CoCreate OneSpace Designer - Commands Reference Manual

CREATE_RELATION terminate action

CREATE_RELATION creates a new Relation definition.

Syntax


---->(CREATE_RELATION)----+
                          |
  +-----------<-----------+
  |
  |  +->(:FIXED)-------+
  +--+                 |
  |  +->(:RIGID)-------+
  |                    |
  |  +-----------------+-----------------------------------------------+
  |  |                 |                                               |
  |  |                 +---------------------<--------------------+    |
  |  |                 |                                          |    |
  |  |                 +-(:NAME)-----------|enter Relation name|--+    |
  |  |                 |                                          |    |
  |  |                 +-(:OBJECTS)--------|select objects|-------+    |
  |  |                 |                                          |    |
  |  |                 +-(:PREVIEW)-------------------------------+    |
  |  |                 |                                          |    |
  |  |                 +--(:AUTO_SOLVE)--+--(:YES)--+-------------+    |
  |  |                 |                 |          |                  |
  |  +--<--(:NEXT)--<--+                 +--(:NO)---+                  |
  |                    |                                               |
  |                    +-----------------------------------------------+
  |                                                                    |
  +--(:FREE_DISTANCE)--+                                               |
  |                    |                                               |
  +--(:FREE_ANGLE)-----+                                               |
  |                    |                                               |
  +--(:FREE_NUMBER)----+                                               |
  |                    |                                               |
  |  +-----------------+-----------------------------------------------+
  |  |                 |                                               |
  |  |                 +---------------------<--------------------+    |
  |  |                 |                                          |    |
  |  |                 +--(:NAME)--|name|-------------------------+    |
  |  |                 |                                          |    |
  |  |                 +--(:VALUE-TYPE)--|type|-------------------+    |
  |  |                 |                                          |    |
  |  |                 +--(:VALUE)--|value|-----------------------+    |
  |  |                 |                                          |    |
  |  |                 +--(:EXPR-TYPE)--|type|--------------------+    |
  |  |                 |                                          |    |
  |  |                 +--(:EXPR)--|expression|-------------------+    |
  |  |                 |                                          |    |
  |  |                 +--(:PREVIEW)------------------------------+    |
  |  |                 |                                          |    |
  |  |                 +--(:AUTO_SOLVE)--+--(:YES)--+-------------+    |
  |  |                 |                 |          |                  |
  |  +--<--(:NEXT)--<--+                 +--(:NO)---+                  |
  |                    |                                               |
  |                    +-----------------------------------------------+
  |                                                                    |
  +--(:MEASURE_LENGTH)-+                                               |
  |                    |                                               |
  +--(:MEASURE_RADIUS)-+--+--(:MAJOR)--+---+                           |
  |                    |  |            |   |                           |
  |                    |  +--(:MINOR)--+   |                           |
  |                    |                   |                           |
  |  +--->-------------+---------<---------+                           |
  |  |                 |                                               |
  |  |            |select ref|                                         |
  |  |                 |                                               |
  |  +---<-------------+------------------------------------------+    |
  |  |                 |                                          |    |
  |  |                 +---------------------<--------------------+    |
  |  |                 |                                          |    |
  |  |                 +--(:NAME)--|name|-------------------------+    |
  |  |                 |                                          |    |
  |  |                 +--(:REF)--(select ref)--------------------+    |
  |  |                 |                                          |    |
  |  |                 +--(:PREVIEW)------------------------------+    |
  |  |                 |                                          |    |
  |  |                 +--(:AUTO_SOLVE)--+--(:YES)--+-------------+    |
  |  |                 |                 |          |                  |
  |  +--<--(:NEXT)--<--+                 +--(:NO)---+                  |
  |                    |                                               |
  |                    +-----------------------------------------------+
  |                                                                    |
  |  +->-(:DISTANCE)----------+                                        |
  |  |                        |                                        |
  |  +->-(:REL_ANGLE)---------+                                        |
  |  |                        |                                        |
  |  +->-(:PARALLEL)----------+                                        |
  +--+                        |                                        |
  |  +->-(:PERPENDICULAR)-----+                                        |
  |  |                        |                                        |
  |  +->-(:COINCIDENT)--------+                                        |
  |  |                        |                                        |
  |  +->-(:TANGENT)-----------+                                        |
  |  |                        |                                        |
  |  +->-(:MEASURE_DISTANCE)--+                                        |
  |  |                        |                                        |
  |  +->-(:MEASURE_ANGLE)-----+                                        |
  |                           |                                        |
  |                 +---------+                                        |
  |                 |                                                  |
  |       |select 1st ref elem|                                        |
  |                 |                                                  |
  |       |select 2nd Ref Elem|                                        |
  |                 |                                                  |
  |                 +---------------------<------------------------+   |
  |                 |                                              |   |
  |                 +-(: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:

:FIXED - specifies a Fixed Relation type.
:RIGID - specifies a Rigid Relation type.
: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 creation.

The following qualifiers apply to Variable Relations:

:FREE_DISTANCE - specifies a variable distance relation.
:FREE_ANGLE - specifies a variable angle relation.
:FREE_NUMBER - specifies a variable number relation.
:NAME - specifies the name of the variable.
:VALUE-TYPE - specifies that a numerical value will be entered for the relation.
:VALUE - specifies a numerical value for the relation.
:EXPR-TYPE - specifies that a mathematical expression will be entered for the relation.
:EXPR - specifies a mathematical expression for the relation.
: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 creation.

The following qualifiers apply to Measured Length and Measured Radius Relation types:

:MEASURE_LENGTH - specifies a measured length type relation.
:MEASURE_RADIUS - specifies a measured radius type relation. For tori and ellipses, both a :MINOR radius and a :MAJOR radius can be specified.
:NAME - the name of the relation to be created.
:REF - the reference element for the relation to be created.
: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 creation.

The following qualifiers apply to Value and Logical Relations as well as to Measured Distance and Measured Angle Relations:

:DISTANCE - specifies a Distance Relation type.
:REL_ANGLE - specifies a Angle Relation type.
:PARALLEL - specifies a Parallel Relation type.
:PERPENDICULAR - specifies a Perpendicular Relation type.
:COINCIDENT - specifies a Coincident Relation type.
:TANGENT - specifies a Tangent Relation type.
:MEASURE_DISTANCE - specifies a Measured Distance Relation type.
:MEASURE_ANGLE - specifies a Measured Angle Relation type.
:FIRST_REF - (optional) allows you to change the first Reference Element previously selected.
:SECOND_REF - (optional) allows you to change the second Reference Element previously selected.
: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 Relations only) specifies that a discrete value is to be supplied. :VALUE is used to specify the discrete value.
:EXPR-TYPE - (Value Relations 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 and Measure 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 and Measure 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 and Measure 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 creation.

When to use

Use this action to create a new Relation definition within the active Relation Set.

Example

The following parameter sequence creates a Fixed Relation called "fix1" for part "p2" in assembly "a2". The solution will be previewed, but the Relation Set will not be solved.
CREATE_RELATION :FIXED :NAME "fix1" :OBJECTS "/a2/p2" :PREVIEW :AUTO_SOLVE :NO COMPLETE
The following parameter sequence creates an Angle Relation called "ang1" with a positive planar angle of "45" degrees between the axes of 2 Reference Elements (e.g. cylinders). The solution will be previewed, but the Relation Set will not be solved.
CREATE_RELATION :REL_ANGLE [specify 1st Reference Element] [specify 2nd Reference Element] :NAME "ang1" :PLANAR :PLANE_REF [specify plane reference] :FOCUS1_AXIS :FOCUS2_AXIS :VALUE_TYPE :VALUE "45" :DIRECTION_POSITIVE :PREVIEW :AUTO_SOLVE :NO COMPLETE