Skip to main content
Version: 16

FILTER

Creates an ID list of model objects based on object type and attributes.

Description

The FILTER command lists object IDs with the given object types. All object types that are given will serve as a basis for the filtering. The filtering can be restricted based on values of object attributes. The attribute based filters are optional. If there is none given, then the result array will contain all object IDs with the specified object type(s). If there is more then one filter condition, then the result will be the intersection of the filtered sets of objects, in other words the objects for which all filter conditions are true.

Syntax

FILTER [Result array]
Objecttypes [Object type]
[Filter 1] [Filter 1 value]
[Filter 2] [Filter 2 value]
[Filter 3] [Filter 3 value]
etc.

Command parameters

Command parameterAssignmentValue formatInput options
Result arrayRequiredStringLocal, variable
Object typeRequiredPredefined stringsLocal, variable
FiltersOptionalPredefined stringsLocal, variable
Filter valuesOptionalString, integer, floatLocal, variable

Result array:

The array that will contain the IDs of objects that are the result of the filtering.

Object type:

Object types the command will filter within. One ore more object types can be given for one FILTER command within the objecttypes row.

Available object types:
Object type nameObject type
Structural members tab-
Structural memberStructural_Member
Structural PlateStructural_Plate
Point supportSupport_Point
Line supportSupport_Edge
Surface supportSupport_Plate
Loads tab-
Load caseLoadCase
Load combinationLoadCombination
Point loadNodeForce
Line loadMemberForce
Surface loadPlateForce
Mass tab-
Mass caseMassCase
Mass combinationMassCombination
Other-
PortionPortion

Filters:

The object attributes based on which the filtering will be executed.

Available object attributes for filtering:
Filter nameFilterApplicable object types
Material namematerialStructural_Member, Structural_Plate
Object namenameAll types
Plate thicknessplatethicknessStructural_Plate
Section namesectionStructural_Member
Group namegroupidStructural_Member, Structural_Plate
Section groupsectiontypeStructural_Member, Section

Filter values:

The attribute values that will be used for filtering.

Sample code

All structural members:

FILTER Mem_IDs
Objecttypes Structural_member

All load combinations:

FILTER LC_IDs
Objecttypes Loadcombination

All structural members and plates with material "S 235 EN 10025-2":

FILTER Filter_Result_IDs
Objecttypes Structural_Member Structural_Plate
Material "S 235 EN 10025-2"

All structural plates with material "S 235 EN 10025-2" and thickness of 20 mm:

FILTER Filter_Result_IDs
Objecttypes Structural_plate
Material "S 235 EN 10025-2"
Platethickness 20