Home
MotionSolve Reference Guide
This manual provides a detailed list and usage information regarding command statements, model statements, functions and the Subroutine Interface available in MotionSolve.
Command Statements
Load: Load Command
Command ElementThe Load_Command command reads the command block from a specified MotionSolve XML file and executes the command elements.

Welcome
What's New
View new features for MotionSolve 2024.1.
Overview
MotionSolve^® is an integrated solution to analyze, evaluate, and optimize the performance of multibody systems.
Tutorials
Discover MotionSolve functionality with interactive tutorials.
MotionSolve User Guide
MotionSolve is a system level, multibody solver that is based on the principles of mechanics.
MotionSolve Reference Guide
This manual provides a detailed list and usage information regarding command statements, model statements, functions and the Subroutine Interface available in MotionSolve.
- Notation and Syntax
- Creating MotionSolve XML Files
- Writing Custom Elements for MotionSolve
- Writing Custom Functions for MotionSolve
- Supported Versions - Third Party Software
- Command Statements
  - Activate
    Command ElementSwitches on a formerly deactivated model element, and the modeling element can then be subsequently used in an analysis.
  - Body: Flexible
    Command ElementModifies a flexible body element.
  - Body: Rigid
    Command ElementModifies a rigid body element.
  - Constraint: User
    Command ElementModifies a Constraint_UserConstr element.
  - Deactivate
    Command ElementSwitches off a formerly activated model element. The modeling element is ignored in all subsequent analyses, unless it is explicitly "activated."
  - DebugOutput
    Command ElementThe DebugOutput command generates debugging output from MotionSolve. These extra diagnostics are typically used to understand MotionSolve analysis failures, so that modeling issues may be fixed and simulation parameters may be changed to get past the failure(s).
  - Force: Beam
    Command ElementModifies a beam element.
  - Force: Bushing
    Command ElementModifies a BUSHING force element.
  - Force: Contact
    Command ElementThe Force_Contact command can be used to modify the parameters of a Force_Contact model element.
  - Force: Gravity
    Command ElementModifies a gravity force element.
  - Force: Joint Friction
    Command ElementThe Force_JointFriction command can be used to modify the parameters of the topics/solvers/ms/xml-format_61.html model element.
  - Force: Spring Damper
    Command ElementModifies a spring-damper force element.
  - Force: Two Body Scalar
    Command ElementModifies a Force_Scalar_TwoBody force element.
  - Force: Two Body Vector
    Command ElementModifies a Force_Vector_TwoBody force element.
  - H3D Output
    Command ElementDefines an H3D output command.
  - Load Model
    Command ElementThe Load_Model command reads a MotionSolve XML file and builds a new multibody model.
  - Load: Load Command
    Command ElementThe Load_Command command reads the command block from a specified MotionSolve XML file and executes the command elements.
  - Motion: Joint Based
    Command ElementModifies a joint motion element.
  - Motion: Marked Based
    Command ElementModifies a marker motion element.
  - Output: Results
    Command ElementThe ResOutput command defines options for output files to be generated by MotionSolve.
  - Parameters: Linear Solver
    Command ElementModifies a linear parameter element.
  - Parameters: Simulation
    Command ElementModifies the simulation parameter element.
  - Parameters: Static Solver
    Command ElementDefines the solution control parameters for static and quasi-static analysis, where the parameters control the accuracy of the solution and the method to be used for solution.
  - Parameters: Transient Solver
    Command ElementParam_Transient defines the simulation control parameters for a time-domain-based nonlinear dynamic analysis.
  - Post: Output Request
    Command ElementModifies a Post_Request element.
  - Reference: Array
    Command ElementModifies an existing Reference_Array element.
  - Reference: FrequencyInput
    Command ElementModifies a Reference_FrequencyInput element.
  - Reference: Marker
    Command ElementModifies a marker element.
  - Reference: Solver Variable
    Command ElementModifies a variable element.
  - Save
    Command ElementThe Save command causes MotionSolve to write out the model data to a MotionSolve XML file.
  - Sensor: Event
    Command ElementModifies a Sensor_Event model element.
  - Simulate
    Command ElementPerforms a single simulation.
  - Stop
    Command ElementDefines a Stop command.
  - User Defined Program Control
    Command ElementDefines a UserProgramControl command.
- Model Statements
- Functions
- The Subroutine Interface for MotionSolve
- ADM/ACF Entities
- NLFE Statements
- msolve API Statements

View All Altair HyperWorks Help

Load: Load Command

Command ElementThe Load_Command command reads the command block from a specified MotionSolve XML file and executes the command elements.

Format

<Load_Command
     Command_File = "valid_file_name.xml"
/>

Attributes

Command_File: The name of the MotionSolve XML file to be loaded.

Example

The following example demonstrates using the Load_Command to load a MotionSolve XML file, called cmd.xml and then executing the three simulate commands it contains.

<Command
   <Load_Model
      model_file          = "save1.xml"
      result_file         = "output.mrf"
      anima_file          = "output.h3d"
   />
   <Simulate
      analysis_type       = "Transient"
      end_time            = "5."
      print_interval      = "0.01"
   />
   <Load_Command

      command_file        = "cmd.xml"
   />
   <Simulate
     analysis_type        = "Transient"
     end_time             = "10."
     print_interval       = "0.01"     
   />  
</Command>
The contents of the file cmd.xml are as follows.
<Command>
  <Simulate
     analysis_type       = "Transient"
     end_time            = "6."
     print_interval      = "0.01"     
  />  
  <Simulate
     analysis_type       = "Transient"
     end_time            = "7."
     print_interval      = "0.01"     
  />
  <Simulate
     analysis_type       = "Transient"
     end_time            = "8."
     print_interval      = "0.01"     
  />  
 </Command>

Comments

Any general MotionSolve XML file can be specified. MotionSolve will read only the command block from the specified file.