Professional Documents
Culture Documents
This Document describes the FEMAP Neutral File Format. This information is not required unless you are going to
write your own interfaces to read or write Neutral Files.
Integer Values
Integer values are all subject to the limitations for the corresponding numbers in FEMAP. In no case can an ID ever
exceed the range 1 to 99999999. Other limitations are described in the formats shown below.
Real Values
Real numbers can be written in either floating point or exponential format. Any reasonable number of significant
digits can be included, but the total length of any line can not exceed 255 characters.
Character Strings
Titles and other text items are simply written as a series of characters. In a formatted file, they are always the only
item in the record, so the end of the line terminates them. If the character string is really empty (has no characters),
FEMAP will write the special string "<NULL>". If you are reading a Neutral file, you should interpret this as a blank
string.
2. Each entry in the library is preceded by a comment line that looks like:
A-2 FEMAP Neutral File Format
It must start with $COM. The second field must be the entity type (i.e. for materials - 0=Isotropic, 1=2D
Orthotropic...). The third field is the FEMAP version of the datablock. The remainder of the line is the entity title.
3. Following the comment is a standard FEMAP data block containing one, and only one entity.
If you follow these formatting rules, a FEMAP library can be read either one entity at a time with the various Load
from library options, or in its entirety with the FEMAP Neutral Read Translator.
Data blocks that are listed as obsolete are not written in the current version of the Neutral File. They have been
superseded by another similar datablock. Since FEMAP can write Neutral files for previous versions, some of these
obsolete datablocks may still be produced if you select an old version format. In that case, the datablocks are still
documented. In most cases, these data blocks can still be read by FEMAP, but may be removed completely in a later
release. You should never write any new interfaces that use these obsolete formats.
When you look at the following tables, the record numbers refer to the line numbers relative to the start of the
datablock in a formatted neutral file. You can tell the type and size of these numbers (or characters) by referring to
the "Size" column.
Changes from previous versions have a version number included in the description - like (4.1+) to mean version 4.1
and later. If you find the version number change in the Record or Field column, this implies that that record or field
was added in that version - files generated in previous versions will not have this data present. If the version change
is listed in the Description column, this implies that the description was changed. This usually occurs when
additional options or meanings are given to an existing field.
The following table gives the locations in the material data tables for the data that is defined for the standard
materials. Other custom materials can use these locations, or any other location, as defined in the material definition
file that is described later in this document.
Material Values
Type Value Description Locations
Integer Values
HYPER_POLYORD(i) Strain Energy Polynomial Order for ival[0],ival[1]
Hyperelastic
NONLINEAR_TYPE Nonlinear Type (0=None/Linear, ival[2]
1=Nonlinear Elastic, 2=Plastic, 3=Elasto-
Plastic
HARDENING_TYPE Hardening Data Type ival[3]
YIELD_TYPE Yield Criterion (0=von Mises, 1=Tresca, ival[4]
FEMAP Neutral File Format A-7
2=Mohr-Coloumb, 3=Drucker-Prager)
CREEP_TYPE Creep Type (0=None, 1=Empirical, ival[5]
2=Tabular)
CREEP_EMPIRICAL_FORM(i) Empirical Creep Law Format Flags ival[6..9]
DP_HARDENING_DATA_TYPE Drucker-Prager Hardening data type ival[10]
Boolean Values
HAS_STRAIN_LIMITS Flag if material uses strain limits instead of bval[0]
stress limits
FLUID IS LIQUID Flag if a fluid type materia is a liquid vs. a bval[1]
gas
OPT_FRONT_SIDE bval[2]
OPT_REV_SIDE bval[3]
DMATRIX_HYP_D1_ZERO Flag to write D1 in Nastran Hyperelastic bval[4]
material as Zero
Real Values
E(i) Young's modulus mval[0..2]
G(i) Shear modulus mval[3..5]
NU(i) Poisson's ratio mval[6..8]
GMATRIX_3D(i) Upper triangle of 6x6 3D anisotropic mval[9..29]
elastic matrix.
GMATRIX_2D(i) Upper triangle of 3x3 2D anisotropic mval[30..35]
elastic matrix.
THERMAL_EXPANSION(i) Thermal expansion coefficients. mval[36..41]
THERMAL_CONDUCTIVITY(i) Thermal conductivity coefficients. mval[42..47]
THERMAL_CAPACITY Specific Heat mval[48]
DENSITY Material density mval[49]
DAMPING Damping coefficient mval[50]
TEMPERATURE Reference temperature mval[51]
TENSION_LIMIT(i) Stress Allowables in tension mval[52..53]
COMPRESSION_LIMIT(i) Stress Allowables in compression mval[54..55]
SHEAR_LIMIT Stress Allowable in shear mval[56]
TSAI_WU_INTERACTION Tsai_wu interaction factor mval[57]
AMATRIX_HYP(i) Hyperelastic Amatrix values mval[58..78]
DMATRIX_HYP(i) Hyperelastic Dmatrix values mval[79..83]
HARDENING_SLOPE Plasticity Hardening Slope mval[84]
YIELD_LIMITS(i) Plasticity Yield Limits - Initial Yield mval[85..89]
Stress, Friction Angle, addl yield limits
CREEP_THRESHOLD_STRESS Creep Threshold Stress mval[90]
CREEP_REF_TEMP Creep Reference Temperature mval[91]
CREEP_TEMP_DEP_RATE Temperature Dependent Creep Rate mval[92]
CREEP_EMPIRICAL_COEFF(i) Empirical Creep Law Coefficients mval[93..99]
HEAT GENERATION Heat Generation Value mval[100], or
tval[57]
REFERENCE ENTHALPY Enthalpy for Phase Change mval[101]
PHASE CHANGE TEMP Temperature for Phase Change Onset mval[102]
PHASE CHANGE TEMP RANGE Temperature Range for Phase Change mval[103]
LATENT HEAT OF FUSION Latent heat of Fusion mval[104]
SPECIFIC HEAT ABOVE PHASE Specific heat above Phase Change Temp mval[105]
OPT EMISSIVITY Optical Emissivity mval[106]
OPT EMISSIVITY REV Optical Emissivity, Reverse Side mval[107]
OPT ABSORPTIVITY Optical Absorptivity mval[108]
OPT ABSORPTIVITY REV Optical Apsorptivity, Reverse Side mval[109]
OPT TRANSMISSIVITY SOLAR Optical Solar Transmissivity mval[110]
OPT TRANSMISSIVITY IR Optical InfraRed Transmissivity mval[111]
OPT REFLECTIVITY SOLAR Optical Solar Reflectivity mval[112]
A-8 FEMAP Neutral File Format
OPT REFLECTIVITY SOLAR REV Optical Solar Reflectivity, Reverse Side mval[113]
OPT REFLECTIVITY IR Optical InfraRed Reflectivity mval[114]
OPT REFLECTIVITY IR REV Optical InfraRed Reflectivity, Reverse mval[115]
GAS CONSTANT Fluid Gas Constant mval[116] or
tval[58]
DYNAMIC VISCOSITY Fluid Dynamic Viscosity mval[117] or
tval[59]
PRANDTL NUMBER Prandtl Number mval[118] or
tval[60]
ELECTRICAL RESISTIVITY Electrical Resistivity mval[119]
Function Values
EXPERIMENTAL_FUNCTIONS(i) IDs of Hyperelastic Experimental Data fval[0..4]
Functions
NONLINEAR_FUNCTION ID of function for Plasticity fval[5]
CREEP_FUNCTIONS(i) Tabular Model Creep Function IDs fval[6..8]
DP_YIELD_FUNCTION ID of Drucker-Prager Yield Function fval[9]
OPT EMISSIVITY FUNCTION ID of Optical Emissivity Function fval[10]
OPT_EMISSIVITY REV FUNCTION ID of Optical Emissivity Rev Side fval[11]
Function
OPT ABSORPTIVITY FUNCTION ID of Optical Absorptivity Function fval[12]
OPT ABSORPTIVITY REV FUNC ID of Optical Absorptivity Rev Side fval[13]
Function
OPT TRANSMISSIVITY SOLAR ID of Solar Transmissivity Function fval[14]
FUNC
OPT TRANSMISSIVITY IR FUNC ID of InfraRed Transmissivity Function fval[15]
OPT REFLECTIVITY SOLAR FUNC ID of Solar Reflectivity Function fval[16]
OPT REFLECTIVITY SOLAR REV ID of Solar Reflectivity, Rev Side fval[17]
FUNC Function
OPT REFLECTIVITY IR FUNC ID of InfraRed Reflectivity Function fval[18]
OPT REFLECTIVITY IR REV FUNC ID of InfraRed Reflectivity Rev Side fval[19]
Function
ELECTRICAL RESISTIVITY FUNC ID of Electrical Resistivity Function fval[20]
Property Values
ROD BAR TUBE LINK BEAM SPRING
Type 1 2 3 4 5/ (8.2+)37 6
Flags
(8.2+)
0 cable tapered Bush Csys on(8.3+)
(9.0+)
1 cable gap shape type shape type axial(1)/torsion(0)
2 section method section method A Bush LOC on(8.3+)
3 section method B CBUSH(0)/Other(1
)
Values
0 Area Area Dout Ku_A Area_A Stiffness
1 Cable, (8.2+)Inertia I1 Din Kv_A I1_A Damping
2 I2 Kw_A I2_A Bush Structural
Damping(8.3+)
3 I12 Kthu_A I12_A Bush Location(8.3+)
4 J J Kthv_A J_A Bush Stress TR coef
(8.3+)
(10.2+)
24 J_B
25 K1_B,eff
26 K2_B,eff
27 NSM_B
28 Yf_B1
29 Zf_B1
30 Yf_B2
31 Zf_B2
32 Yf_B3
33 Zf_B3
34 Yf_B4
35 Zf_B4
36 Yoff_B Bush Stiff dof 1
(8.3+)
37 Z_offB Bush Stiff dof 2
(8.3+)
38 Warp_B Bush Stiff dof 3
(8.3+)
39 Bush Stiff dof 4
(8.3+)
40 Std Shape H, Std Std Shape H, Std Bush Stiff dof 5
Shape R Shape R (8.3+)
41 Std Shape W1 Std Shape W1 Bush Stiff dof 6
(8.3+)
42 Std Shape W2 Std Shape W2 Bush Damp dof 1
(8.3+)
43 Std Shape T1 Std Shape T1 Bush Damp dof 2
(8.3+)
44 Std Shape T2 Std Shape T2 Bush Damp dof 3
(8.3+)
45 Std Shape T Std Shape T Bush Damp dof 4
(8.3+)
46 Std Shape SR1 Std Shape SR1 Bush Damp dof 5
(8.3+)
47 Std Shape SR2 Std Shape SR2 Bush Damp dof 6
(8.3+)
48 Std Shape SR3 Std Shape SR3 Bush Stiff vs Freq
dof 1 (8.3+)
49 Std Shape SR4 Std Shape SR4 Bush Stiff vs Freq
dof 2 (8.3+)
50 Std Shape Orient Std Shape Orient Bush Stiff vs Freq
dof 3 (8.3+)
51 Std Shape RefLoc Std Shape RefLoc Bush Stiff vs Freq
dof 4 (8.3+)
52 Shape RefY Shape RefY Bush Stiff vs Freq
dof 5 (8.3+)
53 Shape RefZ Shape RefZ Bush Stiff vs Freq
dof 6 (8.3+)
54 Shape Outline ID Shape Outline ID Bush F/V vs Freq
dof 1 (8.3+)
(8.1+)
55 Std Shape H, Bush F/V vs Freq
Std Shape R(end2) dof 2 (8.3+)
(8.1+)
56 Std Shape Bush F/V vs Freq
W1(end2) dof 3 (8.3+)
(8.1+)
57 Std Shape Bush F/V vs Freq
W2(end2) dof 4 (8.3+)
(8.1+)
58 Std Shape Bush F/V vs Freq
T1(end2) dof 5 (8.3+)
(8.1+)
59 Std Shape Bush F/V vs Freq
T2(end2) dof 6 (8.3+)
(8.1+)
60 Std Shape Bush Force vs Disp
T(end2) dof 1 (8.3+)
FEMAP Neutral File Format A-11
(8.1+)
61 Std Shape Bush Force vs Disp
SR1(end2) dof 2 (8.3+)
(8.1+)
62 Std Shape Bush Force vs Disp
SR2(end2) dof 3 (8.3+)
(8.1+)
63 Std Shape Bush Force vs Disp
SR3(end2) dof 4 (8.3+)
(8.1+)
64 Std Shape Bush Force vs Disp
SR4(end2) dof 5 (8.3+)
(8.1+)
65 Std Shape Bush Force vs Disp
Orient(end2) dof 6 (8.3+)
(8.1+)
66 Std Shape Bush DOF1 Struct
RefLoc(end2) Damp vs Freq
(8.3+)
(8.1+)
67 Shape Bush DOF2 Struct
RefY(end2) Damp vs Freq
(10.2+)
(8.1+)
68 Shape Bush DOF3 Struct
RefZ(end2) Damp vs Freq
(10.2+)
(8.1+)
69 Shape Outline Bush DOF4
ID(end2) Struct Damp vs
Freq (10.2+)
70 Bush DOF5
Struct Damp vs
Freq (10.2+)
71 Bush DOF6
Struct Damp vs
Freq (10.2+)
41 Std Shape W1
42 Std Shape W2
43 Std Shape T1
44 Std Shape T2
45 Std Shape T
46 Std Shape SR1
47 Std Shape SR2
48 Std Shape SR3
49 Std Shape SR4
50 Std Shape Orient
51 Std Shape RefLoc
52 Shape RefY
53 Shape RefZ
54 Shape Outline ID
30 Dyna Type
31 Dyna One Way
32 Dyna Offset
33 Dyna Penalty
34 Dyna Birth
35 Dyna Death
36 Dyna Scale Slave
Penalty Stiffness
37 Dyna Scale Master
Penalty Stiffness
38 Dyna Over Slave
Thick
39 Dyna Over Master
Thick
40 Dyna Scale Slave
Thick
41 Dyna Scale Master
Thick
42 Dyna Scale Coulomb
Friction
43 Dyna Scale Viscous
Friction
44 Dyna Out SF
45 Dyna Out MF
46 Dyna Rigid Func
47 Dyna Rigid Force
48 Dyna Rigid Unload
49 Dyna Tie Norm
50 Dyna Tie Shear
51 Dyna Tie Norm Exp
52 Dyna Tie Shear Exp
53 Dyna Tie Function
54 Dyna Erode Sym
55 Dyna Erode Node
56 Dyna Erode Solid
57 Dyna Constraint
( 10.3+)
58 Dyna Static
Friction Coefficient
( 10.3+)
59 Dyna Dynamic
Friction Coefficient
( 10.3+)
60 Dyna
Exponential Decay
( 10.3+)
61 Dyna Viscous
Friction
( 10.3+)
62 Dyna Viscous
Damping
...
65 Marc Tolerance
66 Marc Sep Force
67 Marc Inter
68 Marc Disp
69 Marc Friction
70 Marc Stick Vel
71 Marc Fr Stress
72 Marc Con Type
73 Marc Con Shell
74 Marc Tol Bias
75 Marc Beam
76 Marc Sep
77 Marc Sep Max
78 Marc Sep Stress
FEMAP Neutral File Format A-15
79 Marc Slip Coeff
80 Marc Slip F
81 Marc Slip Trans
82 Marc Rig Avg
83 Marc Rig Cutoff
( 9.1+)
84 NX/Nas701Pen
Stiff Criteria
( 9.1+)
85 NX/Nas701
Normal Stiffness
( 9.1+)
86 NX/Nas701
Tangent Stiff Criteria
( 9.1+)
87 NX/Nas701
Tangential Stiffness
( 9.1+)
88 NX/Nas701
Damp Method
( 9.1+)
89 NX/Nas701
Damping Coefficient
( 9.1+)
90 NX/Nas701
Contact Type
( 9.1+)
91 NX/Nas701
Double-Sided
( 9.1+)
92 NX/Nas701
Penetration Depth
( 9.1+)
93 NX/Nas701
Segment Normal
( 9.1+)
94 NX/Nas701
Offset Type
( 9.1+)
95 NX/Nas701
Offset Distance
( 9.1+)
96 NX/Nas701
Birth Time
( 9.1+)
97 NX/Nas701
Death Time
( 9.1+)
98 NX/Nas701
Surf Extension Factor
( 9.1+)
99 NX/Nas701
Compliance Factor
100 Sinda Type
101 Sinda Coeff1
102 Sinda View
103 Sinda Coeff2
104 Sinda Cfunc1
105 Sinda Vfunc
106 Sinda Cfunc2
107 Sinda Cfunc3
135 NE/Nastran Scale
Fact
136 NE/Nastran Fric Stiff
137 NE/Nastran Static
Friction
138 NE/Nastran Pen Type
( 9.2+)
139 NE/Nastran Max
Penetration
( 9.2+)
140 NE/Nastran Max
Adjust Ratio
( 9.2+)
141 NE/Nastran Max
Penetration Fraction
( 9.2+)
142 NE/Nastran
Penetration Surface
Offset
( 9.2+)
143 NE/Nastran Max
Activation Distance
( 9.2+)
144 NE/Nastran Max
Activation Distance
(Automatic)
145 NX/Nas601 Type
146 NX/Nas601 NSide
147 NX/Nas601 Birth
Time
148 NX/Nas601 Death
Time
149 NX/Nas601 Initial
Penetration
150 NX/Nas601
Penetration Depth
151 NX/Nas601 Segment
Normal
152 NX/Nas601 Offset
Type
153 NX/Nas601 Offset
Distance
154 NX/Nas601 Initial
Penetration Duration
155 NX/Nas601
Consistent Stiffness
156 NX/Nas601 Tied
157 NX/Nas601 Tied
Tolerance
158 NX/Nas601 Surface
Extension Factor
159 NX/Nas601 Friction
Model
160 NX/Nas601 Fric
Parameter 1
161 NX/Nas601 Fric
Parameter 2
162 NX/Nas601 Fric
Parameter 3
163 NX/Nas601 Fric
Parameter 4
164 NX/Nas601 Fric
Parameter 5
165 NX/Nas601 Eps N
166 NX/Nas601 Eps T
167 NX/Nas601
CFactror1
FEMAP Neutral File Format A-17
168 NX/Nas601
Penetration Tolerance
169 NX/Nas601 Normal
Modulus
170 NX/Nas601
Tangential Modulus
171 NX/Nas601 Min
Tensile Freeing Force
172 NX/Nas601 Max
Total Freeing Force
( 9.3+)
173 NX/Nas601
Disp Formulation
( 9.3+)
174 NX/Nas601
Gap Distance
( 9.1+)
175 NX/Nas101
Max Force Iterations
( 9.1+)
176 NX/Nas101
Max Status Iterations
( 9.1+)
177 NX/Nas101
Normal Penalty
Factor
( 9.1+)
178 NX/Nas101
Tangential Penalty
Factor
( 9.1+)
179 NX/Nas101
Force Convergence
Tol
( 9.1+)
180 NX/Nas101
Number Allow
Contact Changes
( 9.1+)
181 NX/Nas101 Min
Contact Percentage
( 9.1+)
182 NX/Nas101
Shell Offset
( 9.1+)
183 NX/Nas101
Contact Status
( 9.1+)
184 NX/Nas101
Friction
( 9.1+)
185 NX/Nas101 Min
Contact Search Dist
( 9.1+)
186 NX/Nas101
Max Contact Search
Dist
( 9.1+)
187 NX/Nas101
Averaging Method
( 9.1+)
188 NX/Nas101
Initial Penetration
( 9.2+)
189 NX/Nas101
Gluing Search
Distance
( 9.2+)
190 NX/Nas101
Gluing Penalty Factor
( 9.2+)
200 NX/Nas701
Friction
( 9.2+)
201 Marc Friction
( 9.2+)
202 Ansys Friction
...
217 Dyna A Soft
A-18 FEMAP Neutral File Format
Constraint
218 Dyna A Soft
Constraint Scale
Factor
219 Dyna A Airbag Load
Curve ID
220 Dyna A Maximum
Parametric Segment
Search
221 Dyna A Segment
Based Contact
Options
222 Dyna A Search Depth
223 Dyna A Number of
Cycles Between Sorts
(or Frequency Curve
ID x (-1))
224 Dyna A Cycles
Between Contact
Force Updates
225 Dyna B Maximum
Penetration Distance
226 Dyna B Thickness
Option
227 Dyna B Shell
Thickness
Considerations
228 Dyna B Shooting
Node Logic
(0 = Enabled)
229 Dyna B Symmetry
Plane ( 0 = Off)
230 Dyna B Primary
Segment Searching
Option
(0 = 2D; 1 = 3D )
231 Dyna B Solid
Element Thickness
232 Dyna B Solid
Element Stiffness
233 Dyna C Improve
Implicit Convergence
( 1= On; 2= Off )
234 Dyna C Ignore Initial
Penetration Options
235 Dyna C Pentration
Depth Reduction
Factor( or Time
Curve ID x ( -1))
236 Dyna C Stiffness
Time Step ( or Time
Curve ID x (-1))
237 Dyna C Angle
Tolerance for Feature
Lines (radians)
238 Dyna D Split
Quadrilateral Contact
Segments into two
triangles
239 Dyna D Time Interval
between Shell
Penetration Reports
240 Dyna D Scale Factor
for Neighbor Segment
FEMAP Neutral File Format A-19
Contact
241 Dyna D Incremental
Displacement Update
for Tied Contacts
242 Dyna ABCD Level
( 10.3+)
243 NE/Nastran
Maximum Normal
Activation Distance
( 10.3+)
244 NE/Nastran
Maximum Radial
Activation Distance
( 10.3+)
245 NE/Nastran
Maximum Allowable
Slip
( 10.3+)
246 NE/Nastran
MAXAD or
MAXNAD/MAXRA
D toggle
For Bars, Beams and Curved Beams, where shapes are available, flag[1] defines the type of shape selected.
Available values are:
Value Shape Value Shape Value Shape Value Shape
1 Rectangular Bar 5 Circular Bar 9 I 13 Z
2 Rectangular Tube 6 Circular Tube 10 Channel 14 Hat
3 Trapezoidal Bar 7 Hex Bar 11 Angle 15 General
4 Trapezoidal Tube 8 Hex Tube 12 T
The following types are also available: Plot Only (10), Plot Plate(32), Axisymmetric (23/24), Solid (25/26), and
Rigid (29). When two types are listed, the first number corresponds to a linear type, the second to a parabolic type.
Data Block 403 - Nodes
Record Field Description Size
1 ID ID of node 4 byte, long integers
define_sys ID of definition coordinate system
output_sys ID of output coordinate system
layer ID of layer
color ID of color
permbc[0..5] the six permanent constraints (0=free,1=fixed) 2 byte, boolean
x Coordinates of node in Global Rectangular 8 byte, double precision
coordinate system
y
z
(4.4+)
node_type Type of Node (0=Node, 1=Scalar, 2=Extra) 4 byte, long integer
(9.3+)
superelementID ID of Superelement that contains this node 4 byte, long integer
(9.1+)
connectSEG[0..1] Node, Element or Property ID for weld patch 4 byte, long integers
A and B respectively for individual of weld
types.
1 record for ndtempID ID for nodal temperature. Must be -1 for last 4 byte, long integer
each nodal record.
temp plus last
color ID of color
layer ID of layer
ndtemp Nodal Temperature 8 byte, double precision
ndtemp_co Unused
(4.3+)
ndt_funcID ID of function for Node Temp 4 byte, long integer
FEMAP Neutral File Format A-27
1 record for eltempID ID for elemental temperature. Must be -1 for 4 byte, long integer
each element last record.
temp plus last
color ID of color
layer ID of layer
eltemp Elemental Temperature 8 byte, double precision
eltemp_co Unused
(4.3+)
elt_funcID ID of function for ElemTemp 4 byte, long integer
[2]=Temp vs Temp
[3]=View Factor vs Time
[4]=Phase vs. Freq
1 record per Enclosure Radiation Enclosure Radiation on or off 2 byte, boolean
load can_shade Flags for View Factor Shading Calculations
can_be_shaded
1 record per dir_func[0..2] Vector Flux Time Dependence Functions 4 byte, long integer
load
1 record per direction[0..2] Vector Flux Initial Directions 8 byte, double precision
load
1 record for loadID Node or element ID where load is applied. 4 byte, long integer
each geometry loadID must be -1 for the last record.
based load loadtype See table for types of Geometry Loads
plus final color ID of color
layer ID of layer
define_sys Definition coordinate system for load
subtype Flag that indicates Forced Convection, Vector
Flux or Enclosure Radiation if nonzero
is_expanded is 1 if load was expanded from a geometry 2 byte Boolean
load
(9.3+)
nLoadDefID The ID of the load definition that contains this 4 byte, long integer
load (0=None)
1 record for dof_face[0..2] x,y,z load values on/off 2 byte Boolean
each load
1 record per value[0..4] Single element value [0], x, y, z values[0..2], 8 byte, double precision
load
1 record per functions[0..4] [0]=Load func, Emissivity func 4 byte, long integer
load [1]=Absorbtivity vs. Temp
[2]=Temp vs Temp
[3]=View Factor vs Time
[4]=Phase vs. Freq
(9.3+)
datasurfs[0..4] ID of Data Surface assigned to individual load 4 byte, long integer
values
1 record per Enclosure Radiation Enclosure Radiation on or off 2 byte, boolean
load can_shade Flags for View Factor Shading Calculations
can_be_shaded
addl_id [0..1] Additional Node IDs used for Nonlinear 4 byte, long integer
Transient Loads
1 record per dir_func[0..2] Vector Flux Time Dependence Functions 4 byte, long integer
load
1 record per direction[0..2] Vector Flux Initial Directions 8 byte, double precision
load
View Option Draw, Label, Color and Color Mode Array Indexes
Labels, Entities and Colors Tools and View Style PostProcessing
Label Parameters 0 Free Edge and Face 22 Post Titles 40
Coordinate System 1 Shrink Elements 23 Deformed Style 41
Point 2 Fill, Backfaces and Hidden 25 Vector Style 42
Curve 3 Filled Edges 26 Animated Style 43
Combined Curve 95 Render Options 77 Deformed Model 44
Curve - Mesh Size 24 Transparency 92 Undeformed Model 45
FEMAP Neutral File Format A-41
Options for ABAQUS Solver (if analysis set type set to ABAQUS)
1 on 2 byte boolean
2 time_period 8 byte, double precision
initial_time_increment
min_time_increment
max_time_increment
3 num_eigvectors
min_frequency 8 byte, double precision
max_frequency
shift_frequency
scale_factor
4 output_intervals 4 byte, long integer
nonlinear_geometry 2 byte boolean
linear_perturbation
auto_contact
stabilize_contact
write_zero_increment
5 step_amplitude 2 byte unsigned
step_op
step_op_bc
analysis_case_solution 4 byte unsigned
slide_distance 2 byte boolean
Options for ANSYS Solver (if analysis set type set to ANSYS)
1 MDOF_on 2 byte boolean
2 MDOF_do_set
MDOF_automatic
MDOF_exclude_rotations
MDOF_set 4 byte, long integer
MDOF_number_of_dof
3 MODAL_on 2 byte boolean
4 MODAL_num_modes 4 byte, long integer
MODAL_min_freq 8 byte, double precision
MODAL_max_freq
MODAL_element 2 byte boolean
MODAL_method 8 byte, double precision
5 HEAT_on 2 byte boolean
6 HEAT_end_time 8 byte, double precision
HEAT_time_step
HEAT_output_freq 4 byte, long integer
Options for MSC.MARC Solver (if analysis set type set to MSC.MARC) Version 8.2 and later..
1 Marc History On 2 byte Boolean
2 Contact_Property 4 byte, long integer
Control_Method
Solver_Method
Control_Max_Steps
Control_Max_Recycles
Control_Min_Recycles
3 Max_Residual 8 byte, double precision
Convergence_Method 4 byte, long integer
A-52 FEMAP Neutral File Format
PARAMcntaset
unused_real 8 byte, double precision
unused_real
NasBu5 Skip_standard 2 byte boolean
NasBu6 Nlines_start_text Number of lines of starting text 4 byte, long integer
FEMAP Neutral File Format A-55
NasBu7+ Start_text starting text if nlines_start_text > 0 Character string(s)
NasBu8 Nlines_end_text Number of lines of ending text 4 byte, long integer
NasBu9+ End_text Ending text if nlines_end_text > 0 Character string(s)
NasNL1 Nonlin_on 2 byte boolean
NasNL2 NDT 4 byte, long integer
DT 8 byte, double precision
NO 4 byte, long integer
MAXITER 4 byte, long integer
NasNL3 EPS_flag[0..2] 2 byte boolean
EPS[0..2] 8 byte, double precision
NasNL4 (11.1+) nl_KDAMP 2 byte boolean
nl_KUPDATE 4 byte, long integer
NasMd1 Modes_on 2 byte boolean
NasMd2 eigr_set 4 byte, long integer
modal_method 4 byte, long integer
dynam_solution_typ 2 byte boolean
frequency_range[0..1] 8 byte, double precision
(v9.3+)
Skip_eigr 2 byte boolean
(v9.3+)
imaginary_freq_range[0.. 8 byte, double precision
1]
(v9.3+)
complex_convergence 8 byte, double precision
(v9.3+)
complex_region_width 8 byte, double precision
NasMd3 estimated_roots 4 byte, long integer
desired_roots 4 byte, long integer
normalization_option 4 byte, long integer
normalization_node 4 byte, long integer
normalization_dof 4 byte, long integer
modal_mass_formulation 2 byte boolean
(v8.1+)
NasMxy1 On 2 byte boolean
(v8.1+) (v8.3+)
NasMxy2 Output_request[0..4] 4 byte, long integer
was [0..3] in (v8.1+)
NasMCheck2 Weight_dof_set[n]
N=0 to 5 (8.2+)
NasMCheck3 weight_cgi
8.2+)
weight_ref_node 4 byte, long integer
weight_units
ground_ref_node
NasMCheck4 ground_dof_set[n] 2 byte boolean
N=0 to 4 (8.2+)
NasMCheck5 max_strain_energy 8 byte, double precision
(8.2+)
Datarec_on 2 byte boolean
Datarec_tol 0(11.2+) 4 byte, long integer
FEMAP Neutral File Format A-57
NasNXNL1(9.0+) NXNL_On 2 byte boolean
NasNXNL2(9.0+) Max_Time_Steps 4 byte, long integer
NasNXNL3(9.0+) Number of Time Steps[0] 4 byte, long integer
Time Increment[0] 8 byte, double precision
Skip Factor[0] 4 byte, long integer
Number of Time Steps[9] 4 byte, long integer
Time Increment[9] 8 byte, double precision
Skip Factor[9] 4 byte, long integer
NasNXNL4(9.0+) SOLVER 4 byte, long integer
AUTO Auto Incrementation 4 byte, long integer
NPOSIT Continue when not positive definite 2 byte boolean
MASSTYP Mass Matrix Type 2 byte boolean
TINT Integration order thru Shell thick 4 byte, long integer
MSTAB Matrix Stabilization 2 byte boolean
MSFAC Matrix Stabilization Factor 8 byte, double precision
DTDELAY Element Death Time delay 8 byte, double precision
SDOFANG Shell DOF Angle 8 byte, double precision
UPFORM u/p formulation 2 byte boolean
NasNXNL5(9.0+) DISPOPT Prescribed displacement option 2 byte boolean
LOADOPT Applied Load option 2 byte boolean
ALPHA Newmark Time Integ alpha coeff 8 byte, double precision
DELTA Newmark Time Integ delta coeff 8 byte, double precision
ITEMAX Max iter for multigrid solver 4 byte, long integer
EPSIA Convergence Tolerance epsia 8 byte, double precision
EPSIB Convergence Tolerance epsib 8 byte, double precision
EPSII Convergence Tolerance epsii 8 byte, double precision
LSEARCH Line Search Flag 4 byte, long integer
MAXITE Max Iter per time step 4 byte, long integer
(9.0+)
NasNXNL6 CONVCRI Convergence Critieria 4 byte, long integer
ETOL Relative Energy Tolerance 8 byte, double precision
RTOL Relative Force Tolerance 8 byte, double precision
RNORM Reference Force 8 byte, double precision
RMNORM Reference Moment 8 byte, double precision
RCTOL Relative Contact Force Tolerance 8 byte, double precision
DTOL Relative Displacement Tolerance 8 byte, double precision
DNORM Reference Translation 8 byte, double precision
DMNORM Reference Rotation 8 byte, double precision
STOL Line Search Convergence Tolerance 8 byte, double precision
(9.0+)
NasNXNL7 RCONSM Reference Contact Force 8 byte, double precision
ENLSTH Line Search Energy Threshold 8 byte, double precision
ATSSUBD Auto Time Step Small Step Size 4 byte, long integer
ATSMXDT Auto Time Step Largest Step Size 8 byte, double precision
ATSNEXT Auto Time Step Size Flag 4 byte, long integer
ATSDFAC Division Factor for Sub Increment 8 byte, double precision
ATSLOWS Low Speed Dynamics Flag 2 byte boolean
ATSDAMP Low Speed Dynamics Damping Fac 8 byte, double precision
LDCGRID Node ID for Prescribed Displace 4 byte, long integer
LDCDOF DOF for Prescribed Displacement 4 byte, long integer
NasNXNL8(9.0+) LDCDISP Magnitude of Prescribed Displace 8 byte, double precision
LDCIMAX Displacement Convergence Factor 8 byte, double precision
LDCDMAX Max Displacement 8 byte, double precision
A-58 FEMAP Neutral File Format
Contact Options for MSC/Nastran Solver (if analysis set type set to MSC/Nastran) (v11.2+ only)
NasMSCCt1 on 2 byte Boolean
bEnabled 2 byte Boolean
NasMSCCt2 DDULMT 8 byte, double precision
RVCNST
SLDLMT
NasMSCCt3 TAUGMNT 2 byte Boolean
AUGMENT 4 byte, long integer
NasMSCCt4 BEAMB 2 byte Boolean
ERRBAS
FTYPE 4 byte, long integer
IBSEP
ICSEP
MAXSEP
NasMSCCt5 METHOD 4 byte, long integer
NLGLUE 2 byte Boolean
NODSEP 4 byte, long integer
SEGSYM 2 byte Boolean
NasMSCCt6 AUGDIST 8 byte, double precision
BIAS
ERROR
FNTOL
PENALT
STKSLP
TPENALT
Options for NASTRAN Solver (if analysis set type set to NASTRAN) (v11.2+ only)
NasParam1 MGRID 2 byte Boolean
SWPANGLE 2 byte Boolean
ALPHA1
ALPHA2
MGRID 4 byte, long integer
FEMAP Neutral File Format A-63
MDOF
NasParam2 dSWPANGLE 8 byte, double precision
dALPHA1[0..1]
dALPHA2[0..1]
Options for ABAQUS Solver (if analysis set type set to ABAQUS) (v8.1+ only)
Ab1 on 2 byte boolean
version 4 byte, long integer
Ab2 titles_as_set_names 2 byte boolean
write_group_as_sets
Ab3 skip_standard
Ab4 Nlines_start_text Number of lines of starting text 4 byte, long integer
Ab5+ Start_text starting text if nlines_start_text > 0 Character string(s)
Ab6+ Nlines_end_text Number of lines of ending text 4 byte, long integer
Ab7+ End_text Ending text if nlines_end_text > 0 Character string(s)
Options for ANSYS Solver (if analysis set type set to ANSYS) (v8.1+ only)
An1 model_on 2 byte boolean
version 4 byte, long integer
An2 titles_as_set_names 2 byte boolean
write_group_as_sets 2 byte boolean
(11.0+)
skip preprocess command 2 byte boolean
An3 title Character string(s)
An4 write_solution_commands 2 byte boolean
write_iterative_commands
use_large_deformations
analysis_memory 4 byte, long integer
An5 skip_standard 2 byte boolean
An6 Nlines_start_text Number of lines of starting text 4 byte, long integer
An7+ Start_text starting text if nlines_start_text > 0 Character string(s)
An8 Nlines_end_text Number of lines of ending text 4 byte, long integer
An9+ End_text Ending text if nlines_end_text > 0 Character string(s)
An10 random_on 2 byte boolean
An11 random_disp_on
random_vel_on
random_accel_on
random_disp_relative
Random_vel_relative
Random_accel_relative
Options for FEMAP Structural Solver (if analysis set type set to FEMAP Structural)
Fsfil1 File_on 2 byte boolean
Fsfil2 logfile
Fsfil3 keep_logfile 2 byte boolean
echo_to_logfile 2 byte boolean
Fsfil4 hypermatrix1 Character string
Fsfil5 hypermatrix2 Character string
Fsfil6 keep_hypermatrix 2 byte boolean
Fsfil7 scratch1 Character string
Fsil8 scratch2 Character string
Fsdyn1 Dyn_on 2 byte boolean
Fsdyn2 solution_method 4 byte, long integer
mass_formulation 2 byte boolean
modal_damping 2 byte boolean
modal_normalization 2 byte boolean
A-64 FEMAP Neutral File Format
Options for MSC.MARC Solver (if analysis set type set to MSC.MARC) Version 8.2 and later..
Mar1 on 2 byte boolean
Mar2 skip_standard
Mar3 Nlines_start_text Number of lines of starting text 4 byte, long integer
Mar4+ Start_text starting text if nlines_start_text > 0 Character string(s)
Mar5+ Nlines_end_text Number of lines of ending text 4 byte, long integer
Mar6+ End_text Ending text if nlines_end_text > 0 Character string(s)
Mar7 Title Character string(s)
Mar8 work_space_vector 4 byte, long integer
max_constraints
Mar9 follower_on 2 byte boolean
follower_option 4 byte, long integer
plasticity_on 2 byte boolean
plasticity_option 4 byte, long integer
elasticity_on 2 byte boolean
elasticity_total
is_elastic
constant_dilation
large_displacement
update
FEMAP Neutral File Format A-65
finite
Mar10 echo_input_data
write_group_sets
extended_input
shell_transverse_shear
plate_integration_points 4 byte, long integer
Mar11 dist_loads_on 2 byte boolean
dist_loads_list 4 byte, long integer
dist_loads_elems
dist_loads_nodes
tying_on 2 byte boolean
tying_ce 4 byte, long integer
tying_type
tying_servo_nodes
tying_servo_link
Mar12 out_of_core 2 byte boolean
core_value 4 byte, long integer
processors 2 byte boolean
No_cpu 4 byte, long integer
vector_length
parallel 2 byte boolean
bandwidth_optimization
Options for LS-DYNA3D Solver (if analysis set type set to LS-DYNA3D) Version 9.2 and later..
Dyn1 on 2 byte boolean
Dyn2 export_rigid_nodes 2 byte boolean
material_based_parts 2 byte boolean
write_groups_as_sets 2 byte Boolean
Dyn3 skip_standard 2 byte boolean
Dyn4 Nlines_start_text Number of lines of starting text 4 byte, long integer
Dyn5+ Start_text starting text if nlines_start_text > 0 Character string(s)
Dyn6+ Nlines_end_text Number of lines of ending text 4 byte, long integer
Dyn7+ End_text Ending text if nlines_end_text > 0 Character string(s)
Output Components
The components are 20 Vector IDs of other vectors that are "components" of the current vector. There are several
possible ways these components are used:
1. THE CURRENT VECTOR CONTAINS THE VECTOR MAGNITUDE OF 3 OTHER VECTORS THAT ARE
THE GLOBAL X,Y, AND Z COMPONENTS OF SIMILAR DATA:
In this case Components 0, 1, and 2 are the Vector IDs of the X, Y, and Z component Vectors respectively. An
example of this type of usage is Vector 1 (TOTAL TRANSLATION) which has Component 0=2(X
TRANSLATION), Component 1=3(Y TRANSLATION) and Component 2=4(Z TRANSLATION). These
A-76 FEMAP Neutral File Format
components MUST be defined for deformed/animated plotting to work correctly. Components 3 through 19 must be
0 for this case.
2. THE CURRENT VECTOR CONTAINS DATA WHICH SHOULD BE PLOTTED IN A SPECIFIC GLOBAL
DIRECTION:
In this case, if plotting should occur in Global X then Component 0 must equal the current Vector ID. If Global Y,
then Component 1 = current Vector ID, and if Global Z then Component 2 = current Vector ID. All other
Components must equal 0 (i.e. only 1 nonzero component and it is equal to the current Vector ID).
3. THE CURRENT VECTOR CONTAINS ELEMENTAL CENTROIDAL DATA FOR ELEMENTS WHICH
ALSO HAVE RELATED DATA AT THE ELEMENT CORNERS:
In this case, the number of nonzero components depends upon the number of nodes on this element type (for
example, output for linear plates has 4 components-4 nodes/corners). The nonzero components must equal the
Vector IDs of the same type of data at the corners of the elements. For example, if the current vector is 7033
(CENTROIDAL VON MISES STRESS) then component 0 may be 20133 (CORNER1 VON MISES STRESS) and
component 1 may be 30133 (CORNER2 VON MISES STRESS) etc... If you do not have corner data, all
components must be 0. If the components are defined, FEMAP will use the corner data (not the data in the current
vector) when calculating data at nodes (like for contouring). If no components are defined, FEMAP will
assign the centroidal value to each node when doing the calculation.
4. THE CURRENT VECTOR CONTAINS LINE ELEMENT DATA AT ONE END OF THE ELEMENT.
This is just like the previous case. The first component is the vector ID of the End A data, the second component is
the vector ID of the End B data. This type of output also requires special settings in the "comp_dir" variable. Set
"comp_dir" to 2 if you want FEMAP to use the data as it is specified. Set "comp_dir" to 3 if you want FEMAP to
reverse the sign of all End B data when doing a Beam Diagram. This adjusts for differences in sign conventions
between the various analysis programs.
5. ALL OTHER CASES:
All components should be 0. This will force the data in the current vector to be used for every case. The current
setting of the View Option Deformed Style - Deformed Direction option, will control the Deformed plotting
direction.
[ID]
Name=material type name
FieldID[,minVAL,maxVAL]=field title
FieldID[,minVAL,maxVAL]=field title
Blank=
FieldID[,minVAL,maxVAL]=field title
[ID]
This is the material subtype number. These must be unique in your material definition file. If you are going to define materials
for other than personal use, contact ESP to be assigned a range of subtypes. Doing this eliminates conflicts between various
definitions of materials by different people.
Name=title
Here you define the title that is displayed in the FEMAP list of available material types. The title must be enclosed in quotes.
FieldID=field title
These are the actual data definition records for this material. One record is required for each data item that you want for this
material type. Data fields will be displayed in the material creation dialog box in the order that you specify them in this file.
The FieldID value specifies both the type of data (R=real value, I=integer value, F=function value, A=text only) and the
location in the data arrays to store the value. For example R53 means select a real number and store it in mval[53], I15 means
select an integer and store it in ival[15]. Allowable FieldIDs are in the range R0 thru R199, I0 thru I24 and F0 thru F49. If
you start the FieldID with an A, you can specify any number. In this case, only the associated title will be displayed, the
input field will be hidden, and no data will be stored. The field title is the text that is displayed next to this data field in the
material creation dialog box. You will have to limit this text to around 25 characters or less, due to limited space in the dialog
box.
FieldID,minVAL,maxVAL=field title
The simplest way to specify a data field was the previous one given above, however this will allow any value to be entered for
the data. If you want to restrict input to a certain range of values, you can use the format shown here. You must specify both
the minVAL (minimum) and maxVAL (maximum) values that you will accept. When a user is creating a material of this type
only values between this range will be allowed.
Blank=
This record is simply used to skip a space in the dialog box. It can be used to separate groups if similar input. No user input
will be allowed from this position in the dialog.
To define a material type, simply create a new section in the material definition file. Make sure you choose a subtype ID that
is not currently being used. The next record must be present and must be the Name definition. Then simply add as many
field records as you need to collect the data for your material.
You can define multiple material definition files and select them through the File Preferences Libraries option.