2.2.2.3 mdim
Menu Information
Matrix: Set Dimensions/values
Brief Information
Set matrix dimensions and XY coordinates
Command Line Usage
1. mdim ms:=MSheet1 cols:=10 rows:=10;
2. mdim c:=10 r:=10 x1:=0 x2:=9 y1:=0 y2:=9;
X-Function Execution Options
Please refer to the page for additional option switches when accessing the x-function from script
Variables
Display
Name
|
Variable
Name
|
I/O
and
Type
|
Default
Value
|
Description
|
| Matrix
|
ms
|
Input/Output
MatrixLayer
|
<active>
|
Specifies the matrix sheet to be manipulated.
|
| Columns
|
cols
|
Input
int
|
<auto>
|
Specifies the number of columns.
|
| Rows
|
rows
|
Input
int
|
<auto>
|
Specifies the number of rows.
|
| First X
|
x1
|
Input
double
|
<auto>
|
Specifies the value of the first X coordinate.
|
| Last X
|
x2
|
Input
double
|
<auto>
|
Specifies the value of the last X coordinate.
|
| First Y
|
y1
|
Input
double
|
<auto>
|
Specifies the value of the first Y coordinate.
|
| Last Y
|
y2
|
Input
double
|
<auto>
|
Specifies the value of the last Y coordinate.
|
Description
You can use this X-Function to control the number of rows and columns and the X and Y (column and row) mapping arrangement for matrices.
Row and column numbers are positive integers. They determine the number of cells in the matrix. If a matrix is a numeric matrix, you can use this X-Function to change the dimension. However, you cannot change the dimensions for images.
The X and Y coordinates of matrix data are assumed to be evenly spaced. When you set the first and last X, the first X is mapped to the first column and the last X is mapped to the last column. The X coordinates of other columns will be linearly mapped. Similar mapping applies to rows, but the first Y and the last Y are used. For a point that corresponds to a matrix cell, its position in 3D space is determined by the X and Y coordinates of this cell, as well as the Z value that is saved in the cell. When matrix data is plotted or analyzed, the XY coordinates, instead of the row and column numbers, will be used.
Examples
- Create a new matrix by clicking the New Matrix button on Standard toolbar.
- Select Matrix: Set Dimensions from the Origin menu to open the dialog of mdim.
- In the dialog, enter 10 for Columns and Rows, 2 for First X and First Y and 20 for Last X and Last Y. Click OK to close the dialog.
- Select View: Show X/Y from the menu to view the coordinates.
Keywords:scale, calibrate, calibration
|