Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
6.0.0 - English

Change language to:
Français - 日本語 - Português - Русский

Please note that the recommended version of Scilab is 2025.0.0. This page might be outdated.
See the recommended documentation of this function

Scilab Help >> Elementary Functions > Matrix - shaping > matrix

matrix

reshape a vector or a matrix to a different size matrix

Syntax

y=matrix(v,n,m)
y=matrix(v,[sizes])

Arguments

v

a vector, a matrix or a hypermatrix

n,m

integers

sizes

vector of non-negative integers

y

a vector, a matrix or hypermatrix

Description

For a vector or a matrix with n x m entries, the command y=matrix(v,n,m) or similarly y=matrix(v,[n,m]) transforms the v vector (or matrix) into an nxm matrix by stacking columnwise the entries of v.

If one of the dimension m or n is equal to -1 it is automatically assigned to the quotient of size(v,'*') by the other dimension.

For a hypermatrix such as prod(size(v))==prod(sizes), the command y=matrix(v,sizes) (or equivalently y=matrix(v,n1,n2,...nm)) transforms v into an matrix or hypermatrix by stacking "columnwise" (first dimension is varying first) the entries of v. y=matrix(v,sizes) results in a regular matrix if sizes is a scalar or a 2-vector.

Examples

a=[1 2 3;4 5 6]
matrix(a,1,6)
matrix(a,1,-1)
matrix(a,3,2)

See also

  • matrices — Scilab objects, matrices in Scilab
  • hypermatrices — a Scilab object, N dimensional matrix in Scilab
  • ones — matrix made of ones
  • zeros — matrix made of zeros
  • emptystr — zero length string
  • rand — Random numbers
  • poly — polynomial definition
  • empty — ([]) empty matrix
Report an issue
<< flipdim Matrix - shaping permute >>

Copyright (c) 2022-2024 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Tue Feb 14 15:02:42 CET 2017