SET – Set Definition
Defines a set of grids, elements, design variables, MBD entities, mode numbers, frequencies or times for reference by other input definitions.
Format
(1) |
(2) |
(3) |
(4) |
(5) |
(6) |
(7) |
(8) |
(9) |
(10) |
SET |
SID |
TYPE |
SUBTYPE/ |
|
|
|
|
|
|
|
ID1/ |
ID2/ |
ID3/ |
ID4/ |
ID5/ |
ID6/ |
ID7/ |
ID8/ |
|
|
ID9/ |
… |
… |
… |
… |
… |
… |
… |
|
|
… |
… |
|
|
|
|
|
|
|
(1) |
(2) |
(3) |
(4) |
(5) |
(6) |
(7) |
(8) |
(9) |
(10) |
SET |
SID |
TYPE |
SUBTYPE |
|
|
|
|
|
|
|
ID1 |
THRU |
ID2 |
EXCEPT |
ID3 |
ID4 |
ID5 |
ID6 |
|
|
ID7 |
… |
ENDTHRU |
|
|
|
|
|
|
|
… |
|
|
|
|
|
|
|
|
The following set contains the grids 1, 17, 22, 23, 29, 33, 35, 48, 88, 93 and 102. It is defined using a simple ID list (assuming that these GRID cards are present in the Bulk Data).
|
The following set contains the elements 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 33, 34, 34, 35, 36, 37, 38, 41, 42, 43, 44, 45, 94, 95, 96. 97, 98, 99, 106, 107, 108, 109, 110, 111, 120, 121 and 125. It is defined using a combination of ID ranges and lists.
|
The following set includes any element included in sets 29, 30 or 31. It is defined as Boolean set.
|
The following set defines GRID/Component list; intended for use by PFMODE.
|
The following set defines list of strings.
|
The following set defines list of all elements with specific properties.
|
The following set outputs all of the grids on PLOTEL.
|
Field |
Contents |
SID |
Unique set identification number. See comment 1. No default (Integer > 0) |
TYPE |
Identifies what type of entities the set is comprised of. See comment 2 for description of the types. No default (GRID, ELEM, RIGID, GRIDC, DESVAR, MODE, FREQ, TIME, LABEL or PLY) |
SUBTYPE |
Indicates how the set is defined. See comment 2 for description of subtypes. Default = LIST (LIST, BBOX, PROP, MAT, ELTYPE, or ELEM) |
OPERATOR |
Operators supported in defining Boolean sets. See comments 4, 5, and 6. No default (OR, AND, NOT, or MINUS) |
ID# |
ID list. Only valid for certain combinations of TYPE and SUBTYPE. The entity to which the ID corresponds depends on the TYPE and SUBTYPE of the set (see comment 2). ID ranges may be used in combination with ID lists. The keywords EXCEPT and THRU are used to define ID ranges. The keyword ENDTHRU identifies the end of an ID range and is required if an ID list is to follow where the first value is within the previous range. ID lists following EXCEPT must be in ascending order and must exist within the previous range. No default (Integer > 0) |
MODE# |
Mode number list. Only valid when TYPE is MODE (see comment 2). Mode number ranges may be used in combination with Mode number lists. The same rules apply as for ID ranges. No default (Integer > 0) |
REAL# |
Real value list. Only valid when TYPE is FREQ or TIME (see comment 2). No default (Real) |
NAME# |
Keyword list. Only valid for certain combinations of TYPE and SUBTYPE. The keyword EXCEPT is allowed only as the first entry in a keyword list. Default = Undefined (see comment 2) |
SID# |
Identification number of another SET definition. Used in defining Boolean sets. Only valid when OPERATOR is defined in SUBTYPE/OPERATOR field (see comments 4, 5, 6, and 7). No default (Integer > 0 or <PartName.number>) |
X1, Y1, Z1 |
X, Y, and Z coordinates of two opposing corners of a cuboid. Only valid when SUBTYPE is BBOX (see comment 2). No default (Real) |
G1, G2 |
Grid ID’s (G1, G2) can be used instead of (X1, Y1, Z1), (X2, Y2, Z2) data (see field descriptions above). G1, G2 should be defined in the basic coordinate system (CP field on the GRID entries should be blank). |
ALL |
Keyword used for ID lists to indicate that all IDs of the appropriate entity type are to be included in the set. Only valid in first field of ID list. May be followed by keyword EXCEPT (see below). |
THRU |
Keyword used for ID ranges to indicate that all IDs between the preceding ID and the following ID are to be included in the set. Definition of range may contain list of exceptions in the following form: N1 THRU N2 EXCEPT N3 N4 ... ENDTHRU where N1 < N3 < N4... < N2; N1 < N2 |
EXCEPT |
Keyword used for ID ranges and keyword lists to indicate that the following IDs or keywords are to be excluded from the set. Only valid in first field for keyword lists. When ALL is given as the first entry for an ID list, EXCEPT may be given as the second entry, in which case all subsequent IDs are excluded from the set of ALL entities of the defined TYPE. |
ENDTHRU |
Optional keyword used after EXCEPT to indicate the end of an excluded ID list definition. |
Comments
1. | SID must be unique with respect to all other SET definitions (regardless of type). It must also be unique with respect to any SURF entries and any legacy SET/PSET I/O Options definitions. |
2. | The following table describes subtype combinations and the set TYPEs for which they are valid. |
TYPE |
SUBTYPE |
Description |
||||||||
---|---|---|---|---|---|---|---|---|---|---|
GRID |
LIST |
This is a set of grids - structural grids (GRID) or scalar points (SPOINT) - defined either as a simple list of grid IDs, or as some combination of ranges of grid IDs and lists of grid IDs. |
||||||||
BBOX |
This is a set of grids defined by a bounding box. The fields X1, Y1, and Z1 provide the coordinates of one corner and X2, Y2, and Z2 the coordinates of an opposing corner of a cuboid. All grids contained within this cuboid are included in the set. The bounding box can also be defined using the G1 and G2 fields instead of (X1, Y1, and Z1) and (X2, Y2, and Z2), respectively. |
|||||||||
ELEM |
This is a set of structural grids (GRID) belonging to listed elements. |
|||||||||
ELEM |
LIST |
This is a set of elements defined either as a simple list of element IDs, or as some combination of ranges of element IDs and lists of element IDs. |
||||||||
BBOX |
This is a set of elements defined by a bounding box. The fields X1, Y1, and Z1 provide the coordinates of one corner and X2, Y2, and Z2 the coordinates of an opposing corner of a cuboid. All elements whose centroids are contained within this cuboid are included in the set. The bounding box can also be defined using the G1 and G2 fields instead of (X1, Y1, and Z1) and (X2, Y2, and Z2), respectively. |
|||||||||
PROP |
This is a set of elements defined in one of the following ways:
|
|||||||||
MAT |
This is a set of elements defined through a list of material IDs, or some combination of ranges of material IDs and lists of material IDs. All elements referencing properties, that in turn reference the selected materials, are included in the set. |
|||||||||
ELTYPE |
This is a set of elements defined in one of the following ways:
In addition to all valid element types, the following element type groupings may be used: |
|||||||||
SOLID |
for CTETRA, CPYRA, CPENTA and CHEXA elements referencing structural property definitions. |
|||||||||
FLAT |
for CQUAD4, CQUAD8, CTRIA3 and CTRIA6 elements. |
|||||||||
SHELL |
for FLAT elements referencing properties with non-zero MID2. |
|||||||||
MEMBRANE |
for FLAT elements referencing properties with zero MID2. |
|||||||||
BEAM |
for CBAR and CBEAM elements. |
|||||||||
ROD |
for CONROD and CROD elements. |
|||||||||
FLUID |
for CTETRA, CPYRA, CPENTA and CHEXA elements referencing fluid property definitions. |
|||||||||
For rigid elements (RROD, RBAR, RBE1, RBE2 and RBE3). See RIGID below. |
||||||||||
RIGID |
LIST |
This is a set of Rigid elements defined either as a simple list of Rigid element IDs, or as a combination of ranges of Rigid element IDs and lists of Rigid element IDs. |
||||||||
GRIDC |
LIST |
This is a set of GRID/Component pairs. |
||||||||
DESVAR |
LIST |
This is a set of design variables defined either as a simple list of design variable IDs, or as some combination of ranges of design variable IDs and lists of design variable IDs. |
||||||||
MODE |
LIST |
This is a set of mode numbers defined as a simple list of mode numbers, or as some combination of ranges of mode numbers and lists of mode numbers. This can also reference a list of RANDPS bulk data entry IDs. Such a SET bulk data entry can be referenced by the RANDOM Subcase Entry. |
||||||||
FREQ |
LIST |
This is a set of real values representing frequencies defined simply as a list of real values. |
||||||||
TIME |
LIST |
This is a set of real values representing times defined simply as a list of real values. |
||||||||
LABEL |
LIST |
List of arbitrary labels. Each label must start with a letter and contain only letters or digits. |
||||||||
PLY |
LIST |
This is a set of ply ID’s defined in the PLY or PCOMPG data entries. |
3. | SET definitions using IDs may refer to non-existing entities. This is allowed, but the actual SET will contain only grids or elements which are actually present in the structure. |
4. | The Boolean operators OR, AND, NOT and MINUS are recognized for SET combinations. These operators are described here: |
Operator |
Description |
---|---|
OR |
An entity is included in the SET, if it is included in a minimum of one of the constituent sets. OR is used to expand the SET by combining items from various SET’s (for example, an entity is included in SET, if it is present in SET 1, SET 2, or SET 3, or …). |
AND |
An entity is included in the SET, if it is included in all of the listed sets. AND is used to restrict the SET to a typically smaller subset (for example, an entity is included in SET, if it is present in SET 1, SET 2, and SET 3, and …). |
NOT |
An entity is included in the SET, if it is not included in the listed set (for example, if an entity is not included in SET 1, then it is included in SET). Note: Only one set should be listed for the NOT operator. |
MINUS |
An entity is included in the SET if it is included in the first set, but not in the second set. Note: Only two sets may be listed for when this operator is used. |
5. | Boolean SET definitions can only be used when all listed sets are of the same TYPE. |
6. | Boolean SET definitions can reference other Boolean sets, but circular references must be avoided. Boolean SET can be defined only for GRID, ELEM, or RIGID set types. |
7. | Supported local entries in specific parts can be referenced by the use of “fully qualified references” on SET entries in the model. A fully qualified reference (“PartName.number”) is similar to the format of a numeric reference. “PartName” is the name of the part that contains the referenced local entry (part names are defined on the BEGIN bulk data entry in the model). “number” is the identification number of a referenced local entry in the part “PartName”. See Parts and Instances in the User’s Guide for detailed information on the use of fully qualified references. |
The SET bulk data entry can be used in the global part to reference SET’s defined within different parts. These SET entries in the global part can contain fully qualified references to part-specific SET data only if logical operators (OPERATOR field) are used. For example:
The following SET entry exists in part “A”:
BEGIN, FEMODEL, A
SET, 29, ELEM, LIST
15 THRU 30
…
END, FEMODEL, A
Referencing SET, 29 in the global part “G”:
BEGIN, FEMODEL, G
SET, 78, ELEM, OR
A.29
…
END, FEMODEL, G
8. | ELIST is an alternative to SET and SURF, but ELIST is intended only to provide compatibility with Nastran decks. It is recommended to use SURF/SET, instead of ELIST. Additionally, |
• | The SURF and SET entries may not be combined with ELIST entries to define damp elements. |
• | ELIST entries are internally converted to SET entries. If ELIST is referenced on a minimum of one MFLUID entry, then all MFLUID entries in a model must reference ELIST entries. In such cases, if an MFLUID entry references a particular Set Identification Number (<SID>) to define WSURF1/WSURF2 fields without a corresponding ELIST,<SID> in the model, then OptiStruct will not search for a SET/SURF,<SID>. |
9. | This card is represented as a set in HyperMesh. |