Getting Started With SIMPACK
Getting Started With SIMPACK
Getting Started
SIMPACK Release 8.6
COPYRIGHT 2003 c
GETS:0.0 -2
Contents
1 Introduction to SIMPACK 1.1 1.2 1.3 1.4 1.1 -7
The Software What are you intending to do? . . . . . . . 1.1 -7 Modes of Analysis . . . . . . . . . . . . . . . . . . . . . . 1.3 -8 Program Structure . . . . . . . . . . . . . . . . . . . . . 1.3 -8 Pre-processing (Model Set-up) . . . . . . . . . . . . . . . 1.4 -9
2 Introduction to the SIMPACK Getting Started Guide -11 2.2 2.1 2.2 2.3 2.4 The Software . . . . . . . . . . . . . . . . . . . . . . . . 2.2 -11 From Concept to Simulation . . . . . . . . . . . . . . . . 2.2 -12 What the User Will Learn . . . . . . . . . . . . . . . . . 2.3 -15 Some Useful Hints When Working with SIMPACK . . . 2.0 -16 3.3 -17
How to Start a SIMPACK Session . . . . . . . . . . . . . 3.3 -17 Windows NT users . . . . . . . . . . . . . . . . . . . . . 3.3 -17 UNIX Users . . . . . . . . . . . . . . . . . . . . . . . . . 3.3 -17
3.2 3.3
Exiting SIMPACK . . . . . . . . . . . . . . . . . . . . . 3.3 -17 The SIMPACK GUI . . . . . . . . . . . . . . . . . . . . 3.3 -18 4.1 -21
4 File and Model Management 4.1 4.2 4.3 4.4 4.5 4.6 4.7
Creating a New Model . . . . . . . . . . . . . . . . . . . 4.1 -21 Copying a Model . . . . . . . . . . . . . . . . . . . . . . 4.3 -23 Removing a Model . . . . . . . . . . . . . . . . . . . . . 4.3 -23 Opening a Model . . . . . . . . . . . . . . . . . . . . . . 4.6 -25 Starting the Pre-Processor . . . . . . . . . . . . . . . . . 4.6 -25 Exiting the Pre- or Post-Processor . . . . . . . . . . . . . 4.0 -26 Getting Help . . . . . . . . . . . . . . . . . . . . . . . . 4.0 -26 5.1 -27
Setting up the Model . . . . . . . . . . . . . . . . . . . . 5.1 -27 Data for the Mechanical System Pendulum . . . . . . . . 5.4 -29 Opening the Model . . . . . . . . . . . . . . . . . . . . . 5.4 -29 Starting the Pre-Processor . . . . . . . . . . . . . . . . . 5.4 -29
GETS:0.0 -4
CONTENTS
Modifying the Reference Frame . . . . . . . . . . . . . . 5.5 -32 Discarding Changes . . . . . . . . . . . . . . . . . . . . . 5.6 -33 Modifying the Rigid Body . . . . . . . . . . . . . . . . . 5.7 -35 Modifying the Joint . . . . . . . . . . . . . . . . . . . . . 5.8 -39 Dening the g-Vector . . . . . . . . . . . . . . . . . . . . 5.11 -45 . . . . . . . . . . . . . . . . . 5.12 -46
5.10 Modifying the Sensors . . . . . . . . . . . . . . . . . . . 5.11 -45 5.11 Saving the Model to Disk 5.12 Creating the 3D Geometry . . . . . . . . . . . . . . . . . 5.12 -47 5.13 Graphical Representation of Body - Prism - Primitive . . 5.14 -52 5.14 Manipulating the View . . . . . . . . . . . . . . . . . . . 5.14 -52 5.15 On/O Line Integration . . . . . . . . . . . . . . . . . . 5.15 -55 On Line Integration . . . . . . . . . . . . . . . . . . . . . 5.15 -56 O Line Integration . . . . . . . . . . . . . . . . . . . . . 5.15 -57 Performing the Time Integration . . . . . . . . . . . . . 5.16 -60 5.16 Calculating Measurements . . . . . . . . . . . . . . . . . 5.16 -60 5.17 Animating the Results of the Integration . . . . . . . . . 5.17 -61 6 The DoublePendulum 6.1 6.2 6.3 6.4 6.5 6.1 -63
About the Model DoublePendulum . . . . . . . . . . . 6.1 -63 Extending the Pendulum Model to a Double Pendulum . 6.3 -65 Adding a Marker to a Body . . . . . . . . . . . . . . . . 6.3 -65 Creating a New Body and Adding a Marker . . . . . . . 6.4 -67 Modifying a Joint . . . . . . . . . . . . . . . . . . . . . . 6.5 -70
7 Creating and Importing a Substructure to a Model 7.1 -73 7.1 Creating a Substructure . . . . . . . . . . . . . . . . . . 7.1 -73
8 Adding a Force Element to the Double Pendulum Model -77 8.1 8.1 8.2 Adding the Force Element . . . . . . . . . . . . . . . . . 8.1 -77 Plots of the Results . . . . . . . . . . . . . . . . . . . . . 8.2 -81 2D State Plots of the Joint States and Velocities . . . . . 8.2 -81 General 2D plots . . . . . . . . . . . . . . . . . . . . . . 8.2 -81 8.3 8.4 8.5 Static Equilibrium . . . . . . . . . . . . . . . . . . . . . 8.3 -84 Calculation of the Nominal Force Parameters . . . . . . . 8.4 -85 Eigen Behaviour . . . . . . . . . . . . . . . . . . . . . . . 8.5 -88 Animation of the Mode Shapes . . . . . . . . . . . . . . 8.5 -88 9 Addition of a Force Element to be Used as a Bump Stop -91 9.0
CONTENTS
GETS:0.0 -5
10.3 -93
10.1 About the Slider Crank Mechanism . . . . . . . . . . . . 10.3 -93 10.2 Extending the Double Pendulum Force Model to a Slider Crank10.3 -93 10.3 Dening a Constraint (Closed Loop) . . . . . . . . . . . 10.3 -93 10.4 Dependent and Independent Joints . . . . . . . . . . . . 10.4 -95 10.5 Exercises . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.5 -98 10.6 On-line Kinematics . . . . . . . . . . . . . . . . . . . . . 10.6 -99 Dening a Slider Bar . . . . . . . . . . . . . . . . . . . . 10.6 -99 Interactive Kinematics . . . . . . . . . . . . . . . . . . . 10.7 -101 10.7 Inverse Kinematics . . . . . . . . . . . . . . . . . . . . . 10.7 -102 Conguration of the Inverse Kinematics Solver . . . . . . 10.7 -104 Performing Inverse Kinematics . . . . . . . . . . . . . . . 10.0 -105 11 How to Move On 11.0 -107
GETS:0.0 -6
CONTENTS
GETS:1.
Introduction to SIMPACK
GETS:1.1
The SIMPACK software package is a tool to assist engineers to model, simulate, analyse and design all types of mechanical system, such as vehicles, robots, machines and mechanisms. It is able to analyse vibrational behaviour, calculate forces and accelerations as well as describe and predict the motion of multi-body systems. The basic concept of SIMPACK is to create the equations of motion for mechanical and mechatronic systems and then from these equations, apply various dierent mathematical procedures to produce a solution (e.g. time integration). The SIMPACK model is built up using the SIMPACK modelling elements. SIMPACK will then automatically generate the system equations from this model. The equations of motion can be generated both symbolically and numerically (where the numeric form is the usual form). The symbolic code allows the user to export the SIMPACK model as standard FORTRAN or C code which can be run independently, for example in real time, in a hardware in the loop environment. The software has a comprehensive range of modelling and calculation features, together with a user interface well adapted to an engineers needs. Due to its comprehensive modelling abilities, it has been successfully applied within industry, university and research institutions. The following is a list of many of the elds to which SIMPACK has been applied. Automotive vehicles Tracked vehicles Robotics Machine tools Printing machines Packaging machines Ground dynamics of aeroplanes
GETS:1.3 -8
Program Structure
GETS:1.2
Modes of Analysis
A wide range of analysis features are available to analyse and design dynamic systems: Static Analysis Kinematic Analysis Non-linear Dynamic Analysis Linear System Analysis Symbolic Code Generation Eigenvalue Analysis
GETS:1.3
Program Structure
Figure GETS:1.3.1 shows the main functional modules and interfaces to external software tools.
Figure GETS:1.3.1: SIMPACK Program Structure The window oriented interface of SIMPACK serves four main purposes: The user interface includes a dialogue driven model set-up window, which includes list boxes for the MBS-library elements, parameters etc. This interactive module generates all the data nec-
GETS:1.4 -9
essary for a complete physical and graphical description of the MBS. It also generates all the necessary data for SIMPACK to perform the numerical evaluation methods. It prevents the user from creating inconsistent models. Logical data checks of the input deck are made by SIMPACK as well as calculations performed on-line for closed loop systems to ensure that the model is viable. It provides help on all menu items. Thus the necessary manual research work is reduced to a minimum. It gives the engineer complete control of the model creation and simulation processes.
GETS:1.4
GETS:1.0 -10
tems. Due to its ability to numerically linearise the system equations, SIMPACK can also be used as a simulation tool within linear control design tools. A further link is provided to external post-processing tools in addition to the extensive internal post-processing capabilities of SIMPACK. The 2D and 3D visualisation tools enable the user to view simulation results in many dierent forms. These include tables, plots and realtime animation of the graphical models created by SIMPACK.
GETS:2.1
GETS:2.2 -12
GETS:2.2
Figure GETS:2.2.1: Truck and Trailer as an Example of a Physical System Step 2. Development of a Mechanical Model The mechanical structure is divided into bodies and joints, the interconnecting structures Constraints are then dened, which contsrains the mobility of the elements by removing degrees of freedom Forces in-between the ground and the bodies are dened
GETS:2.2 -13
2 2 1 1 1 x1 z7 8 1 z3 9 7 3 5 4
z1
Figure GETS:2.2.2: Mechanical Model Step 3. Provision of the Model Parameters The physical parameters for the model such as the mass, moments of inertia and centre of mass for the various dierent bodies are dened The geometry of the structure and how it ts together are dened; i.e. the distances in-between coupling points The parameters for the coupling elements are dened, such as the force element values and constraints
Figure GETS:2.2.3: Typical Model Parameters Step 4. Pre-Processing This section is where the model data is entered into SIMPACK. This data includes: The physical model; i.e. bodies and joints All the input functions for the model including the constraints, forces and excitation functions The associated 3D geometrical data for the graphical representation of the bodies
GETS:2.2 -14
The numerical calculation settings The settings for the output quantities The settings for the optimisation and parameter variation Step 5. SIMPACK Calculations The dierential equations are generated from the data entered in the previous step and then solved within SIMPACK Step 6. Post-processing: Presentation of Results SIMPACK can present the results in any of the following forms: User determined plots such as load indices or limiting values 2D line plots SIMPACK contains various dierent mathematical algorithms i.e. Fast Fourier Transforms which can be used to process the results of SIMPACKs calculations 3D animation of the model i.e. mode shape animation Export to Microsoft Excel and MATLAB
GETS:2.3 -15
GETS:2.3
GETS:2.0 -16
GETS:2.4
GETS:3.
The main features you will learn at this stage are as follows: How to start a SIMPACK session Basic le management Ending a SIMPACK session
GETS:3.1
Windows NT users:
Figure GETS:3.1.1: SIMPACK Desktop Item Or from the taskbar menu select Programs, followed by SIMPACK v.8.6 folder and then nally click on the SIMPACK v.8.6 icon
UNIX Users:
Open a terminal window Type sim The SIMPACK user interface window appears GETS:3.1.2:
GETS:3.2
Exiting SIMPACK
From the menu bar on the user interface select Exit from File on the pull-down menu: File Exit
GETS:3.3 -18
GETS:3.3
GETS:3.0 -19
This menu gives you access to the main post-processing functions. Help This provides access to the main SIMPACK documentation, including help topics on the SIMPACK keywords, plus general SIMPACK information as well as details of the current SIMPACK release.
GETS:3.0 -20
Figure GETS:4.0.1: On-Line View of a SIMPACK Session In this section you will learn how to open, copy, create and remove models.
GETS:4.1
GETS:4.1 -22
Figure GETS:4.1.3: Open Model from the Pull-Down Menu The open model dialogue box then appears, gure GETS:4.1.4:
Figure GETS:4.1.4: The Open Model Dialogue Box You must now select which directory you would like to save the model in. On the left hand side of the Open Model dialogue box you will see a directory list box. Either double click on a directory or double click on .. to look in a parent directory. Once you are in the directory you would like to save your model in, then click on New and enter the model name
pendulum in the list box that appears. You must . then hit Return The model name will be displayed at the top
When a new model is created, SIMPACK automatically creates a default model with the following parameters:
Copying a Model
GETS:4.3 -23
Inertia reference frame $B Isys with a marker $M Isys placed at the origin of the inertia reference frame One body $B Body1 with a marker $M Body1 placed on the body xed reference frame One joint $J Body1, which connects the inertia frame and the body with zero degrees of freedom One sensor $S Body1 between the two markers A default gravity vector A default 3Dgeometry for the inertia frame and the body
GETS:4.2
Copying a Model
Open the Open Model dialogue box and select the pendulum model you have just created, click with the right hand mouse button in this section (Models section) of the Open Model window and select Copy Model. Click again with right hand mouse button and select Paste Model. You will then be asked to whether you want to overwrite the existing model, select No and in the New Model window that then appears enter the new name for the copied model. Models can also be copied across directories. The model should be copied in exactly the same way. Then switch to the directory in which you would like to copy your model and click on Paste Model. The model data will be copied to this directory and will have the name of the original model. You should now create the model deleteme which is a copy of the pendulum model and will be located in the same directory as the pendulum model.
GETS:4.3
Removing a Model
Open the Open Model dialogue box and select the model deleteme which you have just created. Click on Remove . The following dia logue box will appear on the screen, gure GETS:4.3.5.
GETS:4.3 -24
Removing a Model
Opening a Model
GETS:4.6 -25
There are 5 options that appear. Three of the options are for working only with the selected model and the other two options are for working with the entire active directory. The options for the current model are: To remove the current model with all the results To remove all the results from the current model; this removes all the output les of the selected model To remove measurement results only from the current model; this removes all the measurement results from the current model, but keeps all the simulation results The nal option keeps only the basic results les and model les. This is useful as the results les from the simulation are kept, which may have taken a signicant amount of computer time to produce. The measurement les are removed, which often take up a signicant amount of disk space, but can be restored very quickly. Calculating measurements will be explained later in the guide. The options for the entire directory are as follows: To remove all the results from all the models in the current directory To remove all the measurement results from all the models in the current directory Select remove current model with all results and click on OK . Con rm that you want to remove this model and when you return to the Open Model dialogue box click on Close .
GETS:4.4
Opening a Model
Open the Open Model window once more. Find the directory which contains the pendulum model, which you have just created. Double click the pendulum model or select the model and then click on on OK .
SIMPACK only allows you to work on one model at a time. You will be unable to load up a new model in SIMPACK if the pre- or post-processor is running with another model. To begin working on a new model you must close the pre- or post-processor.
GETS:4.5
GETS:4.0 -26
Getting Help
GETS:4.6
GETS:4.7
Getting Help
SIMPACK provides the user with many help options. Help is most easily accessible via the on-line help HTML pages, which are accessed through Help on the pull-down menu in the SIMPACK Documentation user interface. If the user clicks on help from within the menu bar in other windows then they are presented with two options from within the pull-down menu. 1. Help on context, can be selected where a short help text is available for many elds within the SIMPACK windows 2. Help on window, brings up a HTML document in a browser window, which provides help on functions within that window
GETS:5.
GETS:5.1
Pendulum Model
GETS:5.1 -28
GETS:5.4 -29
GETS:5.2
Joint: joint mobility = rotation about x-axis initial joint state = 0.707 [ rad ] initial angular velocity = 0.0 [ rad/s ] Gravity: acceleration due to gravity along z-axis, g = 9.81 [ m/s2 ] Geometric data for the pendulum: Prism, representing the pendulum: co-ordinates of the prism thickness = y z 0.1 0.0 0.0 0.1 0.1 0.0 0.0 0.7 0.05 [m] [m]
GETS:5.3
GETS:5.4
GETS:5.4 -30
GETS:5.4 -31
The other window that appears is the SIMPACK Echo Area window, gure GETS:5.4.3. This window displays the working status of SIMPACK as well as any error or calculation messages:
GETS:5.5 -32
GETS:5.5
Discarding Changes
GETS:5.6 -33
This dialogue box contains all the dened reference frames in the MBS model. There should only be one reference frame present which is the reference frame $B Isys. From this dialogue box you should now either double click on the reference frame $B Isys or select it and then click on modify . The following dialogue box, gure GETS:5.5.5 will appear:
Figure GETS:5.5.5: Reference Frames Dialogue Box From this dialogue box you can edit the reference frame data. You can dene various dierent parameters for the reference frame as well as dene its guiding motion. Try selecting Type . This starts the window Reference System List. From this window you can select the type of reference frame you require. Click on Cancel to return back to the Dene Reference System dia
Clicking on Show the Reference Frame will highlight the reference frame in the 3D Model Setup window. Click on OK to close the Dene Reference System window. You will learn how to create and modify markers later in this guide.
GETS:5.6
Discarding Changes
Before going any further with developing the model, it is necessary to explain how to discard any unwanted modications. SIMPACK does not have an undo facility. If you as the user wish to remove a number of changes to the model you have just made, then it is necessary to reload the model from the last save.
GETS:5.6 -34
Discarding Changes
The model can be reloaded either from File and then Reload on the pullor by clicking on Reload in the toolbar. down menu File Reload This Reload function is found in the 3D Model Setup window as shown in gures GETS:5.6.6 and gure GETS:5.6.7.
GETS:5.7 -35
Reloading the database from the last save means all the changes you have made since the last save will be removed. If however, you would only like to remove one or two changes then it is more advisable to modify the model (such as a joint or marker). Modifying varying different aspects of the model will be explained at various dierent stages throughout this guide.
GETS:5.7
GETS:5.7 -36
GETS:5.7 -37
Double click $B Body1 or select it with the mouse and then click on on Modify . The MBS Dene Body dialogue box appears, within this window you can select whether the data used for the body is input locally (i.e. by you in the pre-processor) or from a database. You can also select whether the body is rigid or elastic. For this model you will enter the data by hand, i.e. not from the database and you will dene the body as rigid. Within this dialogue box you can enter the physical attributes of the body. These include the mass, centre of mass and the inertia-tensor. The inertia-tensor can be set relative to either the centre of mass, the body xed reference system or to a marker. Normally it is set relative to the centre of mass, which is the case for the pendulum model here. You should now enter the following data for the body: Edit $B Body1:
mass = 4 Centre of mass z = Ixx = 10 Iyy = 10 -0.25
Figure GETS:5.7.9 shows how the MBS Dene Body dialogue box should look:
GETS:5.7 -38
GETS:5.8 -39
Click on OK
GETS:5.8
The dialogue box MBS Dene Joint, gure GETS:5.8.10 will appear.
Figure GETS:5.8.10: MBS Dene Joint At the top of the dialogue box the name of the joint is shown. The markers to which it is attached as well as the type of joint are also shown. When dening the markers associated with a joint, it is necessary to follow the tree structure which starts from the inertia frame
GETS:5.8 -40
and moves outwards. Therefore the from marker i should be nearer the reference frame than the to marker j. SIMPACK takes this into account when it oers you the markers. Click on From Marker i and the dialogue box, gure GETS:5.8.11 appears:
GETS:5.8 -41
Select marker $M Isys and then click on OK. This marker is the default marker set by SIMPACK on the reference frame Select $M Body1 as marker j. This is the default marker set by SIMPACK on Body1
It is then necessary to select a joint type. Click on Joint Type . The window GETS:5.8.12 appears with a list of the dierent types of joint, e.g. Rheonomic Joints. The individual joints can be found under the relevant joint type. Open the folder General: Free Motion and from the list that appears select joint Revolute Joint al. This is a 1 degree of freedom joint, which allows only rotation about the x axis (angle Alpha). Figure GETS:5.8.12 shows what you should select:
GETS:5.8 -42
Press OK to close the subwindow and you will return to the MBS Dene Joint Dialogue box. Click on the rst line of the initial state box as shown in gure GETS:5.8.13:
GETS:5.8 -43
In the following input window you can enter the initial state of the joint in terms of both position and velocity. Enter the following modications into the input panel. Position Velocity = =
0.707 0.0
GETS:5.8 -44
Click on OK and the MBS Dene Joint dialogue box should look as follows, gure GETS:5.8.15:
GETS:5.11 -45
GETS:5.9
Figure GETS:5.9.16: Dene g-Vector For this analysis stay with the default value which is negative along the z axis.
GETS:5.10
The dialogue box, gure GETS:5.10.17 will appear: Again marker i should be closer to the inertia frame, so select $M Isys for this marker. For marker j select Body1. Keep the other de$M faults within the window and click on OK .
GETS:5.12 -46
GETS:5.11
GETS:5.12 -47
GETS:5.12
The SIMPACK 3D Geometry window appears. This window shows the ensembles and primitives that are associated with this reference frame. Under Primitives of Selected Ensembles click on New as shown in gure GETS:5.12.18:
GETS:5.12 -48
GETS:5.12 -49
In the input box that then appears you should enter the name $P axle and then click on OK . The SIMPACK Primitive Denition window appears and in this window click on Type to change the primitive type, gure GETS:5.12.19.
GETS:5.12 -50
Figure GETS:5.12.20 shows the available primitives. In this window select primitive type Cylinder and click on OK .
Figure GETS:5.12.20: Primitive Types List Box You will return back to the Primitive Denition window and in this window you must enter the following parameters. Enter: diameter = length = number of planes = smooth = Edit the built-in vector matrix
Revolve primitive 90o on zaxis (gamma = +90 ) The dialogue box should look as follows, gure GETS:5.12.21: 0.05 0.2 8 1
GETS:5.12 -51
GETS:5.14 -52
Click on OK and then again in the 3D Geometry box and then click on OK in the Dene Reference System dialogue box.
GETS:5.13
Change the name to $P Hand Click on Modify to change the primitive parameters of the hand Change the Primitive type to Prism by Coordinates Back in the Primitive Denition window change the prism thickness to 0.05 and the No. of shape points to 4 In the shape/line list box enter the four shape points as follows: Enter in 1. 2. 3. 4. line: line: line: line: x x x x = = = = -0.1 0.0 0.1 0.0 y y y y = 0.0 = -0.1 = 0.0 = 0.7
Figure GETS:5.13.22 shows how the primitive dialogue box should look: Click on OK and OK again to get back to MBS Dene Body and then OK to close this window Save the model
GETS:5.14
GETS:5.14 -53
Figure GETS:5.13.22: Completed Body-Primitive Denition Window model within or around the screen axes or within the Reference system axes. You will learn, in this section, how to move the model within the 3D Model Setup window. However, before changing the view you should save the model. You therefore only need reload the model data to get back to the original view settings. Select View Setup from View on the pull-down menu in the 3D Model Setup window. The following dialogue box will appear, gure GETS:5.14.23
GETS:5.14 -54
GETS:5.15 -55
Click on Standard Views . A list of standard views appears. Click on each dierent view Try clicking on Zoom/Translate/Rotate You can see the eect the slider bars have on the view. You can toggle between screen co-ordinates and reference system co-ordinates to determine the translational movement of the model within the screen. When the screen co-ordinates are selected the bottom left hand corner of the 3D Model Setup window becomes the origin. Try also rotating the model around the screen using the slider bars. One very useful feature in SIMPACK allows you to operate with 4 user dened views. You will nd these at the top of the View Setup dialogue box. You can toggle between four views or just the one view. You can also toggle between the four dierent views. As well as the View Setup window you can also control the view by holding down the control key and one of the mouse keys. By scrolling with the mouse and trying each of the mouse keys in turn you can see the eect each has on the view. It is also possible to manipulate the view from on the toolbars. There is a ret function, as well as a zoom in and zoom out function. Once you have nished experimenting with the dierent views, reload the MBS model data from the previous save and you will return to the SIMPACK standard view.
GETS:5.15
GETS:5.15 -56
SIMPACK is told for how long to integrate for, using a start and end time. The animation of the model is performed later by SIMPACK.
On Line Integration
To begin integrating on-line select Time Integration from Calculations in the pull-down menu within the 3D Model Setup window. The following window will appear , gure GETS:5.15.24:
GETS:5.15 -57
To save the moving data to animate later, switch the Protocol, at the top of the window, from No to Yes To start integrating the equations and animating the model then click on Go . The pendulum starts to oscillate about the x axis, which can be seen in the 3D window. The time integration can be followed in the SIMPACK echo area To stop the integration click on Stop When nished click on OK
O Line Integration
Normally however, the integration that is performed by SIMPACK is o-line. O-line integration is normally used for large complex models with a large number of degrees of freedom. The CPU time required to integrate the equations may be high, which makes it unfeasible to animate the model whilst performing the time integration. Before starting an o-line integration, SIMPACK must be told what to perform in the integration. SIMPACK must be told the initial start time for the integration as well as the end time. These values must be positive as SIMPACK does not allow you to integrate backwards. SIMPACK also requires the number of communication points. These communication points determine how many times SIMPACK writes data to the results les in the integration process. For example, an integration time of 10 seconds with 100 communication points would mean that results are available for every tenth of a second. From the pull-down menu in the SIMPACK user interface select Calculation Time Integration Congure The Time Integration window will appear and in this window enter the following parameters: Initial Time = End Time = Number of Communication Points =
0.0 5.0 101
GETS:5.15 -58
GETS:5.15 -59
The integration method SODASRT will be automatically selected as the SIMPACK default integration method. SODASRT is SIMPACKs standard integration integrator which is optimised for a wide range of mechanical systems. You will nd that this method is appropriate for almost all cases, however for some certain cases there are other more appropriate solvers available to the user. For example for complicated non-linearities other solver methods are available. The wide range of SIMPACK solvers means that virtually any system can be integrated Click on the Settings... button to see how the solver settings can be changed. The SODASRT window appears, gure GETS:5.15.26:
GETS:5.16 -60
Calculating Measurements
In this window it is possible to congure how the solver will integrate the equations. However at this stage, with the defaults stay in the window. Click on OK or Cancel
You will be back in the time integration window. Click on Save and then Exit
GETS:5.16
Calculating Measurements
It is necessary to calculate measurements to animate the results of the integration process. The movements of the ensembles are determined by the output data from the sensors. These measurements are the rst measurements taken when the perform measurements module is executed. The next measurements taken are those associated with the kinematics, the applied forces, the internal force law variables and the constraint forces. All the results are saved in the subdirectory /output of the current directory. To start the perform measurements module, click on the pull-down
GETS:5.17 -61
or click on the Perform Measurements menu Calculation Perform Measurements Full toolbar button.
GETS:5.17
GETS:5.0 -62
At the top of the window you will see it says frame number. There should be the same number of frame numbers as communication points that you entered in the Congure Time Integration window. Therefore there should be 101 frame numbers available. Directly underneath these frame numbers you will see the buttons which you use to control which frame number is displayed in the 3D Model Setup window. Experiment with these pushbuttons to see the eect they have on the animation. Once nished click on OK .
GETS:6.
GETS:6.1
The DoublePendulum
GETS:6.1 -64
Data for the mechanical system doublependulum: Bodies: Body1: mass centre of gravity (x,y,z) inertia tensor I
= 4.0 = ( 0, 0, -0.25 ) 10.0 0.0 0.0 0.0 10.0 0.0 = 0.0 0.0 1.0 [m]
[ kg ] [m] [ kgm2 ]
Additional marker on body1: builtinvector with re- = (0.0, 0.0, 0.7) spect to body xed RefSys Body2: mass centre of gravity (x,y,z) inertia tensor I = = ( 0, 15.0 = 0.0 0.0
[ kg ] [m] [ kgm2 ]
Joints: Joint connecting body-1 and the inertia frame: joint mobility = rotation about x-axis initial joint state = 0.707 [ rad ] initial angular velocity = 0.0 [ rad/s ] Joint connecting body-2 and body-1: joint mobility = rotation about x-axis initial joint state = -0.2 [ rad ] initial angular velocity = 1.0 [ rad/s ] Gravity: acceleration due to gravity along zaxis, g = 9.81 [ m/s2 ].
GETS:6.3 -65
Data for the graphic representation of the doublependulum: Geometric parameters of body1: Body1 is graphically represented by a prism. y z 0.1 0.0 0.1 denition points = 0.0 0.1 0.0 0.0 0.7 thickness = 0.05 Geometric parameters of body2: Body-2 is graphically represented by a cuboid. x y z 0.0 [ m ] Co-ordinates of the = 0.025 0.025 0.025 0.025 1.0 cuboid diagonal vector:
[m]
[m]
GETS:6.2
GETS:6.3
GETS:6.3 -66
and name this new marker $M Body1 1 Figure GETS:6.3.2 shows how the window should look:
Figure GETS:6.3.2: Marker List for the Body Double click on the new marker and the MBS Dene Marker window appears. This window allows you to edit the built in vector and orientation matrix that describe the markers position. These co-ordinates are given relative to the body xed reference frame The orientation matrix determines a constant orientation of the marker relative to the body xed reference frame. There are four possible options to determine the orientation: E-Matrix (Identity matrix) Cardan angles 3x3 orientation matrix 3 points (PQR-vectors) For this model you will stay with the default, the E-Matrix. However change the built-in position to z=-0.7. Figure GETS:6.3.3 shows how the dialogue box should look: If you click on Update 3D Scene you will see that a set of axes appears at the bottom of the pendulum, where the marker has been added. This marker will be used as an attachment point to the second body. You will attach a joint to this marker which in turn will be
GETS:6.4 -67
Figure GETS:6.3.3: MBS Dene Marker attached to a marker on the second body. Return back to the MBS Bodies window.
GETS:6.4
Names of bodies begin with $B SIMPACK will automatically add this for you. When this new body is created SIMPACK automatically assigns default settings for the mass and inertia tensor. SIMPACK also automatically assigns: A marker to the body A default 3D geometry including two primitives to represent the body graphically (a co-ordinate axis and default cuboid) A zero degree of freedom joint which connects this body to the inertia frame A sensor between the inertia frame and the body xed frame The MBS Dene Body window should have appeared. Enter in the following values for the model:
GETS:6.4 -68
mass = 2.5 Centre of mass z = 0.5 Ixx = 15 Iyy = 15 Izz = 1 I-Tensor relative to the centre of mass Figure GETS:6.4.4 shows how the completed dialogue box should look:
Figure GETS:6.4.4: Denition of the Second Body Edit the 3D geometry by clicking on 3D Geometry
Select $P Body2 cuboid in the Primitives List box Click on Rename and change the name to Rod Click on Modify to modify this element. The default primitive type is a cuboid, which you will keep Enter the following lengths:
GETS:6.4 -69
Enter x = y= z=
These lengths are entered by clicking on each of the input lines length in x length in y and length in z in the parameter box. If you look in the Model Setup window you will see that the rods centre is at the origin of the inertia frame. To move the rod, enter in the build in vector box the following data:
Shift the cuboid on the zaxis: z = -0.5 The Primitive Denition window should look as follows, gure GETS:6.4.5:
GETS:6.5 -70
Modifying a Joint
You now need to add a marker to this body. Click on Markers and then select New
Enter the name as Body2 1 Click on Modify and then change the Built-In Position:
Shift the cuboid on the zaxis: z = -1.0
Click on OK
A marker should appear at the bottom end of the rod. You should now return to the MBS bodies window.
GETS:6.5
Modifying a Joint
As mentioned previously when a body is created it is assigned a joint with zero degrees of freedom. This joint is also attached to the inertia frame. The joint on body2 has to be modied so that it is connected to both body 1 and body 2. The joint to be used is a revolute joint about the x-axis. Select Joints from either the pull-down menu under Elements or click on the toolbar button Double click on the joint $J Body2. The Dene Joint window appears Select From Marker i . The Marker List box should appear
Select To marker j and then select $M Body2 and click on OK Select Joint Type and in the Joint List window select Revolute
Enter the initial joint state and velocity as follows: Position = -0.2 Velocity = 1.0 If the dialogue box looks the same as gure GETS:6.5.6 click on OK
Modifying a Joint
GETS:6.5 -71
GETS:6.0 -72
Modifying a Joint
You should now save your model and as described in section GETS:5.15 begin the time integration and model animation. If you can, try performing the time integration without referring back.
GETS:7.1
Creating a Substructure
The substructure will be completely separate to the main model. If changes are made to the substructure then it is not necessary to update the substructure in the main model as this is done automatically by SIMPACK. This is a particularly useful feature when the substructure is used by a number of models. Ensure that the pre-processor is running with the double pendulum model. You should also save the model. You will use the body $B Body2 as the basis of the substructure. You will remove $B Body1 and then save the model as a dierent name. This model will now be used as the substructure. First of all it is necessary to change the From marker of joint $J Body2. This marker is currently attached to a marker on body $B Body1. SIMPACK will not allow you to remove $B Body1 until the joint is connected to another structure. When the body is removed all the markers, joints etc. will also be removed.
GETS:7.1 -74
Creating a Substructure
In the Joints dialogue box select $J Body2. For the From marker i you should select the inertia frame $M Isys You will see that $B Body2 moves and is now attached to the inertia frame. You should now remove $B Body1. This is done by going into the Bodies window. You should select this body and click on button Remove . The Remove MBS Element window appears which
shows all the elements which will be removed. Click on OK to conrm that you want to remove all these elements What you are left with is the substructure that you will import into the main model. In the 3D Model Setup window you should click on the Save As toolbar button. Name the MBS conguration as pendulum substructure You should now click on the Reload MBS toolbar button in the 3D Model Setup window. This reloads the previously saved model double pendulum You have now created the substructure under the lename pendulum substructure, which can be imported into the double pendulum model. You should either click on the Substructures toolbar button or click on Substructures from within Elements. The Substructures window will appear. In this window click on New and the SIMPACK Substructure window will appear. It is from within this window where you select which le will be loaded. Click on File . The MBS Element Info List window appears. This window displays all the les within the current directory. Any of which could be used as a substructure Select the substructure you have just created, pendulum substructure and in Name in the MBS, enter Body3. The names of all substructures begin with $S SIMPACK will automatically assign this for you. The window should look as follows, gure GETS:7.1.1:
Creating a Substructure
GETS:7.1 -75
Figure GETS:7.1.1: Substructure Dialogue Box Finally click on Load substructure . The substructure which you have just created will appear and is attached to the origin of the inertia reference frame. It is necessary to attach the end of the substructure to the body $B Body2 Open the MBS Elements Joints window. You will now see the joint $J S body3 J body2. Double click on this joint and change the From Marker i to $M body2 1, which is a marker at the bottom of $B Body2 The 3D Model Setup window should look as follows, gure GETS:7.1.2:
GETS:7.0 -76
Creating a Substructure
It is now possible to perform the time integration For the next stage of the Getting Started the substructure is not required and should be removed. This can be done by clicking on Remove in the Substructures window with $S body3 selected
For more information on substructures see section: HWTU:2.6 in the how to use section of the documentation or section SIMREF:4.12 in SIMPACK fundamentals.
GETS:8.1
You will use the double pendulum model as the basis for the new model; double pendulum force. Copy the double pendulum model to double pendulum force and open the new model. Start the pre-processor by clicking on the Model Setup toolbar button You will dene a spring-damper between a new marker on the inertia frame (marker $M I1 on inertia frame $B Isys) and the head of the hand ($M Body1 1 on body $B Hand). First you must create the coupling point $M I1. Modify the inertia frame $B Isys and create the new marker $M I1 Set the built-in position to y=1.7. If you are having problems refer back to GETS:6.3 under adding a marker to a body Select Force Elements from under Elements in the pull-down or from the toolbar and menu Elements Force Elements create a new force element and call it Force1 Select From Marker k in the MBS Force Element box and pick marker $M I1 as the rst coupling point
GETS:8.1 -78
Select To Marker l as the second coupling point and pick marker $M Body1 1 Click on Force Type . The Force Type List window opens, which contains a list of the dierent force types. The dierent force types are located in folders, i.e. for a tyre force element, then opening the folder Tyres will display the available tyre force elements see g GETS:8.1.1.
Figure GETS:8.1.1: Force Element Folders Select the force Spring-Damper parallel PtP, which is located in the Spring-Damper folder. and click on OK Enter the following spring parameters: length of the unloaded spring: l0 = stiness of the spring: c = damping coecient of the spring d =
0.5 50 5
Figure GETS:8.1.2 shows how the MBS Force Element box should look:
GETS:8.1 -79
GETS:8.1 -80
You can now integrate the model and then animate it. The double pendulum force model should now oscillate about a new equilibrium position.
GETS:8.2 -81
GETS:8.2
Figure GETS:8.2.3: 2D Plot of States Try clicking on some of the other plots that are available. zgp is velocity whereas zg is position. The various dierent plots are brought up in the window as you click on them
General 2D plots
If you would like customised plots of the time integration results then it is necessary to use 2D general plots. To use this module it is necessary to calculate the measurements, after the time integration has been performed. Click on the Perform Measurements toolbar button or from the
GETS:8.2 -82
Pull-down menu click on Calculation Perform measurements Full Select General Plots from either the toolbar or from the pull-down menu under PostProcess The SIMPACK 2D window appears, in which you can congure the plotting window. This window contains a sub-window with the General Plot, plotting area. You can have up to 50 dierent pages containing up to 12 dierent active plots In the gure position matrix click inside the top left hand frame Ensure that curve 1 is selected
Select axis y and again click on Modify . Select State Vector X and in the window Select MBS Element choose joint.st.pos(1):$J Body1 and click on OK A plot should appear showing the variation of joint state $J Body1 with time As mentioned it is possible to add a further curve to this plot. Select curve 2 and as you have just done select time as the x axis and then select joint $J Body2 as the variable for the y axis. SIMPACK will display both these curves on the same set of axes You can also add a further plot to this window, but on separate axes. In the gure matrix click on the square in the matrix shown, gure GETS:8.2.4:
GETS:8.2 -83
The Select MBS Element window appears and in this window you will see $F Force1 and select the co-ordinate y as shown in gure GETS:8.2.5
Figure GETS:8.2.5: Select Force Window There should now be two plots in the window. One showing the time history of the joint states, the other shows the time history of the applied force. The view of the window should look as follows, gure GETS:8.2.6.
GETS:8.3 -84
Static Equilibrium
Figure GETS:8.2.6: 2D General Plot Window Try adding more curves to this plot page and in dierent plot pages. Once nished select Exit from File on the pull-down menu. It will then ask you if you wish to save the 2D conguration before closing. If you would like to have the same plot windows next time you open the general plots window in this le, then click on Yes , otherwise click on No
GETS:8.3
Static Equilibrium
SIMPACK is able to calculate the static equilibrium of the multi-body system. A system is said to be in static equilibrium when the sum of all the accelerations is zero. The velocities may not necessarily be zero when the system is in static equilibrium. For example, a car travelling along a at road at constant velocity is said to be in static equilibrium. There are various dierent iteration methods available for solving the non-linear set of equations. The default setting is Newtons method. Set the velocities of the joints to zero and then save the model Under Calculation on the pull-down menu in the SIMPACK user interface select Static Equilibrium (there is also a static equilibrium toolbar button). The Static Equilibrium window appears, gure GETS:8.3.7:
GETS:8.4 -85
Figure GETS:8.3.7: Static Equilibrium Window Keep all these settings and then click on Perform
The SIMPACK Static Equilibrium Results window appears with both joint states when the system is in static equilibrium. Click on OK Click on Save and when the SIMPACK Save window appears keep the default saves. It is necessary to save the states if you wish to display the static equilibrium of the model. You will return to the Static Equilibrium window where you should click on Exit In the Model Setup window either click on the toolbar button Reload MBS-model or from the File pull-down menu click on Reload. The static equilibrium position of the model will now be displayed in the Model Setup window
GETS:8.4
GETS:8.4 -86
sition. This can be seen as the complementary function to the static equilibrium module. Both these modules work out when the system is in static equilibrium. The dierence is: Static equilibrium calculates the position in which the model is in equilibrium with a dened set of physical constraints Nominal force parameters calculates the necessary physical parameters, so that the system is in equilibrium at a given position First of all you must set the joint states Set joint state $J Body1=1.0 Set joint state $J Body2=-1.0 Set velocity of both joints to zero Click on Calculation from the pull-down menu in the user interface and then on Nominal Force Parameters or click on the Nominal Force Parameters toolbar button. The Nominal Force window appears, gure GETS:8.4.8. Stay with the Default values for the solution method
GETS:8.4 -87
Figure GETS:8.4.8: Nominal Forces Window You must now select which of the force parameters will be determined by SIMPACK in the nominalforce calculations. Click on Selection of Force Parameters . The Nominal Force Param eter List window appears Click on New to dene a new force element to be added to the nominal force parameter list. The Nominal Force Element List window appears Select the only force available $F Force1. The Select Nominal Force Parameters window appears For this analysis you will calculate the force required from the spring for the system to be statically determined. In this window select Stiness and click on OK and you will then return to the Nominal Force Parameters List window. This should now look as follows, gure GETS:8.4.9: Click on OK and you will now be back to the Nominal Forces window
GETS:8.5 -88
Eigen Behaviour
Figure GETS:8.4.9: Nominal Forces Parameter List Click on Perform and SIMPACK will display the spring force required for the system to be in static equilibrium Click on OK and you will then return to the Nominal Forces
window. Click on Save to save the results for comparison with the eigenvalue solution. Keep the default save settings and then click on Exit
GETS:8.5
Eigen Behaviour
The SIMPACK Eigenvalue module linearises the non-linear equations of motion and calculates the eigenvalues and eigenvectors. The state about which the linear equations can be calculated include: Nominal state x 1, used as the initial state for the time integration Linearisation state x 1, used as the initial state for the time integration End state, x end of integration run 1 End state, x end of integration run 2 An arbitrary state x i calculated by time integration from t=t 0 to t=t end in i=1 to ntout steps Either select Eigenvalues from the pull-down menu or click on the Eigenvalues toolbar button. The Eigen Values window appears gure GETS:8.5.10 Choose initial state as the state for linearisation and then click on Perform . The eigenvalues are displayed in this window
Eigen Behaviour
GETS:8.0 -89
Figure GETS:8.5.10: Eigen Values Window Click on animation from the pull-down menu in the 3D window and then select Mode Shapes. The SIMPACK animation control window appears Select one of the two natural frequencies displayed in the list box and then click on the play button as shown. SIMPACK begins the animation of the selected mode Click on the stop button and then select the other mode which can be animated in the same way
GETS:8.0 -90
Eigen Behaviour
It is now necessary to perform the time integration to see the eect that this bump stop has on how the pendulum behaves. To see what happens within the SIMPACK solver it is best to use the O-line time integration module. Open the SIMPACK Time Integration window from the SIMPACK user interface window. Calculation Time Integration Congure The SODASRT integration should already be selected, if not select it fromthe pop-down menu Integration Method. Click on the button Settings... The Time Integration - SODASRT win dow will appear. You have the choice under Root Functions,
whether SIMPACK will Ignore or Locate State Events. You should select Locate State Events. By selecting Roots enabled, SIMPACK will detect when a root is found and change the integration step size accordingly. This ensures these discontinuities within the integration process are picked up by the solver Click on OK to return to the Time Integration window. You should set the End time as 25 and the number of communication points as 1000 Exit this window and start the SIMPACK time integration module. In the SIMPACK Echo Area TimeInt window you can follow the process of the SIMPACK solver. As you have told SIMPACK to detect the roots, you will see that as the solver progresses, that each time the SIMPACK solver detects a root it will display this in the Echo Area You should now animate the model and see the eect this bump stop has on the motion of the double pendulum system
GETS:10.
GETS:10.1
Figure GETS:10.1.1: Slider Crank Model In this nal section of Getting Started you will learn how to develop the double pendulum force model into a slider crank mechanism. You will restrict the motion of the marker at the end of the second body so it is free to move only in the y direction.
GETS:10.2
GETS:10.3
GETS:10.3 -94
SIMPACK distinguishes between ordinary joints and constraints as doing so allows SIMPACK to create the minimum number of equations required to dene the system. This constraint will be dened between two markers. Click on Constraints from within the Elements pull-down menu or click on the Constraints toolbar button Create a new constraint with the name $L Loop (The procedure is the same as for creating a new body). Double click on this constraint and the Dene Constraints window appears. SIMPACK automatically denes this constraint from the inertia frame marker i to the inertia frame marker j. All the rotational and translational constraints are, by default, set to zero Select marker $M I1 as Marker i Select marker $M Body2 1 as Marker j Click on Constraint Type . The Constraint List window ap pears Select the User Dened Constraint and click on OK you will now return to the Dene Constraints window Click on the input line Lock Transl. in z of M K and in the SIMPACK Flags window that then appears select locked. The Dene Constraints window should look as follows, gure GETS:10.3.2:
GETS:10.4 -95
GETS:10.4
In the Dene Constraints window click on Assemble System If there are the same number of loop closing conditions to dependent joint states then SIMPACK will calculate the initial position and then display it in the 3D window, otherwise SIMPACK will
GETS:10.4 -96
start the Check State Dependence window. Your model currently has two dependent joints, that means the Check State Dependence window will open. At the top of this window SIMPACK states what the problem with the model is In this window select joint state joint.st.pos(1):$J Body1 In the window that then appears select Independent State. The Check State Dependence window should look as follows, gure GETS:10.4.3:
Figure GETS:10.4.3: Check State Dependence Dialogue Box Click on OK . You will then be back at the Dene Constraints window Click on Assemble System . SIMPACK will now calculate the new initial position The model should look as follows, gure GETS:10.4.4:
GETS:10.4 -97
GETS:10.5 -98
Exercises
GETS:10.5
Exercises
Save your model Perform time integration, static equilibrium, eigenvalues, etc Try varying the initial state and velocity of $J Body1 in MBS Dene Joint and calculate the new initial positions. It is interesting to see how the slider crank responds to dierent initial states and velocities You can also try changing joint1 to dependent and $J Body2 to independent and then editing the state and velocity of joint2. It is possible to edit whether the joints are independent or dependent in the MBS Dene Joint dialogue box. If you click on the input line Initial State then in the window that then appears you have the choice whether the joint is dependent or independent
On-line Kinematics
GETS:10.6 -99
GETS:10.6
On-line Kinematics
You will use the slider crank model you have developed. You will learn how to manipulate the joint states on-line and display their position in the Model Setup window. You will do this by controlling the state of $J Body1 with the use of an interactive slider bar. Copy the slider crank model to slider crank online kinematics and open this model in the pre-processor Ensure that joint $J Body1 is as follows: State =-0.2 and velocity=0.2 Check, within the Joints Modelling Element, that joint $J Body2 is dependent and joint $J Body1 is independent
GETS:10.6 -100
On-line Kinematics
Figure GETS:10.6.5: Dene Interactions The SIMPACK 3D MBS interactions window appears Click on the pop-text item Interaction 1 and you will see that up to 6 dierent on-line interactions can be dened. Each of these corresponds to an interaction in the Kinematics window. Select Interaction 1 Click on the pop-text window Parameter Type and in the pop text window that appears select Joint Position State. The SIMPACK MBS Element window appears with the two joints. As you are going to control the state of joint $J Body1 then select this joint Enter the following information:
Parameter Id: 1 Initial Value: -0.2
On-line Kinematics
GETS:10.7 -101
Figure GETS:10.6.6: MBS Interactions Click on Apply and then OK and then click on OK in the Kinematics window Save your model
Interactive Kinematics
Open the Kinematics window again from the Calculations pulldown menu in the 3D Model Setup window. You will see that the rst slider bar is named as joint state body1. You can now use this slider bar to control the model Click on the slider with the mouse and you will then be able to move the slider bar using the mouse, which in turn will control the state of joint $J Body1 as shown in gure GETS:10.6.7: Once nished click on OK
GETS:10.7 -102
Inverse Kinematics
GETS:10.7
Inverse Kinematics
In this section you will learn inverse kinematics. This module calculates the forces and accelerations occurring when a model moves through a predetermined motion. A constant velocity or velocity prole could be used to describe the motion of a joint. In this section you will modify the joint of Body1 so it is a constant velocity joint. The model must be completely statically determined (0 degree of freedom) if you wish to perform on-line kinematics. SIMPACK has joints which have a completely determined motion and therefore 0 degrees of freedom. You will use one of these joints in this example. They are normally referred to as rheonomically driven joints.
Inverse Kinematics
GETS:10.7 -103
Copy the slider crank model to slider crank inv kin Change joint $J Body1 to a constant angular velocity joint, gure GETS:10.7.8
Figure GETS:10.7.8: Selection of the Rheonomically Driven Joint Change the other parameters for the joint so they are as follows: Model Data of the modied joint $J Body1: Type : Joint with constant velocity Axis : Rotational motion about xaxis initial state of the joint : -0.2 [rad] constant angular velocity : 0.5 [rad/s] The MBS Dene Joint window should look as follows, gure GETS:10.7.9:
GETS:10.7 -104
Inverse Kinematics
Inverse Kinematics
GETS:10.0 -105
Figure GETS:10.7.10: Inverse Kinematics Window Click on Save and then on Exit Save your model
GETS:10.0 -106
Inverse Kinematics
GETS:11.
How to Move On
You have now completed the getting started guide and you should now have a good understanding of how to use SIMPACK to build your own MBS model. You can now go on and build your own models in the SIMPACK pre-processor. Once you have dened your model in SIMPACK, you should be able to solve it and then manipulate the results within the post-processor. For a brief description of the available SIMPACK handbooks see the section What to nd where.