Adams 2020 Shared Dialog Box and Appendix
Adams 2020 Shared Dialog Box and Appendix
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: [Link]@[Link]
Email: [Link]@[Link]
Worldwide Web
[Link]
Support
[Link]
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 © 2020 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 [Link] (or successor
website designated by MSC from time to time). Portions of this software are owned by Siemens Product Lifecycle Management, Inc.
© Copyright 2020
The MSC Software logo, MSC, MSC Adams, MD Adams, and Adams are trademarks or registered trademarks of MSC Software
Corporation in the United States and/or other countries. Hexagon and the Hexagon logo are trademarks or registered trademarks of
Hexagon AB and/or its subsidiaries. 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:V2020:Z:Z:Z:DC-F1
Documentation Feedback
At MSC Software, we strive to produce the highest quality documentation and welcome your feedback.
If you have comments or suggestions about our documentation, write to us at: documentation-
feedback@[Link].
Please include the following information with your feedback:
Document name
Release/Version number
Chapter/Section name
Topic title (for Online Help)
Brief description of the content (for example, incomplete/incorrect information, grammatical
errors, information that requires clarification or more details and so on).
Your suggestions for correcting/improving documentation
You may also provide your feedback about MSC Software documentation by taking a short 5-minute
survey at: [Link]
Note: The above mentioned e-mail address is only for providing documentation specific
feedback. If you have any technical problems, issues, or queries, please contact Technical
Support.
Dialog Box - F1 Help 1
Actuator Set Activity
on - Actuator is active.
off - Actuator is not active.
Enter the path directly into the text box. For example, if the path for the prototype
database is located at /usr/people/gabriel/prototype_02.cdb, you enter:
/usr/people/gabriel/prototype_02.cdb
Add Subsystem
(Standard Interface) File → Manage Assemblies → Add Subsystem Shared Dialog Box
To select a subsystem that is open in the current session, select . The icon
changes to and the text box is replaced by a pull-down menu from which
you can select a subsystem.
Shift Subsystems Opens the Subsystem Shift dialog where you can enter a longitudinal and vertical shift
for each subsystem specified.
4 template_based_common
Add Testrig
Add Testrig
(Standard Interface) File → Manage Assemblies → Add Testrig Shared Dialog Box
Adds a testrig into the selected assembly. Learn more.
Animation Graphics
(Standard Interface) Tools → Animation Graphics Shared Dialog Box
Allow adding graphics to improve the animation of the simulated models. Animation parts can be fixed to
ground (environmental objects like trees, buildings, street signs, landscaping, and so on.) or moving objects
(other traffic participants like cars, pedestrians and so on.). Animation graphics will be added to the assembly
model and optionally to an existing analysis object as well.
Note: Saving the assembly in ASCII format will not retain the animation graphics. Please use a
session binary (for example, [Link]) or the binary assembly file to save animation graphics
with the assembled model.
If modifying an animation graphic, enter its group name by browsing the database. If
you enter the group's object name, please omit the prefix "apg_".
If not selected, a new part will be created and constrained to ground with point
motions in all directions.
Dialog Box - F1 Help 5
Assembly Display
Note: Animation graphics can only be added to the existing analyses, if the
velocity functions (see below) are constant values, that is, do not require a
solver simulation to compute.
Position Enter real numbers to define the location offsets relative to the global origin.
X and Y
Velocity f(time) Enter the runtime function expression that will define the longitudinal and lateral
X and Y animation graphic motion.
Those expressions should be functions of time, for example, a constant velocity along
-X for another traffic participant to be overtaken.
Select to use the Function or Expression Builder to define a function. For information
on the Function or Expression Builder, see Function Builder.
Assembly Display
(Standard Interface) View → Assembly Shared Dialog Box
Displays a full-vehicle or suspension assembly.
Assembly Info
(Standard Interface) File → Info → Assembly Shared Dialog Box
Displays detailed information about Assemblies open in the current session.
6 template_based_common
Attach Custom Dialog Boxes
Bumpstop
Tools → Curve Manager
Generates a bumpstop property file. Learn about Working with Bumpstops.
You can create a linear bumpstop by entering a slope (stiffness), or define a force-deflection characteristic
using a mathematical formula (see Modifying Curves). You can also enter data in a spreadsheet and view and edit
the corresponding curve in the plotting window by dragging Hotpoints.
The following table explains the default options that are common to both the plot and table Curve Manager
views. Learn about Curve Manager.
Bundle Database
Tools → Database Management → Bundle Database Shared Dialog Box
Creates a tar file of an existing Database.
Bundling a database entails grouping together in the tar file all the subdirectories and files which currently
exist below the selected database. Your template-based product writes the resulting tar file to the Default
Writable Database under the name database_name.tar. This functionality is useful when you want a snapshot
state of a database, or if you want to transfer the database files to an external file system.
8 template_based_common
Bushing
Bushing
Tools → Curve Manager
Generates a bushing property file. Learn about Working with Bushings.
You can create a linear bushing by entering a slope (stiffness/angular stiffness), or define a force-deflection
characteristic using a mathematical formula. You can also enter data in a spreadsheet and view and edit the
corresponding curve in the plotting window by dragging Hotpoints. See Modifying Curves.
A bushing property file lists:
Six curves (three translational and three rotational characteristics)
Six damping factors defined as constants in the three axial directions
The following table explains the default options that are common to both the plot and table Curve Manager
views. Learn about Curve Manager.
Dialog Box - F1 Help 9
By Entering Size
Note: The pull-down menus in the upper left corner of the Curve Manager allow you to select an
active plot (translational and rotational stiffnesses) and components (x-y-z axis).
By Entering Size
(Template Builder) Build → Geometry → Elllipsoid → New/Modify → Method: by entering size Shared Dialog Box
Calculate Mass
(Template Builder) Build → Parts → General Part → Calculate Mass
or
Calculates the mass and inertia of a general part. Learn about General Parts. When you use this dialog box to
set the mass properties of a general part, your template-based product uses all defined geometries that belong
to the general part to determine the correct mass and inertia properties.
Material - Calculate the mass and inertia properties from the current density
value for the selected material.
User-Entered - Calculate the mass and inertia properties from a user-entered
density.
If you set Density to Material, your template-based product displays the following option:
Material Type Select a material type from the list of materials currently defined. When you select a
material, your template-based product uses the density defined for that material to
calculate the general part's mass and inertia properties.
If you set Density to User-Entered, your template-based product displays the following option:
Density Value Enter a density that your template-based product will use to calculate the general
part's mass and inertia properties.
Note: The search order is off by default. See the note in Setting Up the Search List and Order.
If you specify a file name without a full path, your template-based product searches through the defined
databases until it finds a matching file name. The search order of these databases is set in your private
configuration file, but you can change it at any time during the session.
Therefore, if two databases contain a file with the same name but different data, changing the database order
may cause your template-based product to find a different file in each case. This is advantageous in many
cases, but may produce unintended results when you change the search order without realizing that your
template-based product may be accessing different files.
12 template_based_common
Close Assembly
Close Assembly
(Standard Interface) File → Close → Assembly Shared Dialog Box
Closes the current assembly.
Close Subsystem
(Standard Interface) File → Close → Subsystem Shared Dialog Box
Closes the selected subsystem without first saving it to the Database.
Close Template
(Template Builder) File → Close Shared Dialog Box
Closes the selected template without first saving it to a Database.
Dialog Box - F1 Help 13
Clutch Force
Clutch Force
(Template Builder) Driveline Components → Clutch Forces → New/Modify Comprehensive Help
Defines a clutch force.
Learn about:
Communicators Info
(Template Builder) Build → Communicator → Info Shared Dialog Box
Displays information about Communicators, to help you assess the status of communicators for one or more
templates.
Dialog Box - F1 Help 15
Connector Modification Table
Many - Your template-based product displays many entity class options for you
to select.
All - Your template-based product selects all entity classes.
array/bushing/ Select one or more options. Each option represents a distinct entity that has a
differential corresponding communicator variable for the type.
equation/force/...
Clear Information Select if your template-based product should clear the Information window of any
Window current information before displaying the communicator information.
joint – The joint will be active, and the bushing will be inactive.
bushing – The bushing will be active, and the joint will be inactive.
both – The bushing and joint will both be active.
none – The bushing and joint will both be inactive.
kinematic flag – If the subsystem is in kinematic mode, the joint will be
active, and the bushing inactive. If the subsystem is in compliant mode,
the bushing will be active, and the joint will be inactive.
Joint Type Select one of the following joint types:
fixed
revolute
spherical
translational
Comments Displays and allows editing of the connector comments in the Standard User
Interface Subsystem context.
Display: Single and Select to display some or all of the connectors that exist in the current model.
Your template-based product always displays the single connectors. In
addition, you can select to display left or right connectors, or both.
Learn about:
Notes: If the selected database is writable, the original (source) database, table directory or
individual file will be backed up at its original location, and replaced by the new entities.
If the selected database is not writable, the converted files will be written to the current
working directory, maintaining the source database structure and internal database alias
references.
The table like interface provides the user with an easy way of looking at a list of contacts at once and
activating/deactivating an entire selection.
Dialog Box - F1 Help 19
Convert Files in Database
object name
activity
matching name
object type
connect type
The sort can be done in ascending or descending order.
List of contacts Displays the contacts in the current assembly.
Attributes The read-only columns Active, Matching Name, Object Type and Connect Type
provide an overview of the current contact definitions.
Activate Selection Allows activating and de-activating individual or multiple contacts by selecting the
corresponding row(s) and hitting the appropriate button.
De-activate Selection
Use the <.> button to select multiple rows.
Learn about:
Copy File
Tools → File Management → Copy Shared Dialog Box
Copies a file on the file system.
Your template-based product provides a run-time interface for copying files on the file system. You can copy
files by specifying from and to directories. In addition, for many files you can take advantage of the CDB
(Car DataBase) structure to facilitate the copying. For example, you can copy a bushing property file from
one database to another. Rather than use the filesystem path (C:\Program
Files\Adams12.0\acar\shared_database.cdb\[Link]), you can use the database alias
C<shared\[Link]>, which you can access by right-clicking.
Example input:
You can also right-click and select one of your databases. In this case, you will need
to provide a new file name in the Filename text box, and then select OK.
Alternatively, you can type the path and file name.
To Database Name Select from the available list of databases, which may be some or all of the databases
found in the search list (only the writable databases are valid choices for this
operation).
When you use this option, Adams requires that the file name you specified is located
under a table directory within a database structure ([Link], [Link],
plot_configs.tbl, and so on). This is because the copy file algorithm will attempt to
copy the file to the corresponding table in the selected database. For example,
<shared>/[Link]/MDI_Demo_Vehicle_lt.asy would be copied to
<private>/[Link]/MDI_Demo_Vehicle_lt.asy, if you selected <private> as the
database name.
Note: The new file name will always have the same extension as the old file name. If you input a
different extension for the new file name, your template-based product will modify it to
correspond to the extension of the old file name.
Create Hardpoint
(Template Builder) Build → Hardpoint → New Shared Dialog Box
Creates a hardpoint. Learn about Hardpoints.
24 template_based_common
Create New Database
left/right - Define either the left or the right hardpoint, and your template-based
product creates the corresponding opposite hardpoint by default.
single - Define a nonsymmetric hardpoint.
Location Enter the three real values that define the location of the hardpoint, separated by
commas.
Select to display a dialog box where you can add multi-line comments to any entity,
to describe its purpose and function. Your template-based product displays different
comments dialog boxes, depending on the entity type for which you want to record
comments:
Enter the path directly into the text box. For example, if the path for the prototype
database is located at /usr/people/gabriel/prototype_02.cdb, you enter:
/usr/people/gabriel/prototype_02.cdb
(Adams Driveline Template Builder) Driveline Components → Gear Tool → Gear → 2D Spur Gear Force → New/Modify Shared
Dialog Box
Creates or modifies a 2D Spur Gear Force.
The order in which the gears are specified is relevant in terms of the parametric
orientation which is created based on the number of teeth and the relative position
of both gears. If you build a chain of gears, do not use each gear more than once
as Gear 2.
Gear 2 Enter the name of the second gear.
Learn about Contact Force.
You can include dynamic and static friction in the gear force. You define the friction by specifying static
and dynamic coefficient, and slip and transition velocity. Learn about Calculation of Friction Force.
Stiffness Enter the desired stiffness.
26 template_based_common
Create/Modify 2D Spur Gear Force
Note: The order in which you specify the gears is important because it maintains the parametric
orientation of the gears, therefore ensuring proper meshing. The gear force icon is positioned
at the center of the first gear, Gear 1.
Use the pitch diameter variable (pitch_diameter) of each gear to parameterize the location of
one gear to the location of the other gear, to ensure proper meshing. The gears pitch circles
should tangent.
Dialog Box - F1 Help 27
Create/Modify Adjustable Force
camber
toe
caster
Note: For creating caster type adjustable force first you need to set
suspension parameter array (Build > Suspension Parameters >
Characteristics Array > Set)
I Measure Part Enter the name of the part measured by the adjustable force. For example,
in a toe adjustment, you can set the I measure part to the wheel carrier part.
I Measure Const Frame Enter the construction frame the adjustable force uses to evaluate the
desired quantity (toe or camber or caster). For example, you could enter a
spin axis construction frame.
Measured relative to: Select one of the following:
yes
no
Select to display a dialog box where you can add multi-line comments to
any entity, to describe its purpose and function. Your template-based
product displays different comments dialog boxes, depending on the entity
type for which you want to record comments:
Note: You only require to specify this when you have two point property file
selected and application of second force on the different part. Possible use
case scenario could be 'two body configuration'.
Property File If creating an aerodynamic force, note that the text box by default contains the file
mdids://acar_concept/aero_forces.tbl/aerodynamic_forces_2loc.xml. You can use
this file or select another one from your databases.
If modifying an aerodynamic force, specify the property file that contains the coefficient
data for the aerodynamic force.
The property files for aerodynamic force are classified into four types as shown in
below table:
Property File Type Aerodynamic Force Coefficients Spline Type
Single Point 2D Single location Drag 2D
Side Force
Lift
Roll
Pitch
Yaw
30 template_based_common
Create/Modify Aerodynamic Force
With any of the above options, Location defines the initial Cartesian coordinates of
the origin of the part's Body Coordinate System (BCS) with respect to the Global
Coordinate System (GCS).
With any of the above options, Location defines the initial Cartesian coordinates of
the origin of the part's Body Coordinate System (BCS) with respect to the Global
Coordinate System (GCS).
Learn about:
left/right - Define either the left or the right anti-roll bar part, and your
template-based product creates the corresponding opposite anti-roll bar
part by default.
single - Define a single anti-roll bar part.
If you select Method tab, Adams Car displays the following options:
Method Select one of the following:
Simple -The left and right rigid part are connected via a revolute joint and
torsional spring. Supports only left/right symmetry type.
Beam - Use for high fidelity modelling. Anti-Roll bar will be constructed
using a series of rigid parts that are connected by beam forces.
FE Part - Use FE part(s) to create an anti-roll bar.
If you select Beam Method, Adams Car displays the following option:
Beam Formulation Select Linear, Nonlinear or String Beam Formulation type.
If you select continuous option for simple method then left and right rigid
bodies are connected via a revolute joint and torsional spring.
If you select continuous option for beam method then a center part of type
single will be created which will be connected to left and right parts by beam
forces.
Material - Calculate the mass and inertia properties from the current
density value for the selected material.
User-Entered - Calculate the mass and inertia properties from a user-
entered density.
This calculates the mass and inertia based on the dimensions of the arm.
If you set Density to Material, your template-based product displays the following option:
Material Type Select a material type from the list of materials currently defined. When you
select a material, your template-based product uses the density defined for that
material to calculate the general part's mass properties.
If you set Density to User-Entered, your template-based product displays the following option:
Density Value Enter a density that your template-based product will use to calculate the
general part's mass properties.
Select to display a dialog box where you can add multi-line comments to any
entity, to describe its purpose and function. Your template-based product
displays different comments dialog boxes, depending on the entity type for
which you want to record comments:
left/right - Define either the left or the right bspline geometry, and your
template-based product creates the corresponding opposite bspline
geometry by default.
single - Define a nonsymmetric bspline geometry.
Reference Coordinates Specify Coordinate Reference, to define the control points of the Bspline. You
must enter at least four coordinate references to define a valid bspline
geometry.
Close Select if the bspline geometry should close on itself, that is, connect the last
coordinate reference with the first coordinate reference entered.
Color Select a color for the Bspline geometry graphic.
Dialog Box - F1 Help 39
Create/Modify Bumpstop
Learn about:
Create/Modify Bumpstop
(Template Builder) Build → Forces → Bumpstop → New/Modify
Creates or modifies a bumpstop. Learn about Working with Bumpstops.
40 template_based_common
Create/Modify Bumpstop
If modifying a bumpstop, specify the property file that contains the force-
deflection relationship for the bumpstop.
Note: Because the bumpstop is not a part itself, and solely defines the
force-displacement relationship between two parts, changing the
bumpstop graphic diameter does not translate into different
bumpstop properties.
Select to display a dialog box where you can add multi-line comments to any
entity, to describe its purpose and function. Your template-based product
displays different comments dialog boxes, depending on the entity type for
which you want to record comments:
Learn about:
left/right - Define one of the bushings, and your template-based product creates
the corresponding opposite bushing.
single - Define a nonsymmetric bushing.
Inactive Select if the bushing will become inactive in the kinematic mode. Generally, a
bushing becomes inactive in kinematic mode if a joint is created which models the
kinematic motion of the bushing, and you want to use the joint in place of the
bushing in the Analysis of the system.
Geometry Length Enter the length of the bushing geometry graphic.
Geometry Radius Enter the radius of the bushing geometry graphic.
Property File If creating a bushing, note that the text box by default contains the file
mdids://acar_shared/[Link]/mdi_0001.bus. You can use this file or select
another one from your databases.
If modifying a bushing, specify the property file that contains the force data for the
bushing.
Dialog Box - F1 Help 43
Create/Modify Bushing Attachment
If you select Located At Flexible Body Node, the attachment will be reacted at the selected
node. It will be located at the selected node and offset by the vector you specify,
relative to the flexible body's Local Body Reference Frame. Note that you may only
select one node.
Learn about:
joint – The joint will be active, and the bushing will be inactive.
bushing – The bushing will be active, and the joint will be inactive.
both – The bushing and joint will both be active.
none – The bushing and joint will both be inactive.
kinematic flag – If the subsystem is in kinematic mode, the joint will be
active, and the bushing inactive. If the subsystem is in compliant mode,
the bushing will be active, and the joint will be inactive.
48 template_based_common
Create/Modify Construction Frames
fixed
revolute
spherical
translational
Design Option Select this option to create a new design option that will control the connector
Method. If the design option is evaluates to 0, the Method will be joint. If the
design option evaluates to 1, the Method will be bushing. The design option
will be given the same name as the connector.
Select to display a dialog box where you can add multi-line comments to any
entity, to describe its purpose and function. Your template-based product
displays different comments dialog boxes, depending on the entity type for
which you want to record comments:
left/right - Define either the left or the right contact, and your template-based
product creates the corresponding opposite contact by default.
single - Define a non-symmetric contact.
Select one of the following options:
I Contact Solid Enter the name of an existing geometry object valid for use in a contact.
I Flexible Body Enter the name of an existing flexible body.
Select one of the following options:
J Contact Solid Enter the name of an existing geometry object valid for use in a contact.
J Flexible Body Enter the name of an existing flexible body.
J Matching Name Enter the name of the object that will be matched either at assembly or runtime.
Road Graphics N/A. This selection will create a contact with the road object after the model has
been assembled.
If you selected J Matching Name & I Flex Body, the following options will be available:
J Object Type Select one of the following:
Contact Solid
Flexible Body
Force Display Select to create dynamic force graphics for animation. If this option is selected,
choose the color of the force graphics.
If creating a new contact definition, the following options will be available:
Contact Parameters Select one of the following:
Impact Force - To define the normal force based on an impact using the
IMPACT function.
Poisson Force - To define the normal force as restitution-based. This option is
not available with Flex Body to Solid and Flex Body to Flex Body type of
contacts.
User Defined - To define the force based on a User-written subroutine.
Learn about the types of Contact Force Algorithms and also see Learning More about the
Contact Detection Algorithm.
If you select Impact Force, the following four options will be available:
Stiffness Enter a material stiffness that is to be used to calculate the normal force for the
impact model. In general, the higher the stiffness, the more rigid or hard the bodies
in contact are.
Note: When changing the length units in Adams View, stiffnesses in contacts
are scaled by (length conversion factor**exponent). When changing the
force unit, stiffness is only scaled by the force conversion factor.
Force Exponent Adams Solver models normal force as a nonlinear springdamper. If the damping
penetration, below, is the instantaneous penetration between the contacting
geometry, Adams Solver calculates the contribution of the material stiffness to the
instantaneous normal forces as:
STIFFNESS * (PENALTY)**EXPONENT
For more information, see the IMPACT function in the Adams Solver online help.
Damping Enter a value to define the damping properties of the contacting material.
Consider a damping coefficient that is about one percent of the stiffness
coefficient.
Penetration Depth Enter a value to define the penetration at which Adams Solver turns on full damping.
Adams Solver uses a cubic STEP function to increase the damping coefficient from
zero, at zero penetration, to full damping when the penetration reaches the
damping penetration. A reasonable value for this parameter is 0.01 mm. For more
information, see the IMPACT function in the Adams Solver online help.
If you select Poisson Force, the following two options will be available:
Dialog Box - F1 Help 53
Create/Modify Contact Definition
A large penalty value ensures that the penetration of one geometry into another
will be small. Large values, however, will cause numerical integration difficulties.
A value of 1E6 is appropriate for systems modeled in Kg-mm-sec. For more
information on how to specify this value, see the Extended Definition for the CONTACT
statement in the Adams Solver online help.
Note: The penalty value of 1.0E+06 is recommended value for users who have
no prior experience with restitution based contacts. Experienced users
will find values that are both smaller and larger that are applicable to
their models.
Restitution Enter the coefficient of restitution, which models the energy loss during contact.
Coefficient
A value of zero specifies a perfectly plastic contact between the two
colliding bodies.
A value of one specifies a perfectly elastic contact. There is no energy loss.
The coefficient of restitution is a function of the two materials that are coming into
contact. For information on material types versus commonly used values of the
coefficient of restitution, see the table for the CONTACT statement in the Adams
Solver online help.
If you select User Defined, the following two options will be available:
User function Specify the user parameters to be passed to a User-written subroutine CNFSUB. For
more on user-written subroutines, see the Adams Solver online help.
Routine Specify an alternative library and name for the user subroutine. Learn about
ROUTINE Argument.
The following option is available for all choices:
Friction Force Select to model the friction effects at the contact locations using the Coulomb
friction model, no friction, or as user-defined subroutine. The Coulomb friction
model models dynamic friction but not true stiction.
For more on friction in contacts, see Contact Friction Force Calculation. In addition,
read the information for the CONTACT statement in the Adams Solver online help.
If you selected Coulomb for Friction Force, define the following options:
Coulomb Friction Specify whether the friction effects are to be included at run time:
On
Off
Dynamics Only
54 template_based_common
Create/Modify Contact Definition
Material - Calculate the mass and inertia properties from the current
density value for the selected material.
User-Entered - Calculate the mass and inertia properties from a user-
entered density.
If you set Density to Material, your template-based product displays the following option:
Material Type Select a material type from the list of materials currently defined. When you
select a material, your template-based product uses the density defined for that
material to calculate the general part's mass properties.
If you set Density to User-Entered, your template-based product displays the following option:
Density Value Enter a density that your template-based product will use to calculate the
general part's mass properties.
Select to display a dialog box where you can add multi-line comments to any
entity, to describe its purpose and function. Your template-based product
displays different comments dialog boxes, depending on the entity type for
which you want to record comments:
Create/Modify Damper
(Template Builder) Build → Forces → Damper → New/Modify Shared Dialog Box
Creates or modifies a damper. Learn about Working with Dampers.
If modifying a damper, specify the property file that contains the force-velocity
relationship for the damper.
Color Select a color for the damper graphic.
Damper Diameter Select the diameter of the damper graphic. Note that the slider actually defines
the ratio of the diameter to the length.
Note: Because the damper is not a part itself, and solely defines the force-
velocity relationship between two parts, changing the damper graphic
diameter does not translate into different damper properties.
Select to display a dialog box where you can add multi-line comments to any
entity, to describe its purpose and function. Your template-based product
displays different comments dialog boxes, depending on the entity type for
which you want to record comments:
Learn about:
Create/Modify Dyno
(Adams Driveline Template Builder) Build → Dyno → New/Modify Shared Dialog Box
Creates or modifies a Dyno.
Series - Specify the function of the dyno as a Fourier Sine series, by specifying the
mean value, order, magnitude, phase shift, and angle multiplier. You also specify
the direction of rotation. See Function Type: Series.
Constant - The input to the dyno is a constant value. The value will have the
units corresponding to the choice of actuator (angular_velocity when choosing
motion, and torque when choosing torque). See Function Type: Constant.
Curve - Specify the function of the dyno as a spline depending on time or angle
and angular velocity. You also specify the direction of rotation. See Function Type:
Curve.
User-Entered - Lets you create a user-specified function. Note that if you want to
specify a velocity function, functions for motions must always use radians. See
Function Type: User-Entered.
If you are working in Adams Driveline and have set the Dyno Type to Torque, the
following options are also available:
By Entering Size
Scaled Off Link
Color Select a color for the ellipsoid geometry graphic.
Calculate Mass Select to calculate the mass and inertia properties of the general part, based on
Properties of General the dimensions of the ellipsoid.
Part
If you select Calculate Mass Properties of General Part, your template-based product enables the following
option:
Density Select one of the following:
Material - Calculate the mass and inertia properties from the current density
value for the selected material.
User-Entered - Calculate the mass and inertia properties from a user-entered
density.
If you set Density to Material, your template-based product displays the following option:
Material Type Select a material type from the list of materials currently defined. When you
select a material, your template-based product uses the density defined for that
material to calculate the general part's mass properties.
Dialog Box - F1 Help 61
Create/Modify FE Part
Create/Modify FE Part
(Template Builder) Build → Parts → FE Part → New/Modify Shared Dialog Box
Creates or modifies an FE part. Learn about FE Parts.
Details about how the number and location of nodes can influence extruded geometry.
Angle (deg) A node's X-axis will be oriented in the direction of the curve's instantaneous
tangent at the node location. For "Angle," specify the rotation about the node's
X-axis defining the orientation of the normal and binormal (that is, the node's
Y and Z axes). If this value is zero Adams will, by default, orient the node
according to the following rules:
Solid geometry creation for the FE Part can also be defined via the Section
definition.
Note: The following section types do not yet support solid geometry
creation (only the centerline geometry will be visible and animate):
• Hollow rectangle
• Hollow circle
• Generic cross-sections where the section will end up as a hollow
geometry. Only closed polyline sections are allowed.
Uniform Section Apply the section defined in the first row to all rows.
Section Editor Opens the Create Section dialog box.
Evenly Distribute Reset all cells in the "Distance (S)" column so as to evenly space the nodes from
Start to End.
Sort by S Sort and rename all nodes so that they are sequentially ordered by their "Distance
(S)" values.
Note: This will overwrite the names of any manually named nodes.
Uniform Angle Set all Angle cells to match the value in the Start row.
Evenly Rotate Reset all cells in the "Angle" column so as to evenly rotate the nodes from Start
to End between the current values in the Start and End rows.
Faceting Tolerance Specify a real value to control the mesh density for visualizing the FE Part. The
default Faceting Tolerance is 300.0. Increasing this value will result in a finer
mesh of triangles, which gives a more accurate representation of curved surfaces.
Increasing the tolerance, however, also increases the memory requirements of the
geometry engine and adds to the computational overhead, which makes it run
slower. Maximum limit is 5000.0.
If you set Define By to New B-Spline, Existing B-Spline, or Existing Outline, the following options are displayed:
Curve Control Points The table will be populated with rows corresponding to each of the spline’s
control points’ positions. All existing nodes/rows will be replaced.
Parameterize Select this option to enforce a persistent link between the curve control point
locations and node locations.
The Contour Plots and Datum Node options are available while modifying the FE part.
Contour Plots Select this checkbox to enable color contour plotting during animation for the
FE Part. The Datum Node can be selected only if the Contour Plots checkbox
is selected.
64 template_based_common
Create/Modify Flexible Body
User-entered Location
Delta Location From Coordinate
Centered Between Coordinates
Located Along An Axis
Located On A Line
Location Input Communicator
See a Summary of Location Dependency Options.
Orientation Select one of the following:
Dependency
Delta Orientation From Coordinate
Parallel To Axis
Oriented In Plane
Orient To Zpoint-Xpoint
Orient Axis Along Line
Orient Axis To Point
User entered values
Orientation Input Communicator
Toe/Camber
See a Summary of Orientation Dependency Options.
If you set Type to left or right, your template-based product enables the following options:
66 template_based_common
Create/Modify Friction Element
Note: If you are creating friction on a joint active only in kinematic mode, be aware that when you
select compliant mode, the friction force will be disabled along with the joint.
Dialog Box - F1 Help 67
Create/Modify Gear
Create/Modify Gear
(Adams Driveline Template Builder) Driveline Components → Gear Tool → Spur/Helical Gear Element → New/Modify Shared
Dialog Box
Creates or modifies a Gear.
You can:
Use an existing property file by specifying the name of the property file that
contains the parameter values of the component.
Tips on Entering File Names in Text Boxes.
When you specify a property file, your template-based product automatically
updates the dialog box with the values from the property file.
Create a new property file by specifying a new name. When you specify a new
name, your template-based product displays the database path that it will use
to create the new file.
Your template-based product always creates a new property file in the default
writable database.
Editable Select if you want to modify any of the values supplied by the property file you
selected.
Attachment To Select one of the following:
Part - Specify a part and a construction frame. Learn about Construction Frames.
Your template-based product creates a marker on the attachment part at the
location and with the same orientation as the construction frame. (Learn
about Markers.) The marker is the J marker of the joint.
Marker - Specify a marker. The marker is the J marker of the joint.
If you set Attachment To to Part, your template-based product displays the following options:
Attachment Part Enter the name of the part to which the gear will be constrained.
Coordinate Reference Specify the location and orientation of the gear by entering the name of a
construction frame.
If you set Attachment To to Marker, your template-based product displays the following option:
Coordinate Reference Specify the location and orientation of the gear by entering the name of a marker.
68 template_based_common
Create/Modify Gear
where:
az - Angular displacement
wz - Angular velocity
Torsional Stiffness Enter the stiffness of the rotational spring-damper. The stiffness is in force units *
(optional) length units/angle units.
Torsional Damping Enter the damping coefficient of the rotational spring-damper. The damping is in
(optional) force units * length units * time units/angle units.
Fixed Gear Select one of the following:
Select to display a dialog box where you can add multi-line comments to any
entity, to describe its purpose and function. Your template-based product displays
different comments dialog boxes, depending on the entity type for which you
want to record comments:
Learn about:
Note: *Parameter values are stored in the property file. You can only update these values when
Editable is selected.
left/right - Define either the left or the right parameter, and your
template-based product creates the corresponding opposite parameter by
default.
single - Define a nonsymmetric parameter.
Property File Name You can:
Use an existing property file by specifying the name of the property file that
contains the parameter values of the component.
Tips on Entering File Names in Text Boxes.
When you specify a property file, your template-based product
automatically updates the dialog box with the values from the property
file.
Create a new property file by specifying a new name. When you specify a
new name, your template-based product displays the database path that it
will use to create the new file.
Your template-based product always creates a new property file in the
default writable database.
Datablock Name Enter the name of a data block from the property file. Data blocks are enclosed
in square brackets within the property file.
Dialog Box - F1 Help 71
Create/Modify General Part
Learn about:
User-entered Location
Delta Location From Coordinate
Centered Between Coordinates
Located Along An Axis
Located On A Line
Location Input Communicator
See a Summary of Location Dependency Options.
With any of the above options, Location defines the initial Cartesian coordinates
of the origin of the part’s Body Coordinate System (BCS) with repect to the Global
Coordinate System (GCS).
Orientation Select one of the following:
left/right - Define either the left or the right spline, and your template-based
product creates the corresponding opposite spline by default.
single - Define a nonsymmetric spline.
Property File Name You can:
Use an existing property file by specifying the name of the property file that
contains the parameter values of the component.
Tips on Entering File Names in Text Boxes.
When you specify a property file, your template-based product automatically
updates the dialog box with the values from the property file.
Create a new property file by specifying a new name. When you specify a new
name, your template-based product displays the database path that it will use
to create the new file.
Your template-based product always creates a new property file in the default
writable database.
Datablock Name Enter the name of a data block from the property file. Data blocks are enclosed in
square brackets within the property file.
Spline Type Select one of the following:
Learn about:
left/right - Define either the left or the right variable, and your template-
based product creates the corresponding opposite variable by default.
single - Define a nonsymmetric variable.
76 template_based_common
Create/Modify Input Communicator
Use an existing property file by specifying the name of the property file that
contains the parameter values of the component.
Tips on Entering File Names in Text Boxes.
When you specify a property file, your template-based product
automatically updates the dialog box with the values from the property file.
Create a new property file by specifying a new name. When you specify a
new name, your template-based product displays the database path that it
will use to create the new file.
Your template-based product always creates a new property file in the default
writable database.
Datablock Name Enter the name of a data block from the property file. Data blocks are enclosed
in square brackets within the property file.
Attribute Name Enter the name of an Attribute from the property file. This name is found within
the datablock specified above.
Select to display a dialog box where you can add multi-line comments to any
entity, to describe its purpose and function. Your template-based product
displays different comments dialog boxes, depending on the entity type for
which you want to record comments:
Learn about:
If modifying a communicator, note that this text box is disabled, because you
cannot change the entity class to which the communicator refers after the
communicator is defined.
From Minor Role Specify the communicator minor role for this input, which should match the
minor role of a corresponding output. The minor role any, matches to any
output, regardless of its minor role. If minor role = inherit, your template-
based product determines the minor role from the role of the subsystem
owning the input.
If you set Minor Role to parameter integer or parameter real, your template-based product enables the following
option:
78 template_based_common
Create/Modify Instrumentation
Create/Modify Instrumentation
(Template Builder) Build → Instrumentation → New/Modify Shared Dialog Box
Creates or modifies an instrumentation. Learn about Instrumentation.
left/right - Define either the left or the right instrumentation, and your
template-based product creates the corresponding opposite instrumentation
by default.
single - Define a non-symmetric instrumentation.
Sensor Type Select one of the following:
Acceleration
Height (w.r.t. tire ref )
Ride Height
StringPot
Velocity
Dialog Box - F1 Help 79
Create/Modify Instrumentation
If you select Located At Flexible Body Node, the attachment will be reacted at the
selected node. It will be located at the selected node and offset by the vector you
specify, relative to the flexible body's Local Body Reference Frame. Note that you
may only select one node.
If you select Located At Flexible Body Node, the attachment will be reacted at the
selected node. It will be located at the selected node and offset by the vector you
specify, relative to the flexible body's Local Body Reference Frame. Note that you
may only select one node.
Platform
Data cable
Inside Laser
Outside Laser
Anti Rotation Support
82 template_based_common
Create/Modify Interface Part
If hardpoint selected then the marker will create at that location with global
orientation 0.0, 180.0, 0.0. If construction frame selected then marker created
will orient as per the construnction frame's orientation.
Select to display a dialog box where you can add multi-line comments to any
entity, to describe its purpose and function. Your template-based product
displays different comments dialog boxes, depending on the entity type for
which you want to record comments:
left/right - Define either the left or the right joint, and your template-based
product creates the corresponding opposite joint by default (for example,
wheel bearing).
single - Define a nonsymmetric joint (for example, steering column universal
joint).
84 template_based_common
Create/Modify Joint Attachment
Note: The lower part of this dialog box changes based on the type of joint
you select. Types of Joints explains the options available for the different
types of joints.
Active Select if the joint will only be active in the kinematic mode. Generally, a joint
becomes inactive in dynamic mode if a bushing is created which models both
motion and stiffness/damping of the two parts, and the joint is used only in the
kinematic (motion) Analysis.
Location Dependency Select one of the following:
If you select Located At Flexible Body Node, the attachment will be reacted at the
selected node. It will be located at the selected node and offset by the vector you
specify, relative to the flexible body's Local Body Reference Frame. Note that you
may only select one node.
Translational
Revolute
Cylindrical
Universal
Spherical
Hooke
You can enter a joint from three options. See Options for Joint.
If you selected a joint of type single, you define only one function for the force that
will be created.
Select to use the Function or Expression Builder to define a function. For
information on the Function or Expression Builder, see Function Builder.
Force Limits Enter a numerical string that defines the force limits of the actuator(s).
(optional)
Displacement Enter a numerical string that defines the displacement limits of the actuator(s).
Limits (optional)
Velocity Limits Enter a numerical string that defines the velocity limits of the actuator(s).
(optional)
Acceleration Limits Enter a numerical string that defines the acceleration limits of the actuator(s).
(optional)
Dialog Box - F1 Help 87
Create/Modify Joint Motion Actuator
on - Actuator is active.
off - Actuator is not active.
You can also use the Actuator Set Activity dialog box to define the activity of any
actuator.
Select to display a dialog box where you can add multi-line comments to any entity,
to describe its purpose and function. Your template-based product displays
different comments dialog boxes, depending on the entity type for which you want
to record comments:
Note: The limits are not used in the current version of your template-based product. They are
optional and create string variables under the actuator user-defined element (ude) definition;
the same applies to the unit, application, and identifier strings.
You can enter a joint from three options. See Options for Joint.
The type of motion generators that your template-based product creates depends
on the type of joint you select:
on - Actuator is active.
off - Actuator is not active.
You can also use the Actuator Set Activity dialog box to define the activity of any
actuator.
Select to display a dialog box where you can add multi-line comments to any entity,
to describe its purpose and function. Your template-based product displays
different comments dialog boxes, depending on the entity type for which you want
to record comments:
Note: The limits are not used in the current version of your template-based product. They are
optional and create string variables under the actuator user-defined element (ude) definition;
the same applies to the unit, application, and identifier strings.
Select to modify the leaf spring property file in the Leaf Spring Editor.
Material - Calculate the mass and inertia properties from the current density
value for the selected material.
User-Entered - Calculate the mass and inertia properties from a user-entered
density.
If you set Density to Material, your template-based product displays the following option:
Material Type Select a material type from the list of materials currently defined. When you select a
material, your template-based product uses the density defined for that material to
calculate the general part's mass properties.
If you set Density to User-Entered, your template-based product displays the following option:
Density Value Enter a density that your template-based product will use to calculate the general
part's mass properties.
Select to display a dialog box where you can add multi-line comments to any entity,
to describe its purpose and function. Your template-based product displays different
comments dialog boxes, depending on the entity type for which you want to record
comments:
Create/Modify Loading
(Template Builder) Build → Loading → New/Modify Shared Dialog Box
Creates or modifies a loading object. Learn about Loading.
Dialog Box - F1 Help 93
Create/Modify Loading
Cargo - Defines the loading type as cargo, which has default location type as 'cg'.
Occupant - Defines the loading type as occupant.
If you set Loading Type to Occupant, your template-based product displays the following option:
Location Type Select one of the following:
Joint - Fixed joint is created between loading and mount (attachment) part
Bushing - Bushing is created between loading and mount (attachment) part
If template major role is loading, your template-based product displays the following option:
Matching Name Enter identifier for this input. Identifier must be identical to a matching name
identifier for the corresponding output communicator. If left blank, the matching
name defaults to the loading name.
If template major role is loading, your template-based product displays the following option:
Dialog Box - F1 Help 95
Create/Modify Loading
If modifying a bushing, specify the property file that contains the force data for the
bushing.
Location Select one of the following:
Dependency
Delta Location From Coordinate
Centered Between Coordinates
Located Along An Axis
Located On A Line
Location Input Communicator
See a Summary of Location Dependency Options.
96 template_based_common
Create/Modify Loading
Learn about:
Note: The loading object is created as a single entity and hence doesn't supports symmetric options.
Create/Modify Marker
(Template Builder) Build → Marker → New/Modify Shared Dialog Box
Creates or modifies markers. Learn about Markers.
The type of the coordinate reference also defines the type of the mount. If you
enter a left or right coordinate reference, your template-based product creates a
symmetric mount part pair (that is, both a left and a right mount part). If you
enter a single coordinate reference, your template-based product creates a
nonsymmetric (single) mount part.
From Minor Role Select a minor role for the mount part.
Select to display a dialog box where you can add multi-line comments to any
entity, to describe its purpose and function. Your template-based product
displays different comments dialog boxes, depending on the entity type for which
you want to record comments:
cylindrical
rectangular
Properties Select a mass property method:
Auto Calculate
User Entered
Type of Beam flexible
rigid
If you set Shape to cylindrical, your template-based product enables the following options:
Outer Radius Specify the outer radius of the nonlinear beam.
Inner Radius Specify the inner radius of the nonlinear beam.
If you set Shape to rectangular, your template-based product enables the following options:
Height Specify the height of the nonlinear beam.
Width Specify the width of the nonlinear beam.
If you set Properties to User Entered, your template-based product enables the following options:
Ixx Enter the area moment of inertia.
Iyy Enter the area moment of inertia.
Izz Enter the area moment of inertia.
Area Enter the cross-sectional area.
If you set Type of Beam to flexible, your template-based product enables the following option:
Damping Ratio Enter the damping ratio for the beam elements for the flexible nonlinear beam.
Material Type Select the nonlinear beam material. Your template-based product determines
the mass properties according to the current density for the material you
selected.
Beam Formulation Specifies the theory to be used to define the force this element will apply. By
default the LINEAR theory is used. If the NONLINEAR option is used, the
full non linear Euler-Bernoulli theory is used. If the STRING option is used, a
simplified non linear theory is used. The simplified non linear theory may speed
up your simulations with little performance penalties.
Dialog Box - F1 Help 101
Create/Modify Nonlinear Beam
cylindrical
rectangular
Properties Select a mass property method:
Auto Calculate
User Entered
If you set Shape to cylindrical, your template-based product enables the following options:
Outer Radius Specify the outer radius of the nonlinear beam.
Inner Radius Specify the inner radius of the nonlinear beam.
If you set Shape to rectangular, your template-based product enables the following options:
Height Specify the height of the nonlinear beam.
Width Specify the width of the nonlinear beam.
Damping Ratio Enter the damping ratio as a function of stiffness.
(Stiffness)
Damping Ratio (Mass) Enter the damping ratio as a function of mass.
Evenly Spaced Nodes Select to evenly space the nodes.
If you set Properties to User Entered, your template-based product enables the following options:
Iyy Enter the area moment of inertia.
Izz Enter the area moment of inertia.
Iyz Enter the area moment of inertia.
Jxx Enter the area moment of inertia.
Area Enter the cross-sectional area.
102 template_based_common
Create/Modify Outline Geometry
If modifying a communicator, note that this text box is disabled, because you
cannot change the entity class the communicator refers to after the
communicator is defined.
To Minor Role Specify the minor role for this output, which should match the minor role of a
corresponding input. The minor role any, matches to any input, regardless of its
minor role. If minor role is inherit, your template-based product determines the
minor role from the role of the subsystem owning the output.
Object name Enter the name of a database object, of the selected Entity class. Note that you
may use an expression in order to parameterize the output communicator.
Select to display a dialog box where you can add multi-line comments to any
entity, to describe its purpose and function. Your template-based product
displays different comments dialog boxes, depending on the entity type for
which you want to record comments:
Line of Sight
Moving with Body
Space Fixed
I Part/J Part Enter the name of the body that the force will act upon.
Application (optional) Enter a string for the application area.
Identifier (optional) Enter a string for the identifier.
Function Enter the function that defines the translational force.
Dialog Box - F1 Help 107
Create/Modify Point Force Actuator
Note: The limits are not used in the current version of your template-based product. They are
optional and create string variables under the actuator user-defined element (ude) definition;
the same applies to the unit, application, and identifier strings.
Dialog Box - F1 Help 109
Create/Modify Point Torque Actuator
on - No reaction is applied.
off - Reaction of the torque is applied on a marker that belongs to Part J.
Learn about Markers.
Application (optional) Enter a string for the application area.
Identifier (optional) Enter a string for the identifier.
Left/Right/ Function Enter the function that defines the rotational force(s) the actuator created.
If you selected an actuator of type single, you define only one function for the
torque that will be created.
Select to use the Function or Expression Builder to define a function. For
information on the Function or Expression Builder, see Function Builder.
Force Limits (optional) Enter a numerical string that defines the force limits of the actuator(s).
Displacement Limits Enter a numerical string that defines the displacement limits of the
(optional) actuator(s).
Velocity Limits (optional) Enter a numerical string that defines the velocity limits of the actuator(s).
Acceleration Limits Enter a numerical string that defines the acceleration limits of the actuator(s).
(optional)
Units (optional) Enter a literal string to identify the units used in the actuator definition. This
string is currently not used.
110 template_based_common
Create/Modify Point Torque Actuator
on - Actuator is active.
off - Actuator is not active.
You can also use the Actuator Set Activity dialog box to define the activity of any
actuator.
Location Dependency Select one of the following:
Note: The limits are not used in the current version of your template-based product. They are
optional and create string variables under the actuator user-defined element (ude) definition;
the same applies to the unit, application, and identifier strings.
Create/Modify Reboundstop
(Template Builder) Build → Forces → Reboundstop → New/Modify Shared Dialog Box
Creates or modifies a reboundstop. Learn about reboundstops.
112 template_based_common
Create/Modify Reboundstop
If modifying a reboundstop, specify the property file that contains the force-
deflection relationship for the reboundstop.
Clearance/Impact Length Select a method to specify when the reboundstop force activates:
Note: Because the reboundstop is not a part itself, and soley defines the
force-displacement relationship between two parts, changing the
reboundstop graphic diameter does not translate into different
reboundstop properties.
Dialog Box - F1 Help 113
Create/Modify Request
Learn about:
Create/Modify Request
(Template Builder) Build → Request → New/Modify Shared Dialog Box
Creates or modifies a request statement and auxiliary variables.
Define Using Type and Markers - Specify the output type and the markers used
for the computation of the output. Learn about Markers.
Define Using Subroutine - Define the request statement as a user-defined
request.
Define Using Function Expression - Explicitly specify the function used in the
definition of the request. Learn about Modifying requests to remove component
function.
If you select Define Using Type and Markers, your template-based product displays the following options:
Output Type Select the type of output that will be calculated by Adams Solver. The output type is
referred to the I and J markers.
I/J Marker Name Select a marker.
R Marker Name Identifies the marker with respect to which you want to resolve information.
Note: Angular displacements are not affected by the reference marker, because
finite angular rotations are not vector quantities.
If you select Define Using Subroutine, your template-based product displays the following options:
User Function Enter a string that defines the user-function parameter list.
Title Enter a title for your user-defined request.
If you select Define Using Function Expression, your template-based product displays the following options:
F1,8 Define the function of the corresponding component written to the request file.
Select to use the Function or Expression Builder to define a function. For
information on the Function or Expression Builder, see Function Builder.
Title Enter a title for your user-defined request.
Result Set Name Enter a name for the result set.
Your template-based product uses this, together with the component names,
described next, in the generation of the .nam File.
MAG/X/Y/Z/AMA Enter the strings that correspond to the output requests and identify the
G/R1/R2/R3 components. Your template-based product uses these strings when it generates the
.nam file. The strings appear in the plotting environment, in the Component text
box.
Units Select a unit for each component so the plots created in the postprocessing
environment will have the proper units on the axes.
Dialog Box - F1 Help 115
Create/Modify Ride Height Sensor
Contact Solid
Flexible Body
Threshold Optional field to allow the user to specify a maximum distance for which the
clearance calculations will not be computed. Set to 0.0 by default.
Select to display a dialog box where you can add multi-line comments to any entity,
to describe its purpose and function. Your template-based product displays different
comments dialog boxes, depending on the entity type for which you want to record
comments:
Create/Modify Spring
(Template Builder) Build → Forces → Spring → New/Modify Shared Dialog Box
Creates or modifies a spring. Learn about springs.
Note: Since the spring is not a part itself, and solely defines the force-
displacement relationship between two parts, changing the spring
graphic diameter does not translate into different spring properties.
118 template_based_common
Create/Modify Switch Part
Note: Since the spring is not a part itself, and solely defines the force-
displacement relationship between two parts, changing the spring
graphic diameter does not translate into different spring properties.
Select to display a dialog box where you can add multi-line comments to any entity,
to describe its purpose and function. Your template-based product displays different
comments dialog boxes, depending on the entity type for which you want to record
comments:
Learn about:
The order in which the gears are specified is relevant in terms of the parametric
orientation which is created based on the number of teeth and the relative position of
both gears. If you build a chain of gears, do not use each gear more than once as Gear
2.
Gear 2 Enter the name of the second gear.
Learn about Contact Force Formulation Based on Oilfilm Thickness Theory.
Stiffness Enter the desired stiffness.
Damping Specify the damping coefficient of the contact-force formulation.
Oilfilm Thickness Specify the oilfilm thickness of the contact-force formulation.
Select to display a dialog box where you can add multi-line comments to any entity,
to describe its purpose and function. Your template-based product displays different
comments dialog boxes, depending on the entity type for which you want to record
comments:
Notes: The order in which you specify the gears is important because it maintains the parametric
orientation of the gears, therefore ensuring proper meshing. The gear force icon is
positioned at the center of the first gear, Gear 1.
Use the pitch diameter variable (pitch_diameter) of each gear to parameterize the location
of one gear to the location of the other gear, to ensure proper meshing. The gears pitch
circles should tangent.
Dialog Box - F1 Help 121
Create/Modify Torsion Beam Spring
Learn about:
left/right - Define one of the torsional joints, and your template based product
creates the corresponding opposite torsional joint.
single - Define a non-symmetric torsional joint.
Dialog Box - F1 Help 123
Create/Modify Torsional Joint Attachment
If you select Located At Flexible Body Node, the attachment will be reacted at the selected
node. It will be located at the selected node and offset by the vector you specify,
relative to the flexible body's Local Body Reference Frame. Note that you may only
select one node.
Learn about:
If you selected a feedback channel of type single, you define only one function.
Select to use the Function or Expression Builder to define a function. For
information on the Function or Expression Builder, see Function Builder.
Offset You can offset the raw signal of the feedback channel with a real value.
Offset Compensate Select on or off to indicate if you want to offset the raw signal of the feedback
channel by a desired real value.
Units String Enter a literal string to identify the units used in the feedback channel definition.
This string is currently not used.
Select to display a dialog box where you can add multi-line comments to any
entity, to describe its purpose and function. Your template-based product displays
different comments dialog boxes, depending on the entity type for which you want
to record comments:
If you selected a variable actuator of type single, you define only one function for
the data element variable that will be created.
Select to use the Function or Expression Builder to define a function. For
information on the Function or Expression Builder, see Function Builder.
Limits (optional) Enter a numerical string that defines the limits of the actuator(s).
Units (optional) Enter a literal string to identify the units used in the actuator definition. This
string is currently not used.
Select to display a dialog box where you can add multi-line comments to any
entity, to describe its purpose and function. Your template-based product
displays different comments dialog boxes, depending on the entity type for
which you want to record comments:
Note: The limits are not used in the current version of your template-based product. They are
optional and create string variables under the actuator user-defined element (ude) definition;
the same applies to the unit, application, and identifier strings.
Swept Sine
Rotating Mass
PSD
User
Select to display a dialog box where you can add multi-line comments to any
entity, to describe its purpose and function. Your template-based product
displays different comments dialog boxes, depending on the entity type for
which you want to record comments:
Create/Modify Wheel
(Template Builder) Build → Wheel → New/Modify Shared Dialog Box
Creates or modifies a wheel. Learn about Wheels.
left/right - Define one of the wheels, and your template-based product creates
the corresponding opposite wheel.
single - Define a nonsymmetric wheel.
Cm Offset Enter the center of mass (cm) offset of the wheel part from the wheel location
defined in Location Dependency. The center of mass will be located along the z-
axis of the wheel; the z-axis orientation is defined in the Orientation.
Mass Enter the mass of the wheel part.
Ixx Iyy Enter values that define the Ixx and Iyy mass-inertia components of the wheel part.
Izz Enter a value that defines the Izz mass-inertia component of the wheel part.
132 template_based_common
Create/Modify Wheel
If modifying a wheel, specify a property file that contains the data for the tire.
High Performance When selecting a PAC2002 tire property file, the High Performance mode allows
the model to run at a high speed with a slight reduced accuracy, see High Performance
switch in Adams Car.
Wheel Select one of the following:
Configuration
Single / Dual Outside - Defines the wheel or (left/right wheel pair) to be
the only, or outside wheel of a dual wheel configuration.
Dual Inside - Defines the wheel or (left/right wheel pair) to be the inside
wheel of a dual wheel configuration.
Outside Wheel For "Wheel Configuration" = "Dual Inside", select the matching outside wheel.
Dialog Box - F1 Help 133
Create Motor
Create Motor
(Template builder) Build → Motor → New/Modify
Creates or modifies a motor
134 template_based_common
Create Motor
Analytical
Curve based
External
Note: Inputs in the parameters tab vary for each method.
Motor type Select one of the following
AC Synchronous
DC
Brushless DC
Stepper
Note: Motor type option is available only for analytical method.
Direction Select one of the following
Please see the Torque Angle() Calculation and Pole Slipping for Torque angle calculation and pole slipping details.
Note: In actual implementation Er is calculated as magnitude (Er = SQRT (Re(Er) ^2 + Im(Er) ^2)) and not as
complex number.
Where:
138 template_based_common
Create Motor
T = KφI a
ZP Es – Eb ZφNP
K = ---------- I a = ----------------- E b = ---------------
2πa Ra 60a
Where
T = Torque developed in N-m
K = Torque constant
φ = Flux per pole in Webers
Ia = Armature current in Amps
Z = Number of conductors
P = Number of Poles
a = Number of parallel paths in the Armature.
Es = Source Voltage in Volts
Eb = Back emf induced in Volts
Ra= Armature resistance in ohms
N = Revolutions per Minute
140 template_based_common
Create Motor
2
T = K 1 KI
ZP Es – Eb ZφNP
K = ---------- I a = ----------------- E b = ---------------
2πa Ra 60a
Where
T = Torque developed in N-m
K = Torque constant
K1 = Series motor constant
T = k d k p k s mnBLRI
Eb – Es ZφNP
I a = ----------------- E b = ---------------
Ra 60a
Where
kd = Distribution Factor
kp = Coil pitch Factor
ks = Slot Skew Factor
m = Number of Teeth per phase
n = Number of Turns per phase
B = Strength of the permanent Magnetic field
L = Length of rotor windings
R = Radius of Armature
I = Current in the Motor winding
T = Torque developed in N-m
φ = Flux per pole in Webers
Z = Number of conductors
P = Number of Poles
a = Number of parallel paths in the Armature
Es = Source Voltage in Volts
Eb = Back emf induced in Volts
Ra = Armature resistance in ohms
N = Revolutions per Minute
Distribution Factor Enter the distribution factor. The distribution factor kd reflects the fact that the
winding coils of each phase are distributed in a number of slots.
Coil Pitch Factor Enter the coil pitch factor. The pitch factor kp reflects the fact that windings
are often not fully pitched, that is, the individual turns are reduced in order to
decrease the length of the end-turns and do not cover a full pole-pitch (also
called chorded).
Slot Skew Factor Enter the skew factor. The skew factor ks reflects the fact that the winding is
angularly twisted, which results in an angular spread and reduced emf.
Teeth per Phase Count Enter the number of teeth per phase present in the motor.
Dialog Box - F1 Help 143
Create Motor
π
T 1 = HSin --- ⁄ S θ
2
π
T 2 = HCos --- ⁄ S θ
2
Where
T1 = Torque on the first winding.
T2 = Torque on the Secondary winding.
H = Holding Torque in N-m.
S = Step Angle in radians.
θ = Shaft Angle in radians.
Holding Torque Enter holding torque. The amount of torque required to keep the motor shaft
in a particular position.
Control Type One Phase On-Full Step Drive
Two Phase On-Full Step Drive
Step Angle (Degrees) Enter the step angle by which the rotor will rotate when a signal is passed.
Friction Torque Enter a constant opposing torque that does not vary with velocity.
Damping Coefficient Enter a constant damping coefficient which is multiplied by angular velocity
to define a damping torque. It represents the combined electromagnetic and
viscous damping.
Input Type To indicate the type of data in the input file.
PPS vs Time - Pulse per second vs time. The Stepper motor rotates by its
step angle when a pulse is received.
Target Angle vs Time - Target angle is the end position of rotor shaft where
the user desires the motor to stop.
Input File Provide a file which contains a curve of speed vs time or angle vs time based on
input type.
External Method
External Method External System Library Import
Co-Simulation
If External System Library Import is selected, the following options will be displayed:
Dialog Box - F1 Help 145
Create Motor
Easy5
MATLAB
FMU
If User Defined is selected, the following options will be displayed:
General State Equation Name Enter the name of the GSE to be created.
External System Library Enter the name of the external system library. If the extension entered is .fmu,
Adams will expect an FMU that conforms to the FMI standard.
Import I/O Signals from Existing Select to display the Database Navigator, where you can select an existing
Controls Plant controls plant from which output and input signals are to be imported.
Input Signal(s) Enter names of state variables that you want to use as plant inputs. Select From
Pinput to use state variables from existing plant inputs.
Output Signal(s) Enter names of state variables that you want to use as plant outputs. Select
From Poutput to use state variables from existing plant outputs.
Static Hold Select one of the following:
Easy5
MATLAB
FMU
Use External Library Error Tolerance Check to apply the error tolerance values of the continuous states of ESL to the
GSE during integration. The ESL error tolerance values change the
computation of the local integration error that is computed after the corrector
as converged. If the estimated error is greater than the specified integration
ERROR the integrator rejects the solution. See the INTEGRATOR statement
for more details about ERROR. You may want to use this feature to help refine
the accuracy of your ESL states, but just like any INTEGRATOR setting, this
may require tuning. This feature only applies to the C++ Solver, and only
Easy5 models currently report error tolerance values.
Values > 0 will scale all of the ESL error tolerance values in order to tighten
or loosen these values, that is, Final GSE error tolerance = Error Scale
Factor * ESL error tolerance
Values <= 0 will disable using the ESL error tolerance values, and the
default computation for the local integration error will be used.
Information Check to display verbose information about the general state equation (GSE)
that the controls system import created.
Visibility This option is only available for External System Libraries of type FMU.
Visibility means the FMU runs in interactive mode. Turn it off if you want to
run it in batch mode. In order for this option to work in Adams, visibility
needs to be supported by the specified FMU.
Communication Interval This option is only available for External System Libraries of type FMU. To
co-simulate with the FMU you need to specify the communication interval.
Sample the FMU at least two times faster than the highest frequency of interest
(refer to Nyquist frequency).
If Co-Simulation is selected, the following options will be displayed:
Plant Input/Output Standard
Standard method creates the GSE by importing the External System
Library and using the default input and output state variables.
User Defined
User-Defined method follows the same method as that of Standard
method except it allows the user to select input and output state variables.
Dialog Box - F1 Help 147
Create Motor
Easy5
MATLAB
FMU
If User Defined is selected, the following options will be displayed:
Controls Plant Name Enter the name of the Controls Plant to be created
File Prefix Enter the prefix for the .adm, .cmd, .acf, .m, and .inf files that Adams Controls
creates.
Initial Static Analysis Select one of the following:
Easy5
MATLAB
FMU
148 template_based_common
Curve Manager
Scale Factor
Step Function
Expression
If Scale Factor is selected, the following option is displayed:
Scale Factor Enter a constant scale factor to apply to the motor torque.
If Step Function is selected, the following options are displayed:
Start Time Enter start time.
End Time Enter end time.
Start Value Enter start value.
End Value Enter end value.
If Expression is selected, the following option is displayed:
Expression Enter a run-time expression to scale the motor torque.
Curve Manager
• Plot and Data Table view - You can interact with both the plot and the data table, and update one
from the other.
• Property Table view - Certain property files enable this option, such as Adams Ride bushings.
This mode allows you to manually change multiple parameter values stored in the property file.
Set units - From the Settings menu, select Units. (see Set File Units dialog box help)
Note: Note that the two pull-down menus at the top left of the Curve Manager are informational
(except when working with property files that contain more than one curve, such as bushings):
The first menu displays the type of component with which you are working. For bushings, you can
display data for translational or rotational bushings.
The second menu displays the component characteristic for which the Curve Manager displays data.
For bushings, you can display data for the x, y, or z characteristics.
In both views, along the left side of the window, are options that are shared by both views and options that
are specific to each view:
For information on the options shared by both views, see the help for the different components.
For information on the options specific to each view, see Curve Manager Plot View or Curve Manager Table
View.
Torsion Spring
Tools → Curve Manager
Create or modify a Torsion Spring Property File (*.tsf ). Learn about Torsion Springs.
You can create a linear spring (torque vs. angular displacement) by entering a slope, or define any torque-
angle relation using a mathematical formula. See Modifying Curves.
The following table explains the default options that are common to both the plot and table Curve Manager
views. Learn about the Curve Manager.
Dialog Box - F1 Help 151
Curve Manager
Bearing
Tools → Curve Manager
Clutch Force
Tools → Curve Manager
Create or modify a Clutch Force Property File (*.clu). Learn about Clutch Forces.
You can create a linear spring (torque vs. angular displacement) by entering a slope, or define any torque-
angle relation using a mathematical formula. See Modifying Curves.
Besides the force vs. displacement curve, the Curve Manager lets you edit a clutch force property file's linear
damping rate.
The following table explains the default options that are common to both the plot and table Curve Manager
views. Learn about the Curve Manager.
Wet Clutch
Tools → Curve Manager
Modify a Wet Clutch Property File (*.wcf ). Learn about the conceptual Wet Clutch.
You can create a linear relationship (pressure vs. time) by entering a slope, or define any non-linear relation
using a mathematical formula. See Modifying Curves.
Besides the pressure vs. time curve, the Curve Manager Property Table lets you edit a wet clutch property
file's parameters and mass properties.
The following table explains the default options that are common to both the plot and table Curve Manager
views. Learn about the Curve Manager.
Dialog Box - F1 Help 153
Curve Manager
Complex Spring
Tools → Curve Manager
Modify a Complex Spring Property File (*.csp). Learn about the Complex Springs.
You can create a linear relationship (torque vs. angle) by entering a slope, or define any non-linear relation
using a mathematical formula. See Modifying Curves.
The complex spring defines two separate three-dimensional loading and unloading curves. Thus the Curve
Manager gives you the option in Plot View to visualize the data as a 2D or 3D plot.
The following table explains the default options that are common to both the plot and table Curve Manager
views. Learn about the Curve Manager.
Ride Tire
Tools → Curve Manager
Modify a Ride Tire Property File (*.rti). Learn about Ride Tires.
154 template_based_common
Curve Manager
You can create a linear relationship (friction vs. slip) by entering a slope, or define any non-linear relation
using a mathematical formula. See Modifying Curves.
Besides the friction vs. slip curve, the Curve Manager Property Table lets you edit a ride tire property file's
geometry, stiffness, damping, and mass properties.
The following table explains the default options that are common to both the plot and table Curve Manager
views. Learn about the Curve Manager.
Torque Converter
Tools → Curve Manager
Modify a Torque Converter Property File (*.tcf ). Learn about Torque Converters.
You can create a linear relationship by entering a slope, or define any non-linear relation using a mathematical
formula. See Modifying Curves.
Besides the capacity factor vs. speed ratio and torque ratio vs. speed ratio curves, the Curve Manager lets you
edit a torque converter property file's lockup clutch properties.
The following table explains the default options that are common to both the plot and table Curve Manager
views. Learn about the Curve Manager.
Dialog Box - F1 Help 155
Curve Manager
Modify a Dyno Motion Series Property File (*.dyn). Learn about Dyno.
You can create a linear relationship by entering a slope, or define any non-linear relation using a mathematical
formula. See Modifying Curves.
Besides the torque magnitude vs. order and phase shift vs. order curves, the Curve Manager lets you edit a
dyno property file's mean torque value and angle multiplier.
The following table explains the default options that are common to both the plot and table Curve Manager
views. Learn about the Curve Manager.
Modify a Dyno Curve (angle) Property File (*.dav). Learn about Dyno.
156 template_based_common
Curve Manager
You can create a linear relationship by entering a slope, or define any non-linear relation using a mathematical
formula. See Modifying Curves.
A Dyno Curve (angle) file defines a three-dimensional curve of either motion or torque as a function of angle
and angular velocity. Thus the Curve Manager gives you the option in Plot View to visualize the data as a 2D
or 3D plot.
The following table explains the default options that are common to both the plot and table Curve Manager
views. Learn about the Curve Manager.
Modify a Dyno Curve (time) Property File (*.dti). Learn about Dyno.
You can create a linear angular velocity or torque vs. time relationship by entering a slope, or define any non-
linear relation using a mathematical formula. See Modifying Curves.
The following table explains the default options that are common to both the plot and table Curve Manager
views. Learn about the Curve Manager. Learn about the Curve Manager.
Dialog Box - F1 Help 157
Curve Manager Plot View
Plot mode - You can manually adjust the profile of the curve by selecting an appropriate hotpoint
and dragging that point in either the positive or negative vertical direction. Note that you cannot
drag Hotpoints horizontally.
Table mode - You can insert or delete rows of data. You can also enter new values for your plot data
by highlighting the text box you want to modify and typing the new values.
Managing Plots
The Curve Manager has several tools you can use to manage your plots.
Printing Plots
To print your plots, select File → Print.
Starting Row Enter the row number at which you want to start inserting or deleting rows.
Number of Rows Enter the number of rows you want to insert or delete.
Insert Rows Select to insert rows.
Delete Rows Select to delete rows.
Filter Select a format by which to filter the data.
Sort Sort the data in ascending order.
Damper
Tools → Curve Manager
Generates a Damper Property File. Learn about dampers.
You can create a linear damper by entering a slope, or define a force-velocity relation using a mathematical
formula. See Modifying Curves.
The following table explains the default options that are common to both the plot and table Curve Manager
views. Learn about the Curve Manager.
Data Editor/Viewer
In Adams Driveline, the Data Editor/Viewer lets you view data as plots or as tabular data.
Note: The Data Editor/Viewer has a different name depending on where you opened it from. If in
editor mode, Editor is part of the title. If in viewer mode, Viewer is part of the title.
If the Data Editor/Viewer is in editor mode, you can make changes to your data. To modify a component
and its property file with new data, make sure you select OK or Apply, in the Data Editor/Viewer and in the
dialog box from which you launched it.
Delete File(s)
Tools → File Management → Delete Shared Dialog Box
Deletes files from the file system.
When specifying the file names, you can take advantage of the database alias naming conventions. Therefore,
if the <private> database is located at /usr/people/gabriel/[Link], then either of the following file name
specifications will work:
/usr/people/gabriel/[Link]/[Link]/[Link]
or
<private>/[Link]/[Link]
Note: Your template-based product will not prompt you for a confirmation of the file deletion: it
assumes that because you are using the dialog box, the file names you enter are those you want
to delete.
Delete Objects
(Template Builder) Build → Component name → Delete Shared Dialog Box
Deletes one or more objects. The name of this dialog box corresponds to the object from which you launched
it. For example, if you launched it from Build → Hardpoint → Delete, the name of the dialog box will be
Delete Hardpoints.
Delete Variants
(Standard Interface) File → Manage → Assemblies/Subsystems → Delete Variant
Deletes one or more variants from an assembly or subsystem in session. The same dialog box is used when
operating on subsystems and assemblies.
If the entity you are orienting is a construction frame, you can parameterize the
location offset. You can, for example, use a parameter variable to define the location
offset.
local - Specify only when the Coordinate Reference text box contains a
construction frame.
global - Specify when the Coordinate Reference text box contains either a
construction frame or a hardpoint. Because hardpoints contain only location
and no orientation information, if you select local when the Coordinate
Reference contains a hardpoint, Location in will default to using the global
reference frame.
Note: Because hardpoints have no orientation, you cannot use them to define this type of orientation
dependency. Learn about Hardpoints.
If the entity you are orienting is a construction frame, you can parameterize the
orientation offset. You can, for example, use a parameter variable to define the
orientation offset.
Differential
Tools → Curve Manager
Create or modify a Differential Property File (*.dif ). Learn about differentials.
You can create a linear viscous differential (torque vs. angular velocity) by entering a slope, or define any
torque-velocity relation using a mathematical formula. See Modifying Curves.
The following table explains the default options that are common to both the plot and table Curve Manager
views. Learn about the Curve Manager.
the vertical (y) values in terms of the horizontal (x) values. You can use only one
independent variable (x) to describe the functional relation. You can use any valid
FORTRAN mathematical operator, such as SIN, **2, and so on.
Display Subsystem
(Standard Interface) View → Subsystem Shared Dialog Box
Displays an open subsystem. Learn about subsystems.
Display Template
(Template Builder) View → Template Shared Dialog Box
Displays a template that is open.
Simulation → Create a new Simulation Script → Script Type: Adams Solver Commands
Specifies options for creating ACF command for Eigen Solution Calculation.
Range:
Range:
Range:
Range:
Entity Comments
Entity Information
(Standard Interface) Tools → Model Diagnostics → Entity Info Shared Dialog Box
Provides an overview of a subsystem.
Dialog Box - F1 Help 169
Entity Information
Entity Information
(template Builder) Build → Component Name → Entity Info Shared Dialog Box
Provides general information for a specified class of entities in your template to help you understand the
topology of the model.
Adams Insight appends the suffix .xml to the name (see XML File Format). For example,
if you named your experiment trial1, Adams Insight saves it in your default directory
as [Link].
Simulation Script Enter a Simulation Script. Adams Insight uses the simulation script to provide the
simulation details and parameters to Adams Insight.
Feedback Database
[Link]
In an effort to continually improve our products and meet customer requirements, MSC Software provides
a feedback database. If you have access to the Internet, the feedback database provides a quick and easy
method to report problems and request enhancements. If you do not have Internet access, contact your local
MSC Software office who can submit feedback on your behalf.
When providing feedback, be as detailed as possible and include examples of how to reproduce the problem.
This allows us to respond more quickly. To include examples, you can upload files (log files, Datasets, Adams
commands) to the feedback database.
When MSC Software receives your feedback, it automatically assigns it a change request (CR) number and
e-mails you a copy of the response. Do not reply to these e-mails, but rather use the Web interface, because
responding to a CR using reply is not currently supported and MSC Software staff will not see your response.
File Management
(Standard Interface) File → Info → Modified Files Shared Dialog Box
Displays modified assemblies and subsystem in the current session. The table lists only those subsystems and/or
assemblies that have been modified since their last save.
Dialog Box - F1 Help 171
Frequency Bushing
Frequency Bushing
Tools → Curve Manager
Generate or edit a frequency bushing property file. Learn about Working with Frequency Bushing.
You can create a frequency bushing property file by specifying stiffness curves, loss angles, and scale factors
for all six directions. You can also enter data in the Property Table view. See Modifying Curves.
Besides the Property Table, the Curve Manager lets you edit a frequency bushing property file's:
Six stiffness curves (three translational and three rotational characteristics)
Six loss angles
Bushing shape
Rectangular - No interaxial coupling in force/torque calculations.
Cylindrical - Forces/torques in x and y directions are coupled. Force/torque in z direction is
independent.
Spherical - Forces/torques in and about all three directions are coupled.
The following table explains the options that are available in the Curve Manager plot view. Learn about Curve
Manager.
172 template_based_common
Gear Pair
the vertical (y) values in terms of the horizontal (x) values. You can use only one
independent variable (x) to describe the functional relation. You can use any valid
FORTRAN mathematical operator, such as SIN, **2, and so on.
Note: The pull-down menus in the upper left corner of the Curve Manager allow you to select an
active plot (translational and rotational stiffnesses) and components (x-y-z axis).
Gear Pair
(Standard Interface) Driveline Components → Gear Pair ...
Modifies a Gear Pairs.
actuator name
activity
application
identifier
The sort can be done in ascending or descending order.
List of actuators Displays the actuators in the current assembly.
Attributes The read-only columns Active, Application, Identifier and Function Expres-
sions provide an overview of the current actuator definitions.
Activate Selection Allows activating and de-activating individual or multiple actuators by select-
ing the corresponding row(s) and hitting the appropriate button.
De-activate Selection
Use the <Ctrl> button to select multiple rows.
Edit selection in wizard Allows editing individual actuators by selecting the corresponding row and
switching to the actuator wizard layout.
If multiple rows are selected upon pressing this button, the data for the first
selected row will be used to open the wizard.
General Bushing
Tools → Curve Manager
Edit a general bushing property file (*.gbu). Learn about General Bushing.
You can edit a general bushing property file by modifying the static stiffness curves, loss angles, shape and
coupling options. You can also enter data in the Property Table view. See Modifying Curves.
Besides the Property Table, the Curve Manager lets you edit a general bushing property file's:
Six static stiffness curves (three translational and three rotational characteristics)
Six loss angles
Bushing shape
Rectangular - No interaxial coupling in force/torque calculations.
Cylindrical - Forces/torques in x and y directions are coupled. Force/torque in z direction is
independent.
Spherical - Forces/torques in and about all three directions are coupled.
Coupling
Uncoupled - Uncouple Bouc-Wen force from linear stiffness force.
Coupled - Couple Bouc-Wen force with linear stiffness force.
Revised - Revised Bouc-Wen force with linear stiffness force.
The following table explains the options that are available in the Curve Manager plot view. Learn about Curve
Manager.
176 template_based_common
General Part Wizard
the vertical (y) values in terms of the horizontal (x) values. You can use only one
independent variable (x) to describe the functional relation. You can use any valid
FORTRAN mathematical operator, such as SIN, **2, and so on.
Note: The pull-down menus in the upper left corner of the Curve Manager allow you to select an
active plot (translational and rotational stiffnesses) and components (x-y-z axis).
left/right - Define either the left or the right general part, and your
template-based product creates the corresponding opposite general part by
default.
single - Define a nonsymmetric general part.
Geometry Type Select one of the following:
Material - Calculate the mass and inertia properties from the density value
for the material you selected.
User Entered - Calculate the mass and inertia properties from a user-entered
density.
If you set Density to Material, your template-based product displays the following option:
Material Type Select a material type your template-based product should use to calculate the
general part's mass and inertia properties.
If you set Density to User Entered, your template-based product displays the following option:
Density Value Enter the density your template-based product should use to calculate the
general part's mass and inertia properties.
Select to display a dialog box where you can add multi-line comments to any
entity, to describe its purpose and function. Your template-based product
displays different comments dialog boxes, depending on the entity type for
which you want to record comments:
Highlight Connectivity
Tools → Model Diagnostics → Highlight Connectivity Shared Dialog Box
Helps you view the connectivity of various components.
Instrumentation Table
(Standard Interface) Adjust → Instrumentation → Instrumentation Table
The table like interface provides the user with an easy way of looking at a list of Instrumentation at once and
activating/deactivating a selection.
Loading Table
(Standard Interface) Adjust → Loading → Table Shared Dialog Box
The table-like interface provides the user with an easy way of looking at a list of loading objects that helps in
activating/deactivating an entire selection.
loading name
type
activity
location type
attachment type
The sort can be done in ascending or descending order.
Alignment Include Select to include or exclude individual or multiple loading objects during alignment
by selecting the corresponding row(s) and selecting the appropriate button.
If multiple rows are selected when pressing this button, the object in the first
selected row will be used to populate the Modify Loading dialog box.
Loading Table
(Template Builder) Build → Loading → Table Shared Dialog Box
The table-like interface provides the user with an easy way of looking at a list of loading objects that helps in
activating/deactivating an entire selection.
182 template_based_common
Located Along An Axis
loading name
type
activity
location type
attachment type
The sort can be done in ascending or descending order.
Activate Selection Allows activating and de-activating individual or multiple loading objects by
selecting the corresponding row(s) and hitting the appropriate button.
De-activate
Selection Use the <Ctrl> button to select multiple rows.
Modify Selection Select a single row, then hit Modify Selection to bring up the Modify Loading dialog
box.
If multiple rows are selected when pressing this button, the object in the first
selected row will be used to populate the Modify Loading dialog box.
Note: Because hardpoints have no orientation, you cannot use them to define this type of location
dependency. Learn about Hardpoints.
Dialog Box - F1 Help 183
Located At Flexible Body Node
If the entity you are orienting is a construction frame, you can parameterize the
location offset. You can, for example, use a parameter variable to define the location
offset.
Example: (pvs_length).
Axis Select to apply the offset distance along either the x-, y-, or z-axis of the construction
frame.
Located On A Line
Dialog boxes where you can set location dependencies Shared Dialog Box
Locate an entity at a variable distance between Coordinate References.
184 template_based_common
Location Input Communicator
Message Window
Displayed as needed Shared Dialog Box
The Message Window is a separate window that displays alerts, warnings, errors, and other messages which
are kept separate from the general-purpose message window. Your template-based product records these
messages in the log file so you can refer to them as needed.
Dialog Box - F1 Help 185
Migrate Chassis Database
Model Auditor
Tools → Model Diagnostics → Model Auditor Shared Dialog Box
Audits a full-vehicle model using user-entered tolerances. The results are displayed on screen and saved to a
text file. See Model Auditor for more information.
186 template_based_common
Model Auditor
The menu lists all full-vehicle assembly variants of the chosen assembly.
Switches to the selected variant and adds the required testrig as needed.
Report Filename Enter a string that specifies the report filename. The default filename is the
model name appended with “.dat”.
Solver settings Select this option to check and report the Solver settings for this assembly
variant.
Beam length vs. diameter Select this option to check beam element length compared with diameter.
Part inertias Select this option to check that all rigid body inertias are physically
meaningful.
Part CG locations Select this option and enter a distance tolerance to check each part’s CG
offset.
Bushing coincident with Select this option to check bushing locations compared to their Zp/Xp
ZpXp locations.
Bushing damping fraction Select this option and enter lower and upper limits to check bushing
damping relative to stiffness.
Dialog Box - F1 Help 187
Modify 2D Spur Gear Force
ac_spring
ac_damper
ac_bushing
ac_airspring
The following attributes are checked:
sign convention
monotony (does not include ac_airspring)
2nd derivative
Tire scale factor Select this option and enter lower and upper limits to check scale factors used
by the Ford Tire Model. (This is applicable only for Adams FoCus)
You can include dynamic and static friction in the gear force. You define the friction by specifying static
and dynamic coefficient, and slip and transition velocity. Learn about Calculation of Friction Force.
Stiffness Enter the stiffness. The stiffness is in force units/length units.
Force Exponent Specify the force exponent of the contact force formulation. The force
exponent is typically larger than 1.
Scale Factor Specify the scale factor of the contact force formulation. The scale factor is
in length units.
Damping Specify the damping coefficient of the contact force formulation. The
damping is in force units * time units/length units.
188 template_based_common
Modify Adjustable Force
Select to display the Data Editor/Viewer and plot the force characteristics based
on the specified stiffness, scale factor, and force exponent.
For example, if you enter 0,0,1,0, your template-based product performs four initial
static equilibrium simulations for adjusting the suspension, but the adjustable force
acts during the third static equilibrium Simulation only. You should coordinate the
pattern of all forces in all templates.
Recommended pattern for toe and camber adjustable forces in the templates -
Toe :101
Camber : 0 1 1
Recommended pattern for toe, camber and caster adjustable forces in the templates -
Toe :100101
Camber : 0 1 0 1 0 1
Caster :001010
Note: The first column will do toe adjustment, second column will do camber
adjustment, third will do caster adjustment - these three adjustment
generally are very close to the expected value. There could be influence of
change in caster on the toe/camber, so fourth column is to do minor toe
and camber adjustment. There could be slight change in the caster due to
change in the toe/camber so that fifth column and so on. Also, you can't
do all three adjustments together unless there is sufficient compliance in
the system to accommodate effect of change in the caster on the
toe/camber and vice versa.
Stiffness/Damping Specify stiffness/damping values, which form the basis of the force function
definition. The adjustable force assembly instance includes the force definition.
Lock with Motion Select one of the following:
yes - Motion is locked at the value computed during the initial static solution.
no - Motion displacement changes over the dynamic portion of the Simulation,
which may introduce undesired effects when large amplitude force changes
occur in the model.
Dialog Box - F1 Help 191
Modify Adjustable Force
Display the adjusted value which is required to move the J part to achieve desired
value.
Reset Set motion delta value to zero. The adjustable force will be reset to initial suspension
configuration. Useful when you have multiple adjustable forces of same type.
You should coordinate the Reset button when you have multiple adjustable forces in
the template.
Select to display a dialog box where you can add multi-line comments to any entity,
to describe its purpose and function. Your template-based product displays different
comments dialog boxes, depending on the entity type for which you want to record
comments:
If the location was defined at creation time using a location expression, the Location
text box is disabled and the location cannot be modified in Standard Interface. You
can modify location of the hardpoint or construction frame used in the location
expression.
Location defines the initial Cartesian coordinates of the origin of the force with
respect to the Global Coordinate System (GCS).
Location 2 Enabled if the aerodynamic force location 2 was defined to be User Entered when
created. Enter the x, y, and z values for the aerodynamic force location 2, separated
by commas (for example, -100, 200, 50).
If the location was defined at creation time using a location expression, the Location
text box is disabled and the location cannot be modified in Standard Interface. You
can modify location of the hardpoint or construction frame used in the location
expression.
Location defines the initial Cartesian coordinates of the origin of the force with
respect to the Global Coordinate System (GCS).
Property File Specify the property file that contains the coefficient data for the aerodynamic force.
Select the "+" button to add a new property file to the list. Select the "-" button to
remove one or more property files from the list.
The property files for aerodynamic force are classified into four types as shown in
below table:
Property File Type Aerodynamic Force Coefficients Spline Type
Dialog Box - F1 Help 193
Modify Aerodynamic Force
Learn about:
Select the "+" button to add a new property file to the list. Select the "-" button to
remove one or more property files from the list.
Trim Load/ Select one of the following:
Auto Trim Load
Trim Load - Enter a value that sets the spring's trim load.
Auto Trim Load - Adams Solver uses a differential equation to set the spring's trim
load.
Scale Factor Enter a scale factor to be applied to the force function. The default is 1.0.
Symmetric Enabled when you modify component pairs (or brothers):
Learn about:
Modify Arm
Right-click component → Modify Shared Dialog Box
Modifies an arm. Learn about Arm Geometry.
Modify Bumpstop
(Standard Interface) Right-click component → Modify Shared Dialog Box
Modifies a bumpstop. Learn about Working with Bumpstops.
Select the "+" button to add a new property file to the list. Select the "-" button to
remove one or more property files from the list.
Learn about:
Modify Bushing
(Standard Interface) Right-click component → Modify Shared Dialog Box
Defines a bushing. Learn about Working with Bushings.
Default: orient the I part compliance so that it matches the bushing’s orientation
Euler Angles: orient the I part compliance using Euler angles
Direction Vectors: orient the I part compliance by specifying the X and Z vectors
Euler Angles Enter three rotation angles to define the I part compliance orientation
X Vector Enter three values to define the X vector of the I part compliance
Z Vector Enter three values to define the Z vector of the I part compliance
If the I part compliance is active, the following tab will be enabled:
J Part Compliance (disabled if an FMU is selected as the property file)
J part compliance Select this toggle to activate a bushings-in-series calculation. This is used to represent
(bushings-in- the local compliance of the J part.
series)
Property File J Part Select a linear bushing property file (.lbu or .xml) to represent the local J part
compliance.
Orient using Select one of the following:
Default: orient the J part compliance so that it matches the bushing’s orientation
Euler Angles: orient the J part compliance using Euler angles
Direction Vectors: orient the J part compliance by specifying the X and Z vectors
202 template_based_common
Modify Bushing
Select the "+" button to add a new property file to the list. Select the "-" button to
remove one or more property files from the list.
Symmetric Enabled when you modify component pairs (or brothers):
Learn about:
Modify Connector
(Standard Interface) Adjust → Connector → Modify Shared Dialog Box
Modifies a connector. Learn about Working with Connectors.
joint – The joint will be active, and the bushing will be inactive.
bushing – The bushing will be active, and the joint will be inactive.
both – The bushing and joint will both be active.
none – The bushing and joint will both be inactive.
kinematic flag – If the subsystem is in kinematic mode, the joint will be
active, and the bushing inactive. If the subsystem is in compliant mode,
the bushing will be active, and the joint will be inactive.
Bushing Displays the associated bushing. Select the bushing button to open the
Modify Bushing dialog box.
Joint Type Select one of the following joint types:
fixed
revolute
spherical
translational
Symmetric Enabled when you modify component pairs (or brothers):
Displacement
Velocity
Acceleration
Force
If Force is selected above, the following options are enabled:
Coordinate(s) Select to activate any number of the following force requests:
Modify Damper
(Standard Interface) Right-click component → Modify Shared Dialog Box
Modifies a damper. Learn about Working with Dampers.
Select the "+" button to add a new property file to the list. Select the "-" button
to remove one or more property files from the list.
Scale Factor (comp) Enter a scale factor to be applied to the force function, in the compression
direction. The default is 1.0.
Scale Factor (reb) Enter a scale factor to be applied to the force function, in the rebound direction.
The default is 1.0.
Symmetric Enabled when you modify component pairs (or brothers):
Learn about:
Modify Dyno
(Standard Interface) Adjust → Dyno Shared Dialog Box
Modifies a Dyno.
208 template_based_common
Modify Dyno
Motion-Velocity
Torque
Function Type Select one of the following:
Series - Specify the function of the dyno as a Fourier Sine series, by specifying the
mean value, order, magnitude, phase shift, and angle multiplier. You also specify
the direction of rotation. See Function Type: Series.
Constant - The input to the dyno is a constant value. The value will have the
units corresponding to the choice of actuator (angular_velocity when choosing
motion, and torque when choosing torque). See Function Type: Constant.
Curve - Specify the function of the dyno as a spline depending on time or angle
and angular velocity. You also specify the direction of rotation. See Function Type:
Curve.
User-Entered - Lets you create a user-specified function. Note that if you want to
specify a velocity function, functions for motions must always use radians. See
Function Type: User-Entered.
If you are working in Adams Driveline and have set the Dyno Type to Torque, the
following options are also available:
Modify FE Part
(Standard Interface) Adjust → FE Part Shared Dialog Box
Modifies an FE Part. Learn about FE Parts, a method of modeling structural flexibility.
Select to modify the related FE Part Section. If the FE Part references more than
one Section, the Modify Section dialog box will open with the Section referenced
by FE_Node_1.
Euler Angles
Direction Vectors
If you select Euler Angles, your template-based product enables the following option:
Euler Angles Enter the three Euler angle values that define the flexible body's orientation.
If you select Direction Vectors, your template-based product enables the following options:
X Vector Enter the x, y, and z values that define the direction of the x-vector along which the
flexible body will be oriented.
Dialog Box - F1 Help 211
Modify Friction Element
If you have several different modal neutral files all representing the same part, but
with different modal flexibility characteristics, you can switch between them by
selecting the desired MNF file.
Sprung Mass % Enter percentage contribution of part total mass into sprung mass. Select a location
of sprung mass contribution from the list for the subsystem with role other than
front or rear. (Used only for SVC event)
Select to view the comments that were added during the creation of the flexible
body in the Template Builder.
Select to display the Flexible Body Mode Manager, where you can view/animate
mode shapes and perform other operations, such as define the deformation scale
factor and inertia modeling, or enable/disable modes.
Note: If you are creating friction on a joint active only in kinematic mode, be aware that when you
select compliant mode, the friction force will be disabled along with the joint.
You can:
Use an existing property file by specifying the name of the property file that
contains the parameter values of the component.
Tips on Entering File Names in Text Boxes.
When you specify a property file, your template-based product automatically
updates the dialog box with the values from the property file.
Create a new property file by specifying a new name. When you specify a new
name, your template-based product displays the database path that it will use
to create the new file.
Your template-based product always creates a new property file in the default
writable database.
Geometry tab
Module* Enter the module of the gear. The module is equal to 1/diametral pitch.
Number of Teeth* Enter the number of teeth of the gear. The pitch diameter is computed based on
the equation:
az - Angular displacement
wz - Angular velocity
Torsional Stiffness Enter the stiffness of the rotational spring-damper. The stiffness is in force units *
(optional) length units/angle units.
Torsional Damping Enter the damping coefficient of the rotational spring-damper. The damping is in
(optional) force units * length units * time units/angle units.
Fixed Gear Select one of the following:
Select to display a dialog box where you can add multi-line comments to any entity,
to describe its purpose and function. Your template-based product displays
different comments dialog boxes, depending on the entity type for which you want
to record comments:
Note: *Parameter values are stored in the property file. You can only update these values when
Editable is selected.
If the location was defined at creation time using a location expression, the Location
text box is disabled and the location cannot be modified in Standard Interface.
Location defines the initial Cartesian coordinates of the origin of the part’s Body
Coordinate System (BCS) with respect to the Global Coordinate System (GCS).
Orient using Select if you want to orient the general part using:
Euler Angles
Direction Vectors
If you select Euler Angles, your template-based product enables the following option:
Euler Angles Enter the three Euler angle values that define the general part's orientation.
If you select Direction Vectors, your template-based product enables the following options:
X Vector Enter the x, y, and z values that define the direction of the x-vector along which the
general part will be oriented.
Z Vector Enter the x, y, and z values that define the direction of the z-vector along which the
general part will be oriented.
Mass Enter the mass of the general part.
Ixx/Iyy/Izz Enter the values that define the moments of inertia components of the general part.
The inertia reference frame is parallel to BCS at the center of mass (CM) location.
Learn About Entering Mass Moments of Inertia.
Off-Diagonal Select to display and undisplay the Ixy/Izx/Iyz text boxes.
Terms
Sprung Mass % Enter percentage contribution of part total mass into sprung mass. Select a location
of sprung mass contribution from the list for the subsystem with role other than
front or rear. (Used only for SVC event)
If you select Off-Diagonal Terms, your template-based product displays the following options:
Ixy/Izx/Iyz Enter the values that define the products of inertia components of the general part.
(optional) The inertia reference frame is parallele to BCS at the center of mass (CM) location.
CM Location Enter the x, y, and z values of the location offset. You can offset the center of mass
Relative to Part and inertia markers of the general part a specified distance from the general part's
(optional) Body Coordinate System location. Learn about Markers.
216 template_based_common
Modify General Part
Material - Calculate the mass and inertia properties from the current
density value for the selected material
User-Entered - Calculate the mass and inertia properties from a user-
entered density
If you set Density to Material, your template-based product displays the following option:
Material Type Select a material type from the list of materials currently defined. When you select
a material, your template-based product uses the density defined for that material
to calculate the general part's mass and inertia properties.
If you set Density to User-Entered, your template-based product displays the following option:
Density Value Enter a density that your template-based product will use to calculate the general
part's mass and inertia properties.
Select to calculate and display the mass and inertia into the respective fields.
Modify Instrumentation
(Standard Interface) Right-click component → Modify Shared Dialog Box
Defines a instrumentation. Learn about Instrumentation.
Platform
Data cable
Inside Laser
Outside Laser
Anti Rotation Support
If sensor type is Velocity is selected then it enables the following options:
Ay Calculation Method Option is only available when sensor type Velocity selected.
Select one of the following:
Corrected for roll and pitch. Ay in body frame, corrected with respect to
roll and pitch (Ay as Adams measures)
Uncorrected for roll and pitch. Ay in body frame, uncorrected (Ay as an
accelerometer would measure)
This will calculate lateral acceleration (an additional request "vehicle statistics"
added at I location) with and without accelerometer gravity effect.
By default (option 1) the acceleration is output without gravity effects. This
acceleration is measured in the body reference frame. Option 2 corresponds to
acceleration as an accelerometer would measure. This value is higher than that
from option 1, because it contains an additional component due to angular
orientation of the body, roughly equal to sin(Roll).
220 template_based_common
Modify Linear Bushing
Note: The orientation options are not enabled because they are not editable in Standard Interface.
You can only modify the orientation by editing the associated template.
Dialog Box - F1 Help 221
Modify Linear Damper
Learn about:
Learn about:
Learn about:
Modify Link
Right-click component → Modify Shared Dialog Box
Modifies a link. Learn about Link and Cylinder Geometry.
Modify Loading
(Standard Interface) → Adjust → Loading → Modify Shared Dialog Box
Modifies a loading. Learn about Loading.
If the location was defined at creation time using a location expression, the
Location text box is disabled and the location cannot be modified in Standard
Interface.
Location defines the initial Cartesian coordinates of the origin of the part's Body
Coordinate System (BCS) with respect to the Global Coordinate System (GCS).
Orient using Select if you want to orient the general part using:
Euler Angles
Direction Vectors
If you select Euler Angles, your template-based product enables the following option:
Euler Angles Enter the three Euler angle values that define the general part's orientation.
If you select Direction Vectors, your template-based product enables the following options:
X Vector Enter the x, y, and z values that define the direction of the x-vector along which the
general part will be oriented.
Z Vector Enter the x, y, and z values that define the direction of the z-vector along which the
general part will be oriented.
Mass Enter the mass of the loading part.
Ixx/Iyy/Izz Enter the values that define the moments of inertia components of the loading
part. The inertia reference frame is parallel to BCS at the center of mass (CM)
location. Learn About Entering Mass Moments of Inertia.
Off-Diagonal Terms Select to display and undisplay the Ixy/Izx/Iyz text boxes.
If you select Off-Diagonal Terms, your template-based product displays the following options:
226 template_based_common
Modify Location Dependencies
You can modify the bushing by right click > point to its database name > select
modify.
Select to display a dialog box where you can add multi-line comments to any entity,
to describe its purpose and function. Your template-based product displays
different comments dialog boxes, depending on the entity type for which you want
to record comments:
User-entered Location
Delta Location From Coordinate
Centered Between Coordinates
Located Along An Axis
Located On A Line
Location Input Communicator
Located At Flexible Body Node
Modify Motor
(Standard Inteface) Right-click Motor → Modify
Modifies a motor
Please see the Torque Angle() Calculation and Pole Slipping for Torque angle calculation and pole slipping details.
Note: In actual implementation Er is calculated as magnitude (Er = SQRT (Re(Er) ^2 + Im(Er) ^2)) and not as
complex number.
Where:
230 template_based_common
Modify Motor
T = KφI a
ZP Es – Eb ZφNP
K = ---------- I a = ----------------- E b = ---------------
2πa Ra 60a
Where
T = Torque developed in N-m
K = Torque constant
φ = Flux per pole in Webers
Ia = Armature current in Amps
Z = Number of conductors
P = Number of Poles
a = Number of parallel paths in the Armature.
Es = Source Voltage in Volts
Eb = Back emf induced in Volts
Ra= Armature resistance in ohms
N = Revolutions per Minute
No. of conductors (Z) Enter number of conductors.
Flux Per Pole (φ ) Enter flux per pole. It is the measure of the quantity of magnetism, that is, the
total number of magnetic lines of force passing through a specified area in a
magnetic field.
Source Voltage (Es) Enter source voltage. Enter source voltage value. This will corresponds to the
voltage provided on the supply terminal to produce a meaningful output.
No. of Paths (P) Enter the number of parallel armature Winding paths.
Armature Resistance (Ra) Enter armature resistance. The Resistance offered by the windings in the
moving part of the motor to current flow in the coils.
No. of Poles (P) Enter no of poles. This will corresponds to the No of poles in the stator field
of the Motor based on its specification. It is a factor that plays a role to identify
the capacity of the motor.
232 template_based_common
Modify Motor
ZP Es – Eb ZφNP
K = ---------- I a = ----------------- E b = ---------------
2πa Ra 60a
Where
T = Torque developed in N-m
K = Torque constant
K1 = Series motor constant
T = k d k p k s mnBLRI
Eb – Es ZφNP
I a = ----------------- E b = ---------------
Ra 60a
Where
kd = Distribution Factor
kp = Coil pitch Factor
ks = Slot Skew Factor
m = Number of Teeth per phase
n = Number of Turns per phase
B = Strength of the permanent Magnetic field
L = Length of rotor windings
R = Radius of Armature
I = Current in the Motor winding
T = Torque developed in N-m
φ = Flux per pole in Webers
Z = Number of conductors
P = Number of Poles
a = Number of parallel paths in the Armature
Es = Source Voltage in Volts
Eb = Back emf induced in Volts
Ra = Armature resistance in ohms
N = Revolutions per Minute
Distribution Factor (kd) Enter distribution factor. The distribution factor kd reflects the fact that the
winding coils of each phase are distributed in a number of slots.
234 template_based_common
Modify Motor
π
T 1 = HSin --- ⁄ S θ
2
π
T 2 = HCos --- ⁄ S θ
2
Where
T1 = Torque on the first winding.
T2 = Torque on the Secondary winding.
H = Holding Torque in N-m.
S = Step Angle in radians.
θ = Shaft Angle in radians.
Holding Torque (H) Enter holding torque. The amount of torque required to remain the motor
shaft in a particular position.
Control Type One Phase On-Full Step Drive
Two Phase On-Full Step Drive
Step Angle (S) Enter step angle. The angle by which the rotor of an stepper motor will rotate
when a signal is passed.
Friction Torque This is a constant opposing torque and does not vary with velocity.
Damping Coefficient This is specified as a constant which is multiplied by angular velocity to get the
damping torque. It represents the combined electromagnetic and viscous
damping.
Input Type To indicate the type of data in the input file.
PPS vs Time - Pulse per second vs time. The Stepper motor rotates by its
step angle when a pulse is received.
Target Angle vs Time - Target angle is the end position of rotor shaft where
the user desires the motor to stop.
Input File The spline is the input file (CSV) by the user which contains data as speed vs
time or angle vs time based on control method.
236 template_based_common
Modify Motor
Easy5
MATLAB
FMU
If User Defined is selected, the following options will be displayed:
General State Equation Name Enter the name of the GSE to be created.
External System Library Enter the name of the external system library. If the extension entered is .fmu,
Adams will expect an FMU that conforms to the FMI standard.
Import I/O Signals from Existing Select to display the Database Navigator, where you can select an existing
Controls Plant controls plant from which output and input signals are to be imported.
From Poutput (s) Select to display the Database Navigator, where you can select an existing
poutput from which to import output signals.
From Pinput (s) Select to display the Database Navigator, where you can select an existing
pinput from which to import input signals.
Static Hold Select one of the following:
Easy5
MATLAB
FMU
Use External Library Error Tolerance Check to apply the error tolerance values of the continuous states of ESL to the
GSE during integration. The ESL error tolerance values change the
computation of the local integration error that is computed after the corrector
as converged. If the estimated error is greater than the specified integration
ERROR the integrator rejects the solution. See the INTEGRATOR statement
for more details about ERROR. You may want to use this feature to help refine
the accuracy of your ESL states, but just like any INTEGRATOR setting, this
may require tuning. This feature only applies to the C++ Solver, and only
Easy5 models currently report error tolerance values.
Values > 0 will scale all of the ESL error tolerance values in order to tighten
or loosen these values, that is, Final GSE error tolerance = Error Scale
Factor * ESL error tolerance
Values <= 0 will disable using the ESL error tolerance values, and the
default computation for the local integration error will be used.
Information Check to display verbose information about the general state equation (GSE)
that the controls system import created.
Visibility This option is only available for External System Libraries of type FMU.
Visibility means the FMU runs in interactive mode. Turn it off if you want to
run it in batch mode. In order for this option to work in Adams, visibility
needs to be supported by the specified FMU.
Communication Interval This option is only available for External System Libraries of type FMU. To
co-simulation with the FMU you need to specify the communication interval.
Sample the FMU at least two times faster than the highest frequency of interest
(refer to Nyquist frequency).
If Co-Simulation is selected, the following options will be displayed:
238 template_based_common
Modify Motor
Scale Factor
Step Function
Expression
If Scale Factor is selected, the following options displayed:
Scale Factor To multiply the torque value by a constant or a variable.
If Step_Function is selected, the following options displayed:
Start Time Enter start time.
End Time Enter end time.
Start Value Enter start value.
End Value Enter end value.
If Expression is selected, the following options displayed:
Expression To scale the torque value within an expression.
Motor
Tools → Curve Manager
Modify a Motor Property File. Learn about Motor.
You can edit a motor's torque curve by entering a slope, or define any torque curve using a mathematical
formula or tabular data entry. See Modifying Curves.
The following table explains the default options that are common to both the plot and table Curve Manager
views. Learn about the Curve Manager.
242 template_based_common
Modify Orientation Dependencies
the vertical (y) values in terms of the horizontal (x) values. You can use only one
independent variable (x) to describe the functional relation. You can use any valid
FORTRAN mathematical operator, such as SIN, **2, and so on.
Modify Reboundstop
(Standard Interface) Right-click component → Modify Shared Dialog Box
Defines a reboundstop. Learn about Working with Reboundstops.
Select the "+" button to add a new property file to the list. Select the "-" button to
remove one or more property files from the list.
Clearance/ Select a method to specify when the reboundstop force activates:
Impact Length
Clearance - You specify the distance the I Coordinate Reference can travel towards
the J coordinate reference before the reboundstop force activates.
Impact Length - Specify how close the I coordinate reference can approach the J
coordinate reference before the reboundstop force activates.
Scale Factor Enter a scale factor to be applied to the force function. The default is 1.0.
Symmetric Enabled when you modify component pairs (or brothers):
Learn about:
Oilfilm Thickness Specify the oil film thickness of the contact force formulation.
Dialog Box - F1 Help 247
Modify Spline Gear Force
where:
Modify Spring
(Standard Interface) Right-click component → Modify Shared Dialog Box
Modifies a spring. Learn about Working with Springs.
Select the "+" button to add a new property file to the list. Select the "-" button to
remove one or more property files from the list.
Learn about:
Modify Strut
(Standard Interface) Right-click component → Modify Shared Dialog Box
Modifies the reference to the property file and, therefore, the strut characteristics associated with the damper
you selected.
Select the "+" button to add a new property file to the list. Select the "-" button to
remove one or more property files from the list.
Scale Factor Enter a scale factor to be applied to the force function, in the compression direction.
(comp) The default is 1.0.
Scale Factor (reb) Enter a scale factor to be applied to the force function, in the rebound direction. The
default is 1.0.
Symmetric Enabled when you modify component pairs (or brothers):
Learn about:
where:
Learn about:
Constant - enter a force value that will be applied during static and transient
analyses
Automatic-Fixed - enter the name of an existing ride height sensor. The
sensor will automatically control trim load during static equilibrium, then
hold trim load fixed during subsequent analyses.
Automatic-Variable - enter the name of an existing ride height sensor. The
sensor will automatically control trim load during static equilibrium, and
continue to adjust trim load during subsequent analyses as needed.
Symmetric Enabled when you modify component pairs (or brothers):
Learn about:
Swept Sine
Rotating Mass
PSD
User
Symmetric Enabled when you modify component pairs (or brothers):
Modify Wheel
(Standard Interface) Right-click component → Modify Shared Dialog Box
Defines a wheel. Learn about Wheels.
260 template_based_common
Modify Wheel
Select the "+" button to add a new property file to the list. Select the "-" button to
remove one or more property files from the list.
High Performance When selecting a PAC2002 tire property file, the High Performance mode allows the
model to run at a high speed with a slight reduced accuracy, see High Performance switch
in Adams Car.
Symmetric Enabled when you modify component pairs (or brothers):
Learn about:
New File
Tools → Curve Manager → File → New Shared Dialog Box
Creates a new property file in the Curve Manager. You can use that property file to define the dynamic
characteristics of components or to define a wheel envelope.
262 template_based_common
New Generic Assembly
Bushing
Frequency Bushing (if the Ride plugin is loaded)
Bumpstop
Reboundstop
Spring
Damper
Wheel Envelope
Differential
Note: You can open, modify, and save subsystems independent of any assemblies that reference them.
Therefore, when you open an assembly, the referenced subsystems may have changed since the
last time you saved the assembly.
To select a subsystem that is open in the current session, select . The icon
changes to and the text box is replaced by a pull-down menu from which
you can select a subsystem.
Dialog Box - F1 Help 263
New Subsystem
New Subsystem
(Standard Interface) File → New → Subsystem Shared Dialog Box
Creates a new subsystem based on an existing template.
To search/browse for a subsystem from the database, right-click the text box
next to .
To search/browse for a subsystem from the database, right-click the text box
next to .
- Right-click the text box and then search/browse for a subsystem from
the database.
- Right-click the text box and then select a subsystem open in the
current session.
Suspension Test Rig From the pull-down menu, select the Test Rig you want to use in your assembly.
Select to display a dialog box where you can add multi-line comments to any
entity, to describe its purpose and function. Your template-based product
displays different comments dialog boxes, depending on the entity type for
which you want to record comments:
New Template
(Template Builder) File → New Shared Dialog Box
Creates a new template.
After you create the new template, save it to a writable Database for use when you or others create subsystems.
266 template_based_common
Open Assembly
Open Assembly
(Standard Interface) File → Open → Assembly Shared Dialog Box
Opens an assembly in the current session.
Open File
Tools → Curve Manager → File → Open Shared Dialog Box
Opens a property file in the Curve Manager. Once you've opened the file, you can modify it as needed.
Dialog Box - F1 Help 267
Open Subsystem
Bushing
Bumpstop
Reboundstop
Spring
Damper
Wheel Envelope
File Specify the property file you want to open.
Open Subsystem
(Standard Interface) File → Open → Subsystem Shared Dialog Box
Opens a subsystem in the current session.
When you open a subsystem that specifies a flexible representation of a rigid part, your template-based
product replaces the equivalent rigid body from the template with the flexible body. Learn about Flexible
Bodies.
Open Template
(Template Builder) File → Open Shared Dialog Box
Opens a template in the current session.
When opening templates that contain flexible parts, your template-based product does not convert the parts
to rigid parts with flexible representations. Your must convert the parts manually. Learn about Flexible Bodies.
268 template_based_common
Orient About Axis
Note: Because hardpoints have no orientation, you cannot use them to define this type of orientation
dependency. Learn about Hardpoints.
You can parameterize the orientation offset. You can, for example, use a parameter
variable to define the orientation offset.
Example: (pvs_angle)
About Axis Select to apply the offset distance along either the x-, y-, or z-axis of the construction
frame.
Orient To Zpoint-Xpoint
Dialog boxes where you can set orientation dependencies Shared Dialog Box
Orients an entity in a plane defined by the entity's location and two other Coordinate References, with one of
the axes directed along a specified vector in the plane. The directed axis will point in the direction defined
from the entity's location to Coordinate Reference 1.
270 template_based_common
Orientation Input Communicator
ZX - The z-axis will be parallel to the vector defined from the entity to
Coordinate Reference 1.
XZ - The x-axis will be parallel to the vector defined from the entity to
Coordinate Reference 1.
Oriented In Plane
Dialog boxes where you can set orientation dependencies Shared Dialog Box
Orients an entity in a plane defined by the location of three Coordinate References, with one of the axes directed
along a specified vector in the plane. The three coordinate references define the plane; the directed axis will
point in the direction defined from Coordinate Reference 1 to Coordinate Reference 2.
Dialog Box - F1 Help 271
Adams Tire Data and Fitting Tool
Save Tire Database Save a Tire Database .xml file that contains the tires table as well as
references to measurement data files.
Save Tire Property Save tire parameters to a PAC2002 or PAC-MC tire property file for the
selected tire in the tires table.
Save Tire Property As Save tire parameters to a PAC2002 or PAC-MC tire property file as .tir
file.
Convert Tire Property to PAC Model Allows you to convert any Adams Tire property file towards a PAC2002
or PAC-MC tire property file, except for 5.2.1 tire and FTire.
Exit Close the Adams Tire Data and Fitting Tool
Edit
Deactivate Tire Property in Database Remove a selected tire from the tires table after after clicking 'Update
Database'.
Activate Tire Property in Database Remove the Deactivate status from a selected tire in the tires table.
Copy Selected Tire Property Copy the contents of a selected tire to a new tire in the tires table.
Settings
Plot Units… Tire characteristic units.
Optimization Settings Setting the options for the parameter optimizer.
Run
Tire Plot Plot tire characteristic.
Clear Tire Plot(s) Remove the tire characteristic from the embedded plot.
Embedded or
Adams PPT for plotting of the tire characteristics.
Measurement Data Select:
Yes: Use tire model input data from the measurement data files
and plot measurement data.
No: Use tire model input data as defined in Plot Parameters.
Slip Condition Select:
Note: Double click on the file name opens the file with an ascii
editor.
Import Tire Properties Imports properties of the tire as listed in the .tdx files, when all files have
consistent information.
Dominating Parameters These are the parameters that MUST be set before starting a fit process:
Learn more about the Adams Tire Data and Fitting Tool (TDFT).
Dialog Box - F1 Help 275
Adams Tire Data and Fitting Tool - Conversion Settings
Parallel To Axis
Dialog boxes where you can set orientation dependencies Shared Dialog Box
Orients an entity parallel to a chosen axis on a construction frame by making an axis on the chosen entity
dependent on an axis on the construction frame. Learn about Construction Frames.
Note: Because hardpoints have no orientation, you cannot use them to define this type of orientation
dependency. Learn about Hardpoints.
To determine the orientation of the other two entity axes, you use the two remaining construction frame axes.
Therefore, if you specify the entity's x-axis as parallel to the construction frame's - z-axis, the entity's y- and
z-axes would be oriented according to the right-hand-rule along the construction frame's x- or y-axes (in this
case, the entity's y-axis would be parallel to the construction frame's y-axis, and the entity's z-axis would be
parallel to the construction frame's x-axis).
Right-click component (or Create/Modify dialog boxes) → load .xml property file → select
Defines and modifies curves and other parameters for .xml bumpstop/reboundstop property files.
Properties tab
Dialog Box - F1 Help 281
Property File Editor (bumpstop/reboundstop)
Polynomial
Nonlinear
• Learn about the bumpstop force formulation.
• Learn about the reboundstop force formulation.
If you select Polynomial, your Adams product enables the following options:
Bumper Height Enter the bumper height.
Diameter Enter the bumper diameter.
Linear Rate Enter the bumper linear rate.
Quad Rate Enter the bumper quad rate.
Cubic Rate Enter the bumper cubic rate.
If you select Nonlinear, your Adams product enables the following options:
Bumper Height Same as above.
Diameter Same as above.
Damping Rate Enter the damping rate to calculate damping (viscous) forces.
Scale Factor Enter a scale factor.
Spline Data Select Plot/Edit Data to see the spline data.
Damping Method Select one of the following:
Linear
Nonlinear
Learn about the bumpstop force formulation.
Learn about the reboundstop force formulation.
If you select Linear, your Adams product enables the following option:
Damping Rate Enter the damping rate
If you select Nonlinear, your Adams product enables the following option:
Damping Data Select Plot/Edit Data to see the damping data.
Header tab
File Version Displays the file version.
Date Displays the date when the file was created.
Product Name Displays the name of the product.
Revision Comment Enter comments.
282 template_based_common
Property File Editor (bushing)
Right-click component (or Create/Modify dialog boxes) → load .xml property file → select
Defines and modifies curves and other parameters for .xml bushing property files.
Shape tab
Shape Select one of the following:
Right-click component (or Create/Modify dialog boxes) → load .xml property file → select
Defines and modifies curves and other parameters for .xml damper property files.
284 template_based_common
Property File Editor (spring)
Properties tab
Damping Method Select one of the following:
Right-click component (or Create/Modify dialog boxes) → load .xml property file → select
Defines and modifies curves and other parameters for .xml spring property files.
Dialog Box - F1 Help 285
Property File Editor (spring)
Properties tab
Method Select one of the following:
Note: Since the spring is not a part itself, and solely defines the force-
displacement relationship between two parts, changing the spring graphic
diameter does not translate into different spring properties.
Diameter Enter the diameter of the spring graphic.
Note: Since the spring is not a part itself, and solely defines the force-
displacement relationship between two parts, changing the spring graphic
diameter does not translate into different spring properties.
Free Length Enter the free length of the spring.
Linear Rate Enter the linear rate of the spring.
If you select Nonlinear, your Adams product enables the following options:
Number of Coils Enter the number of coils for the spring graphic.
Note: Since the spring is not a part itself, and solely defines the force-
displacement relationship between two parts, changing the spring graphic
diameter does not translate into different spring properties.
Diameter Enter the diameter of the spring graphic.
Note: Since the spring is not a part itself, and solely defines the force-
displacement relationship between two parts, changing the spring graphic
diameter does not translate into different spring properties.
Plot/Edit Data Select to see the spring data in the Curve Editor.
Length Select to use a force versus length table. The force is calculated as follows:
overwrite - Overwrites any files in the target database with the same file
names.
backup - Causes the file in the target database to be renamed before the
new file is copied into the database. When you back up a file like this, the
name of the new file will vary according to the operating system you are
using.
Target Database Select a writable database to which the assembly files will be published. To
access a writable database not on the pull-down menu, add the database to
the database list using the Add Database to Search dialog box.
Include Template Files Select it if you want to also copy the template file for each subsystem in the
assembly to the target database. Otherwise, your template-based product
only copies the assembly file (assembly_name.sub), subsystem files, and
property files to the target database.
Please note that those templates are simply copied from the source database,
not exported from the session data. As such, path data in the templates is not
updated even if the "Update Session Data …" toggle is active.
Update Session Data with Changes database references in the open assembly to match the target
'Target Database' alias database.
Create Database Opens the Create New Database dialog box.
Database Info Select to display a list of the search directories, including their search level,
database name, and database path.
overwrite - Overwrites any files in the target database with the same
file names.
backup - Causes the file in the target database to be renamed before
the new file is copied into the database. When you back up a file like
this, the name of the new file will vary according to the operating
system you are using.
Target Database Select a writable database to which the subsystem files will be published. To
access a writable database not on the pull-down menu, add the database to the
database list using the Add Database to Search dialog box.
Include Template Files Select it if you want to also copy the subsystem's template file to the target
database. Otherwise, your template-based product only copies the subsystem
file (subsystem_name.sub) and property files copied to the target database.
Please note that those templates are simply copied from the source database,
not exported from the session data. As such, path data in the templates is not
updated even if the "Update Session Data …" toggle is active.
Update Session Data with Changes database references in the open subsystem to match the target
'Target Database' alias database.
Create Database Opens the Create New Database dialog box.
Database Info Select to display a list of the search directories, including their search level,
database name, and database path.
Reboundstop
Tools → Curve Manager
Generates a reboundstop property file. Learn about Working with Reboundstops.
You can create a linear reboundstop by entering a slope (stiffness), or define a force-deflection characteristic
using a mathematical relation. You can also enter data in a spreadsheet and view and edit the corresponding
curve in the plotting window by dragging Hotpoints. Learn Modifying Curves.
The following table explains the default options that are common to both the plot and table Curve Manager
views. Learn about the Curve Manager.
potential gains in Adams Solver robustness, which can reduce Simulation times substantially for assemblies that
contain many interface parts. When you remove interface parts, any joints and forces attached to the interface
part are moved to the appropriate flexible body. Those joint or force markers on the flexible body will
automatically be associated to the closest node.
Learn about Interface Parts.
Remove Subsystem
(Standard Interface) File → Manage Assemblies → Remove Subsystem Shared Dialog Box
Removes a subsystem from the assembly to which it belongs. Learn more.
Remove Testrig
(Standard Interface) File → Manage Assemblies → Remove Testrig Shared Dialog Box
Removes a testrig from the assembly to which it belongs. Learn more.
Rename File
Tools → File Management → Rename Shared Dialog Box
Renames files either into the local directory where the session is running or into a file system location you
specify.
When specifying the file names, you can take advantage of the database alias naming conventions. Therefore,
if the <private> database is located at /usr/people/gabriel/[Link], then either of the following file name
specifications will work:
/usr/people/gabriel/[Link]/[Link]/[Link]
or
<private>/[Link]/[Link]
Example input:
Filename: /usr/people/gabriel/[Link]/[Link]/[Link]
New Filename: prototype_2000.tpl
If renaming to the old file's directory, the resultant file is
/usr/people/gabriel/[Link]/[Link]/prototype_2000.tpl
Notes: The renamed file name will always have the same extension as the old file name. If you
input a different extension for the new file name, your template-based product will always
modify it to correspond to the extension of the old file name.
The renaming process automatically overwrites any existing file at the new file name
location.
Rename Object
(Template Builder) Right-click component → Rename Shared Dialog Box
Renames an object.
Dialog Box - F1 Help 293
Reorder Custom Menus
Note: The name you enter corresponds to the name you would enter if creating a
new object, not the name the template-based product would generate. In
most cases, your template-based product will add a prefix to the name you
entered, to identify the entity type and symmetry characteristics.
For example, in Adams Car, a new single hardpoint you created with a name of
sub_frame will be stored internally with the name hps_sub_frame. (Learn about
Hardpoints). Therefore, if you want to rename the hardpoint from sub_frame to
subframe, you enter subframe in the New Name text box, not hps_subframe. Adams Car
ensures that the correct prefix continues to be used with the new name.
Only the specified instance - Replace just the component you chose.
All instances of same name - Replace all instances with the same name (will
typically convert both the left and right symmetrical pair).
All instances of same type - Replace all instance within the model. For example, if
you want to convert every nonlinear spring in your model to be linear, you would
select this option.
Replace Subsystem
(Standard Interface) File → Manage Assemblies → Replace Subsystem Shared Dialog Box
Replaces a subsystem in an assembly with a new subsystem. Learn more.
To select a subsystem that is open in the current session, select . The icon
changes to and the text box is replaced by a pull-down menu from which
you can select a subsystem.
Replace Testrig
(Standard Interface) File → Manage Assemblies → Replace Testrig Shared Dialog Box
Replaces a testrig in the selected assembly. Learn more.
Dialog Box - F1 Help 295
Reposition Assembly
Reposition Assembly
Tools → Model Reduction → Assembly Repositioning Shared Dialog Box
Move and/or rotate an entire assembly. If you are setting up your assembly for real time analysis and your road
file origin doesn't match your vehicle origin, you may wish to reposition the assembly instead of specifying a
road offset. The use of a road offset requires additional computation at each time step in order to calculate
the location of each tire with respect to the road surface. Repositioning the assembly to match the road origin
eliminates the need for these additional computations, resulting in faster run times. This process is generally
irreversible, so it should be performed immediately before submitting an analysis.
Note: Saving the repositioned assembly in ASCII or XML formats will not store the
location/orientation changes. If you wish to save the repositioned assembly in its new position,
save as binary format.
request name
components
major role
minor role
The sort can be done in ascending or descending order.
Edit Mode Select to switch the table list from read-only to edit mode (and vice versa).
In edit mode, you can add or remove request definitions from the table and
modify Components, Major and Minor Role attributes.
Filter by The table list can filtered by Major Role or Minor Role to reduce the number
of requests displayed.
New request map name Enter the name of the request map to be created in the selected model (if Apply
to Model is selected), or the name of the file to be exported (if Save to Request
Map File is selected).
Target Select Database or Directory, then select your desired location to write the file.
Info Display information on currently registered and active databases.
Apply to Model Applies the contents of the table to the selected model.
Save to Request Map File Saves a Request Map File to the selected database or directory containing the
request map definition as defined in the table. This operation will not change
the current model settings.
Empties the table (single-click) or reverts its contents to the default state upon
dialog display (that is, populated with the acf files in the current working
directory – via double-click)
Sorts the table in ascending (single-click) or descending (double-click) order
by the selected column.
If no or multiple rows are selected, no sorting will be performed.
Refreshes the content of the data table by updating columns 2-5 from the file
system and maximizes the width of the first column.
Dialog Box - F1 Help 299
Run Adams Command Files
object name
activity
matching name
object type
connect type
The sort can be done in ascending or descending order.
List of contacts Displays the contacts in the current assembly.
Attributes The read-only columns Active, Matching Name, Object Type and Connect Type
provide an overview of the current contact definitions.
Activate Selection Allows activating and de-activating individual or multiple contacts by selecting the
corresponding row(s) and hitting the appropriate button.
De-activate Selection
Use the <Ctrl> button to select multiple rows.
Save Assembly
(Standard Interface) File → Save As → Assembly Shared Dialog Box
Saves an assembly, and optionally renames it, to the selected database or directory. Use this dialog box to create
new assembly variants or update an existing variant's definition.
Dialog Box - F1 Help 301
Save Assembly
ASCII - Saves the file in the traditionally used format. See TeimOrbit File
Format.
Binary - Saves the file in binary format. Adams Car reads binary assembly
files much faster than ASCII assembly files. Learn about binary assemblies.
Learn about binary assemblies.
XML - Saves the file in an industry-standard data format. See XML File
Format.
Target Select either Database or Directory.
Database - The target database for the assembly. The menu lists all writable
databases.
Directory - Select a directory in which to write the assembly file.
Close assembly after Select if you want to close the assembly after saving it.
save
Include Parameter & By default, ASCII assembly files will include parameter variable and hardpoint
Hardpoint comments tables with comment lines. If you wish to turn off these comment lines, deselect
this toggle.
If you selected ASCII File Format, the following option is displayed:
302 template_based_common
Save File
Save File
Tools → Curve Manager → File → Save Shared Dialog Box
Saves a property file in the Curve Manager to the Default Writable Database.
Database - The target database for the assembly. The menu lists all writable
databases.
Directory - Select a directory in which to write the assembly file.
Notes: By default, File → Save will write the file to the default writable database.
If you already saved the property file, this dialog box will not appear, because there is no need
to specify the file name again. If you want to save the property file with a new name or in a
different database, use the Save File As option.
Dialog Box - F1 Help 303
Save File As
Save File As
Tools → Curve Manager → File → Save As Shared Dialog Box
Saves the current property file in the Curve Manager with a new file name.
Database - The target database for the assembly. The menu lists all writable
databases.
Directory - Select a directory in which to write the assembly file.
If this checkbox is unselected, all curves on any plot get written to the .plt file.
Thus, when importing that .plt file against multiple analyses each curve will
get re-generated for each analysis.
For example: a plot has three curves, the same quantity plotted three times
once per three different analyses. If "Collapse Multi-Run Plots" is selected,
then when the .plt file is imported to another session against three analyses
three curves will be generated. If "Collapse Multi-Run Plots" is not selected,
then when the .plt file is imported to another session against three analyses nine
curves will be generated.
Page Names Enter a list of pages you want to save.
Note: *To use plot or curve commands, you must create a macro that modifies your plots or curves
according to your needs.
Dialog Box - F1 Help 305
Save Subsystem
Save Subsystem
(Standard Interface) File → Save As → Subsystem Shared Dialog Box
Saves a subsystem, and optionally renames it, to the selected database or directory. Use this dialog box to create
new subsystem variants or update an existing variant's definition.
any
front
rear
trailer
File Format Select the file format to use when saving the new file to the target database:
TeimOrbit - Saves the file in the traditionally used format. See TeimOrbit
File Format.
XML - Saves the file in an industry-standard data format. See XML File
Format.
Target Select either Database or Directory.
Database - The target database for the subsystem. The menu lists all
writable databases.
Directory - Select a directory in which to write the subsystem file.
306 template_based_common
Save Subsystem
Save Template
(Template Builder) File → Save As Shared Dialog Box
Renames the template and then saves it to the Default Writable Database. Alternatively, you can keep the same
template name but change the major role or file format.
When saving a template that includes a flexible part, your template-based product saves the part as rigid.
If you do not specify a new name, your template-based product saves the
currently selected template with the same name, but with the major role and file
format selected.
Major Role Select a major role for the template.
308 template_based_common
Save Template
In some assemblies, you could use the same template twice (such as a suspension
template in Adams Car). In that case, if you assign a particular ID to the left lower
control in the suspension template, you end up with two parts (front-left-lower-
control-arm and rear-left-lower-control-arm) with the same Adams ID. To avoid
this problem, we provide the option to set the Adams IDs to zero.
Select to display a dialog box where you can add multi-line comments to any
entity, to describe its purpose and function. Your template-based product displays
different comments dialog boxes, depending on the entity type for which you
want to record comments:
Select Course
ISO Test
Moose Test
VDA Test
User Defined
Save Session
File → Save As → Session
Exports a snapshot of the current Adams Car or Driveline session to a binary session file (extension .bin).
This capability can be used to quickly save and later restore all data associated with the current session.
It's the Car equivalent of the View database file, and contains all models, analyses, plots, reports, plugins and
user interface (UDE definitions, menus, macros and dialog boxes) of the current session.
In addition to the View database file, currently registered Car databases (cdb) and event sets are also
supported.
Event sets are not stored in the binary, but written to a separate file in the same folder (same prefix, extension
xml), but only if events exists in your session.
Note: Due to the binary file format, and because it contains all user interface, the session file
should only be used within the same version of Adams Car. Also note that, the session
file can become huge (several GB), if many models, analyses and plugins are present
at the time of the save operation.
If turned off, analysis data will be retained in-session and included in the session file.
Including results data in the session (file) may exceed the maximum file size for binary
files (currently 2 GB).
Dialog Box - F1 Help 313
Set Default Writable Database
Note: The menu may not contain a complete listing of all databases in the
database search list, as there may be some which are read-only and thus
cannot be used as the default writable database.
Database Info Select to display a list of the search directories, including their search level, database
name, and database path.
Shift Subsystem
(Standard Interface) Adjust → Shift Shared Dialog Box
Shifts an entire subsystem along the x- and z-axes. Learn about subsystems.
Shift Template
(Template Builder) Build → Shift Template Shared Dialog Box
Shifts a template that is open.
Solver Selection
Settings → Solver → Selection Shared Dialog Box
Sets the version of Adams Solver that your template-based product will use to run simulations.
Default Adams Solver:
All template-based products - The FORTRAN (F77) version of Adams Solver is the default solver
for all template-based analyses. The C++ (CXX) version of Adams Solver is the planned replacement
for the Adams Solver (FORTRAN) in a future release, but is currently experimental.
If you select the CXX version, your results and analysis run times may vary from the FORTRAN
version. We've made the CXX solver available to you for your own experimentation.
The settings you choose using the dialog box apply only for the current session.
316 template_based_common
Solver Selection
Specify the number of parallel threads that Adams Solver (C++) uses when performing
the simulation. The number of threads, n, must be an integer in the range of 1 to 128.
The default value is 1. By executing multiple threads in parallel across multiple
processors, Adams Solver (C++) can reduce the walltime required for a simulation.
Typically, the optimal number of threads is between N and 2N, where N is the number
of processors (including virtual processors in the case of Pentium processors with
HyperThreading enabled).
All
Bushings
Springs
Dampers
Bumpstops
Reboundstops
Select one of the following options:
Database Select the name of the database you wish to scan for property files.
Assemblies Select one or more assemblies in session.
Subsystems Select one or more subsystems in session.
Elements Select one or more elements in session.
Symmetry Check Select this option to check for spline symmetry about the Origin specified.
Symmetry Repair Select this option to offset the spline data points to achieve symmetry about the Origin
specified.
Zero Crossing Select this option to check whether the spline curve passes through (0, 0).
Check
Zero Crossing Select this option to set the spline data points so that the curve passes through (0, 0).
Repair
Evenly Spaced Select this option to check whether the spline's X-data is evenly spaced. In some cases
Check even spacing may be desirable.
Evenly Spaced Select this option to resample the data using the specified method.
Repair
Settings Select this button to open the Evenly Spaced Repair options.
If you selected the Settings button, the following options appear:
Dialog Box - F1 Help 319
Spline Check and Repair
Min. Increment
No. of Points
Set Select this button to accept the options and return to the main dialog box.
If you selected No. of Points, the following option appears:
No. of Points Enter the number of data points you wish the modified spline to contain.
Minimum Slope Select this option to check whether the spline's slope is always equal to or greater than
Check the specified slope.
Minimum Slope Select this option to record which splines require repair. After the check operations, a
Repair "Repair Next" button will appear. Select this button to manually repair the spline data
in the Curve Manager or Property File Editor.
If Minimum Slope Check is NOT selected, the following options are available:
Monotonic Check Select this option to check whether the spline is monotonic.
Monotonic Repair Select this option to record which splines require repair. After the check operations, a
"Repair Next" button will appear. Select this button to manually repair the spline data
in the Curve Manager or Property File Editor.
Monotony of Select this option to checker whether the slope of the spline is monotonic.
Slope Check
Monotony of Select this option to attempt to repair the slope monotony by filtering the data.
Slope Repair
Modify Filter Select this button to set the filter parameters used when attempting to repair slope
monotony.
Comparison Plot Select this option to display the Spline Comparison before any automatic repair
operation. This gives you a chance to visually inspect the repair before accepting the
change.
Save Property Files Select this option to save the modified splines to property files in the default writable
database.
If you selected Save Property Files, the following option is available:
Backup Property When saving property files to the default writable database: if the property already
Files exists, it will be backed up.
320 template_based_common
Spline Comparison
Message Window
File
Both
If you selected File or Both:
File Enter the name of a file where the messages will be written.
Spline Comparison
(Standard Interface) Tools → Spline Comparison Shared Dialog Box
Creates an overly plot of two splines (2D or 3D). Spline data can be loaded in session or from property files.
This utility does not allow modification of the spline data.
Bushing
Spring
Damper
Bumpstop
Reboundstop
Select one of the following options:
Spline B Enter the name of an existing spline.
File B Select an existing property file. Supported file types (TeimOrbit and XML files):
Bushing
Spring
Damper
Bumpstop
Reboundstop
Dialog Box - F1 Help 321
Spline Comparison
AKISPL
CUBSPL
This is for visualization only - it has no effect on the spline used during the simulation.
If the Solver function that references your spline data uses the AKISPL function, then
you should choose AKISPL here to create a plot using the same spline fitting routine.
Recompute Select this button to recreate the plot using the Number of Points and Spline Type
chosen.
Transfer to Full Select this button to copy the current plot to Adams PostProcessor where you can save
Plot your plot and have it be accessible for such operations as creating reports. Note that
any changes you make to the plot in Adams PostProcessor are not reflected in the
actual spline object because you are editing the plot, not the spline data.
322 template_based_common
Spring
Spring
Tools → Curve Manager
Generates a spring property file. Learn about Working with Springs.
You can create a linear spring by entering a slope (stiffness), or define a nonlinear force-deflection
characteristic using a mathematical formula. You can also enter data in a spreadsheet and view and edit the
corresponding curve in the plotting window by dragging Hotpoints. See Modifying Curves.
The following table explains the default options that are common to both the plot and table Curve Manager
views. Learn about the Curve Manager.
Subsystem Info
(Standard Interface) File → Info → Subsystem Shared Dialog Box
Displays detailed information about subsystems in the current session.
Dialog Box - F1 Help 323
Switch & Remove Switch Parts
Synchronize Subsystem
(Standard Interface) File → Manage Subsystems → Synchronize Shared Dialog Box
Applies the values of the selected master subsystem to one or more subsystem instances. Learn more about
synchronizing subsystems.
Use the Shift or Ctrl keys or Select All to select multiple subsystems from
the table. These subsystems will inherit the values from the master
subsystem.
Test Communicators
(Template Builder) Build → Communicator → Test Shared Dialog Box
Tests how Communicators from different templates match.
Dialog Box - F1 Help 325
Toe/Camber
If a communicator has a minor role of inherit, which specifies that when the
template-based product creates a subsystem from the template, the communicator
should inherit the subsystem's minor role. Since when you test a template's
communicators, the inherit minor role is still undefined, entering minor roles in
the Minor Role text box provides the communicators with their minor role.
In Adams Car for example, if you assign the template susp_02, a minor role of
front in the Minor Roles text box, the communicator test also changes the minor
role of any communicators in susp_02 whose minor role is inherit to the role of
front.
Clear Information Select if your template-based product should clear the Information window of any
Window current information before displaying the communicator information.
Save Test Results to Select if your template-based product should send the test results to a text file.
File
If you set Save Test Results to File, your template-based product enables the following option:
File Name Enter the name of the text file that will contain the results displayed in the
Information window.
Toe/Camber
Dialog boxes where you can set orientation dependencies Shared Dialog Box
Sets the Toe and Camber orientation.
Parameter Variables
Input Communicators
If you set Variable Type to Parameter Variables, your template-based product displays the following options:
326 template_based_common
Toggle Kinematic Mode
Kinematic
Compliant
Update Assembly
(Standard Interface) File → Manage Assemblies →Update Assembly Shared Dialog Box
Re-reads an assembly file, in case you modified the file by an alternative process. For example, if you edit in a
text editor an assembly file stored in the shared database, you can reflect this change in your template-based
product by using the update assembly functionality.
Update Instance(s)
Updates more than one instance at one time. All instances updated must be of the same type.
You don't have to specify the instance given in the Instance Name text box, as
this is already part of the updates.
Update Subsystem
(Standard Interface) File → Manage Subsystems → Update Shared Dialog Box
Resets the values of a subsystem to those stored in a subsystem file. You can update a subsystem using any
subsystem file that is based on the same template as the subsystem in session.
If you do not specify a subsystem file, your template-based product updates the
subsystem from the original subsystem file referenced when you opened the
subsystem.
Entity Type Select the type of entity you wish to update. You can choose either a single entity type
(for example, hardpoints) or "all".
User-entered Location
Dialog boxes where you can set location dependencies Shared Dialog Box
Euler Angles - Allows for rotation according to the body313 method, or z-x'-z'.
Direction Vectors - Specifies the directions of the x- and z-axes, with the y-axis
determined according to the right-hand-rule.
If you select Euler Angles, your template-based product enables the following option:
Euler Angles Enter the three Euler angle rotations to be used.
If you select X Vector/Z Vector, your template-based product enables the following options:
X Vector Enter the three real values representing the vector direction of the x-axis.
Z Vector Enter the three real values representing the vector direction of the z-axis.
Dialog Box - F1 Help 331
ViewFlex
ViewFlex
Dialog boxes where you can set orientation dependencies Shared Dialog Box
Transforms a rigid part to an MNF-based flexible body using embedded finite element analysis where a
meshing step and linear modes analysis will be performed.
Manual Replace = Off : Viewflex will automatically replace the part with flexible
body by transferring all connections from rigid body to flexible body. This will
deactivate the rigid part and make it invisible.
Manual Replace = On: Viewflex will not automatically replace the part and both
rigid and flexible body will be shown. You need to manually create the
connections on the flexible body.
Advanced Settings
This will allows you to control the details of creating the flexible body.
332 template_based_common
ViewFlex
Interpolation
Linear: Linear interpolation
Cubic: Cubic interpolation (may require more than two reference markers to capture
curvature events).
• The Auto Align option enabled.
None: No interpolation is used
Pick/Browse Coord Reference: Select the coordinate system for which, if available, the
orientation appears in the data table.
View Centerline Geometry: This will allow you to view the centerline geometry.
For more details see section Defining the Centerline.
Dialog Box - F1 Help 333
ViewFlex
Section Type
Elliptical: You provided with the options for defining an ellipse.
Generic: You provided with the options for defining a generic section.
For more details see section Modeling the Section.
Mesh/Properties Displays the general material and mesh properties.
Element Type: Indicates what type of elements are to be generated. Available options are point,
line, area or volume elements.
Solid: Creates solid elements.
Shell: Creates shell elements.
Element Shape
Tetrahedral - Creates tetrahedral solid elements. Card: CTETRA. Linear: CTETRA4,
Quadratic: CTETRA10
The following Element shapes appear when Shell Element Type is selected
Triangle - Creates triangular shell elements. Card: CTRIA. Linear: CTRIA3, Quadratic:
CTRIA6
Quadrilateral - Creates quadrilateral shell elements. Card: CQUAD Linear: CQUAD4,
Quadratic: CQUAD8
Element Order: Indicates what order of elements are to be generated. Available options are
linear, quadratic and cubic. The specified element order must be compatible with the element
order used in previously meshed adjacent regions.
Linear: Sets linear element order for first-order elements
Quadratic: Sets quadratic for second-order elements.
Element Specification
Auto: Uses an automatic scale factor to determine the element size based on the selected
part's dimensions.
Size: After entering the average edge length of the element, ViewFlex asks you to input the
element's median and minimum side size (using automatic mesh refining, where required
by the geometry to mesh).
Edge Shape: Indicates whether higher order element should be generated with straight or
curved boundary edges.
Straight: All mid-side nodes will be positioned at the average coordinate of the end nodes.
Curved: Mid-side nodes on boundary geometry will be projected onto the geometry
resulting in curved element edges.
Mixed: Edges will be curved except when such curving would result in an invalid element
(negative Jacobian).
Element Size: Enter the average edge length of the element. This option will be available upon
selecting “Size” from Element Specification options.
Dialog Box - F1 Help 335
ViewFlex
Where:
P: a point on surface, Circle: the osculating circle, C: a curve on a surface, O: the center of
osculating circle, r: the radius of the osculating circle which = 1.0/mpc, where mpc is the max
principle curvature at point P.
Blue line segment E: An element-edge in the neighborhood of P.
Yellow line segment: Connecting an end point of the E to the center of osculating circle
The subtended angle of element-edge E is the angle formed by two yellow-line-segments. It is
controlled by angle-per-element
Dialog Box - F1 Help 337
ViewFlex
Selection Type
Node IDs
• Pick Nodes
• Transfer IDs
Spherical
• Radius
• Transfer IDs
Cylindrical
• Radius
• End Location
• Symmetric
• Transfer IDs
Closest nodes
• Number of nodes
• Transfer IDs
Solid feature
• Vertex
• Edge
• Surface
• Pick
• View part only
Rigid Body Element (RBE) connected by attachment nodes can be previewed by clicking on RBE
toggle button and Mesh Preview can be hidden by clicking off Mesh toggle button.
Show/Hide
Mesh
RBE
See section Defining Attachment Points in Existing Solid Geometry for information.
Mesh Preview Select to preview a mesh of the selected geometry. For more details see Creating Flexible Bodies from
Existing Solid Geometry.
Dialog Box - F1 Help 339
Wheel Envelope
Wheel Envelope
Tools → Curve Manager
Generates a Wheel-Envelope Property File.
A wheel-envelope-input curve defines the boundaries of the vertical and steering travel used to compute a
wheel envelope. During a wheel-envelope Analysis, Adams Car overlays the wheel-envelope-input curve with
a grid and computes the position and orientation of the wheels at each point on the wheel-envelope curve.
The following table explains the default options that are common to both the plot and table Curve Manager
views. For information on the options specific to each view, see Curve Manager Plot View or Curve Manager Table
View.
340 template_based_common
Wheel Envelope
Note: The grid sizes and number of curve points determines the number of output points in the
wheel-envelope analysis. Choosing small grid sizes increases the number of output points,
which in turn increases solution times and output file sizes.
Appendix
.acf File
An .acf file is a command script that controls a Simulation, including which files to read, the number of Analysis
frames, end time, and other simulation parameters.
.adm File
An .adm file describes a model using Adams Solver Data Language (ADL) statements.
.nam File
A name file (.nam) allows you to create requests with meaningful result set component names. When you
read into the interface a request file, your template-based product renames the results and result set
components based on the information it found in the .nam file.
torque - Resulting torque applied at the first gear. The gear force icon is positioned at the center of
the first gear.
ASCII
American Standard Code for Information Interchange (ASCII) is a human-readable character format.
Adams IDs
Adams IDs are numbers that identify an entity in the Adams Solver Dataset (.adm) file.
Adams Solver
Adams Solver is a powerful numerical Analysis application that automatically solves the equations of motion
for the following types of analyses:
Kinematic Analysis
Static Analysis
Quasi-static
Dynamic Analysis
Your template-based product uses Adams Solver to analyze the assemblies you create.
Learn more about Adams Solver at:
Welcome to the C++ Version of Adams Solver
Welcome to the FORTRAN Version of Adams Solver
Analysis
An analysis is an Adams Solver Simulation and its corresponding results.
Animation
Allows you to replay the frames from your Simulation, and helps you review and study the part movements
within your model.
Appendix 3
Array
Array
A list of input variables, state variables, output variables, and initial conditions associated with System
elements, such as general state equations, linear state equations, and transfer functions. You can also use
general arrays to define lists of constants. You can access the values in function Expressions or User-written
subroutines.
Assembly Class
The assembly class determines the list of available test rigs. For example, in Adams Car, selecting full-vehicle
prompts Adams Car to load full-vehicle test rigs in the Test Rig option menu.
Attribute
Attributes are single line entries listed after a data block. For example, PART_ASSEMBLY is a data block and
MASS is an attribute.
$--------------------------PART_ASSEMBLY
[PART_ASSEMBLY]
USAGE = 'chassis'
MASS = 995.0
Contact Friction
Cam
A cam consists of one part constrained with a fixed joint. It contains a BSPLINE, which is used for contacts.
The component outputs the result: joint_force, which is the force magnitude in the fixed joint.
Command Window
A window that lets you enter commands directly instead of using menus. The commands correspond to menu
selections and the parameters correspond to dialog box choices. You can either enter the full command or an
abbreviation to the command.
To display the command window, press the F3 key.
Comprehensive Help
This is the comprehensive help for this component. Therefore, if you accessed this dialog box from the
Standard Interface, you will find that some of the options explained here are not part of your dialog box.
Contact Force
The contact force between two parts is defined by a modified impact function for a penetration larger than
zero. The force is zero when there is no penetration. The modified impact function uses a scale factor while
the standard impact function doesn't.
where:
s = Scale Factor
k = Stiffness
e = Exponent
p = Penetration
v = Velocity
c = Effective damping coefficient with a value of Damping, cmax, for a penetration larger than
Penetration Depth, d, as shown next.
6 Template based
Contact Force
Impact Damping
You can design your contact force law by changing stiffness, exponent, and scale factor. Figure Impact Stiffness
shows the influence of scale factor and stiffness on the stiffness force. The graph shows three different
examples with scale factor s2 much larger than s1 and stiffness k2 much larger than k1. The exponent is the
same for all three examples, and is larger than 1. Figure Impact Exponent shows the influence of the exponent,
e. Note that for penetration p=s, the impact force is independent of the exponent.
Using a scale factor also ensures that the stiffness-force function is independent of the units. The next example
illustrates the influence of the scale factor with respect to units. The force function is independent of the
length unit when using the modified impact function as shown in figure Impact Scale Factor. When the
standard impact function is used, the force function is dependent on the unit of length, as shown in figure
Unit-Sensitive Impact; curve A is for [mm] and curve B is for [m].
Appendix 7
Contact Force Formulation Based on Oilfilm Thickness Theory
Coordinate Reference
A coordinate reference is a component that can serve as the basic building block in building other
components. You can use two types of coordinate references:
Hardpoint
Construction frame
Appendix 9
Curve Math Operations
so on. To access the curve math tools, right-click the Linear Slope tool (the default).
Defines a ramp function that can be used to represent data of a ramp nature. The ramp function is very
similar to the step function; the only difference being in the shape of the curve between minimum and
maximum y values.
Scales the y-axis values of a curve. If you have a y value of 100 mm and a scale value of 2, then your new y-
axis will be 200 mm.
Specifies the minimum and maximum values for the x-axis. This is the same as specifying axis limits on a plot
page.
Shifts all y values in a curve by a set amount. Your template-based product adds the offset value to each y
point in the curve.
Defines a step function that can be used to represent data of a step-type nature. The step function is very
similar to the ramp function; the only difference being in the shape of the curve between minimum and
maximum y values. See Plot for Step Function.
Cylinder Head
Adams Engine displays the following pull-down menu when the major role of the template is cylinder_head.
Database
Two elements define a database:
Database name - Internal reference used when accessing the contents of the database.
Database path - File system location of the database directory.
A session in your template-based product requires one or more databases which can function as either
read/write or read-only repositories. In addition to the databases defined in the configuration files and
accessed at start-up, during a session, you can add an existing database to those currently in use.
One of the databases must function as the Default Writable Database.
At start-up, your template-based product stores databases defined in the configuration files and existing on
the file system in the database list, a mechanism internal to your template-based product, which maintains
information for use during the session.
Appendix 15
Dataset
Dataset
A dataset is a model described with Adams Solver data language statements. Datasets are stored in .adm files.
Degrees of Freedom
Degrees of freedom (DOF) are a measure of how components can move relative to one another in a model.
A body free in space has six DOF in which it can move: three translational and three rotational. Each DOF
corresponds to at least one equation of motion.
When you add a constraint, such as a revolute joint, between two components, you remove DOF between
the components, causing them to remain positioned with respect to one another regardless of any motion or
force in the model. Each constraint removes different DOF.
Differential Equation
A differential equation is a user-defined state variable.
Dynamic Analysis
A dynamic analysis provides a time-history solution for all displacements, velocities, accelerations, and
internal reaction forces in your model driven by a set of external forces and excitations. A dynamic analysis is
also known as a kinetic analysis.
During a dynamic Simulation, Adams Solver solves the full set of nonlinear differential and algebraic equations
(DAEs). You use dynamic analyses with models that have one or more Degrees of Freedom (DOF).
Dyno
A dyno contains a rotational SFORCE and a rotational MOTION. Depending on the mode of the dyno, the
force and the motion are active or deactivated. The two dyno modes are:
Torque mode - Dyno is modeled with a rotational SFORCE. The rotational MOTION is
deactivated.
Motion mode - Dyno is modeled with a rotational MOTION on markers. (Learn about Markers.)
The rotational SFORCE is deactivated.
You can give the input function to the dyno as a:
Harmonic series, specified in a property file or as user-entered values
Constant value
16 Template based
Entering File Names in Text Boxes
Note: Adams Driveline checks to see if you have two communicators that it must use to
exchange information with the test rig: cis_torque_demand and cis_throttle_demand.
If it doesn't find them, they will be automatically created. These communicators allow
you to get values from the test rig for the throttle signal and the engine torque signal.
You use dynos in a Test Rig to drive your system or to define resistance torques.
The dyno outputs the following results:
angle - Angular displacement in motion or SFORCE
angular_velocity - Angular velocity in motion or SFORCE
angular_acceleration - Angular acceleration in motion or SFORCE
torque - Resulting torque in motion or SFORCE
Fit
Fit the entire extent of all plot curves on the plot.
Appendix 19
Function Type: Constant
If RPM Smoothing is selected, the WZ function above is replaced with a moving average of the angular
velocity:
(Crank angle - delay(crank angle, delta_time) - 0.001) / (time -
delay(time, delta_time, -0.001))
Note that because of the DELAY function, RPM Smoothing can only be used with Adams Solver (C++).
If the Dyno Type is Motion - Velocity, the velocity function is a cubic spline function:
direction * CUBSPL( MOD( velocity * time + angle_offset, 720d),
velocity_offset, spline)
where, velocity is ABS(velocity_offset).
Note that the Initial Ramp Up and RPM Smoothing are not applicable for Motion - Velocity dynos.
Property File - Adams Engine takes the values for the Fourier
Sine series from a property file.
User-Entered - Enter the values for the Fourier Sine series.
If you set Input Type to Property File, Adams Engine displays the following options:
Harmonic Series File Specify the property file that contains the function series data for the
dyno. The file contains the information needed to specify a Fourier Sine
series (mean value, order numbers, magnitudes, phase shift values, and
an angle multiplier).
When you specify a file name, Adams Engine displays the database path
that it will use to save the file. Adams Engine always saves a file in the
default writable database.
Mean Value Enter the mean value of the Fourier Series.
Order, Magnitude & Phase Shift Select to display the curve editor, where you can specity the order
number, magnitude, and phase.
Order Number Enter the order numbers that should be used in the Fourier Series.
Magnitude Enter the magnitude for each order of the Fourier Series. The number
of entries should match the number of entries in the Order Number
text box.
Phase Shift Enter the phase shift for each order of the Fourier Series. The number
of entries should match the number of entries in the Order Number
text box.
Angle Multiplier This number is multiplied to the angle-measurement variable, and will
therefore scale the angle input to the function. For example: If you
measured the torque at the alternator pulley versus crankshaft angle,
you must enter the ratio between the pulley pitch diameters.
Direction Specify if the function should work clockwise or counterclockwise
around the z-axis of the dyno.
Appendix 23
Function Type: Throttle Demand
Gear
A gear can be either straight or helical. It consists of one part constrained with either a fixed or revolute joint.
Optionally, you can use a torsional spring-damper SFORCE in parallel with the revolute joint. You can
connect two gears with a three-phase gear force element.
24 Template based
Gear Property File
ADDENDUM_MOD_COEFF = 0.0
ADDENDUM_FACTOR = 1.0
DEDENDUM_FACTOR = 1.25
HELIX_ANGLE = 0.0
MASS = 2.135099001
CM_LOCATION_FROM_PART_X = 0.0
CM_LOCATION_FROM_PART_Y = 0.0
CM_LOCATION_FROM_PART_Z = 0.0
IXX = 2396.292778791
IYY = 2396.292778791
IZZ = 4650.2456241819
IXY = 0.0
IZX = 0.0
IYZ = 0.0
$-------------------------------------------TORSIONAL_SPRING
[TORSIONAL_SPRING]
TORSIONAL_STIFFNESS = 200.0
TORSIONAL_DAMPING = 20.0
Copyright © 2002, FEV Motorentechnik GmbH. All rights reserved.
Generating a Subsystem
In this example from Adams Car, you could use a subsystem file to transform the left-hand-drive vehicle to a
right-hand-drive vehicle by modifying the hardpoint locations at each point in the steering column.
26 Template based
Generic
Generating a Subsystem
Generic
Adams Engine displays the following pull-down menu when the major role of a template is not
single_valve_train, cam_shaft, cylinder_head, or timing_mechanism; for example, if it is a component template.
Learn about Building Models.
Note that for each major role, Adams Engine allows only one subsystem in an assembly
with the minor role any.
Appendix 27
Hotpoints
Hotpoints
Small squares that appear on geometric elements and plot Curve when selected.
Installed Length
When you select the install method Installed Length, you directly specify what the length of the spring is for
the given design positions of the I and J coordinate references.
Interactive Simulation
A simulation that uses the external Adams Solver.
Kinematic Analysis
A kinematic analysis uses constraints, such as translational and revolute joints, to define the attachments
between the parts.
28 Template based
List of Variable Values for MDI_ACAR_ANL_LOG*
A kinematic analysis enables you to determine the range of values for the displacement, velocity, and
acceleration of any point of interest in the model, independent of forces applied to it. During a kinematic
Simulation, Adams Solver solves only the reduced set of algebraic equations. This type of analysis, therefore, is
only available for models with zero Degrees of Freedom.
If you specify the mass and inertia properties of bodies in your model, a kinematic analysis also calculates the
corresponding applied and reaction forces required to generate the prescribed motions.
Main Window
Your product's window in which you build and simulate assemblies.
Memory
Toggle the visibility of the memory curve of the current data curve.
Modifying Curves
You can modify a curve by:
Selecting the Vertical Hotpoints tool and then dragging the hotpoints to the desired location on
the force-displacement plane. Modifying a curve by dragging hotpoints might be a good solution for
initial studies.
Entering horizontal and vertical data in tabular form. To enter data in tabular form, you must switch
to the Table Editor: View -> Table. In the Table Editor, you can enter a set of vertical and
horizontal values.
Entering a slope for a linear curve by filling in the options described for each type of component.
3. Select OK.
4. Select Try to Execute in response to the message you receive.
See Example Dialog Box.
Output Steps
The number of output steps represents the resolution of the Analysis results. For example, if you run a 10-
second analysis with 100 output steps, you would expect to see 10 data points per second. This is equivalent
to sampling data at 10 Hz and the spacing between the points being 100 ms.
To achieve greater granularity of data, you should increase the number of output steps. You would typically
do this to capture a specific event, such as the impact of a timing chain with a gear. The higher the output
step size, the larger the output file and memory use.
Output Steps Example for Adams Car.
PSD
The vibration actuator PSD is defined using a spline function. You can specify either a force PSD or a
displacement PSD. For the displacement PSD, you can also specify a corresponding stiffness. It is assumed
that the PSD inputs applied to the linear model are not correlated to one another.
Appendix 31
Plot for Step Function
Note that you cannot combine vibration actuators of the non-PSD type with PSD-type vibration actuators
in the same vibration Analysis.
Preload
The spring force definition depends on the type of spring and the installation method. Springs may be
defined as either linear or nonlinear, and the installation methods vary accordingly.
dmCalc is the distance magnitude between the I and the J coordinates at the design configuration.
Product Abbreviations
The product abbreviations are:
To display the Property File Editor, select when modifying an XML-based property file.
You can open bushing, spring, bumpstops, reboundstop, and damper XML-based property files. Example
XML property files are distributed in the acar_shared database.
Push Button
Push buttons contain entries or execute commands only for those entities that exist in the template. Your
template-based product adds push buttons to the template's custom interface. Learn about Customizing Your
Product.
34 Template based
Recording Comments
You can place the custom push buttons under the Adjust menu in the Standard Interface, or under previously
created custom menus by selecting the desired parent menu. Learn about the Standard Interface.
Recording Comments
Your template-based product records the comments as follows:
Reference Marker
A reference marker is a marker that defines the location and orientation of a component.
Rotating Mass
A rotating mass applies a frequency-dependent force. This actuator represents the force due to a rotating mass
located at a specified offset from an axis of rotation. The axis of rotation is defined by the input channel to
which this vibrational actuator is applied.
2
f(ω) = m ⋅ ω ⋅ r
where:
ω is the frequency
f ( ω ) is the unbalanced mass forcing function
m is the unbalanced mass
r is the radial distance of the unbalanced mass from the axis of rotation
Similarly, a rotating mass placed at a distance offset along the axis of rotation results in an unbalanced
moment.
2
t(ω) = m ⋅ ω ⋅ r ⋅ d
Appendix 35
Shared Dialog Box
where:
Simulation
A simulation is the real-time Adams Solver process of solving the equations of motions for a multibody system.
Simulation Script
Your template-based product automatically creates a simulation script when you run a Simulation. The
simulation script is different for different types of analyses (see Analysis).
By default, the last simulation that you ran creates a simulation script named Last_Sim, which you should
not use. Use the simulation named simulation_script.
Single Valvetrain
Adams Engine displays the following pull-down menus when the major role of the template is
single_valve_train.
Single-Component Force
A single-component force applies a translational vector force at a single point of application on a part and
ground (action-only force), or between two parts along the line of sight.
Solution Steps
The number of solution steps defines the granularity of the results. This is equivalent to running a test in the
real world and monitoring the changes of a system at fixed time intervals. The number of steps is the number
of solution steps from a lower bound to an upper bound.
36 Template based
Solver Variable
Solver Variable
A solver variable is a data element algebraic variable.
Spline
A spline is a data element that is defined by discrete numerical data.
Symmetry
When this check is performed, the spline(s) will be examined for symmetry about the specified origin, where
the default is (0, 0). If asymmetry is detected and the repair option is selected, the quadrant with the greater
number of values will be mirrored to the quadrant having the smaller number.
Zero Crossing
This checks whether the curve passes through the origin (0, 0). This is useful, for example, because a spring
or damping curve that does not pass through (0, 0) has the effect of a preload force. If the curve fails this
Appendix 37
Spline Comparison
check and the repair option is selected, then a (0, 0) point is added, unless there is a (0, Y) data point, in
which case the Y value is set to 0.
Minimum Slope
This checks whether a minimum slope value is maintained. One can hereby detect constant values of the Y-
axis. If the curve fails this check and the repair option is selected, then the user will be warned and prompted
to manually modify the spline manually. If the Minimum Slope check is selected, the following monotony
checks are not available, since they are guaranteed to pass if the spline meets the minimum slope criterion.
Curve Monotony
This check is intended to ensure a monotonically consistent (always increasing or decreasing) curve. This is
useful, for example, because a damping curve with an inconsistent slope may lead to a self-exciting system. If
the curve fails this check and the repair option is selected, then the user is warned and prompted to repair this
manually.
Slope Monotony
This check is performed on the spline derivative. It is intended to ensure a monotonically consistent (always
increasing or decreasing) slope. If the curve fails this check and the repair option is selected, then a user-
specified filter will be applied to the spline in attempt to smooth the data.
In the Standard Interface, to use the Spline Check and Repair tool:
1. From the Tools menu, select Spline Check/Repair.
2. Press F1 and then follow the instructions in the dialog help for Spline Check and Repair.
3. Select OK.
Spline Comparison
The Spline Comparison tool allows you to plot data element splines loaded in session or from property files.
You can select two splines to plot simultaneously, and view the data in plot form, tabular form, or both. When
selecting a spline loaded in session, you may select any 2D or 3D spline. When selecting a spline from a
property file, you can only select property files pertaining to the following components:
Bushings
38 Template based
Spline Gear Force
Springs
Dampers
Bumpstops
Reboundstops
Note: The Spline Comparison dialog box does not allow you to edit the spline data. To edit the data,
use the Curve Manager or Property File Editor.
Static Analysis
A static analysis attempts to find a configuration for the parts in your model for which all the forces balance.
This configuration is often referred to as an equilibrium configuration. Velocities and accelerations are set to
zero for static analyses, so inertial forces are not taken into consideration. A static analysis is for use with
models that have one or more Degrees of Freedom.
Status Bar
A line at the bottom of the Main Window that displays information about the element your cursor is currently
on, the action you should perform, or an error message.
Swept Sine
Swept sine defines a constant amplitude sine function being applied to the model. The amplitude of the sine
function and the starting phase angle are required.
f( ) = F . [cos( ) + j . sin( )]
where:
f - Forcing function
F - Magnitude of the force
- Phase angle
- Frequency
Appendix 41
Switch Part Example for Adams Car
Target Database
A target Database is a writable database to which the assembly files will be published.
Test Rig
A test rig is a model designed to control an Analysis.
Note that creating your own test rig is not a trivial task, and should only be done by the very experienced user.
Timing Mechanism
Adams Engine displays the following pull-down menu when the major role of the template is
timing_mechanism. Learn about Building Models.
pointless. Typically we are either interested in the motion of the mechanism (Kinematic Analysis) or the
compliance of the system (compliant analysis).
Toggle Visibility
Toggle visibility of hotpoints for current data curve.
Types of Joints
You can use several types of joints, as follows:
None
Using Two Axes
If you set Orientation to Using Two Axes, your template-based product enables the following options:
I-Part Axis Enter a Coordinate Reference to define the direction of the I-part axis, which will be
from the location coordinate reference to the coordinate reference you enter in this
field.
J-Part Axis Enter a Coordinate Reference to define the direction of the J-part axis, which will be
from the location coordinate reference to the coordinate reference you enter in this
field.
Notes: For perpendicular joints it is recommended that I-part construction frame Z-axis and J-part
construction frame Z-axis be perpendicular to each other.
Hooke and Universal joints represent the same idealized constraint. The difference is how the
axes of the joint are defined:
For a Hooke joint (as well as a Convel, or constant velocity joint), choose Coordinate
References that are offset from the location reference, along the spin axes of the I and J parts.
For a Universal joint, choose Coordinate References that are offset from the location reference,
along two vectors orthogonal to the spin axes of the I and J parts. Note that the Universal joint
icon may not appear as pictured above, but the joint will constrain the proper DOF if set up
correctly.
Use Hardpoints
When you select the install method Installed Length, you directly specify what the length of the spring is for
the given design positions of the I and J coordinate references.
Appendix 47
Use Hardpoints
Note: When you look at the ac_spring UDE definition in the Database Navigator, you will notice
an OffsetCalc variable. In the equation above, OffsetCalc = Free_Length.
User
You can define any function of the independent variable omega:
f( ) = g( )
where:
is the frequency
g( ) is the general function of omega
Being able to create your own function based on standard Adams functions is very useful when the required
function is not provided by Swept Sine, Rotating Mass, or PSD.
Vertical Hotpoints
Hotpoints are small squares that appear on plot curves when selected. You can modify the loaded curve by
dragging its hotpoints vertically.
Note in some of .xml files such as bushing property files each individual spline curve may also have a unit tag
such as "xUnit" and "yUnit". These tags are used for the labels in the Curve Editor, but are not used for any
conversion in Adams Car.
Zoom In
Zoom in on an area of a displayed plot by using your pointer to draw a box.