transpose

returns a two-dimensional array after swapping the order of keys for each element of the array.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.1 Security:

# Syntax

transpose(array)

# Params

- array : A two-dimensional array variable whose elements are numbers, and whose keys are sequential numbers.

# Examples

transpose(myArray)

put transpose(censusByHousehold) into censusByGroup

# Description

Use the transpose function to swap rows and columns in a matrix.

A two-dimensional array is an array whose elements have a two-part key to describe them. You can visualize such an array as a set of rows and columns:the first part of each element's key is the row number, and the second part is the column number. For example, the expression myArray[3,2] describes the element of myArray which is in the third row, second column.

The transpose function simply swaps rows for columns. In other words, for each element in the array, the corresponding element in transpose(array) has its two parts switched one for the other. The value in the third row, second column is moved to the second row, third column.

The transpose function is its own inverse : you can transpose a transposed array again to recover the original array.

>*Important:* If the array has missing elements, > the transpose function will fail to work. For example, an array > that contains elements myArray[1,1], myArray[1,2], > and myArray[2,2] cannot be transposed because the element myArray[2,1] > ais missing.

# Tags

properties,

# See

- **keyword:** inverse, element - **function:** keys, transpose, matrixMultiply - **glossary:** array, return, element - **control structure:** function