Create an IMAT_GROUP object.
group=imat_group
group=imat_group(M,N,P,...)
group=imat_group(N)
group=imat_group(S)
group=imat_group(T)
The IMAT_GROUP class contains FEM group entity information. It provides a number of methods for working with the data.
IMAT_GROUP with no arguments will create a scalar IMAT_GROUP object with no entities.
IMAT_GROUP(M,N,P,...) where M,N,P, and so on are positive scalar integers, will create an IMAT_GROUP with dimension [M N P...].
IMAT_GROUP(EM), where EM is an Nx2 matrix containing the entity information (ID in column 1, type in column 2), will create an IMAT_GROUP with the supplied entities.
IMAT_GROUP(S), where S is a structure containing fields with the same name as the properties of IMAT_GROUP, will convert the structure into an IMAT_GROUP object.
IMAT_GROUP(T), where T is an IMAT_CTRACE, will create a group from the entities in T. Entities with cartesian coordinates (X through RZ) are assumed to be nodes, and all others are assumed to be unknown.
The IMAT_GROUP object contains several properties that define the group entities:
| .id | Group ID (numeric scalar) |
| .name | Group name (string up to 80 characters) |
| .data | Nx2 matrix of entity IDs (column 1) and their associated entity types (column 2). The rows (combination of ID and entity type) must be unique. |
| .type | Read-only property that returns a structure that defines the numeric data type for each supported entity type |
You can control the maximum number of items displayed by setting the .numdisplay property. If a group contains more entities than this value, only the summary information is displayed for that group.
Several dependent properties are also defined for easier access to the entities in the group. You can get and set entities using the following properties:
| .cs | Coordinate system IDs |
| .elem or .element | Element IDs |
| .node | Node IDs |
| .scalar_point | Scalar points |
| .tl or .traceline | Traceline IDs |
>> elem_id = g.element;
>> g.node = 1:10;