| Property | Value |
|---|---|
| Hex Value | $14 |
| Categories | |
| Localizations |
|
augment(
Overview
Returns a matrix, which is matrixB appended to matrixA as new columns.
Availability: Token available everywhere.
Syntax
augment( matrixA ,matrixB )
Arguments
| Name | Type | Optional |
|---|---|---|
| matrixA | matrix | |
| matrixB | matrix |
Location
2nd, matrix, MATH, 7:augment(
Overview
Returns a list, which is listB concatenated to the end of listA.
Availability: Token available everywhere.
Syntax
augment(listA,listB)
Arguments
| Name | Type | Optional |
|---|---|---|
| listA | list | |
| listB | list |
Location
2nd, list, OPS, 9:augment(
Description
The augment( command is used to combine two lists or two matrices into one. For lists, this is done the obvious way: adding the elements of the second on to the elements of the first. For example:
augment({1,2,3,4},{5,6,7
{1 2 3 4 5 6 7}
For matrices, the columns of the second matrix are added after the columns of the first matrix: an R by C matrix augmented with an R by D matrix will result in an R by (C+D) matrix. For example:
augment([[1][2]],[[3][4]
[[1 3]
[2 4]]
Advanced Uses
Use the T (transpose) command if you want to combine two matrices vertically, rather than horizontally. For example:
augment([[1,2]]T,[[3,4]]T)T
[[1 2]
[3 4]]
Optimization
You may be tempted to use augment( to add one element to the end of a list:
:augment(L1,{X→L1
However, the following way is faster and more memory-efficient while the program is running (although it increases the program's size):
:X→L1(1+dim(L1
Error Conditions
- ERR:DATA TYPE is thrown if you try to augment a single number to a list, a common error — use {X instead of X.
- ERR:DIM MISMATCH is thrown if you try to augment two matrices with a different number of rows.
- ERR:INVALID DIM is thrown if one of the arguments is a list with dimension 0, or if the result would have dimension over 999 (for lists) or 99x99 (for matrices).
Related Commands
- dim( – for retrieving the size of a list
- seq( – for creating a list based on a formula, or to create a subset of an existing list
- T – to transpose a 2D matrix
Source: parts of this page were written by the following TI|BD contributors: burr, DarkerLine, GoVegan, Myles_Zadok, Trenly.
History
| Calculator | OS Version | Description |
|---|---|---|
| TI-82 | 1.0 | Added |
Created: February 23, 2023 23:15:01