Using Adams Insight With ADAMSView
Using Adams Insight With ADAMSView
Overview
This tutorial guides you through the process of designing an
ADAMS/View experiment and evaluating the results using
ADAMS/Insight. Both products are part of the MSC.ADAMS®
suite of software.
ADAMS/Insight is a stand-alone product that also works with
ADAMS/View, ADAMS/Engine, ADAMS/Car, and
ADAMS/Chassis. ADAMS/Insight lets you design
sophisticated experiments for measuring the performance of
your mechanical system model. It also provides a collection of
statistical tools for analyzing the results of your experiments so
that you can better understand how to refine and improve your
model.
This guide assumes you know how to use ADAMS/View. We
also assume that you are familiar with parametric modeling
capabilities including creating, modifying, and using points and
design variables. In addition, you should know how to specify
design objectives. For information on ADAMS/View or other
MSC.ADAMS products, see the online help.
This guide also assumes that you have a moderate level of
knowledge about experimental design or Design of
Experiments (DOE) and that you have access to in-depth
references on them.
■ Introducing the Suspension Tutorial, 3
The information in this document is furnished for informational use only, may be revised from time to time, and
should not be construed as a commitment by MSC.Software Corporation. MSC.Software Corporation assumes no
responsibility or liability for any errors or inaccuracies that may appear in this document.
Copyright Information
This document contains proprietary and copyrighted information. MSC.Software Corporation permits licensees of
®
MSC.ADAMS software products to print out or copy this document or portions thereof solely for internal use in
connection with the licensed software. No part of this document may be copied for any other purpose or distributed or
translated into any other language without the prior written permission of MSC.Software Corporation.
Copyright © 2005 MSC.Software Corporation. All rights reserved. Printed in the United States of America.
Trademarks
ADAMS, EASY5, MSC, MSC., MSC.ADAMS, MSC.EASY5, and all product names in the MSC.ADAMS Product
Line are trademarks or registered trademarks of MSC.Software Corporation and/or its subsidiaries.
NASTRAN is a registered trademark of the National Aeronautics Space Administration. MSC.Nastran is an enhanced
proprietary version developed and maintained by MSC.Software Corporation. All other trademarks are the property of
their respective owners.
Government Use
Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in FAR 12.212
(Commercial Computer Software) and DFARS 227.7202 (Commercial Computer Software and Commercial
Computer Software Documentation), as applicable.
1 Introducing the Suspension Tutorial
Overview
This chapter introduces you to the suspension tutorial and gets
you started. The tutorial uses a simple automotive example to
illustrate the basics of ADAMS/Insight. Even if you don’t have an
interest in automotive parts as a regular part of your job, we think
you’ll find these instructions sufficient to help you focus on the
capabilities of ADAMS/Insight.
The sections in this chapter are:
■ About the Tutorial, 4
■ Starting ADAMS/View, 5
■ ADAMS/Insight Interface, 8
Geometric
Performance attributes you’ll
locations Description of event:
monitor:
you’ll modify:
Outer tie-rod You’ll track the changes in toe You’ll determine how
location angle as the suspension moves modifying the geometric
through its range of motion from location of the outer tie-rod
jounce to rebound. affects toe angle. A real-world
application for this event
Toe angle is the projected angle the
includes:
wheel plane makes with the ground
when viewed from above the ■ Determining if exaggerated
vehicle. Toe-in is considered changes in toe angle result
positive, and toe-out is considered in aggressive tire wear.
negative. ■ Assessing your model
against a manufacturing
variation.
■ Assessing packaging
requirements for your
model.
Using ADAMS/Insight with ADAMS/View
Introducing the Suspension Tutorial 5
Starting ADAMS/View
The section provides instructions on how to start ADAMS/View on UNIX and Windows.
Note: On Windows, you may need to set the permissions to Full Control to edit the
tutorial files.
5 Select OK.
ADAMS/View imports the file, and then displays the car suspension model. It also
opens the Simulation Control dialog box.
Running a Simulation
Before you create your experiment, you’ll simulate the suspension model in
ADAMS/View.
■ In the Simulation Control dialog box, select the Start tool , and wait for the
simulation to finish.
ADAMS/View runs the simulation.
Using ADAMS/Insight with ADAMS/View
Introducing the Suspension Tutorial 7
Starting ADAMS/Insight
In this section, you’ll open ADAMS/Insight from ADAMS/View and begin creating an
experiment to measure the performance of a suspension model.
ADAMS/Insight Interface
This section describes what you see when ADAMS/Insight first opens. Figure 1 shows the
main window as it appears when you first launch ADAMS/Insight. It includes the
following items:
■ Menu bar - Contains pull-down menus for File, Edit, Define, Simulation, Tools,
and Help.
■ Toolbars - Contain commonly used tools for accessing files, creating and
modifying designed experiments.
■ Treeview - Displays a hierarchical list of objects that you can include in an
experiment. The tree is especially useful for selecting and identifying objects
when you are creating a design matrix.
■ Viewport - The area of the window that displays parameters for modifying the
objects you select from the treeview.
■ Status bar - Displays messages and issues prompts during your ADAMS/Insight
session.
Figure 1. ADAMS/Insight Main Window
Menu bar
Toolbars
Treeview Viewport
Status bar
Using ADAMS/Insight with ADAMS/View
Introducing the Suspension Tutorial 9
ADAMS/Insight Toolbars
The ADAMS/Insight main window has four toolbars:
■ Main (Experiments) toolbar - Lets you execute basic commands.
■ Design Assistant (Experiments Contents) toolbar - Helps you build and execute
your experiment.
■ Work Space toolbar - Lets you execute commands on the work space.
■ Report toolbar - Lets you generate and export a report.
If you hold your mouse pointer over any tool, tip text appears giving a short description of
the tool.
Tools in toolbars are arranged in the order that you’ll use them in the process of creating
and executing your designed experiment. Depending on where you are in the process of
creating an experiment, ADAMS/Insight enables or disables the tools (you can always
display and undisplay them if you need to). This feature alerts you to the correct order of
procedures to follow. For example, the Run simulations tool is disabled until you define
required elements for a design matrix.
For more information on the toolbars, see the ADAMS/Insight online help.
Using ADAMS/Insight with ADAMS/View
10 Introducing the Suspension Tutorial
2 Creating and Running an Experiment
Overview
This chapter guides you through the process of creating a design
matrix and running the model through a number of simulations
that you set up in the experiment.
The sections in this chapter are:
■ Creating a Design Matrix, 12
Promoting Candidates
The first step required to creating your designed experiment is to select the factors that you
want to include in your design matrix. You select factors from the Candidates list in the
treeview, and then promote them to the Inclusions list. Promoting candidates to inclusions
causes them to become part of your design matrix.
1 In the treeview, select the + in front of Factors. Factors expands to reveal Inclusions
and Candidates.
2 Continue by expanding Candidates, tut_101_aview, ground, and hpl_tierod_outer. Under
hpl_tierod_outer, you’ll see a list of design variables that you can include in your
design matrix.
Note: The treeview displays the full object hierarchy for each design variable.
This tutorial will only refer to the variable name. For example, the variable
hpl_tierod_outer.x appears as ground.hpl_tierod_outer.x in the treeview.
Using ADAMS/Insight with ADAMS/View
Creating and Running an Experiment 13
3 Select the candidate, hpl_tierod_outer.x, and then move your cursor to the Design
Assistant toolbar and select the Promote to inclusion tool .
The candidate hpl_tierod_outer.x moves to the Inclusion list under Factors in the
treeview.
Tip: To select more than one factor, hold the Ctrl key as you click. To promote the
factors directly from the treeview, press the shortcut key F5.
1 In the treeview, find the factors in the Inclusions list. Select the factor
hpl_tierod_outer.x.
Promoting Responses
Now that you have finished promoting and modifying your factors, the next step is to
promote your responses for the experiment.
Tip: You can select the minus (-) sign in front of Factors to collapse that section
of the treeview and save screen space.
3 Select and promote the following responses just as you promoted the factors in
Step 3 on page 13:
■ toe_left_REQ
■ toe_right_REQ
The responses move from the Candidates to the Inclusion list.
Using ADAMS/Insight with ADAMS/View
18 Creating and Running an Experiment
Modifying Responses
The modifications you’ll make to the responses are minor. You’ll add units and change
one of the parameters. To learn more about response parameters, press the F1 key from the
Response form.
To modify responses:
1 In the treeview, under Responses, in the Inclusions list, select the response,
toe_left_REQ.
Note: Output characteristics are grayed out when you use ADAMS/Insight with
ADAMS/View and other MSC.ADAMS applications. The output characteristic
is set by the originating CAE application, and is displayed in the Response form
for information only.
1 In the Design assistant toolbar, select the Set design specification tool , or in the
treeview, expand the levels under Design, and then select Specification. You can also
select the Define menu, point to Experiment Design, and select Set Design Specification.
The Design Specification form appears, in the viewport, as shown next.
Using ADAMS/Insight with ADAMS/View
Creating and Running an Experiment 21
■ Model: Linear
5 Select the Define menu, point to Experiment Design, and then select Create Work Space.
Note: Selecting the Generate Work Space tool in the Design Assistant toolbar performs
Steps 4 and 5.
The Work Space appears in the viewport as shown in Figure 3 on page 22. This table
displays the work space matrix for the full-factorial experiment that you defined above.
ADAMS/View will run a simulation for each trial defined in this matrix. The column
headings are sortable and sizeable. You can also select Work Space Review to view
summary information for each factor and response in your experiment.
In the treeview, at the Design level, the letters D:W appear to indicate that the Design
contains a successfully generated design work space.
Using ADAMS/Insight with ADAMS/View
22 Creating and Running an Experiment
Note: Columns appear in the work space matrix in the order that you promote
factors for inclusion.
Tip: Put your mouse pointer over column headings to display key information
about the abbreviation shown.
Using ADAMS/Insight with ADAMS/View
Creating and Running an Experiment 23
1 In the Design Assistant toolbar, select the Run simulations tool . You can also
select the Simulation menu, point to Build-Run-Load, and then select All.
ADAMS/View opens and runs the simulations defined by your experiment. The
ADAMS/View Status bar displays messages showing simulation progress. The
Message window also appears and displays warnings about joint locations, which
you can ignore for this tutorial.
Note: This procedure builds, runs, and postprocesses all of the simulations within
the ADAMS/View session. We recommend that you break up the process
flow into its separate phases using the MDI INSIGHT BUILD and MDI
INSIGHT LOAD commands. This is especially important when you have
more than 30 trials.
■ Fitting Results, 27
■ Optimizing Results, 30
■ Publishing Results, 33
Using ADAMS/Insight with ADAMS/View
26 Working with Results
Reviewing Results
After ADAMS/View completes the trials defined in your design matrix, you return to the
ADAMS/Insight interface to view the results.
To return to ADAMS/Insight:
1 From the Main menu in ADAMS/View, select Simulate, point to ADAMS/Insight, and
then select Display.
The ADAMS/Insight Display dialog box appears with the name of your current
experiment.
2 Select OK.
ADAMS/View undisplays and the ADAMS/Insight window opens.
Runs
Factors Responses
Fitting Results
Now that ADAMS/View has completed the trials defined in your work space matrix, you
can use ADAMS/Insight to fit your results to a polynomial or a response surface. The
purpose of fitting your results is to establish a relationship between the factors and
responses that you selected for the work space matrix. Fitting results includes a multiple
regression. You will be able to investigate the parts of the regression in the Summary
(located in the treeview under Analysis) after completing the steps on page page 27. For
more information on this topic, refer to the ADAMS/Insight online help.
1 From the Design Assistant toolbar, select the Fit results tool . You can also select
the Tools menu, and then select Fit New Model.
The Model Properties Summary window appears. Here, you can enter information
on your model.
2 In the Regression column, select the response, toe_left_REQ.
3 In the Display column, select the type of results you want to view. For example,
Figure 5 shows an example of the Fit table.
Using ADAMS/Insight with ADAMS/View
28 Working with Results
For definitions of the items in the results tables, refer to the online help.
The tables also provide you with a color code that indicates the soundness of your
results:
Green indicates that all fit criteria meet or exceed highest fitting thresholds
Yellow indicates that the fit criterion may bear investigation
Red indicates that the fit criterion should be investigated
Using ADAMS/Insight with ADAMS/View
Working with Results 29
Optimizing Results
You can perform single-objective and multi-objective optimization using
ADAMS/Insight. Single-objective optimization involves trying to achieve a target for one
scalar response; multi-objective optimization involves more than one scalar response.
You can optimize your results by:
■ Updating Factor Settings, 30
■ Updating Design Objective (Response) Settings, 32
Note: To save your results, select Write and enter the name of the file to which you
want to save. You can save to a number of different formats, including a
.cmd file, which can then be read back into ADAMS/View to set the model
using the specified factor settings.
Using ADAMS/Insight with ADAMS/View
32 Working with Results
1 Modify the response values as appropriate. You can change the following values:
❖ Oper: Changes the operator.
❖ Target: Changes the target value for the response.
❖ Weight: Applies a higher priority in achieving optimization for that factor.
Weight values can range from 0.0 to 1.0, where 1.0 indicates greater
importance.
2 Select Fixed next to any factor that you don’t want changed during the
optimization.
3 Press Run.
ADAMS/Insight updates the factor values to reflect the changes you made to the
responses. Use the Reload button to return to the nominal values for each
factor/response.
Note: To save your results to a text file, select Write and enter the name of the file
and file type to which you want to save.
Using ADAMS/Insight with ADAMS/View
Working with Results 33
Publishing Results
ADAMS/Insight lets you save your results in .html, .slk, .bas (Visual Basic), and .m
(MATLAB) formats. Once saved, you can use other utilities, such as a browser or
spreadsheet program, to modify factors and see the effect on responses without performing
full simulations.
1 In the treeview, under Analysis, select Model_01, and then go to the Design Assistant
toolbar, and select the Export to Web, SLK, etc. tool . You can also select the File
menu, point to Export, and then select Model. In the window that opens, set the File
Type to HTML File.
1 The Save dialog box appears and prompts you to save your results as xxx.htm,
where xxx is the name of your file.
2 Enter a name for your file and specify the path where you would like it to reside,
and then select Save.
ADAMS/Insight saves your file in the directory that you specified.
3 Continue with the next section, Modifying Values Using a Web Browser, 33, to
learn how to view and use the results in the HTML file.
1 If not already displayed, display the Report toolbar by right-clicking a blank space
in the toolbar area, and then selecting Report.
Your default browser opens the HTML page you created for your experiment.
Using ADAMS/Insight with ADAMS/View
34 Working with Results
3 Change the value for the first factor hpl_tierod_outer.x from 417 to 420, and then
select Update.
The estimated responses adjust to reflect the new factor values. Notice that the
value for only one of the responses, toe_left_REQ, reflects a change. Because the
MSC.ADAMS model you’re working with is an independent suspension, in which
the right tie rod is not coupled with the left tie rod, the changes in the factor values
you made only affect the left side of the suspension.
Using ADAMS/Insight with ADAMS/View
Working with Results 35
4 You can continue to vary the factor values and investigate how changes to them
affect your responses. To learn more about analyzing the results of your
experiment and publishing your results to HTML or SYLK pages, refer to the
ADAMS/Insight online help.
5 Close your browser window.
6 Exit ADAMS/Insight.
7 Exit ADAMS/View.
■ Stats - Displays R2, R2 adjusted, P, and R/V statistics for each response.
■ Effects - For each response, displays effects caused by varying each factor from
its minimum to maximum value.
■ Nonscalar - Displays composite responses in addition to the scalar responses.
■ Plots- Opens a new window that displays a plot for each composite response
(providing you specified composite responses).
■ Info - This button displays a separate window that provides summary
information about the DOE parameters for the current page. It also provides
Web environment information that is valuable if you need to contact
MSC.ADAMS technical support.
For more information on the controls and information provided by the HTML page, refer
to the ADAMS/Insight online help.
Using ADAMS/Insight with ADAMS/View
36 Working with Results
4 Using the Monte Carlo Method
Overview
This chapter introduces you to the Monte Carlo method of
analysis. The tutorial uses a launch vehicle/spacecraft separation
example to illustrate the mechanics of the solution.
The sections in this chapter are:
■ Introducing the Monte Carlo Method, 38
■ Starting ADAMS/View, 38
■ Starting ADAMS/Insight, 42
■ Reviewing Results, 47
Starting ADAMS/View
The section teaches you how to start ADAMS/View on UNIX and Windows.
5 Select OK.
ADAMS/View imports the command file, and then displays the launch vehicle
model.
Using ADAMS/Insight with ADAMS/View
40 Using the Monte Carlo Method
6 Zoom in on the top portion of the vehicle. Note the four forces between the adapter
frustum and the spacecraft (they’re circled in the following figure).
Using ADAMS/Insight with ADAMS/View
Using the Monte Carlo Method 41
3 Select the Play tool , and wait for the simulation to finish.
ADAMS/View runs the simulation.
4 From the Review menu, select Animation Controls.
5 Select the Play tool and wait for the animation to finish.
Note that the four forces push the spacecraft off of the launch vehicle.
6 Close the Animation Controls dialog box.
Identifying Measures
Here, you will identify the measures in the model.
1 From the Build menu, point to Measure, and then select Display.
The Database Navigator opens, displaying the four measures for the model: three
angular velocity components and a translational separation velocity component.
For information on measures, refer to the ADAMS/View online help.
2 Close the Database Navigator.
3 From the Simulate menu, point to Design Objective, and then select Modify.
The Database Navigator opens.
Using ADAMS/Insight with ADAMS/View
42 Using the Monte Carlo Method
4 Select separation.
The Database Navigator displays the four objectives representing the ending
simulation values for each measure.
For information on design objectives, refer to the ADAMS/View online help.
5 Close the Database Navigator.
Starting ADAMS/Insight
In this section, you’ll open ADAMS/Insight from ADAMS/View and begin creating an
experiment to measure the performance of a launch vehicle model.
3 Select OK.
ADAMS/View launches ADAMS/Insight and the ADAMS/Insight main window
appears.
In the treeview of ADAMS/Insight, note that the model has eight factors and four
responses.
Using ADAMS/Insight with ADAMS/View
Using the Monte Carlo Method 43
Promoting Candidates
The first step required to creating your designed experiment is to select the factors that you
want to include in your design matrix. You select factors from the Candidates list in the
treeview, and then promote them to the Inclusions list. Promoting candidates to inclusions
causes them to become part of your design matrix.
1 In the treeview, select the + in front of Factors. Factors expands to reveal Inclusions
and Candidates.
2 Continue by expanding Candidates, and then separation. Under separation, you’ll see
a list of design variables that you can include in your design matrix.
3 Select all of the candidates by holding down the Ctrl key while mouse-clicking
each candidate.
4 Move your cursor to the Design Assistant toolbar and select the Promote to inclusion
tool .
The candidates move to the Inclusion list under Factors in the treeview.
Tip: To promote the factors directly from the treeview, press the shortcut key F5.
Using ADAMS/Insight with ADAMS/View
44 Using the Monte Carlo Method
Tip: You can select the minus (-) sign in front of Factors to collapse that section
of the treeview and save screen space.
6 Continue expanding the levels under Candidates and separation. Under separation,
you’ll see a list of responses that are potential candidates you can include in your
design matrix.
7 Select and promote all of the responses just as you promoted the factors in Step 3
on page 43.
The responses move from the Candidates to the Inclusion list as shown in
Figure 8.
Responses you
promoted from
Candidates to Inclusions
Using ADAMS/Insight with ADAMS/View
Using the Monte Carlo Method 45
Modifying Factors
After you promote your factors, you define parameters for them in the Factor form. To
learn more about factor parameters, press the F1 key from the Factor form.
1 In the treeview, find the factors in the Inclusions list. Select the factor spacecraft_lxx.
2 In the Factor form, select the Variation tab.
3 Set Distribution to Normal.
4 Select the Calculator tool next to the Standard Deviation text box.
The Specify Variation Characteristics dialog box appears.
5 Select Tolerance, enter 40 in the corresponding text box, and then select OK.
6 Select Apply in the Factor form.
ADAMS/Insight saves your factor modifications.
7 Modify the parameters for the remaining factors as follows. Be sure to select Apply
after modifying each factor.
1 In the Design assistant toolbar, select the Set design specification tool.
2 Complete the Design Specification form as shown next.
3 Select Apply.
4 To create the work space, select the Generate Work Space tool.
The Work Space appears in the viewport. Note that the response columns are
empty.
Using ADAMS/Insight with ADAMS/View
Using the Monte Carlo Method 47
1 In the Design Assistant toolbar, select the Run simulations tool. You can also select
the Simulation menu, point to Build-Run-Load, and then select All.
ADAMS/View displays and runs the simulations defined by your experiment.
2 In the information window that opens, select OK.
Note: This procedure builds, runs, and postprocesses all of the simulations within
the ADAMS/View session. We recommend that you break up the process
flow into its separate phases using the MDI INSIGHT BUILD and MDI
INSIGHT LOAD commands. This is especially important when you have
more than 30 trials.
Reviewing Results
After ADAMS/View completes the trials defined in your design matrix, you return to the
ADAMS/Insight interface to view the results.
To return to ADAMS/Insight: