Engineering Data Users Guide
Engineering Data Users Guide
ANSYS, Inc.
Southpointe
2600 ANSYS Drive
Canonsburg, PA 15317
[email protected]
http://www.ansys.com
(T) 724-746-3304
(F) 724-514-9494
Release 17.0
January 2016
ANSYS, Inc. is
certified to ISO
9001:2008.
Disclaimer Notice
THIS ANSYS SOFTWARE PRODUCT AND PROGRAM DOCUMENTATION INCLUDE TRADE SECRETS AND ARE CONFIDENTIAL AND PROPRIETARY PRODUCTS OF ANSYS, INC., ITS SUBSIDIARIES, OR LICENSORS. The software products
and documentation are furnished by ANSYS, Inc., its subsidiaries, or affiliates under a software license agreement
that contains provisions concerning non-disclosure, copying, length and nature of use, compliance with exporting
laws, warranties, disclaimers, limitations of liability, and remedies, and other provisions. The software products
and documentation may be used, disclosed, transferred, or copied only in accordance with the terms and conditions
of that software license agreement.
ANSYS, Inc. is certified to ISO 9001:2008.
Third-Party Software
See the legal information in the product help files for the complete Legal Notice for ANSYS proprietary software
and third-party software. If you are unable to access the Legal Notice, Contact ANSYS, Inc.
Published in the U.S.A.
Table of Contents
Basics of Engineering Data ......................................................................................................................... 1
Overview ............................................................................................................................................... 1
User Interface ......................................................................................................................................... 2
Menu Bar ......................................................................................................................................... 3
Toolbar ............................................................................................................................................. 4
Toolbox ............................................................................................................................................ 4
Engineering Data Sources Pane ......................................................................................................... 4
Outline Pane .................................................................................................................................... 5
Properties Pane ................................................................................................................................ 8
Table Pane ........................................................................................................................................ 9
Chart Pane ..................................................................................................................................... 12
Working with Data Sources ................................................................................................................... 12
Working with Data ................................................................................................................................ 13
Perform Basic Tasks in Engineering Data ................................................................................................ 15
Perform Advanced Tasks in Engineering Data ........................................................................................ 16
Material Data ............................................................................................................................................ 19
Definitions ........................................................................................................................................... 19
Sample Libraries ................................................................................................................................... 19
Default Material Assignment for Model Parts ......................................................................................... 20
Supported Properties ........................................................................................................................... 20
Electric ........................................................................................................................................... 21
Explicit Dynamics ........................................................................................................................... 21
Harmonic ....................................................................................................................................... 22
Linear Buckling .............................................................................................................................. 22
Magnetostatic ................................................................................................................................ 23
Modal ............................................................................................................................................. 23
Random Vibration & Response Spectrum ........................................................................................ 24
Static Structural & Modal (Samcef ) .................................................................................................. 25
Steady-State Thermal ...................................................................................................................... 25
Thermal-Electric ............................................................................................................................. 25
Static Structural & Transient Structural ............................................................................................. 26
Rigid Dynamics .............................................................................................................................. 28
Transient Thermal .......................................................................................................................... 28
Suppression of Mutually Exclusive Properties ........................................................................................ 29
Charting ............................................................................................................................................... 29
Validation ............................................................................................................................................. 29
Curve Fitting ......................................................................................................................................... 29
Perform Material Tasks in Engineering Data ........................................................................................... 30
Field Variables ...................................................................................................................................... 32
Material Property Support for the Mechanical Application ..................................................................... 36
Linear Material Models .................................................................................................................... 37
Material Models with Nonlinear Behavior (No Unit Conversion) ........................................................ 38
Chaboche Kinematic Hardening ...................................................................................................... 38
Hyperelastic Material Models .......................................................................................................... 38
Gasket Material Model .................................................................................................................... 39
Gurson Material Model ................................................................................................................... 39
Puck Material Model ....................................................................................................................... 40
Cam-Clay ........................................................................................................................................ 40
Drucker-Prager ............................................................................................................................... 40
Jointed Rock ................................................................................................................................... 41
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
iii
iv
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Overview
Engineering Data is a resource for material properties used in an analysis system. Engineering Data can
be used as a repository for company or department data, such as material data libraries. The Engineering
Data workspace is designed to allow you to create, save, and retrieve material models, as well as to
create libraries of data that can be saved and used in subsequent projects and by other users.
Engineering Data can be shown as a component system or as a cell in any Mechanical analysis system.
As a standalone component system, the workspace accesses all material models and properties by default.
When viewed as a cell in a Mechanical analysis system, the workspace shows the material models and
properties pertinent to that system's physics.
To access Engineering Data:
1.
Insert an Engineering Data component system or a Mechanical system into the Project Schematic.
2.
Select Edit from the Engineering Data cell's context menu, or double-click the cell.
3.
The Engineering Data workspace appears. From here, you can navigate through the data for your analysis
system, access external data sources, create new data, and store data for future use.
If you share an Engineering Data cell with one or more other analysis systems, be aware that changes
in one system will change the data for all systems with which the data is shared.
Definitions
The Engineering Data documentation makes use of the following terminology:
Term
Engineering
Data
Definition
The cell of a system in the Project Schematic, which contains engineering data. The
default name is Engineering Data.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Modes of Operation
Data for an Analysis - You can create data or retrieve stored data which can then be assigned to the model
of the analysis system. You can also review, modify, and suppress the data used by an analysis system.
Data Libraries - You can create, edit, and save a library made up of the data that you use most often. This
library can then be used in another project or analysis system.
The data contained in Engineering Data is automatically saved when the project is saved.
User Interface
The Engineering Data workspace is an integrated Workbench feature. This workspace enables you to
add and modify material data. The illustration shown below is the primary and default interface.
Description
Menu
Bar (p. 3)
Toolbar (p. 4)
Toolbox (p. 4)
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
User Interface
Name
Description
Engineering
Data Sources
Pane (p. 4)
Displays the available data sources and their location, edit state and description.
Outline
Pane (p. 5)
Displays the outline of the contents of the selected data source in the Engineering Data
Sources pane or the contents of Engineering Data.
Properties
Pane (p. 8)
Table
Pane (p. 9)
Shows the tabular data for the selected item in the Properties pane.
Chart
Pane (p. 12)
When you select the Engineering Data Sources button, as highlighted below, you display the available
data sources that are included with the application.
Menu Bar
The following items in the menu bar are provided by Engineering Data or affect Engineering Data:
Menu
File
Selection(s)
Description
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Selection(s)
Description
Edit
Delete
View
Various Choices
Units
Various Choices
Extensions
Various Choices
Help
Various Choices
Toolbar
The Engineering Data Toolbar provides the following buttons that you toggle on and off:
Filter Engineering Data: filter Toolbox content and property data based on the system(s) containing
this Engineering Data. The default setting is on (also see Filtering (p. 15)).
Engineering Data Sources: displays the Engineering Data Sources pane (p. 4). The default setting
is off.
Toolbox
Engineering Data will filter the Toolbox to those items which are applicable for the current selection.
For example, in the User Interface (p. 2), the current selection is Structural Steel. The Toolbox presents
items in the following categories:
Material properties and models (p. 19)
Additional tabular data that can be added to a property or model (p. 19)
Curve fitting of data (p. 29)
) and Favorites (
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
User Interface
Remove a data source from the list
Enable the editing of a data source
Save a data source
Edit Column
The edit column ( ) is used to mark a library for editing. When exiting edit mode, you will be
prompted to save the library.
Location Column
The Location column shows a diskette button. Hold the mouse cursor over the button to display a tool
tip that includes the path to the data source. If you are editing the data source, you may save to the
location ( ) (if the internal format is supported for export, see Exporting (p. 13)), or save as a different
file name and/or location ( ). You may also load an existing library from file by clicking the file open
button (... ).
Outline Pane
The Outline pane shows an outline of the contents of the selected data source. You can perform the
following actions in this pane:
Create a new material
Delete a material
Rename a material
Suppress (p. 14) a material
Add a description for a material
Add a material to the system from an external data source
Select a default material for the solid and or fluid parts of a model
An example of the Outline pane is illustrated below. Refer to the table below for descriptions of the
interface elements of the pane.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Description
Contents
Column
The Contents column shows the name of the items contained in the selected data
source. The type and status of the item is indicated under the Material title by an
icon to the left of the name.
: The data contained in this material is valid data (see the Validation (p. 29)
and Filtering (p. 15) topics).
Color
Column
The Color column provides a fly-out menu option for each material that enables
you to assign a specific color to your materials. This material-based color scheme
is transferred to Mechanical. The application assigns random colors by default. You
can change the default colors using the palette or you can make manual color
value entries.
Suppression
Column
The Suppression column shows the suppression status of the item and may also
be used to switch the status (see Suppression (p. 14)). This column is only displayed
when the selected data source is Engineering Data.
Source
Column
The Source column displays the location of the material file and whether the data
is linked to the file. You can hold the mouse cursor over the link icon to display a
tool tip that includes the path to the linked source. Link status is indicated by the
following icons.
: The data does not match the data in the linked location. Right-click and
select the Refresh From Linked Source option.
: The data could not be found in the linked source or the linked source is
missing.
Description
Column
The Description column displays the description for the item contained in the
data source. Hold the mouse cursor over the description to display a tool tip with
the complete description. If the column is too small, you may still see the contents
without resizing.
Add
Columns
The Add columns are used to add an item from an external data source to
Engineering Data for the system you are editing, and indicates if the item is included
in Engineering Data. This column is only displayed when the selected data source
is other than Engineering Data. Click on the addition button ( ) to add the item
to Engineering Data. When an item is included in Engineering Data it is indicated
by the presence of an icon (
).
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
User Interface
Interface
Element
Default
Column
Description
In addition to the common menu options, the following selections perform specific actions.
Duplicate: this option creates a duplicate of the source file.
View Linked Source: this option displays the Engineering Data Sources pane.
Refreshed From Linked Source: this option refreshes the materials from the source file. This action
will discard any changes that you have performed.
Break Link to Source: this option disconnects the link to your material source file.
Default Solid Material For Model: this option automatically assigns the selected material to all solid
bodies that do not have a specified material.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Properties Pane
The Properties pane shows the properties for the item selected in the Outline pane. You can perform
the following actions in this pane:
Add additional properties, tabular data, or curve fitting (from the Toolbox)
Delete a property
Modify constant data
Suppress (p. 14) a property
Parameterize a property
Property Column
The property column lists the properties for the item selected in the Outline pane. Selecting a property
will change the contents of the Table pane and Chart pane. The type and status of the item is indicated
by an icon to the left of the name.
Material Property
The status of the material property is indicated as follows:
The material property is described in a single property data (see the Material
Definitions (p. 19) topic).
Some data contained in this material property requires attention (see the Validation (p. 29)
and Filtering (p. 15) topics).
The material property is described in a collection of property data (see the Material
Definitions (p. 19) topic).
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
User Interface
Indicates that the collection of property data requires attention (see the Validation (p. 29)
and Filtering (p. 15) topics).
Value Column
The value column is used to change data for a property or indicates that the data for the property is
tabular (
). If the item selected in the Outline pane is not editable this column will be shown disabled.
Unit Column
The unit column displays the unit of the data shown in the value column . If the column is editable (see
Units Menu), changing the unit will convert the value into the selected unit (there is no net change in
the data, so the solution is still valid).
Suppression Column
The suppression column (
) shows the suppression status of the item and may also be used to switch
the status (see Suppression (p. 14)).
Parameter Column
The parameter column ( ) shows the parameterization status of the item and may also be used to
switch the status (see Parameterize (p. 14)).
Table Pane
The Table pane shows the tabular data for the item selected in the Properties pane. If there are independent variables (for example, Temperature) for the selected item and the item is constant, you may
change it to a table by entering a value into the independent variables data cell. If a row is shown with
an index of *, you may add additional rows of data. The data may be sorted by using the filter item in
the header of the column.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
The data is separated in this way to make it easier to visualize and modify but the data is maintained
in a single table by Engineering Data.
When you select the Import Delimited Data option, a dialog box titled "Delimited Data Import" appears,
as illustrated below with the default settings shown, and enables you to specify certain criteria regarding
the format of your data file.
10
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
User Interface
As shown, you use the Browse button to select the file you wish to import and you may then further
define how the data is imported into the table. You can choose a specific line in the file to begin the
import from, select a Delimiter Type, either Comma (default), Semicolon, Space, or Tab and as needed,
you can choose specific columns in the file to import.
The Auto Detect feature examines your file's content to find recognizable delimiters and numeric data.
During this process, the feature attempts to convert any string data preceding the numerical data as a
variable type and its units.
As illustrated in the example shown below, Auto Detect automatically sets the form's controls to match
the format of the file to import. The settings of the File Format settings and the Data table match the
format of the example file. This feature provides a preview of your file's content based on the header
information contained in the file.
As illustrated, Preview is selected. This option displays the header information as well as the first 50
lines of your file. As needed, select Full File to display the entire content of the file. Additional features
include:
Import: activate/deactivate the column.
Variable: this option provides a drop-down list of available variables from the property shown in the
Table pane. These values are read-in by the tool. You can change them as necessary.
Unit: another drop-down list of units based on the specified Variable. For variables that do not require
units, this field is left blank.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
11
Note
The import operation always appends data in the Table. Data is never overwritten.
You can drag and drop your file onto a cell of the Table pane to automatically launch the
Delimited Data Import window.
Chart Pane
The Chart pane shows the chart of the selected item in the Properties pane.
Engineering Data
Engineering Data is the source of the material information that is used for the analysis of the system it
is contained in. The information in an Engineering Data component system is used if shared to an
analysis system. Engineering Data allows you to view, edit, and add data for use in your analysis system.
12
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Library
A library is the term used for a collection of engineering data. Engineering Data allows you to add a
library for viewing, editing, and adding additional data. To edit a library, select the check box to the
right of the library's title. You can add items from the library to Engineering Data for use in your analysis
system.
Favorites
The favorites ( ) data source is the location for those items that you use frequently and allows you to
mark items as defaults for a new analysis system. You can add items from other data sources to the
favorites using the context menu (right-click). You can add items from the favorites to Engineering Data
for use in your analysis system. Material defaults for newly created systems may be assigned in the
context menu (see Material Defaults (p. 20)).
Importing
You can import data into an existing data source (if it is editable) or import it as a library. The following
types of files are supported for import:
Engineering Data libraries exported from Workbench 9.0 to 11.0 SP1
Material(s) file following the MatML 3.1 schema
Material(s) file generated by AUTODYN
Import into Existing Source
When you use the Import Engineering Data menu item, the data contained in that source will be added
to the currently selected data source (if edit enabled).
Import as Data Source
When you use the "..." open file dialog in the Engineering Data Sources pane, the selected data source
will be added to the list of data sources.
Exporting
You can export a complete data source or the selected items in a data source. The following format is
supported for export:
MatML 3.1 schema for Material(s)
13
Parameterize
Data can be parameterized to allow it to be used in parametric studies and design points (see Working
with Design Points). To parameterize an item in the Properties pane, choose the check box in the
parameter column (
). The parameter value can then be changed in the Parameters and Design Points
workspace. Use caution when parameterizing data that is dependent on other data to maintain valid
data. The parameterized data is always calculated from the original values, so also use caution when
modifying data in the parameter workspace to avoid computer precision problems.
Constant Data
When you parameterize constant data, the constant data can be changed by the Parameter Workspace
but the original datum is not modified. The original datum is restored when the parameterization is
removed.
Tabular Data
You can parameterize tabular data by parameterizing the scale and/or offset for all of the tabular data.
The scale value varies the curve by multiplying the y-axis value of each point on the curve. The offset
is added to or subtracted from a y-axis value for each point on the curve. The equation used for varying
each datum value in the tabular data is:
Property = Scale * Nominal Value + Offset
The original tabular data is not modified, but the scale and/or offset datum are restored to the defaults
of 1.0 and 0.0 when the parameterization is removed.
Suppression
Data may be defined but suppressed to prevent it from being sent to a downstream cell in the system.
For example, suppressing a material or material property will prevent it from being used in the model.
A data item may be suppressed by selecting the check box in the suppression column (
). Suppressed
items are shown by a strike through the name (for example,
) and the check box being selected in the suppression column.
14
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Filtering
Engineering Data will filter the data which pertains to the project system being edited, by default. The
filtering is based on the Physics, Analysis Type, and Solver. You can turn filtering on and off in the
toolbar (
). All data is transferred to the downstream cell regardless of filtering being turned on or
off. A selected solver may ignore the data if it is not recognized or supported.
Procedure
Access
Engineering
Data.
Access
Engineering
Data
Sources.
1. Double-click the Engineering Data cell or right-click the Engineering Data cell and select
Edit...
Note
You may also access via RMB.
Import data
into a data
source.
Note
Only recognized data will be imported into the data source.
Import data
as a data
source.
Note
Only recognized data will be imported.
Export a
data source.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
15
Procedure
2. Select a data source in the Engineering Data Sources pane.
3. Choose File> Export Engineering Data....
4. In the Save As dialog, select the folder, provide a file name, and choose Save.
Export
individual
data.
Note
Multiple items may be selected in the Outline pane.
Combine
data
sources.
1. Perform the "Import Data as a data source" task for each of the data sources you want
to combine.
2. Perform the "Edit a data source" task to combine into an existing data source, or perform
the "Create a library" task to combine into a new library.
3. Select a data source.
4. From the Outline pane drag the item of interest into theEngineering Data Sources
pane and drop the item on the data source you want to combine.
5. Complete the above operation for all items of interest.
6. Choose the Save button (
16
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
17
3. Once the model is defined click OK to add the new model to the Toolbox category and the selected
material.
An example of the new model added to Structural Steel is illustrated here.
18
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Material Data
This section examines the function and use of material properties within Engineering Data.
Definitions
Sample Libraries
Default Material Assignment for Model Parts
Supported Properties
Suppression of Mutually Exclusive Properties
Charting
Validation
Curve Fitting
Perform Material Tasks in Engineering Data
Field Variables
Material Property Support for the Mechanical Application
Mutually Exclusive Properties
Mechanical Material Curve Fitting
CAD Materials
Definitions
The documentation for Material Data makes use of the following terminology:
Term
Definition
Property
This is the identifier for the singular information (for example, Density) that together with
other properties defines or models the behavior of the material. A property is always defined
by at least one table (tabular data), which could be singular. Some properties can contain
a collection of tabular data (for example, Isotropic Elasticity).
Property
data
This is the identifier for tabular data (for example, Young's Modulus).
Sample Libraries
Engineering Data provides sample material data categorized into several libraries. You must validate
that the data is consistent with the material you are using in your analysis. If you are viewing the library
in an analysis system, the contents of a material will be filtered to that system (see Filtering (p. 15)).
The samples are part of the installation and are located in the path ANSYS
Inc.\v170\Addins\EngineeringData\Language\<lang>\Samples.
The following libraries are included:
General Materials,
This is a library of general use materials and consists mostly of metals that can be used in various analyses.
General Nonlinear Materials,
This is a library of general use nonlinear materials for performing nonlinear analyses.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
19
Material Data
Explicit Materials,
This is a library of materials containing data, specific for use in an explicit dynamics analysis.
Hyperelastic Materials,
This is a library of "materials" containing stress strain data which can be used to experiment with curve
fitting (see the Curve Fitting (p. 29) topic). The data doesn't correspond to any particular material.
Magnetic B-H Curves,
This is a library of materials containing B-H Curve data, specific for use in a magnetic analysis.
Thermal Materials,
This is a library of materials containing data, specific for use in a thermal analysis.
Fluid Materials,
This is a library of materials containing data, specific for use in a fluid analysis.
Composite Materials,
This is a library of materials containing data, specific for use in a composite analysis.
Supported Properties
The supported material properties are defined by the analysis system(s) that contains or shares the
Engineering Data cell. If filtering is active (see Filtering (p. 15)), you will only see the supported material
properties. See the list of material properties supported by a given analysis system in the following
sections. The minimum material properties required for a given analysis are marked with an asterisk (*).
Select the link to read more information about a particular property. If temperature dependency is
supported, the material property will be marked with f(T).
Electric (p. 21)
Explicit Dynamics (p. 21)
Harmonic (p. 22)
20
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Supported Properties
Linear Buckling (p. 22)
Magnetostatic (p. 23)
Modal (p. 23)
Rigid Dynamics (p. 28)
Static Structural & Transient Structural (p. 26)
Static Structural & Modal (Samcef ) (p. 25)
Steady-State Thermal (p. 25)
Thermal-Electric (p. 25)
Transient Thermal (p. 28)
Random Vibration & Response Spectrum (p. 24)
Electric
Properties
*Isotropic
Resistivity
Orthotropic
Resistivity
Explicit Dynamics
Properties
Density
Isotropic Elasticity
Orthotropic Elasticity
Viscoelastic
Bilinear Isotropic Hardening
Multilinear Isotropic Hardening
Bilinear Kinematic Hardening
Multilinear Kinematic Hardening
Johnson Cook Strength
Cowper Symonds Strength
Steinberg Guinan Strength
Zerilli Armstrong Strength
Neo-Hookean
Mooney-Rivlin (2, 3, 5, and 9 Parameter) f(T)
Polynomial (1st, 2nd, and 3rd Order)
Yeoh (1st, 2nd, and 3rd Order)
Ogden (1st, 2nd, and 3rd Order)
Specific Heat
Drucker-Prager Strength Linear
Drucker-Prager Strength Stassi
Drucker-Prager Strength Piecewise
Johnson-Holmquist Strength Continuous
Johnson-Holmquist Strength Segmented
RHT Concrete Strength
MO Granular
Bulk Modulus
Shear Modulus
Polynomial EOS
Shock EOS Linear
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
21
Material Data
Properties
Shock EOS Bilinear
Crushable Foam
Compaction EOS Linear
Compaction EOS Non-Linear
P-alpha EOS
Plastic Strain Failure
Principal Stress Failure
Principal Strain Failure
Stochastic Failure
Tensile Pressure Failure
Crack Softening Failure
Johnson Cook Failure
Grady Spall Failure
Specific Heat
Explosive JWL
Explosive JWL Miller
Ideal Gas EOS
See Material Models Used in Explicit Dynamics Analysis for a description of the above properties.
Orthotropic Stress Limits
Orthotropic Strain Limits
Tsai-Wu Constants
Tsai-Wu Constants must be used in conjunction with Orthotropic Stress Limit. Tsai-Wu Constants
used in conjunction with Orthotropic Strain Limit are not supported.
Harmonic
Properties
*Density f(T)
Damping Factor ()
Damping Factor ()
Constant Damping Coefficient
*Isotropic Elasticity f(T)
Orthotropic Elasticity f(T)
See Linear Material Properties in the Material Reference for a description of the above properties.
Anisotropic Elasticity (p. 37)
Hyperelastic Material Models are supported for pre-stress modal based analysis but not for pure
modal based analysis.
Linear Buckling
Properties
*Density f(T)
*Isotropic Elasticity f(T)
Orthotropic Elasticity f(T)
22
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Supported Properties
Properties
See Linear Material Properties in the Material Reference for a description of the above properties.
Anisotropic Elasticity (p. 37)
Orthotropic Stress Limits
Orthotropic Strain Limits
Tsai-Wu Constants
Puck Constants
LaRc03/04 Constants
Superelasticity
Shape Memory Alloy
The above shape memory alloy material model properties are supported only for pre-stress
analysis.
Gasket Material Model (p. 39) is supported for pre-stress analysis.
Magnetostatic
Properties
*Relative Permeability
Coercive Force & Residual Induction
B-H Curve
Demagnetization B-H Curve
Relative Permeability (Orthotropic)
*Isotropic Resistivity
Orthotropic Resistivity
See Electromagnetic Material Properties (p. 42) for a description of the above
properties.
Modal
Properties
*Density f(T)
Damping Factor ()
Damping Factor ()
Constant Damping Coefficient
Coefficient of Thermal Expansion f(T) (p. 37)
*Isotropic Elasticity f(T)
Orthotropic Elasticity f(T)
See Linear Material Properties in the Material Reference for a description of the above properties.
Anisotropic Elasticity (p. 37)
Bilinear Isotropic Hardening f(T)
Bilinear Kinematic Hardening f(T)
Multilinear Isotropic Hardening f(T)
Multilinear Kinematic Hardening f(T)
Chaboche Kinematic Hardening f(T)
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
23
Material Data
Properties
Anand Viscoplasticity
Orthotropic Stress Limits
Orthotropic Strain Limits
Tsai-Wu Constants
Puck Constants
LaRc03/04 Constants
See Material Strength Limits for a description of the above properties.
Superelasticity
Shape Memory Alloy
See Shape Memory Alloy (SMA) for a description of the above properties.
The above shape memory alloy material model properties are supported for pre-stress modal analysis
but not for pure modal analysis.
Gasket Material Model (p. 39) is supported for pre-stress modal analysis but not for pure modal
analysis.
Hyperelastic Material Models (p. 38) are supported for pre-stress modal analysis but not for pure
modal analysis.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Supported Properties
Properties
The above shape memory alloy material model properties are supported for pre-stress modal based
analysis but not for pure modal based analysis.
Gasket Material Model (p. 39) is supported for pre-stress modal based analysis but not for pure modal
based analysis.
Hyperelastic Material Models (p. 38) are supported for pre-stress modal based analysis but not for
pure modal based analysis.
Steady-State Thermal
Properties
*Isotropic Thermal Conductivity f(T)
Orthotropic Thermal Conductivity f(T)
See Linear Material Properties in the Material Reference for a description of the above
properties.
Thermal-Electric
Properties
*Isotropic Thermal Conductivity f(T )
Orthotropic Thermal
Conductivity f(T)
*Isotropic Resistivity
Orthotropic Resistivity
Seebeck Coefficient
Orthotropic Seebeck Coefficient
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
25
Material Data
Properties
See Linear Material Properties in the Material Reference for a description of the above
properties.
26
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Supported Properties
Properties
Anand Viscoplasticity
Rate-Independent Plasticity
Gurson Model ( (p. 39))
Fatigue
Alternating Stress Mean Stress
Alternating Stress R-Ratio
Strain-Life Parameters
Viscoelasticity
Prony Shear Relaxation
Prony Volumetric Relaxation
Williams-Landel-Ferry Shift Function ( (p. 38))
Tool-Narayanaswamy Shift Function ( (p. 38))
Tool-Narayanaswamy with Fictive Temperature Shift Function
( (p. 38))
Stress Tool
Tensile Yield Strength
Compressive Yield Strength
Tensile Ultimate Strength
Compressive Ultimate Strength
Gasket Model
Implicit Creep Equations (p. 38)
Strain Hardening
Time Hardening
Generalized Exponential
Generalized Graham
Generalized Blackburn
Modified Time Hardening
Modified Strain Hardening
Generalized Garofalo
Exponential form
Norton
Combined Time Hardening
Rational polynomial
Generalized Time Hardening
Material Strength Limits
Orthotropic Stress Limits
Orthotropic Strain Limits
Tsai-Wu Constants
Puck Constants
LaRc03/04 Constants
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
27
Material Data
Properties
Shape Memory Alloy (SMA)
Superelasticity
Shape Memory Alloy
Geomechanical
Cam Clay ( (p. 40))
Drucker-Prager ( (p. 40))
Jointed Rock ( (p. 41))
Mohr-Coulomb ( (p. 41))
Material Damage
Damage Initiation Criteria
Damage Evolution Law
Cohesive Zone
Exponential for Interface Delamination
Bilinear for Interface Delamination
Separation-Distance based Debonding
Fracture-Energies based Debonding
Fracture Criteria
Linear Fracture Criterion
Bilinear Fracture Criterion
B-K Fracture Criterion
Modified B-K Fracture Criterion
Power Law Fracture Criterion
() Refers to the corresponding Engineer Data Help page.
Rigid Dynamics
Properties
*Density
Transient Thermal
Properties
*Density f(T)
*Isotropic Thermal Conductivity f(T)
Orthotropic Thermal Conductivity f(T)
*Specific Heat f(T)
Enthalpy f(T)
See Linear Material Properties in the Material Reference for a description of the above
properties.
28
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Curve Fitting
Charting
The axis range can be modified on a chart by choosing Edit Properties from the axis context menu
(see Setting Chart Properties). This range will be used when generating the x-y data for the chart so
that you can examine the data beyond the default range.
Validation
The user interface will indicate invalid data by showing a yellow background and changing the state
of the material to attention required. To find the reason for the data being invalid, choose Display
Validation Failure from the context menu of the invalid item.
Curve Fitting
When curve fitting is available for a selected item in Engineering Data a Curve Fitting group will be
accessible in the ANSYS Workbench Toolbox. A curve fitting module can then be added to the selected
item. The data that can be used for the curve fitting module will be shown, regardless of whether or
not the data is available. If the required data is not available it should be added from the Toolbox. The
data used for curve fitting can be suppressed (in some instances), in the curve fitting module, to prevent
its use in the curve fitting calculations. The curve fitting solution is done by choosing Solve Curve Fit
in the context menu for Curve Fitting, in the Properties pane. You can then visually compare the fitted
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
29
Material Data
curve to the original data in the Chart pane. Once you are satisfied with the solution you can then
choose Copy Calculated Values to Property in the context menu.
Note
Curve Fitting is only active for the running session. If you exit the application you will have
to add the curve fitting module again. You should be sure to Copy Calculated Values to
Property to maintain the calculated information.
Note
If the active unit system for the project is changed, the current Curve Fitting modules in
the project will be recreated using the new unit system. This will result in the seed values
being reset to their default values.
Note
Note: If the experimental data is parametrized, the current design point parameter value
will be used for the computations when choosing Solve Curve Fit, but will have no effect
for other design points when updating a project, because of the interactive nature of performing the fitting.
Curve fitting is specific to a given solver and so the following topics provide specific information:
Mechanical Material Curve Fitting (p. 46)
Perform Material Tasks in Engineering Data (p. 30)
Procedure
1. In the Outline pane click in the cell marked as Click here to add a new
material.
2. Type in the name of the new material and press Enter.
30
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Procedure
1. Select the material in the Outline pane that is to receive the additional
property.
2. Double-click the property in the Toolbox that you want to add.
Delete Material
Properties.
Modify Material
Properties.
1. Select the material in the Outline pane that contains the property you want
to modify.
2. In the Properties pane change the value or unit for constant data.
3. Perform one of the following:
For constant data, change the value or unit in the Properties pane.
For tabular data, change the value or unit(s) in the Table pane.
Parameterize Material
Properties.
1. Select the material in the Outline pane that contains the property you want
to parameterize.
2. Select the check box in the parameter column for the property you want to
parameterize. For tabular data, use scale and/or offset (see
Parameterize (p. 14)).
Suppress Material
Properties
1. Select the material in the Outline pane that contains the property you want
to suppress.
2. Select the check box in the suppression column for the property you want
to suppress.
1. Select the material in the Outline pane that is to be used as the default for
the Model cell.
2. Right-click and choose Default Solid Material for Model or Default Fluid/Field
Material for Model.
Note: This default setting applies only to the Engineering Data cell in
which it is set (see Material Defaults (p. 20)).
1. Select a material model that supports curve fitting. The option for performing
a curve fit is indicated by the "Curve Fitting" group in the Toolbox (see Curve
Fitting (p. 29)).
2. Modify options for the curve fitting calculations.
3. Suppress any experimental data to exclude from the curve fitting calculations.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
31
Material Data
Task
Procedure
4. Select the Curve Fitting item in the Properties pane and select Solve Curve
Fit in the context menu.
5. Review the accuracy of the fitted data to the experimental data.
6. Select the Curve Fitting item in the Properties pane and select Copy
Calculated Values To Property.
Field Variables
Material data can be dependent on variables such as temperature, shear angle, degradation factor, or
user-defined entries. These variables are termed as Field Variables and are only available for specific
material properties and models, as listed below. For more information on this topic, see the discussion
on User-Defined Field Variables in the Mechanical APDL Material Reference.
Engineering Data supports the following Field Variables:
Temperature
Shear Angle
Degradation Factor
User-defined variables (as discussed below).
Important
Shear Angle, Degradation Factor, and user-defined field variables are only applicable
when used in an ACP-Pre system because only ACP defines field information for the
solution.
The use of field variables to further define material properties enables you to simulate the effects of
environmental conditions and manufacturing processes on material characteristics. This can be of particular importance when you are using the ANSYS Composite PrepPost application to model composites.
See the Variable Material Data in Composite Analyses section of the ANSYS Composite PrepPost User's
Guide for additional information.
The supported material properties and models are listed below.
Isotropic elasticity
Orthotropic elasticity
Orthotropic Stress Limits
Orthotropic Strain Limits
Woven Specification for Puck
32
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Field Variables
2. From the Field Variables category, select the desired system provided field variable:
Temperature
Shear Angle
Degradation Factor
The new field variable populates the Table pane (p. 9). Enter appropriate values.
2. The following dialog box displays. Enter a name for your new field variable and select a desired Quantity
Type from the drop-down list. Dimensionless is the default. Once complete, click OK.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
33
Material Data
3. The new field variable populates the Table pane. Enter appropriate values. Example entries are illustrated
below for the user-defined field variable Example_Custom_Fld_Var.
4. Select the Interpolation Options property to display the following Table pane. This table defines the algorithm the solver uses to interpolate between the data entered in the Table pane from Step 2 in order
to get the values corresponding to the calculated field variable values on a given element. Please refer to
the General Interpolation Library section of the ANSYS Composite PrepPost User's Guide for more details
about the algorithms and options used when creating user-defined Field Variables.
5. Select one of the following Algorithm Types from the drop-down menu:
34
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Field Variables
6. Refine the interpolation algorithm by activating one or more of the following options.
Normalize: scale the axes to achieve an unbiased distance metric. The ranges used to scale the axes are
defined by the Lower Limit and Upper Limit values of the Material Field Variables table pane.
Quantize: discretize the field variable axes based on the ranges and Resolution defined in the Material
Field Variables table pane.
Cache: save previous queries in order to increase performance.
7. Select the Material Field Variables property to display the following table pane.
Usage Notes
The order in which you add field variables to a material property becomes important if:
Your material data has multiple field variables.
The data is structured such that one field variable changes while the others remain fixed.
Whichever field variable varies the most, is the variable that you should insert and define first. Consider
the example illustrated below. In this case, the Temperature varies more than the Shear Angle, so it will
be best to add temperature first and then shear angle. Adding the field variables in this order results
in a table structure that, for each shear angle, there is data at multiple temperatures.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
35
Material Data
The drop-down menu on the Table pane for the field variable provides options (e.g., sorting and filtering).
In order to remove a Field Variable from a property, you must use the Delete option from this dropdown menu.
36
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
D22
D31
D32
D33
D41
D42
D43
D44
D51
D52
D53
D54
D55
D61
D62
D63
D64
D65
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
D66
37
Material Data
Each row corresponds to the terms of x, y, z, xy, yz, xz. The stiffness terms must be positive definite (requiring all determinants to be positive). The stiffness terms have units of Force/Area
operating on the strain vector.
38
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Charts
Select Data Set node in Properties Pane to display chart for all the data defined for specific data set or
temperature value.
Select Gasket Model property node in Properties Pane to display all the gasket data. Each data set is displayed in unique color and associated temperature value can be seen in the chart legend.
39
Material Data
Nucleation Stress Controlled
Nucleation Strain Controlled
Coalescence
You may specify either stress or strain but not both.
Cam-Clay
The Cam-Clay material model is contained in the Geomechanical Toolbox data item. This property
supports Static Structural and Transient Structural analyses. When you added this model, the Porous
Elasticity (p. 42) model is also automatically added. For additional information, see the discussion of
Cam-Clay in the Mechanical APDL Material Reference.
Cam-Clay includes the following physical properties:
Plastic Slope Parameter
Slope of Critical State Line
Initial Size of Yield Surface
Minimum Size of Yield Surface
Dry Part of Yield Surface Modifier
Wetting Part of Yield Surface Modifier
Anisotropic Yield Surface Parameter
Drucker-Prager
The Drucker-Prager material model is contained in the Geomechanical Toolbox data item. This property
supports Static Structural and Transient Structural analyses. For additional information, see the discussion
of Drucker-Prager in the Mechanical APDL Material Reference.
Drucker-Prager Base is the primary property and includes the following physical properties:
Uniaxial Compressive Strength
Uniaxial Tensile Strength
Biaxial Compressive Strength
In addition, once you insert the Drucker-Prager model, the Drucker-Prager - Additional Data data
item displays in the Toolbox so that you can add one of the following:
40
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Jointed Rock
The Jointed Rock material model is contained in the Geomechanical Toolbox data item. This property
supports Static Structural and Transient Structural analyses. For additional information, see the discussion
of Jointed Rock in the Mechanical APDL Material Reference.
The Jointed Rock property includes the following physical properties:
Residual Strength Coupling
Yield Surface
Initial Inner Friction Angle (Degree)
Initial Cohesion (Force/length2)
Dilatancy Angle (Degree)
Residual Inner Friction Angle (Degree)
Residual Cohesion (Force/length2)
In addition, once you insert the Jointed Rock model, the Jointed Rock - Additional Data data item
displays in the Toolbox so that you can add one of the following:
Tension Rankine Yield Surface
Failure Plane Data Set
Mohr-Coulomb
The Mohr-Coulomb material model is contained in the Geomechanical Toolbox data item. This property
supports Static Structural and Transient Structural analyses. For additional information, see the discussion
of Mohr-Coulomb in the Mechanical APDL Material Reference.
Yield Surface is the Mohr-Coulomb property and includes the following physical properties:
Initial Inner Friction Angle (Degree)
Initial Cohesion (Force/length2)
Dilatancy Angle (Degree)
Residual Inner Friction Angle (Degree)
Residual Cohesion (Force/length2)
In addition, once you insert the Mohr-Coulomb model, the Mohr-Coulomb - Additional Data data
item displays in the Toolbox so that you can add the optional additional model Tension Rankine Yield
Surface.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
41
Material Data
Porous Elasticity
The Porous Elasticity material model is contained in the Geomechanical Toolbox data item. This property
supports Static Structural and Transient Structural analyses. Porous Elasticity is automatically added
when the Cam Clay (p. 40) model is added. For additional information, see the discussion of Porous
Elasticity in the Mechanical APDL Material Reference.
Porous Elasticity includes the following physical properties:
Swell Index
Elastic Limit of Tensile Strength
Poisson's Ratio
Initial Void Ratio
42
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
43
Material Data
44
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
45
Material Data
Exponential for Interface Delamination
Bilinear for Interface Delamination
Separation-Distance based Debonding
Fracture-Energies based Debonding
Linear Fracture Criterion
Bilinear Fracture Criterion
B-K Fracture Criterion
Modified B-K Fracture Criterion
Power Law Fracture Criterion
46
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Note
The Volume Ratio equals the ratio of the current volume to that of the original volume and
all solution data displayed for postprocessing are true stresses and logarithmic strains.
The experimental data defined for all temperatures is used for curve fitting. Please make sure that
temperatures are defined consistently for different experimental data. If the experimental data contains
temperature mismatch then the warning message will be displayed in the Messages pane during Solve
Curve Fit.
When volumetric data is supplied, a compressible or nearly incompressible model is implied. When no
volumetric data is supplied, the model is understood to be incompressible. Supplying zero as a coefficient
for the volumetric data also denotes an incompressible model.
You should perform curve fitting for the various hyperelastic models to choose the one, based on the
range of strain you are interested in, that best matches the experimental data provided.
Chaboche Test Data
Uniaxial Plastic Strain Test Data f(T) (Plastic Strain vs. True Stress)
Note
To use curve fitting with plasticity, the only experimental data supported is Uniaxial Plastic
Strain Test Data. Experimental data for plasticity is path dependent. Multiple Uniaxial Plastic
strain test data can be added from Uniaxial Plastic Strain Additional Test Data group
which will be accessible in the Toolbox, when Uniaxial Plastic Strain Test Data is selected.
Chaboche Kinematic Hardening plasticity model supports curve fitting (see Curve Fitting (p. 29)) of
the Uniaxial Plastic strain test data.
Viscoelastic Test Data
Shear Data- Viscoelastic f(T) (Time vs. Shear Modulus)
Bulk Data - Viscoelastic f(T) (Time vs. Bulk Modulus)
Note
Both the above test data are path dependent. Multiple test data can be added from Viscoelastic - Additional Test Data group which will be accessible in the Toolbox, when test
data is selected in properties.
Viscoelastic models with curve fitting (see Curve Fitting (p. 29)) support:
Prony Shear Relaxation
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
47
Material Data
Prony Volumetric Relaxation
Note
A change in the Number of Terms on the Prony models will update the curve fitting coefficients to allow fitting for the desired number of terms. The calculated values in the curve
fitting are normalized, when Copy Calculated Values to Property is selected. The normalization uses the following equations, which describe the relationship between the Prony
Coefficient ( ) and the corresponding coefficient generated in curve fitting ( ). is the
number of terms computed.
is the square root of
and
are the shear modulus and bulk modulus at
values used in the property table positive.
and
is the square root of
. This is done to keep all
.
and
(1)
(2)
(3)
(4)
CAD Materials
The materials assigned to parts in a CAD package can be used in Mechanical by checking the Material
Properties check box in the Geometry cell properties pane. The materials assigned to parts in the CAD
package will be assigned to corresponding parts in the Mechanical application.
CADMaterials Engineering Data Source- When a model is refreshed after importing CAD geometry,
a temporary MatML 3.1 file will be created, which contains the materials from the CAD package. This
file will be added as a Data Source in Engineering Data as CADMaterials and the file description will
identify the system it belongs to. This file is overwritten when a CAD update operation is performed,
so the file should not be edited directly.
Please see the following work flows related to the use of materials from CAD packages.
48
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
CAD Materials
A. Using CAD materials
1. Check Material Properties check box in the Geometry cell and import geometry.
2. Refresh model- The materials assigned to parts in the CAD package will be assigned to corresponding
parts in the Mechanical application.
Note
If the part in the CAD package doesn't have a material assigned, the default material
will be assigned in Mechanical (see Default Material Assignment for Model
Parts (p. 20)).
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
49
50
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Appendix
This section includes the following:
Appendix A: Material Library File Format
Appendix B: Custom Material Models
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
51
Appendix
MAPDL_UserMat_DefinitionMethods.xml: Defines the category and names to display for the user-defined
material model(s) in the Toolbox view. Installation location:
Drive:\Program Files\ANSYS Inc\version\Addins\EngineeringData\MetaData
MAPDL_UserMat_Relationships.xml: Defines dependencies and mutual exclusions for the custom material model(s). Installation location:
Drive:\Program Files\ANSYS Inc\version\Addins\EngineeringData\MetaData
EngineeringData.config: Defines the files to be used by the product and if your edits are invalid, you can
disable the product. Installation location:
Drive:\Program Files\ANSYS Inc\version\Addins\EngineeringData\bin\<machine-type>
These files include instructional comments that guide you during the modification process. Each file is
described in subsequent sections.
Important
ANSYS recommends that you use a text editor that allows you to expand and collapse sections
in the XML files for ease of editing.
Procedure
1. Open the following installation directory:
Drive:\Program Files\ANSYS Inc\version\Addins\EngineeringData\MetaData
2. Highlight and copy each of the following files to a new folder. This helps to ensure that the integrity of the
original files is maintained.
MAPDL_UserMat_Properties.xml
MAPDL_UserMat_DefinitionMethods.xml
MAPDL_UserMat_Relationships.xml
3. Rename the new files by replacing MAPDL with your companys name. For example:
MyCompany_UserMat_Properties.xml
MyCompany_UserMat_DefinitionMethods.xml
52
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Important
It is recommended that you use a text editor that allows you to expand and collapse sections
in the XML files for ease of editing.
Once you feel that your edits are complete and accurate, you need to modify the EngineeringData.config
file. This is a critical program file.
Warning
If you introduce an error into EngineeringData.config file, you may disable the product.
Therefore, it is critical that you have a backup copy of the file before performing edits to it.
1. Open the following installation directory:
Drive:\Program Files\ANSYS Inc\version\Addins\EngineeringData\bin\<machine-type>
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
53
Appendix
6. Open the Engineering Data Workspace and select the Filter Engineering Data button. The Toolbox should
display your material model(s).
54
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
As shown above, the <PropertyCategory> element defines the Engineering Data Toolbox category
and the <Property> element defines a property contained in the category.
As illustrated, you can have more than one property. In addition, this is where you also create additional
property categories. You can copy and paste these lines to help you create additional properties and
property categories.
Note
The string for the name attribute must be the same as that used in the MyCompany_UserMat_Properties.xml file for the name of the user-defined material model to be valid. An example of this
entry is shown below.
The text "(UPF)" is appended to the string by Engineering Data to clearly distinguish user-defined
material models from those provided by ANSYS.
Make sure that your tags are properly formatted with beginning ("<") and ending ("/>") characters.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
55
Appendix
56
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Note
The string for the name attribute must be the same as that used in the MyCompany_UserMat_Properties.xml file for the name of the user-defined material model to be valid. An example of this
entry is shown below.
Make sure that your tags are properly formatted with beginning ("<") and ending ("/>") characters.
Mutual Exclusions
A user-defined material model may not be able to be used with other material data (e.g. isotropic
elasticity) because the user-defined material model provides the needed computation (e.g. elasticity).
The relationships file enables you to specify this information so that when a user would add the userdefined material model to the material the other material properties or models will be suppressed
automatically if in the material.
Any mutual exclusion to other material models is defined within the MutualExclusions element. You
use the subelements (ModelData) to specify those models which cannot be used together. There can
be more than one MutuallyExclusive element specified. Add the ModelData line multiple times with
a string as a property name which cannot be used with the user-defined material model.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
57
Appendix
Within the BulkDetails element, the PropertyData element defines the input data for each user-defined
material model.
58
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
The PropertyData element requires the property attribute (property="prUSER") which is a string data
type that corresponds to an id attribute in the Metadata element within the properties files. You may
use any unique string as the identification for a given Property. The PropertyData element also requires
the minOccurrences attribute (minOccurrences="1") attribute. You use the ParameterValue element
within PropertyData to define the data for a user-defined material model.
<Data format>=string</Data>
You must include this line as shown for compatibility requirements.
<Qualifier name="UserMat">string</Qualifier>
Identifies this PropertyData as being defined in UserMat. The string should be specified as "USER" to
define inputs for this user-defined material model (TB, USER) or "STATE" to define state variables for this
user-defined material model (TB, STATE) or a material model (e.g. CZM) which supports USER as a valid
TBOPT field (e.g. TB,CZM,,,,USER).
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
59
Appendix
<Qualifier name="Display">False</Qualifier>
This Boolean allows the PropertyData to be hidden (False) in the GUI but the data is sent to Mechanical.
The individual field data and behaviors for a user-defined material model are defined within the ParameterValue element. The following attributes are applicable for this element.
Attribute
Value
Description
parameter
"string"
format
"string"
lowerLimit
"string"
upperLimit
"string"
60
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
61
Appendix
For the example content, the parameter "pa1" is defined in the Metadata table as Temperature.
You can use an alternate string if desired (e.g. "temp").
The parameter groupPropertyData is defined in the Metadata table with the name Material Property
which facilitates this behavior. You can use an alternate string if desired (e.g. "group").
62
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Metadata Element
The details for the attributes used on PropertyData (property="") and ParameterValue (parameter="")
are contained within Metadata element. Metadata content is illustrated below.
Parameter Details
The string used by ParameterDetails is a unique identification for the parameter to be used in conjunction with a ParmeterValue's attribute parameter.
Name
<Name>"string"</Name>: This string to be displayed in the GUI as the name of the parameter.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
63
Appendix
Units
The Units element defines the name of the physical quantity for which defined units are available. For example, units of a parameter which has Stress units (Pa) can be defined as shown below. Use Unitless for
parameters without units as shown above.
Caution
Use extreme caution if you are choosing the unit of measure. This value is converted to the
Unit System specified for the solution and if you do not enter a supported unit, you could
produce incorrect data for the solution.
Property Details
The only PropertyDetails attribute is id="string". The string is a unique identification for the property
(prUSER) to be used in conjunction with a PropertyData's attribute property. Following elements are
used to further specify PropertyDetails.
Name
<Name>"string"</Name>: The string to be displayed in the GUI as the name of the user-defined material
model.
Units
This is required for compatibility and should not be modified.
64
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Index
C
chart pane, 12
create custom material models, 51
custom material models, 16, 51
D
definitions, 1
E
Engineering Data user interface, 2
exporting, 12
F
favorites, 12
filtering, 13
importing, 12
parameterizing, 13
performing basic tasks, 15
properties pane, 8
L
layout
Engineering Data, 2
library, 12
quick start, 1
material
cad material, 48
charting, 29
composite, 20
curve fitting, 29
definitions, 19
electromagnetic properties, 42
explicit library, 20
fluid, 20
general library, 19
general nonlinear library, 19
hyperelastic library, 20
magnetic B-H curve library, 20
Mechanical APDL material curve fitting, 46
mutually exclusive properties, 44
perform tasks, 30
properties, 19
property support, 36
sample libraries, 19
supported properties, 20
suppression of mutually exclusive properties, 29
thermal, 20
validation, 29
suppressing, 13
T
table pane, 9
toolbar, 4
toolbox, 4
U
user interface
Engineering Data, 2
W
working with data, 13
working with data sources, 12
workspace
Engineering Data, 2
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
65
66
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.