Построение пустого массива типа mxDOUBLE_CLASS.

Построение пустого массива указанного типа.

Создайте матрицу 2-D указанного типа и сложности. Для нечисловых типов: mxComplexity будет игнорироваться. Для числовых типов передайте mxCOMPLEX для последнего аргумента для создания комплексной матрицы; в противном случае матрица будет действительной. Все элементы инициализированы как нулевые. Для матриц ячеек все элементы инициализируются в пустые ячейки.

Создание n-мерный массив указанного типа и сложности. Для нечисловых типов: mxComplexity будет игнорироваться. Для числовых типов передайте mxCOMPLEX для последнего аргумента для создания комплексной матрицы; в противном случае массив будет реальным. Все элементы инициализированы как нулевые. Для массивов ячеек все элементы инициализируются в пустые ячейки.

Создание 1-по-n массив типа mxCHAR_CLASS, с n = strlen(str)и инициализируйте данные массива символами в указанной строке.

Создание матрицы типа mxCHAR_CLASSи инициализируйте данные массива символами в предоставленных строках. Созданный массив имеет размеры mоколо-max, где m - количество строк и max - длина самой длинной строки в str.

Создание матрицы типа mxSTRUCT_CLASS, с указанными именами полей. Все элементы инициализируются пустыми ячейками.

Создание n-мерный массив типа mxSTRUCT_CLASS, с указанными именами полей. Все элементы инициализируются пустыми ячейками.

Создание глубокой копии существующего массива.

Создайте действительный скалярный массив.

Скалярный массив создается с типом входного аргумента.

Создайте сложный скалярный массив.

Скалярный массив создается с типом входного аргумента.

<type> может быть любым из следующих:

Создайте новый массив, представляющий глубокую копию массива.

Создание общей копии существующего массива. Новый массив и исходный массив указывают на одни и те же данные.

Сериализовать массив на байты. A 1-по-n числовая матрица типа mxUINT8_CLASS возвращается, содержащий сериализованные данные. Данные могут быть десериализованы обратно в исходное представление путем вызова mwArray::Deserialize().

Определите тип массива. Дополнительные сведения см. в разделе Работа с mxArrays mxClassID.

Определите размер элемента типа массива в байтах. Если массив сложен, возвращаемое значение будет представлять размер в байтах действительной части элемента.

Определите общий размер массива.

Определите размер данных массива. Если базовый массив не разрежен, возвращается то же значение, что и NumberOfElements().

Определите выделенный размер данных массива. Если базовый массив не разрежен, возвращается то же значение, что и NumberOfElements().

Определите размерность массива.

Определение количества полей в struct массив. Если базовый массив не имеет типа struct, возвращается ноль.

Определение имени данного поля в struct массив. Если базовый массив не имеет типа struct, создается исключение.

Определите размер каждого измерения в массиве. Размер возвращаемого массива равен 1-by-NumberOfDimensions().

Определите, пуст ли массив.

Определите, является ли массив разреженным.

Определите, является ли массив числовым.

Определите, является ли массив сложным.

Прибыль true если входной массив является байтовым, равным этому массиву. Этот метод выполняет побайтовое сравнение базовых массивов. Поэтому следует сравнивать массивы одного типа. Массивы разных типов в общем случае не будут равны, даже если они инициализированы одними и теми же данными.

Сравнивает этот массив с указанным массивом для порядка. Этот метод выполняет побайтовое сравнение базовых массивов. Поэтому следует сравнивать массивы одного типа. Массивы различных типов, как правило, не упорядочиваются эквивалентно, даже если они инициализированы одними и теми же данными.

Создает уникальное значение хэша из базовых байтов в массиве. Поэтому массивы разных типов будут иметь разные хэш-коды, даже если они инициализированы одними и теми же данными.

Возвращает строковое представление базового массива. Возвращенная строка совпадает с той, которая возвращается путем ввода имени переменной в командной строке MATLAB.

Возвращает массив, представляющий индексы строк (первое измерение) элементов этого массива в порядке «» большой столбец «». Для разреженных массивов индексы возвращаются только для ненулевых элементов, а размер возвращаемого массива равен 1-by-NumberOfNonZeros(). Для массивов без синтаксического анализа размер возвращаемого массива равен 1-by-NumberOfElements()и возвращаются индексы строк всех элементов.

Возвращает массив, представляющий индексы столбцов (второе измерение) элементов этого массива в порядке «» большой столбец «». Для разреженных массивов индексы возвращаются только для ненулевых элементов, а размер возвращаемого массива равен 1-by-NumberOfNonZeros(). Для массивов без синтаксического анализа размер возвращаемого массива равен 1-by-NumberOfElements()и возвращаются индексы столбцов всех элементов.

Преобразовать числовой массив, который ранее был выделен как real кому complex. Если базовый массив имеет нечисловой тип, mwException выбрасывается.

Извлекает один элемент по заданному индексу. Количество индексов передается, за которым следует разделенный запятыми список индексов на основе 1. Допустимое число индексов, которые могут быть переданы, равно 1 (индексирование одного подстрочного индекса) или NumberOfDimensions() (индексирование нескольких подстрочных индексов). При индексировании одного подстрочного индекса возвращается элемент с указанным смещением на основе 1, получающий доступ к данным в основном порядке столбцов. При индексировании нескольких индексов индексный список используется для доступа к указанному элементу. Допустимый диапазон для индексов: 1 <= index <= NumberOfElements(), для индексации одного подстрочного индекса. Для индексирования нескольких подстрочных индексов ith индекс имеет допустимый диапазон: 1 <= index[i] <= GetDimensions().Get(1, i). Один mwException выдается, если передано недопустимое число индексов или если какой-либо индекс выходит за границы.

Извлекает один элемент с указанным именем поля и индексом. Этот метод может быть вызван только для массива, который имеет тип mxSTRUCT_CLASS. Один mwException передается, если базовый массив не является struct массив. Переданное имя поля должно быть допустимым именем поля в struct массив. Индекс передается путем первого прохождения числа индексов, за которым следует разделенный запятыми список индексов на основе 1. Допустимое число индексов, которые могут быть переданы, равно 1 (индексирование одного подстрочного индекса) или NumberOfDimensions() (индексирование нескольких подстрочных индексов). При индексировании одного подстрочного индекса возвращается элемент с заданным смещением на основе 1, который обращается к данным в порядке столбцов. При индексировании нескольких индексов индексный список используется для доступа к указанному элементу. Допустимый диапазон для индексов: 1 <= index <= NumberOfElements(), для индексации одного подстрочного индекса. Для индексирования нескольких подстрочных индексов i-й индекс имеет допустимый диапазон: 1 <= index[i] <= GetDimensions().Get(1, i). Один mwException выдается, если передано недопустимое число индексов или если какой-либо индекс выходит за границы.

Доступ к действительной части сложного массива. Возвращенный mwArray считается действительным и имеет ту же размерность и тип, что и оригинал.

Комплексные массивы состоят из комплексных чисел, которые являются векторами (парами) 1 на 2. Например, если номер 3+5i, то пара (3,5i). Поэтому массив комплексных чисел является двумерным (N-by-2), где N - число комплексных чисел в массиве. 2+4i, 7-3i, 8+6i будет представлен как (2,4i) (7,3i) (8,6i). Комплексные числа имеют две составляющие, вещественную и мнимую.

Доступ к мнимой части сложного массива. Возвращенный mwArray считается действительным и имеет ту же размерность и тип, что и оригинал.

Комплексные массивы состоят из комплексных чисел, которые являются векторами (парами) 1 на 2. Например, если номер 3+5i, то пара (3,5i). Поэтому массив комплексных чисел является двумерным (N-by-2), где N - число комплексных чисел в массиве. 2+4i, 7-3i, 8+6i будет представлен как (2,4i) (7,3i) (8,6i). Комплексные числа имеют две составляющие, вещественную и мнимую.

Назначение общей копии входного массива ячейке, на которую в данный момент имеется ссылка, для массивов типа mxCELL_CLASS и mxSTRUCT_CLASS.

Копирует данные массива в предоставленный числовой буфер.

Данные копируются в основном порядке столбцов. Если базовый массив отличается от входного буфера, данные преобразуются в этот тип при копировании. Если преобразование не может быть выполнено, mwException выбрасывается.

Копирует данные массива в mxLogical буфер.

Данные копируются в основном порядке столбцов. Если базовый массив не имеет типа mxLOGICAL_CLASSданные преобразуются в этот тип при копировании. Если преобразование не может быть выполнено, mwException выбрасывается.

Копирует данные массива в mxChar буфер.

Данные копируются в основном порядке столбцов. Если базовый массив не имеет типа mxCHAR_CLASSданные преобразуются в этот тип при копировании. Если преобразование не может быть выполнено, mwException выбрасывается.

Копирует данные из предоставленного числового буфера в массив.

Данные копируются в основном порядке столбцов. Если базовый массив отличается от входного буфера, данные преобразуются в этот тип при копировании. Если преобразование не может быть выполнено, mwException выбрасывается.

Вы не можете использовать SetData для динамического изменения размера mwArray.

Копирует данные из предоставленного mxLogical буфер в массив.

Данные копируются в основном порядке столбцов. Если базовый массив не имеет типа mxLOGICAL_CLASSданные преобразуются в этот тип при копировании. Если преобразование не может быть выполнено, mwException выбрасывается.

Копирует данные из предоставленного mxChar буфер в массив.

Данные копируются в основном порядке столбцов. Если базовый массив не имеет типа mxCHAR_CLASSданные преобразуются в этот тип при копировании. Если преобразование не может быть выполнено, mwException выбрасывается.

Десериализация массива, сериализованного с помощью mwArray::Serialize(). Входной массив должен иметь тип mxUINT8_CLASS и содержат данные из сериализованного массива. Если входные данные не представляют сериализованную mwArray, поведение этого метода не определено.

Создание вещественной разреженной матрицы типа double с указанным количеством строк и столбцов.

Длины входных строк, индексов столбцов и массивов данных должны быть одинаковыми или равными 1. В случае, когда любой из этих массивов равен 1, значение повторяется во время построения матрицы.

Если одна и та же пара строка/столбец встречается более одного раза, значение данных, присвоенное этому элементу, является суммой всех значений, связанных с этой парой. Если какой-либо элемент rowindex или colindex массив больше указанных значений в num_rows или num_cols соответственно, создается исключение.

Этот пример конструирует разреженную тридиагональную матрицу 4 на 4:

2 -1  0  0
-1  2 -1  0
0 -1  2 -1
0  0 -1  2

Следующий код при выполнении:

double rdata[]        = 
           {2.0, -1.0, -1.0, 2.0, -1.0, 
            -1.0, 2.0, -1.0, -1.0, 2.0};
mwIndex row_tridiag[] = 
           {1,    2,    1,   2,    3,
            2,   3,    4,    3,   4  };
mwIndex col_tridiag[] = 
           {1,    1,    2,   2,    2, 
              3,   3,    3,    4,   4  };

mwArray mysparse = 
           mwArray::NewSparse(10, row_tridiag, 
                              10, col_tridiag, 
                              10, rdata, 4, 4, 10);
std::cout << mysparse << std::endl;

выведет на экран следующие выходные данные:

 (1,1)        2
 (2,1)       -1
 (1,2)       -1
 (2,2)        2
 (3,2)       -1
 (2,3)       -1
 (3,3)        2
 (4,3)       -1
 (3,4)       -1
 (4,4)        2

Создание вещественной разреженной матрицы типа double с количеством строк и столбцов, выведенных из входных данных.

Длины входных строк и столбцов индекса и массивов данных должны быть одинаковыми или равными 1. В случае, когда любой из этих массивов равен 1, значение повторяется через структуру матрицы.

Если одна и та же пара строка/столбец встречается более одного раза, значение данных, присвоенное этому элементу, является суммой всех значений, связанных с этой парой. Количество строк и столбцов в созданной матрице рассчитывается на основе входных данных rowindex и colindex массивы как num_rows = max{rowindex}, num_cols = max{colindex}.

В этом примере мы построим разреженную единичную матрицу 4 на 4. Значение 1,0 копируется в каждый ненулевой элемент, определенный массивами индексов строк и столбцов:

double one = 1.0;
mwIndex row_diag[] = {1, 2, 3, 4};
mwIndex col_diag[] = {1, 2, 3, 4};

mwArray mysparse = 
  mwArray::NewSparse(4, row_diag, 
                     4, col_diag, 
                     1, &one, 
                     0);
std::cout << mysparse << std::endl;

(1,1)        1
(2,2)        1
(3,3)        1
(4,4)        1

Создание сложной разреженной матрицы типа double с указанным количеством строк и столбцов.

Длины входных строк и столбцов индекса и массивов данных должны быть одинаковыми или равными 1. В случае, когда любой из этих массивов равен 1, значение повторяется через структуру матрицы.

Если одна и та же пара строка/столбец встречается более одного раза, значение данных, присвоенное этому элементу, является суммой всех значений, связанных с этой парой. Если какой-либо элемент rowindex или colindex массив больше указанных значений в num_rows, num_cols, соответственно, затем генерируется исключение.

Этот пример конструирует сложную тридиагональную матрицу:

double rdata[] = 
  {2.0, -1.0, -1.0, 2.0, -1.0, -1.0, 2.0, -1.0, -1.0, 2.0};
double idata[] = 
  {20.0, -10.0, -10.0, 20.0, -10.0, -10.0, 20.0, -10.0, 
                                              -10.0, 20.0};
mwIndex row_tridiag[] = 
  {1,    2,    1,   2,    3,    2,   3,    4,    3,   4};
mwIndex col_tridiag[] =
  {1,    1,    2,   2,    2,    3,   3,    3,    4,   4};

mwArray mysparse = mwArray::NewSparse(10, row_tridiag, 
                                      10, col_tridiag, 
                                      10, rdata, 
                                      idata, 4, 4, 10);
std::cout << mysparse << std::endl;

На экране отображаются следующие выходные данные:

(1,1)      2.0000 +20.0000i
(2,1)     -1.0000 -10.0000i
(1,2)     -1.0000 -10.0000i
(2,2)      2.0000 +20.0000i
(3,2)     -1.0000 -10.0000i
(2,3)     -1.0000 -10.0000i
(3,3)      2.0000 +20.0000i
(4,3)     -1.0000 -10.0000i
(3,4)     -1.0000 -10.0000i
(4,4)      2.0000 +20.0000i

Создание сложной разреженной матрицы типа double с количеством строк и столбцов, выведенных из входных данных.

Длины входных строк и столбцов индекса и массивов данных должны быть одинаковыми или равными 1. В случае, когда любой из этих массивов равен 1, значение повторяется через структуру матрицы.

Если одна и та же пара строка/столбец встречается более одного раза, значение данных, присвоенное этому элементу, является суммой всех значений, связанных с этой парой. Количество строк и столбцов в созданной матрице вычисляется при вводе rowindex и colindex массивы как num_rows = max{rowindex}, num_cols = max{colindex}.

В этом примере создается комплексная матрица путем вывода размеров и распределения памяти из входных данных.

mwArray mysparse = 
   mwArray::NewSparse(10, row_tridiag, 
                      10, col_tridiag,
                      10, rdata, idata, 
                      0);
std::cout << mysparse << std::endl;

(1,1)      2.0000 +20.0000i
(2,1)     -1.0000 -10.0000i
(1,2)     -1.0000 -10.0000i
(2,2)      2.0000 +20.0000i
(3,2)     -1.0000 -10.0000i
(2,3)     -1.0000 -10.0000i
(3,3)      2.0000 +20.0000i
(4,3)     -1.0000 -10.0000i
(3,4)     -1.0000 -10.0000i
(4,4)      2.0000 +20.0000i

Создание логической разреженной матрицы с указанным количеством строк и столбцов.

Длины входных строк и столбцов индекса и массивов данных должны быть одинаковыми или равными 1. В случае, когда любой из этих массивов равен 1, значение повторяется во время построения матрицы.

Если одна и та же пара строка/столбец встречается более одного раза, значение данных, присвоенное этому элементу, является суммой всех значений, связанных с этой парой. Если какой-либо элемент rowindex или colindex массив больше указанных значений в num_rows, num_cols, соответственно, затем генерируется исключение.

В этом примере создается разреженная логическая тридиагональная матрица 4 на 4, присваивающая true к каждому ненулевому значению:

mxLogical one = true;
mwIndex row_tridiag[] = 
      {1,    2,    1,   2,    3,    
       2,   3,    4,    3,   4};
mwIndex col_tridiag[] = 
      {1,    1,    2,   2,    2,    
       3,   3,    3,    4,   4};

mwArray mysparse = 
      mwArray::NewSparse(10, row_tridiag,
                         10, col_tridiag, 
                          1, &one, 
                          4, 4, 10);
std::cout << mysparse << std::endl;

(1,1)        1
(2,1)        1
(1,2)        1
(2,2)        1
(3,2)        1
(2,3)        1
(3,3)        1
(4,3)        1
(3,4)        1
(4,4)        1

Создает логическую разреженную матрицу с количеством строк и столбцов, выведенных из входных данных.

Длины входных строк и столбцов индекса и массивов данных должны быть одинаковыми или равными 1. В случае, когда любой из этих массивов равен 1, значение повторяется через структуру матрицы.

Количество строк и столбцов в созданной матрице вычисляется при вводе rowindex и colindex массивы как num_rows = max {rowindex}, num_cols = max {colindex}.

В этом примере используются данные из первого примера, но на основе входных данных можно рассчитать количество строк, количество столбцов и выделенное хранилище:

mwArray mysparse = 
    mwArray::NewSparse(10, row_tridiag, 
                       10, col_tridiag, 
                       1, &one, 
                       0);
std::cout << mysparse << std::endl;

(1,1)        1
(2,1)        1
(1,2)        1
(2,2)        1
(3,2)        1
(2,3)        1
(3,3)        1
(4,3)        1
(3,4)        1
(4,4)        1

Создание пустой разреженной матрицы. Все элементы в пустой разреженной матрице изначально равны нулю, и объем выделенного хранилища для ненулевых элементов определяется nzmax.

В этом примере создается действительная пустая разреженная матрица типа 3 на 3 double с зарезервированным хранилищем для 4 ненулевых элементов:

mwArray mysparse = mwArray::NewSparse
                (3, 3, 4, mxDOUBLE_CLASS);
std::cout << mysparse << std::endl;

All zero sparse: 3-by-3

Получить значение NaN (Не-а-число).

Звонить mwArray::GetNaN для возврата значения NaN для вашей системы. NaN - арифметическое представление IEEE для Not-a-Number. Некоторые математические операции возвращаются NaN в результате, например:

Значение NaN встроена в систему; изменить его нельзя.

Возвращает значение MATLAB eps переменная. Эта переменная представляет собой расстояние от 1,0 до следующего наибольшего числа с плавающей запятой. Следовательно, это мера точности с плавающей запятой. MATLAB pinv и rank использование функций eps в качестве допуска по умолчанию.

Возвращает значение внутренней переменной MATLAB Inf переменная. Inf - постоянная переменная, представляющая арифметическую положительную бесконечность IEEE. Значение Inf встроен в систему; изменить его нельзя.

Операции, которые возвращаются Inf включать

Определите, является ли значение конечным. Число является конечным, если оно больше -Inf и менее Inf.

Определяет, равно ли значение бесконечности или минус бесконечности. MATLAB сохраняет значение бесконечности в постоянной переменной с именем Inf, которая представляет арифметическую положительную бесконечность IEEE. Значение переменной, Inf, встроен в систему; изменить его нельзя.

Операции, возвращающие бесконечность, включают

Определяет, является ли значение NaN. NaN - арифметическое представление IEEE для Not-a-Number. NaN получается в результате математически неопределенных операций, таких как

Система понимает семейство битовых шаблонов как представляющие NaN. Другими словами, NaN это не одно значение, а семейство чисел, которые программное обеспечение MATLAB (и другие приложения, совместимые с IEEE) использует для представления состояния ошибки или отсутствующих данных.

Извлекает один элемент по заданному индексу. Индекс передается в виде разделенного запятыми списка индексов на основе 1. Этот оператор перегружен для поддержки индексов от 1 до 32. Допустимое число индексов, которые могут быть переданы, равно 1 (индексирование одного подстрочного индекса) или NumberOfDimensions() (индексирование нескольких подстрочных индексов). При индексировании одного подстрочного индекса возвращается элемент с заданным смещением на основе 1, который обращается к данным в порядке столбцов. При индексировании нескольких индексов индексный список используется для доступа к указанному элементу. Допустимый диапазон для индексов: 1 <= index <= NumberOfElements(), для индексации одного подстрочного индекса. Для индексирования нескольких подстрочных индексов i-й индекс имеет допустимый диапазон: 1 <= index[i] <= GetDimensions().Get(1, i). Один mwException выдается, если передано недопустимое число индексов или если какой-либо индекс выходит за границы.

Извлекает один элемент с указанным именем поля и индексом. Этот метод может быть вызван только для массива, который имеет тип mxSTRUCT_CLASS. Один mwException передается, если базовый массив не является struct массив. Переданное имя поля должно быть допустимым именем поля в struct массив. Индекс передается путем первого прохождения числа индексов, за которым следует массив индексов на основе 1. Этот оператор перегружен для поддержки индексов от 1 до 32. Допустимое число индексов, которые могут быть переданы, равно 1 (индексирование одного подстрочного индекса) или NumberOfDimensions() (индексирование нескольких подстрочных индексов). При индексировании одного подстрочного индекса возвращается элемент с заданным смещением на основе 1, который обращается к данным в порядке столбцов. При индексировании нескольких индексов индексный список используется для доступа к указанному элементу. Допустимый диапазон для индексов: 1 <= index <= NumberOfElements(), для индексации одного подстрочного индекса. Для индексирования нескольких подстрочных индексов i-й индекс имеет допустимый диапазон: 1 <= index[i] <= GetDimensions().Get(1, i). Один mwException выдается, если передано недопустимое число индексов или если какой-либо индекс выходит за границы.

Задает одно скалярное значение. Этот оператор перегружен для всех числовых и логических типов.

Извлекает одно скалярное значение. Этот оператор перегружен для всех числовых и логических типов.

Написать mwArray для вывода потока. Выходные данные имеют тот же формат, что и выходные данные при вводе имени переменной в командной строке MATLAB. Посмотрите ToString().