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

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

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

Подробную информацию о предоставленных классах и методах см. в документации MWArray API.

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

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

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

Многомерный массив в MATLAB и .NET

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

(row column page1 page2 ...)

(... page2 page1 row column) 

Учитывая многомерные myarr MATLAB:

>> 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 

Вы бы кодировали этот эквивалент в .NET:

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 см. в разделе неподдерживаемых типов.

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

Спецификация типа

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

Здесь код указывает, что массив должен быть построен как 16-битный целочисленный массив MATLAB 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)

The 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 Interface

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 векторы такие, что длина ith вектор равен 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]);

Отражение .NET

Можно использовать reflection, чтобы динамически создать образец типа, связать тип с существующим объектом или получить тип из существующего объекта. Затем можно вызвать методы типа или получить доступ к его полям и свойствам. Дополнительные сведения об отражении см. в библиотеке MSDN.

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

public void GetPrimes(int n)
{
	MWArray primes= null;
	MyPrimesClass myPrimesClass= null;
	try
	 {
		myPrimesClass= new MyPrimesClass();
		primes= myPrimesClass.myprimes((double)n);
		Array primesArray= ((MWNumericArray)primes).
			ToVector(MWArrayComponent.Real);
		if (primesArray is double[])
		 {
			double[] doubleArray= (double[])primesArray;
			/* Do something with doubleArray . . . */
		 }
		else if (primesArray is float[])
		 {
			float[] floatArray= (float[])primesArray;
			/* Do something with floatArray . . . */
		 }
		else if (primesArray is int[])
		 {
			int[] intArray= (int[])primesArray;
			/*Do something with intArray . . . */
		 }
		else if (primesArray is long[])
		 {
			long[] longArray= (long[])primesArray;
			/*Do something with longArray . . . */
		 }
		else if (primesArray is short[])
		 {
			short[] shortArray= (short[])primesArray;
			/*Do something with shortArray . . . */
		 }
		else if (primesArray is byte[])
		 {
			byte[] byteArray= (byte[])primesArray;
			/*Do something with byteArray . . . */
		 }
		else
		 {
			throw new ApplicationException("
				Bad type returned from myprimes");
		 }
	 }
}

В примере используется toVector метод для возврата примитивного массива .NET (primesArray), который представляет базовый массив MATLAB. См. следующий фрагмент кода из примера:

primes= myPrimesClass.myprimes((double)n);
		Array primesArray= ((MWNumericArray)primes).
			ToVector(MWArrayComponent.Real);

Запрос MWArray

В следующем примере используется MWNumericArray NumericType метод, наряду с MWNumericType перечисление для определения типа базового массива MATLAB. Смотрите switch (numericType) оператор.

public void GetPrimes(int n)
{
	MWArray primes= null;
	MyPrimesClass myPrimesClass= null;
	try
	 {
		myPrimesClass= new MyPrimesClass();
		primes= myPrimesClass.myprimes((double)n);
		if ((!primes.IsNumericArray) || (2 !=
			primes.NumberofDimensions))
		 {
			throw new ApplicationException("Bad type returned
				by mwprimes");
		 }
		MWNumericArray _primes= (MWNumericArray)primes;
		MWNumericType numericType= _primes.NumericType;
		Array primesArray= _primes.ToVector(
			MWArrayComponent.Real);
		switch (numericType)
		 {
			case MWNumericType.Double:
			 {
				double[] doubleArray= (double[])primesArray;
				/* (Do something with doubleArray . . .) */
				break;
			 }
			case MWNumericType.Single:
			 {
				float[] floatArray= (float[])primesArray;
				/* (Do something with floatArray . . .) */
				break;
			 }
			case MWNumericType.Int32:
			 {
				int[] intArray= (int[])primesArray;
				/* (Do something with intArray . . .) */
				break;
			 }
			case MWNumericType.Int64:
			 {
				long[] longArray= (long[])primesArray;
				/* (Do something with longArray . . .) */
				break;
			 }
			case MWNumericType.Int16:
			 {
				short[] shortArray= (short[])primesArray;
				/* (Do something with shortArray . . .) */
				break;
			 }
			case MWNumericType.UInt8:
			 {
				byte[] byteArray= (byte[])primesArray;
				/* (Do something with byteArray . . .) */
				break;
			 }
			default:
			 {
				throw new ApplicationException("Bad type returned 
					by myprimes");
			 }
		 }
	 }
}

Код в примере также проверяет размерность по вызову NumberOfDimensions; см. следующий фрагмент кода:

if ((!primes.IsNumericArray) || (2 !=
			primes.NumberofDimensions))
		 {
			throw new ApplicationException("Bad type returned
				by mwprimes"); 
      }

Этот вызов выдает исключение, если массив не является числовым и соответствующей размерности.