Документация

Обзор классов и методы в иерархии классов преобразования данных

Чтобы поддержать типы данных MATLAB, продукт MATLAB Compiler SDK обеспечивает классы преобразования данных MWArray в блоке MWArray. Вы ссылаетесь на этот блок в своем управляемом приложении, чтобы преобразовать нативные массивы в массивы MATLAB и наоборот.

См. документацию API MWArray для полного изложения на классах и предоставленных методах.

Классы преобразования данных создаются как иерархия классов, которая представляет главные типы массива MATLAB.

Корень иерархии является абстрактным классом MWArray. Класс MWArray имеет следующие подклассы, представляющие главные типы MATLAB: MWNumericArray, MWLogicalArray, MWCharArray, MWCellArray и MWStructArray.

MWArray и его производные классы обеспечивают следующую функциональность:

Обработка многомерного массива в MATLAB и.NET

MATLAB и.NET реализуют различные стратегии индексации многомерных массивов. Когда вы создаете переменную типа MWNumericArray, MATLAB автоматически создает эквивалентный массив, используя его собственную внутреннюю индексацию. Например, индексы MATLAB с помощью этой схемы:

(row column page1 page2 ...)

(... page2 page1 row column) 

>> myarr(:,:,1) = [1, 2, 3; 4, 5, 6]; 
>> myarr(:,:,2) = [7, 8, 9; 10, 11, 12]; 
>> myarr 

myarr(:,:,1) = 

     1     2     3 
     4     5     6 


myarr(:,:,2) = 

     7     8     9 
    10    11    12 

double[,,] myarr = {{{1.000000, 2.000000, 3.000000}, 
{4.000000, 5.000000, 6.000000}}, {{7.000000, 8.000000, 
9.000000}, {10.000000, 11.000000, 12.000000}}}; 

Нативное преобразование данных

Продукт MATLAB Compiler SDK обеспечивает классы массивов MATLAB в порядке упростить преобразование данных между нативными данными и скомпилированными функциями MATLAB.

Этот пример явным образом создает числовое постоянное использование конструктора для класса MWNumericArray с аргументом System.Int32. Эта переменная может затем быть передана одному из сгенерированных методов.NET.

int data = 24; 
MWNumericArray array = new MWNumericArray(data);
Console.WriteLine("Array is of type " + array.NumericType);

Когда вы запускаете этот пример, результаты:

Array is of type double 

В этом примере нативное целое число (int data) преобразовано в MWNumericArray, содержащий двойной массив MATLAB 1 на 1, который является типом MATLAB по умолчанию.

MWNumericArray array = new MWNumericArray(data, false);

Продукт MATLAB Compiler SDK не поддерживает некоторые типы массива MATLAB, потому что они не CLS-совместимы. Смотрите Неподдерживаемые Типы массива MATLAB для списка неподдерживаемых типов.

Для получения дополнительной информации о концепциях, вовлеченных в преобразование данных, смотрите Проблемы Преобразования Данных об Управлении с Классами Преобразования Данных о.NET MATLAB Compiler SDK.

Введите спецификацию

Если вы хотите создать числовой массив MATLAB определенного типа, установите дополнительный аргумент makeDouble на False. Нативный тип затем определяет тип массива MATLAB, который создается.

Здесь, код указывает, что массив должен быть создан как MATLAB 16-битный целочисленный массив 1 на 1:

short data = 24; 
MWNumericArray array = new MWNumericArray(data, false);
Console.WriteLine("Array is of type " + array.NumericType);

Выполнение этого примера приводит к следующим результатам:

Array is of type int16 

Спецификация дополнительного аргумента

В продукте MATLAB varargin и varargout используются, чтобы задать аргументы, которые не требуются. Рассмотрите следующую функцию MATLAB:

function y = mysum(varargin)
y = sum([varargin{:}]);

Эта функция возвращает сумму входных параметров. Входные параметры обеспечиваются как varargin, что означает, что вызывающая сторона может задать любое количество входных параметров к функции. Результат возвращен как скалярный массив double.

Для функции mysum продукт MATLAB Compiler SDK генерирует следующие интерфейсы:

// Single output interfaces
public MWArray mysum()
public MWArray mysum(params MWArray[] varargin)
// Standard interface
public MWArray[] mysum(int numArgsOut)
public MWArray[] mysum(int numArgsOut, 
           params MWArray[] varargin)
// feval interface
public void mysum(int numArgsOut, ref MWArray ArgsOut,  
						params MWArray[] varargin)

Аргументы varargin могут быть переданы или как MWArray[], или как список явных входных параметров. (В C# модификатор params для аргумента метода указывает, что метод принимает любое количество параметров определенного типа.) Используя params позволяет вашему коду добавлять любое количество дополнительных входных параметров к инкапсулированной функции MATLAB.

Вот пример того, как вы можете использовать один выходной интерфейс метода mysum в приложении.NET:

static void Main(string[] args]
{
MWArray sum= null;
MySumClass mySumClass = null;
try
  {
   mySumClass= new MySumClass();
   sum= mySumClass.mysum((double)2, 4);
   Console.WriteLine("Sum= {0}", sum);
   sum= mySumClass.mysum((double)2, 4, 6, 8);
   Console.WriteLine("Sum= {0}", sum);
  }
}

Количество входных параметров может отличаться.

 Передайте входные параметры

function p = myprimes(n) 
p = primes(n);

 Создайте один входной параметр

MWNumericArray data = 5;
MyPrimesClass myClass = new MyPrimesClass();
MWArray primes = myClass.myprimes(data);

 Передайте нативный тип.NET

MyPrimesClass myClass = new MyPrimesClass();
MWArray primes = myClass.myprimes((double)13);

 Используйте Интерфейс feval

MyPrimesClassmyClass = new MyPrimesClass(); 
MWArray[] maxPrimes = new MWArray[1]; 
maxPrimes[0] = new MWNumericArray(13);
MWArray[] primes = new MWArray[1];
myClass.myprimes(1, ref primes, maxPrimes);

Передайте переменное количество Выходных параметров

Когда существующий, аргументы varargout обработаны таким же образом, что аргументы varargin обработаны. Рассмотрите следующую функцию MATLAB:

function varargout = randvectors()
for i=1:nargout
   varargout{i} = rand(1, i);
end

Эта функция возвращается, список случайного double векторизовал таким образом, что длина i th вектор равна i. Продукт MATLAB Compiler SDK генерирует интерфейс.NET к этой функции можно следующим образом:

public void randvectors()
public MWArray[] randvectors(int numArgsOut)
public void randvectors(int numArgsOut, ref MWArray[] varargout)

 Пример использования

MyVarargOutClass myClass = new MyVarargOutClass();
MWArray[] results = myClass.randvectors(2);
Console.WriteLine("First output= {0}", results[0]);
Console.WriteLine("Second output= {0}", results[1]);