keep(obj, [filterType], [filterNames])
keep(array, [filterType], [filterNames])
keep(attrType, [names], [filterType], [filterNames])
keep(attrType, names, masterSlave, [filterType], [filterNames])
keep(eleType, [filterType], [filterNames])
keep(stressModel, [filterType], [filterNames])
Remove all objects from this set that do not meet the given criteria Note that keep obeys the value of the downward associativity such that it will also keep the LOFs of any items kept if the downward associativity flag is set true. When called with an ObjectSet or an array, this function acts on all the objects contained within it. When called with attributes, it acts on those objects that have an assignment to the attributes given. In each case, an additional filter can be performed by specifying the type (and optionally name(s)) of objects to be acted on.
| objType | string | Name of an object type, such as "point", or "line" "Point", "Line", "Element", etc |
| names | string | Name(s)/ID(s) of objects or attributes. Examples are ""bob"", "Structural Support 2", "3", "1T5" |
| obj | object | An object to act on. Typically another ObjectSet object, or any other object derived from DatabaseMember |
| array | array | An array of objects derived from DatabaseMember |
| filterType | string | Restricts operation of this function to only objects of the type given |
| filterNames | string | Restricts operation of this function to only those objects whose names/IDs are given |
| attrType | string | "Loading", "Support", "Material", etc |
| masterSlave | boolean | "Master"/true or "Slave"/false |
| eleType | string | Name of a LUSAS element, e.g. "QTS4" |
| stressModel | string | Name of a LUSAS stress model e.g. "Thick Shell" |
| Return value | Pointer to this object | Allows multiple function calls to be chained together |
Example
To build a set that contains only surfaces and that have support "fixed" assigned
set x = newObjectSet()
call x.add("Support", "Fixed") ' make the assignments visible
call x.keep("Surface", "All") ' make any points lines etc invisible
call visible.keep("Material", "Aluminium") ' remove objects that do not have this assignment
Back to ObjectSet
Back to Overview