MV-8500: Use the Truck Library

In this tutorial, you will build a full truck model with a driver, add events to the model, and view the reports.

The purpose of this tutorial is to walk you through the process of how to build a full truck model with advanced drivers and how to add events to the model built.

The new event user interface is supported only for models with advanced drivers. Files can be edited or updated in the event editor. Sixteen event types are supported. To learn more about the events, see Full Vehicle with Driver.

Select Model Type

In this step, you will load the MBD-Vehicle Dynamics Tools preference file and select a model type using the Set wizard library dialog.

In MotionView, models are assembled from libraries of pre-defined systems using the Assembly Wizard. The Assembly Wizard dialog guides you through the assembly process, ensuring that your selections are compatible.

  1. Start a new MotionView session.
    Figure 1.
  2. From the menu bar, click File > Load > Preference File to open the Preferences dialog.
    Figure 2.
  3. Select MBD-Vehicle Dynamics Tools and click Load.
    Figure 3.
  4. Set the required truck wizard paths using the Assembly Wizard dialog.
    1. From the menu bar, click Model > Set Wizard Paths.
      Figure 4.
      The Set wizard library dialog opens.
    2. From the Wizard library drop-down menu, select Heavy Truck.


      Figure 5.
    3. Browse and locate the required paths from the installation folder and click OK.
  5. From the menu bar, select Model > Assembly Wizard.


    Figure 6.
    The Heavy truck - Model Type dialog opens.


    Figure 7.

Build a Full Truck Model with Driver

In this step, you will build a full truck model with a driver using the Heavy truck - Model Type dialog.

In MotionView, truck models are assembled from libraries of pre-defined systems using the Heavy Truck library. It guides you through the assembly process, ensuring that your selections are compatible. The Full truck with driver model type builds the model with steering, front suspension, rear suspension, powertrain, and driveline.

  1. From the Heavy truck - Model Type dialog, select Full truck with driver and click Next.
  2. Select the bodies.
    1. From the Frame drop-down menu, select Ladder-rigid.
    2. From the Cabin drop-down menu, select Conventional Semi-forward cab.
    3. From the Cargo drop-down menu, select Container Box.
    4. From the Instrumentation drop-down menu, select Instrumentation.
    5. Click Next.


    Figure 8.
  3. Select the primary systems.
    1. From the Front suspension drop-down menu, select Front solid axle suspension.
    2. From the Rear suspension drop-down menu, select Rear dual solid axle suspension.
    3. From the Powertrain drop-down menu, select Linear Torque Map Powertrain.
    4. Click Next.


    Figure 9.
  4. Select steering systems.
    1. From the Steering linkages drop-down menu, select Pitman Arm Steering.
    2. From the Steering column drop-down menu, select Steering column.
    3. From the Steering boost drop-down menu, select EPAS.
    4. Click Next.


    Figure 10.
  5. Select the springs.
    1. From the Front spring drop-down menu, select Leaf springs.
    2. From the Rear spring drop-down menu, select Bell crank linked leaf spring.
    3. Click Next.
    Note: Based on the suspension type selected for the Front suspension and Rear suspension, the Front spring and Rear spring options are modified accordingly.


    Figure 11.
  6. Select shock absorbers.
    1. From the Front shocks drop-down menu, select Front shock absorber (with inline jts).
    2. From the Rear shocks drop-down menu, select Rear shock absorbers (with inline jts).
    3. Click Next.


    Figure 12.
  7. Select jounce and rebound bumpers.
    1. From the Front jounce bumpers drop-down menu, select Front external jounce bumpers.
    2. From the Front rebound bumpers drop-down menu, select Front internal reb bumpers.
    3. From the Rear jounce bumpers drop-down menu, select Rear external jounce bumpers.
    4. From the Rear rebound bumpers drop-down menu, select Rear internal reb bumpers.
    5. Click Next.


    Figure 13.
  8. Select driveline systems.
    1. From the Brake system drop-down menu, select Brakes.
    2. From the Rear driveline drop-down menu, select Two-axle driveline.
      Note: Based on the suspension type selected, the Rear driveline options are modified accordingly.
    3. Click Next.


    Figure 14.
  9. Select driveshaft systems.
    1. From the Rear driveshaft drop-down menu, select Rear Driveshaft 1-piece.
    2. From the Auxiliary driveshaft drop-down menu, select Secondary driveshaft.
    3. Click Next.


    Figure 15.
  10. Enter a Driver system.
    1. From the Driver system drop-down menu, select Altair Driver.
    2. Click Next.


    Figure 16.
  11. Click Finish to complete the process and exit the custom library wizard.


    Figure 17.
    The full truck with driver model is displayed in the modeling window.


    Figure 18.
    The subsystems that you have selected in the Custom library wizard to build the model are displayed in the Project Browser.


    Figure 19.

Add Events to the Model

In this step, you will add events to the model you built in Build a Full Truck Model with Driver.

The following steps outline how to add an event to the previously built model. Currently, nineteen event types are available in the advanced driver models:
  • Altair Driver File
  • Brake in Turn
  • Constant Radius
  • Double Lane Change
  • J Turn
  • Power off in Straight Line
  • Pulse Steer
  • Road Course Drive
  • Single Lane Change
  • Sinusoidal Steering
  • Slalom
  • Step Steer
  • Straight Line Acceleration
  • Straight Line Braking
  • Swept Sine
  • Swept Steer
  • Throttle off cornering
  • Throttle off Turn in
  • N-post shaker

Each event type has different options that needs to be addressed. In the following steps the Constant Radius event is explained.

  1. From the Project Browser, right-click on Model and select Add Events.


    Figure 20.
    The Add Scripted Driver Task dialog opens.
  2. From the Type drop-down menu, select the Constant Radius event and click OK.


    Figure 21.
    The Constant Radius event is added to the Project Browser.


    Figure 22.
  3. Open the Event Editor dialog by right-clicking on the ConstantRadius 0 event from the Project Browserand select Edit Event from the context menu.
    The Constant Radius event's parameter is displayed.
  4. Enter the necessary information in the Constant Radius event's parameter.
    1. Change the Units to meters (m).
    2. For Radius [m], enter 40.
    3. For Initial straight [m], enter 20.
    4. For Initial velocity [m/s], enter 5.
    5. For Final velocity [m/s], enter 12.
    6. From the Turn direction drop-down menu, select Left.
    7. For Transient time [s], enter 10.
    8. For Look ahead time [s], enter 0.5.
    9. For Prediction step size, enter 0.01.
    10. For Print interval [s], enter 0.05.
    11. From the Output XML File, browse and select the file path.


    Figure 23.
  5. Click the Run button.
    An ADF (Altair Driver File) is generated with all the event parameters at the XML file path (Output XML File) location. The model is exported and MotionSolve starts to generate the result files. MotionSolve is invoked in the background.


    Figure 24.
    Note: The generated file types include: .adf, .plt, and .h3d files.
  6. Once the MotionSolve run is complete, close the window and return to the MotionView interface.

View the Reports

In this step, you will view the reports using the View Reports wizard.

Report templates are a series of pre-defined plots that apply the standard set of plots required for an event. A report template generates all the plots and properly labels them.

  1. From the menu bar, click Analysis > View Reports.


    Figure 25.
    The View Reports wizard is displayed.
  2. From the View Reports window, select Driver Report and click OK.


    Figure 26.
    A series of report templates are displayed in the Plot Browser.
  3. Using the sessions, navigate through the pages and review the results.


    Figure 27.