*JointIDScheme()
Specifies a scheme for assigning solver ID numbers to joints.
Syntax
*JointIDScheme(scheme)
Arguments
- scheme
- A string of uppercase letters that describes the identification numbering scheme for all joints.
Example
*JointIDScheme(EELSSI)
*JointIDScheme(LSSSEEE)
The same joint would have an ID number of 1004002 (1 004 002).
Context
Comments
Beginning at one, MotionView incrementally assigns numbers to all joints in a system or model. These numbers are used to construct solver ID numbers.
A joint ID scheme can contain the format characters L (locator), S (system number), P (point number) and I (incrementor). Each character in the scheme represents one digit of the identification number. Repetitions of a character in the ID scheme reserve that many spaces for that number in the ID. If a part number or system number has fewer digits than the places reserved for it in the ID scheme, it is padded with zeros on the left. Identification numbers can be up to eight characters long.
The incrementor (I) creates unique integer ID numbers for coincident joints. When a hard point appears in multiple connectivities, multiple joints are created at the same location on the body. The incrementor differentiates the coincident joints. If the format character I is not present in the *JointIDScheme() statement, the ID numbers of the coincident joint are selected from the ID number pool.
Element | Values | Limits |
---|---|---|
E entity | 0 - 9 | up to eight E’s per scheme |
I incrementor | 0 - 9 | up to eight I’s per scheme |
L location | 1 - left 2 - right 3 - neither |
only one L per scheme |
P point | 0 - 9 | up to eight P’s per scheme |
S system | 0 - 9 | up to eight S’s per scheme |
If a unique identification number as described by the scheme cannot be generated, a number from a pool is assigned. The pool begins at 70000000 and continues onward.
Joint identification numbers can be assigned in a *SetEntityID() statement or automatically generated by MotionView. Similarly, joint numbers and system numbers can be assigned in the *SetEntityNumber() and *System()-MDL statements, respectively, or automatically generated by MotionView.