CoCreate OneSpace Designer - Commands Reference Manual

MODIFY_RELATION terminate action

MODIFY_RELATION modifies an existing Relation definition.

Syntax


  ---->(MODIFY_RELATION)----+
                            |
    +-----------------------+
    |
    |  +-->|select Fixed Relation|--+
    +--+                            +--+
    |  +-->|select Rigid Relation|--+  |
    |                                  |
    |                 +----------------+
    |                 |
    |                 +---------------------<------------------------+
    |                 |                                              |
    |                 +-(:NAME)-----------|enter Relation name|------+
    |                 |                                              |
    |                 +-(:OBJECTS)--------|select objects|-----------+
    |                 |                                              |
    |                 +-(:PREVIEW)-----------------------------------+
    |                 |                                              |
    |                 +-(:AUTO_SOLVE)-----+-->(:YES)---+-------------+
    |                 |                   |            |
    +---<-(:NEXT)<----+                   +-->(:NO)----+
    |
    |
    |  +-->|select Distance Relation|-------+
    |  |                                    |
    |  +-->|select Angle Relation|----------+
    |  |                                    |
    |  +-->|select Parallel Relation|-------+
    +--+                                    +--+
    |  +-->|select Perpendicular Relation|--+  |
    |  |                                    |  |
    |  +-->|select Coincident Relation|-----+  |
    |  |                                    |  |
    |  +-->|select Tangent Relation|--------+  |
    |                                          |
    |                 +------------------------+
    |                 |
    |                 +---------------------<------------------------+
    |                 |                                              |
    |                 +-(:NAME)----------|enter Relation name|-------+
    |                 |                                              |
    |                 +-(:FIRST_REF)-----|select 1st Ref Elem|-------+
    |                 |                                              |
    |                 +-(:SECOND_REF)----|select 2nd Ref Elem|-------+
    |                 |                                              |
    |                 |                  +-->(:NO)-------------------+
    |                 +-(:PLANAR)--------+                           |
    |                 |                  +-->(:YES)---+              |
    |                 |                               |              |
    |                 |  +----------------------------+              |
    |                 |  |                                           |
    |                 |  +-(:PLANE_REF)--|select plane reference|----+
    |                 |                                              |
    |                 +-(:FOCUS1_BASIC)------------------------------+
    |                 |                                              |
    |                 +-(:FOCUS1_CENTER)-----------------------------+
    |                 |                                              |
    |                 +-(:FOCUS1_AXIS)-------------------------------+
    |                 |                                              |
    |                 +-(:FOCUS1_PLANE)------------------------------+
    |                 |                                              |
    |                 +-(:FOCUS1_DIRECTION)--------------------------+
    |                 |                                              |
    |                 +-(:FOCUS2_BASIC)------------------------------+
    |                 |                                              |
    |                 +-(:FOCUS2_CENTER)-----------------------------+
    |                 |                                              |
    |                 +-(:FOCUS2_AXIS)-------------------------------+
    |                 |                                              |
    |                 +-(:FOCUS2_PLANE)------------------------------+
    |                 |                                              |
    |                 +-(:FOCUS2_DIRECTION)--------------------------+
    |                 |                                              |
    |                 +  +->(:VALUE-TYPE)-+                          |
    |                 +  |                |                          |
    |                 +--+                +-(:VALUE)--|enter value|--+
    |                 +  |                                           |
    |                 +  +->(:EXPR-TYPE)--+                          |
    |                 +                   |                          |
    |                 +  +----------------+                          |
    |                 +  |                                           |
    |                 +  +-(:EXPR)-------|enter expression|----------+
    |                 +                                              |
    |                 |                                              |
    |                 +  +->(:DIRECTION_POSITIVE)-----------------+  |
    |                 |  |                                        |  |
    |                 +--+->(:DIRECTION_NEGATIVE)-----------------+--+
    |                 |  |                                        |  |
    |                 +  +->(:DIRECTION_OPEN)---------------------+  |
    |                 |                                              |
    |                 |                                              |
    |                 +  +->(:NORMALS_SAME)-----------------------+  |
    |                 |  |                                        |  |
    |                 +--+->(:NORMALS_OPPOSITE)-------------------+--+
    |                 |  |                                        |  |
    |                 +  +->(:NORMALS_OPEN)-----------------------+  |
    |                 |                                              |
    |                 +  +->(:SIDE_INFRONT)-----------------------+  |
    |                 |  |                                        |  |
    |                 +--+->(:SIDE_BEHIND)------------------------+--+
    |                 |  |                                        |  |
    |                 +  +->(:SIDE_OPEN)--------------------------+  |
    |                 |                                              |
    |                 +-(:PREVIEW)-----------------------------------+
    |                 |                                              |
    |                 +-(:AUTO_SOLVE)----+-->(:YES)---+--------------+
    |                 |                  |            |
    +---<-(:NEXT)<----+                  +-->(:NO)----+

Options

The following qualifiers apply to Fixed and Rigid Relations:

:NAME - the name of the Relation to be created.
:OBJECTS - the object(s) to which the Fixed/Rigid Relation will be applied.
:PREVIEW - specifies that the solution of the current relation set, including the relation being defined, is to be previewed. If AUTO_SOLVE is set to :NO, the components of the assembly will be returned to their original positions after COMPLETE.
:AUTO_SOLVE - specifies whether or not the current Relation set should be solved after submission of the Relation definition.
:NEXT - allows you to go immediately to the start of the next Relation modification.

The following qualifiers apply to Value and Logical Relations:

:FIRST_REF - specifies the first Reference Element.
:SECOND_REF - specifies the second Reference Element.
:PLANAR - (Angle Relation only) specifies whether or not the angle in an Angle Relation should be planar. If :YES is specified, a :PLANE_REF must be specified.
:PLANE_REF - (Angle Relation only) if :PLANAR has been specified, this parameter specifies the reference plane onto which the Reference Elements will be projected and on which the angle will be measured.
:FOCUS1_BASIC - specifies that the basic first Reference Element should be the focus, e.g. the focus of a cylinder should be the cylinder not its axis.
:FOCUS1_CENTER - specifies Center as the first Reference Element Focus.
:FOCUS1_AXIS - specifies Axis as the first Reference Element Focus.
:FOCUS1_PLANE - specifies Plane as the first Reference Element Focus.
:FOCUS1_DIRECTION - specifies Direction as the first Reference Element Focus, e.g. when using the direction of a swept b-spline in an Angle Relation definition.
:FOCUS2_BASIC - specifies that the basic second Reference Element should be the focus, e.g. the focus of a cylinder should be the cylinder not its axis.
:FOCUS2_CENTER - specifies Center as the second Reference Element Focus.
:FOCUS2_AXIS - specifies Axis as the second Reference Element Focus.
:FOCUS2_PLANE - specifies Plane as the second Reference Element Focus.
:FOCUS2_DIRECTION - specifies Direction as the second Reference Element Focus, e.g. when using the direction of a swept b-spline to define an Angle Relation.
:VALUE-TYPE - (Value Relation only) specifies that a discrete value is to be supplied. :VALUE is used to specify the discrete value.
:EXPR-TYPE - (Value Relation only) specifies that a mathematical expression is to be supplied, rather than a discrete value. :EXPR is used to express the mathematical expression.
:DIRECTION_POSITIVE - (Angle Relations only) sets the Direction option to Positive. The angle specified is to be applied in the positive direction according to the right-hand rotation rule.
:DIRECTION_NEGATIVE - (Angle Relations only) sets the Direction option to Negative. The angle specified is to be applied in the negative direction according to the right-hand rotation rule.
:DIRECTION_OPEN - (Angle Relations only) sets the Direction option to Open. The system will attempt to choose the angular direction, to produce minimum parts movement.
:NORMALS_SAME - (Distance, Parallel, Coincident and Tangent Relations) sets the Normals option to Same Dir. The Reference Elements will be oriented with their normals in the same direction.
:NORMALS_OPPOSITE - (Distance, Parallel, Coincident and Tangent Relations) sets the Normals option to Opp Dirs. The Reference Elements will be oriented with their normals in opposite directions.
:NORMALS_OPEN - (Distance, Parallel, Coincident and Tangent Relations) sets the Normals option to Open. The system will choose the directions of the normals to the Reference Elements, to produce minimum parts movement.
:SIDE_INFRONT - (Distance Relations only) sets the Displacement option to Positive. The second reference will be placed in front of the first reference element, relative to its normal direction.
:SIDE_BEHIND - (Distance Relations only) sets the Displacement option to Negative. The second reference will be placed behind the first reference element, relative to its normal direction.
:SIDE_OPEN - (Distance Relations only) sets the Displacement option to Open. The system attempts to choose whether the second reference will be placed in front of, or behind, the first reference element, to produce the minimum parts movement.
:PREVIEW - specifies that the solution of the current relation set, including the relation being defined, is to be previewed. If :AUTO_SOLVE is set to :NO, the components of the assembly will be returned to their original positions after COMPLETE.
:AUTO_SOLVE - specifies whether or not the current Relation set should be solved after submission of the Relation definition.
:NEXT - allows you to go immediately to the start of the next Relation modification.

When to use

Use this action to modify an existing Relation definition within the active Relation Set.

The following parameter sequence modifies an existing Distance Relation, changing its name to "dis1a", changing the specified distance value to "50"cm and setting the normals of the Reference Elements in opposite directions. The solution will be previewed, but the Relation Set will not be solved.

MODIFY_RELATION [select Distance Relation] :NAME "dis1a" :VALUE_TYPE :VALUE "50" :NORMALS_OPPOSITE :PREVIEW :AUTO_SOLVE :NO COMPLETE

All input strings must be enclosed by double quotes (" ").

CoCreate OneSpace Designer - Commands Reference Manual

MODIFY_RELATION terminate action

Syntax

Options

When to use

Example

See also