Home
Reference Guides
Reference guides are available for functions and commands supported by OML, Tcl, and Python.
Reference Guide for OpenMatrix Language Functions
The Reference Guide contains documentation for all functions supported in the OpenMatrix language.
Data Structure Commands
sortrows
Returns matrix, R, which is the result of sorting rows of matrix, m, based on the columns listed, columns.

Welcome
What's New
Discover new features and enhancements.
Get Started
Discover Compose, including its language support and system requirements.
Tutorials
The Compose tutorials and associated example model files help introduce you to the basic functionality of the software.
User Guide
Learn about the features and functionality available in Compose.
Reference Guides
Reference guides are available for functions and commands supported by OML, Tcl, and Python.
- Scripting Guide for OpenMatrix Language
  OpenMatrix is a mathematical scripting language.
- Reference Guide for OpenMatrix Language Functions
  The Reference Guide contains documentation for all functions supported in the OpenMatrix language.
  - ABF Commands
  - Altair Integration Commands
  - Audio Commands
  - CAE Commands
  - CAE Reader Commands
  - CAE Reader 3D Commands
  - CAE Writer Commands
  - Calculus Commands
  - Computer Vision Commands
  - Communication Commands
  - Control System Commands
  - Core Minimal Interpreter Commands
  - Data Structure Commands
    - arrayfun
      Evaluates the function func on each element of the array m. Each element is passed into the function individually.
    - bsxfun
      Evaluates the function func on the elements (element-wise operation) of the input matrices.
    - cat
      Joins the given arrays along a specified dimension, dim.
    - cell
      Creates a new empty cell array.
    - cell2mat
      Converts a cell array to a matrix.
    - cell2struct
      Converts the cell a to a struct. The number of fields b must match number of dimensions c.
    - celldisp
      Displays the content of the cell array x.
    - cellfun
      Evaluates the function func on the cell array c. Each element is passed into the function individually.
    - fieldnames
      Returns a cell array of strings with the names of the fields in the specified struct.
    - getfield
      Extract a field value from a structure s.
    - iscell
      Tests if a value is a cell array.
    - iscellstr
      Indicates whether each element of a cell array is a string.
    - iscolumn
      Tests if v is a column vector of dimension M x 1, where M is a non-negative integer.
    - isfield
      Returns true if x is a struct and contains the field 'field'.
    - isfinite
      Tests if a value is finite.
    - isrow
      Tests if v is a row vector of dimension 1 x N, where N is a non-negative integer.
    - isstruct
      Tests if a value is a struct.
    - mat2cell
      Converts a 2D matrix, m, to a cell array, R.
    - num2cell
      Returns a cell array after converting a complex, 2D matrix, scalar or string input.
    - rmfield
      Returns a copy of the structure s with the field f removed.
    - setfield
      Sets the value of field f in the stucture s to the value v.
    - sortrows
      Returns matrix, R, which is the result of sorting rows of matrix, m, based on the columns listed, columns.
    - struct
      Creates one or more structs with the specified fields and values.
    - structfun
      Evaluates the function func on the fields of the structure s. Each field is passed into the function individually.
    - struct2cell
      Creates a cell array from the struct s.
    - subsasgn
      Assigns a value to an element of a cell or matrix.
  - Differential Equations Commands
  - Elementary Math Commands
  - File I/O Commands
  - Geometry Commands
  - GUI Commands
  - HDF5 Reader Commands
  - HDF5 Writer Commands
  - hstpyfit Commands
  - Image Commands
  - JSON Commands
  - Library Manager Commands
  - Linear Algebra Commands
  - Logical Commands
  - Machine Learning Commands
  - Optimization Commands
  - Plotting Commands
  - PSIM Commands
  - Polynomial Math Commands
  - Signal Processing Commands
  - Special Functions Commands
  - Statistical Analysis Commands
  - String Operations Commands
  - System Commands
  - Table Commands
  - Tcl Bridge OML Commands
  - Tcl Bridge Tcl Commands
  - Time Commands
  - Trigonometry Commands
  - OML to Python Bridge Commands
  - Python to OML Bridge Commands
- Python in Compose Reference Guide
Appendix
Get help for the optional libraries that are available in the Extension Manager.
Frequently Asked Questions
You've got questions? We've got answers!

sortrows

Returns matrix, R, which is the result of sorting rows of matrix, m, based on the columns listed, columns.

Syntax

R = sortrows(m)

R = sortrows(m, columns)

[R, index] = sortrows(m, ...)

Inputs

m: Type: matrix
columns (optional): Specifies the order of columns used for sorting. If a column number is negative, sorting is done in descending order, else sorting is done in ascending order. If no column is specified, the first column is used for sorting; Type: integer | vec

Outputs

R: Type: matrix
index: Vector which contains the indicies of the rows of the input matrix, m, which make up the sorted resultant matrix, R.; Type: vector

Examples

Sort matrix using the first column as the reference in ascending order:

R = sortrows([8, 1, 2, 6; 7, 4, 8, 5; 8, 4, 9, 4 ])

R = [Matrix] 3 x 4
7  4  8  5
8  1  2  6
8  4  9  4

Sort matrix using multiple columns, in ascending and descending order:

R = sortrows([8, 1, 2, 6; 7, 4, 8, 5; 8, 4, 9, 4], [1, -2])

R = [Matrix] 3 x 4
7  4  8  5
8  4  9  4
8  1  2  6

Sort matrix using multiple columns and get row indicies in original matrix:

[s,idx]=sort([1,2,3,4],'ascend')

s = [ 1 2 3 4 ]
idx = [ 1 2 3 4 ]

Two outputs with dim and descend specified:

[R, index] = sortrows([8, 1, 2, 6; 7, 4, 8, 5; 8, 4, 9, 4], [1, -2])

R = [Matrix] 3 x 4
7  4  8  5
8  4  9  4
8  1  2  6
index = [Matrix] 3 x 1
2
3
1