group create
Allows you to create a new Adams View group.
An Adams View group is a collection of any Adams View objects except other groups. Groups can be used to control object's attributes, like visibility and color.
Format:
group create |
|---|
group_name = | new group name |
comments = | string |
objects_in_group = | existing entity |
type_filter = | entity |
expand_groups = | yes/no |
expr_active = | integer |
Example:
group create & |
|---|
group_name = | pendulum_parts & |
comments = | "group containing all parts of a pendulum" & |
objects_in_group = | .model_1.part_2,.model_1.part_3 & |
type_filter = | part & |
expand_groups = | no & |
expr_active = | 1 |
Description:
Parameter | Value Type | Description |
|---|
group_name | New Group Name | Specifies the name of the new group. You may use this name later to refer to this group. |
comments | String | Specifies comments for the group being created or modified. |
objects_in_group | Entity | Specifies the objects to be in the group. |
type_filter | Entity Type | Specifies the type of objects allowed. |
expand_groups | Yes/no | Specifies a Boolean value |
expr_active | Integer | EXPR_ACTIVE allows you to set the activity of the group using an integer value, which allows parameterization. |
Extended Definition:
1. Adams View will not allow you to have two group with the same name, so you must provide a unique name.
You may identify a group by typing its name. If a group is available by default, you may identify it by entering only its name. If it is not, you must enter its full name. If you type a "?", Adams View will list the group available by default.
You must separate multiple group names by commas.
2. The “objects_in_group” parameter takes one or more of any existing Adams View objects. If a wild card is used to specify the objects, the TYPE_FILTER parameter can be used to accept only objects of a particular type.
3. Adams View at this time does not allow expressions when specifying option lists. To allow the activity of a group to be set parametrically, the parameter EXPR_ACTIVE was added to the GROUP CREATE and GROUP MODIFY commands. This parameter takes on integer value.
If the value is not set, either because the parameter was never used, or it was unset with the (none) expression, then the standard activity rules apply.
If the EXPR_ACTIVE is set to an expression that evaluates to zero (FALSE), the objects in the group will be in active (and will not be included by Adams Solver in any simulation). If the value is the default or non-zero (TRUE), then the objects will be active (and will be included in simulations).