Use the ADAMS Dataset Language Input with MotionSolve

You can submit ADAMS dataset language files (ADM and ACF) directly to MotionSolve, thus avoiding manual translation. The ADAMS model is first automatically translated into the MotionSolve XML format and then solved.

MotionSolve supports most of the ADAMS statements, commands, functions, and user subroutines. It issues a warning message when an unsupported ADAMS element is found in the input.

The tables below show the mapping between MotionSolve and the ADAMS/Solver features. The correspondence between model elements, commands, functions, and user subroutines is shown in detail. ADAMS features not currently supported by MotionSolve are marked as Not Supported in the MotionSolve column. These unsupported items will be targeted for completion in future releases. Some of ADAMS/Solver features have been deprecated and are marked as such.

MotionSolve also provides a few modeling elements that are not supported by the ADAMS solver. To use these elements with your ADAMS models, ADAMS statements have been added, as have ADAMS commands and functions. These statements, commands, and functions are marked, in parenthesis, with Not in ADAMS next to the element name in the ADAMS column.

The ADAMS statements and commands are documented in the section ADM/ACF Entities in the XML Format help. The functions are documented in the Functions topic.

Map ADAMS and MotionSolve Modeling Elements

Blue - Supported in ADAMS, but not supported in MotionSolve.

Orange - Supported in ADAMS, but not applicable in MotionSolve.

Green - Not supported in ADAMS, but supported in MotionSolve.

ADAMS MotionSolve
2d PART Subsystem_Planar
ACCGRAV Force_Gravity
ARRAY Reference_Array
BEAM Force_Beam
BUSHING Force_Bushing
CONTACT Force_Contact
COUPLER Constraint_Coupler
CURVE Reference_ParamCurve
CVCV Constraint_CVCV
DEBUG Debug_Output
DIFF Control_Diff
END Not Applicable
EQUILIBRIUM Param_Static
FEMDATA Not Applicable
FIELD Force_Field
FLEX_BODY Body_Flexible,Reference_FlexData
FRICTION Force_JointFriction
GCON Constraint_Mate
GEAR Constraint_Gear
GFORCE Force_Vector_{OneBody, TwoBody}
GRAPHICS Post_Graphics (GRAPHICS of type FORCE are not supported). See Comment below.
GSE Control_StateEqn (type:Usersub)
IC IC
INTEGRATOR Param_Transient
JOINT Constraint_Joint
JPRIM Constraint_Jprim
KINEMATICS Not Applicable
LIST/NOLIST Not Applicable
LSE Control_StateEqn (type:Linear)
MARKER Reference_Marker
MATRIX Reference_Matrix
MFORCE Force_FlexModal
MOTION Motion_{Joint, Marker}
MREQUEST Not Applicable
NFORCE Force_MultiPoint
Not Supported Constraint_PTdCV
Not Supported Constraint_PTdSF
Not Supported Constraint_PTSF
Not Supported Constraint_CVSF
Not Supported Constraint_SFSF
Not Supported Force_PTdSF
Not Supported Reference_DeformCurve
Not Supported Reference_DeformSurface
OUTPUT Not Applicable
PART Body_Rigid
PINPUT Control_PlantInput
POINT_MASS Body_Point
POUTPUT Control_PlantOutput
PREFERENCES Not Applicable
PTCV Constraint_PTCV
REQUEST Post_Request
RESULTS Not Applicable
SENSOR Sensor_{Event, Evaluate}
SFORCE Force_Scalar _{OneBody, TwoBody}
SPLINE Reference_Spline
SPRINGDAMPER Force_SpringDamper
STRING Reference_String
SURFACE Reference_ParamSurface
TFSISO Control_SISO
UCON Constraint_UserConstr
UNITS Param_Unit
VARIABLE Reference_Variable
VFORCE Force_Vector_{OneBody, TwoBody}
VTORQUE Force_Vector_{OneBody, TwoBody}

Comments

  1. GRAPHICS of type FORCE are not supported directly by the MotionSolve translator. However, you may still create force vector graphics in your model by creating an output of type "FORCE" on a body in MotionView. Alternatively, you may add a modeling element <Post_Request> of type "MARKER_FORCE" to generate the force vectors in HyperView.
  2. When GRAPHICS is defined for use in contact scenarios, the MotionSolve translator does not support GRAPHICS of type EXTERNAL when the file format is .obj or .shl. For this scenario, you will need to:
    • Import the ADM model in MotionView
    • Convert the .obj/.shl graphics to H3D via the CAD import
    • Run the model from MotionView or export the model as XML

Map ADAMS and MotionSolve Command Elements

Blue - Supported in ADAMS, but not supported in MotionSolve.

Orange - Supported in ADAMS, but not applicable in MotionSolve.

Green - Not supported in ADAMS, but supported in MotionSolve.

ADAMS MotionSolve
ACCGRAV Force_Gravity
ACTIVATE Activate
ARRAY Reference_Array
BEAM Force_Beam
BUSHING Force_Bushing
CONTROL UserProgramControl
DEACTIVATE Deactivate
DEBUG DebugOutput
EQUILIBRIUM Param_Static
FIELD Force_Field
FILE Load_{Model,Command}
FLEX_BODY Body_Flexible
FRICTION Force_JointFriction
GCON Constraint_Mate
GFORCE Force_Vector_TwoBody
H3D H3Doutput
IC IC
INFO Not Applicable
INTEGRATOR Param_Transient
JOINT Constraint_Joint
KINEMATICS Not Applicable
LINEAR Param_Linear
MARKER Reference_Marker
MENU Not Applicable
MOTION Motion_{Joint, Marker}
OUTPUT Not Applicable
PART Body_Rigid
POINT_MASS Body_Point
PREFERENCES Not Applicable
RELOAD Load_{Model, Command}
REQUEST Post_Request
SAVE Save
SENSOR Sensor_{Event, Evaluate}
SFORCE Force_Scalar_TwoBody
SHOW Not Applicable
SIMULATE Simulate
SPLINE Reference_Spline
SPRINGDAMPER Force_SpringDamper
STOP Stop
STRING Reference_String
TIME Not Applicable
UCON Constraint_UserConstr
UNITS Param_Unit
VARIABLE Reference_Variable
VFORCE Force_Vector_TwoBody
VTORQUE Force_Vector_TwoBody

Map ADAMS and MotionSolve Functions

Blue - Supported in ADAMS, but not supported in MotionSolve.

Orange - Supported in ADAMS, but not applicable in MotionSolve.

Green - Not supported in ADAMS, but supported in MotionSolve.

ADAMS MotionSolve
ABS ABS
ACCM ACCM
ACCX ACCX
ACCY ACCY
ACCZ ACCZ
ACOS ACOS
AKISPL AKISPL
AINT AINT
ANINT ANINT
ARYVAL ARYVAL
ASIN ASIN
ATAN ATAN
ATAN2 ATAN2
AX AX
AXU (Not in ADAMS) AXU
AY AY
AYU (Not in ADAMS) AYU
AZ AZ
AZU (Not in ADAMS) AZU
BEAM BEAM
BISTOP BISTOP
BUSH BUSH
CHEBY CHEBY
COS COS
COSH COSH
CONTACT CONTACT
COUPLER COUPLER
CUBSPL CUBSPL
CURVE CURVE
CVCV CVCV
CVSF (Not in ADAMS) CVSF
DIF DIF
DIF1 DIF1
DIM DIM
DM DM
DTOR DTOR
DX DX
DY DY
DZ DZ
EXP EXP
FIELD FIELD
FM FM
FORCOS FORCOS
FORSIN FORSIN
FRICTION Friction_JointFriction
FX FX
FXFREQ FXFREQ
FXMODE FXMODE
FY FX
FZ FZ
GFORCE GFORCE
HAVSIN HAVSIN
IF IF
IMPACT IMPACT
INCANG INCANG
INTERP Not supported
INVPSD Not supported
JOINT JOINT
JPRIM JPRIM
KE (Not in ADAMS) KE
LINSPL (Not in ADAMS) LINSPL
LOG LOG
LOG10 LOG10
MAX MAX
MIN MIN
MOD MOD
MODE MODE
MOTION MOTION
NFORCE NFORCE
PHI PHI
PI PI
PINVAL PINVAL
PITCH PITCH
POLY POLY
POUVAL POUVAL
PROXIMITY (Not in ADAMS) PROXIMITY
PSI PSI
PTCV PTCV
PTSF (Not in ADAMS) PTSF
QUISPL (Not in ADAMS) QUISPL
ROLL ROLL
RTOD RTOD
SENVAL SENVAL
SFORCE SFORCE
SFSF (Not in ADAMS) SFSF
SHF SHF
SIGN SIGN
SIN SIN
SINH SINH
SPDP SPDP
SQRT SQRT
STEP STEP
STEP5 STEP5
SWEEP SWEEP
TAN TAN
TANH TANH
THETA THETA
TIME TIME
TM TM
TX TX
TY TY
TZ TZ
VARVAL VARVAL
VFORCE VFORCE
VTORQUE VTORQUE
VM VM
VR VR
VX VX
VY VY
VZ VZ
WDTM WDTM
WDTX WDTX
WDTY WDTY
WDTZ WDTZ
WM WM
WX WX
WY WY
WZ WZ
YAW YAW

Map ADAMS and MotionSolve User Subroutines

Blue - Supported in ADAMS, but not supported in MotionSolve.

Orange - Supported in ADAMS, but not applicable in MotionSolve.

Green - Not supported in ADAMS, but supported in MotionSolve.

ADAMS MotionSolve
CFFSUB CFFSUB
CNFSUB CNFSUB
CONSUB CONSUB
COUSUB, COUXX, COUXX2 COUSUB, COUXX, COUXX2
CURSUB CURSUB
DIFSUB DIFSUB
DMPSUB DMPSUB
FIESUB FIESUB
GFOSUB GFOSUB
GSE{SUB, XU, XX, YU, YX} GSE{SUB, XU, XX, YU, YX}
GSE_{DERIV, UPDATE} Not Supported
GSE_{OUTPUT, SAMP} Not Supported
MFOSUB MFOSUB
MOTSUB MOTSUB
RELSUB RELSUB
REQSUB REQSUB
SAVSUB SAVSUB
SENSUB SENSUB
SEVSUB SEVSUB
SFOSUB SFOSUB
SPLINE_READ SPLINE_READ
SURSUB SURSUB
TIRSUB Not Supported
UCOSUB UCOSUB
VARSUB VARSUB
VFOSUB VFOSUB
VTOSUB VTOSUB
NALYS ANALYS
DATOUT DATOUT
MODIFY MODIFY
ADD_MASS_PROPERTY ADD_MASS_PROPERTY
BODY_MASS_PROPERTY BODY_MASS_PROPERTY
AKISPL AKISPL
BISTOP BISTOP
CHEBY CHEBY
CUBSPL CUBSPL
ERRMES ERRMES
FORCOS FORCOS
FORSIN FORSIN
GETCPU GETCPU
GETINM GETINM
GET_FULL_MATRIX_DATA GET_FULL_MATRIX_DATA
GET_GRAVITY GET_GRAVITY
GETINT GETINT
GETMOD GETMOD
GETSLV GETSLV
GETSTM GETSTM
GET_SPARSE_MATRIX_DATA GET_SPARSE_MATRIX_DATA
GETVER GETVER
GTARAY GTARAY
GTCMAT GTCMAT
GTCURV GTCURV
GTINAM GTINAM
GTONAM GTONAM
GTSTRG GTCMAT
GTUNTS GTUNTS
GET_MATRIX_INFO GET_MATRIX_INFO
HAVSIN HAVSIN
IMPACT IMPACT
ISTRNG ISTRNG
MODFNC MODFNC
MODINF MODINF
NMODES NMODES
POLY POLY
PUT_SPLINE PUT_SPLINE
QUISPL (Not in ADAMS) QUISPL
RCNVRT RCNVRT
RELPAR RELPAR
RSTRNG RSTRNG
SAVPAR SAVPAR
SHF SHF
STEP STEP
STEP5 STEP5
STR2INTARY STR2INTARY
STR2DBLARY STR2DBLARY
SUBTRACT_MASS_PROPERTY SUBTRACT_MASS_PROPERTY
SYSARY SYSARY
SYSFNC SYSFNC
SYSPAR Not Supported
TCNVRT TCNVRT
TIMGET TIMGET
TIRARY Not Supported
Not Supported UCOMAR
UCOVAR UCOVAR
USRMES USRMES

For details of the BDF and MDL formats and their coverage of MotionSolve functionality, refer to the OptiStruct and MotionView online help, respectively. The MotionSolve XML format is documented in the XML Format help. ADAMS dataset language documentation may be obtained from MSC Software.