group modify
Allows the modification of an existing Adams View groups.
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 modify |
|---|
group_name = | existing group name |
new_group_name = | new group name |
comments = | string |
objects_in_group = | existing entity |
type_filter = | entity |
expand_groups = | yes/no |
expr_active = | integer |
Example:
group modify & |
|---|
group_name = | pendulum_parts & |
group_name = | pend_parts_and_joints & |
comments = | "group containing all parts and joints" & |
objects_in_group = | model_1.part_2,.model_1.part_3,.model_1.joint_1 |
Description:
Parameter | Value Type | Description |
|---|
group_name | Group Name | Specifies the name of the existing group to be modified. |
New_group_name | New Group Name | Specifies the new name for the group. You may us e this name later to refer to this group. |
comments | String | Specifies comments for the group being created or modified. |
objects_in_group | Entity | Specify the objects to be in the group. |
type_filter | Entity Type | Specify the type of objects allowed. |
expand_groups | Yes/no | Specify 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 full 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 its name only. 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 wldcaring 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 so 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).