You are on page 1of 82

Adams 2017.

Release Guide
Corporate Europe, Middle East, Africa
MSC Software Corporation MSC Software GmbH
4675 MacArthur Court, Suite 900 Am Moosfeld 13
Newport Beach, CA 92660 81829 Munich, Germany
Telephone: (714) 540-8900 Telephone: (49) 89 431 98 70
Toll Free Number: 1 855 672 7638 Email: europe@mscsoftware.com
Email: americas.contact@mscsoftware.com

Japan Asia-Pacific
MSC Software Japan Ltd. MSC Software (S) Pte. Ltd.
Shinjuku First West 8F 100 Beach Road
23-7 Nishi Shinjuku #16-05 Shaw Tower
1-Chome, Shinjuku-Ku Singapore 189702
Tokyo 160-0023, JAPAN Telephone: 65-6272-0082
Telephone: (81) (3)-6911-1200 Email: APAC.Contact@mscsoftware.com
Email: MSCJ.Market@mscsoftware.com

Worldwide Web
www.mscsoftware.com

Disclaimer
This documentation, as well as the software described in it, is furnished under license and may be used only in
accordance with the terms of such license.
MSC Software Corporation reserves the right to make changes in specifications and other information contained
in this document without prior notice.
The concepts, methods, and examples presented in this text are for illustrative and educational purposes only,
and are not intended to be exhaustive or to apply to any particular engineering problem or design. MSC Software
Corporation assumes no liability or responsibility to any person or company for direct or indirect damages resulting
from the use of any information contained herein.
User Documentation: Copyright 2017 MSC Software Corporation. Printed in U.S.A. All Rights Reserved.
This notice shall be marked on any reproduction of this documentation, in whole or in part. Any reproduction or
distribution of this document, in whole or in part, without the prior written consent of MSC Software Corporation is
prohibited.
This software may contain certain third-party software that is protected by copyright and licensed from MSC
Software suppliers. Additional terms and conditions and/or notices may apply for certain third party software. Such
additional third party software terms and conditions and/or notices may be set forth in documentation and/or at
http://www.mscsoftware.com/thirdpartysoftware (or successor website designated by MSC from time to time).
Portions of this software are owned by Siemens Product Lifecycle Management, Inc. Copyright 2013. Portions
1998
The MSC Software logo, MSC, MSC Adams, MD Adams, and Adams are trademarks or registered trademarks of
MSC Software Corporation and/or its subsidiaries in the United States and other countries. FLEXlm and FlexNet
Publisher are trademarks or registered trademarks of Flexera Software. Parasolid is a registered trademark of
Siemens Product Lifecycle Management, Inc. All other trademarks are the property of their respective owners.

ADAM:V2017.1:Z:Z:Z:DC-REL-PDF
Contents
Adams 2017.1 Release Guide

Preface
Welcome to Adams 2017.1 viii

About MSC Software ix


Overview ix
About Virtual Product Development and Adams ix

Technical Support x
Web x
Phone and Email x
Training x

Internet Resources xii

1 Whats New
Whats New 2

General 3
Last Release for Python 2 3
Issues Resolved 3

Adams Car 4
Issues Resolved 4
Known Issues 7

Adams Car-AT 8
Issues Resolved 8

Adams Car-Ride 9
Issues Resolved 9

Adams Chassis 10
Issues Resolved 10
Known Issues 10

Adams Controls 11
Direct Communication Mode for FMI Co-simulation 11
CONTENTS iv

FMU Export for SIMulation Workbench 12


Heterogeneous FMU Export 12
Forward Compatible FMU 12
SMP Support for Co-simulation FMU 12
Issues Resolved 13
Known Issues 13

Adams Co-simulation Interface 14


Supported Versions of Software for Co-simulation 14
Known Issues 14

Adams Driveline 15
Issues Resolved 15

Adams Durability 16
Issues Resolved 16

Adams Explore 17
Issues Resolved 17
Known Issues 17

Adams Flex 18
Issues Resolved 18

Adams Insight 19
Known Issues 19

Adams Machinery 20
Issues Resolved 20
Known Issues 21

Adams MaxFlex 23
Issues Resolved 23
Known Issues 23

Adams Mechatronics 25
Direct Communication Mode for FMI Co-simulation 25
FMU Export for SIMulation Workbench 26
Heterogeneous FMU Export 26
Forward Compatible FMU 26
SMP Support for Co-simulation FMU 26
Issues Resolved 27

Adams PostProcessor 28
Plot Panning Improvements 28
Issues Resolved 28
CONTENTS v

Known Issues 30

Adams Real Time 31


Introducing Adams Real Time 31
Fixed Step Integrator 32
Real Time Reporting Option 32
Real Time Analysis with SIMulation Workbench 33
Licensing 35
Known Issues 35

Adams SmartDriver 36
Issues Resolved 36

Adams Solver 37
Fixed Step Integrator Option 37
Issues Resolved 39
Known Issues 40

Adams Tire 41
Local Tire Solver 41
High Performance Setting Management 42
Issues Resolved 43

Adams Vibration 44
Issues Resolved 44
Known Issues 44

Adams View 45
Last Release for Precision Shaded and Z Short Shaded Render Options 45
Issues Resolved 45
Known Issues 47

2 Running Adams Products


Starting Adams Products 54
Starting Adams Products on LINUX 54
Starting Adams Products on Windows 55

Setting Preferences 57
Setting Preferences on LINUX 57
Setting Preferences on Windows 57

Setting Your Working Directory 58


CONTENTS vi

3 Getting Help
Tool Tips 60

Online Help 61
Versions of Web Browsers 61
Accessing the Online Help 62
Searching 63
Printing 64
Index 64

Tutorials and Examples 65

4 Supported Versions of Integration Products


Support for Easy5 and MATLAB 68
Easy5 68
MATLAB 68

Supported Versions of Integration Products 69


MD Nastran 2006 Installation and Operations Guide

Preface


Welcome to Adams 2017.1

About MSC Software

Technical Support

Internet Resources
viii Adams 2017.1 Release Guide
Welcome to Adams 2017.1

Welcome to Adams 2017.1


Thank you for purchasing Adams 2017.1. Adams is motion simulation software for analyzing the
complex behavior of mechanical assemblies. With it, you can test virtual prototypes and optimize designs
for performance, safety, and comfort, without having to build and test numerous physical prototypes.
ix
Preface

About MSC Software

Overview
MSC Software Corporation is the leading global provider of virtual product development (VPD) tools,
including simulation software and professional services. MSC Software helps companies make money,
save time, and reduce costs associated with designing, testing, producing, and supporting manufactured
products.
MSC Software works with thousands of companies worldwide, in hundreds of industries, to develop
better products faster by using information technology, software, and services to enhance and automate
the product design and manufacturing process. Simulating your product performance reduces
development costs, time to market, and warranty costs.

About Virtual Product Development and Adams


Youve heard it before: manufacturing companies today face intense global competition, demanding
customers, fragmented markets, increasing product complexity, compressed product cycles, price and
profit pressures, strict regulatory and liability environments, systems integration and supply chain issues,
skyrocketing costs of testing and physical prototyping, and on and on
What you dont often hear, though, is a strategy for enabling your company to improve your new product
development process to meet these challenges.
Whether you are delivering airplanes, automobiles, ships, biomedical devices, golf clubs or childrens
toys to your customers, MSC Softwares goal is to help you improve your new product development
process, allowing you to be significantly better at your concept development, design, testing, and
production activities through the application of VPD.
VPD is an environment that uses an integrated combination of both simulation software technology and
traditional techniques to design, test, manufacture, and support products. The result is that cost-effective
designs that meet all performance, safety, durability, and reliability requirements can be brought to
market in less time and for less cost.
Adams, as part of VPD, is focused on enhancing your ability to make better product development
decisions, explore innovative design alternatives, and consistently get the product right. It is the world's
most widely used mechanical system simulation software. It enables you to produce virtual prototypes,
realistically simulating the full-motion behavior of complex mechanical systems on your computers and
quickly analyzing multiple design variations until an optimal design is achieved. This reduces the
number of costly physical prototypes, improves design quality, and dramatically reduces product
development time.
x Adams 2017.1 Release Guide
Technical Support

Technical Support
For help with installing or using an MSC Software product, contact MSC technical support. Our technical
support provides technical assistance on questions related to installation and use of the software. For
further details please see the Technical Support Usage Guide, which is accessible via our support web
site.
You can reach MSC technical support on the web, by telephone, or e-mail.

Web
Go to the MSC Software web site at www.mscsoftware.com, and click on Services -> Technical
Support. Here, you can find a wide variety of support resources including Product Updates, Discussions,
Technical Articles, and Documentation updates.
In addition, we provide several excellent sources of online information:
SimCompanion - Find solutions to problems in this repository of troubleshooting tips,
examples, and frequently asked questions. To access the SimCompanion, go to:
http://simcompanion.mscsoftware.com
VPD Community - The VPD community is where to go when you are looking for peer support,
as well as technical expertise. Many of our consultants, developers, and technical support staff
monitor the forums. To sign up for the forums, go to:
http://forums.mscsoftware.com
Then:
To view the Adams discussions, select Adams.
To view product alerts and company news and events, select MSC News.

Phone and Email


For a current list of phone numbers and language based email addresses please visit our support web site
and click on Contact Technical Support.

Training
MSC Software training provides comprehensive training in Virtual Product Development. We offer
standard and customized training courses in the application of CAE tools to solve from basic to complex
problems within any industry. We offer over 100 courses in our state-of-the-art classroom facilities and
individual computer graphics laboratories at training centers throughout the world. All of our courses
emphasize hands-on computer laboratory work to facilitate skills development. We are uniquely
positioned to optimize your investment in design and simulation software tools.
xi
Preface

Our industry experienced expert staff is available to customize our course offerings to meet your unique
training requirements. For the most effective training, we also offer many of our courses at our
customer's facilities.
We specialize in customized training based on our evaluation of your design and simulation processes,
which yields courses that are geared to your business. In addition to traditional instructor-led classes, we
also offer video courses, interactive multimedia training, web-based training, and a specialized
instructor's program.

Course Information and Registration


For detailed course descriptions, schedule information, and registration call the Training Specialist at
(800) 732-7211 or visit www.mscsoftware.com.
xii Adams 2017.1 Release Guide
Internet Resources

Internet Resources
MSC Software (www.mscsoftware.com)
MSC Software corporate site with information on the latest events, products and services for the
CAD/CAE/CAM marketplace.

MSC Software Store (store.mscsoftware.com)


store.mscsoftware.com is a virtual marketplace where clients can find engineering expertise, and
engineers can find the goods and services they need to do their job.
1 Whats New

Whats New, 2
General, 3

Adams Car, 4

Adams Car-AT, 8
Adams Car-Ride, 9

Adams Chassis, 10

Adams Controls, 11

Adams Co-simulation Interface, 14

Adams Driveline, 15

Adams Durability, 16

Adams Explore, 17

Adams Flex, 18

Adams Insight, 19

Adams Machinery, 20
Adams MaxFlex, 23

Adams Mechatronics, 25

Adams PostProcessor, 28
Adams Real Time, 31

Adams SmartDriver, 36

Adams Solver, 37
Adams Tire, 41

Adams Vibration, 44

Adams View, 45
2 Adams 2017.1 Release Guide
Whats New

Whats New
The following are highlights of additions to existing products. Subsequent updates to the Known Issues
and Resolved Issues lists may be found in the MSC SimCompanion articles linked above.
General, 3
Adams Car, 4
Adams Car-AT, 8
Adams Car-Ride, 9
Adams Chassis, 10
Adams Controls, 11
Adams Co-simulation Interface, 14
Adams Driveline, 15
Adams Durability, 16
Adams Explore, 17
Adams Flex, 18
Adams Insight, 19
Adams Machinery, 20
Adams MaxFlex, 23
Adams Mechatronics, 25
Adams PostProcessor, 28
Adams Real Time, 31
Adams SmartDriver, 36
Adams Solver, 37
Adams Tire, 41
Adams Vibration, 44
Adams View, 45
CHAPTER 1 3
Whats New

General
Last Release for Python 2
Issues Resolved

Last Release for Python 2


Adams 2017.1 is the last release for which support for Python 2 is guaranteed. Adams 2017.1 uses
Python 2.7.11. In the future Adams will move to a Python 3.X version. There are some changes in the
Python language which render some Python 2.X syntax nonfunctional in Python 3.X. For details visit
https://www.python.org/. The contents (classes, methods) of the new Adams Python Interface described
later in this document are already Python 3 compliant. However, when authoring Python code around
those classes and methods one should be advised that if it is not Python 3 compliant then it will not
function when imported into later releases of Adams.

Issues Resolved

ADMS-37567 Poor description of workingDirectory reg editor item in docs

ADMS-28431 Adams2015.1 Install guide under "Licensing on Linux" topic one of the
weblink is not working (pdf page no. 56)
ADMS-38997 Incorrect graphcis requiremets listed in Adams 2017 installation guide
4 Adams 2017.1 Release Guide
Adams Car

Adams Car
Issues Resolved
Known Issues

Issues Resolved

ADMS-37422 Dialog box help (F1 Help) not working for ACar Actuation Input Files
dialogs
ADMS-38822 typo in the help doc (Add testrig)
ADMS-38825 typo in the help doc (Modify Adjustable forcce)

ADMS-38474 Friction mapping issue moving from AChassis model to ACar

ADMS-34566 Leaf clip parameters shown wrong in Leaf spring editor

ADMS-38768 SPMM analysis has an error with an instant axis model(multi link
suspension.)
ADMS-27430 Both rack motion and steering wheel motion are active during statics when
tra steering is used

ADMS-38561 After saving an assembly as Binary, you cannot do subsystem swaps

ADMS-35318 solver settings default button doesn't work in Adams Car

ADMS-38661 Adams Car session crash while modifying Curve Manager Points value
(from default to 1)

ADMS-21471 abgVDM::req908 Information required


ADMS-36907 Improve Airspring documentation to include the role of automatic preload
for suspension analysis

ADMS-39371 F1 help and general help document not available for Create BSpline
Geometry dbox in ACar

ADMS-37107 function "gui_upd_assyclass_omenu" not working when the testrig is not


used
ADMS-38867 Text is overlapped if user resizes the Save As dialog box.
CHAPTER 1 5
Whats New

ADMS-33961 Problem with the event builder dialog box, the relative option is greyed out

ADMS-39192 Curve to curve/plane contact issue.


ADMS-38491 durability output file error
ADMS-39081 Adams Car crashes when saving template either as binary or ascii with a
specific name

ADMS-33513 Reading results file is crashing in Adams Car

ADMS-34788 Adams/Car contact UDE creation dialog must contain the option to refer to
I and J- solids internal to the template or otherwise update the
documentation

ADMS-39302 loading configuration rename works strange

ADMS-35807 While modifying the shape of "Nonlinear Beam-FE part" behaviour is not
proper in Adams Car

ADMS-35788 Error message appears when try to modify the FE part centerline to new
outline in Adams Car

ADMS-35790 Warning message of deleting the shell geometry appears while creating the
Nonlinear Beam with FE part method in Adams Car

ADMS-39042 Unable to Create an Adams User Library on Linux Using a DOS Created
List File.
ADMS-38533 Getting an error message while selecting request from database navigator
in Request Map Editor dialogbox

ADMS-28051 Leaf spring tool needs to clean up bush xml files

ADMS-37574 Colour of ARB is not saved while saving Subsystem

ADMS-38950 template update removes the requests in the group


6 Adams 2017.1 Release Guide
Adams Car

ADMS-15348 Template buider switch to standard interface when accidentally clicked on


F8(post-processor) and then closed the post-processor
ADMS-38610 Adams Car crashes while running the simulation

ADMS-35914 Construction Frame can be modified through Standard Interface

ADMS-37512 Changing ltf file should regenerate leaf spring

ADMS-38917 Actuator Table is grayed out and rows have different heights by default

ADMS-38639 property editor for a rebound stop doesn't work.(browse button)

ADMS-38637 property editor for a rebound stop doesn't work.(save button)

ADMS-38636 property editor for a rebound stop doesn't work.(damping field)

ADMS-37206 Switch Part modify generate an error message when a rigid body is
switched to flexible

ADMS-39558 "vertical set up mode" check doesn't work in dynamic suspension

ADMS-35825 Spline Checker: Backup Property Files option cannot retain the original file

ADMS-37733 ARB is not properly migrated while opening chassis model into Adams Car

ADMS-37057 Cannot create leaf spring properly when shackle location is selected as
front
ADMS-24618 Difference in shackle length for leaf spring
ADMS-24154 Error while creating auxiliary leaf spring in Adams Car
ADMS-36776 Airspring drive axle from demo truck database fails for suspension analysis

ADMS-36652 Saving a binary template as ascii


ADMS-37282 maximum power parameter for simple powertrain units problem

ADMS-37284 integral link not supported for C2C migration


CHAPTER 1 7
Whats New

ADMS-36732 Flex body orientation definition can't be transfered from a template to a


subsystem
ADMS-37160 Humvee demo model failing due to alignment

ADMS-38012 flex to flex DBOX has a wrong label


ADMS-26384 version of _loading_start.tpl should be updated in new feature example

Known Issues

ADMS-24253 Name of the Filter is also added to Group if user creates a Group by using
'Add to Group' option (Template Builder Mode)
ADMS-24971 Fit View is unsupported for the standalone OGL animation view in Adams
PostProcessor
8 Adams 2017.1 Release Guide
Adams Car-AT

Adams Car-AT

Issues Resolved

ADMS-35869 errors submitting file driven event with output prefix left empty
ADMS-39173 additional measures from compliance matrix method do not show up in
PPT
ADMS-14165 Error occurs while selecting postprocessing type - Test Suite for Static
Aligning Torque in Vehicle.asy
CHAPTER 1 9
Whats New

Adams Car-Ride

Issues Resolved

ADMS-36923 Request Map editor dosent work correctly when General Bushing is used
ADMS-37453 Problem with Initial jerk on Four poster when the Road is modeled using
table function
10 Adams 2017.1 Release Guide
Adams Chassis

Adams Chassis
Issues Resolved
Known Issues

Issues Resolved

ADMS-36668 Problems using controls subsystem with dll in Adams Chassis


ADMS-39216 Fix tab order in Chassis editors
ADMS-37897 User tire model casues unexpected termintaion when used with 3D shell
road

Known Issues

ADMS-21716 Flex Generation event does not work with rear twist beam
CHAPTER 1 11
Whats New

Adams Controls
Direct Communication Mode for FMI Co-simulation
FMU Export for SIMulation Workbench
Heterogeneous FMU Export
Forward Compatible FMU
SMP Support for Co-simulation FMU
Issues Resolved
Known Issues

Direct Communication Mode for FMI Co-simulation

With this release of Adams a new "Direct" communication option for FMI-based co-simulation has been
implemented. This option is meant to improve the communication performance between the FMU
master and slave during co-simulation. It is accessed from the Adams Controls Plant Export dialog and
is available only for Adams co-simulation with a master process based in another FMI-compliant tool.
It does not support any Adams-as-the-master co-simulation scenarios. And, it is restricted to use with
Adams Solver C++ (it does not support Adams Solver FORTRAN).
Previously existing FMI co-simulation communication modes continue to be supported. The table below
compares these three options.

Communication
Mode Adams Master FMI Master Speed
TCP/IP X X lower
Pipes X X medium
Direct X high
12 Adams 2017.1 Release Guide
Adams Controls

FMU Export for SIMulation Workbench


Adams Solver can now participate in co-simulations performed in Concurrent's SIMulation Workbench
(SimWB) real time environment. This is achieved via extensions to Adams' support for the Functional
Mockup Interface (FMI). A functional mockup (FMU) unit exported from Adams Controls within
Adams View or Adams Car can now be imported into SimWB. See the new feature example, "A17-
1_003_RT_Solver_on_SIMualtionWorkbench", included with this release for detailed usage steps.
The specific versions of this environment which MSC has certified are:
iHawk running RedHawk Linux 6.5 with SIMulation Workbench Control Center 7.5
RedHawk Linux 7.0 with SIMulation Workbench Control Center 7.4

See the "Real Time Analysis with SIMulation Workbench" entry under the Adams Real Time section of
this document for further details on these kinds of analyses.

Heterogeneous FMU Export


Adams Functional Mockup Units (FMU) exported from Adams Controls on one supported Adams
platform can now be used for Functional Mockup Interface (FMI) co-simulations on other supported
Adams platforms.

Forward Compatible FMU


Adams Functional Mockup Units (FMU) exported from Adams Controls in previous versions of Adams
can now be used with later versions of Adams by setting the environment variable
ADAMS_PATH_FOR_FMU=<Adams Installation Path> for the environment running the later version of
Adams. For example, if Adams is installed in C:\MSC.Software\Adams\2017_1, then <Adams
Installation Path> would be C:\MSC.Software\Adams\2017_1. Previously one would have to regenerate
the FMU on the newer version of Adams.

SMP Support for Co-simulation FMU


Adams Functional Mockup Units (FMU) exported from Adams Controls for Functional Mockup
Interface (FMI) co-simulations now support Adams Solver SMP multi-threading. So, now in the solver
executable settings one can set "Thread Count" greater than 1 and this setting will employed for FMI co-
simulation.
CHAPTER 1 13
Whats New

Issues Resolved

ADMS-39466 Docs keyword search: "debug controls" not matching obvious things
ADMS-37959 Adams crashes when importing dll created using simulink model having
parameters defined using multi-level structures
ADMS-38635 Session will crash trying to run interactive simulation on model ion which
one imported Easy5 generated dll without using any input and output signal
ADMS-38086 Adams Car model FMU contains references to tire using database alias in
ADM file packaged a resourses
ADMS-37324 mnf files are included in the FMU when doing a plant export FMU
ADMS-38515 Changing value of FMU fixed parameter has no effect on results
ADMS-38549 Warning message about MSVS requirements while exporting FMU v2
needs to be generic
ADMS-38452 Adams issues diagnostic message listing wrong compiler versions during
FMI Export
ADMS-19054 Update Simulink block limitation documentation
ADMS-6446 Adams Controls cannot handle EASY5 timed switch events correctly
ADMS-37072 Leaving two single quotes ('') in Output files Prefix tab in Adams Plant in
Simulink causes "Error in Initialization''
ADMS-7377 Function evaluation produces incorrect results with model of coor. repar.

Known Issues

ADMS-39685 On Linux, the Controls Plant Export dialog will hang if Adams Car was
started from the command line like so: "<install_dir>/mdi -c acar ru-
standard i" instead of via the toolbar like so: "<install_dir>/mdi and then
select the Adams Car icon". The workaround is to enter a carriage return in
the startup terminal window to avoid the hang.
ADMS-39685 On Linux, the Controls Plant Export dialog, when target software is set to
either FMU option, will not close after clicking OK if DIRECT
communication mode was selected. Click Cancel or "x" to close the dialog
after clicking OK.
14 Adams 2017.1 Release Guide
Adams Co-simulation Interface

Adams Co-simulation Interface


Supported Versions of Software for Co-simulation
Known Issues

Supported Versions of Software for Co-simulation


An updated table of the Adams co-simulation Interface supported versions of Marc and EDEM is shown
below; there is no change here in Adams 2017.1 from Adams 2017.0:

Marc/EDEM version ACSI supported version


Marc 2013.0 ACSI 2014.0, 2014.0.1
Marc 2013.1 ACSI 2014.0, 2014.0.1
Marc 2014.0 No support for ACSI
Marc 2014.1 No support for ACSI
*
Marc 2014.2 ACSI 2015-2015.1, ACSI 2016*-2017.1*
Marc 2015* ACSI 2015-2015.1, ACSI 2016*-2017.1*
Marc 2016 ACSI 2015-2017.1
EDEM 2.7.1 (or later) ACSI 2016-2017.1

* The ACSI 2016 and ACSI 2017.X versions require a workaround for the case of Adams models co-
simulating with Marc versions 2014.2 and 2015. Marc 2016 does not require this workaround. For details
see the "Special requirements to run Marc" section of the Adams product documentation (online Help)
under "Adams Co-simulation Interface."

Known Issues

ADMS-34101 Cannot export .adm files from AView which were setup for ACSI without
ACSI_Adams.dll present in working directory
ADMS-33986 Adams-Marc co-simulation with two Marc process and with single thread
option set as "Yes" will issue the following error for the second Marc
process: "An Adams-Marc co-simulation analysis was aborted due to a
program interruption or a communication error"
CHAPTER 1 15
Whats New

Adams Driveline

Issues Resolved

ADMS-20100 F1 help is not openoing for Driveline Components Status dialogbox in


Adams Driveline Standard Interface
ADMS-12927 Gear ratio is not updated correctly.
ADMS-27038 F1 help is not opened for New Bench Test Assembly dialog box in Adams
Driveline
ADMS-35259 For Adams Driveline- allow LSD dbox to store information for different
options
ADMS-38869 Dropped Clutch Analysis throws an Error if submitted twice.
ADMS-37863 ADriveline_Advanced_Contact_Gear does not work in directory name
with blank
ADMS-13200 Defect with Modify Torque Converter dbox
ADMS-15107 Driveline incorrect variable assingment causes model no to run
ADMS-14213 Spurious error when running driveline benchtest analysis
ADMS-12758 Help is not opening for Modify Gear Pair Dialog box in Adams Driveline
ADMS-13030 Momentum name is not properly displayed in Modify unbalanced mass
dialog box
16 Adams 2017.1 Release Guide
Adams Durability

Adams Durability

Issues Resolved

ADMS-32550 Need better documentation of Hotspots Value Visibility


ADMS-36227 Adams Durability online help issues regarding Butterworth filter.
ADMS-35457 Documentation of RPC header
ADMS-35160 Update the Online help Adams Durability tutorial steps as per Default
Interface options
ADMS-39267 Difference in the hotspot table a nodal plot results.
ADMS-12624 no hot spot labels are shown while animating
CHAPTER 1 17
Whats New

Adams Explore
Issues Resolved
Known Issues

Issues Resolved

ADMS-39538 SPMM-auto-genrated .plt file incompatible with Adams Explore

Known Issues

ADMS-16820 Browsing for Adams Explore Excel files is not working in MS Edge
Browser on Windows10 if the original is still open in Excel when
submitting the job. Workaround is to close the file or simply use another
browser like IE or Firefox.
ADMS-20717 Launching the Adams Explore web server and job server from the Adams
View or Adams Car GUI on a Linux machine through remote access from
a Windows machine via some tools (e.g., Exceed and Putty), the Adams
View or Adams Car session will lock up while the web server and job server
are running. One must close those windows to regain control of the session.
A workaround is to not launch the Explore web server and job server from
an Adams GUI but, instead, launch it from the Adams command line (e.g.,
"adams2016 aexplore ru-jobserver" and "adams2016 aexplore ru-
webserver").
18 Adams 2017.1 Release Guide
Adams Flex

Adams Flex

Issues Resolved

ADMS-15189 Description about "preserve stress and strain modes" feature of Flex toolkit
ADMS-36959 FEA_MEM_SETTING and similar are missing in FLEX_BODY
statement docs
ADMS-28936 equation has a typo in the Flex theory document in the online help
ADMS-32394 Interface node created at different location than the specified in
Adams/Viewflex import mesh method
ADMS-19066 The Flexbody .MTX file not updated when Marker attached to the flexible
body is deleted.
ADMS-12631 Blue columns are not related to Refresh Table button on Modify Modal ICs
window.
CHAPTER 1 19
Whats New

Adams Insight

Known Issues

ADMS-18145 Exported HTML Report from Insight is not working with MS Edge
Browser on Windows10; may work in later versions of Edge; iini the
meantime use another browser like IE or Firefox
20 Adams 2017.1 Release Guide
Adams Machinery

Adams Machinery
Issues Resolved
Known Issues

Issues Resolved

ADMS-35207 Update Adams/Machinery GUI plot with the latest Adams version plot in
Adams Online help
ADMS-37398 Problem with belt tension calculation

ADMS-32039 V-axis values changes when post-processor is maximized or minimized

ADMS-39277 Crash detected when modify the parameter 'number of contact planes' in the
gear set
ADMS-38581 Adams 2017 cannot solve Planetary Gear Set externally.

ADMS-39238 "Intel Visual Fortran run-time error" appears when try to modify the
Planetary Advanced 3D Contact gear
ADMS-36054 Error occurs while executing "Machinery Cable Tutorial" from Adams
online help
ADMS-33994 "division by zero" error while importing a cable cmd model.
ADMS-37452 Cannot use simplified formulation gear sets on rotating parts
ADMS-35705 A/Machinery - Simplified Spur Gear model does not work properly if
driven gear is fixed
ADMS-32078 Gears not rotated properly when two racks are using the same pinion

ADMS-37411 Machinery Gear Bore Radius setting error


ADMS-32024 Accepted BORE RADIUS GEAR 1 value becomes not accepted if gear
pair is modified
ADMS-36917 Japanese localization issue for Advanced 3D Contact Gear wizard
ADMS-28061 Adams/Machinery planetary gear model does't run with Simplified contact
model under some conditions
CHAPTER 1 21
Whats New

Known Issues

ADMS-33805 Bearing disappears when selecting "reset to start" in animation control


dialog.
ADMS-32067 Bearing .wzd file stores name and issues erorr if try to reuse in same model.
Workaround is to manually edit the name after opening the .wzd file.

ADMS-32062 An error message appears if the user deletes the design variables created for
Detailed bearing geometry parameters
ADMS-32055 Duty cycle bearing life does not support analyses run via external
Adams/Solver launched from Adams/View or via standalone
Adams/Solver.

ADMS-31992 Some instances of bin file corruption observed which result in inability to
open them in Adams 2013.2 and later without error. Workaround is to
export .cmd files.

ADMS-31988 A broken translational joint on the tensioner in a belt systems is observed


when reading bin file created on 2013.1 in later versions. Use .cmd as
workaround

ADMS-22387 A cam system exported as parasolid then re-imported displays all


configurations of cams and followers including ones that are supposed to
be hidden.

ADMS-32143 When copying a cam system its follower motion will not be copied. Both
cam systems will reference the same follower motion object.

ADMS-31937 Contact parameter definition for Guide - Chain contact is missing

ADMS-31994 Span requests do not persist when modifying chain (open and closed) and
belt
ADMS-31900 Chain system guide tensioner's piston & housing mass properties are
uneditable.
22 Adams 2017.1 Release Guide
Adams Machinery

ADMS-31886 Duplication of gear set occurs when merging models including gear
systems
ADMS-22363 Unable to chage direction of motor in runtime with curve based method for
motor.
ADMS-31960 If users run the motor with the exact rated condition of voltage and fluency
and the external load (load on motor) is within the motor torque limit, then
the AC motor is showing abnormal behavior since current is remaining
constant but torque is changing as per load applied. Workaround is for the
user to specify slightly lower supply voltage and frequency than is rated.
CHAPTER 1 23
Whats New

Adams MaxFlex
Issues Resolved
Known Issues

Issues Resolved

ADMS-38523 No help available regarding MaxFlex error ID=1900 in Adams help


contents
ADMS-32711 Simulation fails when simulating same BDF from two different Adams
sessions simultaneously in same working directory
ADMS-32255 WARNING: No Mode Shape Data found in this Database file." message
needs to be documented.
ADMS-28714 In Flexible Body Modify (MaxFlex) dialog-box the help for the Modal ICs
option is provided which is not applicable
ADMS-37878 When swapping the flexbody to the bdf in ACar, the errors are occurred.
ADMS-26239 Flex-to Flex swap does not work properly if the DTI card is present in the
.bdf file already.

Known Issues

ADMS-30608 MaxFlex body does not appear initially in animation when opening a .bin
file; one must click play or load animation for it to appear.

ADMS-28164 When animating MaxFlex bodies with stress contours two progress meters
will be shown (one for calculating the stresses and the other for applying
the colors) when ideally only one should be shown

ADMS-26175 On Linux systems while browsing for a .bdf it defaults to the last browsed
.bdf directory as opposed to the current working directory

ADMS-24244 Object measures unsupported by nonlinear flexible bodies


24 Adams 2017.1 Release Guide
Adams MaxFlex

ADMS-25798 Outline graphics generated for nonlinear flexible bodies do not respond to
hide/show toggle
ADMS-20258 In MaxFlex bodies' BDF definitions all independent degrees of freedom of
RBE2 must have non-zero stiffness value or else the model may have
difficulty solving in Adams. For example, if dependent GRIDs of RBE2 are
only connected to solid elements, they won't have rotational stiffness, so the
independent degrees of freedom of the RBE2 should be specified in the
BDF as 123 instead of 123456. In addition, the number of dependent
GRIDs of RBE2 should be more than 2 in this case to avoid the singularity
of the independent degrees of freedom computation.
ADMS-28656 Extraneous messages in the Info window ("calling ESTIMATE
Program...") when simulating via external solver from A/View and the
model contains a nonlinear flexible body.
CHAPTER 1 25
Whats New

Adams Mechatronics
Direct Communication Mode for FMI Co-simulation
FMU Export for SIMulation Workbench
Heterogeneous FMU Export
Forward Compatible FMU
SMP Support for Co-simulation FMU
Issues Resolved

Direct Communication Mode for FMI Co-simulation

With this release of Adams a new "Direct" communication option for FMI-based co-simulation has been
implemented. This option is meant to improve the communication performance between the FMU
master and slave during co-simulation. It is accessed from the Adams Mechatronics Control System
Creation dialog and is available only for Adams co-simulation with a master process based in another
FMI-compliant tool. It does not support any Adams-as-the-master co-simulation scenarios. And, it is
restricted to use with Adams Solver C++ (it does not support Adams Solver FORTRAN).
Previously existing FMI co-simulation communication modes continue to be supported. The table below
compares these three options.

Communication
Mode Adams Master FMI Master Speed
TCP/IP X X lower
Pipes X X medium
Direct X high
26 Adams 2017.1 Release Guide
Adams Mechatronics

FMU Export for SIMulation Workbench


Adams Solver can now participate in co-simulations performed in Concurrent's SIMulation Workbench
(SimWB) real time environment. This is achieved via extensions to Adams' support for the Functional
Mockup Interface (FMI). A functional mockup (FMU) unit exported from Adams Mechatronics within
Adams View or Adams Car can now be imported into SimWB. See the new feature example, "A17-
1_003_RT_Solver_on_SIMultionWorkbench", included with this release for detailed usage steps.
The specific versions of this environment which MSC has certified are:
iHawk running RedHawk Linux 6.5 with SIMulation Workbench Control Center 7.5
RedHawk Linux 7.0 with SIMulation Workbench Control Center 7.4

See the "Real Time Analysis with SIMulation Workbench" entry under the Adams Real Time section of
this document for further details on these kinds of analyses.

Heterogeneous FMU Export


Adams Functional Mockup Units (FMU) exported from Adams Mechatronics on one supported Adams
platform can now be used for Functional Mockup Interface (FMI) co-simulations on other supported
Adams platforms.

Forward Compatible FMU


Adams Functional Mockup Units (FMU) exported from Adams Mechatronics in previous versions of
Adams can now be used with later versions of Adams by setting the environment variable
ADAMS_PATH_FOR_FMU=<Adams Installation Path> for the environment running the later version of
Adams. For example, if Adams is installed in C:\MSC.Software\Adams\2017_1, then <Adams
Installation Path> would be C:\MSC.Software\Adams\2017_1. Previously one would have to regenerate
the FMU on the newer version of Adams.

SMP Support for Co-simulation FMU


Adams Functional Mockup Units (FMU) exported from Adams Mechatronics for Functional Mockup
Interface (FMI) co-simulations now support Adams Solver SMP multi-threading. So, now in the solver
executable settings one can set "Thread Count" greater than 1 and this setting will employed for FMI co-
simulation.
CHAPTER 1 27
Whats New

Issues Resolved

ADMS-38909 Missing subsystem parameter in control system ude: fmu_output_rate


ADMS-38148 Adams Car session crash while generating adm/acf files using FMI Model
ADMS-37542 External System Library field shows previously imported FMU, when user
tries to create .esl file for second time
28 Adams 2017.1 Release Guide
Adams PostProcessor

Adams PostProcessor
Plot Panning Improvements
Issues Resolved
Known Issues

Plot Panning Improvements


The plot panning capability has been enhanced to provide better visual cues. The cursor now switches to
the "hand" icon in pan mode and it animates to "grabs" the plot when one clicks and drags to pan. Also,
a preview of the pan direction is displayed to indicate if Adams PostProcessor interprets the click-and-
drag motion as a horizontal or vertical one. Furthermore, the amount of panning done is proportional to
the length of the dragging motion.

Issues Resolved

ADMS-36912 Multiple plot config file reading creates undesired curve layout

ADMS-17285 Defects of the slide bar of A/PPT

ADMS-23813 Weired behaviour of animation slider in Adams/Postprocessor

ADMS-34708 Co-animation export limitations not documented

ADMS-22233 HTML report exports figure improperly

ADMS-34963 Symbol of the scatter plot does not update automatically in the legend of
the plot
CHAPTER 1 29
Whats New

ADMS-34541 Gain vertical Label missing on Linux.

ADMS-21575 location of notes in Adams/PPT

ADMS-12797 Improper editing abilities in standalone Adams Postprocessor

ADMS-34835 Plot disappears while switching between the table and plot if the active
layout is to another plot.

ADMS-36025 Axis tic marks show through plot legend object

ADMS-24163 When deleting a plot page, the names of the plot becomes the defaults
name.
ADMS-14238 h-axis and v-axis overlaps the curve when fit the entire extend button is
clicked
ADMS-18898 Plot panning is not logical

ADMS-17544 Plot panning doesn't give any feedback

ADMS-24471 Axis names do not appear properly in Adams/Postprocessor on Linux and


SUSE-11 platforms

ADMS-28176 Plotting FFT results in the error 'SPLINE requires that X values be in
strictly ascending order'.

ADMS-32023 some Part_XFORM results are not exported in Adasm/Machinery

ADMS-20605 Unexpected FFT data out-of-sequence error

ADMS-7248 Various text extent problems

ADMS-39149 Adams View session crash when click on Reload Simulations icon in APPT

ADMS-38095 Friction output result differs between "Request" and "Result set".

ADMS-7304 Flex Body recaches stress when I change Start frame in Animation tab
30 Adams 2017.1 Release Guide
Adams PostProcessor

ADMS-26742 Reading a plot config file containing a bode plot will make adams throw an
error
ADMS-21310 Curve editing on imported rsp plot is not working.

ADMS-25306 Poor Flexbody Vertex Matrix Performance when animation flex bodies in
Adam Car on Windows

Known Issues

ADMS-30608 MaxFlex body does not appear initially in animation when opening a .bin
file; one must click play or load animation for it to appear.

ADMS-28164 When animating MaxFlex bodies with stress contours two progress meters
will be shown (one for calculating the stresses and the other for applying
the colors) when ideally only one should be shown

ADMS-26175 On Linux systems while browsing for a .bdf it defaults to the last browsed
.bdf directory as opposed to the current working directory

ADMS-24244 Object measures unsupported by nonlinear flexible bodies


ADMS-25798 Outline graphics generated for nonlinear flexible bodies do not respond to
hide/show toggle
ADMS-20258 In MaxFlex bodies' BDF definitions all independent degrees of freedom of
RBE2 must have non-zero stiffness value or else the model may have
difficulty solving in Adams. For example, if dependent GRIDs of RBE2 are
only connected to solid elements, they won't have rotational stiffness, so the
independent degrees of freedom of the RBE2 should be specified in the
BDF as 123 instead of 123456. In addition, the number of dependent
GRIDs of RBE2 should be more than 2 in this case to avoid the singularity
of the independent degrees of freedom computation.

ADMS-28656 Extraneous messages in the Info window ("calling ESTIMATE


Program...") when simulating via external solver from A/View and the
model contains a nonlinear flexible body.
CHAPTER 1 31
Whats New

Adams Real Time


Introducing Adams Real Time
Fixed Step Integrator
Real Time Reporting Option
Real Time Analysis with SIMulation Workbench
Licensing
Known Issues

Introducing Adams Real Time

Real time simulation can be defined as the ability for the Adams model to complete at a rate equal to, or
faster than, the actual "wall clock" time at which the physical system would run. Real time simulation
enables hardware-in-the-loop (HiL) and some software-in-the-loop (SiL) workflows. Adams Real Time
is a set of capability to help Adams models run at real time both "online" (that is, on real time operating
systems) and "offline." Offline real time simulations might be done to satisfy SiL scenarios in which it
is desired that the Adams model run at real time so as provide the other software tools(s) in the loop with
realistic response (for example, a mechanical system responding in real time to an electronic controller).
Online real time simulations might include either HiL or SiL usage or both.
Three primary factors determine an Adams model's suitability for real time simulation: model
complexity, model excitation and hardware. As model complexity (for example, degrees-of-freedom,
contact, flexible bodies and so on) decreases the chance of achieving real time speed increases. As model
excitation frequency decreases and actuation functions get smoother the chance of achieving real time
speed increases. And, naturally, as the hardware environment upon which the model is more powerful
(especially CPU speed and sometimes the amount of available memory to some extent) the chance of
achieving real time speed increases.
Beyond the fast solving Adams model itself, two key capabilities are frequently required to achieve real
time workflows and have been introduced in this initial release of Adams Real Time: a fixed step
32 Adams 2017.1 Release Guide
Adams Real Time

integrator and the ability to run on real time environments. New features in Adams 2017.1 related to these
items are described below.

Fixed Step Integrator


The ability for the solver to ensure that a fixed amount of work is completed in a given time is frequently
a requirement for real-time simulation. As such, with the introduction of Adams Real Time in this release,
Adams Solver now supports a fixed step integration option. It can be used to run any Adams model on
any platform supported by this version of Adams. It does not user an error tolerance to set the integration
step size, set the number of iterations or as criterion to move on. The user prescribes the integration step
size and the number of iterations integration step. For this reason the fixed step integrator is intended only
for real time use cases including offline tuning of its parameters to ensure the proper accuracy-speed
balance prior to running real time SiL and/or HiL scenarios. The fixed step integrator also reports some
calculations of the simulations speed relative to real time.
To learn more about the fixed step integrator see the Adams Solver section of this document and
especially see the online help entry for the INTEGRATOR statement within the product documentation.
This includes a number of usage and modeling guidelines. Of particular note to some Adams Real Time
users is that Adams Car full-vehicle models operating very close to zero velocity can cause difficulty for
the fixed integrator and possibly incur real time overruns.
For a hands-on tutorial covering the fixed step integrator see the New Feature Example, "A17-
1_002_Fixed_Step_Integrator," included with the Adams 2017.1 release.

Real Time Reporting Option


When the new Fixed Step option for the GSTIFF and HHT integrators is selected via the
INTEGRATOR/FIXIT parameter (as described in the previous section) Adams Solver writes out a short
report to the message file (.msg) with measures of real time performance. The first output is the
Maximum Real Time Index (RTI). This is the largest ratio of elapsed time to simulation time measured
during each sampling interval (DTOUT). A value less than or equal to one indicates real time was
attained.
The second output is the achievable sampling time. This is an estimate of the sampling time achievable
for the model on the current hardware. It is equal to the sampling interval (DTOUT) times Maximum RTI.
CHAPTER 1 33
Whats New

The third output is the number of real time violations (RTI>1) across all sampling intervals. This is
provided for users whose real time systems allow some limited number of violations per simulation.
If not running in eprint mode (that is, DEBUG/EPRINT) then only the overall RTI is printed at the end
of the analysis. If suppressing the .msg file output completely, as may be the case on the real-time
environment to improve performance, then of course none of these new real time reporting statistics are
available.

Below is an example use case scenario illustrating how a user attempting to run an Adams model in real
time at given sampling time might proceed employing this new report information in conjunction with
the new fixed step integrator option:
1. Run simulation on target system using GSTIFF or HHT and default settings, in order to generate
a baseline solution.
2. Run simulation on target system using fixed step GSTIFF, having chosen reasonable values of
the INTEGRATOR parameters FIXIT and HRATIO.
3. Examine message file output for report on real time, paying particular attention to real time index
and minimum achievable sampling time output.
a. If report indicates simulation ran in real time, then check the fixed step solution against the
baseline.
i.If errors are acceptable, then finished.
ii.If not, then re-try with increased FIXIT, increased HRATIO, or a combination of the two.
b. If not real time, then either
i.Re-try with decreased FIXIT, decreased HRATIO, or a combination of the two.
ii.Further simplify the model.
4. Repeat step 3 until simulation meets all criteria.

Real Time Analysis with SIMulation Workbench


With this release Adams Solver now supports Concurrent's SIMulation Workbench (SimWB) real time
modeling environment on the RedHawk Linux operating system. This has two primary benefits.
First, standalone Adams Solver analyses can now be run on the RedHawk Linux operating system.
Second, and more importantly, Adams Solver can now participate in co-simulations performed in the
SimWB real time environment. This is achieved via extensions to Adams' support for the Functional
34 Adams 2017.1 Release Guide
Adams Real Time

Mockup Interface (FMI). A functional mockup (FMU) unit exported from Adams Controls or Adams
Mechatronics within Adams View or Adams Car can now be imported into SimWB.
In terms of specific version support, MSC has certified Adams Solver in the following two environments:
iHawk running RedHawk Linux 6.5 with SIMulation Workbench Control Center 7.5
RedHawk Linux 7.0 with SIMulation Workbench Control Center 7.4

For both of these environments it is the Adams RedHat Linux 6.7 installer which must be installed on the
RedHawk machine. Do not use the Adams RedHat Linux 7.1 installation with either environment.
As for hardware for Adams we recommend faster CPU (clock speed) over number of cores. For example,
we have found the clock speed to have more impact on Adams performance than having a system with
more than 8 cores.
Also, when participating in co-simulations performed in the SimWB real time environment, Adams Car
based FMU models support the Logitech G27 automobile input devices (steering wheel, gear selector,
and accelerator and brake pedals).
See the new feature example, "A17-1_003_RT_Solver_on_SIMultionWorkbench", included with this
release for detailed usage steps.

Note: There is a problem within SIMulation Workbench where its FMU Master is unable to run
an Adams FMU. A patch from Concurrent for SIMulation Workbench to address this issue,
"SImWB_updated_file.zip", is provided with this release of Adams. It updates a file in the
SimWB installation ("fmuMain.c" installed under /usr/local/ccursim/FMIL).
CHAPTER 1 35
Whats New

Licensing
In order to build Adams models and run them in real time scenarios one will need the following pre-
requisites licensed:
A user interface in which to build the Adams model typically, but not limited to, Adams View or
Adams Car (note: this is not required during runtime of the real time scenario)
Adams Solver to solve baseline results via the traditional variable step integrators and to enable
runtime of any real time scenario
Adams Controls to export the FMU of the Adams model for participation in real time co-
simulations and to solve it during runtime
Additionally, the following two license features are specific to real time workflows:
Adams_Solver_FixedStep: this enables use of the Adams Solver fixed step integration option
in any scenario offline or online
Adams_Solver_RealTime_OS: this enables Adams Solver to function in any of the supported
real time operating system environments

Known Issues

ADMS-39753 The Getting Started with Adams Real Time tutorial "Using the Fixed Step
Integrator" will exhibit different behavior on Linux platforms for steps 16
and 18. While consistency with these particular steps is difficult to achieve
accross platforms due to the fact that the analysis is purposely running at
high error, the edition of this tutroial published in the 2017.1 New Feature
Example "A17-1_002_Fixed_Step_Integrator" employs settings that are
more likely to produce consistent effects.
36 Adams 2017.1 Release Guide
Adams SmartDriver

Adams SmartDriver

Issues Resolved

ADMS-38993 PProblem with transformation of dcd path at mini-maneuver transition

ADMS-39234 The vehicle can't run the second lap when the first and last points are not
coincident in some road formats
CHAPTER 1 37
Whats New

Adams Solver
Fixed Step Integrator Option
Issues Resolved
Known Issues

Fixed Step Integrator Option


In this release a new fixed step option is introduced for the GSTIFF integrator supporting both the I3 and
SI2 formulations and for the HHT integrator. The purpose of the fixed step option is to ensure that a fixed
amount of work is completed in a given time to satisfy the requirements for a Linux real time operating
system (RTOS). This is achieved by limiting the number of Newton steps in the implicit solve (that is,
number of iterations per Adams Solver integration step) to ensure a fixed amount of work is performed.
This option can be employed regardless of the environment; that is, it can be used also in non-RTOS
scenario, for example, to help determine ahead of time if a given analysis can be suitable for real-time
simulation and if the results will be acceptable.
It should be noted that the fixed step integrator option does not support 'integrator restarts.' This is done
intentionally to avoid the extra amount of computation associated with integrator restarts and also to
guarantee the fixed amount of work per integration time step. Integrator restarts are generally caused by
i. Singular or ill-conditioned Jacobian, ii. Discontinuity in forces, iii. Sensors forcing the integrator
restart, or iv. Euler Singularity. Ideally the user should avoid all these conditions when the fixed step
integrator option is selected. Note that the Euler singularity case is supported in the fixed step integrator
option without forcing an integrator restart.

Employing the Fixed Step Option in the Adams Solver Language


Both the Adams Solver IINTEGRATOR statement (for .adm files) and INTEGRATOR command (for
.acf files) have been extended with new arguments:
FIXIT: fixed iterations, the limit on the number of iterations to be taken per integration step.
Must be either unspecified or an integer from 1-10. If specified, the fixed step option is
employed. If FIXIT is unspecified, then the fixed step option is not employed and Adams Solver
integration proceeds in the traditional manner.
HRATIO: the output sampling rate (aka "DTOUT") divided by the integrator time step size (aka
"H"). Must be a positive integer. If unspecified while FIXIT is specified, this defaults to 1.
HRATIO is only valid in the context of the fixed step option; so, it's ignored if FIXIT is
unspecified.
MAXERR: the amount of error above which the user would like Adams Solver to stop trying to
solve the problem if it can't do better than this after the number of iterations specified by FIXIT.
MAXERR is a positive real number. Similar to HRATIO, it's only relevant to the fixed step
option; so, it's ignored if FIXIT is unspecified. When FIXIT is specified and this value is
unspecified, then there is no amount of error which would cause Adams Solver to quit.
38 Adams 2017.1 Release Guide
Adams Solver

It should be noted that the integration step size remains 'constant' or 'fixed' throughout the simulation
when the fixed step option is selected. The combination of DTOUT and HRATIO settings specifies the
integration step size.

The dependencies of the other INTEGRATOR statement/command arguments when FIXIT is specified
are as follows:
MAXIT will be ignored
ERROR will be ignored
INTERPOLATE will be ignored and always treated as though it is set "OFF"
PATTERN can still be specified; note that default for GSTIFF remains T:F:F:F:T:F:F:F:T:F. This
is suitable for values of FIXIT less than or equal to 4. If larger values of FIXIT are necessary one
may want to consider setting PATTERN = T:F:F:F:F:F:F:F:F:F so as to avoid the time
consuming Jacobian re-evaluation during newton iterations for real-time performance
HINIT can still be specified, but if set >DTOUT/HRATIO then Adams Solver will reset it =
DTOUT/HRATIO
HMIN will be ignored
HMAX can still be specified but will be ignored if less than DTOUT/HRATIO
KMAX can still be specified but will have no effect since the fixed step GSTIFF always runs
with K=1 and HHT always runs with K=2. So, in effect we have a fixed step and fixed order
integrator
CORRECTOR will have no effect

An example of adm/acf language usage for employing the fixed step option:
INTEGRATOR/GSTIFF, I3, FIXIT=3, HRATIO=4, MAXERR=0.05

Employing the Fixed Step Option via Adams View and Adams Car
The Solver Settings dialog accessed through either Adams View or Adams Car has been extended to
include the three new options related to the fixed step option (part of the parameters exposed via the
"More" checkbox). There is now a "Fixed Iterations" option menu which defaults to "Off" (for traditional
Adams Solver integration) but can also be set 1-10. If set 1-10, then there are optional fields available to
set the other two fixed step related parameters, "HRatio" and "Max Error". See the descriptions of these
items above in "Employing the Fixed Step Option in the Adams Solver Language"
CHAPTER 1 39
Whats New

Issues Resolved

ADMS-38982 When only the Intel Fortran compiler is installed, the script should use the
gnu C compiler for linking when Intel C isn't installed.

ADMS-36228 Mixed use of FXFREQ FXMODE


ADMS-39552 Nastran export typo error in documetation of config file
ADMS-38047 Matrix class document not correct
ADMS-35031 Wrong documentation for the sweep function - the mathematical formula is
incorrect

ADMS-21450 misleading documentation reagrding BDF parameters in executive control


command help

ADMS-38173 Environment variable "MSC_ADAMS_SOLVER_NODAMP_DIFF" not


documented
ADMS-35249 Error in Solver CONTACT documentation for Friction Force Calculation
ADMS-39263 Different Defaults for massless parts in A/Linear and Adams2Nastran
Export
ADMS-20321 inadequate checking for GSE statement (SAMPLE_PERIOD argument)

ADMS-14731 gse_update subroutine is never called in static analysis

ADMS-27192 equilibrium is complete at the wrong position with C++ solver

ADMS-37912 Difference between Adams/View and Adams/Solver in Hmin settings

ADMS-28188 initial conditions tables lack information for point_mass and fe_part bodies

ADMS-37864 RPC channel names written differently depending on request type

ADMS-21903 Reading of large results files leads in crash

ADMS-37835 Angle measure (3 points) gives 3 differents results

ADMS-38605 Solver message on geometry issue Unclear

ADMS-38910 Threshold parameter not affecting CLEARANCE results


40 Adams 2017.1 Release Guide
Adams Solver

ADMS-39239 Wrong default in Nastran whitebox export for PARAM,POST

ADMS-32427 CNFSUB and CFFSUB does not provide geometry IDs in the
sAdamsContactFriction struct

ADMS-36052 Misleading documentation for CNFSUB


ADMS-35234 C++ solver fails the lin/statemat command with non meaningful error
message
ADMS-33139 Curve-curve contact looses contact during simulation, C++ solver only

ADMS-33116 More iterations to get static with SmartDriver GSE

Known Issues

ADMS-16306 Running numerous initial conditions analyses at different velocities in


sequence can lead to incorrect results in C++ Solver. Workaround is to use
the FORTRAN solver.
ADMS-5641 Different results observed in Adams/Solver C++ between versions Linux
2012 and 2008r1 for certain model content
ADMS-5440 Performance issues with BEAM elements used in C++ Solver observed in
Adams/Chassis models
ADMS-23885 The C++ solver has a looser error control when dealing with small models.
If your model is small (few DOF), use a tighter error control.
ADMS-14816 The linear fortran solver should issue a warning about using varval
expressions
CHAPTER 1 41
Whats New

Adams Tire
Local Tire Solver
High Performance Setting Management
Issues Resolved

Local Tire Solver


By default the differential states of the Adams Tire models are calculated by the General State Equation
(GSE) as part of the Standard Tire Interface (STI). PAC2002 now offers the option to calculate the state
internally instead of passing this calculation to Adams Solver via the GSE. In particular when the number
of states is large (like when using the advanced transient or belt dynamics options), this will reduce the
work load for the Adams Solver and will in many cases reduce the required CPU time of the solution and
thus increase simulation speed.
The use of this "local tire solver" is meant for simulations with rather small maximum time step: 0.005s.
The combination of the 3D Enveloping Contact with this new local tire solver is not supported yet.
The use of the 'tire solver' can switched on by setting the LOCAL_SOLVER key word in the [MODEL]
section of the tire property file:
$--------------------------------------------------------------model
MODEL]
LOCAL_SOLVER = 'YES' $tire model is using a local calculation for the
tire model states
42 Adams 2017.1 Release Guide
Adams Tire

High Performance Setting Management


With this release of Adams, Adams Tire introduces a facility by which one can define, for certain
PAC2002 tire property file parameters, different values to be used when a "high performance" mode is
desired. To elect to use the "High Performance" settings for a given tire, one can switch this on in the
Create Wheel dbox (template builder) and the Modify Wheel dbox (standard interface. This toggle's state
will be reflected in the wheel's subsystem file.

In the Adams Car wheel subsystem file (.sub), the keyword 'HIGH_PERFORMANCE' can be set for the
tire model. The default value for the keyword (when not present) is 'NO'. When
HIGH_PERFORMANCE is set to 'YES', the PAC2002 is set to a high performance mode which should
reduce the required CPU time of the simulation.
When HIGH_PERFORMANCE = 'YES' in the subsystem file (.sub), the keywords with extension _HP
in the tire property file (.tir) are taken instead of the base keywords, these are:
CHAPTER 1 43
Whats New

[MODEL]
LOCAL_SOLVER_HP = 'YES'

[CONTACT_COEFFICIENTS]
N_WIDTH_HP = 2
N_LENGTH_HP = 2
ROAD_SPACING_HP = 0.001 $ in (mm)
Thus, the LOCAL_SOLVER_HP setting replace the LOCAL_SOLVER setting and so on. When the _HP
settings are not defined by the user in the tire property file (.tir), the values mentioned above are used by
default.
Of course one must take care to ensure that the proper balance between performance and accuracy is
achieved when employing this new high performance mode. Currently this available only for the
PAC2002 tire model.

Issues Resolved

ADMS-38723 F1 help is not opened for PAC2002 TDFT... Convert to PAC2002 dbox
ADMS-33552 Tire radius is determined incorrectly during straight and skidpad static set-
up for some roads
ADMS-38928 Example aircraft tire file and directory missing from installation
ADMS-38769 Time values of TDFT plot is different from TDX
ADMS-38588 opencrg code showing compiler warnings
ADMS-39572 Adams tire 3D contact documentation error
ADMS-37881 TDFT support for MSCADS optimizer not useful
44 Adams 2017.1 Release Guide
Adams Vibration

Adams Vibration
Issues Resolved
Known Issues

Issues Resolved

ADMS-35727 Need to update Adams Vibration Modal Coordinates Plot in Adams online
help
ADMS-39255 Error has happended when simulating vibration analysis while displaying
modal energy
ADMS-36836 "Marker Mode" feature in Adams/Vibration not working.
ADMS-35282 Frequency Range fields option are not displayed after used Import Settings
From Existing Vibration Analysis option
ADMS-37514 Dialog to enter cross correlation has wrong title
ADMS-35294 modal info computation upper frequency range value integer

Known Issues

ADMS-22060 Vibration analysis won't launch after a dynamic analysis has been run first
and animated in Adams PostProcessor
ADMS-16221 OUTPUT variables referencing deactivated BUSHING forces cause
analysis failure. Workaround is to comment out or otherwise deactivate the
OUTPUT variables.
ADMS-17558 Import of vibration result incorrectly requires user to associate it with an
existing analysis and auto analysis naming is incorrect. Workaround is to
manually rename the analysis object.
CHAPTER 1 45
Whats New

Adams View
Last Release for Precision Shaded and Z Short Shaded Render Options
Issues Resolved
Known Issues

Last Release for Precision Shaded and Z Short Shaded


Render Options
This is the last release in which support is guaranteed for the geometry rending options within Adams
View known as "precision shaded" and "Z short shaded".

Issues Resolved

ADMS-33167 Adams 2015.1 Release guide still shows CATIAV5 .crg files can be
imported into Adams

ADMS-19839 Welcome to Adams Dialog box F1 Help missing


ADMS-38720 createMotionT and createMotionR are mentioned wrongly in the docs

ADMS-38046 typos [,optional_argiments] in Python interface help

ADMS-38868 Update "View Options" - 'Setting Up the Window Layout' Adams GUI
image in Adams Online Help Image

ADMS-35730 Update Create Chain dbox with latest Adams Version dbox in Adams
Online help
ADMS-39193 STR_REPLACE_ALL() missing from DOCS

ADMS-21648 Documentation missing for all File functions

ADMS-22843 Change in parasolid import distribution to parts and geometry in Adams

ADMS-26328 When you create a flexible tube with Centerline in ViewFlex, one can no
longer give the node numbers of attachments

ADMS-39156 ViewFlex attachment definition produces wrong results when using the
solid feature.
ADMS-26025 Experiencing regular crashes on Linux
ADMS-17135 Errors writing Coupler Results Set
46 Adams 2017.1 Release Guide
Adams View

ADMS-33940 Coordinate window (F4) hiding behind main GUI.

ADMS-38034 If Adams is initialized in batch mode (as is the case in SimDesigner),


aview.pth search mechanism is ignored.

ADMS-35779 Python "info" property, when called on an object from a previous session
can cause session termination

ADMS-26740 Online help doc is not available for the geometry translation option
"TranslateCoordinateSystem"

ADMS-14205 Update Adams Online Help for Solidworks and Inventor CAD model files
are not supported on Linux Platforms same as CatiaV5

ADMS-13187 Model Browser Documentation and Help is not Updated

ADMS-38529 Adams View session crash while opening cmd FTire model

ADMS-27220 Adams allows to create more than one outline (geometry) under ground
part.
ADMS-15635 Random crash found precceded by "NVIDIA OpenGL Driver" error dialog
box.
ADMS-38158 Need to change chinese translation string for "Current"

ADMS-39248 Filter results need full element names


ADMS-39138 Adams View session crash while selecting node number for flexible body
ADMS-37890 Adams session crash when forcefully stopped the simulation from
simulation control dialog-box
ADMS-37954 Batch file for ViewFlex contains mscdate.exe which is not in the
installation
ADMS-13481 Shell geometry should not be mesh with Solid Element Type.
ADMS-12805 Invalid Coupler warnings during Loads export

ADMS-23182 no message displayed indicating success of CAD import under some


conditions
ADMS-37515 Setting "FEMFAT" option leads to error when opening dialog box for
solver settings
ADMS-21323 Adams/View DOE multiple indentical .mtx file generation
ADMS-37564 .adm import path ignored if file exists in HOME location
CHAPTER 1 47
Whats New

ADMS-25655 All the geometries comes under one part with parasolid import.

ADMS-19714 MNF File Name could not changed in Position Container

ADMS-13347 Inserted row numbers are visible after deleting selected rows in ViewFlex
attachments.

ADMS-34008 Japanese localization issue for create spline warning

ADMS-37880 FEMDATA create dbox is missing "skip" as input

ADMS-32824 Adams terminates while Merging two model with FE part and DFL

ADMS-5865 flex body swap is unit sensitive


ADMS-23012 Right-click doesn't work for a cell of Create spline dialog
ADMS-28416 ViewFlex gives poor warnings if Unit is set to "tonne"

Known Issues

ADMS-38479 Random and unreliably reproducible session failure when running internal
solver from within Adams View with more then one thread (i.e., Thread
Count > 1) on Linux platforms. Due to the thusfar random nature of this
defect, it is suggested to simply try re-running the analysis as a possible
workaround or set Thread Count to 1 as a possible workaround
ADMS-23496 Error messages repeat 2-4 times when trying to apply an orthotropic or
anisotropic material in ViewFlex (which accepts only Isotropic materials)

ADMS-18024 Adams View does not allow model and analysis of same name
ADMS-28223 If .adm files imported into AView contain contacts employing revolution
type geometry, then simulations run from Adams View will not run and
issue an incorrect error message ("Geometries contain duplicates in
contact"). Workaround is to run the .adm in standalone Adams Solver.

ADMS-22432 Innocuous macro error issued when launching FELoad dialog a second
time subsequent defining one with user subroutine option
ADMS-22407 FE Parts in some conditions will assign same (duplicate) id=1 to
MATERIAL statement in .adm file

ADMS-22402 FE Part isn't translated properly in model merge operations using offsets.

ADMS-20196 Force Display ON/OFF option is not working for the FE Load
48 Adams 2017.1 Release Guide
Adams View

ADMS-23488 Coordinate window expresses coordinates and deltas in XY even when


working on grids oriented differently (e.g., in YZ plane)

ADMS-35275 Importing some JT models and then exporting them as IGES models causes
Adams View session instability
ADMS-23472 Dimensioning lines and self-intersecting splines are ignored when
importing IGES geometry

ADMS-22497 "Switching the Color option during CAD data import in the same session
of Adams causes problems.
The model imported after switching the option is blank or incomplete."

ADMS-22236 Defects of exporting/importing polylines and splines as IGES when


deviating from default setting and using CAD Interoperability environment
variable. Workaround is to use the default setting

ADMS-32057 Cam systems with 2 followers do not copy/paste properly if the ground
reference marker is also selected (e.g., by mistake when selecting via drag
box in graphics window). Workaround is to copy from the model browser

ADMS-16288 Some options on the View Management Orient command not working
correctly. Workaround is to rotate the View via the tools available in the
graphics window and toolbar.

ADMS-33645 Innocuous warning "Discarded range with reserved name" is found in the
log file when importing an Adams Explore workbook in Adams View

ADMS-32686 Refreshing Adams Explore web page takes you always back to main page

ADMS-32679 Hyperlinks between analysis name on Analyses tab and solver settings of
the Model tab are lost in the output workbook of Adams Explore
ADMS-37795 When exporting .adm files from Adams View, "Roundoff Values" has no
influence on the number of digits in the .adm files. Unchecking it should
cause AView to ignore the "Significant Digits" setting, but this is not the
case.
ADMS-23940 If you export an Adams model to CEI Ensight via the co-animation export
capability and that model contains a flexible body, and the flexible body
doesn't use the same length units as the model itself, the resulting bodies in
Ensight will not be scaled or located properly. A workaround is to scale the
flex body in Ensight.

ADMS-21941 Torsional springs missing when merge two models (each containing one)
via "Model assemble" command. Workaround is to use a rotational sforce
instead.
CHAPTER 1 49
Whats New

ADMS-23849 Error "An empty body was encountered when converting the parasolid to a
shell" when importing a parasolid geometry

ADMS-22004 Zero volume of cylinders with 1 or 2 segments, with angle extension less
than 360 degrees

ADMS-23976 On machines with multiple graphics hardware options, use of the "CPU
integrated" graphics hardware (for example, "Intel HD Graphics") may
cause problems with display of flexible bodies and FE parts in wireframe
mode. The workaround is to use the other graphics hardware option (for
example, the "NVIDIA Processor").

ADMS-19798 Plot Transfer Function dialog box option menu is located improperly and
too narrow.
ADMS-33723 Twice importing certain NX models with the color option off can cause the
Adams View session to terminate unexpectedly

ADMS-26617 Sixth decimal place errors in part density values when importing Creo
models of units other than kg and m.

ADMS-22088 Location Parameterization on Markers Created on Flexible Bodies Lost


after CMD Export-Import

ADMS-17094 Some items in parentheses not selected properly in Information Window

ADMS-21230 Usage of MBFolderName in UDEs does not work if one tries to add items
to a pre-defined named entry in the model browser. One must select a new,
unique folder name.

ADMS-12740 Error in Mass property calculated for copied part with the original part
being a parasolid for some (not all) externally imported parasolid files

ADMS-17344 If one uses the Database navigator to look at Associativity and then close it
and try to modify something using the Edit Modify menu, one can see the
Database navigator stuck in "Associativity" mode. The way to recover is to
go to the Database Navigator and switch to Browse mode and close it and
then go back to the Edit Modify menu.
50 Adams 2017.1 Release Guide
Adams View

ADMS-37876 Running Adams View on a SUSE Linux 11 SP3 virtual machine using
native graphics can cause exception 11 errors leading to Adams View
termination when picking geometry. Workaround is to switch the Adams
graphics driver to HOOPS.

ADMS-34828 Creation of a flexible body via ViewFlex does not inform the user when
creation fails due to exceeding the number of nodes allowed in Adams
Student Edition

ADMS-24977 Window header text is garbled on the Function Builder's Assist dialog

ADMS-16065 The dialog_box ".gui.var_mod" is opened via the command navigator by


selecting "variable""modify" When a variable is browsed (or in any other
way selected) and specified in the field (f_variable_name) the command
"int dia dis dia=$_parent" is executed which means that the start commands
of the dialog is executed. But in the start command there no command
which shows the correct container based on the type of the selected. The
workaround is to use the standard AView modify dialog for variables
accessed by right-mouse-modify from the variable name in the model
browser.

ADMS-19376 Excessive memory consumption after reading in .res file with multiple
analyses using the default results parser known as "EXPAT". Workaround
is to select the "DOM" parser via and environment variable:
MSC_RESULTS_DOM=1

ADMS-5419 Change search-order for plugin binaries


ADMS-35885 On Red Hat Linux systems when Adams View is busy with a large task
(e.g., importing a large file) if one minimizes and then maximizes the
Adams View window an "Adams is not responding" or "DOM Bookmarks"
is not responding message gets displayed.

ADMS-35425 3Dconnexion 3D mouse is not working with newer drivers. Workaround is


to use driver version 3.18.0.

ADMS-34194 On Windows 10 virtual machines when VMware tools are installed to make
a full screen virtual machine, then some of the Adams-View-based product
sessions might terminate unexpectedly (Adams View, Adams Car, Adams
Driveline). Uninstalling the Vmware tools alleviates the issue.

ADMS-24953 3D mouse is not working on SUSE11 SP2 machine

ADMS-24771 Text color is not displaying properly (faint) for list option on RHEL6.3
Linux64 OS
CHAPTER 1 51
Whats New

ADMS-24007 The font sizes in Adams View based products in version 2014 and later are
not very clear. Menus do not take the system settings "system font size".

ADMS-23899 Some labels in the dialog box builder are obscured under Attributes: Value
when Windows font size set to 125%
ADMS-23308 Definition container is missing CT field for single component torque.
Workaround is to create the torque and modify from there.

ADMS-19599 Hitting a menu button or any other action in the .main window does not
make the main window view the active one

ADMS-13363 Commands related to modifying internal views of the following form


(found, e.g., in the A/Durability sample model) will cause a grey
background in the main graphical window:
int view mod view=.gui.main.front loc=0.0,0.0 height=0.5 width=1
The work-around to this issue is to click on the view layout icon on the
status bar and select the relevant layout.

ADMS-16818 Some extraneous messages are printed out during ViewFlex solution

ADMS-16207 Adams session terminates while creating flexible bodies via ViewFlex and
the working directory does not have sufficient space for the generated files.

ADMS-14909 ViewFlex via extrusion with generic cross-section will only function for
cross-sections which can be safely meshed via and elliptical pattern.
ADMS-36730 On Windows the Python modules "pip", "easy_install" and "wheel" do not
function by default. Two workaround options are:
(A) Every time you want to use these first execute "adams2017 python -m
pip"
(B) Perform a one-time execution of:
adams2017 python -m pip install setuptools -U
adams2017 python -m pip install wheel --ignore-installed
adams2017 python -m pip install pip -U
Then, add $topdir/python/win64/Scripts to your PATH environment
variable
52 Adams 2017.1 Release Guide
Adams View
MD Nastran 2006 Installation and Operations GuideMD Nastran

2 Running Adams Products

Starting Adams Products, 54



Setting Preferences, 57

Setting Your Working Directory, 58
54 Adams 2017.1 Release Guide
Starting Adams Products

Starting Adams Products


This sections described how you can start your Adams products on LINUX and on Windows.

Starting Adams Products on LINUX


The Adams Toolbar is a starting point to using Adams products on LINUX. The toolbar is shown below.

Adams Toolbar tool - Right click to set up Toolbar, manage


memory models, access online help and Technical Support
resources and more

Product tools - Click to run product or right-click to


configure products and create user libraries.
Hold the cursor over a tool to see the name of the associated
product.

You can also use the Adams Toolbar to:


Customize, keep track of, and organize multiple libraries of standard Adams products
Create binaries
Manage custom memory models and product preferences

For more information on these or other Adams Toolbar operations, see the Running and Configuring
online help (from the Help menu in any product, select Adams Help, on the left pane, select
Configuring Adams).

To start a product on LINUX:


1. To display the Adams Toolbar, at the command prompt, enter the command adamsx where x is
the version number, for example adams2017_1.
2. Click on the tool representing the product you want to start.

Note: We recommend that you use the Adams Toolbar to start your Adams products, but
if you want to automate certain operations, use the text-based Program Menu. For
more information, see the Running and Configuring online help.
CHAPTER 2 55
Running Adams Products

Starting Adams Products on Windows


You start any Adams product from the Start menu. You can also use the Start menu to:
Change your license type
Generate problem reports
Set Adams preferences

For more information on these or other operations, see the Running and Configuring online help.

To start a product on Windows:


From the Start menu, point to Programs, point to Adams 2017.1, point to the name of the
product you want to start.

Tip: Select the corresponding desktop icon for the product, if you installed it on your
desktop.

To start a product from DOS shell in Windows:


Start Programs Adams 2017.1 Command Prompt.
An alternative is to add the /bin directory under the Adams installation directory to your user
PATH environment variable. You can do this via the Control Panel:
a. Type environment in the Control Panel search box.
b. Select the Edit environment variables for your account pick.
56 Adams 2017.1 Release Guide
Starting Adams Products

Check to see if you already have a PATH variable defined under User variables. If it exists
then edit it, add a semicolon ; to the end of the existing value, and then add the bin directory
under the Adams installation directory. Otherwise select New..., use PATH for the variable name
and add the bin directory under the Adams installation directory as the value. The default
location of this directory is:
Windows Adams: C:\MSC.Software\Adams\2017_1\bin

Once you are done click OK.

Note: Windows appends your User PATH to the System PATH environment variable, so there is
no need to copy the existing System PATH variable to your user PATH variable. This
behavior is unique to the User PATH variable. For all other environment variables, a User
variables definition overrides a System Variables definition.
CHAPTER 2 57
Running Adams Products

Setting Preferences
This section describes how you can set preferences, such as your working directory, graphics setting, and
memory model size.

Setting Preferences on LINUX


You use the Registry Editor from the Adams Toolbar to set a variety of preferences. For information on
the preferences you can set, see the Running and Configuring online help.

To display the Registry Editor:


From the Adams Toolbar, right-click any product tool, and then select Change <Product
Name> Settings.

Setting Preferences on Windows


You use the Settings menu to modify:
Graphics settings
HOOPS settings
Memory model size

To display the Settings dialog box:


From the Start menu, point to Programs, point to Adams 2017.1, and then select Settings &
License.
58 Adams 2017.1 Release Guide
Setting Your Working Directory

Setting Your Working Directory


During a session in a default or custom product, you can select the directory where you want to place
your model and output files.
For Adams View, you can set the working directory from the Welcome dialog box.

To set your working directory:


1. From the File menu, select Select Directory.
2. In the dialog box that appears, select the working directory.
MD Nastran 2006 Installation and Operations GuideMD Nastran

3 Getting Help

Tool Tips, 60

Online Help, 61

Tutorials and Examples, 65
60 Adams 2017.1 Release Guide
Tool Tips

Tool Tips
Tool tips display information about the item the cursor is currently over in an Adams product. The
following shows the tool tip that appears when you place the cursor over the link geometry tool.

To display tool tips:


Move the cursor over the item in the interface on which youd like information.
A brief description of the item appears.
CHAPTER 3 61
Getting Help

Online Help
To help you use the Adams products, MSC Software provides online help (HTML format). To view the
online help and tutorials, you can use your default Web browser. An example of online help is shown
below

Versions of Web Browsers


For the Adams Help system, all you need is a Windows, Macintosh, or LINUX computer running a fairly
new browser with JavaScript enabled. If JavaScript is not enabled, then the Help set will not display in
its entirety. You also need to have appropriate Acrobat reader to view PDF files from online help system.
Due to security restrictions in the latest version of Google Chrome, you cannot use Chrome to view the
Adams help. Mozilla Firefox and Microsoft Internet Explorer are recommended to view the Adams help.
62 Adams 2017.1 Release Guide
Online Help

Accessing the Online Help


You can view help for a dialog box, a product, or for all Adams products. The figure below shows the
help for all Adams products, called the integrated master site. You can use this site to view any products
help and search across all product help. You can also access release notes for all products, and view the
documents in Adobe Reader.

To get help on a dialog box:


1. Click in the dialog box for which you need help.
2. Press F1.
Adams launches a browser window that contains information about the dialog box.
CHAPTER 3 63
Getting Help

To get general help on your product:


From your products Help menu, select Product Name Help (where Product Name is the name
of your Adams product).
Adams launches a browser window that contains the starting point for your products online
help.

To get help on another Adams product:


Perform one of the following:
If youre in an Adams product, from its Help menu, select Adams Help.
If youre in the help for an Adams product, use the All Products Help button ( )to get
to main help system.
Your default browser starts and displays the master site for Adams online help.

To open the Adams online help from the Adams Toolbar:


Right-click the Adams Toolbar tool, and then select Online Help.
Your default browser starts and displays the master site for Adams online help.

To open the Adams online help from the Start Menu:


From the Start menu, point to Programs, point to Adams 2017.1, and then select Online Help.
Your default browser starts and displays the master site for Adams online help.

Navigating through the Help


You navigate through the Adams help system as you do through any help system, selecting topics in the
pane on the left. In addition, weve provided:

Navigation arrows at the top of the pane to let you scroll through topics one at a
time.

Automatic sync to show you where your current topic is in the table of contents (TOC).
This is very helpful if you, for example, search for a topic and want to know if there are more
topics on the subject. It shows you where the topic is in the TOC, allowing you to see whether or
not there are more topics with it.

Searching
You can search all the help files in HTML format for a particular product or all Adams products.

If you are in a product specific help


1. Open the online help for your product.
64 Adams 2017.1 Release Guide
Online Help

2. Press Search button at the top of the help window, enter the search text, and then
press the Go button .

The results appear in the pane on the left, replacing the table of contents.
3. Click the topic you want to view.

If you are in Adams help system


1. Press search button at the top of help window, which will give an option to search All Available
products or A single product.
2. Enter the search text and follow Steps 2 and 3 above

Printing
To print a file:

In the help system you can select the Print button . to print the topic that you are viewing

You can select the PDF button . to see the entire PDF file pertaining to the topic and print
the file like a regular PDF file. Notice that some of the images in PDF file may be cropped.

Index
The Index tab displays an alphabetical list of keywords associated with help topics. To view index entries,
you can select a letter group to display the entries for that group. When you click on an index entry, the
related topic will display in the topic frame. You can select Indexes in a product specific help or in the
main help system.
CHAPTER 3 65
Getting Help

Tutorials and Examples


Adams products have a set of tutorials or getting started guides that step you through examples of using
the products features, as well as introduce the basic concepts of the product. The getting started guides
are online. In addition, many of the products have examples of its features that are stored in Knowledge
Base Articles.
You will find links to all the tutorials and examples for a product under its Examples tab.

To access the tutorials and examples:


From the online help, from the left pane, select Getting Started and select the product that you
are interested in.
From the online help for a product, from the pane on the left, select Examples.
66 Adams 2017.1 Release Guide
Tutorials and Examples
MD Nastran 2006 Installation and Operations GuideMD Nastran

4 Supported Versions of
Integration Products


Support for Easy5 and MATLAB, 68
Supported Versions of Integration Products, 69
68 Adams 2017.1 Release Guide
Support for Easy5 and MATLAB

Support for Easy5 and MATLAB

Easy5
This release of Adams Controls is certified to run with Easy5 2015, 2013, 2010, 2010.1.2, 2010.1.3 and
2010.1.4. Easy5 version support is subject to change. For the latest information, see updates to the
Release Guide here:
http://simcompanion.mscsoftware.com/.

MATLAB
The supported versions of MATLAB is R2016a and 2016b.
For more information on MATLAB platforms and compatibility, see:
http://www.mathworks.com/support

Note: If you want to co-simulate with Easy5 or MATLAB and you are running Adams Controls
on one of the platforms that Easy5 or MATLAB does not support, you should consider
using TCP/IP communication. This allows Adams Controls to communicate with Easy5 or
MATLAB even though the codes are running on different platforms.
CHAPTER 4 69
Supported Versions of Integration Products

Supported Versions of Integration Products

Company Product Name Product Version Adams Product Platform

The Mathworks, MATLAB R2016a Version 9.0.0.341360 Red Hat Enterprise Linux
Inc. MATLAB R2016b Version 9.1.0.441655 6.3 x64
Simulink Version 8.6 Adams Controls SuSe 11 SP2 x64
MATLAB Coder Version 3.0 Windows 7 x64
Simulink Coder Version 8.9

MSC Software Easy5 2015, 2013, 2010, Adams Controls Red Hat Enterprise Linux
Corporation 2010.1.2, 2010.1.3 and 6.3 x64
2010.1.4 SuSe 11 SP2 x64
Windows 7 x64
MSC Software MD Nastran R1 and above Adams Car Ride LINUX and Windows
Corporation
Adams Vibration
MSC Software MSC.Nastran V69.X and above Adams Durability LINUX and Windows
Corporation
Adams Flex
MSC Software Marc 2005 and above Adams Durability LINUX and Windows
Corporation
2003 and above Adams Flex
MSC Software Fatigue 2001 and above Adams Durability LINUX and Windows
Corporation
nCode FE-Fatigue Version 5.2 and above Adams Durability LINUX and Windows
ANSYS, Inc. ANSYS V6.0 and above Adams Durability LINUX and Windows

V5.4 and above Adams Flex


70 Adams 2017.1 Release Guide
Supported Versions of Integration Products

Company Product Name Product Version Adams Product Platform


Hibbitt, ABAQUS/ADAMS Version 6.3 and above Adams Durability LINUX and Windows
Karlsson &
Sorensen, Inc. Version 6.1-1 and Adams Flex
(HKS) above
UGS PLM I-DEAS Mechanism I-DEAS NX 10 and Adams Durability LINUX and Windows
Solutions Design above

I-DEAS 8, 9, NX 10 Adams Flex


and above
CEI Inc. EnSight 10.1.1b (but later than Adams LINUX and Windows
8.2.1f may likely PostProcessor
function

You might also like