data_element create matrix sparse
Allows you to create a SPARSE MATRIX.
The MATRIX to be defined is SPARSE therefore, the VALUES parameter specifies only the entries that may be non zero. That is, all entries in the M by N array not assigned values by the ROW_INDEX, COLUMN_INDEX, and VALUES parameters are assumed to be equal to zero in ADAMS. Therefore, the kth entry in the VALUES parameter is assigned to the row identified by the kth entry in ROW_INDEX and to the column identified by the kth entry in COLUMN_INDEX for k=1,2,...,n.
Format:
data_element create matrix sparse |
|---|
matrix_name = | New Sparse matrix |
adams_id = | integer |
comments = | String |
row_index = | integer |
column_index = | integer |
values = | real |
units = | String |
Example:
data_element create matrix sparse & |
|---|
matrix_name = | MATRIX__1 & |
row_index = | 2,3 & |
column_index = | 1,1 & |
values = | 3.456,4.567 |
This will create a matrix will looks like the following:
0.000, 0.000 ,0.000
3.456, 0.000, 0.000
4.567, 0.000, 0.000
Description:
Parameter | Value Type | Description |
|---|
matrix_name | Matrix_name | Specifies the name of the new matrix. |
adams_id | Integer | Specifies an integer used to identify this element in the ADAMS data file. |
Comments | String | Specifies comments for the object being created or modified. |
row_index | Integer | Specifies the row position of each of the N entries in the VALUES parameter for a SPARSE MATRIX. |
column_index | Integer | Specifies the column position of each of the M entries in the VALUES parameter for a SPARSE MATRIX. |
Values | Real | Specifies the real number values that you enter to populate a SPARSE MATRIX. |
units | String | Allows you to specify the type of units to be used for this object. |
Extended Definition:
1. Adams View will not allow you to have two matrices with the same full name, so you must provide a unique name.
Normally, entity names are composed of alphabetic, numeric, or '_' (underscore) characters, and start with an alphabetic or '_' character. They may be any length. For more information, see
Using Extended Names.
By enclosing the name in double quotes, you may use other printable characters, or start the name with a numeral. If a name contains characters, or starts with a numeral, you must always quote the name when entering it.
Note that you can specify the parentage of an entity (for example, what part "owns" a marker or a geometry element) when you CREATE it by changing the name. If you enter just the entity name, then the default parent will be assigned by Adams View. If you type in the full name, then you may over ride the default parent. In most cases, when creating an entity, Adams View will provide a default name. The default name that Adams View provides will specify the parentage that it has assumed. You may, or course, delete this name and use your own. The form of a full name is:
"...._NAME.GRAND_PARENT_NAME.PARENT_NAME.ENTITY_NAME"
The number of levels used varies from case to case and the parentage must exist before an entity can be assigned to it.
2. When an Adams Solver data file (.adm) is read into Adams View, all comments associated with a statement (from the end of the previous statement through the end of the current statement) are stored with the object. Comments in the data file can be associated with model. These comments must follow the title statement and be followed by the comment 'END OF MODEL COMMENTS'. This string must be uppercase.
When an Adams Solver data file is written, the comments for an object are written before the statement corresponding to the object.
3. For each non-zero value in the SPARSE MATRIX each entry for this parameter defines to the position in the matrix of the corresponding entry in the VALUES parameter. For example, the third value entered for the ROW_INDEX parameter defines what matrix row the third value entered for the VALUES parameter is located on.
4. For each non-zero value in the SPARSE MATRIX each entry for this parameter defines to the position in the matrix of the corresponding entry in the VALUES parameter. For example, the forth value entered for the COLUMN_INDEX parameter defines what matrix column the forth value entered for the VALUES parameter is located on.
5. The MATRIX to be defined is SPARSE therefore, the VALUES parameter specifies only the entries that may be non zero. That is, all entries in the M by N array not assigned values by the ROW_INDEX, COLUMN_INDEX, and VALUES parameters are assumed to be equal to zero in ADAMS. Therefore, the kth entry in the VALUES parameter is assigned to the row identified by the kth entry in ROW_INDEX and to the column identified by the kth entry in COLUMN_INDEX for k=1,2,...,n.