numeric_results transform
Allows you to get results to return at locations other than the positions reported in the result file. The transform command only transforms the results in the part result sets (these are the result sets denoted by names of the form xxx_XFORM, where xxx is the part name). The transform command is needed because the result file only gives displacement, velocity, and acceleration results of the local part reference frame (LPRF) origin position relative to ground.
You can use the transform command to transform the displacements, velocities, and accelerations of a part's LPRF to a different position, while it is still rigidly attached to the same part. The transformed results will be relative to the ground's reference frame as the part moves during the simulation.
You specify the part by naming the result set to be transformed. You specify the location to which you want to transform the results, by giving its global or LPRF coordinates, or by using the coordinates of a named marker.
Format:
numeric_results transform |
|---|
result_set_name = | existing result_set |
new_result_set_name = | new result set |
marker_name = | existing marker |
lprf_coords = | real |
global_coords = | real |
Description:
Paramenter | Value Type | Descritpion |
|---|
RESULT_SET_NAME | Existing Result Set | Allows you to identify a result set name. |
NEW_RESULT_SET_NAME | New Result Set | Allows you to identify the new result set name to be created with this operation. |
MARKER_NAME | Existing Marker | The MARKER_NAME parameter specifies a marker whose coordinates are to be used as the reference position for transformation. The reference position is fixed relative to the part indicated by the RESULTS_SET_NAME parameter throughout the simulation. |
LPRF_COORDS | Real | The LPRF_COORDS parameter provides the coordinates of a point where information in a "part result set" should be transformed. |
GLOBAL_COORDS | Real | The GLOBAL_COORDS parameter provides the coordinates of a point where information in a "part result set" should be transformed. |
Extended Definition:
1. A result set is a storage place for any kind of numeric tabular data. A result set can contain "n" components. A component is most usually setup to contain vector components of values like displacement, velocity, acceleration, force and so on. However, in this case a result set is completely general and can store any numeric value in a component with only a few exceptions. These exceptions are those cases when the user asks the system to mix incompatible value types like complex in the same component as real values.
This is a required parameter and the result set name given must be within a particular analysis. A result set name may be arbitrarily long, and a combination of letters of the alphabet and numbers may be used. The leading character must be a letter.
Result Sets are associated with an analysis run and can be identified as such. A result set associated with request 101 from an analysis named "test" is referred to as .test.req101.
Several predefined result set types are created when Adams request and result files are read into Adams View. For example, assume you have read a request file called "SHIFT.REQ", and this request file contains the result information for the Adams statement REQUEST/1. The result set will be named REQ1, and may also be referred to as being relative to the analysis name .shift.req1. If you wish to refer to a component in the same result set the full name for the X component would be .SHIFT.REQ1.X.
The following table illustrates the default names assigned to result sets and result set components, read from request (.REQ) and results (.RES) files
.
Result set type | Result set name | Component names | File that result is from |
|---|
part | PARxxx... | x y z e1 e2 e3 e4 mag vx vy vz wx wy wz accx accy accz wdx wdy wdz | results file |
diff | DIFxxx... | q dq | results file |
joint | JOIxxx... | fx fy fz tx ty tz fmag tmag | results file |
jprim | JPRxxx... | fx fy fz tx ty tz fmag tmag | results file |
motion | MOTxxx... | fx fy fz tx ty tz fmag tmag | results file |
gear | GEAxxx... | fx fy fz | results file |
coupler | COUxxx... | fx1 fy1 fz1 tx1 ty1 tz1 fmag1 tmag1 fx2 fy2 fz2 tx2 ty2 tz2 fmag2 tmag2 fx3 fy3 fz3 tx3 ty3 tz3 fmag3 tmag3 | results file |
sforce | SFOxxx... | fx fy fz tx ty tz fmag tmag | results file |
spring damp | SPRxxx... | fx fy fz tx ty tz fmag tmag | results file |
bushing | BUSxxx... | fx fy fz tx ty tz fmag tmag | results file |
beam | BEAxxx... | fx fy fz tx ty tz fmag tmag | results file |
field | FIExxx... | fx fy fz tx ty tz fmag tmag | results file |
user request | UREQxxx... | u1 u2 u3 u4 u5 u6 u7 u8 | results file |
request | REQxxx... | x y z r1 r2 r3 mag amag | request file |
ucon | (not implemented) | | |
2. If the named marker is actually attached to the part specified by the RESULTS_SET_NAME parameter, then the marker's LPRF coordinates (which remain fixed, relative to the part throughout the simulation) are used to perform the transformation. Using these coordinates, the results (displacement, velocity, and acceleration) associated to the desired part are transformed into the global (or ground) coordinate system as the part moves during the simulation. Thus creating a new result set (named based on the NEW_RESULT_SET_NAME parameter).
If the named marker is attached to a part other than the one specified by the RESULTS_SET_NAME parameter, the program will issue a warning, and proceed. Then, the specified marker's coordinates are first transformed into the ground reference frame (global coordinates) at the time step corresponding to the input step (as the model was initially defined in the Adams data set). Then the marker's global coordinates are transformed into the LPRF of the specified part (also at the time corresponding to the input step). From this point, these LPRF coordinates (which remain fixed, relative to the part throughout the simulation, but are no longer associated with the named marker) are used to perform the transformation as described above.
A marker name can be entered by specifies an existing marker. You may identify a marker by typing its name or by picking it from the screen. If the marker is not visible on the screen, you must type the name. You may also find it convenient to type the name even if the marker is displayed.
If you created the marker by reading an Adams data set or graphics file, the marker name is the letters MAR followed by the Adams data set marker ID number. For example, the name of Adams MARKER/101 is MAR101. If you created the marker during preprocessing, you will have given it a name at that time.
If a marker is available by default, you may identify it by entering only its name. If it is not, you must enter its full name. To identify a marker under a different part, for instance, you may need to enter the model and part names as well. For example, you may specify marker 'pivot' from model 'links', part 'lower_arm' by entering ".links.lower_arm.pivot". If you type a "?", Adams View will list the markers available by default.
You must separate multiple marker names by commas. If the marker is visible in one of your views, you may identify it by picking on it. You need not separate multiple marker picks by commas.
3. The LPRF coordinates entered are assumed to be fixed to the part in question for purposes of the transformation. The transformed results will be relative to the ground's reference frame as the part moves during the simulation. The part is specified by the RESULTS_SET_NAME parameter used with the TRANSFORM command.
The transformation used is based on the following assumption: The described LPRF coordinates are assumed to be associated to the part at the time step that corresponds to the model input step (i.e. as input in the Adams data set).
The LPRF_COORDS parameter consists of six real numbers. The first three coordinates are the (x,y,z) coordinates of the desired location in the parts local coordinate system. The last three coordinates are the Euler angles of the desired location in degrees.
4. The global coordinates entered are assumed to be fixed to the part in question for purposes of the transformation. The transformed results will be relative to the ground's reference frame as the part moves during the simulation. The part is specified by the RESULTS_SET_NAME parameter used with the TRANSFORM command.
Even though the coordinates are input in the global (or ground) reference frame, the system associates them to the part's local part reference frame as defined in the model input step (as input in the Adams data set).
The first three coordinates are the (x,y,z) coordinates of the desired location, and the last three coordinates are the Euler angles of the desired location in degrees.