BuildSimulation(MSimMultibodyModel, options)

MSimMultibodyModel - Maple module of a system created using the BuildEQs command or retrieved from a MapleSim/Multibody store file (`.lib`) using the GetModel command.  

options  - (optional) equations of the form keyword = value

Important: The BuildSimulation command has been deprecated. Use the templates in the MapleSim templates folder to analyze your model instead. For more information, see Opening MapleSim Templates.

The BuildSimulation command performs a forward dynamic simulation on the selected model equations of motion. The command uses dsolve/numeric to integrate the equations. In most cases, BuildSimulation converts the governing equations into an optimized Maple procedure before the integration.  However, if a differential-algebraic equation (DAE) solver is requested (rkf45_dae or mebdfi), BuildSimulation passes the unaltered system equation equations directly to dsolve/numeric/DAE.

The name of the created simulation.  All of the simulation settings, numerical substitutions, initial conditions, and results are accessible from the store file of the model (`.lib`) under this name. Additionally, when you run the BuildSimulation command, the simulation results (as returned by dsolve/numeric) are assigned to this name in the global worksheet.  

A list of equations of the form `parameter=value`. Any parameters or functions that are not explicitly given a value are set to 0.

A list of floats indicating the initial conditions for the simulation. The order of the elements in the list is assumed to be the same as the order of the model's state variables (the model's vX export).

A string indicating which of dsolve/numeric integrators are used to perform the forward dynamic simulations. Valid options are rkf45 (default), rkf45_dae, dverk78, gear[bstoer], gear[polyextr], lsode[adamsfunc], lsode[backfull], and mebdfi.

A float indicating the limit on the relative error tolerance for a successful integration step.  The default value is 0.001.  For more information, see dsolve/numeric.

A float indicating the limit on the absolute error tolerance for a successful integration step. The default value is 0.001.  For more information, see dsolve/numeric.

A numeric value indicating the duration of the simulation. The default value is 1.

A positive integer indicating the number of data points to store. The stored data points are evenly distributed over the duration of the simulation.

A list of the form [ALPHA, BETA], where ALPHA and BETA are the Baumgarte constraint stabilization parameters, as described in the Dynamic exports page.  These parameters are used to control position and velocity constraint violation for constrained systems that are not integrated with a DAE solver..

Setting this option to true hides the output generated by the BuildSimulation command.  The default value is false.

Important: The BuildSimulation command has been deprecated. Use the templates in the MapleSim document folder to analyze your model instead.

The example below shows an embedded MapleSim model of a planar slider-crank mechanism. In this example, the embedded component name is Simulation0 and the model name is SliderCrank. When a simulation is created, you can plot simulation results using the BuildPlot command.

The order of the initial conditions must match the order to the variables in the vX state vector:

Dynamic Exports, Kinematic Exports, MapleSim, MapleSim[Multibody][BuildEQs], MapleSim[Multibody][BuildExpression](deprecated), MapleSim[Multibody][BuildPlot](deprecated), MapleSim[Multibody][GetModel](deprecated), MapleSim[Multibody][GetMultibodyInput]