Matrix . Create Method

Remarks

The values of the matrix are stored in row-major order.

Exceptions

values is null

Create<T>(Int32, Int32)

Constructs a new matrix with the specified number of rows and columns

public static DenseMatrix<T> Create<T>(
	int rowCount,
	int columnCount
)

Visual Basic

Public Shared Function Create(Of T) ( 
	rowCount As Integer,
	columnCount As Integer
) As DenseMatrix(Of T)

C++/CLI

public:
generic<typename T>
static DenseMatrix<T>^ Create(
	int rowCount, 
	int columnCount
)

static member Create : 
        rowCount : int * 
        columnCount : int -> DenseMatrix<'T>

Parameters

rowCount Int32: The number of rows in the new matrix.
columnCount Int32: The number of columns in the new matrix.

Type Parameters

T

Return Value

Exceptions

rowCount is less than zero.

-or-

columnCount is less than zero.

Create<T>(IEnumerable<T[]>, MatrixElementOrder, ArrayMutability)

Constructs a new matrix from a jagged array.

public static DenseMatrix<T> Create<T>(
	IEnumerable<T[]> values,
	MatrixElementOrder order = MatrixElementOrder.RowMajor,
	ArrayMutability mutability = ArrayMutability.MutableValues
)

Visual Basic

Public Shared Function Create(Of T) ( 
	values As IEnumerable(Of T()),
	Optional order As MatrixElementOrder = MatrixElementOrder.RowMajor,
	Optional mutability As ArrayMutability = ArrayMutability.MutableValues
) As DenseMatrix(Of T)

C++/CLI

public:
generic<typename T>
static DenseMatrix<T>^ Create(
	IEnumerable<array<T>^>^ values, 
	MatrixElementOrder order = MatrixElementOrder::RowMajor, 
	ArrayMutability mutability = ArrayMutability::MutableValues
)

static member Create : 
        values : IEnumerable<'T[]> * 
        ?order : MatrixElementOrder * 
        ?mutability : ArrayMutability 
(* Defaults:
        let _order = defaultArg order MatrixElementOrder.RowMajor
        let _mutability = defaultArg mutability ArrayMutability.MutableValues
*)
-> DenseMatrix<'T>

Parameters

values IEnumerable<T[]>: A jagged array or enumerable list of arrays of values.
order MatrixElementOrder (Optional): Specifies whether values contains the rows or columns of the matrix.
mutability ArrayMutability (Optional): Specifies how the matrix's values may be changed. The default is mutable values.

Type Parameters

T

Return Value

Remarks

The values of the matrix are stored in row-major order.

Exceptions

values is null

Create<T>(Int32, Int32, MatrixElementOrder)

Constructs a new matrix with the specified number of rows and columns

public static DenseMatrix<T> Create<T>(
	int rowCount,
	int columnCount,
	MatrixElementOrder elementOrder
)

Visual Basic

Public Shared Function Create(Of T) ( 
	rowCount As Integer,
	columnCount As Integer,
	elementOrder As MatrixElementOrder
) As DenseMatrix(Of T)

C++/CLI

public:
generic<typename T>
static DenseMatrix<T>^ Create(
	int rowCount, 
	int columnCount, 
	MatrixElementOrder elementOrder
)

static member Create : 
        rowCount : int * 
        columnCount : int * 
        elementOrder : MatrixElementOrder -> DenseMatrix<'T>

Parameters

rowCount Int32: The number of rows in the new matrix.
columnCount Int32: The number of columns in the new matrix.
elementOrder MatrixElementOrder: A MatrixElementOrder value that specifies the order in which the matrix components are stored in the storage array.

Type Parameters

T

Return Value

Exceptions

rowCount is less than zero.

-or-

columnCount is less than zero.

Create<T>(Int32, Int32, Func<Int32, Int32, T>, ArrayMutability)

Constructs a new matrix with the specified number of rows and columns whose elements are all equal to the specified value.

public static DenseMatrix<T> Create<T>(
	int rowCount,
	int columnCount,
	Func<int, int, T> initializer,
	ArrayMutability mutability = ArrayMutability.MutableValues
)

Visual Basic

Public Shared Function Create(Of T) ( 
	rowCount As Integer,
	columnCount As Integer,
	initializer As Func(Of Integer, Integer, T),
	Optional mutability As ArrayMutability = ArrayMutability.MutableValues
) As DenseMatrix(Of T)

C++/CLI

public:
generic<typename T>
static DenseMatrix<T>^ Create(
	int rowCount, 
	int columnCount, 
	Func<int, int, T>^ initializer, 
	ArrayMutability mutability = ArrayMutability::MutableValues
)

static member Create : 
        rowCount : int * 
        columnCount : int * 
        initializer : Func<int, int, 'T> * 
        ?mutability : ArrayMutability 
(* Defaults:
        let _mutability = defaultArg mutability ArrayMutability.MutableValues
*)
-> DenseMatrix<'T>

Parameters

rowCount Int32: The number of rows in the new matrix.
columnCount Int32: The number of columns in the new matrix.
initializer Func<Int32, Int32, T>: A delegate that takes a row, column pair and returns the value of the corresponding element.
mutability ArrayMutability (Optional): Specifies how the matrix's values may be changed. The default is mutable values.

Type Parameters

T

Return Value

Exceptions

rowCount is less than zero.

-or-

columnCount is less than zero.

initializer is null.

Create<T>(Int32, Int32, Array2D<T>, MatrixElementOrder, ArrayMutability)

Constructs a new matrix.

public static DenseMatrix<T> Create<T>(
	int rowCount,
	int columnCount,
	Array2D<T> values,
	MatrixElementOrder elementOrder,
	ArrayMutability mutability = ArrayMutability.MutableValues
)

Visual Basic

Public Shared Function Create(Of T) ( 
	rowCount As Integer,
	columnCount As Integer,
	values As Array2D(Of T),
	elementOrder As MatrixElementOrder,
	Optional mutability As ArrayMutability = ArrayMutability.MutableValues
) As DenseMatrix(Of T)

C++/CLI

public:
generic<typename T>
static DenseMatrix<T>^ Create(
	int rowCount, 
	int columnCount, 
	Array2D<T> values, 
	MatrixElementOrder elementOrder, 
	ArrayMutability mutability = ArrayMutability::MutableValues
)

static member Create : 
        rowCount : int * 
        columnCount : int * 
        values : Array2D<'T> * 
        elementOrder : MatrixElementOrder * 
        ?mutability : ArrayMutability 
(* Defaults:
        let _mutability = defaultArg mutability ArrayMutability.MutableValues
*)
-> DenseMatrix<'T>

Parameters

rowCount Int32: The number of rows in the matrix.
columnCount Int32: The number of columns in the matrix.
values Array2D<T>: A strided array that contains the values of the matrix.
elementOrder MatrixElementOrder: A MatrixElementOrder value that indicates whether rows or columns are stored contiguously.
mutability ArrayMutability (Optional): Specifies how the matrix's values may be changed. The default is mutable values.

Type Parameters

T

Return Value

Create<T>(Int32, Int32, T[], MatrixElementOrder, Boolean, ArrayMutability)

Constructs a new matrix of the specified dimensions using the specified values array.

public static DenseMatrix<T> Create<T>(
	int rowCount,
	int columnCount,
	T[] values,
	MatrixElementOrder elementOrder,
	bool reuseComponentArray = false,
	ArrayMutability mutability = ArrayMutability.MutableValues
)

Visual Basic

Public Shared Function Create(Of T) ( 
	rowCount As Integer,
	columnCount As Integer,
	values As T(),
	elementOrder As MatrixElementOrder,
	Optional reuseComponentArray As Boolean = false,
	Optional mutability As ArrayMutability = ArrayMutability.MutableValues
) As DenseMatrix(Of T)

C++/CLI

public:
generic<typename T>
static DenseMatrix<T>^ Create(
	int rowCount, 
	int columnCount, 
	array<T>^ values, 
	MatrixElementOrder elementOrder, 
	bool reuseComponentArray = false, 
	ArrayMutability mutability = ArrayMutability::MutableValues
)

static member Create : 
        rowCount : int * 
        columnCount : int * 
        values : 'T[] * 
        elementOrder : MatrixElementOrder * 
        ?reuseComponentArray : bool * 
        ?mutability : ArrayMutability 
(* Defaults:
        let _reuseComponentArray = defaultArg reuseComponentArray false
        let _mutability = defaultArg mutability ArrayMutability.MutableValues
*)
-> DenseMatrix<'T>

Parameters

rowCount Int32: The number of rows.
columnCount Int32: The number of columns.
values T[]: An array of values that contain the elements of the matrix in column-major order.
elementOrder MatrixElementOrder: A MatrixElementOrder value that specifies the order in which the matrix elements are stored in the storage array values.
reuseComponentArray Boolean (Optional): If true, the array referenced by Specifies how the matrix's values may be changed. The default is mutable values.values is used directly for element storage without being copied. Any changes to the elements of this matrix will also affect the original array, and vice versa. If false, the elements are copied from values to a new array.
mutability ArrayMutability (Optional)

Type Parameters

T

Return Value

Exceptions

values is null

rowCount is less than zero.

-or-

columnCount is less than zero.

Create<T>(Int32, Int32, T[], Int32, Int32, MatrixElementOrder, ArrayMutability)

Constructs a new matrix.

public static DenseMatrix<T> Create<T>(
	int rowCount,
	int columnCount,
	T[] values,
	int offset,
	int leadingDimension,
	MatrixElementOrder elementOrder,
	ArrayMutability mutability = ArrayMutability.MutableValues
)

Visual Basic

Public Shared Function Create(Of T) ( 
	rowCount As Integer,
	columnCount As Integer,
	values As T(),
	offset As Integer,
	leadingDimension As Integer,
	elementOrder As MatrixElementOrder,
	Optional mutability As ArrayMutability = ArrayMutability.MutableValues
) As DenseMatrix(Of T)

C++/CLI

public:
generic<typename T>
static DenseMatrix<T>^ Create(
	int rowCount, 
	int columnCount, 
	array<T>^ values, 
	int offset, 
	int leadingDimension, 
	MatrixElementOrder elementOrder, 
	ArrayMutability mutability = ArrayMutability::MutableValues
)

static member Create : 
        rowCount : int * 
        columnCount : int * 
        values : 'T[] * 
        offset : int * 
        leadingDimension : int * 
        elementOrder : MatrixElementOrder * 
        ?mutability : ArrayMutability 
(* Defaults:
        let _mutability = defaultArg mutability ArrayMutability.MutableValues
*)
-> DenseMatrix<'T>

Parameters

rowCount Int32: The number of rows in the matrix.
columnCount Int32: The number of columns in the matrix.
values T[]: An array that contains the values of the matrix.
offset Int32: Offset of the first element of the matrix in values.
leadingDimension Int32: Distance between the first element of each row or column.
elementOrder MatrixElementOrder: A MatrixElementOrder value that indicates whether rows or columns are stored contiguously.
mutability ArrayMutability (Optional): Specifies how the matrix's values may be changed. The default is mutable values.

Type Parameters

T

Return Value