copy : truefalse

Indicates whether a new rtable should be allocated when converting from other rtable types such as Array or Matrix. The default is false, meaning that convert will attempt to provide a reference to the existing rtable instead of allocating a new one.

format : string

The option behaves identically to targetformat, but is only valid when expr is not itself a string or ByteArray.

sourceformat : string

A string corresponding to one of the file formats described in Formats. The input expr will be decoded using the specified format and the data returned as a Vector.

If the format specified is not one for which a Vector is a valid output type and no target format is specified, an error is issued.

targetformat : string

A string corresponding to one of the file formats described in Formats. The input expr will be encoded in the specified format and the encoded data returned as an Vector.

Note that this can be used in conjunction with sourceformat to decode data from a source to an arbitrary intermediate expression, then encode it as a Vector in a different format.

Any other options specified will be passed to the Vector constructor.

The convert(A, Vector) function converts the parameter A into a Vector.

The orientation of the result can be specified via the parameter o. The default orientation is column.

If A is a 1-dimensional array or Array, a list, a vector or a Vector, it is simply passed directly to the Vector constructor, together with any additional options, and the orientation, o, if provided.

If A is a matrix, Matrix, 2-D array or 2-D Array, its columns or rows are concatenated to form the result.  If the orientation parameter, o, is either not provided or is given as column, the columns of A are concatenated (from left to right) and a column Vector is returned.  If the orientation parameter is given as row, the rows of A are concatenated (from top to bottom) and a row Vector is returned.  Any additional parameters are passed to the Vector constructor when building the result.

Alternatively, use the ArrayTools[Copy] function. The ArrayTools[Copy] function copies data from an existing Matrix, Vector, or Array (source) to another Matrix, Vector, or Array (target).

$L≔\left[1\,0\right]$

$L≔\left[1\,0\right]$

$\mathrm{L1}≔\mathrm{convert}\left(L\,\mathrm{Vector}\right)$

$\mathrm{L1}≔\left[\begin{array}{c}1\\ 0\end{array}\right]$

$\mathrm{type}\left(L\,\mathrm{Vector}\right)$

$\mathrm{false}$

$\mathrm{type}\left(\mathrm{L1}\,\mathrm{Vector}\right)$

$\mathrm{true}$

$A≔\mathrm{array}\left(1..4\right)\:$

$$\begin{gathered} \mathbf{for}i\mathbf{to}3\mathbf{do} \\ A\left[i\right]≔i^2 \\ \mathbf{end}\mathbf{do}\: \end{gathered}$$$\mathrm{print}\left(A\right)$

$\left[\begin{array}{cccc}1& 4& 9& {\mathrm{`?`}}_4\end{array}\right]$

$\mathrm{A1}≔\mathrm{convert}\left(A\,\mathrm{Vector}\,\mathrm{datatype}=\mathrm{float}\right)$

$\mathrm{A1}≔\left[\begin{array}{cccc}1.& 4.& 9.& 0.\end{array}\right]$

$\mathrm{type}\left(A\,\mathrm{Vector}\right)$

$\mathrm{false}$

$\mathrm{type}\left(\mathrm{A1}\,\mathrm{Vector}\right)$

$\mathrm{true}$

$V≔\mathrm{linalg}\left[\mathrm{vector}\right]\left(3\,\left[1\,x\,x^2\right]\right)$

$V≔\left[\begin{array}{ccc}1& x& x^2\end{array}\right]$

$\mathrm{V1}≔\mathrm{convert}\left(V\,\mathrm{Vector}\right)$

$\mathrm{V1}≔\left[\begin{array}{ccc}1& x& x^2\end{array}\right]$

$\mathrm{type}\left(V\,\mathrm{Vector}\right)$

$\mathrm{false}$

$\mathrm{type}\left(\mathrm{V1}\,\mathrm{Vector}\right)$

$\mathrm{true}$

$M≔⟨⟨1\,2\,3⟩|⟨4\,5\,6⟩⟩$

$M≔\left[\begin{array}{cc}1& 4\\ 2& 5\\ 3& 6\end{array}\right]$

$\mathrm{convert}\left(M\,\mathrm{Vector}\right)$

$\left[\begin{array}{c}1\\ 2\\ 3\\ 4\\ 5\\ 6\end{array}\right]$

$\mathrm{convert}\left(M\,\mathrm{Vector}\left[\mathrm{row}\right]\right)$

$\left[\begin{array}{cccccc}1& 4& 2& 5& 3& 6\end{array}\right]$

The convert/Vector command was updated in Maple 2022.

The copy, format, sourceformat and targetformat options were introduced in Maple 2022.

For more information on Maple 2022 changes, see Updates in Maple 2022.