MEDINA 9.0.5.0 - Interface - T-Systems
-
Upload
khangminh22 -
Category
Documents
-
view
5 -
download
0
Transcript of MEDINA 9.0.5.0 - Interface - T-Systems
MEDINA 9.0.5.0 - Interface:
Version 1.0
Publication date Last revised 26.02.2020Copyright © 2020 T-Systems International GmbH
Table of Contents1. Introduction ............................................................................................................ 1
1.1. Calling interfaces with MEDINA Monitor ..................................................... 11.2. Calling interfaces without MEDINA Monitor ................................................ 21.3. Optional program parameters ..................................................................... 4
2. CAD Interfaces ...................................................................................................... 72.1. Overview of CAD Interfaces in MEDINA ..................................................... 72.2. CATIA V5 -> Interface CATIA V5 ................................................................ 8
2.2.1. CATIA V5 - Introduction .................................................................... 82.2.2. BIF Conversion using CATIA Runtime ............................................ 10
2.2.2.1. Integrate CATBIF for CATIA V5 into a CATIA V5Installation ........................................................................................... 112.2.2.2. Specific Parameters for the Conversion using CATIARuntime .............................................................................................. 142.2.2.3. Conversion of Metadata ........................................................ 152.2.2.4. Metadata - conversion of unities ........................................... 152.2.2.5. Which versions are available on which operationsystems? ............................................................................................. 16
2.2.3. BIF Conversion not using CATIA Runtime ...................................... 172.2.3.1. Which versions are available on which operationsystems? ............................................................................................. 18
2.2.4. General parameters for the Conversion .......................................... 192.2.5. Calling CATBIF V5 without MEDINA Monitor .................................. 242.2.6. Conversion of CATIA Product structure to BIF ............................... 262.2.7. Conversion of CATIA Solids and Shells to BIF ............................... 272.2.8. Glossary .......................................................................................... 27
2.3. STEP, VDAFS, IGES, JT and SAT ........................................................... 282.3.1. Introduction ...................................................................................... 282.3.2. STEP-BIF -> Interface STEP to BIF ............................................... 34
2.3.2.1. Mapping table STEP - BIF .................................................... 352.3.2.2. Working with large STEP Models ......................................... 412.3.2.3. Logfile contents and messages ............................................ 412.3.2.4. Control parameters ............................................................... 43
2.3.3. VDAFS-BIF -> Interface VDAFS to BIF .......................................... 452.3.4. IGES-BIF -> Interface IGES to BIF ................................................. 482.3.5. JT-BIF -> Interface JT to BIF .......................................................... 502.3.6. SAT-BIF -> Interface SAT to BIF .................................................... 51
iii
MEDINA 9.0.5.0 - Interface
2.3.7. Glossary .......................................................................................... 532.4. STL -> STL Interface ................................................................................ 57
2.4.1. BIFSTL -> Interface BIF to STL ...................................................... 592.4.2. STLBIF -> Interface STL to BIF ...................................................... 60
2.5. Universal File Interface ............................................................................. 612.5.1. UNI-BIF-BOF -> Interface Universal File to BIF and BOF ............... 612.5.2. BIF-BOF-UNI -> Interface BIF and BOF to Universal File ............... 66
3. Modeling Interfaces ............................................................................................. 683.1. AutoSEA -> Interface to AUTOSEA .......................................................... 68
3.1.1. BIFSEA -> Interface BIF to AUTOSEA ........................................... 683.2. PATRAN -> PATRAN Neutral File Interface .............................................. 70
3.2.1. BIFPAT -> Interface BIF to PATRAN ............................................... 703.2.2. PATBIF -> Interface PATRAN to BIF ............................................... 77
3.3. SYSTUS -> Interface to SYSTUS ............................................................. 864. Solver Interfaces .................................................................................................. 88
4.1. ABAQUS -> Interface to ABAQUS ............................................................ 884.1.1. ABAQUS - Control file .................................................................... 884.1.2. BIFABA-> Interface BIF to ABAQUS .............................................. 89
4.1.2.1. BIFABA - Parameters ........................................................... 894.1.2.2. BIFABA - Additional program parameters ............................. 914.1.2.3. BIFABA - Initial conditions .................................................... 934.1.2.4. BIFABA - Automatic node set detection ................................ 954.1.2.5. BIFABA - Beam Sections ...................................................... 95
4.1.3. ABABIF -> Interface ABAQUS to BIF ............................................. 974.1.3.1. ABABIF - Parameters ........................................................... 974.1.3.2. ABABIF - Search for include files ......................................... 99
4.1.4. BIFABA/ABABIF .............................................................................. 994.1.4.1. ABAQUS - Using properties to define element sets ............. 994.1.4.2. ABAQUS - Using Connection elements (CONN3D) ........... 110
4.1.5. ABABOF -> Interface ABAQUS to BOF ........................................ 1114.1.5.1. ABABOF - FIL Interface ...................................................... 1114.1.5.2. ABABOF - ODB Interface ................................................... 1144.1.5.3. ABABOF - Supported result data for ABABOF/ODB .......... 117
4.2. ANSYS -> Interface to ANSYS ............................................................... 1234.2.1. BIFANS -> Interface BIF to ANSYS .............................................. 1234.2.2. ANSBIF -> Interface ANSYS to BIF .............................................. 1244.2.3. BIFANS/ANSBIF ............................................................................ 1264.2.4. ANSBOF -> Interface ANSYS to BOF .......................................... 129
iv
MEDINA 9.0.5.0 - Interface
4.3. AUTOFORM -> Interface to AUTOFORM ............................................... 1314.3.1. AUTOBOF-> Interface AUTOFORM to BOF ................................. 131
4.4. LS-DYNA -> Interface to LS-DYNA ........................................................ 1324.4.1. LS-DYNA - Introduction ................................................................ 1324.4.2. LS-DYNA - Control file .................................................................. 133
4.4.2.1. Processing of materials and sections ................................. 1354.4.2.2. Definition of Template procession ....................................... 136
4.4.3. LS-DYNA - Databases .................................................................. 1374.4.3.1. Material Database ............................................................... 1384.4.3.2. Section Database ................................................................ 1414.4.3.3. Template Database ............................................................. 142
4.4.4. Load Case Processing with BIFDYN ............................................ 1434.4.4.1. Description of Load Case Files ........................................... 1444.4.4.2. Description of Keywords ..................................................... 1444.4.4.3. Examples ............................................................................. 151
4.4.4.3.1. Example 1 ................................................................. 1514.4.4.3.2. Example 2: (MINIMAL-Example) .............................. 1514.4.4.3.3. Example 3 (MAXIMAL-Example) .............................. 152
4.4.5. LS-DYNA - INCLUDE Transform .................................................. 1534.4.5.1. DYNBIF ............................................................................... 1534.4.5.2. BIFDYN ............................................................................... 1604.4.5.3. Supported contact cards in MEDINA .................................. 160
4.4.6. LS-DYNA - Template File for Control Cards ................................. 1614.4.7. LS-DYNA - Processing Control Card Information to PropertyData ......................................................................................................... 1624.4.8. LS-DYNA - Processing Information from Property DataStructure .................................................................................................. 1624.4.9. LS-DYNA - Initial conditions ......................................................... 1624.4.10. LS-DYNA - Method to Generate a Model ................................... 1644.4.11. BIFDYN -> Interface BIF to LS-DYNA ........................................ 165
4.4.11.1. More Additional parameters .............................................. 1674.4.12. DYNBIF -> Interface LS-DYNA to BIF ........................................ 169
4.4.12.1. More Additional parameters .............................................. 1714.4.12.2. Search for include files ..................................................... 1734.4.12.3. DYNBIF: KEYWORD Input ............................................... 1744.4.12.4. DYNBIF: Fix Input Format ................................................ 187
4.4.13. DYNBOF -> Interface LS-DYNA to BOF ..................................... 1884.4.13.1. DYNBOF: Table of results ................................................. 189
v
MEDINA 9.0.5.0 - Interface
4.5. MARC -> Interface to MARC .................................................................. 1904.5.1. BIFMARC -> Interface BIF to MARC ............................................ 1904.5.2. MARCBIF -> Interface MARC to BIF ............................................ 192
4.6. MSC-NASTRAN -> Interface MSC NASTRAN ....................................... 1954.6.1. BIFNAS -> Interface BIF to NASTRAN ......................................... 1954.6.2. NASBIF -> Interface NASTRAN to BIF ......................................... 2034.6.3. NASBOF -> Interface NASTRAN to BOF ..................................... 215
4.7. PAMCRASH -> Interface to PAMCRASH ................................................ 2204.7.1. PAMCRASH - Material Databases ................................................ 2214.7.2. PAMCRASH - Control file ............................................................. 2224.7.3. PAMCRASH - Configuration file .................................................... 2234.7.4. PAMCRASH - INCLUDE files ....................................................... 2234.7.5. PAMCRASH - INCLUDE Transform .............................................. 2234.7.6. PAMCRASH - Starting the Interface ............................................. 224
4.7.6.1. Interface with MedPre ......................................................... 2244.7.6.2. Interface with MEDINA Monitor .......................................... 2254.7.6.3. Interface with shell prompt .................................................. 226
4.7.7. PAMCRASH - PLINK cards / spotweld connectors ....................... 2284.7.8. PAMBIF -> Interface PAMCRASH to BIF ...................................... 2284.7.9. BIFPAM -> Interface BIF to PAM .................................................. 2454.7.10. PAMBOF -> Interface PAMCRASH to BOF ................................ 261
4.8. STARCD -> Interface to STARCD ........................................................... 2664.8.1. BIFSTAR -> Interface BIF to STARCD ......................................... 2664.8.2. STARBIF -> Interface STARCD to BIF ......................................... 268
vi
List of Figures1.1. Starting a window for an interface ..................................................................... 11.2. MEDINA Monitor with interface menu ................................................................ 22.1. "Use predefined CATIA environment" option ................................................... 132.2. SAT-BIF Interface ............................................................................................. 533.1. Visual result ...................................................................................................... 694.1. BIFABA Interface .............................................................................................. 904.2. ABABIF Interface .............................................................................................. 974.3. LS-Dyna data types ........................................................................................ 1334.4. BIFNAS Interface ............................................................................................ 1954.5. NASBIF Interface ............................................................................................ 2044.6. The panel of the MatDBParam command ...................................................... 2224.7. The MedPre Import command panels for PamBif start .................................. 2244.8. The MedPre Export command panels for PamBif start .................................. 2254.9. BIFPAM Interface ............................................................................................ 2264.10. PAMBIF Interface .......................................................................................... 226
vii
Chapter 1. Introduction
1.1. Calling interfaces with MEDINA MonitorEach interface may be called directly from the MEDINA Monitor by clicking the selectionbutton named after the third party product (program or format) the interface is used for.
After clicking the selection button a small menu list appears from which the appropriateinterface can be selected. Usually there is an interface in each direction, i.e. fromMEDINA to the third party product and vice versa.
Sometimes, there are more interfaces available, e.g. one for input and one for results,or interfaces for different versions of the third party product.
After selecting the appropriate interface, an additional monitor window opens fromwhich to choose options and enter the parameters of the interface.
The most common parameters contain an input line in the window, preceded by theparameter name, or the parameter has a button preceding its name.
Figure 1.1. Starting a window for an interface
A line for special text input parameters is reserved under “Additional programparameters”.
Further optional parameters can also be entered at the line “Additional programparameters” but with a special format as described below.
1
Introduction
Figure 1.2. MEDINA Monitor with interface menu
1.2. Calling interfaces without MEDINAMonitorEach interface may be called directly without MEDINA Monitor by calling its startupscript as command line.
All startup scripts are to be found in directory:
<inst_directory>/cae/bin
If an interface startup script is called without any required parameters, the commandusage is shown. Required parameters are listed without brackets.
2
Introduction
Optional parameters are enclosed in square brackets “[…]”. Parameter values arespecified by key=value, where key is the parameter name and value is the parametervalue.
Parameters without values are specified by key, where key is the parameter name. Ifparameter values are shown as enumeration enclosed in braces “{…}” and separatedby a vertical bar “|”, only items of the enumeration are valid values.
For UNIX example, call:
<inst_directory>/cae/bin/bif bif=name dat=name [dir=name]
[log=name] [batch] [bit={32|64}]
For Windows example, call:
tclsh <inst_directory>/cae/bin/bif.tcl bif=name dat=name
[dir=name] [log=name] [batch] [bit={32|64}]
If optional parameters are omitted, the first value of the numeration is the default value.
On the following pages, the UNIX syntax will be used to describe command lineparameters.
Optional parameters are denoted in squared brackets [ ]. Some are specific to theinterface, some are common to several interfaces and some are only available throughthe opt parameter.
Note
For description of all options and arguments of an interface go into theinstallation directory for load modules and enter the desired interface (e.g.NASBOF).
The following optional parameters are common to (almost) all interfaces:
Parameter Meaning
dir=name Name is the path name of the workingdirectory, where all files with relative filenames are to searched or created. Thedefault working directory is the currentdirectory.
log=name Name is the log output file name. Thedefault file name is the interface’s name
3
Introduction
Parameter Meaningwithout MEDINA version suffix, appendedby file type suffix .log. The default log filewill be created in the working directory(e.g. bif.log).
batch If this parameter is specified, the outputis written to the standard output streamstdout. If not specified, output is scrolledinteractively in pages using the operatingsystem command more.
bit={32|64} If the value 64 is used, 64-bit executablesare used (if available). If the parameteris set to value 32 or 64-bit executablesare not available, 32-bit executables areused instead. Default value for 64-bitprocessors is 64, for all other processors32.
warning=number Complete warning message report.
See also Optional program parameters in the next chapter.
1.3. Optional program parametersOptional program parameters are parameters rarely used in interfaces and thereforenot included in start windows of MEDINA Monitor.
Likewise, they are not displayed on command line prompt if interface is called withoutMEDINA Monitor.
These parameters are only described in this reference manual.
Entering optional parameters with MEDINA Monitor
Optional parameters must be entered in field “Additional program parameters” and arespecified by additional program parameter “opt”.
Syntax rules:
-parameter value value is to be assigned to parameter
4
Introduction
If value contains no spaces, type:
"opt=-parameter value"
If value contains spaces, type:
{opt=-parameter "value"}
Example 1:
To assign file name myfile to
parameter clayer, type:
"opt=-clayer myfile"
Example 2:
To assign file name my file to
paramater clayer, type:
{opt=-parameter "my file"}
Entering optional parameters without MEDINA Monitor
If interface is called from command line, optional parameters must be entered after allother parameters and are specified additional command line parameter “opt”.
Syntax rules:
-parameter value value is to be assigned to parameter
If value contains no spaces, type:
'opt=-parameter value'
If value contains spaces, type:
'opt=-parameter "value"'
Example 1:
To assign file name myfile to
parameter clayer, type:
'opt=-clayer myfile'
Example 2:
To assign file name my file to
paramater clayer, type:
'opt=-parameter "my file"'
5
Introduction
Note that single quotation marks are used instead of double quotation marks andbraces.
6
Chapter 2. CAD Interfaces
2.1. Overview of CAD Interfaces in MEDINA
CATIA Interface
COM/FOX (CXP)
CAA non CAA
Datakit(OCC)
MEDINA 8.5 Windows Yes Yes No
Linux No Yes No
Windows Yes Yes YesMEDINA 9.0.3.2
Linux No Yes Yes
The abbreviations are described in the table below:
Abbreviation Description Use in MEDINA
CAA CATIA ApplicationsArchitecture (needs a CATIAInstallation)
File/Import/UseCATIA
non CAA Interface doesn't need aCATIA Installation
File/Import/NotUseCATIA/COM_FOX
Datakit (OCC) Interface from Datakit,converts the geometrydirectly into the OpenCascade (OCC) format usedin MEDINA
File/Import/NotUseCATIA/DATAKIT
Other CAD Interfaces
COM_FOX (CXP) OPEN_CASCADE
JT Yes No
STEP Yes Yes
IGES Yes Yes
BREP No Yes
7
CAD Interfaces
2.2. CATIA V5 -> Interface CATIA V5This chapter is intended to support the work with the CATBIF V5 conversion program.
CATBIF V5 enables the unidirectional data conversion CATIA V5 –> BIF.
The CATBIF V5 interface will export CAD data and assembly parts defined in CATIAV5 format to MEDINA, creating a BIF file.
2.2.1. CATIA V5 - Introduction
BIF
MEDINA's data structure is based on the BIF format and additionally supportsassembly parts.
The BIF format includes the following geometric elements:
BIF Description Catia V5 Interface
POINT Point < supported >
LINE Connection between 2 points < supported >
(converted to point sequence)
PLANE Plane < not supported >
PSET Point sequence < supported >
CURVE Curve < supported >
SURF Surface < supported >
ARC Circle (circular arc) < supported >
(converted to curve)
CIRCLE Circle (full circle) < supported >
CONS Curve on surface < supported >
FACE Bounded surface < supported >
TOP Coherent groups of faces < not supported >
General remarks
Return Codes:
8
CAD Interfaces
COM/FOX reports error conditions and certain conversion results via the programreturn code.
Note that it is recommended to check the logfile either manually or automatically to getmore information about the conversion result. The return code is only a hint to indicatethat something has failed, it does not provide any detailed information.
Different COM/FOX releases may report different return codes for the sameconversion.
The main reason for different return codes for the same input file with different COM/FOX releases is usually a change in underlying technology like the JT toolkit.
In case the JT toolkit reports more or less errors to COM/FOX, the return code mightchange from 6 to 12 or from 12 to 6.
Note that the default value for RtcGeoLimit and RtcPmiLimit is five, therefore assoon as five geometry or PMI errors are encountered or reported by the JT toolkit thereturn code is changed from 6 to 12 or from 5 to 11.
Note that return codes have a certain priority and a return code with a higher prioritywill override a return code with a lower priority.
Since COM/FOX V4.3.7, the non CAA CATIA V5 Reader maps the CATIA assemblystructure to the corresponding product structure into BIF in the same way as the CATIACAA interface does.
Order of priority from low to high:
0 Success
1 LICMAN license is missing
2 Unspecific error during processing
3 Failed to process all assembly elements
4 No geometry processed
5 Failed to process some PMI elements
6 Failed to process some geometry elements
7 V4 to V5 migration error
8 Fatal error during processing
10 CATIA session creation failed
11 Failed to process more than RtcPmiLimit PMI elements
12 Failed to process more than RtcGeoLimit geometry elements
9
CAD Interfaces
Note
A return code of 6 indicates that there are some errors during geometryconversion, but this does not mean that there are no PMI errors at all becausereturn code 6 has a higher priority than return code 5.
COM/FOX and the JT toolkit are used by MEDINA interfaces.
2.2.2. BIF Conversion using CATIA Runtime
The CATBIF V5 converter can be invoked interactively from MEDINA Monitor or inbatch mode.
MEDINA supports the CATIA V5 Releases 19, 21, 22 and 24 (see section SpecificParameters for the Conversion using CATIA Runtime for specific parameters).
MEDINA Monitor:
10
CAD Interfaces
Interface Version:
Convert geometry:
Convert thick surface:
2.2.2.1. Integrate CATBIF for CATIA V5 into a CATIA V5Installation
To use CATBIF for CATIA V5 you have to start CATBIF together with a CATIAenvironment which fits for your CATIA installation.
There are two possibilities to achieve this:
1. Using a CATIA environment file
2. Starting the MEDINA Monitor from a CATIA environment
Using a CATIA environment file
11
CAD Interfaces
If you have a default CATIA installation you need a CATIA environment file which fitsfor your installation.
You can find an environment file in the folder /CATEnv on Windows in the folder:
C:\Documents and Settings\All Users\Anwendungsdaten
\DassaultSystemes\CATEnv (German Windows installation).
If you are using a customized CATIA installation, please ask your local CATIAadministrator how to obtain a valid environment file.
Note
Currently, the CATBIF for CATIA V5 interface supports 64 bit.
Enter the full path to the CATIA environment file into the CATBIF start window.Additionally, it is required to specify the CATIA installation path.
Note
On Windows platforms the CATBIF dialog window enters the path to the CATIAinstallation automatically; please verify that the entered path is correct.
Starting the MEDINA Monitor from a CATIA environment
Start a command shell with a CATIA environment and, from this shell, start the MEDINAMonitor.
Then, the CATIBIF dialog panel allows to select the check box labeled "Use predefinedCATIA environment".
12
CAD Interfaces
Figure 2.1. "Use predefined CATIA environment" option
There is no need to specify the CATIA installation directory or an environment filebecause all required information is gathered from the CATIA environment.
Please ask your local CATIA installation administrator how to start a command shellwith a CATIA environment.
This second possibility is the recommended way to use CATBIF as it is often difficultfor the end-user to get a correct environment file, especially in the case where acustomized CATIA installation is used.
F.A.Q.:
• What is a CATIA environment?
13
CAD Interfaces
A CATIA environment is a set of environment variables which have to bedefined when the main CATIA program executable "cnext" is started. Usually,the environment is either setup by the Dassault Systèmes CATIA V5 start script"catstart" or through your local CATIA startup procedure.
• When I start CATBIF I get an error message like:
Possible reason: No CATIA configuration license selected
Error: 21
-------------------------------------------------------
Internal error: execution stopped
Use one of the above described methods to select a valid CATIA environment. TheCATIA license to use is defined via the CATIA environment.
Note
If you use a newly installed default CATIA installation (no customization) it isrequired to start CATIA once to select the license to use. The same settingwill be used by CATBIF as long as the same environment file is used.
2.2.2.2. Specific Parameters for the Conversion using CATIARuntime
This CATBIF V5 processor can be controlled by several options.
The option for Thick Surfaces conversion is only available in the converter using theCATIA runtime.
Convert thick surface
Mid-surfaces may be created out of thick surfaces. Optionally only the mid-surfaces,the surface or both of them will be transferred to BIF.
This is determined by the following parameters:
• Body (Default):
Only the surface of the thick-surfaces will be transferred (as it was before).
• MidSurface:
14
CAD Interfaces
Only the mid-surfaces of the thick-surfaces will be transferred
• Body and MidSurface:
Both mid-surfaces and surfaces of the thick-surfaces will be transferred.
2.2.2.3. Conversion of Metadata
You now can convert CATIA metadata (part material data, color, transparency, sheetthickness, ...) to BIF.
There are two approaches for the evaluation of CATIA metadata:
• using standard CATIA functions based on CATIA material database
• using Daimler metadata standard process based on Daimler CATIA start model
This is reflected in the option "Convert meta data according to".
This option has two possibilities:
• CATIA material database
• Daimler standard process
Note
Setting "Daimler standard process" of parameter "Convert meta data accordingto" requires Daimler's designer tool box to be installed within CATIA.
This tool box is shipped by Daimler to its subcontractors, too. It is NOT shippedwith MEDINA distribution.
To verify that tool box has been installed, check existence of file below with yourCATIA installation:
<Catia install dir>\B19\win_b64\resources\graphic
\DCMMstMasterData.CATfct
2.2.2.4. Metadata - conversion of unities
From
15
CAD Interfaces
CatiaMaterialPar Young Modulus = " 7e+010N_m2"
or
CatiaMaterialPar Young-Modul = " 7e+010N_m2"
create
.CAD Material Density_SI = 70000
From
CatiaMaterialPar Poisson Ratio = " 0,346"
or
CatiaMaterialPar Poisson-Faktor = " 0,346"
create
.CAD Material Poisson Ratio_SI = 0.346
From
CatiaMaterialPar Density = "2710kg_m3"
or
CatiaMaterialPar Dichte = "2710kg_m3"
create
.CAD Material Density_SI = 2.71e-9
From
CatiaMaterialPar Thermal Expansion = " 2,36e-005_Kdeg"
or
CatiaMaterialPar Wärmeausdehnung = " 2,36e-005_Kdeg"
create
.CAD Material Thermal Expansion_SI = 2.36e-005
From
CatiaMaterialPar Yield Strength = " 9,5e+007N_m2"
or
CatiaMaterialPar Elastizitätslimit = " 9,5e+007N_m2"
create
.CAD Material Yield Strength_SI = 95
2.2.2.5. Which versions are available on which operationsystems?
The CATIA version V5 Releases 19, 21, 22 and 24 are available and supported byWindows 64-bit (wnt_ix86_64) operating system.
16
CAD Interfaces
2.2.3. BIF Conversion not using CATIA RuntimeYou can convert CATIA V5 data without using a CATIA runtime library or license. Forthat, choose one of the two available interfaces: COM_FOX or DATAKIT.
Note
DATAKIT converts geometry directly into the Open Cascade (OCC) formatused in MEDINA. This interface uses a library of Datakit (http://www.datakit.com[http://www.datakit.com/]).
The currently provided version for MEDINA CATIA V5 -> BIF interface is a Pre-Release,which can indeed convert geometry but no assembly structures or midsurfaces.
This CATBIF V5 converter can be invoked interactively from MEDINA Monitor or inbatch mode.
Depending on the selected conversion interface, one of the following windows isdisplayed:
CATIA V5 - > Bif not using CATIA runtime (COM FOX)
17
CAD Interfaces
For the description of the window parameters, see the General parameters for theConversion chapter.
CATIA V5 - > Brep not using CATIA runtime (DATAKIT)
Two additional conversion parameters are available in this window:
• Convert invisible entities
Check this parameter to convert both visible and invisible entities to BIF. If it isunchecked, only entities in SHOW are converted.
• Write reference planes as hidden
Check this parameter if you don't want to convert reference planes. If it is unchecked,reference planes are converted to BIF.
2.2.3.1. Which versions are available on which operationsystems?
CATBIF V5 is supported by the following operation systems: wnt_ix86_64 andlnx_86_64.
18
CAD Interfaces
2.2.4. General parameters for the Conversion
Both CATBIF V5 processors (with and without using CATIA runtime) can be controlledby several options.
The MEDINA Monitor allows these options to be set in a straight forward way.
Interface version
Use this button to select the desired Catia V5 Release (for using CATIA runtime). Fornot using CATIA runtime the interface version is detected automatically (Auto-detect).
Approximation tolerance
This parameter specifies the tolerance to be used during conversion in cases whereapproximation is required (e.g., for degree reduction of B-spline surfaces).
A positive real value has to be provided, it is interpreted as a millimeter value regardlessof the length unit used in the input file. The default value is 0.01.
Convert geometry
Use this button to select which Catia geometry shall be converted to BIF. Choose oneof the following options from the drop-down list:
All The complete Catia geometry (Show+Noshow) will be converted toBIF.
Show Only the Catia show geometry will be converted to BIF.
Noshow Only the Catia noshow geometry will be converted to BIF.
Options file
Use this field to select an options file. Press the question button "?" to open the fileselection window.
If the field is empty, the default file from the installation will be used.
Example of options file:
19
CAD Interfaces
Use # as first character if the parameter shall be ignored (comment character) .
The parameter will be used, if it begins with - .
If the options file vdabif.opt exists, it will be searched first in the current directory andthen in HOME directory. Otherwise, the cxpbif.opt file will be searched in the installationdirectory.
You will find further descriptions for available parameters in this section.
After definition you have to close the editor to start the Catia interface with the desiredparameter definitions.
Note
Some options are not directly available in the MEDINA Monitor. To specifythese options use the additional input field. This input field is located on the'Parameter' page.
The available options (and shortcuts) for CATBIF V5 are together with this syntax inthe batch mode option file:
Common options:
• Input file: -InFile, -if
The only mandatory option, i.e. all other options are optional. Specifies the name(including path) of the CATIA document to convert.
Example: -InFile=C:/abc/xyz.model or if=C:/abc/xyz.model
• Output file: -OutFile, -of
20
CAD Interfaces
Name (including path) of the BIF output file to create.
Default: If this option is omitted, CATBIF V5 will use the name of the input file, withoutits extension and with the extension '.bif added.
Example: -OutFile=C:/Data/File.bif
• Log file: -Logfile, -log
Name (including path) of the conversion protocol to create.
Default: If this option is omitted, CATBIF V5 will use the name of the input file, withoutits extension and with the extension '.log' added. When running, the convertercreates a log file with time stamp, statistics of processed entities and informationmessages, warnings and errors.
Example: -LogFile=C:/logData/aLogFile.log
• Output format: -OutFormat, -fmt
This parameter determines the type of the output format and can’t be omitted.
The possible value is:
"BIF": BIF for MEDINA.
Example:-OutFormat=BIF
• Verbosity: -Verbosity, -vb
Verbosity of the log file, possible values are:
"Error": (default): print only errors, no information messages and warnings
"Info": print information messages, warnings, and errors
"Warning": print warnings and errors, suppress information messages
"Trace": trace the elements processed.
Example: -Verbosity=Trace
• Output mode: -OutMode, -om
Controls the creation of the output file, possible values are:
21
CAD Interfaces
"Replace":(default): replace an existing file without question
"New": stop processing if the output file already exists.
Example: -OutMode=New
• Approximation tolerance: - ApproximationTol, -ac
Specifies the tolerance to use during the conversion in cases where approximationis required (e.g., for degree reduction of B-spline surfaces).
A positive real value has to be provided, it is interpreted as a millimeter valueregardless of the length unit used in the input file. The default value is 0.01.
Example: -ApproximationTol=0.01
• Brep tolerance: -BrepTol, -brt
Tolerance for Brep conversion in millimeters.
Default: 0.004.
Example: -BrepTol=0.004
This option is not directly available in the MEDINA Monitor.
• Edge tolerance: -EdgeTol, -edt
Tolerance for edges in millimeters.
Default: 0.004.
Example: -EdgeTol=0.004
This option is not directly available in the MEDINA Monitor.
Further Options valid for CATIA to BIF conversion
The following parameters only work if they are entered in the options file:
• Line mapping: -LineMap, -lnm
Controls how lines are converted from CATIA to BIF, possible values are:
Curve: converts a CATIA line into a BIF CURVE element (default).
22
CAD Interfaces
PSET: converts a CATIA line into a BIF PSET element.
Example: -LineMap=PSET
• Body mapping: -BodyMap –bom
Controls how CATIA part or open bodies are mapped to BIF, possible values:
Set: converts each part/open body into a SET (default).
Group: converts each part/open body into a GROUP.
Example: -BodyMap=Set
• Hollow body: -VoidMap
The hollow body had to be translated by the interface and affects how voids in solidsare mapped, possible values:
Map: convert voids.
Suppress: voids are not converted, this skips interior shells of the solids (e.g. inorder to reduce the file size).
This option is available only in case of STEP input data.
Example: -VoidMap=Map
• Select geometry from Show/NoShow:
• -ConvertVisibleGeometry -cvg
• -ConvertInvisibleGeometry -civg
Possible combinations:
cvg civg Effect
Yes No Only visible geometry will be converted (default)
No Yes Only geometry from NoShow will be converted
No No No geometry will be converted
Yes Yes All geometry will be converted
Example: -cvg=yes -civg=no (only visible geometry)
23
CAD Interfaces
• Select invisible CATProducts/CATParts
• -ConvertInvisibleProducts (=yes/=no)
ConvertVisibleGeometry affects several geometric elements in the CATPart whileConvertInvisibleProducts affects CATProducts/CATParts.
A CATPart may contain as many geometric elements as desired.
ConvertInvisibleProducts takes effect at a higher level in the whole structure.
Only in converter using CATIA runtime
Convert thick surface
-ConvertThickSurface (=Body/=Surface/=BodyandSurface)
One of the following options can be selected:
• Body: only the surface of the thick-surfaces will be transferred. This option is setby default.
• Midsurface: only mid-surfaces of the thick-surfaces will be transferred.
• Body and Midsurface: both midsurfaces and surfaces of the thick-surfaces will betransferred.
2.2.5. Calling CATBIF V5 without MEDINA Monitor
Call:
<inst_directory>/cae/bin/cat5bif dat=name bif=name [rel={19|
20|21|22|24}] [runtime={catia|datakit}] [useenv] [catdir=name]
[catenv=name] [options=name] [apptol=num] [geom={all|
show|noshow}] [thicksurface={body|surface|bodyandsurface}]
[metadata={catia|daimler}] [msg={0|1}] [dir=name] [log=name]
[batch] [bit={32|64}]
If optional parameters are omitted, the first value of the numeration is the default value.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. catbif).
24
CAD Interfaces
Option Meaning
dat Specifies the name (including path) of the CATIA document toconvert.
bif Name (including path) of the BIF output file to create.
default If this option is omitted, CATBIF V5 will use the name of the inputfile, without its extension and with the extension '.bif added.
rel Use rel={19|20|21|22|24} for CATIA V5 release.
runtime Use catia or datakit to start CATBIF with or without runtimelibrary.
useenv Use a predefined CATIA environment (see also sectionIntegrate CATBIF for CATIA V5 into a CATIA V5 Installation).
catdir Directory of the CATIA installation.
catenv Name and directory of the CATIA environment file (see alsosection Integrate CATBIF for CATIA V5 into a CATIA V5Installation).
options Name and directory of the options file.
apptol Specifies the tolerance to use during the conversion in caseswhere approximation is required (e.g., for degree reduction ofB-spline surfaces).
A positive real value has to be provided, it is interpreted as amillimeter value regardless of the length unit used in the inputfile.
The default value is 0.01.
geom Defines which geometry will be processed (also see sectionSpecific Parameters for the Conversion using CATIA Runtime.
msg Additional log-file of the STEP toolkits, not relevant for CATBIF.
Default is 0 for no logfile.
The following parameters are valid for all interfaces and are explained in section 1.2:dir, log, batch, bit, warning.
Note
Currently, the CATBIF interface without runtime library only supports 32 bit.
25
CAD Interfaces
The following table describes the mapping of CATIA entities of the geometry levelsto BIF:
CATIA BIF Mapping Rem.
Geometry
3D wireframe
CATPoint POINT 1-1
CATCurve CURVE 1-1
CATCircle CURVE 1-1
CATLine CURVE, PSET 1-1
CATNurbsCurve CURVE 1-1
CATEllipse CURVE 1-1
CATSplineCurve CURVE 1-1
Surfaces
CATSurface SURFACE 1-1
CATFace FACE 1-1
CATEdge CONS 1-1
Additional elements
CATShell GEOMETRY SET
CATBody GEOMETRY SET
CATWire GEOMETRY SET
Mapping cardinality
The CATIA entity is mapped to exactly one corresponding equivalent BIF element.
2.2.6. Conversion of CATIA Product structure to BIF
Since BIF does not support ditto parts, the CATIA product structure will be completelyexploded on export to BIF. The entire assembly will result in one single BIF file.
The created MEDINA parts will get an unique, non-empty label corresponding to theCATIA product name. The MEDINA part codes will be set according to the CATIAproduct identifiers.
26
CAD Interfaces
Note
All CATIA documents other than CATProducts and CATParts that might appearwithin the product structure (e.g. a CATIA V4 model or CGR) will not beconverted.
2.2.7. Conversion of CATIA Solids and Shells to BIFFor CATIA PartBodies (i.e. Solids) the BRep (Boundary Representation) is extracted,for CATIA Shells the bounding faces are retrieved.
For both cases, the resulting set of trimmed surfaces is then exported to BIF.
Curves and surfaces in BIF are described in a power basis form. Hence, on export toBIF the CATIA geometry has to be converted in several steps including approximationfrom rational B-spline with a non-rational curve, basis conversion from B-spline topower basis and recreation of trim curves in the parameter space of surfaces.
The accuracy for these conversions, which is the maximum distance allowed betweenthe approximation and the original geometry, can be specified with certain controlparameters (ApproximationTol, BRepTol, EdgeTol).
Since MEDINA 8.1 and CATIA V5 R17 it can be defined an additionally option for midsurface generation:
2.2.8. GlossaryCATIA
CATIA is one of the world's leading CAD/CAM/CAE software systems.
CATIA provides integrated solutions tailored to the needs of small and medium sizedenterprises as well as large industrial corporations in all industries.
BIF
BIF is the native file format of MEDINA. Its geometric data structures are inspiredby VDAFS format. Besides VDAFS’ geometrical entities, BIF additionally supportsassembly parts, called parts.
27
CAD Interfaces
Boundary representation (BRep)
BRep models represent a solid directly by a representation of its bounding surface.A BRep solid is represented as a volume contained in a set of faces together withtopological information, which defines the relationships between the faces.
Because BReps include such topological information, a solid is represented as a closedspace in 3D space. The boundary of a solid separates points inside from points outsideof the solid.
Continuity of curves and surfaces
In computer aided design it is important to understand the principals of G2 or C2curvature continuity and how to use these principles when creating a design.
The attractive free flowing shapes we see on the market today are almost alwayscreated in a high end surface modeler that can create and check for curvaturecontinuous conditions.
If a model is created with the major visible surfaces being curvature continuous thehuman eye can detect no instant changes in curvature and therefore perceives thesurface to be continuous and "correct".
Mathematically speaking, a curve is called G1 continuous (G for geometric) ifthe tangent directions coincide at neighboring segment endpoints. However, theirmagnitudes may be different.
If the magnitudes are equal and the first derivative is continuous we have C1 continuity.G1 continuity implies that the curve is visually continuous (smooth) but may have adiscontinuity in the parameterization.
Considering the second derivative representing the curvature of the curve, analogicallywe can determine the C2 continuity or curvature continuity.
2.3. STEP, VDAFS, IGES, JT and SAT
2.3.1. Introduction
This User Manual is intended to support the work with the product STEPBIF, VDABIF,JTBIF, IGESBIF and SATBIF conversion programs.
28
CAD Interfaces
The STEPBIF and JTBIF interfaces will import CAD data and assembly structuresdefined in JT format into MEDINA, creating a so called BIF file (binary input CAEdatabus format).
The other interfaces will import CAD data only, defined in VDAFS, IGES and SATformats into MEDINA, creating a BIF file.
Assembly structures will be exploded on import of IGES and SAT.
STEP - The standard for product data
With the International Standard ISO 10303 (STEP: Standard for the Exchange ofProduct Model Data) it is possible to describe product model data for exchange,storage and archiving.
The product data which can be described by STEP include the data of all productsthroughout the entire life cycle of the product.
Description of product data
A product data model includes not only geometry data but also the structure data of theproduct, e. g. product identifying data or assembly structures and more technologicaldata, like tolerances or material properties.
On the basis of STEP you can realize an integration of geometry data and productstructure data, for example between CAD/CAM and parts list application systems.
This is a clear delimitation from the standards applied today (IGES, VDAFS, and SET)with which in essence only geometry data can be exchanged.
Therefore STEP is:
• more than just a new standard for data exchange, it is
• the entry into a new technology: the product data technology.
An essential aspect of the description of product data is the so-called productidentifying data, which are mandatory with each data exchange.
This includes the identifiers and the descriptions of the product (e. g. the productidentifier), the version of the product and the type of the product describing data. Ifthese are not available in the CAD system, they have to be extracted from an attachedEDM system or specified by the user through data entry panels.
29
CAD Interfaces
The program STEPBIF offers flexible configuration possibilities for the data entrypanels and for the default values.
STEP standardizes product model data which are independent from their form ofimplementation, e. g. sequential exchange file or data base.
Therefore, the data models are defined in the formal data definition languageEXPRESS so that contrary to the present standards not only the syntax but alsothe semantics are formally described. These formal descriptions can be processedautomatically by different tools.
General remarks
Return Codes:
COM/FOX reports error conditions and certain conversion results via the programreturn code.
Note that it is recommended to check the logfile either manually or automatically to getmore information about the conversion result. The return code is only a hint to indicatethat something has failed, it does not provide any detailed information.
Different COM/FOX releases may report different return codes for the sameconversion.
The main reason for different return codes for the same input file with different COM/FOX releases is usually a change in underlying technology like the JT toolkit.
In case the JT toolkit reports more or less errors to COM/FOX, the return code mightchange from 6 to 12 or from 12 to 6.
Note that the default value for RtcGeoLimit and RtcPmiLimit is five, therefore as soonas five geometry or PMI errors are encountered or reported by the JT toolkit the returncode is changed from 6 to 12 or from 5 to 11.
Moreover, return codes have a certain priority and a return code with a higher prioritywill override a return code with a lower priority.
Order of priority from low to high:
0 Success
1 LICMAN license is missing
30
CAD Interfaces
2 Unspecific error during processing
3 Failed to process all assembly elements
4 No geometry processed
5 Failed to process some PMI elements
6 Failed to process some geometry elements
7 V4 to V5 migration error
8 Fatal error during processing
10 CATIA session creation failed
11 Failed to process more than RtcPmiLimit PMI elements
12 Failed to process more than RtcGeoLimit geometry elements
Note
A return code of 6 indicates that there are some errors during geometryconversion but this does not mean that there are no PMI errors at all becausereturn code 6 has a higher priority than return code 5.
COM/FOX and the JT toolkit are used by the MEDINA interfaces.
STEP Application Protocols
ISO 10303 (STEP) is a very complex standard. Therefore it is published in variousparts which are based on a specific document structure.
The parts of STEP which can be implemented are called Application Protocols(APs).These are the application relevant and implementable parts of the entire STEPstandard.
Since 1994 STEP is available as an International Standard in several parts with a totalvolume of much more than 3000 pages.
The following STEP Application Protocols are available as International Standard:
• AP 201 ‘Explicit draughting’:
Technical drawings with 2D geometry and explicit dimensions.
• AP 202 ‘Associative draughting’:
Technical drawings with 3D geometry and associative dimensions.
• AP 203 ‘Configuration controlled design’:
31
CAD Interfaces
Product structure and configuration data with 3D geometry in variousrepresentations.
One more important Application Protocol that becomes international standard in 2001according to ISO 10303 is:
• AP 214 ‘Core data for automotive mechanical design processes’:
The data of the development processes in the automotive industry.
Since the data models in the Application Protocols become sometimes very large andcomplex, they cannot always be implemented entirely.
Therefore, and because in specific cases of data exchange partial scopes are moreefficient, an AP’s data model is subdivided into so-called "Conformance Classes".
These are partial scopes of an Application Protocol that can be implemented.
Supported EXPRESS schemas
The STEP-BIF conversion program supports the following schemas:
• AP 214 ‘Conformance Class 20’:
Complete schema automotive_design for AP214 IS and DIS version
• AP 203 ‘3D geometry (possibly with assembly structures)’:
Config_control_design for AP 203 IS version (1994) AP 203 corresponds to theInternational Standard (IS) from 1994 for AP 203 [3].
VDAFS (VDA-Flächen-Schnittstelle, VDA surface interface)
The VDAFS (VDA-Flächen-Schnittstelle, VDA surface interface) is a system neutralCAD format. It has been created by the department ”CAD/CAM” of the GermanAutomobile Industry Association to simplify the exchange of 3D geometry andparticularly of free form surfaces between various CAD systems.
VDAFS currently exists in the versions 1.0 and 2.0. Version 1.0, which has been a DINStandard (DIN 66301) since 1986, includes the following geometrical elements:
POINT Point
32
CAD Interfaces
PSET Point sequence
MDI Point vector sequence
CURVE Curve
SURF Surface
Curves and surfaces are described in the VDAFS format by polynomial coefficients.
Description in the VDAFS format is thus independent of the mathematicalapproximation methods which are the basis of the geometry.
In contrast to the CAD systems, there are no restrictions in VDAFS regardingpolynomial degree and number of polynomial segments per curve and surface.
In addition to the geometry elements, there are also the following elements:
HEADER Header label
BEGINSET Beginning of a set
ENDSET End of a set
$$ Commentary line
END End label
In Version 2.0 all the elements of Version 1.0 are retained with their validity unchanged.The only exception is the HEADER element, which now must have a fixed form.
Others geometrical elements are also presented:
CIRCLE Circle
CONS Curve on surface
FACE Bounded surface
TOP Coherent groups of faces
The elements CONS, FACE and TOP enable complex surface data to be transferred.
In addition to these geometry elements, there are also in VDAFS Version 2.0 theelements:
GROUP Group
33
CAD Interfaces
TMAT Transformation matrix
TLIST Transformation list
Further elements were deliberately foregone in VDAFS. It is not possible therefore totransfer, for example, dimensions and representation attributes via VDAFS.
A file with data in the VDAFS format is a simple sequential file. There is a fundamentaldifference, however, between the two versions in the structural configuration of aVDAFS file.
The geometrical elements of Version 1.0 are all defined singularly and are completelyindependent in their description from all other geometrical elements in the same file.
Ignoring the set assignment, the sequence of elements in the file is, therefore, of nosignificance. Manipulating an element in the editor, for example, also does not affectthe description of any other element of the file.
In Version 2.0, by contrast, there are element types which in their description relateto other elements and do not obtain their geometrical significance without thosesupporting elements.
Elements which are related to other elements, must be listed before these in thesequential sequence in the file.
As a result of these possible back-references, the structure of a file with data ofVDAFS Version 2.0 may become so complex that manual manipulation destroys thefile structure. Consequently, it is also no longer possible as a general rule to split upa file into several parts.
The VDABIF conversion program operates on the basis of VDAFS Version 2.0, theelement TOP is not being supported, though.
2.3.2. STEP-BIF -> Interface STEP to BIF
The STEPBIF interface will import CAD data and assembly structures defined in STEPformat into MEDINA , creating a so called BIF file (binary input CAE databus format).
The table Mapping table STEP - BIF describes the mapping of STEP entities of productstructure and of the geometry levels to BIF.
The remarks in the right-hand column of the table are only related to the conversionof the STEP entities in the corresponding line.
34
CAD Interfaces
2.3.2.1. Mapping table STEP - BIF
STEP MEDINA Data Element MC Rem
Product structure
S1: product management data
Product,
Product_definition_formation,
Product_definition,
Shape_representation
PART (9001), each information yieldsan extended string attributes of rootpart
1-M
S2: element structure
Mapped_item,
Representation_map,
Shape_representation
PART (9001), each instance of themapped item yields an extra part withunique, non empty label.
M-N 0 , 0
Mapped_item,
Representation_map,
Draughting_model
not supported -- 0
Presentation_layer_assignment GGROUP (4025), layer names arepreserved
1-1 3
Applied_group_assignment GGROUP (4025), group names arepreserved
1-1 0
Representation_context,
Geometric_representation_context,
Global_unit_assigned_context,
Global_uncertainty_assigned_context
Geomeric_representation_context isignored.
Units are transformed to mm.
Closure tolerance of STEP istransformed to MEDINA geometrytolerance RESTART (10001).
M-1 0
S3: item definition structure
Next_assembly_usage_occurrence(variant 1),
PART (9001), each instance of theassembly yields an extra part withunique, non empty label.
M-N 0 , 0
35
CAD Interfaces
STEP MEDINA Data Element MC RemMapped_item,
Representation_map,
Shape_representation
Next_assembly_usage_occurence(variant 2),
Representation_relationship,
Shape_representation
PART (9001), each instance of theassembly yields an extra part withunique, non empty label.
M-N 0 , 0
E1: external reference mechanism
Shape_representation,
External_source,
Document_file
PART (9001), each external referenceof the STEP file is transformed to anexternal reference of a MEDINA part.
1-1 0 , 0
Geometry
G2: 3D wireframe
Cartesian_point GPOINT4 (4001) 1-1
Trimmed_curve, Line GLINE4 (4002) M-1 0
Trimmed_curve, Circle GCIRCLE4 (4005) M-1 0
Trimmed_curve, Ellipse GCURVE8 (4114) M-1
Trimmed_curve, Parabola GCURVE8 (4114) M-1
Trimmed_curve, Hyperbola GCURVE8 (4114) M-1
Curve_replica, Curve GCURVE8 (4114) M-1
Polyline GPSET4 (4006) 1-1 4
Offset_curve_2D/3D GCURVE8 (4114) 1-1
Composite_curve,
Composite_curve_segment
GCURVE8 (4114) 1-M
B_spline_curve GCURVE8 (4114) 1-1
G3: surfaces
B_spline_surface GSURF8 (4116) 1-1
36
CAD Interfaces
STEP MEDINA Data Element MC Rem
Plane GPLANE4 (4003) 1-1
Conical_surface GSURF8 (4116) 1-1
Cylindrical_surface GSURF8 (4116) 1-1
Spherical_surface GSURF8 (4116) 1-1
Toroidal_surface,
Degenerate_toroidal_surface
GSURF8 (4116) 1-1
Offset_surface GSURF8 (4116) 1-1
Surface_of_linear_extrusion GSURF8 (4116) 1-1
Surface_of_revolution GSURF8 (4116) 1-1
Surface_replica, Surface GSURF8 (4116) 1-1
Surface_curve, Pcurve GCURVE8 (4114) plus 2x GCONS8(4122)
1-3 0
Advanced_face,
Face_outer_bound,Face_bound
Edge_loop, Oriented_edge,
Edge_curve,
Surface_curve, Surface
GFACE (4023) 1-M 0
Shell_based_surface_model,
Open_shell /Closed_shell,
Advanced_face
STRUKTUR (106) M-1 0 , 0
G4: faceted brep
Faceted_brep,
Face_surface,
Poly_loop
not supported -- 0
G5: brep
37
CAD Interfaces
STEP MEDINA Data Element MC Rem
Manifold_solid_brep,Brep_with_voids,
Closed_shell,
Oriented_closed_shell,
Advanced_face
STRUKTUR (106) M-1 0 , 0
G8: geometrically bounded surface
Rectangular_trimmed_surface
Surface
GFACE (4023), with accordingGSURF8 (4116) and 4x GCURVE8(4114)
1-M 0
Rectangular_composite_surface
Surface_patch, Surface
several GFACE (4023), withaccording GSURF8 (4116) andGCURVE8 (4114)
1-M 0
Curve_bounded_surface
Boundary_curve,
Outer_boundary_curve,
Composite_curve_segment
GFACE (4023), with accordingGSURF8 (4116) and GCURVE8(4114)
1-M 0
Geometric_set STRUKTUR (106) 1-1 0
Presentation/draughting
P1: geometric presentation
Styled_item,
Presentation_style_assignment,
Point_style, Curve_style,
Surface_style_fill_area,
Colour_rgb
RESTART (10001), but colors only.Other styles cannot be converted.
M-1 0
Styled_item, Point_style
Presentation_style_assignment
not supported -- 8
Styled_item, Curve_style not supported -- 8
38
CAD Interfaces
STEP MEDINA Data Element MC RemPresentation_style_assignment
Invisibility RESTART (10001) 1-1 0
MC = Mapping Cardinality, Rem = Remark
Mapping cardinality:
• 1-1: The STEP entity is mapped to an exact equivalent BIF element.
• 1-M: One STEP entity is mapped to several corresponding BIF elements.
• M-1: Several STEP entities are mapped to one BIF element.
• M-N: Several STEP entities are mapped to several corresponding BIF elements.
Note
"Shared Instancing" is used for the mapping of assembly components. Theassembly components are stored in a separate BIF file. Additionally, a "part file"will be created which refers to the components.
The created MEDINA parts will get a unique, non empty label correspondingto the STEP product name. The MEDINA part codes will be set according theSTEP product identifiers.
STEP entity not supported in this combination.
Presentation_layer_assignments can optionally be mapped to DE GGROUP,no. 4025.
Mapping to DE CURVE8, no. 4114, if the curve is part of a face boundary. Incase of GPSET4, each segment has to be transformed to a separate curve toassert smooth curves.
Brep_with_voids: voids can be omitted optionally in order to reduce data size.Colors of advanced_faces are currently not supported. Styles are currently notsupported in BIF.
Structured instances in the STEP file (e.g. shape_representation, closed_shell,geometric_set) are optionally mapped to MEDINA SETs (DE STRUKTUR, no.106).
39
CAD Interfaces
Invisibility can optionally be mapped to MEDINA geometric objects in NoShow.Since this requires to generate a MEDINA RESTART DE, no. 10001, this optionis deferred to future releases.
Applied_group_assignment can optionally be mapped to DE GGROUP, no.4025.
Currently, only referenced STEP files can be transformed.
Colors of geometric objects are mapped to MEDINA color indices.
Since MEDINA's geometric tolerance is contained in RESTART DE, no. 10001,its transfer to BIF is deferred. The original closure tolerance is just mentionedin log file. MEDINA RESTART DE, no. 10001, this option is deferred to futurereleases.
Topological connected faces are represented by one or several commoncurves, having separate CONSes. Surface_curves are thus automaticallytranslated with the translated faces.
If appropriate, faces are split at seams of closed surfaces. Cylindrical faces aresplit into two half cylindrical faces. A complete toroidal surface is split into fourfaces. In general, faces using a single curve twice are avoided.
Hierarchical Assembly Structures
MEDINA currently supports only hierarchical assemblies of tree shape. Thus, repeatedor symmetric parts will be exploded during translation to BIF format.
Calling STEPBIF without MEDINA Monitor
Call:
<inst_directory>/cae/bin/stepbif stp=name bif=name
[options=name] [apptol=num] [msg={0|1}] [dir=name] [log=name]
[batch] [bit={32|64}]
If optional parameters are omitted, the first value of the numeration is the default value.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. stepbif).
40
CAD Interfaces
2.3.2.2. Working with large STEP Models
Recommendations:
1. Define the COM/STEP parameters LINDEX and LDATA with adequate values.
2. Check if the /tmp directory has enough free working space. The "/tmp/<userid>/cdalib/" directory, which is created during the convertion, can be used twice as muchworking space as the created or read in STEP file. During CATIA > STEP export, theSTEP file can be increased to the double or triple size like the original CATIA model.In the opposite way during import to CATIA, the CATIA model can be increased tothe 5-6 times size of the original STEP file, because of the different mathematicaldescriptions.
2.3.2.3. Logfile contents and messages
The STEPBIF and VDABIF converters can be invoked interactively by a user interfacewithin the MEDINA Monitor.
When running, the converter creates a logfile with time stamp, statistics of processedentities and information messages, warnings and errors.
The logfile of the converter has the following contents:
• Time stamp indicating the start of the conversion
• Table of options used for the conversion
• Information messages, warnings, and errors (see below)
• Statistics for the read input file.
• Statistics for the created output file.
• Time stamp indicating the end of the conversion
Here is a list of the information/warning/error messages of the converters and a shortdescription. The amount of messages can be controlled via the option "Verbosity".
If nothing is specified, the default value error will only display error messages, andsuppress all warning and information messages.
Warning messages
Warning: Conversion not implemented for instance #<name>.
41
CAD Interfaces
The indicated instance is of a type that is not yet supported by STEPBIF AND VDABIF.
Warning: 3D "infinite" vector in context of instance #<name>.
In the definition of the instance, a vector is used with length > 1e100. It is used anyway(normalized), but the data looks questionable.
Warning: 2D/3D NULL vector in context of instance #<name> or
vector #<name> has magnitude of zero or degenerate line #<name>:
NULL direction.
The definition of the instance either contains a NULL vector directly, or indirectly (e.g.if it uses an axis system whose axes are not orthogonal).
STEPBIF and VDABIF will use the data anyway but the result of the conversion mightbe useless.
Warning: degenerate curve #<inst> ignored.
A curve with zero length was detected and skipped.
Warning: skip element <name>.
The element was skipped, probably because of errors during its conversion.
Warning: entity modification failed.
While modifying an entity some error occurred.
Warning: vector <name> has magnitude of zero.
A vector with the magnitude of zero was found.
Information Messages
Information: Splitting face #<inst>.
Solid modeling systems based on the ACIS or ParaSolid kernels (Unigraphics,SolidDesigner, SolidEdge, SolidWorks, ...) allow the creation of faces with several outerbounds on cyclic surfaces e.g. cylinders, conical surfaces. An integrated face splittingalgorithm enables the converters to convert such faces to a topology valid in MEDINA.
Information: STEP file <name> read.
The STEP Scanner/Parser finished reading the STEP file.
Information: MEDINA document <name> closed.
42
CAD Interfaces
A newly created MEDINA document has been closed.
Error Messages
Error: Option error.
Inconsistency in the options provided to STEPBIF and VDABIF. The program aborts.
Error: Unable to open file <name>.
An output file cannot be created, probably due to missing write permissions orinsufficient disk space. The program aborts.
Error: SDAI error.
Syntactical or semantical error in the internally used data structure. Depending on thenature of the problem, some instances may get skipped but the converters tries toconvert the intact instances.
Error: STEP error.
During reading the STEP file some unknown, unsupported or malformed STEP entitieswere encountered.
Error: Unable to open MEDINA document <name>.
The converters could not open the specified MEDINA document.
Error: internal error.
Unhandled error, causes the converters to abort.
2.3.2.4. Control parameters
The STEPBIF and VDABIF processors can be controlled by several options. The userinterface allows these options to be set in a straightforward way.
Note
Some options are not directly available in the user interface. To specifythese options use the additional input field. This input field is located on the"parameter" page.
The available options (and shortcuts) for the converters are together with the followingsyntax in the batch mode option file:
43
CAD Interfaces
Options for conversion STEP->BIF or VDAFS ->BIF
• Input file: -InFile or -if
The only mandatory option i.e., all other options are optional. Specifies the name(including path) of the STEP or VDAFS document to convert.
Example: -InFile=C:\STEPData\STEPFile.stp or using the shortcut -if=C:\STEPData\STEPFile.stp
• Output file: -OutFile or -of
Name (including path) of the output file to create. This is a MEDINA file.
Default: If this option is omitted, STEPBIF or VDABIF will use the name of the inputfile, without its extension, and with the extension '.bif' added for MEDINA.
Example: -OutFile=C:\MedinaData\MedinaFile.bif
• Log file: -Logfile or -log
Name (including path) of the conversion protocol to create. This option is not directlyavailable in the user interface.
Default: If this option is omitted, STEPBIF or VDABIF will use the name of the inputfile, without its extension, and with the extension '.log' added.
Example: -LogFile=C:\logData\aLogFile.log
• Verbosity: -Verbosity or -vb
Verbosity of the log file, possible values are:
"error" (default): print only errors, suppress information messages and warnings
"info": print information messages, warnings, and errors
"warn": print warnings and errors, suppress information messages
"trace": trace the elements processed
Example: -Verbosity=Trace
• Output mode: -OutMode or -om
Controls the creation of the output file, possible values are:
44
CAD Interfaces
"Replace": (default): replace an existing file without question
"New": stop processing if the output file already exists
Example: -OutMode=New
• Approximation tolerance: ApproximationTol or -ac
Specifies the tolerance to use during the conversion in cases where approximationis required (e.g., for degree reduction of B-spline surfaces).
A positive real value has to be provided, it is interpreted as a millimeter valueregardless of the length unit used in the input file. The default value is 0.01.
Example: -ApproximationTol=0.01
• BRep tolerance: -BrepTol or -brt
Tolerance for BRep conversion in millimeters, default value is 0.004. This option isnot directly available in the user interface.
Example: -BrepTol=0.004
• Edge tolerance: -EdgeTol or -edt
Tolerance for edges in millimeters, default value is 0.004. This option is not directlyavailable in the user interface.
Example: -EdgeTol=0.004
• Group mapping: -GroupMap or -gma
Controls the conversion of STEP group_assignment elements and layers orGRPOUP’s in VDAFS.
By default, each group or layer is converted into a separate GROUP entity, if thisoptions is set to "no" the groups are not converted.
Example: -GroupMap=Yes
2.3.3. VDAFS-BIF -> Interface VDAFS to BIF
The VDABIF interface will import CAD data defined in VDAFS format into MEDINA,creating a BIF file.
45
CAD Interfaces
Please see the Control parameters for converting VDAFS to BIF.
Beside the control parameters described before, the VDA -> BIF Interface has onespecific option which is the geometry processing.
• "Without geometry processing" will call the old interface: It will translate allASCII numbers direct to binary numbers without checking or even processing them.This leads to a very fast converting of the VDA. But if the VDA file is faulty, a faulty BIFwill be created. Furthermore, the interface will crash with especial complex faces.
• "With geometry processing" enabled, the new interface will be called: Thisnew interface is based on the same technique as the ACISBIF, CATBIFV5, IGESBIF,JTBIF and STEPBIF. It does not only check the VDA file for errors, it also breaksclosed faces (cylinder) in several faces which may be handled much better inMEDINA.
In batch mode, use geom=1 to activate or geom=0 to deactivate the geometryprocessing.
The next table describes the mapping of VDAFS entities to BIF.
The remarks in the right-hand column of the table are only related to the conversionof the VDAFS entities in the corresponding line.
Mapping table VDAFS - BIF
VDAFS MEDINA Data Element Mapping Cardinality Rem
Non geometric entities
HEADER GHEADER 1-M
BEGINSET,ENDSET
STRUKTUR (106) M-1 1
GROUP GGROUP (4025), groupnames are preserved
1-1 2
TMAT < not supported > 1-1
TLIST Create transformed copiesof elements referenced bythe TLIST
1-M
46
CAD Interfaces
VDAFS MEDINA Data Element Mapping Cardinality Rem
Geometry
POINT GPOINT4 (4001) 1-1
PSET GLINE4 (4002) 1-M
MDI GLINE4 (4002) 1-M
CIRCLE GCIRCLE4 (4005) 1-1
CURVE GCURVE8 (4114) 1-1
SURF GSURF8 (4116) 1-1
CONS GCONS8 (4122) 1-1
FACE GFACE (4023) 1-1 3,4
TOP < not supported > 1-1
Mapping cardinality
• 1-1: The VDAFS entity is mapped to an exact equivalent BIF element.
• 1-M: One VDAFS entity is mapped to several corresponding BIF elements.
• M-1: Several VDAFS entities are mapped to one BIF element.
• M-N: Several VDAFS entities are mapped to several corresponding BIF elements.
Note
Structured instances in the VDAFS file (e.g. BEGINSET, ENDSET) are mappedto MEDINA SETs (DE STRUKTUR, no. 106).
GROUP’s can optionally be mapped to DE GGROUP, no. 4025.
Topological connected faces are represented by one or several commoncurves, having separate CONSes. Surface_curves are thus automaticallytranslated with the translated faces.
If appropriate, faces are split at seams of closed surfaces. Cylindrical faces aresplit into two half cylindrical faces.
Calling VDABIF without MEDINA Monitor
Call:
47
CAD Interfaces
<inst_directory>/cae/bin/vdabif dat=name bif=name [geom={1|0}]
[options=name] [apptol=num] [msg={0|1}] (used for geom=1 only)
[dir=name] [log=name] [batch] [bit={32|64}]
If optional parameters are omitted, the first value of the numeration is the default value.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. vdabif).
2.3.4. IGES-BIF -> Interface IGES to BIF
SupportedEntities
Description
Type 100 Circular Arc Entity
Type 102 Composite Curve Entity
Type 104 Conic Arc Entity
Type 106 Copious Data Entity (etc). Forms 1, 2, and 3 created as collectionsof points. Forms 11, 12, and 13 created as two- or three-dimensional piecewise linear NURBS.
Type 108 Plane Entity. We support form 0 and form 1.
Type 110 Line Entity
Type 112 Parametric Spline Curve Entity
Type 114 Parametric Spline Surface Entity
Type 116 Point Entity
Type 118 Ruled Surface Entity
Type 120 Surface of Revolution Entity
Type 122 Tabulated Cylinder Entity. Here the parameterization might bemessed up, depending on the curves used to create the surface.If so, the above type 120 comments apply.
Type 124 Transformation Matrix Entity
Type 126 Rational B-Spline Curve Entity
Type 128 Rational B-Spline Surface Entity
Type 130 Offset Curve Entity
48
CAD Interfaces
SupportedEntities
Description
Type 140 Offset Surface Entity
Type 141 Boundary Entity
Type 142 Curve on a Parametric Surface Entity
Type 143 Bounded Surface Entity
Type 144 Trimmed (Parametric) Surface Entity
Type 158 Sphere Entity
Type 186 Manifold Solid B-Rep Object Entity
Type 190 Plane Surface Entity
Type 192 Right Circular Cylindrical Surface Entity
Type 194 Right Circular Conical Surface Entity
Type 196 Spherical Surface Entity
Type 198 Toroidal Surface Entity
Type 308 Subfigure Definition Entity
Type 408 Singular Subfigure Instance Entity
Type 504 Edge Entity
Type 508 Loop Entity
Type 510 Face Entity
Type 514 Shell Entity
This list contains all standard geometry entities in IGES. There are also a numberof entities designed for creating CSG solids which MEDINA does not have plans tosupport at the moment.
Calling IGESBIF without MEDINA Monitor
Call:
<inst_directory>/cae/bin/igesbif igs=name bif=name
[options=name] [apptol=num] [msg={0|1}] [dir=name] [log=name]
[batch] [bit={32|64}]
If optional parameters are omitted, the first value of the numeration is the default value.
49
CAD Interfaces
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. igesbif).
2.3.5. JT-BIF -> Interface JT to BIF
JT is a mature lightweight data format that already enjoys widespread use in theautomobile and aerospace industries and is equally suitable for all manufacturingindustry applications.
JT has become the preferred common data format for many large end-users.
The JT data representation is CAD-neutral supporting all major MCAD applications.
JT data can be very lightweight, holding little more than facet data or it can be richerand hold associations to the original CAD information, assemblies, product structure,geometry, attributes, meta data and PMI.
It supports multiple tessellations and level-of-detail generation.
Mapping table JT - BIF
JTBIF converts data from the JT format file to the binary CAE-Databus format (BIF).
JTBIF does not create layers in BIF. But it is possible to activate or deactivate the layerfilter that deals with reading layers from a JT file. Add the following line into the optionsfile to deactivate the filter:
-JtReadActiveLayerFilter=IgnoreALF
The following table compares and describes the parameters in the MEDINA Monitorand the command line parameters for the tcl batch script:
Start MonitorParameter
Batch ScriptParameter
Description
Working directory dir=dirname Set the working directory for file access.
Input file jt=filename Formatted JT input file.
BIF output file bif=filename Binary file for MEDINA PreProcessing.
Replace existingfiles
(alwaysreplace)
The monitor toggle has two states: ON and OFF. Ifthe toggle is ON, existing files, e.g. the BIF output
50
CAD Interfaces
Start MonitorParameter
Batch ScriptParameter
Description
file, are overwritten. If called from a script, files arealways replaced.
Options file options Use this field to select an options file. Pressthe question button "?" to open the file selectionwindow.
Approximationtolerance
apptol=value An approximation tolerance value for the geometrymay be given here.
Additionalprogramparameters
batch
bit=32|64
warning
log=filename
Parameters shared by all interfaces (see chapter 1for a description).
Calling JTBIF without MEDINA Monitor
Call:
<inst_directory>/cae/bin/jtbif jt=name bif=name [options=name]
[apptol=num] [TesselationToFE={0|1}] [msg={0|1}] [dir=name]
[log=name] [batch] [bit={32|64}]
If optional parameters are omitted, the first value of the numeration is the default value.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. jtbif).
2.3.6. SAT-BIF -> Interface SAT to BIF
The 3D ACIS® Modeler (ACIS) is a 3D modeling kernel (or engine) owned by SpatialCorporation (formerly Spatial Technology).
SATBIF allows to convert SAT files (Standard ACIS Text Files) to MEDINA. CurrentlySAB files (Standard ACIS Binary) are not supported.
File Types
51
CAD Interfaces
The two formats store identical information, so the term SAT file is generally used torefer to either (when no distinction is needed).
SAT files are ASCII text files that may be viewed with a simple text editor. A SAT filecontains carriage returns, white space and other formatting that makes it readable tothe human eye. A SAT file has a .sat file extension.
SAB files cannot be viewed with a simple text editor and are meant for compactnessand not for human readability. A SAB file has a .sab file extension. A SAB file usesdelimiters between elements and binary tags, without additional formatting.
MEDINA requires a file in SAT format. You can check the format regardless of the fileextension if you open the file with a normal text editor.
If the file is readable, MEDINA will be able to convert it.
Structure of the file
A save file contains:
• a three-line header
• entity records, representing the bulk of the data
• optionally, a begin history data marker
• optionally, old entity records needed for history and rollback
• optionally, an end history data marker
• an end marker
For the SAT -> BIF interface only the standard settings are available.
52
CAD Interfaces
Figure 2.2. SAT-BIF Interface
Approximation tolerance
Specifies the tolerance to use during the conversion in cases where approximation isrequired (e.g., for degree reduction of B-spline surfaces).
A positive real value has to be provided, it is interpreted as a millimeter value regardlessof the length unit used in the input file. The default value is 0.01.
Parameters for the options file and the additional program parameters are described inthe section Control parameters. Of course only parameters that apply to this interfacewill work.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface with version number.
2.3.7. GlossaryACIS
ACIS stands for Alan, Charles & Ian's System. It is a solid modeling geometric modelingkernel that several CAD packages now use.
53
CAD Interfaces
ACIS uses a sophisticated object-oriented approach for modeling, the data is storedin boundary representation.
ACIS is owned by Spatial Technology. This was the author's second generation system,the first generation being Romulus. In 1999 around the time when Spatial was boughtout by Dassault Systemes, the file format changed slightly and was no longer openlypublished.
Application Protocol
The parts of STEP which can be implemented are called Application Protocols (APs).
This is a list of the most popular AP’s:
ISO 10303-203: Industrial automation systems and integration
• Product data representation and exchange
• Application protocol: Configuration controlled design
ISO 10303-201: Industrial automation systems and integration
• Product data representation and exchange
• Application protocol: Explicit draughting
ISO 10303-202: Industrial automation systems and integration
• Product data representation and exchange
• Application protocol: Associative draughting
ISO 10303-214: Industrial automation systems and integration
• Product data representation and exchange
Application protocol: Core data for automotive mechanical design processes
Conformance Class
STEP AP's are subdivided into so-called 'Conformance Classes'. These are partialscopes of an Application Protocol that can be implemented.
IGES
IGES (Initial Graphics Exchange Specification) was the first specification for CAD dataexchange published in 1980 as a NBS (National Bureau of Standards) report in USA.
54
CAD Interfaces
IGES version 1.0 was accepted and released in 1981 as an ANSI standard.
IGES is supported by all important CAD vendors and it is currently by far the mostwidespread standard for CADdata exchange.
IGES was originally developed for the exchange of drafting data like 2D/3D wireframemodels, text, dimensioning data, and a limited class of surfaces.
Due to criticism and bad experience with the data transfer using IGES, the standardhas been gradually extended and developed concerning supported entities, syntax,clarity, and consistency.
SAT
SAT stands for "Standard ACIS Text" and is one of two types of ACIS files (SAB,Standard ACIS Binary, being the other).
SAT files are ASCII text files that may be viewed with a text editor.
STEP
STEP (STandard for the Exchange of Product model data) is a new InternationalStandard (ISO 10303) for representing and exchanging product model information. Itincludes an object-flavored data specification language, EXPRESS, to describe therepresentation of the data.
STEP defines also implementation methods, for instance, a physical transfer file, andoffers different resources, e.g. geometric and topological representation.
The development of STEP started in 1984 as a worldwide collaboration. The goalwas to define a standard to cover all aspects of a product (i.e. geometry, topology,tolerances, materials, etc.), during its life time. This kind of attempt has not been madebefore.
STEP is a collection of standards to represent and exchange product information. Themain parts of STEP are already international standards, while many parts are still underdevelopment.
The development is performed under the control of the International Standardsorganization (ISO), Technical Committee 184 (TC184, Industrial Automation Systems),Subcommittee 4 (SC4, Industrial Data and Global Manufacturing ProgrammingLanguages).
VDAFS
55
CAD Interfaces
VDAFS (Vereinung Deutsche Automobilindustrie Flächen Schnittstelle)] is a Germanneutral file format for the exchange of surface geometry. It was developed to exchangefree form surfaces and it became a DIN standard in 1986.
VDAFS supports elementary curve and surface geometry entities and some topologyto define more complex models.
VDAFS is used by German automotive industry to define surface models, e.g. carbodies.
Bibliography
[1] VDA-Flächenschnittstelle Version 2.0
Verband der Automobilindustrie e.V. (VDA)
[2] PSstep_Caselib, ProSTEP Software Tool Kit, User Manual, Darmstadt 1994
[3] ISO 10303-203:1994, Industrial automation systems and integration
- Product data representation and exchange:
- Application protocol: Configuration controlled design
[4] ISO 10303-201:1994, Industrial automation systems and integration
- Product data representation and exchange:
- Application protocol: Explicit draughting
[5] ISO 10303-202:1996, Industrial automation systems and integration
- Product data representation and exchange:
- Application protocol: Associative draughting
[6] ISO 10303-214:---, Industrial automation systems and integration
- Product data representation and exchange:
- Application protocol: Core data for automotive mechanical design processes
- ISO TC 184/SC4 N335, CD1 from August 8, 1995
[7] ISO 10303-214:---, Industrial automation systems and integration
- Product data representation and exchange:
56
CAD Interfaces
- Application protocol: Core data for automotive mechanical design processes
- ISO TC 184/SC4 N582, CD2 from March 14, 1997
[8] ISO 10303-214:---, Industrial automation systems and integration
- Product data representation and exchange:
- Application protocol: Core data for automotive mechanical design processes
ISO TC 184/SC4 N335, DIS from February 20, 1999
2.4. STL -> STL InterfaceThe STL or stereo lithography file format is an ASCII or binary file used inmanufacturing.
It is a list of triangular surfaces and describes a solid model.
STL file format:
http://www.vr.clemson.edu/rp/rp_stlfile.htm
STL file is composed of a set of many unordered triangular facets. Its BNF format isdefined as followed:
<STL file>::=<facet 1><facet 2>...<facet n>
<facet>::=<normal>< vertex 1>< vertex 2><vertex 3>
<normal>::=<lx><ly><lz>
<vertex>::=<x><y><z>
STL file has two formats, ASCII format and BINARY format.
The ASCII format is described as followed: The first line in the file is the descriptionline, which contains the STL filename.
Facets begin from the second line: first is the normal of the facet, then the vertices.
The coordinates of the three vertices are given in the order that comply with the right-hand rule.
When the information of this triangle ends, then begins the next one. In this way, thewhole model is recorded.
Example: ASCII format STL file
57
CAD Interfaces
solid sample.stl created by Wei Feng on 15th OCT. 1994
facet normal -1.000000 0.000000 0.000000
outer loop
vertex 140.502634 233.993075 -38.310362
vertex 140.502634 229.424780 -38.359042
vertex 140.502634 242.525774 -27.097848
endloop
endfacet
Facet normal 0.903689 0.004563 0.428166
outerloop
vertex 134.521310 273.427873 30.342009
vertex 134.521310 308.505852 30.715799
vertex 140.502634 334.576026 18.369396
Endloop
endfacet
Facet normal -0.903689 0.004563 0.428166
outer loop
vertex 140.502634 334.576026 18.369396
vertex 140.502634 294.929752 17.946926
vertex 134.521310 273.427873 30.342009
endloop
endfacet
... ...
endsolid sample.stl
BINARY STL file format is accessed by byte.
The format is as follows: the first 80 bytes are used for description, and the next 4 bytesrepresents the total number of the facets(Long Int), followed by the facet information(normal and 3 vertices), the normal and vertices are stored in floating point format,each occupying 4 bytes.
At the end of each facet information section, there are two bytes spaces, then the nextfacet is repeated till the end of the file.
When BINARY format is used to describe STL file, the data size is much smaller thanASCII format, so most STL files available now use BINARY format.
<BINARY STL file format>::=<STL file entity name><facet number
N>
58
CAD Interfaces
<facet info>
<STL file entity name >::=<80 bytes entity name, spaces are
used to fill the blank>
<facet number N>::=<4 bytes long integer>
<facet info>::=<facet normal><facet vertices><2 bytes spaces>
<facet normal><facet vertices><2 bytes spaces>
... ...
<facet normal>::=<lx,ly,lz, float, 12 bytes>
<facet vertex coordinates>::=<x1,y1,z1,x2,y2,z2,x3,y3,z3,
float, 36 bytes>
2.4.1. BIFSTL -> Interface BIF to STL
The BIFSTL interface converts MEDINA data (BIF) to a binary or ASCII STL file.
Option Meaning
bif=name Input: MEDINA data file name (e.g. test.bif)
dat=name Output: STL file name (e.g. test.stl)
type={binary|ascii} Output file type (default: binary)
endian={big|little} Byte ordering for binary STL files (default: big).
UNIX Risc processors usually use big-endian byte orderingwhile X86 processors use little-endian.
eol={unix|windows} End-of-line termination for ASCII STL files (default: unix).
UNIX workstations usually use CarriageReturn whileWindows PCs use CarriageReturn/LineFeed.
format=string Output format descriptor for floating point values in ASCIISTL files, C syntax (default: "%f")
Features
The BIFSTL interface reads nodes and Tria3 (CAE key 31) elements from input BIF file.Facet vertex coordinates are formed of the coordinates of Tria3 node points P1,P2,P3.
Facet normal vectors are computed as cross-product of vectors: x
Calling BIFSTL without MEDINA Monitor
Call:
59
CAD Interfaces
<inst_directory>/cae/bin/bifstl bif=name dat=name
[type={binary|ascii}] [endian={big|little}] [eol={unix|
windows}] [format=string] [dir=name] [log=name] [batch]
[bit={32|64}]
If optional parameters are omitted, the first value of the numeration is the default value.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. bifstl).
2.4.2. STLBIF -> Interface STL to BIF
The STLBIF interface converts data from a binary or ASCII STL file to MEDINA data(BIF).
Option Meaning
dat=name Input: STL file name (e.g. test.stl)
bif=name Output: MEDINA data file name (e.g. test.bif)
type={auto|binary|ascii} Input file type (default: auto)
File type “auto” tries to auto-detect file type and byteordering of STL file. If file type cannot be detected, file type“ascii” is used.
endian={big|little} Byte ordering for binary STL files (default: big).
UNIX Risc processors usually use big-endian byte orderingwhile X86 processors use little-endian.
Features
The STLBIF interface reads facets from STL file. Each facet is mapped to a INFE3element, each facet vertex is mapped to a node of a NPCO element.
Node IDs are generated in ascending order with increment 1, starting with node ID 1.Element IDs are generated in ascending order with increment 1, starting with elementID 1.
Calling STLBIF without MEDINA Monitor
Call:
60
CAD Interfaces
<inst_directory>/cae/bin/stlbif dat=name bif=name [type={auto|
binary|ascii}] [endian={big|little}] [dir=name] [log=name]
[batch] [bit={32|64}]
If optional parameters are omitted, the first value of the numeration is the default value.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. stlbif).
2.5. Universal File Interface
2.5.1. UNI-BIF-BOF -> Interface Universal File to BIFand BOFUNIB*F converts data from the formatted Universal File to the binary CAE-Databusformat (BIF/BOF).
The following table compares and describes the parameters in the MEDINA Monitorand the command line parameters for the tcl batch script:
Start MonitorParameter
Batch ScriptParameter
Description
Workingdirectory
dir=dirname Set the working directory for file access.
Input file unv=filename Formatted UNIVERSAL input file.
BIF output file bif=filename Binary file for MEDINA PreProcessing.
BOF output file bof=filename Binary file for MEDINA PostProcessing.
Replaceexisting files
(alwaysreplace)
The monitor toggle has two states, ON and OFF. Ifthe toggle is ON, existing files, e.g. the BIF outputfile, are overwritten. If called from a script, files arealways replaced.
Additionalprogramparameters
batch
bit=32|64
log=filename
Parameters shared by all interfaces (see chapter 1for a description).
Supported data
61
CAD Interfaces
The following table lists the data translated from the UNIVERSAL to the MEDINA dataformat:
Universal File Data Sets CAE Data Element(MEDINA Element)
Remarks
Nodes (15, 781, 2411) NPCO Number of nodes limited to:
3 000 000
Coordinates Systems (18) CORSIS TRAFO
Element (71, 780, 2412) INFE (Continuouselements)
Number of elements is limitedto:
3 000 000
Trace line (82) PLOTEL, INFE2
Restraint Set (89, 755) SUPDOF, PREDOF
Load Set (90, 756, 782) SKNPCO, SKINFE
Universal File Data Sets CAE Data Element(MEDINA Element)
Remarks
Element Properties
Material Table (91, 731/747,772/773)
ESOLID, ESHELL,MAT1
Constrain Set (88, 754) MPC
Nodal Forces (90, 756, 782) FORCE
Data at Nodes (55, 2414) DEFO,DEFOK,NPST,SKNPCO,
VKNPCO
Without transformation fromlocal to global system
Data at Nodes on Elements(57, 2414)
SINFE, SINFEK Without transformation fromlocal to global system
Function at nodal DOF (58) DEFO (t) Without transformation fromlocal to global system (seeNote below)
Scalar results at elements(2414)
SKINFES Complex results are notsupported
62
CAD Interfaces
Note
All data sets 58 of an Universal File must fulfill the following restrictions:
- same order
- same frequencies (max 200)
- same nodes (max 400)
- three components (x,y,z) per node, x, y, and z are complex
A Data Set 58 must contain the following records and fields:
Recordnumber
Recorddefinition
Field number Field definition Remarks
6 DOFIdentification
6 Response node interpreted asnode
6 DOFIdentification
7 Responsedirection
interpreted ascomponent
only valuesbetween -3 and3 are supported(Rotation is notsupported).
7 Data Form 6 Z-axis value interpreted asorder = (Z-axisvalue)/60
12 Data Values interpreted asrevolutions perminute D(i)and a pairof measuredvalues with Re/Im:
D(i) Re(i) Im(i)D(i+1) Re(i+1)Im(i+1)
63
CAD Interfaces
Recordnumber
Recorddefinition
Field number Field definition Remarks
i= 1 to (numberof data pairs)/2
The following records and fields of data set 58 are supported:
Recordnumber
Recorddefinition
Field number Field definition Remarks
6 DOFIdentification
1 Function Type only value 12(Spectrum) issupported
7 Data Form 1 Ordinate Datatype
only value5 (complex,singleprecision) issupported
7 Data Form 3 AbscissaSpacing
only value 0(uneven) issupported
8 Abscissa DataChar
1 Specific Datatype
only value 1(general) andvalue 19 (rpm)are supported.
value 19 (rpm)will beconverted tofrequency(value 18)
9 Ordinate DataChar
1 Specific Datatype
only value 1(general) andvalue 19 (rpm)are supported.
If Field 7 ofRecord 6 is 0
64
CAD Interfaces
Recordnumber
Recorddefinition
Field number Field definition Remarks
the value 1(general) istreated as value15 (pressure)
value 19 (rpm)will beconverted tofrequency(value 18)
11 Z-axis
Data Char
1 Specific Datatype
only value 1(general) andvalue 19 (rpm)are supported.
value 19 (rpm)will beconverted tofrequency(value 18)
If the order or number of data pairs has been changed, all previously processed DataSets 58 will be converted to one CAE Data Element.
If a node with component occurs more than once within one frequency series, the lastvalue becomes valid.
For every frequency one CAE Data Element will be created for all nodes.
The element types LINE and PLANE are extensions. If necessary, LINEs can bechanged to PSETs with a text editor replacing the character strings ’LINE /’ by ’PSET /2, ’.
Calling UNIBIF without the MEDINA Monitor
Call:
<inst_directory>/cae/pgm/unibif unv=name bif=name bof=name
[dir=name] [log=name] [batch] [bit={32|64}]
65
CAD Interfaces
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. unibif).
2.5.2. BIF-BOF-UNI -> Interface BIF and BOF toUniversal File
B*FUNI converts data from the CAE Databus format (BIF/BOF) to Universal File.
Calling BIFUNI from MEDINA Monitor
Start MonitorParameter
Batch ScriptParameter
Description
Workingdirectory
dir=dirname Set the working directory for file access.
BIF Input file bif=filename Binary input file from MEDINA PreProcessing.
BOF Input file bof=filename Binary output file from MEDINA PostProcessing.
Output file unv=filename Formatted UNIVERSAL file.
Replaceexisting files
(alwaysreplace)
The monitor toggle has two states, ON and OFF.If the toggle is ON, existing files are overwritten. Ifcalled from a script, files are always replaced.
Conversion ofINFE2 elements
Infe2=bar|traceline
Convert INFE2 elements to:
->bar
->traceline
Additionalprogramparameters
batch
bit=32|64
log=filename
Parameters shared by all interfaces (see chapter 1for a description).
Supported data
The following table lists the data elements translated from the MEDINA to theUNIVERSAL data format:
66
CAD Interfaces
CAE Data Element(MEDINA Element)
Universal FileData Sets
Remarks
NPCO Nodes (15, 781) Number of nodes is limited to:
3 000 000
CORSIS
TRAFO
Coordinatessystems (18)
INFE (Continuous-Elements)
Element (71,781) Number of elements is limited to:
3 000 000
SUPDOF, PREDOF Restraint set (89,755)
SKNPCO (204) Load set (90, 756,782)
ESOLID, ESHELL, MAT1 Element properties
Material Table (71,731/747, 772/773)
MPC Constrain set (88,754)
FORCE Nodal forces (90,756, 782)
DEFO, DEFOK (231, 232) Data at nodes (55) Without transformation from local toglobal system
Calling BIFUNI without the MEDINA Monitor
Call:
<inst_directory>/cae/pgm/bifuni unv=name [bif=name] [bof=name]
[infe2={bar|traceline}] [dir=name] [log=name] [batch] [bit={32|
64}]
If optional parameters are omitted, the first value of the numeration is the default value.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. bifuni).
67
Chapter 3. Modeling Interfaces3.1. AutoSEA -> Interface to AUTOSEAThe AutoSEA interface converts BIF data to the AutoSEA data.
3.1.1. BIFSEA -> Interface BIF to AUTOSEAThe interface program BIFSEA converts MEDINA BIF files into AutoSEA input files(NEUTRAL-ASCII-File format).
Option Meaning
bif=name Input: MEDINA bif file name
dat=name Output: AutoSEA data file name
template=name Input: Name of the template file [optional]
The interface converts subsystems into a doubly-curved plate of the type "FACE /SPHEROIDAL_CAP".
A subsystem is defined in MEDINA as a connected TRIA3 mesh with any boundarynodes and one center node.
All TRIA3 elements in a subsystem must have the same property ID.
Example of a plate definition:
# property label
FACE 1 {
SPHEROIDAL_CAP {
NODES_LIST {
4000010
4000016
4000017
4000018
4000011
4000681
}
}
}
68
Modeling Interfaces
The comment line "#" before the plate definition contains the property label.
The last node in the node list is the center node of the subsystem.
Example of a subsystem in MEDINA with shrink factor = 0.1:
Definition of the node coordinates:
# Nodes
NODES {
NODE {
NODE_ID 4000001
NODE_NAME "4000001"
POSITION (1.69854,-0.769085,0.623066)
}
}
The node coordinates are in the global coordinate system. The NODE_NAMEcorresponds to the node ID.
Figure 3.1. Visual result
Calling BIFSEA without MEDINA Monitor
Call:
<inst_directory>/cae/bin/bifsea bif=name dat=name
[template=name] [size=number] [dir=name] [log=name]
[warning=number] [batch] [bit={32|64}]
If optional parameters are omitted, the first value of the numeration is the default value.
69
Modeling Interfaces
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. bifsea).
3.2. PATRAN -> PATRAN Neutral FileInterfaceBIFPAT/PATBIF converts MEDINA data (BIF) into PATRAN data (Neutral File Format)and vice versa according to PATRAN Plus User Manual, September 1989.
3.2.1. BIFPAT -> Interface BIF to PATRANBIFPAT converts MEDINA data (BIF Format) into PATRAN input data.
Calling BIFPAT from the MEDINA Monitor
The following table compares and describes the parameters in the Start Monitor andthe command line parameters for the tcl batch script:
Start MonitorParameter
Batch ScriptParameter
Description
Workingdirectory
dir=dirname Set the working directory for file access.
BIF Input file bif=filename Binary input file from MEDINA PreProcessing.
Output file pat=filename Formatted output file used as PATRAN input deck.
Replaceexisting files
(alwaysreplace)
The monitor toggle has two states, ON and OFF. Ifthe toggle is ON, existing files, e.g. the PATRAN inputfile, are overwritten. If called from a script, files arealways replaced.
Additionalprogramparameters
bit=32|64
log=filename
Parameters shared by all interfaces (see chapter 1 fora description).
Calling BIFPAT without MEDINA Monitor
Call:
<inst_directory>/cae/bin/bifpat bif=name pat=name [dir=name]
[log=name] [bit={32|64}]
70
Modeling Interfaces
Option Meaning
bif=name Input: MEDINA data file name (e.g. test.bif)
pat=name Output: PATRAN data file name (e.g. test.pat)
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. bifpat).
Supported data
The following table lists the data translated from the MEDINA to the PATRAN dataformat:
CAE Data Element(MEDINA Element)
PATRAN DataPacket Type(TypeID)
Remarks
TEXT Title Card (25) Extracted out of text line following a linecontaining /TITLE/ (max. length of text line is256 characters)
Headers of severaldata elements
Summary Data(26)
NPCO Node Data (1) Coordinates transformed into globalcartesian system:
Number of DOF = 6
Node type = G
Condensation flag set to 1
Node CONFIG set to 0
INFE2, GEINFE2
INFE3
INFE4
INFE4S
INFE6
Element Data (2)
additionalElementProperties (4)
Associated data not considered (exceptionbars)
CONFIG of element not considered
Material orientation angles not considered
Congruent element ID set to 0
71
Modeling Interfaces
CAE Data Element(MEDINA Element)
PATRAN DataPacket Type(TypeID)
Remarks
INFE6S
INFE8
INFE8S
INFE10S
INFE15S
INFE20S
FEDAL1
ELSKALAR
KMASSE (MASS)
CONM1 (CONM1)
INFE2G (GAP)
Property name: CFG=<CONFIG> ...
For bars: ID of node in xy-plane set to 0
FEDAL1 and ELSKALAR: Two additionalvalues beyond the last node containcomponent numbers
KMASSE: For every element a new elementproperty definition is created. It containsfollowing values: 0, mass, I11, I21, I22, I31,I32; I33, X1, X2, X3 (offset vector).
The CONFIG of element and elementproperty is set to 7
CONM1: For every element a new elementproperty definition is created. It containsfollowing values:
0.0, CID, M11, M21, M22, M31, M32, M33,M41, M42, M43, M44, M51, M52, M53, M54,M55, M61, M62, M63, M64, M65, M66.
The CONFIG of element and elementproperty is set to 35
MATERIAL MaterialProperties (3)
Supported material types:
Isotropic, 3D orthotropic, 3D anisotropic
Supported material constants - isotropic:
, , ,
, , structural damping coefficient(GE), reference temperature (T)
supported material constants - 3Dorthotropic:
72
Modeling Interfaces
CAE Data Element(MEDINA Element)
PATRAN DataPacket Type(TypeID)
Remarks
, , , , , , , , , ,
, , , , words 83-85
supported material constants - 3Danisotropic:
, , , (6 thermal expansion
coefficients), (21 material stiffness matrixterms)
PROPERTY of typeROD, BAR, BEAM,SHELL, SOLID,SPRING, DAEMPFERor MASSE
TEXT
ElementProperties (4)
Property name: CFG=<CONFIG> ...
Negative PIDs not considered
Material ID is extracted out of PROPERTYelement (for BAR, ROD, BEAM, SHELL,SOLID)
CONFIG of elements specified in filepatran.cfg in the directory .medina in user'shome directory
Shape and number of nodes are taken fromcorresponding element with the smallestelement ID (if not found: SHELL 4/4, SOLID8/8)
Property values:
1. extracted out of text lines following a linewith:
´/PROPERTY/ ID=<PID>´ (for eachproperty)
2. each line except the last one has tocontain exactly five property values
73
Modeling Interfaces
CAE Data Element(MEDINA Element)
PATRAN DataPacket Type(TypeID)
Remarks
3. lines with values may be given in:
• free format: with commas asseparators, ‘,,’ and ‘, ,’ lead to a blankproperty value (a semicolon ‘;’ at theend of the last line indicates free formatas well)
• fixed format: like PATRAN NeutralFile, without any comma, blank linesare interpreted as five blank propertyvalues, blanks proceeding the last non-blank property value within the last lineare not interpreted as blank propertyvalues
4. free and fixed format and blank lines maybe mixed shape set to 2 (PBAR, PBEAM,PSPRING, PDAEMPFER, PMASS), 4(PSHELL) or 8 (PSOLID)
CORSYS
TRAFO
CoordinateFrames (5)
PVNPCO Node Forces (7) Packets are written in ascending order ofnode ID (order of load set IDs for a specificnode is arbitrary)
PLOAD DistributedLoads (6)
Element specific pressure definition
SUPDOF, PREDOF NodeDisplacements(8)
Packets are written in ascending order ofnode ID (order of constraint set IDs for aspecific node is arbitrary)
MPC MPC Data (14) is set to 0
74
Modeling Interfaces
CAE Data Element(MEDINA Element)
PATRAN DataPacket Type(TypeID)
Remarks
MPC-IDs are generated by BIFPAT (startingat 1), rigid elements are followed by generalMPCs
MPC-ID from BIF becomes MPC-SETID inneutral file
RINFE2 (RROD) MPC Data (14) Element ID from BIF becomes MPC-ID inneutral file
MPC-SETID set to 50
NDT set to 0
is set to 0
in data cards 2 and 3:
1. dependent DOF
2. 6 independent DOFs
RINFE2 (RBAR) MPC Data (14) Element ID from BIF becomes MPC-ID inneutral file
MPC-SETID set to 10
NDT set to 0
is set to 0
Coefficients C(I) set to 1
in data cards 2, 3, ...:
1. all dependent DOFs
2. 6 independent DOFs
RBE2 (RBE2) MPC Data (14) Element ID from BIF becomes MPC-ID inneutral file
75
Modeling Interfaces
CAE Data Element(MEDINA Element)
PATRAN DataPacket Type(TypeID)
Remarks
MPC-SETID set to 30
NDT set to 0
is set to 0
Coefficients C(I) set to 1
in data cards 2, 3, ...:
1. all dependent DOFs
2. 6 independent DOFs
SET NAMEdComponentDefinition (21)
Set text: ID=<Set-ID> NAME=<Name> (linemay be up to 40 characters long)
Supported types: node, bar, triangle,quadrilateral, tetrahedron, wedge,hexahedron, coordinate frame, multi-pointconstraints (the latter two cannot be handledwithin MEDINA)
TEXT NAMEdComponentDefinition (21)
Coordinate frames and multi pointconstraints are extracted out of text linesfollowing a lines with:
/NAME/ ID=<NameID> NAME=<Name> infirst line, CID=CID1,CID2, ... in second lineand MPCID=MPCID1, MPCID2, ... in thirdline
TEXT LIST Card (40) LIST cards are extracted out of text linesfollowing a line with /LIST/ ID=<ListID>
TEXT DATA Card (41) DATA cards are extracted out of text linesfollowing a line with /DATA/ ID=<DataID>
Note
<varName> means content of variable varName
76
Modeling Interfaces
Comments within TEXT elements are only allowed before any of the keywordsindicated by /.../
3.2.2. PATBIF -> Interface PATRAN to BIF
PATBIF converts PATRAN data into MEDINA data (BIF).
Calling PATBIF from the MEDINA Monitor
The following table compares and describes the parameters in the Start Monitor andthe command line parameters for the tcl batch script:
Start MonitorParameter
Batch ScriptParameter
Description
Workingdirectory
dir=dirname Set the working directory for file access.
Input file pat=filename Formatted input file used as PATRAN input deck.
Configurationfile
config=filenameFormatted input file with the default PATRANelement types for MEDINA elements.
BIF output file bif=filename Binary file for MEDINA PreProcessing.
Replaceexisting files
(alwaysreplace)
The monitor toggle has two states, ON and OFF.If the toggle is ON, existing files, e.g. the PATRANinput file, are overwritten. If called from a script, filesare always replaced.
Additionalprogramparametersshared by allinterfaces
batch
bit=32|64
log=filename
Parameters shared by all interfaces (see chapter1 for a description), plus additional parametersdescribed in the following chapter.
Calling PATBIF without MEDINA Monitor
Call:
<inst_directory>/cae/bin/patbif pat=name bif=name [config=name]
[dir=name] [log=name] [batch] [bit={32|64}]
Option Meaning
pat=name Input: PATRAN data file name (e.g. test.pat)
77
Modeling Interfaces
Option Meaning
bif=name Output: MEDINA data file name (e.g. test.bif)
config=name Input: PATBIF configuration file (default: <inst_directory>/cae/data/patran/patran.cfg)
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. patbif).
Configuration File
The configuration file maps PATRAN elements given by Shape/Nodes/Config to CAEdata elements (MEDINA data elements).
Syntax of configuration file entries:
Name Key=Value[,Value[,...]] [Key=Value[,Value[,...]] [...]]
Supported values for Name:
BAR
BEAM
CONM1
CONM2
DAMP1
GAP
MASS
QUADR
QUAD4
QUAD8
ROD
78
Modeling Interfaces
TRIAR
TRIA3
TRIA6
SPRING1
Supported values for Key:
CFG
Value is a valid PATRAN Config value.
Note
Several entries with equal Name are allowed.
Separator character between Key and Value(s) is an equal sign "=", no spacesare allowed.
Enumerations of key values are separated by comma signs ",", no spaces areallowed.
Enumerations of keys are separated by spaces or tabs.
Each key may occur only once per entry.
Lowercase and uppercase characters are equivalent.
Comment lines start with a hash sign "#" .
If no configuration file is available, the following default mapping will be used:
PATRAN CAE Data Element MEDINA
Shape/ Nodes Name Key Orityp Name
2/2 INFE2 21 BAR BAR
3/3 INFE3 31 TRIA3 TRIA3
3/6 INFE6 36 TRIA6 TRIA6
4/4 INFE4 41 QUAD4 QUAD4
4/8 INFE8 48 QUAD8 QUAD8
5/4 INFE4S 61 TETRA TETRA
79
Modeling Interfaces
PATRAN CAE Data Element MEDINA
Shape/ Nodes Name Key Orityp Name
5/10 INFE10S 62 TETRA10 TETRA10
7/6 INFE6S 63 PENTA PENTA
7/15 INFE15S 64 PENTA15 PENTA15
8/8 INFE8S 65 HEXA HEXA
8/20 INFE20S 66 HEXA20 HEXA20
The following table contains additionally definable mappings:
PATRAN CAE Data Element MEDINA PATRAN NASTRAN
Shape/Nodes
Name Key Orityp Name Config Name
2/2 INFE2 21 BAR BAR 0 CBAR
2/2 INFE2 21 BEAM BEAM 2 CBEAM
2/2 INFE2 21 ROD ROD 1
3
CONROD
CROD
2/2 INFE2G 22 GAP GAP 9 CGAP
2/2 FEDAL1 137 SPRING1 SPRING1 6
11
CELAS1
CELAS2
2/2 FEDAL1 137 DAMP1 DAMP1 21
22
CDAMP1
CDAMP2
2/2 ELSKALAR 142 MASS MASS1 31 CMASS1
2/2 CONM1 145 CONM1 CONM1 35 CONM1
2/2 KMASSE 141 CONM2 MASS 7 CONM2
3/3 INFE3 31 TRIA3 TRIA3 0 CTRIA3
3/3 INFE3 31 TRIAR TRIA3 1 CTRIAR
3/6 INFE6 36 TRIA6 TRIA6 0 CTRIA6
4/4 INFE4 41 QUAD4 QUAD4 0 CQUAD4
4/4 INFE4 41 QUADR QUAD4 1 CQUADR
4/8 INFE8 48 QUAD8 QUAD8 0 CQUAD8
80
Modeling Interfaces
Features
PATRAN DataPacket Type(TypeID)
CAE Data Element(MEDINA Element)
Remarks
Title Card (25) TEXT Inserted into text lines following a linecontaining /TITLE/
Summary Data(26)
Don't need correction
Node Data (1) NPCO Node type not considered
CONFIG not supported
Element Data (2) INFE2 (BAR/BEAM/ROD)
INFE2G (GAP)
INFE3 (TRIA3)
INFE3V (TRIA3)
INFE6 (TRIA6)
INFE6V (TRIA6V)
INFE4 (QUAD4)
INFE4V (QUAD4V)
INFE8 (QUAD8)
INFE8V (QUAD8V)
INFE4S (TETRA)
INFE10S (TETRA10)
INFE6S (PENTA)
INFE15S (PENTA15)
INFE8S (HEXA)
Associated data not considered(exception bars)
Bars: ID of node in xy-plane notconsidered
CONFIG of element must match propertyCONFIG (to keep consistency)
Material orientation angles notconsidered
Property name: CFG=<CONFIG> ...
CONFIG of elements specified in filepatran.cfg in the directory .medina inuser's home directory. If it is not availablefollowing default values apply:
Shape/Nodes CAE Data Elements
2/2 INFE2
3/3 INFE3
3/6 INFE6
4/4 INFE4
4/8 INFE8
81
Modeling Interfaces
PATRAN DataPacket Type(TypeID)
CAE Data Element(MEDINA Element)
Remarks
INFE20S (HEXA20)
FEDAL1 (SPRING1/DAMP1)
CONM1 (CONM1)
KMASSE (MASS)
ELSKALAR (MASS1)
GEINFE2 (BAR/BEAM)
5/4 INFE4S
5/10 INFE10S
7/6 INFE6S
7/15 INFE15S
8/8 INFE8S
8/20 INFE20S
Negative PIDs:
mapped to 1000000-PID
KMASSE: values of correspondingelement property are extracted andwritten into element by followingconvention:
*, mass, I11, I21, I22, I31, I32; I33, X1, X2,X3 (offset vector)
CONM1: values of correspondingelement property are extracted andwritten into element by followingconvention:
0.0, CID, M11, M21, M22, M31, M32,M33, M41, M42, M43, M44, M51, M52,M53, M54, M55, M61, M62, M63, M64,M65, M66
INFE3V, INFE4V, INFE6V, INFE8V: istaken as material orientation angle
MaterialProperties (3)
MATERIAL Supported material types:
isotropic, 3D orthotropic, 3D anisotropic
82
Modeling Interfaces
PATRAN DataPacket Type(TypeID)
CAE Data Element(MEDINA Element)
Remarks
Supported material constants - isotropic:
, , , ,
, , supported materialconstants - 3D orthotropic:
, , , , , , , , , ,
, , , , words 83-85
Supported material constants - 3Danisotropic:
, , , (6 thermal expansion
coefficients), (21 material stiffnessmatrix terms)
ElementProperties (4)
PROPERTY (BAR,BEAM, SHELL, SOLID,SPRING, DAEMPFER,MASS)
TEXT
Property name: CFG=<CONFIG> ...
Determination of element type:
1. For every property ID a correspondingelement is searched which determineselement type and configuration.
2. If no such element is available, shape,number of nodes, configuration ofelement and the file patran.cfg inthe directory .medina in user's homedirectory are used to determine correcttype of element.
Property values:
1. inserted into text lines following a linecontaining:
83
Modeling Interfaces
PATRAN DataPacket Type(TypeID)
CAE Data Element(MEDINA Element)
Remarks
´/PROPERTY/ ID=<PID>´ (for eachnew property)
2. inserted into PROPERTY elementsfollowing NASTRAN conventions:
PBAR: MID, A, I1, I2, J, NSM, C1, C2,D1, D2, E1, E2, F1, F2, K1, K2, I12
PBEAM: MID, A(A), I1(A), I2(A),I12(A), J(A), NSM(A)
PSHELL: MID1, T, MID2, 12I/T3,MID3, TS/T, NSM
PSOLID: MID, CORDM, IN, STRESS,ISOP
CAE data element KMASSE:
Values are extracted out of thecorresponding element property andwritten into element data by following
convention:
*, mass, I11, I21, I22, I31, I32; I33, X1, X2,X3 (offset vector).
The corresponding element property isdropped and does not appear in TEXTelements.
If SHELL element and its’ propertycontain additional layer values, INFExVelements are created .
84
Modeling Interfaces
PATRAN DataPacket Type(TypeID)
CAE Data Element(MEDINA Element)
Remarks
Several different element configurationsfor one element property:
A new element property with the samevalues is created for each elementconfiguration.
CoordinateFrames (5)
CORSYS
TRAFO
DistributedLoads (6)
PLOAD Element specific pressure definition
Restrictions:
only surface loads
only forces in z-direction
Forces have to act on all nodes of asurface (also for volume surfaces)
PLOAD ID is set to load set ID
Node Forces (7) PVNPCO
NodeDisplacements(8)
PREDOF/SUPDOF CID is not considered
MPC Data (14) MPC
RINFE2 (RROD)
RINFE2 (RBAR)
RBE2 (RBE2)
is set to 0
MPC-SETID becomes MPC-ID on BIF
packet with TYPE = ‘RIGID’ areinterpreted by NASPAT convention andtranslated to rigid elements
NAMEdComponentDefinition (21)
SET
TEXT
Set text: ID=<NameID> NAME=<Name>(name is truncated to 12 characters)
85
Modeling Interfaces
PATRAN DataPacket Type(TypeID)
CAE Data Element(MEDINA Element)
Remarks
Supported types: node, bar, triangle,quadrilateral, tetrahedron, wedge,hexahedron)
Coordinate frames and multi pointconstraints are inserted into textlines with /NAME/ ID=<NameID>NAME=<Name> in first line,CID=CID1,CID2, ... in second line andMPCID=MPCID1, MPCID2, ... in third line
LIST Card (40) TEXT LIST cards are inserted into text lineswhich start with /LIST/ ID=<ListID>
DATA Card (41) TEXT DATA cards are inserted into text lineswhich start with /DATA/ ID=<DataID>
Note
<varName means content of variable varName Syntax of file patran.cfg:
Name Key=Value[,Value[, ...] [Key=Value[,Value[, ...]]
[...]]
Name in { BAR, BEAM, ROD, GAP, TRIA3, TRIAR, TRIA6, QUAD4, QUADR,QUAD8, SPRING1, DAMP1, MASS, CONM1 CONM2}, Key in {CFG}
3.3. SYSTUS -> Interface to SYSTUSThe interface program systbof converts SYSTUS data to MEDINA BIFs and BOFs.
Call:
<inst_directory>/cae/bin/systbof bif=name bof=name dat=datfile
result=resultfile [warning=number]
Option Meaning
bif=name Output: MEDINA data file name (e.g. medina.bif). If nameis blank no BIF file will generated.
86
Modeling Interfaces
Option Meaning
bof=name Output: MEDINA data file name (e.g. medina.bof)
dat=datfile Name of the systus model file (e.g. test_model.ASC).
result=resultfile Name of the systus result file (e.g. test_result.ASC).
log=name Output: log file name (default: systbof.log)
warning=number No warnings will be suppressed.
SYSTBOF: Table of results
Name of SYSTUS Result Name of MEDINAData Element
Node or Element Type
Displacements DEFO Node
Element stresses SINFE Brick, shell
Bearing and cutting forces UBRR Brick, shell
Calling SYSTBOF without the MEDINA Monitor
Call:
<inst_directory>/cae/pgm/systbof dat=datfile result=resultfile
bif=name bof=name [log=name] [warning=number]
Option Meaning
dat=datfile Input of systus geometry file
result=resultfile Input of systus result file
bif=name Output: MEDINA data file name (e.g. medina.bif)
bof=name Output: MEDINA result file name (e.g. medina.bof)
log=name Output: log file name (default: systbof.log)
warning=number No warnings will be suppressed
Example:
To convert the SYSTUS files test.dat and test.asc into the MEDINA files test.bif andtest.bof, use:
<inst_directory>/cae/pgm/systbof dat=test.dat result=test.asc
bif=test.bif bof=test.bof
87
Chapter 4. Solver Interfaces
4.1. ABAQUS -> Interface to ABAQUSBIFABA/ABABIF converts MEDINA data (BIF) to ABAQUS data and vice-versaaccording to ABAQUS/Standard.
ABABOF/fil converts a binary or ASCII ABAQUS result file (.fil file) to MEDINA format(BIF and BOF).
ABABOF/odb converts a binary ABAQUS result file (.odb file) to MEDINA format (BIFand BOF).
4.1.1. ABAQUS - Control file
Using ABAQUS element names in MEDINA, it is necessary to read in a Config fileduring the start of MEDINA.
Solver-specific element names are defined unique by a Default Config file in MEDINAinstallation directory and additional by an User-defined Config file in $HOME/.medinadirectory.
First the Default Config file and after that a User-defined Config file are read in duringthe start of the MEDINA PreProcessing, whereas the definitions in the User-definedConfig file obtain higher priority.
At this time the default ABAQUS element names are defined and can be controlled byEList command in the column Name.
When saving a BIF, the element names are unique and can be converted to ABAQUS(with correct SURFACE identification).
Note
The User-defined Config file which could be defined in the BIFABA monitoris removed because the user shall use only one Config file.
User-Config-File
The User-defined Config file is defined in $HOME/.medina<version>.abq directory.
88
Solver Interfaces
In this file the input data can be written in 3 columns:
• In the 1st column the related MEDINA elements are defined
• In the 2nd column the related MEDINA properties are defined
• In the 3rd column the ABAQUS elements are defined (user default ABAQUSelements) and can be changed by the user
Note
The user shall change only the third column (see below).
# Med_Eletyp Med_Proptyp Abaqus_Eletyp
BAR BAR B31
QUAD4 SHELL S4R
TETRA10 SOLID C3D10
The other input data (e.g. the related property ID, the surface name, etc.) are managedby MEDINA.
4.1.2. BIFABA-> Interface BIF to ABAQUS
4.1.2.1. BIFABA - Parameters
BIF -> ABAQUS input
89
Solver Interfaces
Figure 4.1. BIFABA Interface
The following table compares and describes the parameters in the Start Monitor andthe command line parameters for the tcl batch script:
Start Monitor Batch Script Description
Working directory dir=dirname Set the working directory for file access.
BIF Input file bif=filename Binary input file from MEDINA PreProcessing.
Configuration file config=filename Formatted input file with the default ABAQUSelement types for MEDINA elements.
Output file inp=filename Formatted output file used as ABAQUS inputdeck.
Replace existingfiles
(always replace) The monitor toggle has two states, ON andOFF. If the toggle is ON, existing files, e.g. theBIF output file, are overwritten. If called from ascript, files are always replaced.
Discretizeconnectors
discrconn If this toggle is ON, or the parameter"discrconn" is entered at the script command
90
Solver Interfaces
Start Monitor Batch Script Descriptionline, connector elements will be discretized toABAQUS elements.
Write RBE3 asequation
rbe3equat If this toggle is ON, or the parameter is enteredat the script command line, RBE3 elementsare written to the ABAQUS solver deck asequation.
Write uniqueABAQUS labels
uniquelabel If this toggle is set to ON, the labels ofproperties, materials and orientations arechanged (if necessary) to make them unique.Each blank in labels of properties, materials,sets and orientations is replaced by anunderscore. If the label is not unique, twounderscores followed by the external ID of thecorresponding property are added to the label.
Property/Material/Set names
longname=0|1|2 Defines how to convert property, material andset names. Options:
MEDINA name only (default) [0]
MEDINA id and MEDINA name [1]
MEDINA id only [2]
Summarize SPC/NFORCE/PRESSURE in newsets
createset If this toggle is ON, or the parameter is enteredat the script command line, SPC, NFORCEand PRESSURE definitions are summarized inthe ABAQUS solver deck in sets. The sets arenewly created.
Additional programparameters
Batch bit=32|64warning=number
log=filename
Parameters shared by all interfaces (seechapter 1 for a description), plus additionalparameters described in the next section.
4.1.2.2. BIFABA - Additional program parameters
The additional program parameters are referenced in the additional parameter field inthis way:
"opt=-parameter value"
91
Solver Interfaces
-clayer name Select name as the coordinate file for
layers
The layer file is referenced in
the Additional
program parameters field with the
option:
"opt=-clayer <directory-name>/
<filename>"
If value contains spaces (eg. my
file), type:
{opt=-clayer "<directory-name>/my
file"}
Example 1:
To assign file name myfile to
parameter clayer, type:
"opt=-clayer myfile"
Example 2:
To assign file name my file to
paramater clayer, type:
{opt=-parameter "my file"}
-warning number "opt=-warning<number>", number of
warnings which
shall be displayed.
Calling BIFABA without MEDINA Monitor
Call:
<inst_directory>/cae/bin/bifaba bif=name inp=name [config=name]
[longname={0|1|2}] [createset] [discrconn] [rbe3equat]
[size=number] [dir=name] [log=name] [warning=number] [batch]
[uniquelabel] [bit={32|64}]
If optional parameters are omitted, the first value of the numeration is the default value.
92
Solver Interfaces
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. bifaba).
All unsupported cards are written automatically to solvercard.
4.1.2.3. BIFABA - Initial conditions
BIFABA reads initial conditions (shell thicknesses and strains) from several MEDINABOF files and writes them to the ABAQUS input file. A layer file controls the reading ofdata from BOF file and the writing of the necessary ABAQUS statements.
SYNTAXES
*BOF :
Defines the name of the MEDINA BOF file for initial conditions. Required parameter:
FILE=<name>
Example:
*BOFFILE, FILE=/mapping1.bof
*BOFFILE, FILE=/mapping2.bof
*SCALE:
Defines the scale factor. Required parameter:
TYPE=<type>
Where type:
= THICKNESS, scale factor for shell thickness
= STRAIN, scale factor for initial strain
Example:
*SCALE,TYPE=THICKNESS,PID=26
0.1
*SCALE,TYPE=STRAIN,PID=26
0.1
Optional parameter:
93
Solver Interfaces
PID=<number>
Property-ID for which the scale factor is valid, if not defined the scale factor is appliedto all PIDs.
Example:
See above in *SCALE syntax.
Layer:
-clayer filename Select filename as the filename for
layers
The layer file is referenced in
the Additional
program parameters field with the
option:
"opt=-clayer <directory-name>/
<filename>"
If value contains spaces (eg. my
file), type:
{opt=-clayer "<directory-name>/my
file"}
Shell Thickness:
ABAQUS statement for shell thicknesses is:
*NODAL THICKNESS
Initial Strains:
ABAQUS statement for initial strains is:
*INITIAL CONDITIONS, TYPE=HARDENING
MEDINA data elements:
key 204 physical meaning EffPlasticStrain
key 204 physical meaning THICKNESS
Initial strain for each element is averaged over all element nodes.
94
Solver Interfaces
4.1.2.4. BIFABA - Automatic node set detection
When writing the data elements NFORCE, SPC and PRESSURE, the BIFABAinterface automatically detects and writes node set IDs instead of numerous node IDswhen the above data elements have been created using node sets.
4.1.2.5. BIFABA - Beam Sections
The ABAQUS interface supports ABAQUS cross sections for beams (*BEAMSECTION).
If for a standard cross section in MEDINA there is an equivalent standard cross sectionin ABAQUS, BIFABA automatically detects and converts it.
If there is no equivalent cross section in ABAQUS (e.g. for a Z-Section in MEDINA),it is translated as a general cross section.
For a detailed list of cross sections in MEDINA and ABAQUS, see the list below.
See also: MEDINA PreProcessing Reference Manual, BeamSection command.
Cross Section MEDINA ABAQUS
Circle Circular
Tube Pipe
Rectangle Rectangular
Box Box
Triangle -
95
Solver Interfaces
Cross Section MEDINA ABAQUS
Triangle Tube Arbitrary (thin-walled)
Angle Arbitrary
I -Section I
I-General -
T-Section I-Section, several thicknesses to zero
Z-Section Arbitrary
U-Section Arbitrary
L-Section L
Arbitrary (thin-walled)
Arbitrary (thin-walled, open and closedsections)
96
Solver Interfaces
Cross Section MEDINA ABAQUS
--- (Arbitrary) Hexagonal
--- (Arbitrary) Trapezoidal
4.1.3. ABABIF -> Interface ABAQUS to BIF
4.1.3.1. ABABIF - Parameters
ABAQUS input -> BIF
Figure 4.2. ABABIF Interface
The following table compares and describes the parameters in the Start Monitor andthe command line parameters for the tcl batch script:
97
Solver Interfaces
Start MonitorParameter
Batch ScriptParameter
Description
Workingdirectory
dir=dirname Set the working directory for the file.
Input file inp=filename Formatted input file used as ABAQUS inputdeck.
BIF output file bif=filename Binary file for MEDINA PreProcessing.
Replaceexisting files
(always replace) The monitor toggle has two states, ON andOFF. If the toggle is ON, existing files, e.g.the BIF output file, are overwritten. If calledfrom a script, files are always replaced.
Transformbasicorientation
transform If the toggle is ON, the orientations thatare referenced by ABAQUS JOINTC orCONN3D element and lie at the globalorigin will be transformed. Orientation will betransformed to the first node of a referencedJOINTC element. Orientation at the first nodeof CONN3D element will be transformedto the first node of the referenced elementand orientation at the second node willbe transformed to the second node of thereferenced element.
Do not checkduplicatednodes
nocheck If the toggle is OFF, the check for duplicatednodes will be run.
Keep the toggle ON to disable checkingof duplicated node and get a higherperformance of the import from ABAQUS.
Property /Material / Setnames
longname=0|1|2 Defines how to convert property, materialand set names. Options:
MEDINA name only (default) [0]
MEDINA id and MEDINA name [1]
MEDINA id only [2]
98
Solver Interfaces
Start MonitorParameter
Batch ScriptParameter
Description
Additionalprogramparameters
batch
bit=32|64
warning=number
log=filename
Parameters shared by all interfaces (seechapter 1 for a description).
"opt=-warning <number>", number ofwarnings, which shall be displayed.
"opt=-abaqus_keyword <name>" ,readxml file to check ABAQUS input file.
Calling ABABIF without MEDINA Monitor
Call:
<inst_directory>/cae/bin/ababif bif=name inp=name [longname={0|
1|2}] [abaqus_keyword=name] [size=number] [transform] [dir=name]
[log=name] [warning=number] [batch] [nocheck] [bit={32|64}]
If optional parameters are omitted, the first value of the numeration is the default value.
Note
For the description of all options and arguments above go to the installationdirectory for load modules and enter the desired interface (e.g. ababif).
All unsupported cards are read automatically from the solvercard.
4.1.3.2. ABABIF - Search for include files
ABABIF searches for include files in the following manner:
1. If an absolute path is provided exactly this path will be used.
2. If a relative path is provided ABABIF will first search the directory in which the maindeck is situated in and after that in the working directory.
4.1.4. BIFABA/ABABIF
4.1.4.1. ABAQUS - Using properties to define element sets
Elements with the same property are defined as an element set. The name of theelement set is the name of the MEDINA property.
99
Solver Interfaces
If no property name is defined, the name is a “P” followed by the property number. Thiselement set name will be output within the element definition.
Example:
*ELEMENT,TYPE=S4R,ELSET=PROPERTY19
...
...
*ELEMENT,TYPE=S3R,ELSET=P1
Optional for element sets, node sets, materials and sections (properties) the ABAQUSlabels can be replaced by the MEDINA set, material or property ID.
Use the MEDINA id & name button by the BIFABA start monitor to activate thisprocedure. Labels such as set names and surface names are case insensitive and canbe up to 80 characters long.
Example:
MEDINA PID = 1000; MEDINA label = steering_wheel
<-> ABAQUS label = P1000;steering_wheel
MEDINA SID = 3000; MEDINA label = steering_wheel
<-> ABAQUS label = S3000;steering_wheel
MEDINA PID = 5000; MEDINA label = st_14
<-> ABAQUS label = M5000;st_14
Step definition with the reject file
ABAQUS cards not supported by MEDINA can be written in ascii format to solvercardor to the reject file.
There is a possibility to connect different ABAQUS steps with MEDINA load cases withthe reject file.
SYNTAXES:
*MEDINA
<< MEDINA KEY, LOADID >>
MEDINA Key ABAQUS Card
SPC *BOUNDARY ( MODEL + HISTORY)
NFORCE *CLOAD ( HISTORY )
PRESSURE *DLOAD ( HISTORY )
100
Solver Interfaces
MEDINA Key ABAQUS Card
TEMPERATURE *TEMPERATURE ( HISTORY )
BOUNDARY *BOUNDARY ( HISTORY ) Temperature
DFLUX *DFLUX ( HISTORY )
DSFLUX *DSFLUX ( HISTORY )
FILM *FILM ( HISTORY )
SFILM *SFILM ( HISTORY )
RADIATE *RADIATE ( HISTORY )
SRADIATE *SRADIATE ( HISTORY )
Example from MEDINA solvercard:
*HEADING
...
*MEDINA
<< SPC, 1>>
...
*STEP
...
...
*MEDINA
<< NFORCE,5 >>
<< SPC, 2 >>
...
*END STEP
*STEP
...
...
*MEDINA, OP=NEW
<< NFORCE, 3 >>
<< SPC, 8 >>
...
...
*END STEP
Recursive *INCLUDE
ABAQUS decks can include other ABAQUS files recursively.
101
Solver Interfaces
Recursive *INCLUDE cards may appear in the Model- and history data.
Example:
*INCLUDE,INPUT=test.inp
Name of ABAQUS DataEntry
Name ofMEDINA DataElement
Supported Parameters / Notes
SETS Section
*NSET NODE SET NSET, GENERATE
GENERATE is supported for FE inputonly.
*ELSET ELEMENT SET ELSET, GENERATE
GENERATE is supported for FE inputonly.
*SURFACEDEFINITION
BOUNDARYSET
The Face identifier for shell elements isset to P.
SYSTEMS Section
*SYSTEM CORSYS Each system card will be followed by thenodes defined in that coordinate system.
*TRANSFORMATION
*NSET,NSET=TRxx
CORSYS All nodes with the same coordinatetransformation number will be written asan ABAQUS node set with the nameTRxx, where xx is the number of thecoordinate transformation
*ORIENTATION CORSYS SYSTEM = USER is not supported
NODES Section
*NFILL NODES NFILL, BIAS, NSET
NFILL is supported for FE input only.
*NGEN NODES NGEN,NSET
NGEN is supported for FE input only.
*NODE NODES NODE,INPUT,NSET,SYSTEM
102
Solver Interfaces
Name of ABAQUS DataEntry
Name ofMEDINA DataElement
Supported Parameters / Notes
The Normal for element types withrotational degrees of freedom is notsupported.
PROPERTY Section
*BEAM GENERALSECTION
(*ELSET,ELSET=PRxx)
PROPERTY BEAM GENERAL SECTION, ELSET,SECTION=GENERAL, DENSITY
MEDINA Beam and Rod elements withthe same direction are collected in anelement set. For each element set,one BEAM GENERAL SECTION card iswritten.
*BEAM SECTION PROPERTY See BIFABA - Beam Sections
*DASHPOT PROPERTY DASHPOT, ELSET
*GAP
*FRICTION
*SURFACE BEHAVIOR
PROPERTY GAP,ELSET,TAUMAX
*MASS
*ELSET,ELSET=Mxx
ELEMENT TYP MASS, ELSET
All Mass elements with the sameProperty are collected in an element set.
*SHELL SECTION
*SHELL GENERALSECTION
PROPERTY
NSM value
SHELL SECTION, SHELL, MATERIAL
Optional parameter DENSITY andNODAL Thickness
*MEMBRAN SECTION PROPERTY Optional parameter NODAL THICKNESS
*SOLID SECTION PROPERTY SOLID SECTION, ELSET, MATERIAL
*SPRING PROPERTY SPRING, ELSET
MATERIAL Section
*MATERIAL
*ELASTIC
MATERIAL NAME
103
Solver Interfaces
Name of ABAQUS DataEntry
Name ofMEDINA DataElement
Supported Parameters / Notes
*DENSITY
ELEMENT Section
*ELEMENT ELEMENT ELEMENT,ELSET,TYPE
SPRING1, SPRING2,
SPRINGA, JOINTC
8 SPRING1 Remark: orientation coordinate system isat the 1st node
ITT31, MASS 12 MASS
GAPUNI 20 Gap
AC1D2, ASI2A, B21,B23,
B23H, B31, B31OS,B31OSH,
B33, B33H, B34H,PIPE21,
PIPE21H, PIPE31,PIPE31H
21 Bar
C1D2, DINTER2,DINTER2A,
IRS12, IRS13, ISL21,ISL21A,
ISL21AT, ISL21T, ISL31,
ISL31A, JOINTC, R2D2,
T2D2, T2D2H, T2D2E,
T2D2T, T3D2, T3D2H,
T3D2E, T3D2T
23 Rod
B22, B22H, B32, B32H, 29 Rod3
104
Solver Interfaces
Name of ABAQUS DataEntry
Name ofMEDINA DataElement
Supported Parameters / Notes
B32OS, B32OSH,PIPE22,
PIPE22H, PIPE32,PIPE32H,
T2D3, T2D3H, T2D3E,
T2D3T, T3D3, T3D3H,
T3D3E, T3D3T
AC1D3, CPE3, CPE3H,
CPS3, DC2D3, R3D3,S3R,
STRI3, STRI35
31 Tria3
CAX6H, CPE6, CPE6H,
CPE6M, CPE6MH,CPS6,
CPS6M, DC2D6,STRI65
36 Tria6
ACAX4, AC2D4, CAX4,
CPE4, CPE4H, CPE4I,
CPE4IH, CPE4R,CPE4RH,
CPS4, CPS4I, CPS4R,
DC2D4, DCC2D4,DCC2D4D,
DS4, R3D4, S4R, S4R5
41 Quad4
105
Solver Interfaces
Name of ABAQUS DataEntry
Name ofMEDINA DataElement
Supported Parameters / Notes
ACAX8, AC2D8,CAX8R,
CAX8T, CPE8, CPE8H,
CPE8R, CPE8RH,CPS8,
CPS8R, DC2D8, DS8,S8R,
S8R5, S8rT
48 Quad8
S9R5 49 Quad9
C3D4, C3D4H, C3D4E,
DC3D4, DC3D4E
61 Tetra
C3D10, C3D10H,C3D10M,
C3D10MH, C3D10E,
DC3D10, DC3D10E
62 Tetra10
C3D6, C3D6H, C3D6E,
DC3D6, DC3D6E
63 Penta
C3D15, C3D15H,C3D15E,
DC3D15, DC3D15E
64 Penta15
AC3D8, C3D8, C3D8H,
C3D8I, C3D8IH, C3D8R,
C3D8RH, C3D8T,C3D8HT,
65 Hexa
106
Solver Interfaces
Name of ABAQUS DataEntry
Name ofMEDINA DataElement
Supported Parameters / Notes
C3D8E, DC3D8,DC3D8E,
DCC3D8, DCC3D8D
C3D20, C3D20E,C3D20H,
C3D20HT, C3D20RH,
C3D20RHT, C3D20T,
C3D20P, C3D20PH,
C3D20RP, C3D20RPH,
DC3D20, DC3D20E
66 Hexa20
SC8R, SC8RT 77 HEXA8TS
SC6R, SC6RT 76 PENTA6TS
CONTACT
*SURFACE SURFACE SURFACE, NAME, TYPE, TRIM
*TIE TIE TIE, NAME, POSITION TOLERANCE,TIED NSET, ADJUST, NO ROTATION
* SHELL TO SOLIDCOUPLING
SHELL TOSOLID
CONSTRAINT NAME, INFLUENCEDISTANCE, POSITION TOLERANCE
*SURFACEINTERACTION
*FRICTION
*SURFACE BEHAVIOR
INTERACTION
PRESSUREOVERCLOSURE=TABURAR ==>LOADCURVE
NAME
ELASTIC SLIP, LAGRANGE, TAUMAX,ROUGH, SLIP TOLERANCE,ANISOTROPIC
NO SEPARATION
PRESSURE OVERCLOSURE
AUGMENTET LAGRANGE
107
Solver Interfaces
CONTACT
* CONTACT PAIR CONTACT INTERACTION, ADJUST, EXTENSIONZONE, HCRIT, SMALL SLIDING,SMOOTH, TIED
*RIGID SURFACE RIGIDSURFACE
RIGID SURFACE ,TYPE, NAME, REFNODE
Type user is not supported.
*SLIDE LINE SLIDE LINE SLIDE LINE, ELSET, GENERATE,SMOOTH
GENERATE is supported for fe input only.
CONSTRAINTS
*BOUNDARY SPC
*EQUATION MPC
*COUPLING
*KINEMATIC
RBE2ELEMENTS
CONSTRAINT NAME, REF NODE,SURFACE
*COUPLING
*DISTRIBUTING
RBE3ELEMENTS
CONSTRAINT NAME, REF NODE,SURFACE
*MPC RBAR Only for *MPC type BEAM
LOADS
*AMPLITUDE LOADCURVE NAME, TIME, VALUE
*BOUNDARY (1-6) SPC BOUNDARY,TYPE= DISPLACEMENT
*BOUNDARY (11-18) NTEMPERATUREAMPLITUDE
*CLOAD NFORCE MEDINA forces with local coordinatesystems are transformed to thedisplacement system of the node.
Abaqus forces are transformed fromthe local coordinate system of thecorresponding node in the global system.
108
Solver Interfaces
LOADSSolvercard must be used to translate*CLOAD with “OP=..” .
*DLOAD PRESSURE
*FILM CONVECTIONPROPERTY
*FILM
*SFILM
*DFLUX
*DSFLUX
*RADIATE
*SRADIATE
ETEMPERATUREAMPLITUDE, FILM AMPLITUDE
*PRE-TENSIONSECTION
Pretension Node, element, surface, normal
*TEMPERATURE NTEMPERATUREAMPLITUDE
MISCELLANEOUS
*NODAL THICKNESS MEDINA V-elements
The thickness is written into MEDINA V-elements
*DISTRIBUTION CORSYS andMEDINA V-elements
1. Only type angle and coordinateare supported. The angle is writteninto MEDINA V-elements and thecoordinate is written to MEDINAcoordinate.
2. It is supported only if referenced by*ORIENTATION and the orientation isreferenced by an ABAQUS sectioncard.
3. It is supported only for LOCATION=ELEMENT
*DISTRIBUTION TABLE CORSYS
109
Solver Interfaces
4.1.4.2. ABAQUS - Using Connection elements (CONN3D)
Both interfaces convert the elements BUSH, CONN3D and DISCBEAM with itsproperty.
The following table shows the differences between the elements:
MEDINA-CONN3D, BUSH, DISCRETE BEAM ABAQUS
Element node 1 and node 2 *ELEMENT, TYPE=CONN3D2
Element label Comment line before *ELEMENT,TYPE=CONN3D2
Element - Coordinate system 1 and 3rd ElementCoordinate system
*CONNECTOR SECTION
Connection type *CONNECTOR SECTION
Property – Label *CONNECTOR BEHAVIOUR
During the conversion of BUSH and DISCRETE BEAM elements from MEDINA toABAQUS, for each element the following warning is displayed:
"BUSH element <id> converted into CONN3D element"
"DISCRETE BEAM element <id> converted into CONN3D element"
"<id> converted into CONN3D element"
ABABIF
The CONNECTOR BEHAVIOUR is defined on Solvercard and the property of theCONN3D element contains the name of the CONNECTOR BEHAVIOUR as label.
BIFABA
The property label of the CONN3D element identifies the CONNECTOR BEHAVIOURon Solvercard and will be converted to the CONNECTOR SECTION of the CONN3Delement on ABAQUS deck.
Node_System cards
When a global coordinate system is defined by a *NODE, SYSTEM=C, *NODE,SYSTEM=S or *NODE, SYSTEM=R card, they will created in MEDINA as localcoordinate systems with the labels NODE_SYSTEMS_C, NODE_SYSTEMS_R orNODE_SYSTEMS_S.
110
Solver Interfaces
These labels cannot be changed by the COModify command in MEDINA and will beconverted correctly to ABAQUS.
4.1.5. ABABOF -> Interface ABAQUS to BOF
4.1.5.1. ABABOF - FIL Interface
The following table compares and describes the parameters in the Start Monitor andthe command line parameters for the tcl batch script.
Start MonitorParameter
Batch ScriptParameter
Description
Working directory dir=dirname Set the working directory for file access.
Input file fil=filename Binary ABAQUS result file (.fil file).
BIF output file bif=filename Binary file for MEDINA PreProcessing.
BOF output file bof=filename Binary file for MEDINA PostProcessing.
Replace existingfiles
(always replace) The monitor toggle has two states, ON andOFF.
If the toggle is ON, existing files, e.g. the BIFoutput file, are overwritten. If called from ascript, files are always replaced.
Batch Parameters shared by all interfaces (batchmode)
bit=32|64 Execution mode: 32 or 64 bit
Additionalprogramparameters
warning=number
log=filename
"opt=-warning <number>", number of warnings,which shall be displayed.
Calling ABABOF without MEDINA Monitor
<inst_directory>/cae/bin/ababof fil=name bof=name [bif=name]
[dir=name] [log=name] [warning=number] [batch] [bit={32|64}]
If optional parameters are omitted, the first value of the numeration is the default value.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. ababof).
111
Solver Interfaces
Supported result data for ABABOF/FIL
The following table lists the result data translated from the ABAQUS to the MEDINAdata format:
Name of ABAQUS DataBlock
Name ofMEDINA DataElement
Description
*NODE FILE
U
V
A
RF
CF
NT
DEFO
VKNPCO
VKNPCO
VKNPCO
VKNPCO
SKNPCO
Displacements
Velocities
Accelerations
Reaction Forces
Concentrated Forces
Nodal Temperatures
*ELFILE,POSITION=NODES
S,SINV
E
PE
SF
SINFE
DINFE
DINFE
FINFE2
Stresses and MISES Stress
Total Strains
Plastic Strains
Section Forces
*EL FILE
FILM
RAD
LOADS
FLUXS
SKINFE
SKINFE
SKINFE
SKINFE
Film
Radiation
Distributed Loads
Distributed Flux
*ELFILE,POSITION=NODES
SINFE Nodal forces caused by stress for beamelements
112
Solver Interfaces
Name of ABAQUS DataBlock
Name ofMEDINA DataElement
Description
NFORC
(only for beam elements)
*ELFILE,POSITION=NODES
S
E
(for ITT21 and ITT31elements)
SKINFE,contains S11
SKINFE,contains E11
For ITT21 and ITT31 elements S11 is thenormal component of the force and E11is the separation of the surfaces
*ELFILE,POSITION=NODES
S
E
(for JOINTC elements)
UBRR, containsS11
UBRR, containsS12
For JOINTC elements S11 is the totaldirect force in the first local direction andS12 is the total moment about the firstlocal direction.
*ELFILE,POSITION=NODES
S
E
(For GAPUNI elements)
SKINFE,contains S11
SKINFE,contains E11
For GAPUNI elements S11 is the force inthe gap and E11 is the current opening ofthe gap.
*ELFILE,POSITION=NODES
S
E
(for SPRING2 andSPRINGA elements)
SKINFE,contains S11
SKINFE,contains E11
For SPRING2 and SPRINGA elementsS11 is the force in the spring and E11is the relative displacement across thespring.
113
Solver Interfaces
Name of ABAQUS DataBlock
Name ofMEDINA DataElement
Description
*CONTACT FILE
CSTRESS,CDISP
SKNPCO,containsCPRESS
SKNPCO,contains CDISP
Contact results: CPRESS is the pressurebetween the node on the slave surfaceand the master surface and CDISP is theseparation of the surfaces in the directionof the normal.
*ELFILE,POSITION=NODES
NE
DINFE Nominal strains
As a default, BOF output for shell elements is in the local coordinate system.
If the global coordinate system is desired, the command *EL FILE,POSITION=NODES, DIRECTIONS=YES must be used.
4.1.5.2. ABABOF - ODB Interface
ABAQUS versions 6.7, 6.8, 6.9, 6.10, 6.11, 6.12, 6.13, 6.14, 2016, 2017, 2018 and2019 are supported.
When executing ABAQUS ODB interface, ABAQUS runtime libraries are required.ABAQUS runtime libraries are not part of MEDINA distribution and not installed duringMEDINA installation.
ABAQUS and ABAQUS runtime libraries and therefore ODB interface are not availablefor all platforms supported by MEDINA. Detailed information about MEDINA platformsand supported ABAQUS versions may be found at:
https://plm.t-systems-service.com/en/plm-products/simulation-cae/fem-pre-and-post-processing/medina-714910 [https://plm.t-systems-service.com/en/plm-products/simulation-cae/fem-pre-and-post-processing/medina-714910]
The ABABOF/odb interface can also be called by the MEDINA PostProcessingthrough Import command.
The following table compares and describes the parameters in the Start Monitor andthe command line parameters for the tcl batch script:
114
Solver Interfaces
Start MonitorParameter
Batch ScriptParameter
Description
Solver version abaver=version Set the ABAQUS solver version (default=auto)
Workingdirectory
dir=dirname Set the working directory for file access.
Input file odb=filename Binary ABAQUS result file (.odb file).
BIF output file bif=filename Binary file for MEDINA PreProcessing.
BOF output file bof=filename Binary file for MEDINA PostProcessing.
Replaceexisting files
(always replace) The monitor toggle has two states, ON and OFF.If the toggle is ON, existing files, e.g. the BIFoutput file, are overwritten. If called from a script,files are always replaced.
Results of initialstate
inires=1|0 If this toggle is ON, or the script parameter “inires”is set to 1, results of initial state will be written tobof file (default=1).
History data histor=0|1 If this toggle is ON, or the script parameter “histor”is set to 1, history data will be written to bof file(default=0).
Extrapolatedintegration pointresults
extrap=1|0 If this toggle is ON, or the script parameter“extrap” is set to 1, results at integration pointswill be extrapolated to the nodes by using theABAQUS libraries (default=1).
Integration pointresults
intpnt=0|1 If this toggle is ON, or the script parameter “intpnt”is set to 1, integration point results will be writtento bof file (default=0).
Reduced size ofelement results
redelr=0|1 If this toggle is ON, or the script parameter“redelr” is set to 1, the element results at nodesand the extrapolated element results will bewritten only one time for ABAQUS element typesthat have only one integration point, reducingthe size of BOF file without losing any results(default=0).
First step step_min=num The first step at which the results will be read formODB and written to bof file (default=1).
115
Solver Interfaces
Start MonitorParameter
Batch ScriptParameter
Description
Last step step_max=num The last step at which the results will be read formODB and written to bof file (default is the last stepfound on ODB file).
Increment step_inc=num Step increment between first step and last step(default=1)
First increment incr_min=num The first increment at which the results will beread form ODB and written to bof file (default=1).
Last increment incr_max=num The last increment at which the results will beread form ODB and written to bof file (default isthe last increment found on ODB file).
Increment incr_inc=num Increment between the first increment and lastincrement (default=1)
batch Parameters shared by all interfaces (batch mode)
bit=32|64 Execution mode: 32 or 64 bit
Additionalprogramparameters
log=filename The name of log file (default abaodb.log)
When ABABOF/odb is called from MEDINA PostProcessing, a PostProcessinglicense is used additionally to the interface license.
Note
If temporary directory or hard disk is full, an error message with rc=2 will beproduced.
The default Abaqus version is auto. In this case the interfaces look for theAbaqus version on ODB file.
Calling ABAODB without MEDINA Monitor
<inst_directory>/cae/bin/abaodb odb=name [bif=name]
[bof=name] [abaver={auto|6.7-2|6.8-1|6.8-EF1|6.9-1|6.9-EF2|
6.10-1|6.11-1|6.12-1|6.13-1|6.14-1|2016|2017|2018|2019}]
[inires={1|0} [histor={0|1} [redelr={0|1} [extrap={1|0}]
[intpnt={0|1}] [step_min=num] [step_max=num] [step_inc=num]
[incr_min=num] [incr_max=num] [incr_inc=num] [dir=name]
[log=name] [batch] [bit={32|64}]
116
Solver Interfaces
If optional parameters are omitted, the first value of the numeration is the default value.
4.1.5.3. ABABOF - Supported result data for ABABOF/ODB
The following tables list the model and result data converted from ABAQUS to MEDINAdata format.
Supported ABAQUS model data
Enum Name Type ID Description
Element Types
MD_UNKNOWN_ELEMENT 0 Unknown Element
MD_SPRING 9 Spring Element
MD_MASS 12 Mass Element
MD_BEAM 22 Beam Element
MD_BAR 21 Bar Element
MD_TRIA3 31 Tria Element (3 Nodes)
MD_TRIA6 36 Tria Elements (6 Nodes)
MD_QUAD4 41 Quad Elements (4 Nodes)
MD_QUAD8 48 Quad Elements (8 Nodes)
MD_TETRA 61 Tetra Elements
MD_TETRA10 62 Tetra Elements (10 Nodes)
MD_PENTA 63 Penta Elements.
MD_PENTA15 64 Penta Elements (15 Nodes)
MD_HEXA 65 Hexa Elements.
MD_HEXA20 66 Hexa Elements (20 Nodes)
MD_PLOTEL 7 Plot Elements.
MD_CONNSPOT 84 Connspot Elements
MD_ROD 23 Rod Elements
Coordinate system types
MD_CARTESIAN 1 Cartesian Coordinate System.
MD_CYLINDRICAL 2 Cylindrical Coordinate System.
MD_SPHERICAL 3 Spherical Coordinate System.
Nodes
117
Solver Interfaces
Enum Name Type ID Description
Element Sets
Node Sets
Supported ABAQUS result data
AC YIELD
AR
A
CDISP
CF
CM
CNAREA
CNORMF
COPEN
CPRESS
CSHEAR1
CSHEAR2
CSHEARF
CSLIP1
CSLIP2
CSTRESS
E11
E
FLUXS
FTEMP
FV
HFL
LE
LOADS
NE
NFORC
118
Solver Interfaces
NT
PEEQ
PEMAG
PE
PPRESS
RADFLA
RADFL
RADTLA
RADTL
RAD
RBANG
RBFOR
RBROT
RFL
RF
RM
S11
SF
SM
S
TEMP
TF
TM
UR
U
VFTOT
VR
V
History results
119
Solver Interfaces
Note
ABAQUS output variables CSLIP1 and CSLIP2 for the same load case, sameload increment and same surface will be written to MEDINA vector data elementVKNPCO (CAE key 208). The first component of this vector is CSLIP1 andthe second component is CLSIP2. The description of this result in the RSelectcommand contains the text "CSLIP12".
History result data
Use the following two ways to write ABAQUS history results from odb file to MEDINAPostProcessing:
1. MEDINA: Import command
In addition to the model and result data, the history results are imported and savedin the curve memory as result curves.
2. ABAB*F: ABAQUS ODB output -> B*f
Use the odb interface to write ABAQUS history results to the new data elementCRVTABLE on Bof.
MEDINA loadcase number
In general, the MEDINA loadcase number and the step number in ABAQUS are equal.
The step subheading in ABAQUS input file can be used to define user loadcase numberin MEDINA and must be used with the following syntax rules (case insensitive):
*STEP:
BOF_LC=<nr>; an arbitrary text where:
• nr is loadcase number in MEDINA. It must be integer positive.
• all text after semicolon is comment
• MEDINA writes the following message in log file:
"New Loadcase number <nr> extracted from step title <subheading
of step>"
For example, to define a loadcase 27005 for MEDINA, one of the following stepsubheadings in ABAQUS input file can be used:
120
Solver Interfaces
BOF_LC=27005
BOF_LC=27005;
BOF_LC=27005; Pull in both X and Y directions
BOF_LC=27005; Pull in both X and Y directions
Use the step and incr parameters in the following way:
• Control the output of initial state. The increment ID of the initial state in MEDINAmust be equal to zero, like ABAQUS. If the load factor of the first increment equalto 0.0, then the first increment is the initial state.
• Control the output of steps. The parameters step_min, step_max and step_incdefine the way to control the output of steps:
• step_min: Minimum step ID for which the results will be written to bof file.
Required: 1 <= step_min <= step_max
Default: 1
• step_max: Maximum step ID for which the results will be written to bof file.
Required: step_max >= step_min
Default: 999999999
• step_inc: Step increment. If step_inc equal to zero, then the results of the laststep will be written to bof file.
Required: step_inc >= 0
Default: 1
• Control the output of increments. The parameters incr_min, incr_max andincr_inc can be used analogous to steps to control the output of increments.
• incr_min: Minimum increment ID of the selected steps for which the results willbe written to bof file.
Required: 1 <= incr_min <= incr_max
Default: 1
121
Solver Interfaces
• incr_max: Maximum increment ID of the selected steps for which the results willbe written to bof file.
Required: incr_max >= incr_min
Default: 999999999
• incr_inc: Increment of increment. If incr_inc equal to zero, then the results of thelast increment of the selected steps will be written to bof file.
Required: incr_inc >= 0
Default: 1
Examples:
step_min=2 step_max=8 step_inc=3 (the results of the steps 2,
5 and 8
will be written to bof file)
incr_min=2 incr_max=6 incr_inc=2 (the results for the
increments 2, 4
and 6 of the selected steps
will be
written to bof file)
Analysis title
Similar to the load case title, the analysis title is read from ABAQUS ODB file andwritten to MEDINA BOF file. The analysis title is defined in ABAQUS input file after thekeyword line *HEADING.
The length of the analysis and load case titles can be up to 80 characters. The bothtitles are optional in ABAQUS and used in plot layout elements.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. abaodb).
History data: The history data are written as usual for all steps and increments.All changes must have no effect on the handling of the history data.
122
Solver Interfaces
4.2. ANSYS -> Interface to ANSYSThe ANSYS interface converts model data in two directions: from the data bus toANSYS and vice-versa.
The interface processes data of the ANSYS R10.0.
4.2.1. BIFANS -> Interface BIF to ANSYS
BIFANS converts MEDINA data (BIF Format) into ANSYS data (blocked cdb Format)according to ANSYS R10.0.
The following table compares and describes the parameters in the Start Monitor andthe command line parameters for the tcl batch script:
Start MonitorParameter
Batch Script Parameter Description
Workingdirectory
dir=dirname Set the working directory for file access.
BIF Input file bif=filename Binary input file from MEDINAPreProcessing.
Configuration file config=filename Formatted input file with the defaultANSYS element types for MEDINAelements.
Output file dat=filename Formatted output file used as ANSYSinput deck.
Replace existingfiles
(always replace) The monitor toggle has two states, ONand OFF. If the toggle is ON, existing files,e.g. the ANSYS input file, are overwritten.If called from a script, files are alwaysreplaced.
Write RBE2elements
rbe2=dof|mpc Defines how to write RBE2 elements.Options:
Write RBE2 as coupled
degrees of freedom [dof]
Write RBE2 as multi point
123
Solver Interfaces
Start MonitorParameter
Batch Script Parameter Description
constraint rigid link [mpc]
ANSYS datanot supplied byMEDINA
full=1|2 Defines how to include unsupplied cards.File options:
Add only cards completely not supported
Merge cards supplying unsupportedfields (default)
Additionalprogramparameters
batch
bit=32|64
warning=number
log=filename
Parameters shared by all interfaces (seechapter 1 for a description).
Calling BIFANS without MEDINA Monitor
Call:
<inst_directory>/cae/bin/bifans bif=name dat=name [full={1|
2}] [rbe2={dof|mpc}] [config=name] [size=number] [dir=name]
[log=name] [warning=number] [batch] [bit={32|64}]
If optional parameters are omitted, the first value of the numeration is the default value.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. bifans).
4.2.2. ANSBIF -> Interface ANSYS to BIF
ANSBIF converts ANSYS data (blocked cdb Format) according to ANSYS R10.0 intoMEDINA data (BIF Format).
The following table compares and describes the parameters in the Start Monitor andthe command line parameters for the tcl batch script:
124
Solver Interfaces
Start MonitorParameter
Batch Script Parameter Description
Workingdirectory
dir=dirname Set the working directory for file access.
Input file inp=filename Formatted input file used as ANSYS inputdeck.
BIF output file bif=filename Binary file for MEDINA PreProcessing.
Replace
existing files
(always replace) The monitor toggle has two states, ONand OFF. If the toggle is ON, existing files,e.g. the BIF output file, are overwritten.If called from a script, files are alwaysreplaced.
ANSYS datanot supplied byMEDINA
full=1|2 Defines how to include unsupplied cards.File options:
Write only cards completely notsupported
Write all cards with fields not supported(default)
Additionalprogramparameters
batch
bit=32|64
warning=number
Parameters shared by all interfaces. Seechapter 1 for a description.
Calling ANSBIF without MEDINA Monitor
Call:
<inst_directory>/cae/bin/ansbif dat=name bif=name [full={0|1|
2}] [size=number] [dir=name] [log=name] [warning=number] [batch]
[bit={32|64}]
If optional parameters are omitted, the first value of the numeration is the default value.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. ansbof).
125
Solver Interfaces
Option Meaning
bif=name Output: MEDINA data file name (e.g. medina.bif). If nameis blank no BIF file will be generated.
dat=name Name of the ansys file (e.g. ansys.dat).
warning=number No warnings will be suppressed.
Switching additional ANSYS cards not supported by MEDINA
• ignore: BIF generation without additional ANSYS cards
• write to BIF file: additional ANSYS statements are stored in the BIF file
• write to ASCII reject file: additional ANSYS statements are stored in an ASCII rejectfile
Additional program parameters
The additional program parameters are referenced in the additional parameter field inthis way:
"opt=-parameter value".
-warning number Complete warning message report
-size number Start memory size data structures
(usually automatically determined)
-vers Show the version and stop the
interface
4.2.3. BIFANS/ANSBIF
Name of ANSYS DataEntry
Name ofMEDINA DataElement
Supported Parameters / Notes
SETS Section
CMBLOCK NODE SET ENTITY=NODES
CMBLOCK ELEMENT SET ENTITY=ELEMENTS
SYSTEMS Section
CS CORSYS Extra nodes will be created
126
Solver Interfaces
Name of ANSYS DataEntry
Name ofMEDINA DataElement
Supported Parameters / Notes
NODES Section
NBLOCK NODES
PROPERTY Section
R PROPERTY SOLID, SHELL, SPRING
MASS, BAR, BEAM, ROD
No property data supported, besideSHELL/Thickness.
MATERIAL Section
MP MATERIAL Linear isotropic: EX, GXY, NUXY, ALPX,DENS
ELEMENT Section
ET ELEMENTTYPE
EBLOCK ELEMENTS
COMBIN14 8 SPRING1
COMBIN39 9 SPRING
CONTA173 31 TRIA3
41 QUAD4
CONTA174 36 TRIA6
48 QUAD8
TARGE170 31 TRIA3
36 TRIA6
41 QUAD4
48 QUAD8
MASS21 12 MASS
PIPE16, BEAM4 21 BAR
127
Solver Interfaces
Name of ANSYS DataEntry
Name ofMEDINA DataElement
Supported Parameters / Notes
BEAM44 22 BEAM
LINK8 23 ROD
SHELL28, SHELL41,SHELL43, SHELL57,SHELL63, SHELL143,SHEL157, SELL163,SHELL181, PLANE42
31 TRIA3
SHELL93, PLANE82 36 TRIA6
SHELL28, SHELL41,SHELL43, SHELL57,SHELL63, SHELL143,SHEL157, SHELL163,
SHELL181, PLANE42
41 QUAD4
SHELL93, PLANE82 48 QUAD8
SOLID45, SOLID65,
SOLID73, SOLID5,SOLID185
61 TETRA
SOLID92 62 TETRA10
SOLID45, SOLID65,
SOLID73, SOLID5,SOLID185
63 PENTA 6
SOLID45, SOLID65,
SOLID73, SOLID5,SOLID185
65 HEXA
71 PYRAM 5
SOLID186, SOLID95 66 HEXA20
64 PENTA15
62TETRA10
70 PYRAM13
128
Solver Interfaces
Name of ANSYS DataEntry
Name ofMEDINA DataElement
Supported Parameters / Notes
SOLID187 72 TETRA10
SOLID200 62 TETRA10
64 PENTA15
66 HEXA20
SOLID45, SOLID65,
SOLID73, SOLID5
71 PYRAM
CONSTRAINTS
D SPC
CE MPC
CP RBE2
MPC184 RBE2 If parameter –rbe is set
RBE3 RBE3
LOADS
F NFORCE
4.2.4. ANSBOF -> Interface ANSYS to BOFANSBOF converts ANSYS result file according to ANSYS up to version 14.5 intoMEDINA data (BOF Format).
Log-File
File name is "ansbof.log" .
<inst_directory>/cae/bin/ansbof bif=name bof=name result=name
[warning =number]
Option Meaning
bif=name Output: MEDINA data file name (e.g. medina.bif). If nameis blank no BIF file will generated.
bof=name Output: MEDINA data file name (e.g. medina.bof).
129
Solver Interfaces
Option Meaning
result=name Name of the ansys result file (e.g. ansys.rst).
warning=number No warnings will be suppressed.
Calling ANSBOF from MEDINA Monitor
The additional program parameters are referenced in the additional parameter field inthis way: "opt=-parameter value".
-warning number Complete warning message report
-vers Show the version and stop the
interface
Table of ANSYS results supported by MEDINA and ANSBOF:
Name of ANSYS DataBlock
Name ofMEDINA DataElement
Description
NSL DEFO Node Point Displacements
NSL VKINFE Node Solution (Deformation)
RF SKNPCO Reaction Forces
ENF FINFE Element Forces
ENS SINFE Real Element Stresses (in Node Points)
EEL DINFE Real Element elastic strains (in NodePoints) (not implemented)
EPL DINFE Real Element plastic strains
(not implemented)
NSL DEFOK Complex Node Point Displacements
ENS SINFEK Complex Element Stresses
RF UBRRK Complex Reaction Forces
Calling ANSBOF without MEDINA Monitor
Call:
<inst_directory>/cae/bin/ansbof result=name bof=name [bif=name]
[dir=name] [log=name] [batch] [bit={32|64}]
130
Solver Interfaces
If optional parameters are omitted, the first value of the numeration is the default value.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. ansbof).
4.3. AUTOFORM -> Interface to AUTOFORMThe AUTOFORM interface converts AUTOFORM result data to the databus.
4.3.1. AUTOBOF-> Interface AUTOFORM to BOF
The interface program autobof converts AUTOFORM (ascii) result files to MEDINABIFs and BOFs.
Call:
<inst_directory>/cae/bin/autobof bof=name result=name
[warning=number]
Option Meaning
bof=name Output: MEDINA data file name (e.g. medina.bof).
bif=name Output: MEDINA data file name (e.g. medina.bif).
result=name Name of the autoform result file.
warning=number No warnings will be suppressed.
AUTOBOF: Table of results
Name of AUTOFORMResult
Name of MEDINA Data Element Node or element type
Thickness SKNPCO Node
Plastic Strain SKINFE Element
AUTOBOF: Table of geometry data
Name of AUTOFORM Data Name of MEDINA Data Element
Nodes NPCO
Points NPCO
Facet INFE3
131
Solver Interfaces
Name of AUTOFORM Data Name of MEDINA Data Element
Element INFE3
Calling AUTOBOF without MEDINA Monitor
Call:
<inst_directory>/cae/bin/autobof dat=name bof=name [bif=name]
[dir=name] [log=name] [warning=number] [batch] [bit={32|64}]
If optional parameters are omitted, the first value of the numeration is the default value.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. autobof).
4.4. LS-DYNA -> Interface to LS-DYNABIFDYN/DYNBIF converts MEDINA data (BIF) into LS-DYNA data and vice versausing the LS-DYNA keywords, version 970 and LS-DYNA Users Manual, version 970.
DYNBOF converts the results of LS-DYNA (d3plot) into MEDINA data (BIF, BOF).
4.4.1. LS-DYNA - Introduction
The data needed to generate a model in LS-DYNA can be categorized as being eithergeometry, material or property data.
The geometry data (nodes, elements, definitions of contact, definitions of stonewalls,etc.) are dependent upon a particular model. This data is produced by a preprocessor.Most of the material data is independent of any models.
Because the property data (thickness of plates, formulation of elements, number ofintegration points, etc.) can be used in a series of models, they are stored in a database.
In addition to this categorization of data, there is a template database for LS-DYNAoptions that are not (fully) supported by the preprocessor. These templates can befilled with objects (sets) to build the models.
The file that manages the generation of the model is the control file. The informationneeded to generate a model is stored according to properties and augments thegeometry data in the BIF.
132
Solver Interfaces
This concept of data types is portrayed schematically in the following diagram:
Figure 4.3. LS-Dyna data types
4.4.2. LS-DYNA - Control fileThe control file is created together with the material and section user database whenimporting an LS-DYNA input deck into a MEDINA BIF using the DYNBIF program, ifthe “Create databases” option or the “Merge with user databases” option is chosen.
It holds information about all properties in the model, which is used when exporting aMEDINA BIF into an LS-DYNA input deck using the BIFDYN program. As a plain textfile, it can be viewed and modified by means of an editor.
Lines starting with asterisk (*) are comment lines. Comment lines are ignored byDYNBIF, except the one holding the control file version.
Each non-comment line of the control file represents the data of one property. The dataare arranged in columns with the following meaning:
Column Meaning
PID The ID of the PART card
TEXT The name of the PART card
ELE-TYP The corresponding element type, from the referenced sectioncard
ELE-FORM The ID of the HOURGLASS card referenced by the PART card
133
Solver Interfaces
Column Meaning
SECT-NAME The directory name in the section database which holds thesection card referenced by the PART card. In the control file,the directory name is preceded by a “>” sign.
DATA Some section data, depending on the element type. See tablebelow.
MATERIAL The directory name in the material database which holds thematerial card referenced by the PART card. In the control file,the directory name is preceded by a “>” sign.
CONTACT The data of a contact optional card, see table below.
INERTIA The data of a inertia optional card, see table below
Comments Room for comments. This column is ignored by the interface.
The following table shows the data stored into the control file DATA column for eachsection type:
Type DATA column values
BEAM A, ISS, ITT, IRR, SA
DISCRETE,SPRING-DAMPER
CDL, TDL
SHELL T1, T2, T3, T4. If they are all equal, only T1 is stored. All equalmeans, that for each section mapped to the same database fileT1, T2, T3 and T4 are equal, but may differ between sections.
Other For other section types no data is stored in the control file DATAcolumn.
The following table shows the data stored in the CONTACT column for each option:
Option CONTACT column values
CONTACT fs, fd, dc, vc, optt, sft, ssf
The following table shows the data stored in the INERTIA column for each option:
Option INERTIA column values
INERTIA xc,yc, zc, tm, ircs, node, ixx, ixy, ixz, iyy, iyz, izz, vtx, vty, vtz,vrx, vry, vrz, xl, yl, zl, xlip, ylip, zlip, cid
The values of the DATA and CONTACT, INERTIA columns are provided in the format:
134
Solver Interfaces
<variable name>=<variable value>,…,<variable name>=<variable
value>
For example:
*Control file version 2.0
*Created by MEDINA X.X.X.X (64 Bit)
*PID ;TEXT ;TYPE ;ELE-FORM;SECT-NAME ;DATA ;MATERIAL ;CONTACT,
INERTIA ;Comments
2000000 ; F-CH-A-PILL-TOP-ROOF-RAIL ; SHELL ; 0 ;
>SECTION_SHELL_1; T1=1.9,T2=2.9,T3=3.9,
T4=5.9; >MAT_PIECEWISE_LINEAR_PLASTICITY_1;123test
2000001 ; F-CH-A-PILLAR-BKT1-R ; SHELL ; 0 ; >SECTION_SHELL_1;
T1=1.26,T2=1.26,T3=1.26,
T4=1.26; >MAT_PIECEWISE_LINEAR_PLASTICITY_2
2000038 ; F-CH-BUMPER-FRONT-SUPPORT-BKT- ; SHELL ; 0 ;
>SECTION_SHELL_2; T1=1.3;
>MAT_PIECEWISE_LINEAR_PLASTICITY_39
2000324 ; F-MC-ENGINE-CRANK-PULLEY ; SOLID ; 2001717 ;
>SECTION_SOLID_3; ;
>MAT_PIECEWISE_LINEAR_PLASTICITY_325
4.4.2.1. Processing of materials and sections
*PID DescriptionType ofElement
Elform
Section SectionDataMaterial InertiaComment
1000 Right, frontdoors
SHELL 2 >shell_1 s=1.00 >mat_1 Introducedon June26, 1998
2000 Dummy SOLID 1 >mat_2
3000 Pipe BEAM 3 >beam_1di=1.0,da=2.0>mat_4 xc=-223.Variation 1
Key to terms
PID Property ID of the component
135
Solver Interfaces
Description Description of the component
Type of Element The type of element out of which the component consists (SOLID,BEAM, SHELL, THICK SHELL)
El form The formulation of the element
Section Reference to the database that contains the section data. If nothingis specified, then this component does not have any section data(e.g. solids)
Section data Section parameter, which will be replaced from the database
Material Reference to the material database
Inertia Additional information due to *PART_*_INERTIA cards (Only forvalues which do not correlates to the default values)
Comment Field for comments (comments are not processed.)
Comment lines are indicated by an "*" in the first column.
The delimiter between separated data items is a ";".
The separated parameters in the Section data column use a "," as a delimiter.
4.4.2.2. Definition of Template procession
To process templates, the control file was extended with the following definitions:
*PID Description Type ofElement
Elform
Section SectionData
MaterialComment
1000 Right, frontdoors
SHELL 2 >shell_1 s=1.00 >mat_1 Introducedon June26, 1998
2000 Dummy SOLID 1 >mat_2
3000 Pipe BEAM 3 >beam_1 di=1.0,da=2.0>mat_4 Variation1
*KEY Description Template ObjectCriteria Parameter
CombineAirbag >air_1 SetText
*Airbag_1
CombineRigid body >card_36 SetText
*Rigid_1
CombineAcceleration >card_41 Acc=1e5
136
Solver Interfaces
Key to terms
KEY Keyword “combine” needed to call this function
Description Comments
Template Name of file with the templates from the template Database
Object Object from MEDINA, e.g. SET Text, Box ID, Prop. ID
Criteria Text or ID to determine the MEDINA partner to be used with thetemplate
Parameter Parameters entered here using the syntax name=value will beprocessed
Template processing is available for the following LS-DYNA options with structuredformat:
LS-DYNA Option MEDINA Element MEDINA Object
CARD 35 SET SET Text
CARD 36 SET SET Text
CARD 41
CARD 51 SET SET Text
CARD 52 SET SET Text
CARD 57 SET SET Text
For the keyword format in LS-DYNA, template processing is supported for all LS-DYNAoptions that are defined by sets.
4.4.3. LS-DYNA - Databases
The databases which are used store the necessary information in LS-DYNA format,i.e. in either KEYWORD format or STRUCTURED format.
Neither a syntax check nor a consistency check is performed. The variables such as#MID which are described below, are replaced with the current values when generatinga model.
The concepts used here allow the formation of a central database which can be usedby all engineers in a team. In addition, each user can temporarily overwrite this centraldefinition by using his personal database.
137
Solver Interfaces
Team database path are defined by environment variables called “matpath”, “sectpath”and “templpath” respectively.
4.4.3.1. Material Database
Structure of the Material Database:
The material database is a directory structure in a Unix file system.
For each type of material in the directory, one subdirectory will be generated. Thematerial codes are stored in the file “default”.
uMaterial /St14/default
Material /St14/default
/Glas/default
/Mat24/default
Smaterial /spezial1/St14/default
/spezial2/var1/Glas/default
Material is the path of the material database, sMaterial is the path of the specialdatabase and uMaterial is the path of the user material database.
First bifdyn searches the user database for a material. If it is not found there, thenbifdyn searches the special database and then the central material database.
Dynbif is able to handle load curves in the following material cards:
*MAT_24 ( *MAT_PIECEWISE_LINEAR_PLASTICITY )
*MAT_24 ( *MAT_PIECEWISE_LINEAR_PLASTICITY )
*MAT_26 ( *MAT_HONEYCOMB )
*MAT_30 ( *MAT_SHAPE_MEMORY )
*MAT_33_96( *MAT_BARLAT_YLD96 )
*MAT_34 ( *MAT_FABRIC )
*MAT_36 ( *MAT_3-PARAMETER_BARLAT )
*MAT_57 ( *MAT_LOW_DENSITY_FOAM )
138
Solver Interfaces
*MAT_63 ( *MAT_CRUSHABLE_FOAM )
*MAT_71 ( *MAT_CABLE_DISCRETE_BEAM )
*MAT_73 ( *MAT_LOW_DENSITY_VISCOUS_FOAM )
*MAT_76 ( *MAT_GENERAL_VISCOELASTIC )
*MAT_81 ( *MAT_PLASTICITY_WITH_DAMAGE )
*MAT_81 ( *MAT_PLASTICITY_WITH_DAMAGE )
*MAT_83 ( *MAT_FU_CHANG_FOAM )
*MAT_113 ( *MAT_TRIP )
*MAT_120 ( *MAT_GURSON )
*MAT_123 ( *MAT_MODIFIED_PIECEWISE_LINEAR_PLASTICITY )
*MAT_123 ( *MAT_MODIFIED_PIECEWISE_LINEAR_PLASTICITY )
*MAT_126 ( *MAT_MODIFIED_HONEYCOMB )
*MAT_133 ( *MAT_BARLAT_YLD2000 )
*MAT_156 ( *MAT_MUSCLE )
*MAT_179 ( *MAT_LOW_DENSITY_SYNTHETIC_FOAM )
*MAT_187 ( *MAT_SAMP-1 )
*MAT_1001 ( *MAT_DAMPER_NONLINEAR_VISCOUS )
*MAT_1003 ( *MAT_SPRING_GENERAL_NONLINEAR )
*MAT_S15 ( *MAT_SPRING_MUSCLE )
*MAT_T01 ( *MAT_THERMAL_ISOTROPIC )
*MAT_T02 ( *MAT_THERMAL_ORTHOTROPIC )
*MAT_T03 ( *MAT_THERMAL_ISOTROPIC_TD )
*MAT_T04 ( *MAT_THERMAL_ORTHOTROPIC_TD )
*MAT_T05 ( *MAT_THERMAL_ISOTROPIC_PHASE_CHANGE )
*MAT_T06 ( *MAT_THERMAL_ISOTROPIC_TD_LC )
139
Solver Interfaces
Contents of the Material Database
The materials in the database are stored in the LS-DYNA format. The loadcurves aredefined in the same file. The internal loadcurve id is denoted with “# x #”. Such labeledloadcurve ids and “#MID” are replaced in bifdyn.
Example:
*
#MID 24 .7850E-05 0 1 0.100E+00 1
0.150E+01 0.600E-01
PSHELL ZE 260
0.2100E+03
0.3400E+00
0.2810E+00 #1#
#1# 5 0 1
0.0 #2#
0.001 #3#
0.01 #4#
0.1 #5#
0.225 #6#
#2# 3 0
0.0 0.281
0.02 0.304
0.04 0.329
#3# 2 0
0.0 0.338
0.02 0.361
#4# 2 0
0.0 0.385
0.02 0.403
#5# 1 0
0.0 0.437
140
Solver Interfaces
#6# 2 0
0.0 0.488
0.02 0.505
4.4.3.2. Section Database
Structure of the Section Database
The section database is a directory structure in a Unix file system. For each type ofsection in the directory, one subdirectory will be generated.
The actual sections are stored in the corresponding subdirectory in the file “default”.
Section is the path of the section database and uSection is the path of the user sectiondatabase.
First BIFDYN searches the user database for a section. If it is not found there, thenbifdyn searches the central section database.
Example:
USection /shell_1 / default /shell_1 / default etc.
Section /shell / default
/beam / default
/membrane / default
Contents of the Section Database
The sections are stored in the LS-DYNA formats. Parameters with "#x" are searchedfor in the parameter list of the control file and are replaced. Each #SID is replaced withthe corresponding section ID.
Example:
* shell_template: shell_1
* can be used for all shell and membrane elements *
* Parameter: #SID Section ID
* #s shell thickness
*
*
================================================================
141
Solver Interfaces
* nr|etyp|
#SID 2
shell
*shfact| z-integr| printout| quadrule|
0.83333 2.0 3.0 0.0
*thickn1| thickn2 thickn3 thickn4
ref.surf|
#s #s #s #s 0.0
*
================================================================
4.4.3.3. Template Database
The template database is for the LS-DYNA options, which are not (fully) supported bythe preprocessor.
These templates can augment the data in the BIF, which MEDINA generates.
This means that one could, for example, use an element set with one airbag and atemplate for a complete LS-DYNA definition for an airbag.
Structure of the Template Database
The template database is a directory structure in a Unix file system.
For each type of template in the directory, one subdirectory will be generated. Theactual templates are stored in the corresponding subdirectory in the file “default”.
Template is the path of the template database and uTemplate is the path of the usertemplate database.
First BIFDYN searches the user database for a template. If it is not found there, thenbifdyn searches the central template database.
Example:
UTemplat /card_36 / default /card_29 / default /card_57 / default etc.
Template /card_36 / default
etc.
Contents of the Template Database
The templates are written using the LS-DYNA formats.
142
Solver Interfaces
The parameters designated with "# x" in the parameter list in the control file will bereplaced.
Example: Airbag Definition
*card57
* V O R L A G E
* Karte 57 Lumped Parameter Control Volumes: simple airbag
model
* - param1 : heat capacity at constant volume cv
* - param2 : heat capacity at constant volume cp
*--------------------- CONTROL VOLUME DEFINITIONS
----------------*
-1 3 0 0 0.000E+00 0.000E+00 0.000E+00 0.000E+00
0.000
#SID
#param1 #param2 1.200E+03 2 7.000E-01 0.000E+00 1.470E+01
3.821E-06
4.4.4. Load Case Processing with BIFDYN
In addition to the databases material, section and template, 2 new databases will besupported:
• subassemblies like barriers
• load cases
They are structured analogous to the known databases, e.g.:
Barrier/ODB/default (INPUT of the ODB-barrier)
Barrier/ODB/control (control-file related to INPUT)
LoadCase/SideImpact/default (informations about added
barriers
and also additional data about
the
load case to create.
See description below)
The part processing will be invoked by additional BIFDYN command-line parameters:
• partpath: path to the part database (e.g. “Barrier”).
143
Solver Interfaces
• loadcasepath: path to the load case database (e.g. “Loadcase”).
• loadcase: selection of a load case in the load case database (e.g. “SideImpact”).
Note
Only those LS-DYNA cards will be supported in the part processing that aresupported by MEDINA too.
4.4.4.1. Description of Load Case Files
Supported Keywords:
*BARRIER
*BOX_CONTACT
*COOR
*ENDTIME
*INITIAL_VELOCITY
*INITIAL_IDS
*MEDINA_COOR
*TOTAL_CONTACT
Comment lines start with a "$" -sign in the first column.
In the following, the term BIF always refers to the MEDINA-BIF to be read, usually thevehicle model.
The term INPUT refers to the barriers that need to be added from the data base, whichhas to be available as executable LS-Dyna-Input file.
Furthermore, every barrier needs to be accompanied by a control file containingassignments of materials to the barrier.
4.4.4.2. Description of Keywords
=====================================================================================
$ Definition of a selection of barriers from the database
=====================================================================================
144
Solver Interfaces
*BARRIER
=====================================================================================
1.line
Column Description
FORMAT
____________________________________________________________________________________
1 - 10 ID of the barrier
I10
(ID-Barr, arbitrary but unique)
11 - 20 ID-Mirr of coordinate system for symmetry reflection
I10
of the barrier (ID-Coor, default 0)
21 - 30 ID-Trans of coordinate system for transversal
I10
positioning of the barrier (ID-Coor, default 0)
31 - 40 ID of initial velocity set of the barrier
I10
(ID-IniV, default 0)
41 - 50 ID of initial ID set of the barrier
I10
(ID-IniS, default 0)
2.line
Column Description
FORMAT
____________________________________________________________________________________
1 - 80 Name of the barrier (from barrier database)
A80
=====================================================================================
$ Definition of an additional contact as box over BIF and
barriers with all materials
=====================================================================================
*BOX_CONTACT
=====================================================================================
1. line
Column Description
FORMAT
145
Solver Interfaces
____________________________________________________________________________________
1 - 10 Dummy
I10
=====================================================================================
$ Definition of a local coordinate system by three points
=====================================================================================
*COOR
=====================================================================================
1. line
Column Description
FORMAT
____________________________________________________________________________________
1 - 10 ID of the local coordinate system
I10
(ID-Coor, arbitrary but unique)
11 - 20 X-coordinate of the origin
E10.0
21 - 30 Y-coordinate of the origin
E10.0
31 - 40 Z-coordinate of the origin
E10.0
41 - 50 X-coordinate of point on local x-axis
E10.0
51 - 60 Y-coordinate of point on local x-axis
E10.0
61 - 70 Z-coordinate of point on local x-axis
E10.0
2. line
Column Description
FORMAT
____________________________________________________________________________________
1 - 10 X-coordinate of point in local x-y plane
E10.0
11 - 20 Y-coordinate of point in local x-y plane
E10.0
21 - 30 Z-coordinate of point in local x-y plane
E10.0
146
Solver Interfaces
=====================================================================================
$ Definition of the calculation end time (overwrites template-
value)
=====================================================================================
*ENDTIME
=====================================================================================
1. line
Column Description
FORMAT
____________________________________________________________________________________
1 - 10 End time for LSDYNA-Input
E10.0
=====================================================================================
$ Definition of a set with initial velocities for the barrier
$ in global coordinates
$ Only for INITV=6 and for materials applied with initial
velocity cards in INPUT
=====================================================================================
*INITIAL_VELOCITY
=====================================================================================
1.line
Column Description
FORMAT
____________________________________________________________________________________
1 - 10 ID of initial velocity set
I10
(ID-IniV, arbitrary but unique)
11 - 20 Global X-velocity component of the barrier
E10.0
21 - 30 Global Y-velocity component of the barrier
E10.0
31 - 40 Global Z-velocity component of the barrier
E10.0
2.line
Column Description
FORMAT
____________________________________________________________________________________
147
Solver Interfaces
1 - 10 Rotational velocity of the barrier
E10.0
11 - 20 X-coordinate of point on rotational axis
E10.0
21 - 30 Y-coordinate of point on rotational axis
E10.0
31 - 40 Z-coordinate of point on rotational axis
E10.0
41 - 50 X-direction cosine of rotational axis
E10.0
51 - 60 Y-direction cosine of rotational axis
E10.0
61 - 57 Z-direction cosine of rotational axis
E10.0
=====================================================================================
$ Definition of a set with offsets for the barrier numbering
$ Offset=-1 – automatic count-up renumbering
$ Offset=-2 – numbering exactly as defined in INPUT
$ (User is responsible for correct numbering)
$ Offset>=0 – specified offset to be applied if possible, else
automatic count-up
$ applies.
=====================================================================================
*INITIAL_IDS
=====================================================================================
1. line
Column Description
FORMAT
____________________________________________________________________________________
1 - 10 ID of initial ID set
I10
(ID-IniS, arbitrary but unique)
11 - 20 Offset of node renumbering
I10
(default 0, -1: no renumbering)
21 - 30 Offset of element- renumbering
I10
(default 0, -1: no renumbering)
148
Solver Interfaces
31 - 40 Offset of part- renumbering
I10
(default 0, -1: no renumbering)
41 - 50 Offset of coordinate system renumbering
I10
(default 0, -1: no renumbering)
51 - 60 Offset of load curve renumbering
I10
(default 0, -1: no renumbering)
71 - 80 Dummy
I10
2. line
Column Description
FORMAT
____________________________________________________________________________________
1 - 10 Dummy
I10
11 - 20 Dummy
I10
21 - 30 Dummy
I10
31 - 40 Dummy
I10
41 - 50 Dummy
I10
51 - 60 Dummy
I10
61 - 70 Dummy
I10
71 - 80 Dummy
I10
=====================================================================================
$ Assignment of an ID-Coor to a local coordinate system of
MEDINA
=====================================================================================
*MEDINA_COOR
=====================================================================================
149
Solver Interfaces
1.line
Column Description
FORMAT
____________________________________________________________________________________
1 - 10 ID of the local coordinate system
I10
(ID-Coor, arbitrary but unique)
2.line
Column Description
FORMAT
____________________________________________________________________________________
1 - 80 Name of the local coordinate system in MEDINA
A80
(must be available on BIF)
=====================================================================================
$ Definition of an additional contact as complement of a
contact on BIF
$ (Name: TOTAL_CONTACT) by the contact at the assigned
position in INPUT.
$ The box will be enhanced and also the list of materials,
that either will be added
$ or excluded.
=====================================================================================
*TOTAL_CONTACT
=====================================================================================
Column Description
FORMAT
____________________________________________________________________________________
1 - 10 Position at which the contact from the barrier
I10
will be found in INPUT, so that a total contact
may be created by this contact and the contact
from BIF with name “TOTAL_CONTACT”.
150
Solver Interfaces
4.4.4.3. Examples
4.4.4.3.1. Example 1
$BEGIN-of example file
-|----3----|----4----|----5----|----6----|----7----|----8
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
*MEDINA_COOR
9
xz-plane
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
*MEDINA_COOR
13
left_sideimpact
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
*INITIAL_VELOCITY
5 0.00 +9.50 0.00
*INITIAL_IDS
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
$ IDoffs NODE ELEM PART LCOR CURV
ORIE
77 8000000 8000000 8000000 0 0
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
*BARRIER
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
$ ID-Barr ID-Mirr ID-Trans ID-IniV ID-IniS
100 9 13 5 77
odb
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
*TOTAL_CONTACT
2
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
$ENDE of example file
--|----3----|----4----|----5----|----6----|----7----|----8
4.4.4.3.2. Example 2: (MINIMAL-Example)
$BEGIN of example file
-|----3----|----4----|----5----|----6----|----7----|----8
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
151
Solver Interfaces
*MEDINA_COOR
1
left_sideimpact
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
*BARRIER
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
$ ID-Barr ID-Mirr ID-Trans ID-IniV ID-IniS
100 0 1
odb
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
*TOTAL_CONTACT
1
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
$ENDE of example file
--|----3----|----4----|----5----|----6----|----7----|----8
4.4.4.3.3. Example 3 (MAXIMAL-Example)
$BEGIN of example file
-|----3----|----4----|----5----|----6----|----7----|----8
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
*COOR
9 0.0 0.0 0.0 1.0 0.0
0.0
0.0 0.0 1.0
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
*MEDINA_COOR
13
left_sideimpact
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
*INITIAL_VELOCITY
5 0.00 +9.50 0.00
*INITIAL_IDS
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
$ IDoffs NODE ELEM PART LCOR CURV
ORIE
77 8000000 8000000 8000000 0 0
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
*BARRIER
152
Solver Interfaces
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
$ ID-Barr ID-Mirr ID-Trans ID-IniV ID-IniS
100 9 13 5 77
odb
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
*TOTAL_CONTACT
2
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
*BOX_CONTACT
999
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
*ENDTIME
120.0
$---|----1----|----2----|----3----|----4----|----5----|----6----|----7----|----8
$ENDE of example file
--|----3----|----4----|----5----|----6----|----7----|----8
4.4.5. LS-DYNA - INCLUDE Transform
The LS-DYNA interfaces from MEDINA transfer *INCLUDE and *INCLUDE_TRANSFORM cards from a LS-DYNA deck to parts in MEDINA and vice versa.
The MEDINA parts are transformed if they created from the LS-DYNA cards*INCLUDE_TRANSFORM and the *DEFINE_TRANSFORMATION. In all cases theLS-DYNA card *INCLUDE_PATH is supported, if this card is defined.
These cards allow the geometrical placement of different objects into space.
Offsets of different IDs are likewise taken into consideration.
Transformations with regard to the mass, time, length and temperature are not takeninto account.
4.4.5.1. DYNBIF
Functionality within DYNBIF
The relative transformation matrices from the *DEFINE_TRANSFORMATION-mapare converted in the given order recursively into the absolute transformation matrixof the part, i.e. several relative transformations are substituted with an absolutetransformation.
153
Solver Interfaces
Transformations of nodes, elements and other cards with local coordinates will betranslated to the global coordinate system of MEDINA.
Nodes, elements, Properties and all relations on them (see the following list) will berecursively renumbered with the given offset.
Data from the *INCLUDE transform map will be found in the MEDINA part.
*AIRBAG_SIMPLE_PRESSURE_VOLUME
*BOUNDARY_PRESCRIBED_MOTION_NODE
*BOUNDARY_PRESCRIBED_MOTION_RIGID
*BOUNDARY_PRESCRIBED_MOTION_RIGID_LOCAL
*BOUNDARY_PRESCRIBED_MOTION_SET
*BOUNDARY_SPC_NODE*BOUNDARY_SPC_SET
*CONSTRAINED_EXTRA_NODES_NODE
*CONSTRAINED_EXTRA_NODES_SET
*CONSTRAINED_GENERALIZED_WELD_BUTT
*CONSTRAINED_GENERALIZED_WELD_FILLET
*CONSTRAINED_GENERALIZED_WELD_SPOT
*CONSTRAINED_INTERPOLATION
*CONSTRAINED_JOINT_CYLINDRICAL
*CONSTRAINED_JOINT_LOCKING
*CONSTRAINED_JOINT_PLANAR
*CONSTRAINED_JOINT_REVOLUTE
*CONSTRAINED_JOINT_SPHERICAL
*CONSTRAINED_JOINT_TRANSLATIONAL
*CONSTRAINED_JOINT_UNIVERSAL
*CONSTRAINED_NODAL_RIGID_BODY
154
Solver Interfaces
*CONSTRAINED_NODAL_RIGID_BODY_INERTIA
*CONSTRAINED_NODE_SET
*CONSTRAINED_RIGID_BODIES
*CONSTRAINED_RIVET
*CONSTRAINED_SPOTWELD
*CONTACT_AUTOMATIC_SINGLE_SURFACE
*CONTACT_ERODING_SINGLE_SURFACE
*CONTACT_ERODING_SURFACE_TO_SURFACE
*CONTACT_FORCE_TRANSDUCER_PENALTY
*CONTACT_NODES_TO_SURFACE
*CONTACT_ONE_WAY_SURFACE_TO_SURFACE
*CONTACT_SINGLE_EDGE
*CONTACT_SURFACE_TO_SURFACE
*CONTACT_TIED_NODES_TO_SURFACE
*CONTROL_
*CONTROL_HOURGLASS
*DATABASE_CROSS_SECTION_PLANE
*DATABASE_CROSS_SECTION_PLANE_ID
*DATABASE_CROSS_SECTION_SET
*DATABASE_CROSS_SECTION_SET_ID
*DATABASE_HISTORY_BEAM
*DATABASE_HISTORY_BEAM_SET
*DATABASE_HISTORY_BEAM_ID
*DATABASE_HISTORY_NODE
155
Solver Interfaces
*DATABASE_HISTORY_NODE_SET
*DATABASE_HISTORY_NODE_ID
*DATABASE_HISTORY_SHELL
*DATABASE_HISTORY_SHELL_SET
*DATABASE_HISTORY_SHELL_ID
*DATABASE_HISTORY_SOLID
*DATABASE_HISTORY_SOLID_SET
*DATABASE_HISTORY_SOLID_ID
*DATABASE_HISTORY_TSHELL
*DATABASE_HISTORY_TSHELL_SET
*DATABASE_HISTORY_TSHELL_ID+B28
*DATABASE_NODAL_FORCE_GROUP
*DEFINE_BOX
*DEFINE_COORDINATE_NODES
*DEFINE_COORDINATE_SYSTEM
*DEFINE_COORDINATE_VECTOR
*DEFINE_CURVE
*DEFINE_SD_ORIENTATION
*DEFINE_TABLE
*DEFINE_VECTOR
*DEFINE_VECTOR_NODES
*ELEMENT_BEAM
*ELEMENT_BEAM_ORIENTATION
*ELEMENT_BEAM_PID
156
Solver Interfaces
*ELEMENT_BEAM_THICKNESS
*ELEMENT_DISCRETE
*ELEMENT_MASS
*ELEMENT_SEATBELT
*ELEMENT_SEATBELT_ACCELEROMETER
*ELEMENT_SHELL
*ELEMENT_SHELL_BETA
*ELEMENT_SHELL_BETA_OFFSET
*ELEMENT_SHELL_MCID
*ELEMENT_SHELL_MCID_OFFSET
*ELEMENT_SHELL_OFFSET
*ELEMENT_SHELL_THICKNESS
*ELEMENT_SOLID
*ELEMENT_SOLID_ORTHO
*ELEMENT_TSHELL
*END
*HOURGLASS
*INCLUDE
*INCLUDE_PATH
*INITIAL_VELOCITY
*INITIAL_VELOCITY_GENERATION
*INITIAL_VELOCITY_NODE
*INTERFACE_COMPONENT_NODE
*INTERFACE_COMPONENT_SEGMENT
*KEYWORD
157
Solver Interfaces
*LOAD_BODY_X
*LOAD_BODY_Y
*LOAD_BODY_Z
*LOAD_NODE_POINT
*LOAD_NODE_SET
*LOAD_RIGID_BODY
*LOAD_SHELL_ELEMENT
*LOAD_THERMAL_CONSTANT
*MAT
*NODE
*PART
*PART_COMPOSITE
*PART_COMPOSITE_CONTACT
*PART_COMPOSITE_TSHELL
*RIGIDWALL_GEOMETRIC_CYLINDER
*RIGIDWALL_GEOMETRIC_CYLINDER_MOTION
*RIGIDWALL_GEOMETRIC_FLAT
*RIGIDWALL_GEOMETRIC_FLAT_MOTION
*RIGIDWALL_GEOMETRIC_PRISM
*RIGIDWALL_GEOMETRIC_PRISM_MOTION
*RIGIDWALL_GEOMETRIC_SPHERE
*RIGIDWALL_GEOMETRIC_SPHERE_MOTION
*RIGIDWALL_PLANAR
*RIGIDWALL_PLANAR_FINITE
158
Solver Interfaces
*RIGIDWALL_PLANAR_FINITE_MOVING
*RIGIDWALL_PLANAR_MOVING
*SECTION_BEAM
*SECTION_DISCRETE
*SECTION_SHELL
*SECTION_SOLID
*SET_BEAM
*SET_DISCRETE
*SET_NODE
*SET_NODE_COLUMN
*SET_NODE_LIST
*SET_NODE_LIST_TITLE
*SET_PART
*SET_PART_COLUMN
*SET_PART_LIST
*SET_SEGMENT
*SET_SHELL
*SET_SHELL_COLUMN
*SET_SHELL_LIST
*SET_SOLID
*SET_TSHELL
*TITLE
Note
DYNBIF supports only LS-DYNA3D keyword format.
159
Solver Interfaces
4.4.5.2. BIFDYN
If the option "Write extra include file for each part" is set, then the interface for everypart (except root) generates an include file.
Additionally, either a *INCLUDE or if the transformation of the part does not correspondto the identity matrix, a card pair consisting of a *INCLUDE_TRANSFORM with itsaccompanying *DEFINE_TRANSFORMATION will be generated.
Note
During the use of BIFDYN in automated processes, BIFDYN gives backreturncode 10 if a warning occurs.
4.4.5.3. Supported contact cards in MEDINA
Contacttype
*CONTACT_[Description]
1 AIRBAG_SINGLE_SURFACE
2 AUTOMATIC_GENERAL
3 AUTOMATIC_NODES_TO_SURFACE
4 AUTOMATIC_ONE_WAY_SURFACE_TO_SURFACE
5 AUTOMATIC_SINGLE_SURFACE
6 AUTOMATIC_SURFACE_TO_SURFACE
7 CONSTRAINT_NODES_TO_SURFACE
8 CONSTRAINT_SURFACE_TO_SURFACE
9 DRAWBEAD
10 ERODING_NODES_TO_SURFACE
11 ERODING_SINGLE_SURFACE
12 ERODING_SURFACE_TO_SURFACE
13 FORCE_TRANSDUCER_CONSTRAINT
14 FORCE_TRANSDUCER_PENALTY
15 FORMING_NODES_TO_SURFACE
16 FORMING_ONE_WAY_SURFACE_TO_SURFACE
17 FORMING_SURFACE_TO_SURFACE
18 NODES_TO_SURFACE
160
Solver Interfaces
Contacttype
*CONTACT_[Description]
19 ONE_WAY_SURFACE_TO_SURFACE
20 RIGID_NODES_TO_RIGID_BODY
21 RIGID_BODY_ONE_WAY_TO_RIGID_BODY
22 RIGID_BODY_TWO_WAY_TO_RIGID_BODY
23 SINGLE_EDGE
24 SINGLE_SURFACE
25 SLIDING_ONLY
26 SLIDING_ONLY_PENALTY
27 SURFACE_TO_SURFACE
28 TIEBREAK_NODES_TO_SURFACE
29 TIEBREAK_SURFACE_TO_SURFACE
30 TIED_NODES_TO_SURFACE
31 TIED_SHELL_EDGE_TO_SURFACE
32 TIED_SURFACE_TO_SURFACE
33 TIED_NODES_TO_SURFACE_OFFSET
34 TIED_SHELL_EDGE_TO_SURFACE_OFFSET
35 TIED_SURFACE_TO_SURFACE_OFFSET
36 TIED_SHELL_EDGE_TO_SURFACE_BEAM_OFFSET
37 TIED_NODES_TO_SURFACE_CONSTRAINED_OFFSET
38 TIED_SHELL_EDGE_TO_SURFACE_CONSTRAINED_OFFSET
39 TIED_SURFACE_TO_SURFACE_CONSTRAINED_OFFSET
4.4.6. LS-DYNA - Template File for Control Cards
The information for the LS-DYNA control cards in the template file is stored in LS-DYNA Structured Input Format.
Data that is in the MEDINA data file will be replaced. All other data is taken from thetemplate file and passed on to the LS-DYNA input file.
If there is no template file specified, then the default values will be written onto thecontrol cards.
161
Solver Interfaces
The data in the template file must be written in the LS-DYNA format.
4.4.7. LS-DYNA - Processing Control Card Informationto Property Data
Using the program DYNBIF with the parameter “material” (or using the option “createdatabase”), the control file information is written to the control file and additionally aMEDINA property is generated in the following manner:
Example:
Control file 1000; right front door; SHELL; 2; >shell_1; s=1.00; >mat_1;
Property ID=1000
thickness=1.00
label="right front door; 2; >shell_1; s=1.00;"
mid=1
Material ID=1
label=">mat_1"
4.4.8. LS-DYNA - Processing Information fromProperty Data Structure
The interface program bifdyn search for control file information in the property labels,this information is processed to the LS-DYNA input file.
4.4.9. LS-DYNA - Initial conditions
BIFDYN reads initial conditions (shell thicknesses and strains) from several MEDINABOF files and writes them to the LS-DYNA input file.
A layer file controls the reading of data from BOF file and the writing of the necessaryLS-DYNA statements.
SYNTAX:
*BOF :
Defines the name of the MEDINA BOF file for initial conditions. Required parameter:
162
Solver Interfaces
FILE=<name>
*LAYER:
First line:
Layer ID, Layer coordinates
*SCALE:
Defines the scale factor. Required parameter:
TYPE=<type>
Where type:
= THICKNESS, scale factor for shell thickness
= STRAIN, scale factor for initial strain
Optional parameter
PID=<number>
Property-ID for which the scale factor is valid, if not defined the scale factor is appliedto all PIDs.
First line: Scale factor
Example:
*BOFFILE, FILE=/mapping1.bof
*BOFFILE, FILE=/mapping2.bof
*LAYER
1, 0.0
2, -0.906179846
3, -0.538469310
4, 0.538469310
5, 0.906179846
*SCALE,TYPE=THICKNESS,PID=26
0.1
*SCALE,TYPE=STRAIN,PID=26
0.1
163
Solver Interfaces
The layer file is referenced in the Additional program parameters field in the interfacestart window with the option:
"opt=-clayer <directory-name>/<filename>"
If the file name contains blanks (e.g. my file), the correct input is:
{opt=-clayer "<directory-name>/my file”}
Shell elements are written to the LS-DYNA input file as shells with variable thicknesses.
LS-DYNA statement for initial strains is (keyword input only):
*INITIAL_STRESS_SHELL with the corresponding layer coordinates
MEDINA data elements
key 204 physical meaning EffPlasticStrain
key 204 physical meaning THICKNESS
Initial strain for each element is averaged over all element nodes.
4.4.10. LS-DYNA - Method to Generate a Model
Generating the databases
Use a LS-DYNA input deck to generate the databases needed for DYNBIF.
Call DYNBIF:
dynbif –dat input –bif test.bif –material
It generates the databases dbsection and dbmaterial in the current workingdirectory.
The control file which is produced is stored under dbcontrol. These files cannot existin the working directory before the call.
Example named “plate”:
The following input files are available for the example named “plate”:
plate.bif file name with the MEDINA data
plate.control list of components
164
Solver Interfaces
plate.template control card template
Material directory with the material data
Section directory with the section data
Call BIFDYN:
bifdyn bif plate.bif –dat plate.inp –large –matpath Material –
sectpath Section –control plate.control
BIFDYN generates a LS-DYNA input deck with the name plate.inp.
This example is in:
<inst_directory>/cae/data/bifdyn/example
4.4.11. BIFDYN -> Interface BIF to LS-DYNA
The interface BIFDYN converts MEDINA data (BIF) into LS-DYNA data.
The following table compares and describes the parameters in the MEDINA Monitorand the command line parameters for the tcl batch script:
Start MonitorParameter
Batch ScriptParameter
Description
Workingdirectory
dir=dirname Set the working directory for file access.
BIF Input file bif=filename Binary input file from MEDINA PreProcessing.
BIFDYN controlfile
control=filename Specify a BIFDYN component control file.
DYNA3D controlcard template file
template=filenameSpecify a template file for DYNA3D control cards.
User materialdatabase
umatpath=dirnameSet the directory of the user material database.
User sectiondatabase
usectpath=dirnameSet the directory of the user section database.
User templatedatabase
utemplpath=dirnameSet the directory of the user template database.
Output file inp=filename Formatted output file used as DYNA3D inputdeck.
165
Solver Interfaces
Start MonitorParameter
Batch ScriptParameter
Description
Replace existingfiles
(always replace) The monitor toggle has two states, ON andOFF. If the toggle is ON, existing files, e.g. theDYNA3D input file, are overwritten. If called froma script, files are always replaced.
Write extrainclude file foreach part
Part If this toggle is ON, for each part in the modela separate include file is written, containing allelements, properties, coordinate systems, cross-sections, stonewall, Box3D, etc. of that part.
Discretizeconnectors
discrconn If this toggle is ON, or the parameter“discrconn” is entered at the script commandline, connector elements will be discretized toDYNA3D elements.
Output format format= keyword Only keyword format is supported
Additionalprogramparametersspecific toBIFDYN
-dthermal -matoffset=number
-matloffset=number
-ectoffset=number
-sectpath =name
-matpath =name
-templpath=name
-smatpath
Write Control cards for thermal coupled analysis.
Offset for material numbers.
Offset for material load curves.
Offset for sections.
Name is the path name of the section database.
Name is the path name of the material database.
Name is the path name of the template database.
Path of the special database.
Plus additional parameters described in thefollowing chapter.
Additionalprogramparametersshared by allinterfaces
batch
bit=32|64
warning=number
log=filename
Parameters shared by all interfaces (see chapter1 for a description)
166
Solver Interfaces
Calling BIFDYN without MEDINA Monitor
Call:
<inst_directory>/cae/bin/bifdyn bif=name inp=name
[format={keyword}] [replace] [control=name] [template=name]
[matpath=name] [sectpath=name] [templpath=name] [umatpath=name]
[usectpath=name] [utemplpath=name] [matoffset=number]
[matloffset=number] [sectoffset=number] [flansch=number]
[dthermal] [discrconn] [parts] [size=number] [dir=name]
[log=name] [warning=number] [batch] [bit={32|64}]
if optional parameters are omitted, the first value of the numeration is the default value.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. bifdyn).
BIFDYN supports only LS-DYNA3D keyword format.
Example:
To convert the MEDINA file test.bif into the LS-DYNA file test.inp in the keyword format,use:
<inst_directory>/cae/bin/bifdyn bif=test.bif inp=test.inp
Calling BIFDYN from MEDINA Monitor
To define the names of the material database, the section database and the templatedatabase for MEDINA Monitor set environment variables matpath, sectpath andtemplpath to the appropriate directory names.
If these variables are set, the names of the corresponding directories are shown in theBIFDYN start window.
4.4.11.1. More Additional parameters
The additional program parameters are referenced in the additional parameter field inthis way:
"opt=-parameter <name/number>"
167
Solver Interfaces
Option Meaning
-bof name select name as the MEDINA bof file for initial strain and thickness
-newbif name write new bif including bif and parts
-prot name select name as the protocol file (default prot)
-beamnode node-id
writes ELEMENT_BEAM and uses “node-id” as 3. free node id ineach created card.
beamnode [0] writes ELEMENT_BEAM and creates a 3. free nodefor each element.
If "-beamnode node-id“ is NOT defined, creates onlyELEMENT_BEAM_ORIENTATION with Orientation vector.
Otherwise, creates only ELEMENT_BEAM with additional 3. freenode.
-clayer name select name as the coordinate file for layers
-fcparam reading extra contact parameters from the control file
-flansch number switch on flange option number
-freenodes delete the free nodes
-hourglass switch for Hourglass-ID=Material-ID (keyword input only)
-lcfirst write the load curves before the material cards (sequential inputonly)
-loadcase name load case file name
-loadcasepathname
path of the load case database
-refprop only referenced properties will be considered
-noquality DEBUG switch - use first material if no material quality is specified
-parts Write extra include files for each part
-partpath name path of the part database
-statedump time time increment for state dumps (pltc)
-storm storm = 1: write one material-/section-card for each property
storm = 2: write one section-card for each property
168
Solver Interfaces
Option Meaningstorm = 3: write one section-card for each property. The propertyid is used for the section id
storm = 4: write one material-/section-card for each property. Theproperty id is used for the material id and section id
-termtime time termination time for the LSDYNA job
-ucontrol name select name as the user control file
-wcontrol name write a new control file <name>
Note
An option with additional parameters which are separated by blanks are usedcorrectly, if the complete expression is enclosed by curly brackets or byquotation marks (e.g. {opt=-beamnode node-id}.
4.4.12. DYNBIF -> Interface LS-DYNA to BIF
The interface program DYNBIF converts LS-DYNA data into MEDINA data (BIFs).
Calling DYNBIF from the MEDINA Monitor
The following table compares and describes the parameters in the MEDINA Monitorand the command line parameters for the tcl batch script:
Start MonitorParameter
Batch ScriptParameter
Description
Workingdirectory
dir=dirname Set the working directory for file access.
Input file inp=filename Formatted input file used as DYNA3D inputdeck.
User materialdatabase
umatpath=dirname Set the directory of the user material database.
User sectiondatabase
usectpath=dirname Set the directory of the user section database.
BIF output file bif=filename Binary file for MEDINA PreProcessing.
Replaceexisting files
(always replace) The monitor toggle has two states, ON andOFF. If the toggle is ON, existing files, e.g. the
169
Solver Interfaces
Start MonitorParameter
Batch ScriptParameter
Description
DYNA3D input file, are overwritten. If calledfrom a script, files are always replaced.
Read nodesand elementsonly
onlyelementsnodes If this toggle is ON, only nodes and elementswill be read from the LS-DYNA input file.
Delete free 3rdnodes of bars
freenodes If this toggle is ON, the free 3rd nodes of barelements will be deleted.
Write constraintNRB as RBE2
rbe2 If this toggle is ON, LS-DYNA constraint NRBsin the input file will be translated into MEDINARBE2 elements in the BIF file.
Assign separatePID to eachNRB
(see below) If this toggle is ON, a separate property ID isassigned to each nodal rigid body element inthe file.
Start PID nrbstartpid=number If the previous toggle is ON, a start ID for theproperties may be entered.
Additionalprogramparametersspecific toDYNBIF
-dthermal
-sectpath=name
-matpath=name
lsdyna_keyword=filename
Write Control cards for thermal coupledanalysis.
Name is the path name of the sectiondatabase.
Name is the path name of the materialdatabase.
Filename is the name of xml file.
Default: …/data/dyna3d/lsdyna_keyword.xml
Dynbif checks the keywords in input deckby means of keywords in the xml file andwrites the state of these keywords in the file<logfilename>_unsupported.log. Every line ofthe <logfilename>_unsupported.log containsof for parts as following:
170
Solver Interfaces
Start MonitorParameter
Batch ScriptParameter
Description
Keywor;Message typ;number ofkeywords,Message
Additionalprogramparametersshared by allinterfaces
batch
bit=32|64
warning=number
log=filename
Parameters shared by all interfaces (seechapter 1 for a description), plus additionalparameters described in the next section.
Calling DYNBIF without MEDINA Monitor
Call:
<inst_directory>/cae/bin/dynbif inp=name bif=name
[matpath=name] [sectpath=name] [umatpath=name] [usectpath=name]
[freenodes] [nrbtype={set|rbe2}] [nrbstartpid=number]
[material] [dthermal] [onlyelementsnodes] [lsdyna_keyword=name]
[card36] [card=number] [size=number] [dir=name] [log=name]
[warning=number] [batch] [bit={32|64}]
If optional parameters are omitted, the first value of the numeration is the default value.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface with version number(e.g. dynbif84).
4.4.12.1. More Additional parameters
The additional program parameters are referenced in the additional parameter field inthis way:
"opt=-parameter <name/number>"
Additional parameters:
Option Meaning
-prot name select name as the protocol file (default prot).
171
Solver Interfaces
Option Meaning
-warning number complete warning message report.
-card number Read until that card number.
-card36 read a nodal rigid body constraint set as a set (structured inputonly)
-dthermal dyna3d thermal or coupled structural/thermal analysis.
-discretefromcontrol write material and section of springs and dampers in database
-fcparam reading extra contact parameters from the control file
-freenodes delete the free nodes.
-keepnumber keeps the original material-, section- and loadcurve-id whencreating the databases
-material read the material card 3. and creates the databases
-onlyelementsnodes read only elements and nodes.
-nrbstartpid a separate property ID is assigned to each nodal rigid bodyelement, starting with the ID given here.
-rbe2 read a *CONSTRAINED_NODAL_RIGID_BODY as RBE2element (keyword input only)
-umatpath name checks each materials, not found in <matpath>, if it exists inthe database - if not adding it to the database. If <name> is notexisting it will be created. (default: dbMaterial).
-sectpath name checks each section in the input if it exists in the database (ifexisting) - if not checks the <usectpath>.
-smatpath path of the special database
-usectpath name checks each section, not found in <sectpath>, if it exists in thedatabase - if not adding it to the database. If <name> is notexisting it will be created. (default: dbSection).
-secform writes a comment for the element formulation to the database.(for structured solver file only).
-control name writes a control file <name>. (default: dbpropin).
-vers show the version and stop the interface
Calling DYNBIF without MEDINA Monitor
Call:
172
Solver Interfaces
<inst_directory>/cae/bin/dynbif84 inp=name bif=name [log=name]
[dir=name] [freenodes] [material] [dthermal] [card36]
[card=number] [warning=number]
If optional parameters are omitted, the first value of the numeration is the default value.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. dynbif).
Option Meaning
inp=name Input: LS-DYNA data file name (e.g.: test.inp)
bif=name Output: MEDINA data files name (e.g. medina.bif)
log=name Output: log file name (default: dynbif.log)
dir=name Name is the path name of the working directory
freenodes Delete free third beam nodes.
material Generate the databases and the control file
dthermal Control cards for the thermal coupled analysis will beread.
card36 Use the spot welds only in beams
weldspot={set|rbe2} Translate a constrained node set or a constrained nodalrigid body to a MEDINA set or RBE2 element. (keywordformat only)
nrbstartpid=number Start pid for NRB elements from LS-Dyna without adefined property ID. Each element gets its own property.
card=number Process all options up to the card number
warning=number No warnings will be suppressed.
Example:
To convert the MEDINA file test.bif into the LS-DYNA file test.inp in the large format,use:
<inst_directory>/cae/bin/dynbif bif=test.bif inp=test.inp
4.4.12.2. Search for include files
DYNBIF searches for include files in the following manner:
173
Solver Interfaces
• If an absolute path is provided exactly this path will be used.
• If a relative path is provided, DYNBIF will first search the directory in which the maindeck is situated. If the include file is not found and *INCLUDE_PATH is defined, thenDYNBIF looks for the file in the directories specified by *INCLUDE_PATH.
4.4.12.3. DYNBIF: KEYWORD Input
Name of LS-DYNA DATA Entry Support Name ofMEDINAEntry
Remarks
*AIRBAG_SIMPLE_PRESSURE_VOLUME Full General Setwith Solverkey
None
*BOUNDARY_PRESCRIBED_MOTION_NODE Full PVAD None
*BOUNDARY_PRESCRIBED_MOTION_RIGID Full PVAD None
*BOUNDARY_PRESCRIBED_MOTION_RIGID_LOCAL Full PVAD None
*BOUNDARY_PRESCRIBED_MOTION_SET Full PVAD None
*BOUNDARY_PRESCRIBED_MOTION_SET_BOX Full PVAD None
*BOUNDARY_SPC_NODE None
*BOUNDARY_SPC_SET None
*CONSTRAINED_EXTRA_NODES_NODE Full General Setwith Solverkey
None
*CONSTRAINED_EXTRA_NODES_SET Full General Setwith Solverkey
None
*CONSTRAINED_GENERALIZED_WELD_BUTT Full General Setwith Solverkey
None
*CONSTRAINED_GENERALIZED_WELD_FILLET Full General Setwith Solverkey
None
*CONSTRAINED_GENERALIZED_WELD_SPOT Full General Setwith Solverkey
None
*CONSTRAINED_INTERPOLATION None
*CONSTRAINED_JOINT_CYLINDRICAL Full JCYLINelement
None
*CONSTRAINED_JOINT_LOCKING Full JLOCKINGelement
None
174
Solver Interfaces
Name of LS-DYNA DATA Entry Support Name ofMEDINAEntry
Remarks
*CONSTRAINED_JOINT_PLANAR Full JPLANARelement
None
*CONSTRAINED_JOINT_REVOLUTE Full JREVOLVEelement
None
*CONSTRAINED_JOINT_SPHERICAL Full JSPHEREelement
None
*CONSTRAINED_JOINT_TRANSLATIONAL Full JTRANSLelement
None
*CONSTRAINED_JOINT_UNIVERSAL Full JUNIVERSelement
None
*CONSTRAINED_NODAL_RIGID_BODY Full NRIGBODYelement
None
*CONSTRAINED_NODAL_RIGID_BODY_INERTIA Full NRIGBODYelement withinertiaparameter
None
*CONSTRAINED_NODE_SET Full General Setwith Solverkey
None
*CONSTRAINED_RIGID_BODIES Full General Setwith Solverkey
None
*CONSTRAINED_RIVET Full General Setwith Solverkey
None
*CONSTRAINED_SPOTWELD Full General Setwith Solverkey
None
*CONTACT_* Limited Contact None
*CONTACT_INTERIOR Full General Setwith Solverkey
None
*CONTROL_ Solvercard None
*CONTROL_HOURGLASS None
*DATABASE_CROSS_SECTION_PLANE Full CrossSection SetAnalysis
175
Solver Interfaces
Name of LS-DYNA DATA Entry Support Name ofMEDINAEntry
Remarks
System toLS-DYNAin Paramcommand
*DATABASE_CROSS_SECTION_PLANE_ID Full CrossSection SetAnalysisSystem toLS-DYNAin Paramcommand
*DATABASE_CROSS_SECTION_SET Full CrossSection SetAnalysisSystem toLS-DYNAin Paramcommand
*DATABASE_CROSS_SECTION_SET_ID Full CrossSection SetAnalysisSystem toLS-DYNAin Paramcommand
*DATABASE_HISTORY_BEAM Full General Setwith Solverkey
None
*DATABASE_HISTORY_BEAM_SET Full General Setwith Solverkey
None
*DATABASE_HISTORY_BEAM_ID Full General Setwith Solverkey
None
*DATABASE_HISTORY_NODE Full General Setwith Solverkey
None
*DATABASE_HISTORY_NODE_SET Full General Setwith Solverkey
None
176
Solver Interfaces
Name of LS-DYNA DATA Entry Support Name ofMEDINAEntry
Remarks
*DATABASE_HISTORY_NODE_ID Full General Setwith Solverkey
None
*DATABASE_HISTORY_SHELL Full General Setwith Solverkey
None
*DATABASE_HISTORY_SHELL_SET Full General Setwith Solverkey
None
*DATABASE_HISTORY_SHELL_ID Full General Setwith Solverkey
None
*DATABASE_HISTORY_SOLID Full General Setwith Solverkey
None
*DATABASE_HISTORY_SOLID_SET Full General Setwith Solverkey
None
*DATABASE_HISTORY_SOLID_ID Full General Setwith Solverkey
None
*DATABASE_HISTORY_TSHELL Full General Setwith Solverkey
None
*DATABASE_HISTORY_TSHELL_SET Full General Setwith Solverkey
None
*DATABASE_HISTORY_TSHELL_ID Full General Setwith Solverkey
None
*DATABASE_NODAL_FORCE_GROUP Full General Setwith Solverkey
None
*DEFINE_BOX Full Box3D None
*DEFINE_COORDINATE_NODES Full CoordinateSystem of typeNode
None
*DEFINE_COORDINATE_SYSTEM Full CoordinateSystem of typeCoordinates
None
177
Solver Interfaces
Name of LS-DYNA DATA Entry Support Name ofMEDINAEntry
Remarks
*DEFINE_COORDINATE_VECTOR Full CoordinateSystem of typeCoordinates
None
*DEFINE_CURVE Limited Loadcurve SIDR andDATTYPare notsupported.
*DEFINE_SD_ORIENTATION Full OrientationVector
None
*DEFINE_TRANSFORMATION None
*DEFINE_TABLE Limited Loadcurve None
*DEFINE_VECTOR Full Vector None
*DEFINE_VECTOR_NODES Full Vector None
*ELEMENT_BEAM Full BEAMelement
None
*ELEMENT_BEAM_ORIENTATION Full BEAMelement
None
*ELEMENT_BEAM_PID Limited BEAMelement
None
*ELEMENT_BEAM_THICKNESS Limited BEAMelement
Thicknessnotsupported
*ELEMENT_BEAM_SCALAR Limited BEAMelement
Thicknessnotsupported
*ELEMENT_DISCRETE Full NLSPRING,NLDAMPelements
None
*ELEMENT_MASS Full MASSelement
None
*ELEMENT_MASS_NODE_SET Full NSM None
178
Solver Interfaces
Name of LS-DYNA DATA Entry Support Name ofMEDINAEntry
Remarks
*ELEMENT_MASS_PART Full NSM None
*ELEMENT_MASS_PART_SET Full NSM None
*ELEMENT_SEATBELT Full General Setwith Solverkey
None
*ELEMENT_SEATBELT_ACCELEROMETER Full General Setwith Solverkey
None
*ELEMENT_SEATBELT_SLIPRING Full General Setwith Solverkey
None
*ELEMENT_SHELL Full TRIA3,QUAD4element
None
*ELEMENT_SHELL_BETA Full TRIA3V,QUAD4Velement
None
*ELEMENT_SHELL_BETA_OFFSET Full TRIA3V,QUAD4Velement
None
*ELEMENT_SHELL_MCID Full TRIA3V,QUAD4Velement
None
*ELEMENT_SHELL_MCID_OFFSET Full TRIA3V,QUAD4Velement
None
*ELEMENT_SHELL_OFFSET Full TRIA3V,QUAD4Velement
None
*ELEMENT_SHELL_THICKNESS Full TRIA3V,QUAD4Velement
None
*ELEMENT_SOLID Full TETRA,TETRA10,PENTA,
None
179
Solver Interfaces
Name of LS-DYNA DATA Entry Support Name ofMEDINAEntry
Remarks
HEXA,PYRAMelement
*ELEMENT_SOLID_ORTHO Limited TETRA,PENTA,HEXAelement
A1, A2,A3, BETHAand D1, D2,D3 ignored
*ELEMENT_TSHELL Full PENTA6TS,HEXA8TSelements
None
*HOURGLASS None
*INCLUDE Full Part structure Includestructure issupportedas Partstructure
*INCLUDE_PATH Full Part structure None
*INITIAL_STRESS_SECTION Full General Setwith Solverkey
None
*INITIAL_VELOCITY Full IniVel None
*INITIAL_VELOCITY_GENERATION Full IniVel None
*INITIAL_VELOCITY_NODE Full IniVel None
*INITIAL_VELOCITY_RIGID_BODY Full IniVel None
*INTERFACE_COMPONENT_NODE Full General Setwith Solverkey
None
*INTERFACE_COMPONENT_SEGMENT Full General Setwith Solverkey
None
*LOAD_BODY_X, Y, Z Full Accel None
*LOAD_BODY_RX, RY, RZ Full Accel None
*LOAD_BODY_PART Full Accel None
*LOAD_BODY_VECTOR Full Accel None
180
Solver Interfaces
Name of LS-DYNA DATA Entry Support Name ofMEDINAEntry
Remarks
*LOAD_NODE_POINT Limited CNL(ConcentratedNodal Loads)
FollowerForce/Moment(DOF=4andDOF=8)notsupported
*LOAD_NODE_SET Limited CNL(ConcentratedNodal Loads)
None
*LOAD_RIGID Limited CNL(ConcentratedNodal Loads)
None
*LOAD_SHELL_ELEMENT None
*LOAD_THERMAL_CONSTANT Limited ElementTemperature
Node Set(NSIDEX)and Box3d(BOXID)notsupported
*MAT Material None
*NODE Full Nodes None
*PART Full Property,Controlfile
None
*PART_COMPOSITE Full COMPOSITEProperty
None
*PART_COMPOSITE_CONTACT Full COMPOSITEProperty
None
*PART_COMPOSITE_TSHELL Full COMPOSITEProperty
None
*RIGIDWALL_GEOMETRIC_CYLINDER Full Stonewall None
181
Solver Interfaces
Name of LS-DYNA DATA Entry Support Name ofMEDINAEntry
Remarks
*RIGIDWALL_GEOMETRIC_CYLINDER_MOTION Full Stonewall None
*RIGIDWALL_GEOMETRIC_FLAT Full Stonewall None
*RIGIDWALL_GEOMETRIC_FLAT_MOTION Full Stonewall None
*RIGIDWALL_GEOMETRIC_PRISM Full Stonewall None
*RIGIDWALL_GEOMETRIC_PRISM_MOTION Full Stonewall None
*RIGIDWALL_GEOMETRIC_SPHERE Full Stonewall None
*RIGIDWALL_GEOMETRIC_SPHERE_MOTION Full Stonewall None
*RIGIDWALL_PLANAR Full Stonewall None
*RIGIDWALL_PLANAR_FINITE Full Stonewall None
*RIGIDWALL_PLANAR_FINITE_MOVING Full Stonewall None
*RIGIDWALL_PLANAR_MOVING Full Stonewall None
*SECTION_BEAM Database Property +Controlfile
None
*SECTION_DISCRETE Database Property +Controlfile
None
*SECTION_SHELL Database Property +Controlfile
None
*SECTION_SOLID Database Property +Controlfile
None
*SET_BEAM Full General Setwith Solverkey
None
*SET_BEAM_ADD Full General Setwith Solverkey
None
*SET_BEAM_GENERAL Full General Setwith Solverkey
None
*SET_BEAM_GENERATE Full General Setwith Solverkey
None
*SET_DISCRETE Full General Setwith Solverkey
None
182
Solver Interfaces
Name of LS-DYNA DATA Entry Support Name ofMEDINAEntry
Remarks
*SET_DISCRETE_GENERAL Full General Setwith Solverkey
None
*SET_DISCRETE_GENERATE Full General Setwith Solverkey
None
*SET_NODE Full General Setwith Solverkey
None
*SET_NODE_ADD Full General Setwith Solverkey
None
*SET_NODE_ADD_ADVANCED Full General Setwith Solverkey
None
*SET_NODE_COLUMN Full General Setwith Solverkey
None
*SET_NODE_GENERAL Full General Setwith Solverkey
None
*SET_NODE_LIST Full General Setwith Solverkey
None
*SET_NODE_LIST_GENERATE Full General Setwith Solverkey
None
*SET_PART Full General Setwith Solverkey
None
*SET_PART_ADD Full General Setwith Solverkey
None
*SET_PART_COLUMN Full General Setwith Solverkey
None
*SET_PART_LIST Full General Setwith Solverkey
None
*SET_PART_LIST_GENERATE Full General Setwith Solverkey
None
*SET_SEGMENT Full General Setwith Solverkey
None
183
Solver Interfaces
Name of LS-DYNA DATA Entry Support Name ofMEDINAEntry
Remarks
*SET_SEGMENT_GENERAL Full General Setwith Solverkey
None
*SET_SHELL Full General Setwith Solverkey
None
*SET_SHELL_ADD Full General Setwith Solverkey
None
*SET_SHELL_COLUMN Full General Setwith Solverkey
None
*SET_SHELL_GENERAL Full General Setwith Solverkey
None
*SET_SHELL_LIST Full General Setwith Solverkey
None
*SET_SHELL_LIST_GENERATE Full General Setwith Solverkey
None
*SET_SOLID Full General Setwith Solverkey
None
*SET_SOLID_ADD Full General Setwith Solverkey
None
*SET_SOLID_GENERAL Full General Setwith Solverkey
None
*SET_SOLID_GENERATE Full General Setwith Solverkey
None
*SET_TSHELL Full General Setwith Solverkey
None
*SET_TSHELL_GENERAL Full General Setwith Solverkey
None
*SET_TSHELL_GENERATE Full General Setwith Solverkey
None
The keywords above are used to denote the given options for the SET data element.Additional parameters follow the keyword and are separated by commas.
184
Solver Interfaces
Use keywords exactly as shown (e.g. upper case, no further blanks are allowed).
Additional user comments are possible. Append a semicolon and the comment textafter the keyword. User comments are written as a comment line to the output file.
Note
The DYNBIF interface only converts a Discrete Beam as Bush element to theMEDINA Bif file if a material data base is created.
With it creates NO data base, Discrete Beams are converted to normal Beamelements.
Examples:
*CONSTRAINED_NODE_SET,1 means x-translation
*CONSTRAINED_EXTRA_NODES_SET,1 means RIGID BODY
material ID = 1
*CONSTRAINED_RIGID_BODIES means PROPERTY_SET
contains master
and slave IDs. 1st entry
is master
followed by one or more
slaves.
*BOUNDARY_PRESCRIBED_MOTION_SET,1,0 means x-translation
velocity definition
*BOUNDARY_PRESCRIBED_MOTION_SET,2,1 means y-translation
acceleration definition
*BOUNDARY_PRESCRIBED_MOTION_SET,3,2 means z-translation
displacement definition
*DATABASE_CROSS_SECTION_SET,1,NODE means Cross section, ID
1, nodes
*DATABASE_CROSS_SECTION_SET,1,SHEL means Cross section, ID
1, shells
*DATABASE_HISTORY_NODE; RADNABEN means keyword and
comment
The following keywords with ID and title are supported:
*CONSTRAINED_JOINT_OPTION
*DATABASE_CROSSECTION_SET
185
Solver Interfaces
*DATABASE_HISTORY_NODE
*DATABASE_HISTORY_SHELL
*DATABASE_HISTORY_SOLID
*DATABASE_HISTORY_TSHELL
*DEFINE_BOX
*DEFINE_COORDINATE_NODES
*DEFINE_COORDINATE_SYSTEM
*DEFINE_TABLE
*DEFINE_CURVE
*BOUNDARY_PRESCRIBED_MOTION_OPTION
*SET_{Option}_{Option} (described above)
Additional Information:
• Output file header: Contains information about files used, a timestamp andinterface version information.
• Filtering and Sorting: Node IDs which are referenced by*DATABASE_HISTORY_NODE are written in ascending order to the output file.Each node ID entry is unique.
Generation of 3rd beam node:
One orientation node for each element rod, bar, beam is generated.
Exception:
No node generation for rod with property 1111 or 1110 (e.g. weldspot or rivet).
Orientation node is defined by orientation vector:
• Rod: Uses automatic generation of orientation vector.
• Beams: Orientation vector is directly used.
Generation method:
+90° rotation of the beam in a suitable plane in the local coordinate system.
186
Solver Interfaces
Origin of local coordinate system is node 2. (until bifdyn V.6.0.5.20)
Origin of local coordinate system is node 1. (bifdyn V.6.0.5.21)
The generation algorithm was changed in bifdyn version 6.0.5.17.
MEDINA Orientation Vector
Element Internal Key Available Length Generation Comment
Bar 21 yes = 0
> 0
yes
-
Warning message inlogfile
-
Beam 22 yes = 0
> 0
yes
-
Warning message inlogfile
-
Rod 23 no - yes Exception seeabove
4.4.12.4. DYNBIF: Fix Input Format
If the program is called in FIX format, the data must be defined within the context ofthe following keywords:
LS-DYNA Keyword FormatUsed forReading
Remarks
*NODE (I8,3e16.9,2i8)
*ELEMENT_BEAM (5I8) Nodal point 3 for orientationwill be used to calculate theorientation vector at the firstnode. After that, the nodalpoint 3 will be ignored.
*ELEMENT_SHELL (6I8) Only elements with 4 nodes
*ELEMENT_DISCRETE (5i8,e16.0,i8,e16.0)
*ELEMENT_MASS (2i8,e16.9)
*DEFINE_COORDINATE_SYSTEM (i10,6e10.0)
*DEFINE_COORDINATE_VECTOR (i10,6e10.0)
187
Solver Interfaces
LS-DYNA Keyword FormatUsed forReading
Remarks
*DEFINE_COORDINATE_NODES (i10,6e10.0)
*LOAD_BODY_X (i10,e10.0,i10)
*LOAD_BODY_Y (i10,e10.0,i10)
*LOAD_BODY_Z (i10,e10.0,i10)
*INITIAL_VELOCITY_NODE (i10,6e10.0)
In FIX format, a comma produces an input error.
In LS-DYNA format, a comma forces the record to be read in FREE format.
In FIX format, you can still use two asterisks in the first two columns, or use a singleasterisk followed by a keyword to denote keywords.
The data for all keywords that are not mentioned above are read using FREE format.
4.4.13. DYNBOF -> Interface LS-DYNA to BOFThe interface program DYNBOF converts LS-DYNA d3plot files to MEDINA BIFs andBOFs.
Call:
<inst_directory>/cae/bin/dynbof bif=name bof=name result=name
[minmax='string'] [warning=number]
If optional parameters are omitted, the first value of the numeration is the default value.
Option Meaning
bif=name Output: MEDINA data file name (e.g. medina.bif).
If name is blank no BIF file will generated.
bof=name Output: MEDINA data file name (e.g. medina.bof)
result=name Select name as the dyna3d d3plot file
Nodalres Generate nodal results
minmax='string' Select the states to process name='first,last,increment'
warning=number Warning message report
Log=name Name of the log file
188
Solver Interfaces
Option result:
The name of the d3plot family is denoted with the parameter "result" (only singleprecision is supported). D3plot for 64 bit format are not supported.
Option minmax:
The option minmax is used to limit the number of steps that are included in the BOF file.
These are denoted by a string consisting of the first step, the last step, the increment,all separated by commas.
Example:
minmax='10,100,5' means output every fifth
step, starting from
step 10, all the way up
to step 100.
Calling DYNBOF without MEDINA Monitor
Call:
dynbof result=name bof=name [bif=name] [nodalres] [resinfo]
[from=num] [to=num] [incr=num] [dir=name] [log=name]
[warning=number] [batch] [bit={32|64}]
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. dynbof).
4.4.13.1. DYNBOF: Table of results
Name of LS-DYNA Result Name of MEDINAData Element
Node or Element Type
Displacements DEFO node
Velocity VKNPCO node
Accelerations VKNPCO Node
Element forces FINFE2 Beam
Element stresses SINFE Brick, shell, (tshell)
Element strain DINFE (brick, shell)
189
Solver Interfaces
Name of LS-DYNA Result Name of MEDINAData Element
Node or Element Type
Effective plastic strain SKINFE Brick, shell, (tshell)
Thickness SKINFE (shell)
User defines variables SKINFE (brick)
The output of the element types in parentheses in column 3 may be specified by theuser.
4.5. MARC -> Interface to MARCFeatures
The BIFMARC and MARCBIF interfaces converts a model data file (BIF) into a MARCinput file and vice versa according to MARC Version K7, Solver Reference Manual.
The MARCBIF interface converts a binary or formatted MARC result file into a modeldata file (BIF) and a result data file (BOF) in the CAE data bus format.
4.5.1. BIFMARC -> Interface BIF to MARC
BIFMARC converts MEDINA data (BIF Format) into MARC input data.
The following table compares and describes the parameters in the MEDINA Monitorand the command line parameters for the tcl batch script:
Start MonitorParameter
Batch ScriptParameter
Description
Workingdirectory
dir=dirname Set the working directory for file access.
BIF Input file bif=filename Binary input file from MEDINA PreProcessing.
Configurationfile
config=filename Formatted input file with the default MARCelement types for MEDINA elements.
Output file dat=filename Formatted output file used as MARC input deck.
Replaceexisting files
(always replace) The monitor toggle has two states, ON and OFF.If the toggle is ON, existing files, e.g. the MARCinput file, are overwritten. If called from a script,files are always replaced.
190
Solver Interfaces
Start MonitorParameter
Batch ScriptParameter
Description
Additionalprogramparameters
batch
bit=32|64
warning=number
log=filename
Parameters shared by all interfaces (see chapter1 for a description).
Supported data
The following data elements of the CAE data bus are supported:
CAE Data Elementnumber / name
Meaning MARC output
1 / NPCO Node points COORDINATES
20 / GAP Elements with 2 nodes CONNECTIVITY, Elementtype 12,
with GEOMETRY
21 / BAR Elements with 2 nodes CONNECTIVITY, Elementtype 98,
with GEOMETRY
23 / ROD Elements with 2 nodes CONNECTIVITY, Elementtype 9,
with GEOMETRY
31 / INFE3 Elements with 3 nodes CONNECTIVITY, Elementtype 75,
with GEOMETRY
41 / INFE4 Elements with 4 nodes CONNECTIVITY, Elementtype 75,
with GEOMETRY
34 / INFE3V Elements with 3 nodeswith
variable thickness
CONNECTIVITY, Elementtype 75,
with GEOMETRY
44 / INFE4V Elements with 4 nodeswith
variable thickness
CONNECTIVITY, Elementtype 75,
with GEOMETRY
191
Solver Interfaces
CAE Data Elementnumber / name
Meaning MARC output
65 / HEXA8 Elements with 8 nodes CONNECTIVITY, Elementtyp 7,
with GEOMETRY
13 / TETRA4 Elements with 6 nodes CONNECTIVITY, Elementtype 7,
with GEOMETRY
63 / PENTA6 Elements with 6 nodes CONNECTIVITY, Elementtyp 7,
with GEOMETRY
62 / TETRA10 Elements with 10 nodes CONNECTIVITY, Elementtyp 127,
with GEOMETRY
8,9 / SPRINGS SPRINGS
CONTACT CONTACT
115 / MPC TYING, type: 1,2,3,4,5,6,100
113 / SPC FIXED DISPLACEMENT
100 / NODE SET DEFINE NODE SET
100 / ELEMENT SET DEFINE ELEMENT SET
3 / CORSYS TRANSFORMATION
Calling BIFMARC without MEDINA Monitor
Call:
<inst_directory>/cae/bin/bifmarc bif=name dat=name
[config=name] [size=number] [dir=name] [log=name]
[warning=number] [batch] [bit={32|64}]
If optional parameters are omitted, the first value of the numeration is the default value.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. bifmarc).
4.5.2. MARCBIF -> Interface MARC to BIFMARCBIF programs converts a MARC input file into a model data file (BIF).
192
Solver Interfaces
The following table compares and describes the parameters in the MEDINA Monitorand the command line parameters for the tcl batch script:
Start Monitor Parameter Batch Script Parameter Description
Working directory dir=dirname Set the working directory forfile access.
Input file inp=filename Formatted input file used asMARC input deck.
BIF output file bif=filename Binary file for MEDINAPreProcessing.
Replace existing files (always replace) The monitor toggle has twostates, ON and OFF. If thetoggle is ON, existing files,e.g. the BIF output file, areoverwritten. If called froma script, files are alwaysreplaced.
Additional programparameters
batch
bit=32|64
warning=number
log=filename
Parameters shared by allinterfaces (see chapter 1 fora description).
Supported data
The following MARC data types are supported:
Name of MARCBIFData Entry (supported/unsupported)
Name of MEDINAData Element
Remarks
CONNECTIVITY (TYP 7) TETRA4, PENTA6,HEXA8, PYRAM5
CONNECTIVITY (TYP11,75)
TRIA3, QUAD4,TRIA3V, QUAD4V
CONNECTIVITY (TYP 9,98) BAR, ROD
CONNECTIVITY (TYP 12) GAP
193
Solver Interfaces
Name of MARCBIFData Entry (supported/unsupported)
Name of MEDINAData Element
Remarks
CONNECTIVITY (TYP 127) TETRA10
COORDINATE MPCO KO1, KO2 and SuppressedDOFs are not supported.
DEFINE NODE
DEFINE ELEMENT
DEFINE NDSQ
SET
SPRINGS FEDAL
FIXED DISP SPC
GEOMETRY TRIA3V, QUAD4V
TRANSFORMATION TRAFO
TYING
Typing code
<= 6 # >=100
MPC
The input of best items will be supported excluding INTERSECT.
Calling MARCBIF without MEDINA Monitor
Call:
<inst_directory>/cae/bin/marcbif dat=name bif=name
[size=number] [dir=name] [log=name] [warning=number] [batch]
[bit={32|64}]
If optional parameters are omitted, the first value of the numeration is the default value.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. marcbif).
194
Solver Interfaces
4.6. MSC-NASTRAN -> Interface MSCNASTRANBIFNAS/NASBIF converts data from MEDINA (BIF) into MSC/NASTRAN BULK dataand vice-versa according to MSC/NASTRAN Quick Reference Guide.
NASBOF converts results from MSC/NASTRAN (OUTPUT2) into MEDINA format(BOF).
4.6.1. BIFNAS -> Interface BIF to NASTRAN
BIF -> NASTRAN input
Figure 4.4. BIFNAS Interface
Files
BIF input file: binary input file from MEDINA pre-processor
Output file: formatted output file used as MSC/NASTRAN input deck
195
Solver Interfaces
ASCII input file: formatted input (reject) file for additional NASTRAN cards not(completely) supported by MEDINA. Used only if option 6 are selected (for a descriptionof options available, see below).
Protocol file: formatted output file with a short summary of NASTRAN entriesprocessed and error messages. The default file name is bifnas.log. To select anothername, use the last line in the BIFNAS panel: Where is says "additional programparameters", enter log=new file name where file name is the desired name of theprotocol file.
Option parameters:
• Switch for part output
• Switch for discretized connectors
• Switch for bulk data file
a) create bulk data only, all NASTRAN entries generated due to BIF-file. As the bulkdata entries on the solvercard are placed directly after the BEGIN BULK statement,no data will be written.
b) file as described in a) with the addition of entries like BEGIN BULK / ENDDATA
• Format of resulting FIF-file Small: all NASTRAN entries generated are printed inNASTRAN small field format
• Switch for generation of continuation entries (field one and ten in a NASTRAN line)
• Switch for generation of grid points for bar/beam orientation (instead of orientationvector)
• Switch for generation of CTRIAX6 elements from MEDINA TRIA6R element
• Switch for NASTRAN elements generated from MEDINA QUAD4, TRIA3 elements:a) CQUAD4 and CTRIA3 elements are generated b) CQUADR and CTRIARelements are generated
• Check the Set displacement coordinate system ID to -1 at fluid grids box toset the displacement coordinate system ID to -1 at solid properties that have thePFLUID or FFLUID fluid element flag.
• Switch for processing additional NASTRAN cards not supported by MEDINA
196
Solver Interfaces
a) ignore: generation of NASTRAN entries without additional NASTRAN statements
b) read from BIF file: additional NASTRAN statements are read from a BIF file
c) read from ASCII input file: additional NASTRAN statements are read from anASCII reject file (inactive in case of “bulk data only”)
• Switch for processing additional NASTRAN statements The complete executivecontrol section, file management section, and case control section are written backinto the input deck. For processing the bulk data deck, two options are possible:
a) add only cards completely not supplied: at the end of the bulk data deck, allNASTRAN entries not supported by MEDINA are printed. The partially supportedNASTRAN bulk data entries will not be read from solvercard.
b) merge cards supplying unsupported fields: bulk data entries with fields that arenot supported by MEDINA will be processed completely (see table below). In thiscase, only the unsupported fields will be read from solvercard and other fields will beread from bif. Additionally, the completely not supported cards will be written afterthe NASTRAN keyword BEGIN BULK.
• Switch for ignoring midnodes (edge nodes) of QUAD8 elements connected to linear2D-elements. These nodes were set to "0" in the NASTRAN input deck and thecorresponding grid entries are deleted
• Switch for “Write FEMSITE includes” to generate the FEMSITE include files<filename>.bar and <filename>.gri_set, if the toggle “Discretize connectors” isactivated and the FEMSITE idealization is available In the ECNGenerat commandthe directory for the FEMSITE include files has to be defined and will be written to Bif(use the parameters “Directory for FEMSITE output files” and “Name of femsite files”in the “Create FEMSITE Spotweld Idealization window). Additionally the include file<file_name>.mpc is written from ECNGenerat to the defined directory (contains onlythe MPCs for spotweld idealization) The remaining idealized elements (Bar andHexa with properties and materials) are generated and will be written to the Bif
• Save the model to Bif and enter the NASTRAN interface BIFNAS in the MEDINAstart monitor
• Switch for ignoring properties
• Switch for ignoring property exception list. This toggle is active if the ignoreproperties is on. A list of properties can be chosen
197
Solver Interfaces
• Material select box Write as defined: All materials will be written as defined. Ignoreall materials: The material cards will not be written. Ignore MID4 in PSHELL: If MID4is not defined, MID4 will not be written into PSHELL card Check MID3 and MID4in PSHELL:
The following checks will be executed for each shell property:
a) If MID1 > 0 and MID2 > 0 and MID4 > 0, warning will be written and MID4 willbe ignored.
b) If CQUADR or CTRIAR elements are used by a shell property, warning will bewritten and MID4 will be ignored.
c) If MID2 <= 0 and MID3>0, warning will be written and MID3 will be ignored.
• Activate the toggle “Write FEMSITE includes” to generate the include files<file_name>.bar and <file_name>.gri_set The include file <file_name>.bar containsthe idealized spotweld elements (Bar and Hexa with properties and materials)and the <file_name>.gri_set contains a node set, which is generated during theidealization process
• Switch for writing ABAQUS node temperature definitions as NASTRAN TEMP cardsAn ABAQUS *TEMPERATURE card defined for shell elements and temperature attemperature nodes will be converted by considering the first temperature nodeonly.
Spotweld idealization for FEMSITE
Enter the ECNGenerat command in MEDINA PreProcessor and define the directoryand file name for the FEMSITE include files.
After running ECNGenerat in MEDINA, the FEMSITE include files below are writtento the defined directory:
<file_name>.swm_v2 (FEMSITE spotweld matrix file)
<file_name>.mpc (contains only the MPCs for the
spotweld idealization)
<file_name>.log (FEMSITE log file)
If <file_name> is blank, the files are named swm_v2, mpc and log. The remainingidealized elements (Bar and Hexa) are added to the model.
Solver
198
Solver Interfaces
This parameter allows you to choose between NX-NASTRAN and MSC-NASTRAN.NX-NASTRAN is used by default.
Note
BIFNAS exports NX-NASTRAN specific cards (e.g. contact and surface cards)only if NX-NASTRAN is defined in the Solver parameter.
Additional program parameters
The additional program parameters are referenced in the additional parameter field inthis way:
"opt=-parameter <name/number>"
-clayer name Select name as the coordinate file for
layers
The layer file is referenced in
the Additional
program parameters field with the
option:
"opt=-clayer <directory-name>/
<filename>"
If value contains spaces (eg. my
file), type:
{opt=-clayer "<directory-name>/my
file"}
Example 1:
To assign file name myfile to
parameter clayer, type:
"opt=-clayer myfile"
Example 2:
To assign file name my file to
paramater clayer, type:
{opt=-parameter "my file"}
199
Solver Interfaces
-holdeletype TRIAxV/QUADxV elements are generated and
the following
are defined:
- Material property orientation angle
in degrees/material
coordinate system identification
number
- Offset from the surface
- Membran tickness
-include Only bulk data deck generated (sets
are commented out)
-no_conn_err_msg Implementation of the switch
“no_conn_err_msg” to control if
an error message or only a comment
will be written out. If the
Additional program parameter
“no_conn_err_msg” is supplied
for BIFNAS, than instead of the error
message
"-E- CONNSPOT 8001922 is not
connected", only a comment line
"$ -E- CONNSPOT 8001922 is not
connected" will be written into
the Nastran file
-vers Show the version and stop the
interface
Calling BIFNAS without MEDINA Monitor
Call:
<inst_directory>/cae/bin/bifnas bif=name dat=name [full={1|2|
3}] [large][bulkonly] [contid] [relem] [gporient] [ctriax6]
[nomidnodes][ignoreProperties] [propertyExceptionList=list]
[ignoreMaterials={0-3}][fatxml] [discrconn] [FEMSITEincludes]
[ABAQUSnodetemps] [fluid][size=number][dir=name] [log=name]
[warning=number] [batch][bit={32|64}] [solver={0|1}]
200
Solver Interfaces
solver=0 calls for NX-NASTRAN, solver=1 - MSC-NASTRAN.
If optional parameters are omitted, the first value of the numeration is the default value.
Note
For the description of all options and arguments above, go into the installationdirectory for load modules and enter the desired interface (e.g. bifnas).
Unsupported cards are read automatically from solvercard.
Miscellaneous
A NASTRAN Comment line marks the set as MEDINA element or node set ($NSET /$ESET).
If include files are present, the sets are commented out and a warning is printed inthe protocol file.
Superelement sets are supported using the GRID entries.
Element labels are supported for CONM2, CELAS1, CELAS2, CDAMP1 andCDAMP2 elements (description of element labels see section NASBIF).
If "generation of grid points for bar/beam orientation" is selected, the new grid pointsgenerated are reported in the protocol file.
Supported data
PLOTEL3 and PLOTEL4 elements are supported only by NX-Nastran.
When the solver is set to NX-NASTRAN in the BIFNAS monitor or Export toNASTRAN panel, PLOTEL3 and PLOTEL4 are written to the Nastran input file.
When the solver is set to MSC-NASTRAN, a corresponding warning message isdisplayed.
Table of MSC/NX-NASTRAN entries supported by MEDINA and BIFNAS
Example:
$part begin root,n_pid=1,n_type=4
CQUAD4 1 1 1 2 3 4
201
Solver Interfaces
PSHELL 1
$part end
Parts
MEDINA parts are translated into a XML-attachment and written to NASTRANinterface as comments.
Elements and properties are written after the corresponding part comment.
BIFNAS writes the XML attachment in this way:
$Begin part description
$<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
$<!DOCTYPE Part SYSTEM "part_tree.dtd">
$<Part label="root" ........
.........
$</Part>
$<!-- end of /root --><!-- .....
....
$End part description
Initial conditions
BIFNAS reads initial conditions (shell thicknesses and strains) from several MEDINABOF files and writes them to the NASTRAN input file.
A layer file controls the reading of data from BOF file and the writing of the necessaryNASTRAN statements.
SYNTAX:
*BOF :
Defines the name of the MEDINA BOF file for initial conditions. Required parameter:
FILE=<name>
*SCALE:
202
Solver Interfaces
Defines the scale factor. Required parameter:
TYPE=<type>
Where type= THICKNESS (scale factor for shell thickness)
Optional parameter:
PID=<number>
Property-ID for which the scale factor is valid, if not defined the scale factor is appliedto all PIDs.
First line : Scale factor
Example:
*BOFFILE, FILE=/mapping1.bof
*BOFFILE, FILE=/mapping2.bof
*SCALE,TYPE=THICKNESS,PID=26
0.1
The layer file is referenced in the Additional program parameters field in the interfacestart window with the option:
"opt=-clayer <directory-name>/<filename>"
If the file name contains blanks (e.g. my file), the correct input is:
{opt=-clayer "<directory-name>/my file”}
Shell elements are written to the NASTRAN input file as shells with variablethicknesses.
MEDINA data elements
Key 204 Physical meaning THICKNESS
VMA Entries are translated to NSM cards
4.6.2. NASBIF -> Interface NASTRAN to BIF
NASTRAN input -> BIF
203
Solver Interfaces
Figure 4.5. NASBIF Interface
Files
Input file: formatted input file used as MSC/NASTRAN input deck
BIF output file: binary output file for MEDINA pre-processor
ASCII reject file: formatted output (reject) file for additional NASTRAN cards not(completely) supported by MEDINA. Used only if option 3 are selected. (For adescription of options available, see below.)
Protocol file: formatted output file with a short summary of NASTRAN entriesprocessed and error messages. The default file name is nasbif.log. To select anothername, use the last line in the NASBIF panel: Where is says "additional programparameters", enter log=new file name where file name is the desired name of theprotocol file.
Options
Input deck with includes: Files which refer to other files using UNIX or NASTRANinclude command are automatically included.
204
Solver Interfaces
Search for include files
NASBIF searches for include files in the following manner:
• If an absolute path is provided exactly this path will be used.
• If a relative path is provided NASBIF will first search the directory in which the maindeck is situated in and after that in the working directory.
Ignore zero thickness of shell elements:
• Toggle is ON:Shell element that has zero value for ZOFFS, THETA, MCID andthickness on all nodes will not be written as MEDINA V-element to bif.
• Toggle is OFF: Shell element that has zero value for ZOFFS, THETA, MCID orthickness at least on one node will be written as MEDINA V-element to bif.
Switch additional NASTRAN cards not supported by MEDINA
Ignore: generation of NASTRAN entries without additional NASTRAN statements
Write to BIF file: additional NASTRAN statements are stored in a BIF file
Write to ASCII reject file: additional NASTRAN statements are stored in an ASCIIreject file
Switch processing of additional NASTRAN statements
The complete executive control section, file management section, and case controlsection are written to a BIF or an ASCII file.
For processing the bulk data deck, two options are possible
• Only cards completely not supported: all NASTRAN entries not supported byMEDINA are written to a BIF or an ASCII file.
• All cards with fields not supported: bulk data entries which contain fields that are notsupported by MEDINA (see table below) are written to a BIF or an ASCII file.
Additional program parameters
The additional program parameters are referenced in the additional parameter field:
resolve=name NASTRAN includes are resolved into new
file named
filename (complete NASTRAN deck).
205
Solver Interfaces
The following additional program parameters are referenced in the additionalparameter field in this way:
"opt=-parameter <name/number>"
-holdeletype TRIAxV/QUADxV elements are generated and
the following
are defined:
- Material property orientation angle
in degrees/material
coordinate system identification
number
- Offset from the surface
- Membran tickness
-size number Start memory size for data structures
(usually, it is automatically
determined).
-warning number Complete warning message report
-vers Show the version and stop the
interface
Calling BIFNAS without MEDINA Monitor
Call:
<inst_directory>/cae/bin/nasbif dat=name bif=name [full={1|2|
3}] [include] [resolve=name] [size=number] [dir=name] [log=name]
[warning=number] [batch] [holdeletype] [bit={32|64}]
If optional parameters are omitted, the first value of the numeration is the default value.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. bifnas).
Unsupported cards are written automatically to solvercard.
Miscellaneous
206
Solver Interfaces
All NASTRAN entries may be in uppercase or lowercase, with tabulators allowed. AllNASTRAN entries must begin in the first column.
MSC/NASTRAN small, free, and large format are supported: Replication syntax is notallowed.
In case of large format, at least one continuation card must follow (i.e. PDAMP* needsone empty continuation card following: "*....."). In case of large format, the syntax for,i.e. the GRID entry, must be: "GRID*", "GRID *" is not allowed.
Continuation lines must immediately follow the line that they continue.
No comment lines in the middle of a NASTRAN entry are allowed.
Blanks are allowed for continuation keywords.
Comments are not allowed at the end of a NASTRAN statement.
Sets are supported. If the set is marked with the comment $NSET or $ESET, NASBIFcreates the corresponded set for MEDINA.
If the sets are referred to the case control section (i.e. DISPL=5), NASBIF creates thecorresponding set for MEDINA (node or element set).
If this reference is missing, NASBIF creates a node set with the set ID used in the inputdeck and additionally an element set with a new set ID (this action is documented inthe protocol file).
Comments at the end of set entries are allowed.
Sets which are defined in the MSC/NASTRAN plot section must have an unique set ID.
Elements with unknown grids are not converted to the BIF file.
Element labels are supported for CONM2, CELAS1, CELAS2, CDAMP1 and CDAMP2elements. Element labels are defined as the text of the preceding comment line.
Coordinate systems, which are referred to, must be defined in the current inputfile. Otherwise, the corresponding entry fields (i.e. CD field on GRID entry) are ignored.
While processing CQUAD8 elements, if edge grid points with identification numbers of"0" or "blank" are found, new edge grid points are automatically generated using linearinterpolation. These new grid points were additionally sampled in an new node set.
Supported data
207
Solver Interfaces
Table of MSC/NX-NASTRAN entries supported by MEDINA and NASBIF:
Name ofNASTRAN BULKDATA Entry
Field Nameoption 3b)supports thesefields
Name of MEDINA DataElement
Remarks
ASET SET
BAROR not supported
BCPROP
(NX-NASTRAN)
SURF
BCPROPS
(NX-NASTRAN)
SURF
BCTSET
(NX-NASTRAN)
NASCONT
BEAMOR not supported
BEDGE
(NX-NASTRAN)
SURF
BGADD
(NX-NASTRAN)
NASADD
BGSET
(NX-NASTRAN)
NASCONT
BLSEG
(NX-NASTRAN)
SURF
BSURF
(NX-NASTRAN)
SURF
BSURFS
(NX-NASTRAN)
SURF Supportedelements:
HEXA8, HEXA20
PENTA6
208
Solver Interfaces
Name ofNASTRAN BULKDATA Entry
Field Nameoption 3b)supports thesefields
Name of MEDINA DataElement
Remarks
PENTA15
TETRA4
TETRA10
CAABSF GENSOLE
CBAR INFE2
CBEAM SA,SB,BIT INFE2
CBUSH CBUSH
CDAMP1 FEDAL1
CDAMP2 FEDAL
CELAS1 FEDAL1
CELAS2 FEDAL
CFAST SPOTWELD
CGAP INFE2G
CHBDYE IVIEWF/B,RADMIDF/B
not supported
CHEXA INFE8S/INFE20S
CMASS1 ELSCALAR
CMASS2 ELSCALAR
CONM1 CONM1
CONM2 KMASSE
CONROD A, J INFE2 C, NSM notsupported, seeCROD
CONV BOUNDARY not supported
COORD1C CORSYS
COORD2C CORSYS
COORD1R CORSYS
209
Solver Interfaces
Name ofNASTRAN BULKDATA Entry
Field Nameoption 3b)supports thesefields
Name of MEDINA DataElement
Remarks
COORD2R CORSYS
COORD1S CORSYS
COORD2S CORSYS
CPENTA INFE6S/INFE15S
CQUAD4 INFE4V
CQUADR INFE4/INFE4V
CQUADX INFE4/INFE8
CQUAD8 INFE8V
CROD INFE2
CSHEAR INFE4 converted toCQUAD4
CTETRA INFE4S/INFE10S
CTRIA3 INFE3/INFE3V
CTRIAR INFE3/INFE3V
CTRIAX INFE3/INFE6
CTRIAX6 INFE6
CTRIA6 INFE6/INFE6V
CVISC INFE2
CWELD SPOTWELD
CWSEAM CONNECTO Supported isLTYPE = GRIDID*
DAREA DAREA
DELAY DELAY
DPHASE DPHASE
DLOAD DLOAD
FORCE PVNPCO
FORCE1 PVNPCO
210
Solver Interfaces
Name ofNASTRAN BULKDATA Entry
Field Nameoption 3b)supports thesefields
Name of MEDINA DataElement
Remarks
GDRSET not supported
GRID NPCO
MAT1 2nd line MATERIAL
MAT4 MATERIAL
MAT8 MATERIAL
MAT9 MATERIAL
MAT10 MATERIAL
MAT11 MATERIAL Orthotropic solidmaterial,supported only byNX-NASTRAN
MOMENT PVNPCO
MOMENT1 PVNPCO
MPC MPC
PAABSF PROPERTY
PBAR 2nd line PROPERTY
PBARL BOX1, CROSS,HAT, HEXA
PROPERTY
PBEAM 2nd, 4th + 6th line PROPERTY
PBEAML BOX1, CROSS,HAT, HEXA
PROPERTY
PBUSH PROPERTY
PBUSHT PROPERTY
PCOMP PROPERTY
PCOMPG PROPERTY
PCONV PROPERTY/PSSET not supported
PDAMP PROPERTY
PELAS PROPERTY
211
Solver Interfaces
Name ofNASTRAN BULKDATA Entry
Field Nameoption 3b)supports thesefields
Name of MEDINA DataElement
Remarks
PFAST PROPERTY MCID = -1 issupported
PGAP PROPERTY
PLOAD not supported
PLOAD1 not supported
PLOAD2 PLOAD
PLOAD4 P2/3/4, 2nd line PLOAD No alternateformat allowedwhen using option3
PLOTEL
PLOTEL3
(NX-NASTRAN)
GENSOLE
PLOTEL4
(NX-NASTRAN)
GENSOLE
PMASS PROPERTY
PROD PROPERTY
PSHEAR
PSHELL PROPERTY
PSOLID IN,STRESS,ISOP,FCTN,COROT
PROPERTY COROT issupported only byMSC Nastran
PVISC PROPERTY
PWSEAM PROPCONN
QVECT TIDi, CNTRLND PSSET
RBAR RINFE2
RBE2 RBE2
212
Solver Interfaces
Name ofNASTRAN BULKDATA Entry
Field Nameoption 3b)supports thesefields
Name of MEDINA DataElement
Remarks
RBE3 ELRBE Completelysupported
RLOAD1 RLOAD
RLOAD2 RLOAD
RROD RINFE2
RSPLINE RSPLINE
RTRPLT RBE2
SESET GRID
SET1 Option SKIN Nodeset
Elementset
Solvercard
Solverkey SET1,Set type = Node
Solverkey SET1,Set type =Element
SET3 Option GRID
Option ELEM
Option PROP
Option POINT
Nodeset
Elementset
Propertyset
Solvercard
Solverkey SET3,Set type = Node
Solverkey SET3,Set Type =Element
Solverkey SET3,Set Type =Property
SPC SUPDOF
SPC BOUNDARY elementtemperatures
SPC1 SUPDOF
SPCD PREDOF
SPOINT NPCO
213
Solver Interfaces
Name ofNASTRAN BULKDATA Entry
Field Nameoption 3b)supports thesefields
Name of MEDINA DataElement
Remarks
SPOINT BOUNDARY scalar point forelementtemperatures notsupported
TABLED1 LOADCURVES
TABLED2 "SKIP" LOADCURVES
TABLED3 LOADCURVES
TEMP PSNPCO
TLOAD1 RLOAD
TLOAD2 RLOAD
Note
CWSEAM cards with LTYPE = "POINTID" or "XYZ" are written on the solvercard(use parameter –full number). Only two nodes of every card are translated.
Cards with more than 2 nodes are written in the solvercard when using –fullnumber.
PCID is not supported. CWSEAM cards are always placed in the global system.
CWSEAM cards reference PWSEAM cards.
Depending on the PWSEAM thickness, CWSEAM cards result in Weldline orBondline elements:
• PWSEAM-Thickness == Blank result in Weldline elements
• PWSEAM-Thickness ! = Blank result in Bondline elements
NASBIF can read the XML-attachments.
If Parts information are translated, NASBIF does not write the NSM cards to the solvercard.
SET1:
214
Solver Interfaces
SET1 with SKIN option is put to solvercard and a warning is created by Nasbif:
"SET1 <id> with option SKIN is stored onto solvercard"
For SET1, an additional coded comment line will be written by Bifnas to support theset type and label. If a coded comment line is not defined, NASBIF tries to create twosets, a node set and an element set, from the defined IDs in each SET1 card.
• For Node example, type:
$MEDINA_Key NSET Label="label of the node set"
SET1 ...
SET3:
For SET3, an additional coded comment line will be written by Bifnas to support theset label:
$MEDINA_Key Label="label of the set"
SET3 ...
4.6.3. NASBOF -> Interface NASTRAN to BOF
Files
Input file: MSC/NASTRAN binary output2 file
BOF output file: Binary BOF file for MEDINA postprocessor
BIF output file: Binary BIF file for MEDINA. If BIF file name is blank no BIF file willgenerated.
Protocol file: formatted output file with a short summary of the MEDINA data elementsprocessed and error messages. The default file name is nasbof.log.
To select another name, use the last line in the NASBOF panel: Where it says"Additional program parameters", enter log=file name where file name is the desiredname of the protocol file.
Options
Combine loadcases at same frequency: with this toggle deactivated the NASBOFinterface reads the text of TITLE, SUBTITLE and LABEL (if these objects are defined)and writes it to a BOF file.
215
Solver Interfaces
Write deformations in global coordinates.
Reduce geometry and results to surface. The volume model will be reduced to thesurface model.
Only the surface elements and the surface nodes will be written on the Bif file. Theresults (Displacements and stresses) of the elements and nodes of the surface will bewritten on the Bof file.
It is also possible to eliminate the midnodes and the results at the midnodes.
Retrieve geometry from bif file: NASBOF reads the geometry data from an extra bifFile. NASTRAN results with no geometry on the op2 file can be processed.
Additional program parameters
The additional program parameters are referenced in the additional parameter field inthis way:
"opt=-parameter <name/number>"
-statistics Replace results by calculated min,
max, absmax and rms values
-no_conn_err_msg Implementation of the switch
“no_conn_err_msg” to control if
an error message or only a comment
will be written out. If the
Additional program parameter
“no_conn_err_msg” is supplied
for BIFNAS, than instead of the error
message
"-E- CONNSPOT 8001922 is not
connected", only a comment line
"$ -E- CONNSPOT 8001922 is not
connected" will be written into
the Nastran file
-warning number Complete warning message report
-vers Show the version and stop the
interface
Miscellaneous
216
Solver Interfaces
To include node and element data in op2 file since NASTRAN v2012, please useparameter “IFPSTAR=NO”.
To get MSC.NASTRAN results in the required output2 file, please include“PARAM,POST,-1” in your input deck
The results data blocks are described in “MSC/NASTRAN, Version 70.7, QuickReference Guide page 1236”.
The old method with including special files (dmap alters) is no longer necessary.
Supported data
Table of MSC/NASTRAN results supported by MEDINA and NASBOF:
Name ofNASTRAN DataBlock
Name ofMEDINA DataElement
Description
HOEF1 VKINFE Flux vector for elements in basic system(material coordinate system)
OEF1 FINFE2 Element Forces for BAR, ROD, BEAM, ELAS
OEF1 FINFE2K Complex Element Forces for BAR,ROD, BEAM, ELAS and VISC, MSC/NASTRAN CASE CONTROL entry supported:ELFORC(PHASE)=...
OEKE1 SKINFE Element Kinetic Energy
OEKE1 SKINFE Element Kinetic Energy Density
OEKE1 SKINFE Element Kinetic Energy Percent Of Total
OEDE1 SKINFE Element Damping Energy (Energy Loss)
OEDE1 SKINFE Element Damping Energy Density (EnergyLoss)
OEDE1 SKINFE Element Damping Energy Percent Of Total(Energy Loss)
OES1 SINFE Real Element Stresses (in Node Points)
OES1 SINFEK Complex Element Stresses (in Node Points)
OES1C SINFE Real Element Stresses for Composites
217
Solver Interfaces
Name ofNASTRAN DataBlock
Name ofMEDINA DataElement
Description
OES1X SINFE Real Element Stresses with intermediatestation stresses (CBAR/CBEAM) and stresseson nonlinear elements
OESCP SINFE Laminar Stresses
OESCP1 SINFE Real Element Stresses (in Node Points) forcomposite
OESTRCP DINFE Laminar Strains
OESNLXR SINFE-NL Non-linear Element Stresses for ROD, BEAM,QUAD4, TRIA3
OESNLXR SINFE-NL Non-linear Element Stresses for HEXA,PENTA, QUAD4, TRIA3
OESNLXR DINFE-NL Non-linear Element Strains (in Node Points) forHEXA, PENTA, QUAD4, TRIA3
OESNLXR SINFEK Complex Non-linear Element Stresses forROD, BEAM, QUAD4, TRIA3
OESNLXR SINFEK Complex Non-linear Element Strains for ROD,BEAM, QUAD4, TRIA3
OESNLXR SKINFE GAP Force/OPENING, COMP-X, AXIAL-U
OESVM SINFEK Complex Stresses
ONRGY1 SKINFE Element Strain Energy
ONRGY1 SKINFE Element Strain Energy Density
ONRGY1 SKINFE Element Strain Energy Percent Of Total
ONRGY2 SKINFE Element Kinetic Energy
ONRGY2 SKINFE Element Kinetic Energy Density
ONRGY2 SKINFE Element Kinetic Energy Percent Of Total
ONRGY3-6 SKINFEKO Complex Strain Energy *
ONRGY3-6 SKINFEKO Complex Strain Energy Density *
OPG1 UBBR Applied Static Loads
OPG1 UBBRK Applied Static Loads (complex)
OQG1,OGPFB1 UBBR Reaction Forces in Node Points (SPC-Forces)
218
Solver Interfaces
Name ofNASTRAN DataBlock
Name ofMEDINA DataElement
Description
OQMG1 UBRR MPC Forces
OSTR1 DINFE Real Element Strains (in Node Points)for HEXA, PENTA, TETRA, QUAD8, ROD,TRAPRG, SHEAR, TRIARG, QUAD4, QUAD8,TRIA3, TRIA6, SHEAR, TRIARG
OSTRVM DINFEK Complex Strains
OUGV1 DEFO Real Node Point Displacements, Eigenvectors,Velocities, Accelerations
OUGV1 DEFOK Complex Node Point Displacements,Eigenvectors, Velocities, Accelerations
SET Set of superelements
TOUGV TEMP Temperatures in Node Points
OVG1 DEFO Real velocities at nodes
OVG1 DEFOK Complex velocities at nodes
OMM DEFO Find min. and max. value of each requestedresult type for each element over all time stepsfor grid point output.
Displacement, Acceleration, Velocity
OMM SINFE Find min. and max. value of each requestedresult type for each element over all time stepsfor element output.
OGF GPFORCE Element node forces and moments (grid pointforces). This datablock is not supported byMEDINA post
* these datablocks (ONGRY3–6) could be generated only with a special dmap alter
Calling NASBOF without MEDINA Monitor
Call:
219
Solver Interfaces
<inst_directory>/cae/bin/nasbof result=name bof=name [bif=name]
[geobif=name] [merge1] [global] [rotdof] [reduvolum={0|1|2}]
[dir=name] [log=name] [warning=number] [batch] [bit={32|64}]
Explanations:
• merge1: merging duplicate nodes
• rotdof: dof rotation output additionally on tensor results
If optional parameters are omitted, the first value of the numeration is the default value.
Note
For description of all options and arguments above go into the installationdirectory for load modules and enter the desired interface (e.g. nasbof).
4.7. PAMCRASH -> Interface to PAMCRASHThe MEDINA PAMCRASH interface is a software tool for converting PAMCRASH inputdeck data into MEDINA binary file (BIF) format and vice versa. Those two tools arecalled PamBif and BifPam. Besides that, PAMCRASH solver results can be mappedto MEDINA binary output files (BOFs), by means of the PamBof interface.
Introduction
Before an input deck is passed to the solver, some corrections and modifications mightbe necessary, the so called preprocessing. MEDINA as a finite element preprocessorhas its own file format called BIF. In order to import and export solver input decks to andfrom MEDINA, interfaces are used. Since MEDINA interfaces exist for several solvers,these interfaces can also be used for conversion between solver formats.
The MEDINA PAMCRASH interface offers a full support for those PAMCRASH cardswhich can be fully mapped to MEDINA objects. Those PAMCRASH cards which haveno MEDINA pendants are stored in the BIF file as a so-called solvercard. By meansof the solvercard no objects are lost, though the solvercard is opaque to MEDINA.Additionally, the support of material databases and control files by the PAMCRASHinterface facilitates the integration into the CAE workflow.
There are three ways to start the interface:
• Within MedPre using the Import and Export command
220
Solver Interfaces
• Using the MEDINA Monitor
• As a shell command, e.g. pambif, bifpam or pambof, depending on the MEDINAversion.
PAMCRASH cards or parameters which have no correspondence in MEDINA cannotbe supported by the interface. Workarounds exist however, in order to prevent dataloss.
PamBof uses the ESI DSY library, which requires a Pamcrash license and is justavailable for certain platforms. The PamBof interface will be just briefly mentioned here.
4.7.1. PAMCRASH - Material Databases
The use of material databases is optional in the context of the MEDINA PAMCRASHinterface. Material databases are directories with text files. Each file holds exactly onematerial in solver format, together with the function cards (load curves) referenced bythis material. It is assumed that no function is referenced by more than one material.
Two types of material databases are supported:
• Databases where each material file is named “default” and placed in its ownsubdirectory with a name characteristic for this material.
• Databases where the file name itself is characteristic for the material. The files maybe placed in the same directory or in an arbitrary directory tree below.
For MedPre and the MEDINA Monitor, the database type can be configured bysetting the environment variable matdbtypepam to either the value subdir_with_default_files or dir_with_mat_files. The last is assumed when no value isprovided.
The MEDINA PAMCRASH interface can handle up to three databases. These arecalled user, team and global database. The team and global database are read only,they will never be modified by the interface. For MedPre and the MEDINA Monitor, theteam and global databases are specified by the environment variables “tmatpathpam”and “gmat-pathpam”.
In MedPre, the user database is specified by means of the MatDBParam command.In the MEDINA Monitor, a user database panel field is found.
221
Solver Interfaces
Figure 4.6. The panel of the MatDBParam command
PamBif can create a new user material database containing all materials in the givenPAMCRASH input deck. Alternatively, PamBif can merge given material databaseswith the materials of the solver deck, so that just the material files missing in all threedatabases are created in the existing user database.
PamBif identifies the materials by their unique ID number. For MedPre andthe MEDINA Monitor, the search order can be specified by the environmentvariable matdbpriopam. The default value is global_db_first. Alternatively,user_db_first may be specified. The team database is always the second.
The values corresponding to the environment variables above are then passed tothe interface call as command line parameters. The interface itself does not read theenvironment variables.
For each material in the solver input deck, PamBif also creates an isotropic materialwith the corresponding ID. The label of this MEDINA material will be the file or directoryname specific to the material preceded by an “>” sign, rather than the actual materialname. Accordingly, BifPam considers material names starting with “>” to be databasereferences. A corresponding material file is searched in the database conform to thesearch priority and the contents of this file is copied to the PAMCRASH input deckgoing to be written. This way, single materials or whole material databases can beeasily replaced when they become obsolete.
When PamBif is configured to create no databases, all MATER cards of thePAMCRASH input deck will be found on the solvercard of the appropriate MEDINApart. This way, they will be exported in their original format into the appropriate includefile. FUNC cards referenced by materials on the solvercard will be mapped to MEDINAload curves in this case, no matter whether they are referenced by a material.
4.7.2. PAMCRASH - Control file
The optional control file is a text file which holds information about the PAMCRASHPART cards, i.e. the MEDINA properties. This facilitates the overview and the handling
222
Solver Interfaces
of those data, including the material references. The control file is written by PamBifwhen a file name is specified.
During the BifPam run, the control file data, when provided, have priority over the BIFdata. Control files can also be written and read during the MedPre session by meansof the ControlFil command.
4.7.3. PAMCRASH - Configuration file
The configuration file is an optional, plain text file provided to PamBif only. The usercan place in it PAMCRASH keywords, one keyword per line. The correspondingPAMCRASH cards will then be unconditionally put onto the solvercard. This way, theuser can make sure that those cards will not be modified and that they will stay in theright include file.
4.7.4. PAMCRASH - INCLUDE files
A PAMCRASH input deck may consist of several files referenced in a tree hierarchyby means of the “INCLU” keyword. In order to keep the file hierarchy, PamBif createsa MEDINA part for each included file and places the include file contents into thatMEDINA part. Nodes of elements referenced by two MEDINA parts will be found in thelowest common parent part.
MEDINA objects that support no part membership for the time being will be found in theroot part. For those objects, the include file membership cannot be preserved, unlessthey are put onto the solvercard by means of the configuration file.
BifPam either writes the whole model into a single PAMCRASH file or alternativelyinto a hierarchy of include files corresponding to the MEDINA part hierarchy. It isalso possible to import and export single include files while choosing the appropriateMEDINA part.
4.7.5. PAMCRASH - INCLUDE Transform
The information of the PAMCRASH TRSFM cards becomes the transformation matrixof the MEDINA part’s external reference. This implies that the PAMCRASH TRSFMcard references the contents of exactly one include file. Otherwise, the PAMCRASHTRSFM card cannot be mapped to MEDINA and will be put onto the solvercard.
In PamBif, the transformation will also be applied to the coordinates of the referrednodes, in order to visualize their actual position. Then, BifPam restores the original
223
Solver Interfaces
node coordinates by means of the MEDINA part’s transformation matrix. Nodesreferred by the unsupported TRSFM cards found on the solvercard will be at theiruntransformed position in MedPre.
4.7.6. PAMCRASH - Starting the Interface
Starting the PamBif / BifPam interface requires at least a PAMCRASH input deck filename as well as a MEDINA BIF name to be provided. When starting the interfacesfrom MedPre, a temporary BIF will be created automatically.
Further interface parameters are optional. For a full list of interface parameters, typee.g. pambif or bifpam at the system shell prompt. Most of these parameters havetheir corresponding fields in the MedPre Import / Export panels, as well as in theMEDINA Monitor panels. The other optional interface parameters may be provided inthe “Additional program parameters” panel field.
4.7.6.1. Interface with MedPre
Within the MedPre session, start the Import or Export command. Make sure thatPAMCRASH is selected in the solver list of the Import / Export panel. In this panelselect also the “Complete” toggle, unless you want to handle single include files asdescribed in chapter “Work with include files”. When this is done, a panel named“Import from PAM-CRASH” respectively “Export to PAMCRASH” appears. Enter atleast the PAMCRASH file name to be read or written. Tooltips give additional help whenthe mouse is moved above the panel fields. For material database settings, pleasealso refer to the Material Databases section.
Figure 4.7. The MedPre Import command panels for PamBif start
224
Solver Interfaces
Figure 4.8. The MedPre Export command panels for PamBif start
4.7.6.2. Interface with MEDINA Monitor
Within the “FEA Interfaces” Monitor area, press the PAMCRASH button. Then choosebetween “PAMCRASH input -> BIF” for PamBif and “BIF -> PAMCRASH input” forBifPam. If available on your platform, you will also see a “PAMCRASH output -> B*F”item for staring the PamBof interface. A panel will show up, which is similar to thoseseen in MedPre. Additionally, a working directory can be given, which will be the currentdirectory for the interface run.
225
Solver Interfaces
Figure 4.9. BIFPAM Interface Figure 4.10. PAMBIF Interface
4.7.6.3. Interface with shell prompt
Just type e.g. pambif, bifpam or pambof as a shell command. When no command lineparameters are provided, the list of valid command line parameters is printed, like:
For PamBif, call:
<inst_directory>/cae/bin/pambif pc=name bif=name [config=name]
[control=name] [replace] [material={0|1|2}] [umatpath=name]
[tmatpath=name] [gmatpath=name] [matdbprio={global_first|
user_first}] [matdbtype={mat_files|default_files}] [dir=name]
[log=name] [warning=number] [batch] [bit={32|64}]
For BifPam, call:
<inst_directory>/cae/bin/bifpam bif=name pc=name
[control=name] [replace] [parts] [ignoreMaterials]
[umatpath=name] [tmatpath=name] [gmatpath=name] [fatxml]
226
Solver Interfaces
[matdbprio={global_first|user_first}] [matdbtype={mat_files|
default_files}] [dir=name] [log=name] [warning=number] [batch]
[bit={32|64}] [ishg=number]
To convert the PAMCRASH input deck example.pc to MEDINA BIF format, type e.g.:
pambif pc=example.pc bif=example.bif
The optional interface options have the following meaning:
Option Meaning
batch No key press is required at the end of the interface run.
bit Whether to use the 32 or the 64 bit executable, if both are available.
config Configuration file.
control Control file.
dir Directory where the interface shall be executed.
fatxml Part information to be written in the FATXML format. MEDINAsupports FATXML v1.1, v1.1plus and v1.2.
gmatpath Global material database directory.
ignoreMaterials Do not write any material cards to the PAMCRASH input deck.
ishg ISHG value to be written on the deck for material types 103 and 105.
log Log file.
matdbprio Material database to be searched first: user or global.
matdbtype The structure type of the material databases.
material 0: Do not create databases.
1: Create databases. A new user database is created.
2: Merge databases. Create just materials not available already ineither database.
parts Write include files, based on the MEDINA part information.
replace Replace existing files: control file, user database, BIF, PAMCRASHinput deck.
tmatpath Team material database directory.
umatpath User material database directory.
warning Number of similar warnings to be printed.
227
Solver Interfaces
4.7.7. PAMCRASH - PLINK cards / spotweldconnectors
PAMCRASH PLINK cards are mapped to MEDINA spotweld connectors. Themaximum distance value of the MEDINA spotweld connectors is taken from thecorresponding PLINK PART card, since the PLINK card has no such value. Therefore,when the maxi-mum distance becomes different in MEDINA for connectors of the sameproperty, new PLINK PARTS will be created by BifPam in order to hold the differentRSEAR values. A warning is issued in this case.
PLINKs with less referenced PART IDs than their NLAYR value are self-connectingspot-welds. The handling of self-connecting spotwelds is not supported in MEDINA.Nevertheless, the PAMCRASH interface imports and exports such connectors.
Note
If the deck includes PLINK elements, they are converted into connspots.However, the new connectors are not automatically reconnected afterimporting. This can be done manually using ECNConnect command.
4.7.8. PAMBIF -> Interface PAMCRASH to BIF
Keyword Support MEDINA Incl/Part
Remarks
ACC3D Full PVAD Yes None
ACFLD Full Acceleration Yes None
ACTRL Solvercard None Yes None
ACTUA Solvercard None Yes None
ADAPT Solvercard None Yes None
ADVBG Solvercard None Yes None
AIRBAGCHECK Solvercard None Yes None
AIRBG Solvercard None Yes None
ANALYSIS Solvercard None Yes None
AUTOSLEEP Solvercard None Yes None
BAGIN Solvercard None Yes None
BAR Full BAR element Yes None
228
Solver Interfaces
Keyword Support MEDINA Incl/Part
Remarks
BDFOR Solvercard None Yes None
BEAM Limited Beam element Yes If the tapered beamoption (ITPR) is not zero,then the cards are putonto the solvercard.
BEAPLOT Solvercard None Yes None
BELTS Solvercard None Yes None
BFLUX Solvercard None Yes None
BOUNC Limited SPC Yes The IFRAM value isignored. The BOUNCcard will be stored onsolvercard if ISENS isdefined.
BSHEL Solvercard None Yes None
BUCKL Solvercard None Yes None
CCTRL Solvercard None Yes None
CDATA Solvercard None Yes None
CNODE Full Node with label“CNODE”
Yes None
CNTAC Limited PAMCRASHcontact
No Types 43, 44 and 46 arenot supported and will beput onto the solvercard.
The limitations on theGeneral Entity Selectionapply, see the remarks onthe GROUP keyword.
CONLO Limited Nodal Force No If IDR is equal to 4 or 8or ISENS is not zero orITYPE is not equal to 1,then the whole card is putonto the solvercard.
229
Solver Interfaces
Keyword Support MEDINA Incl/Part
Remarks
Option CLOAD (constantload definition) is ignored.
COUPLING Solvercard None Yes None
CPCTRL Solvercard None Yes None
CPULIMIT Solvercard None Yes None
DAMP Solvercard None Yes None
DATACHECK Solvercard None Yes None
DCNTA Solvercard None Yes None
DCOMP Solvercard None Yes None
DEBUG Solvercard None Yes None
DETOP Solvercard None Yes None
DFLUX Solvercard None Yes None
DIS3D Full PVAD Yes None
DIS3DM Full PVAD Yes None
DIS3DX Full PVAD Yes None
DISLIM Solvercard None Yes None
DMPEW Solvercard None Yes None
DOMAIN Solvercard None Yes None
DPEEN Solvercard None Yes None
DPEMA Solvercard None Yes None
DPEQM Solvercard None Yes None
DPNQM Solvercard None Yes None
DRAPF Solvercard None Yes None
ECTRL Solvercard None Yes None
ELINK Solvercard None Yes None
ENDDATA Solvercard None Yes None
ENERGY_MONITORING
Solvercard None Yes None
ERFFIL Solvercard None Yes None
230
Solver Interfaces
Keyword Support MEDINA Incl/Part
Remarks
EXPORT Solvercard None Yes None
FILE Solvercard None Yes None
FRAME Limited CoordinateSystem
Yes Only rectangular U basedSystem is supported(values 0 and 1 forIAXIS), for other valuesthe whole card is put ontothe solvercard.
Although the IFRATYoption is supported, itcannot be visualized norchanged in MedPre.
A comment in line fivemay be provided tospecify the position ofthe coordinate systemand the main axis.BIFPAM writes thiscomment when exportingcoordinate systems.
FRICT Solvercard None Yes None
FPCTRL Solvercard None Yes None
FUNCSW Solvercard None Yes None
FUNCT Limited Loadcurve No The IFLMEAS value andcard 3 are ignored.
When working withmaterial databases, theFUNCT cards referencedby materials arestored in the materialdatabase together withthe referencing material,
231
Solver Interfaces
Keyword Support MEDINA Incl/Part
Remarks
rather than in theMEDINA data structures.
GAP Solvercard None Yes None
GASPEC Solvercard None Yes None
GFRP Solvercard None Yes None
GLOBAL Solvercard None Yes None
GRPEGM Solvercard None Yes None
GROUP Limited Set Yes The keywords GRP, SEGand EDG of the GeneralEntity Selection (GES)are not supported.
When one of thosekeywords is used, thewhole card is put onto thesolvercard.
Same applies when somereferenced ID is missing,except for ranges.
HEAT Solvercard None Yes None
HTSURF Solvercard None Yes None
IDEXP Solvercard None Yes None
IMPFIL Solvercard None Yes None
IMPORT Solvercard None Yes None
INCLU Full Part Yes A MEDINA part is createdwhich holds the contentsof the include file, exceptfor those objects whichhave no MEDINA partmembershipimplemented yet.
INPRES Solvercard None Yes None
232
Solver Interfaces
Keyword Support MEDINA Incl/Part
Remarks
INPUTVERSION Solvercard None Yes None
INVEL Full Initial velocity Yes None
INVSYS Solvercard None Yes None
IVCTRL Solvercard None Yes None
JOINT Solvercard None Yes None
KINDA Solvercard None Yes None
KINJ Solvercard None Yes None
KJOIN Full KJOINTelement
Yes None
LAYER Solvercard None Yes None
LCPSD Solvercard None Yes None
LCTRL Solvercard None Yes None
LINCO Solvercard None Yes None
LLINK Solvercard None Yes None
LOOKU Solvercard None Yes None
MACTRL Solvercard None Yes None
MASS Limited Mass element Yes Values of IDFRA (localframe), Dr, Ds andDt (distance components)are ignored.
If Mx, My, and Mz havedifferent values, then thewhole card is put onto thesolvercard.
If a node is provided incard 1, no General EntitySelection is considered.In this case, a masselement ID may bedefined in Card 5 incolumns 9 up to 16.
233
Solver Interfaces
Keyword Support MEDINA Incl/Part
Remarks
Card 5 should not beused to provide DiagonalMoment of inertia Ixy, Iyzand Ixz (Pamcrash 2010feature) because PAMBIFwill confuse it with thenode selection cards orwith the element ID.
The limitations on theGeneral Entity Selectionapply; see the remarks onGROUP keyword.
MATER Limited Material No Depending on thesettings, there are threeways how material cardsare treated by PAMBIF:
• "Create no databases"just stores thematerial cards on thesolvercard
• "Create databases"writes each materialtogether with thereferenced FUNCTcards into one file intothe user database.
• "Merge databases"does the same, butonly if the materialdoes not already existin either of the givenmaterial databases.
234
Solver Interfaces
Keyword Support MEDINA Incl/Part
Remarks
Additionally, all materialcards are mappedto MEDINA isotropicmaterials forconvenience. Thematerial data, e.g.the density values,are mapped to theappropriate parametersof the isotropic materialas much as possible.
When working withmaterial databases, thematerial label holdsthe database referencerather than the materialname. The materialreference is the nameof the material file orsubdirectory, preceded bya greater sign (">").
MBSYS Solvercard None Yes None
MCTRL Solvercard None Yes None
MDBODY Solvercard None Yes None
MEMBR Limited TRIA3V orQUAD4Velement
Yes Fields Beta1 and Beta2(fiber angles) are ignored.
MERGEGAP Solvercard None Yes None
METRIC Solvercard None Yes None
METRICCHECK Solvercard None Yes None
MMCASS Solvercard None Yes None
MODEL Solvercard None Yes None
MODULAR_DATA Solvercard None Yes None
235
Solver Interfaces
Keyword Support MEDINA Incl/Part
Remarks
MODULE Solvercard None Yes None
MSTRM Solvercard None Yes None
MTOCO Limited RBE2 element Yes ITMTO (MTOCO type)and Card 2 are ignored.ITMTO is assumed to bezero.
MTOJNT Solvercard None Yes None
MUSC1 Solvercard None Yes None
NLAVE Solvercard None Yes None
NODCO Full General nodeset withsolverkeyNODCO
Yes None
NODE Full Node Yes None
NODPLOT Solvercard None Yes None
NSMAS Full NSM Yes None
NSMAS2 Solvercard None Yes None
OCTRL Solvercard None Yes None
ORTHF Solvercard None Yes None
OTMCO Limited RBE3 element Yes ITYP and ALPHA are notsupported.
PART Limited Property Yes Card 1a is not supported.Therefore IDMAT>0 mustbe provided.
PART type PLINK ismapped to connectorproperty.
CARDs 3 and 4 areignored.
236
Solver Interfaces
Keyword Support MEDINA Incl/Part
Remarks
Field IRADBEN of theCARD 5 is ignored.
Values of RSEAR andNLAYR are not stored inthe property but in theelements.
PART type SHELL ismapped to shell property.
Fields TSCALF andEPSINI are ignored.
CARD 6 (materialorthotropic orientation) isignored.
For PART types MEMBR,BAR, BEAM, SPRING,MBSBR, BSHEL, TSHEL,JOINT, KJOIN, MBKJN,LLINK, ELINK, SLINK,SPHEL, SPRGBM, TIED,SOLID and TETRA, thecontent of cards 3 up tothe last card is mappedto a text field, whichis editable in the PEditcommand.
As an exception, if Parttype is MEMBR, then field"h" of card 5 (thickness) issupported as a distinctiveattribute of the property.Its corresponding fieldin the text field is
237
Solver Interfaces
Keyword Support MEDINA Incl/Part
Remarks
replaced by the string"< T >" (which will bereplaced by the thicknessof the property during theBIFPAM run). Part typeMEMBR is mapped tomembrane property.
Analogously, if PART typeis BAR or BEAM, then thecross section area (field"A" of card 5) is supportedas a distinctive attributeof the Property. Itscorresponding field in thetext field is replaced bythe string "< A >". PARTtype BAR and BEAMare mapped to BARand BEAM properties,respectively.
PART types SPRING andMBSBR are mapped toDynaSP1 property.
PART type SOLID andTETRA are mapped tosolid property, which hasa "sub-type" attribute thatindicates whether thePAMCRASH PART typeis SOLID or TETRA.
PART types BSHEL,TSHEL, JOINT, KJOIN,MBKJN, LLINK, ELINK,
238
Solver Interfaces
Keyword Support MEDINA Incl/Part
Remarks
SLINK, SPHEL,SPRGBM, TIED aremapped to generalproperty, which hasa "sub-type" attributethat indicates thePAMCRASH PART type.
It is possible to createa special file whenimporting a PAMCRASHfile.
This file, called the controlfile, has values that canbe edited by the user toreplace values of specialfields.
Please refer to thecontrol file section ofthe MEDINA PAMCRASHinterface documentationfor details.
PENTA6 Full PENTA element Yes None
PFLOW Solvercard None Yes None
PFMAT Solvercard None Yes None
PICK Solvercard None Yes None
PIPE Solvercard None Yes None
PLINK Limited CONNSPOTelement
No The General EntitySelection of the PLINKcard is limited to thePART keyword, i.e. onlyPART IDs may beprovided. Otherwise, the
239
Solver Interfaces
Keyword Support MEDINA Incl/Part
Remarks
whole PLINK card is putonto the solvercard.
PLY Solvercard None Yes None
PREBM Solvercard None Yes None
PREFA Solvercard None Yes None
PREFILTER Solvercard None Yes None
PRESBC Solvercard None Yes None
PRINT Solvercard None Yes None
PROFILE_DMP Solvercard None Yes None
PYFUNC Solvercard None Yes None
RAC3D Full PVAD Yes None
RAN3D Full PVAD Yes None
RAN3DM Full PVAD Yes None
RAN3DX Full PVAD Yes None
RBODY Full NRIGBODY Yes None
RESTARTFILES Solvercard None Yes None
RESUMERUN Solvercard None Yes None
RETRA Solvercard None Yes None
RMLOAD Solvercard None Yes None
RMSSOL Solvercard None Yes None
RUNEND Solvercard None Yes None
RUPMO Solvercard None Yes None
RVE3D Full PVAD Yes None
RWALL Limited Stonewall Yes If ISENS is not zero thewhole card is put onto thesolvercard.
ILEAK (airbag flag) valueis ignored.
240
Solver Interfaces
Keyword Support MEDINA Incl/Part
Remarks
Only Rigid Walls oftype 4 (infinite wall),5 (cylinder wall) and7 (spherical wall) aresupported. Otherwise thewhole card is put onto thesolvercard.
RWALL_KIN_CHECK Solvercard None Yes None
SECFO Limited CrossSection Yes Only PLANE, SECTION,SUPPORT andCONTACT types aresupported. Otherwise thewhole card is put onto thesolvercard.
SECURE Limited Material No PLY, FUNCT, GASPEC,MUSC1, PART andNODE encrypted optionsare put onto solvercard.
In case of the MATERoption, the SECURE cardis treated like a MATERcard.
SELOUT Solvercard None Yes None
SENPT Full General nodeset withsolverkeySENPT
Yes The limitations on theGeneral Entity Selectionapply; see the remarks onGROUP keyword.
SENPTG Full General nodeset withsolverkeySENPTG
Yes The limitations on theGeneral Entity Selectionapply; see the remarks onGROUP keyword.
SENSOR Solvercard None Yes None
SEWING Solvercard None Yes None
241
Solver Interfaces
Keyword Support MEDINA Incl/Part
Remarks
SHELL Limited TRIA3, TRIA3V,QUAD4 orQUAD4Velement
Yes Field NINT (number ofintegration points) isignored
SHEL6 Solvercard None Yes None
SHEL8 Solvercard None Yes None
SHELLCHECK Solvercard None Yes None
SHLPLOT Solvercard None Yes None
SIGNAL Solvercard None Yes None
SLINK Solvercard None Yes None
SLIPR Solvercard None Yes None
SOLID Full TETRA,PYRAM,PENTA orHEXA element
Yes None
SOLIDCHECK Solvercard None Yes None
SOLPLOT Solvercard None Yes None
SOLVER Solvercard None Yes None
SPCTRL Solvercard None Yes None
SPHEL Solvercard None Yes None
SPHELO Solvercard None Yes None
SPHPLOT Solvercard None Yes None
SPRGBM Solvercard None Yes None
SPRING Limited NLSPRINGelement
Yes IFRA (local frame) is notsupported. Hence M1 andM2 must be provided,otherwise cards go tosolvercard.
STAGE Solvercard None Yes None
STOPRUN Solvercard None Yes None
SUBDF Solvercard None Yes None
242
Solver Interfaces
Keyword Support MEDINA Incl/Part
Remarks
SUBRUN Solvercard None Yes None
TETR10 Solvercard None Yes None
TETR4 Full TETRA element Yes None
TETRA Full TETRA10element
Yes None
TETRA4 Solvercard None Yes None
THCRS Solvercard None Yes None
THELE Full Generalelement setwith solverkeyTHELE
Yes The limitations on theGeneral Entity Selectionapply; see the remarks onGROUP keyword.
THICKNESS_INTEGRATIONSolvercard None Yes None
THLOC Full General NodeSet withSolverkey=THLOC
Yes The limitations on theGeneral Entity Selectionapply; see the remarks onGROUP keyword.
THMAT Solvercard None Yes None
THNAC Solvercard None Yes None
THNOD Full General NodeSet withSolverkey=THNOD
Yes The limitations on theGeneral Entity Selectionapply; see the remarks onGROUP keyword.
THNPO Solvercard None Yes None
TIED Full TIED Yes None
TIMESTEP Solvercard None Yes None
TITLE Solvercard None Yes None
TRAFO Solvercard None Yes None
TRANS Solvercard None Yes None
TRSFM Limited Part attributeplus generalnode set with
Yes If there is one or moreMEDINA part(s) whosenodes are all present
243
Solver Interfaces
Keyword Support MEDINA Incl/Part
Remarks
label "GES ofTRSFM ..."
in the node selectionof the TRSFM card,then this transformationis assigned to thispart(s) and thetransformation is appliedto the referenced nodecoordinates. Otherwise,the whole TRSFM cardis put onto the solvercardand no node coordinatesare transformed.
The transformed nodecoordinates will berestored to theiruntransformed positionduring the BIFPAM run.
A general node setis created in order topreserve the original GESformat.
The limitations on theGeneral Entity Selectionapply; see the remarks onGROUP keyword.
TSHEL Solvercard None Yes None
UDATA Solvercard None Yes None
UNIT Solvercard None Yes None
VACPL Solvercard None Yes None
VAMAT Solvercard None Yes None
VAMPSO Solvercard None Yes None
VAPANL Solvercard None Yes None
244
Solver Interfaces
Keyword Support MEDINA Incl/Part
Remarks
VARDEF Solvercard None Yes None
VEL3D Full PVAD Yes None
Note
Contents of CDATA block is not interpreted by PAMBIF, even if it is a GESreferencing to certain object IDs. Be aware that renumbering those referencedobjects damages such GES.
With Pamcrash 2011, the following feature in the syntax of the GES is available:
• The notation " :n" (space-colon-n) denotes all IDs from 1 to n
• The notation "m: " (m-colon-space) denotes all IDs from m to infinity
PAMCRASH contacts keeps their location in Include files in Import and Exportcommands.
4.7.9. BIFPAM -> Interface BIF to PAM
LOADS Exportedas
Remarks
Nodal Force CONLO / CNL of type rigid is not exported.
If CNL is of NodeSet type, thenfor each node in which the load isapplied, one "CONLO / " card iswritten.
Alternative Coordinate System shouldnot be used because BIFPAM willignore it.
ISENS field is not supported (will bezero).
ITYPE field will be equal to 1.
CLOAD field will be empty.
245
Solver Interfaces
LOADS Exportedas
Remarks
Pressure PRESH / none
PVAD ACC3D / full support
PVAD DIS3D / full support
PVAD DIS3DM / full support
PVAD DIS3DX / full support
PVAD RAC3D / full support
PVAD RAN3D / full support
PVAD RAN3DM /full support
PVAD RAN3DX / full support
PVAD RVE3D / full support
PVAD VEL3D / full support
Initital velocity INVEL / full support
Acceleration ACFLD / full support
Thermal loads and thermalboundary conditions
notexported
none
CONSTRAINTS Exportedas
Remarks
SPC BOUNC / IFRAM (frame ID) and ISENS (sensorID) fields will be zero.
MPC notexported
none
Pre-stress notexported
none
Stone wall RWALL / StoneWalls of type FLAT LIMITED arenot exported
SETS Exportedas
Remarks
Boundary and geometry sets notexported
none
246
Solver Interfaces
SETS Exportedas
Remarks
Node, element and propertysimple sets
GROUP / none
General set with solverkey Node,Element, Part, Unused or anysolverkey which is not related toPAMCRASH solver
GROUP / A set is not exported as 'GROUP / 'if it is already exported to NODCO /,SENPT /, SENPTG/, THELE /,THNOD / or THLOC / due to itssolverkey.
General node set with solverkeyNODCO
NODCO / none
Simple node set whose label startswith "NODCO /"
NODCO / IDOF, IFRAM and ISENS fields areextracted from the set label. BIFPAMexpects that they are provided in thelabel after the "NODCO / " sub-string,separated by a space, a comma or asemi-colon between each value.
Only the remaining text of the label willbe written to NAME line.
General node set with solverkeySENPT
SENPT / none
General node set with solverkeySENPTG
SENPTG/ none
Element general set withsolverkey THELE
THELE / none
Element simple set with labelstarting with "THELE /"
THELE / The leading sub-string "THELE /" willnot be part of the NAME line.
General node set with solverkeyTHNOD
THNOD / none
Simple node set whose label startswith "THNOD /"
THNOD / The NAME line will hold the set labelwithout the "THNOD /" substring.
General node set with solverkeyTHLOC
THLOC / none
247
Solver Interfaces
SETS Exportedas
Remarks
Simple node set whose label startswith "THLOC /"
THLOC / The fields IFRAM, N1, N2, Correctionflag for acceleration and IDAFLD areextracted from the set label. BIFPAMexpects that they are provided inthe set label after the "NODCO /"substring, separated by a space, acomma or a semi-colon between eachvalue. Only the remaining text of thelabel will be written to the NAME line.
ELEMENTS Exportedas
Remarks
BAR BAR / Orientation of cross section is notwritten.
ROD BAR / Orientation of cross section is notwritten.
BEAM BEAM / Tapered beam is not supported.
The offset vector is ignored
BEAM4 notexported
none
BUSH notexported
none
CONM1 notexported
none
DAMP notexported
none
DAMP1 notexported
none
GAP notexported
none
HEXA SOLID / full support
248
Solver Interfaces
ELEMENTS Exportedas
Remarks
HEXA20 notexported
none
HEXA21 notexported
none
HEXA27 notexported
none
HEXA32 notexported
none
HEXA8ThickShell SOLID / The element thickness is ignored.
ILIN notexported
none
IQUAD notexported
none
ITRIA notexported
none
JCYCLIN notexported
none
JLOCKING notexported
none
JPLANAR notexported
none
JREVOLVE notexported
none
JSPEHRE notexported
none
JTRANSL notexported
none
JUNIVERS notexported
none
KJOINT KJOIN / full support
MASS MASS / COG Offset, Diagonal Inertia (Ixy, Iyzand Izx) and alternative Coordinate
249
Solver Interfaces
ELEMENTS Exportedas
Remarks
System should not be used becauseBIFPAM ignores these features.
Fields Dr, Ds, Dt and IDFRA (distanceto COG and frame number) will beblank.
Card 5 (Diagonal Inertia - Ixy, Iyz andIzx) will not be written.
MASS1 notexported
none
MASS2 notexported
none
NLSPRING and NLDAMP SPRING/ Only the nodes and orientationis exported. Other attributes (initialoffset, scale factor, print flag) are lostduring export.
If "GROUND" is used as second node,then the second node will be equal tothe first node on the SPRING / card.
NRIGBODY RBODY / Full Support. But in MedPre, elementmust be created with analysisparameter set to PAMCRASH in thePARAM command.
PENTA PENTA6 / Full support
PENTA15 notexported
none
PENTA18 notexported
none
PENTA24 notexported
none
PENTA6ThickShell SOLID / The element thickness is ignored.
250
Solver Interfaces
ELEMENTS Exportedas
Remarks
PLOTEL notexported
none
PYRAM SOLID / The fields N5, N6, N7 and N8 will beequal to N5.
PYRAM13 notexported
none
PYRAM14 notexported
none
QUAD12 notexported
none
QUAD4 SHELL / NIP (number of integration points) andthickness are not supported.
QUAD4V with thickness not equalto 0.0
SHELL / The number of integration points is notsupported (will be blank).
QUAD4V with thickness equal to0.0
MEMBR / Fiber Angle ß1, ß2 options are notsupported and will be set to zero.
QUAD8 notexported
none
QUAD8V notexported
none
QUAD9 notexported
none
QUADX4 notexported
none
QUADX8 notexported
none
RBAR notexported
none
RBE2 ( MTOCO ) MTOCO / Field ITMTO (MTOCO type) is notsupported (will be blank).
RBE3 (OTMCO) OTMCO / ITYP and ALPHA are not supported.
251
Solver Interfaces
ELEMENTS Exportedas
Remarks
ROD3 notexported
none
RROD notexported
none
RSPLINE notexported
none
SPRING notexported
none
SPRING1 notexported
none
TETRA TETR4 / full support
TETRA10 TETRA10 /full support
TETRA16 notexported
none
TRIA3 SHELL /
MEMBR /
NIP (number of integration points )and thickness are not supported.
TRIA3 are exported as "SHELL /",unless a control file is used andtheir property on the control file is ofmembrane type.
N4 will be 0.
TRIA3V with thickness not equalto 0.0
SHELL / The field N4 will be equal to N3.
TRIA3V and QUAD4V withthickness equal to 0.0
MEMBR / Fiber Angle ß1, ß2 options are notsupported and will be set to zero.
TRIA6 notexported
none
TRIA6V notexported
none
TRIA7 notexported
none
252
Solver Interfaces
ELEMENTS Exportedas
Remarks
TRIA9 notexported
none
TRIAX3 notexported
none
TRIAX6 notexported
none
VISC notexported
none
CONNSPOT PLINK / Maximum distance will be dividedby 2 and stored as RSEAR in thePART card. If some spotwelds ofthe same property have differentmaximum distance values, additionalPART cards will be written in orderto map all those values. A warning isissued in such cases.
PROPERTIES Part/Type Remarks
ConnSpot PLINK CARDs 3 and 4 (fields DTELIM,TSCALF, TCONT and EPSINI) are notsupported.
In CARD 5:
• IRADBEN is not supported
• Field SPWLG (maximal length) issupported though it is not possibleto edit its value in MedPre. It isdefined by PAMBIF when PART /...PLINK is imported. Its default valueis 0.0
• The value of RSEAR (link searchradius) is not stored in the property,but by means of the spotweld
253
Solver Interfaces
PROPERTIES Part/Type Remarkselements' maximum distance field,which held’s the double RSEARvalue. Therefore, if not all elementsthat use the property havethe same search radius, thenadditional PART /' cards will bewritten
Shell SHELL The TSCALF value is not supportedand will be blank.
CARD 6 (orthotropic orientation) is notsupported. The line will be empty.
If the property has been created byPAMBIF during an import of PART /..SHELL card, then the DTELIM fieldwill have the same value after export,but it is not possible to edit it inMedPre. By default BIFPAM exports itas zero.
If not available from control file, fieldEPSINI will be equal to zero. Thecontrol file also overrides the fieldsIDMAT, h (thickness), NINT (numberof integration points) and TCONT.
Membrane MEMBR Cards 3 up to the last card areextracted from the textfield, except forthe field h (thickness), which is takenfrom the corresponding panel field.
If available in the control file, theTCONT and EPSINI values areextracted from control file, replacingthe values of the text field. The controlfile also overrides field h (thickness)and IDMAT (material ID), which are
254
Solver Interfaces
PROPERTIES Part/Type Remarksotherwise extracted from the propertydata.
Bar BAR Cards 3 up to the last card areextracted from the text field.
The TCONT and EPSINI fieldsare extracted from the control fileif available. The control file alsooverrides the field IDMAT (materialID), which is otherwise extracted fromthe property data.
Beam BEAM Cards 3 up to the last card areextracted from the text field, with theexception of field A.
The TCONT and EPSINI fieldsare extracted from the control fileif available. The control file alsooverrides the field IDMAT (materialID), which is extracted from theproperty data otherwise.
DynaSP1 SPRING Cards 3 up to the last card areextracted from the text field.
The TCONT and EPSINI fieldsare extracted from the control fileif available. The control file alsooverrides the field IDMAT (materialID), which is extracted from theproperty data otherwise.
Solid SOLID Cards 3 up to the last card areextracted from the text field.
The TCONT and EPSINI fieldsare extracted from the control fileif available. The control file alsooverrides the field IDMAT (material
255
Solver Interfaces
PROPERTIES Part/Type RemarksID), which is extracted from theproperty data otherwise.
General BSHEL,ELINK,JOINT,LLINK,MBKJN,SLINK,SPHEL,SPRGBM,TIED orTSHEL
Field ATYPE (PART type) isdeterminate by the property sub-typeflag, which is editable in the PCreateand PEdit command.
Cards 3 up to the last card areextracted from the text field, withexception of field h (thickness) forsub-type TShell and of fields TCONTand EPSINI for the case that they areprovided on control file.
Note
Properties are exported to PAMCRASH PART cards which have rather nothingto do with MEDINA parts.
Properties that are not used by any element are not exported.
Properties of BAR, BEAM, DYNASP1, GENERAL, MEMBR and SOLID typesprovide a solver-specific text field, in order to store the cards 3 up to the lastcard. The text field is opaque to MEDINA and is editable by means of thePCreate and PEdit commands, except for a few values mapped to dialoguefields. Those values are represented by placeholder strings in the text fieldsand should be edited by means of the corresponding dialogue panel fields only.
When a control file is used, the property data contained therein have priority.
Others
MEDINA OBJECTS Exportedas
Remarks
Node NODE / Node should not have suppressedDOF because BIFPAM will ignorethem. Use SPC instead.
256
Solver Interfaces
MEDINA OBJECTS Exportedas
Remarks
Node Coordinate System ID isignored. The global coordinates of thenodes are used.
Node with label starting with"CNODE"
CNODE / (Same as Node)
BeamSection notexported
none
CossSection SECFO / These MEDINA commands must beexecuted with analysis parameterset to PAMCRASH in the PARAMcommand
PAMCRASH contact TIED TIED / full support
PAMCRASH contact CNTAC / full support
NSM NSMAS / full support
Loadcurve FUNCT / Not exported if not referenced in anyMEDINA object.
BIFPAM always sets to zero theSHIFTX and SHIFTY fields (shiftvalue for abscissa and ordinate)
BIFPAM never writes the fieldIFLMEAS.
The abscissa and ordinate labelsdefined in MedPre are ignored.
Coordinate Systems FRAME / Cylindrical and spherical coordinatessystems are not exported.
Local 1 direction should always be X.If it is set to Y or Z, BIFPAM will treatit as if it were X.
The position of the coordinate systemand the main axis information is
257
Solver Interfaces
MEDINA OBJECTS Exportedas
Remarks
written as a comment in what wouldbe the fifth card.
If the coordinate system has beencreated by PAMBIF during an importof a FRAME card, then the IFRATYfield value will have the same valueon the exported FRAME / card.Otherwise it will be zero. It is notpossible to edit this value in MedPre.
If the coordinate system referencesanother one as parent, BIFPAM willrecalculate its coordinate vectors intothe global system, since PAMCRASHdoes not support such a feature.
Component notexported
none
Layer notexported
none
Box3D notexported
none
Material MATER / If material databases are provided,the material cards and theirreferenced FUNCT cards will beextracted from the material database.In order to be exported, the materialdatabase files must be referencedby a MEDINA material by meansof its label of the form ">" followedby the name of the material file ordirectory. If a control file is used,the material references therein havepriority. Additionally, MATER / cardsfrom the solvercard, e.g. resulting
258
Solver Interfaces
MEDINA OBJECTS Exportedas
Remarks
from the "Create no databases"import option, are always exported.
TRAFO notexported
none
GEINFE1 notexported
none
GEINFE2 notexported
none
PREDOF notexported
none
SUPDOF notexported
none
QUERDAT notexported
none
EPROMSV notexported
none
EMAT notexported
none
EMATCOMP notexported
none
EPROMSV notexported
none
PROPABA notexported
none
PROPDYNA notexported
none
PROPTEMP notexported
none
PSVSET notexported
none
LOADSET notexported
none
259
Solver Interfaces
MEDINA OBJECTS Exportedas
Remarks
INTPOL notexported
none
KONTAKT notexported
none
KONLOAD notexported
none
SITUAT notexported
none
COMPONENT notexported
none
CCONTROL notexported
none
STRUKTUR notexported
none
MESHAREA notexported
none
MESHVOLU notexported
none
RSPLINE notexported
none
HEADER Comment The comment is placed at thebeginning of the main file.
POLYCURV notexported
none
FORIVEC notexported
none
SOLVENAM notexported
none
RESTART notexported
none
Point notexported
none
260
Solver Interfaces
MEDINA OBJECTS Exportedas
Remarks
Line notexported
none
Polygon notexported
none
Partial circle/circle notexported
none
Plane notexported
none
Curve notexported
none
Surface notexported
none
Curve on surface notexported
none
Surface (limited) notexported
none
Surface composites notexported
none
GMESH2D notexported
none
GMESH3D notexported
none
Note
PAMCRASH contacts keeps their location in Include files in Import and Exportcommands.
4.7.10. PAMBOF -> Interface PAMCRASH to BOF
PAMBOF supports version 2008 of PAMCRASH. It uses dsylib, for which a license isrequired.
The following options are supported:
261
Solver Interfaces
Option - interactive
With this button an interactive selection of the results from a list is available.
The list has the general form:
Option info selected, results on File for beam:
1 AXIALFORCE Scalar
2 T-SHEAR FORCE AT NODE 2 Scalar
3 TORSION MOMENT Scalar
4 S-BENDIND MOMENT NODE 1 Scalar
5 T-BENDING MOMENT NODE 1 Scalar
6 S-BENDIND MOMENT NODE 2 Scalar
7 T-BENDING MOMENT NODE 2 Scalar
8 AXIAL ELONGATION Scalar
9 TORSION ANGLE Scalar
10 S-BENDING ANGLE NODE 1 Scalar
11 T-BENDING ANGLE NODE 1 Scalar
12 S-BENDING ANGLE NODE 2 Scalar
13 T-BENDING ANGLE NODE 2 Scalar
Option info selected, results on File for shell:
0 RES-MXX Scalar
1 RES-MYY Scalar
2 RES-MXY Scalar
3 MX PLAST e Scalar
4 MN PLAST e Scalar
5 RES-NXX Scalar
6 RES-NYY Scalar
7 RES-NXY Scalar
8 Thickness Scalar
9 MAX VM Value Scalar
262
Solver Interfaces
Option info selected, results on File for shell:
10 MIN VM Value Scalar
11 Int Energy Density Scalar
Option info selected, results on File for solid:
0 X STRESS Scalar
1 Y STRESS Scalar
2 Z STRESS Scalar
3 XY STRESS Scalar
4 YZ STRESS Scalar
5 ZX STRESS Scalar
6 Effect. Plastic Strain Scalar
7 Solid Aux 1 Scalar
8 Solid Aux 2 Scalar
9 Solid Aux 3 Scalar
10 Solid Aux 4 Scalar
11 Solid Aux 5 Scalar
12 Solid Aux 6 Scalar
13 Int Energy Density Scalar
14 HG Energy Density Scalar
The selection takes place according to the number given in the first column.
For a tensor one must select all the components of the tensor.
To finish the selection, uses only "end".
Selecting the option interactive will override the option rtype.
Option info: With this button the list will be written to the prot file.
The list has the general form:
Option info selected, results on File for shell:
0 RES-MXX M Scalar
263
Solver Interfaces
Option info selected, results on File for shell:
1 RES-MYY M Scalar
2 RES-MXY M Scalar
3 MX PLAST e EPMA Scalar
4 MN PLAST e EPMI Scalar
5 RES-NXX N Scalar
6 RES-NYY N Scalar
7 RES-NXY N Scalar
8 Thickness THIC Scalar
9 MAX VM Value ESMA Scalar
10 MIN VM Value ESMI Scalar
No selection is possible.
The keywords for the input of option rtype are found in column 25-30.
For the vector MXYZ, with the components RES-MXX, RES-MYY and RES-MXY, thekeyword mxyz must be used.
For the vector NXYZ, with the components RES-NXX, RES-NYY and RES-NXY, thekeyword nxyz must be used.
Selecting the option info will overwrite the option interactive.
Option rtype: The string which is included in ' " ' represents the results which arewritten to the BOF for all states.
The options, included by ' " ', are the connection of the element type (beam, shell, solidor tool) and the output qualifier (first column in the SOLVER NOTES MANUAL, plotoutput).
Different options may be separated by commas.
The meanings of the options are summarized in the lists below.
For element type BEAM:
String in rtype Title Variable type
beam_faxi AXIAL FORCE Scalar
264
Solver Interfaces
String in rtype Title Variable type
beam_fssh SHEAR FORCE AT NODE 2 Scalar
beam_ftsh T-SHEAR FORCE AT NODE 2 Scalar
beam_mtor TORSION MOMENT Scalar
beam_msn1 S-BENDIND MOMENT NODE 1 Scalar
beam_mtn1 T-BENDIND MOMENT NODE 1 Scalar
beam_msn2 S-BENDIND MOMENT NODE 2 Scalar
beam_mtn2 T-BENDIND MOMENT NODE 2 Scalar
beam_daxi AXIAL ELONGATION Scalar
beam_rtor TORSION ANGLE Scalar
beam_rsn1 S-BENDING ANGLE NODE 1 Scalar
beam_rtn1 T-BENDING ANGLE NODE 1 Scalar
beam_rsn2 S-BENDING ANGLE NODE 2 Scalar
beam_rtn2 T-BENDING ANGLE NODE 2 Scalar
For element type SHELL:
String in rtype Title Variable type
shell_mxyz RES-MXX 2D Tensor
RES-MYY
RES-MXY
shell_epma MX PLAST e scalar
shell_epmi MN PLAST e scalar
shell_nxyz RES-NXX 2D Tensor
RES-NYY
RES NXY
shell_thic Thickness scalar
shell_esma MAX VM Value scalar
shell_esmi MIN VM Value scalar
shell_mntr1 Int Energy Density scalar
shell_mntr2 HG Energy Density scalar
For element type SOLID:
265
Solver Interfaces
String in rtype Title Variable type
solid_sxyz X STRESS 3D Tensor
Y STRESS
Z STRESS
XY STRESS
YZ STRESS
ZX STRESS
solid_eple Effect. Plastic Strain scalar
solid_aux1 Solid Aux 1 scalar
solid_aux1 Solid Aux 1 scalar
solid_aux1 Solid Aux 1 scalar
solid_aux1 Solid Aux 1 scalar
solid_aux1 Solid Aux 1 scalar
solid_aux1 Solid Aux 1 scalar
solid_mntr1 Int Energy Density scalar
solid_mntr2 HG Energy Density scalar
4.8. STARCD -> Interface to STARCDBIFSTAR/STARBIF converts MEDINA data (BIF) into STARCD data and vice versausing the standards described in STARCD Version 3.05.
Introduction
The basic data needed to generate a model are nodes and elements. This data isproduced by a preprocessor.
4.8.1. BIFSTAR -> Interface BIF to STARCD
The interface program bifstar converts MEDINA data (BIF) into binary STARCD datafiles.
Calling BIFSTAR from the MEDINA Monitor
The following table compares and describes the parameters in the MEDINA Monitorand the command line parameters for the tcl batch script:
266
Solver Interfaces
Start MonitorParameter
Batch ScriptParameter
Description
Workingdirectory
dir=dirname Set the working directory for file access.
BIF Input file bif=filename Binary input file from MEDINA PreProcessing.
Output prefix prefix=name Prefix for STARCD files .cell, .vrt and .ctable
Replaceexisting files
(always replace) The monitor toggle has two states, ON and OFF.If the toggle is ON, existing files, e.g. the STARCDinput file, are overwritten. If called from a script,files are always replaced.
Additionalprogramparameters
bit=32|64
log=filename
batch
warning=number
size=number
Parameters shared by all interfaces (see chapter1 for a description).
Calling BIFSTAR without MEDINA Monitor
Call:
<inst_directory>/cae/bin/bifstar bif=name prefix=casename
[log=name] [warning=number]
Option Meaning
bif=name Input: MEDINA data file name (e.g. medina.bif)
Prefix=casename Prefix for output files (e.g. “test” as prefix produces theoutput files “test.cel”, “test.vrt” and “test.ctable”)
log=name Output: log file name (default: bifstar.log)
warning=number No warnings will be suppressed
Example:
To convert the MEDINA file test.bif into the STARCD files test.cel, test.vrt andtest.ctable, use:
<inst_directory>/cae/bin/bifstar bif= test.bif prefix=test
267
Solver Interfaces
4.8.2. STARBIF -> Interface STARCD to BIFThe interface program starbif converts STARCD data files into MEDINA data (BIF).
The binary files of STARCD version 3 and older versions are supported. The ASCIIfiles of STARCD version 4 is supported.
Calling STARBIF from the MEDINA Monitor
The following table compares and describes the parameters in the MEDINA Monitorand the command line parameters for the tcl batch script:
StartMonitorParameter
Batch ScriptParameter
Description
Workingdirectory
dir=dirname Set the working directory for file access.
Input prefix prefix=name Input file prefix for STARCD data files.
STAR-CD fileformat
format=0|1 Set the format of STARCD file
EQ. 0: Binary (default)
EQ. 1: ASCII Version 4.
BIF output file bif=filename Binary file for MEDINA PreProcessing.
Replaceexisting files
(always replace) The monitor toggle has two states, ON and OFF. If thetoggle is ON, existing files, e.g. the STARCD input file,are overwritten. If called from a script, files are alwaysreplaced.
Additionalprogramparametersshared by allinterfaces
batch
bit=32|64
log=filename
warning=number
Parameters shared by all interfaces (see chapter 1 fora description), plus additional parameters described inthe following chapter.
Calling STARBIF without the MEDINA Monitor
Call:
<inst_directory>/cae/bin/starbif dat=casename bif=name
[log=name] [warning=number][format=number]
268
Solver Interfaces
Option Meaning
Prefix=casename Input: STARCD data file name prefix (e.g. test)
bif=name Output: MEDINA data file name (e.g. medina.bif)
log=name Output: log file name (default: starbif.log)
warning=number No warnings will be suppressed
format=number Input: Format of STARCD file
EQ. 0: Binary
EQ. 1: ASCII Version 4
Example:
To convert the binary STARCD files test.cel, test.vrt into the MEDINA file test.bif, use:
<inst_directory>/cae/bin/starbif prefix=test bif=test.bif
format=0
STARCD Topology Definition
Topology Dimension Number ofvertices
Name MEDINAelement
1 0-D 1 Point Not supported
2 1-D 2 Line BAR
3 2-D Varies Shell/baffle 1. Number ofvertices=3TRIA3
2. Number ofvertices=4QUAD4
3. Other casesnotsupported
4 2-D Varies Shell/baffle withmidside vertices
Not supported
11 3-D 8 Hexahedron HEXA
12 3-D 6 Prism PENTA
269
Solver Interfaces
Topology Dimension Number ofvertices
Name MEDINAelement
13 3-D 4 Tetrahedron TETRA
14 3-D 5 Pyramid PYRAM
21 3-D 20 Hexahedronwith midsidevertices
Not supported
22 3-D 15 Prism withmidside vertices
Not supported
23 3-D 10 Tetrahedronwith midsidevertices
Not supported
24 3-D 13 Pyramid withmidside vertices
Not supported
28 1-D 3 Line with oneextra vertex
Not supported
29 1-D 4 Line with twoextra vertices
Not supported
30 2-D Varies Shell/baffle withextra centervertex
Not supported
31 2-D Varies Shell/baffle withmidside verticesand extra centervertex
Not supported
33 1-D 3 Line with onemidside vertex
Not supported
34 1-D 4 Line with onemidside vertexand one extravertex
Not supported
255 3-D Varies Polyhedron Not supported
270