Matrix Definition
This dialog enables you to define amatrix object inModel Maker. Once a matrix has been defined for a particular model, it is saved with that model.
This dialog is opened when you double-click a matrix graphic that has been placed on the Model Maker page or when you select Edit | Properties from the Model Maker menu bar with a matrix selected. Actually two dialogs will be opened; one for the Matrix Definition options, and one containing aCellArray that lets you set up the Matrix.
Select:
Select the type of matrix to use. The options that are displayed in this dialog will depend on which of these is selected.Built_In Click to use a built-in matrix. Select the matrix from the Built In popup list, below.
Custom_Matrix Click to define a custom matrix using the CellArray. This custom matrix can be based on a built-in matrix by selecting Built-In first, and then editing the values in the CellArray manually.
Read Click to read in an existing matrix.
Output Click to have an output matrix created by the model. All options will be disabled because the model will generate a matrix of the size appropriate for the function being performed.
The following options displayed if you click the Built_In option above.
Built In:
Select one of the pre-defined matrices to use.Kernel: Click on the popup list button to select a matrix from a list of commonly used convolution kernels:
Matrix Definition
Summary
Size: Click on the popup list button to select a size for the built-in matrix: 3x3, 5x5 or 7x7.
The following options are displayed if you click the Custom_Matrix option above.
Create Custom:
Use this group to specify parameters for a custom matrix. These options are enabled when you select Custom_Matrix.Type: Click on the popup list button to select thedata type for the matrix.
Binary Integer Float
Size: Define the size of your custom matrix. The maximum size is 512 x 512.
Shape Definition:
This group of options is enabled when you select Shape, below. It allows you to define a circular, rectangular, or doughnut-shaped kernel within the matrix.(Other values are usually zero.)
Within Shape: Click on the popup list button to choose the shape of the kernel within the matrix.
Circular The kernel will be circular.
Rectangular The kernel will be rectangular.
Within Radius: Specify the number of cells from the center of the matrix to extend the circle.
width: Specify the width (X dimension) of the inner kernel, measured from the center cell.
height: Specify the height (Y dimension) of the inner kernel, measured from the center cell.
Matrix Definition
This value must be less than the value entered in Within Radius.
width: Specify the width (X dimension) of the inner shape, measured from the center cell.
height: Specify the height (Y dimension) of the inner shape, measured from the center cell.
Apply
Click to apply a new value to the selected cells or the defined shape of the matrix.Value:
Enter the value to assign to the selected cells or the defined shape of the matrix.After specifying the Within Radius and/or Beyond Radius, you must enter a value and click Apply to change the shape of the kernel and apply the correct values.
to: Indicate whether the selected value entered should be applied to a shape or a selection.
Shape Values in the table, based on the shape specified in the Shape Selection The following options are displayed if you click the Read option above.
Read Matrix From:
If you select Read, above, you must enter the name of the matrix to read or click on theFile Selector button. The default file extension is .mtx.Prompt for File at Run Time Click to specify the file to read from at the time the model is executed. Do not specify a file in the current dialog. A new dialog to select a file is displayed when the model is executed.
The following options are displayed if you click the Output option above.
Output Options:
If you are creating an Output matrix, you can select whether or not to write the matrix to a file.Write To File: Click to write the output matrix to a file. When this option is selected, the file name part is enabled and you can enter a name for the file or click on theFile Selector button. The .mtx extension will be added automatically. This ASCII file can then be used as input in other models or imported into other software packages for statistical or other analysis.
Prompt for File at Run Time Click to specify the file to write to at the time the model is executed. Do not specify a file in the current dialog. A new dialog to select a file is displayed when the model is executed.
Show Matrix in Session Log Click to write the output matrix to the Session Log when the model is run.
Matrix Definition