2.3 Creating an input file

The simulation of the pin-jointed, overhead hoist in Figure 2–1 is used to illustrate the creation of an ABAQUS input file using an editor. As you read through this section, you should type the data into a file using one of the editors available on your computer. The ABAQUS input file must have a .inp file extension. For convenience, name the input file frame_xpl.inp. The file identifier, which can be chosen to identify the analysis, is called the jobname. In this case use the jobname “frame_xpl” to easily associate it with the input file called frame_xpl.inp.

All of the other examples in this guide assume that you will be using a preprocessor, such as ABAQUS/CAE, to generate the mesh if you are going to create the model from scratch. Input files for all the examples are available. See Execution procedure for ABAQUS/Fetch, Section 3.2.12 of the ABAQUS Analysis User's Manual, for instructions on how to retrieve these input files. However, since the purpose of this example is to help you understand the structure and format of the ABAQUS input file, you should type this input file in directly, rather than use a preprocessor or copy the input file that is provided.


2.3.1 Units

Before starting to define this or any model, you need to decide which system of units you will use. ABAQUS has no built-in system of units. All input data must be specified in consistent units. Some common systems of consistent units are shown in Table 2–1.

Table 2–1 Common systems of consistent units.

QuantitySISI (mm)US Unit (ft)US Unit (inch)
Lengthmmmftin
ForceNNlbflbf
Masskgtonne (103 kg)sluglbf s2/in
Timessss
StressPa (N/m2)MPa (N/mm2)lbf/ft2psi (lbf/in2)
EnergyJmJ (10–3 J)ft lbfin lbf
Densitykg/m3tonne/mm3slug/ft3lbf s2/in4

The SI system of units is used throughout this guide. Users working in the systems labeled “US Unit” should be careful with the units of density; often the densities given in handbooks of material properties are multiplied by the acceleration due to gravity.


2.3.2 Coordinate systems

You also need to decide which coordinate system to use. The global coordinate system in ABAQUS is a right-handed, rectangular (Cartesian) system. For this example define the global 1-axis to be the horizontal axis of the hoist and the global 2-axis to be the vertical axis (Figure 2–3). The global 3-axis is normal to the plane of the framework. The origin (=0, =0, =0) is the bottom left-hand corner of the frame.

Figure 2–3 Coordinate system and origin for model.

For two-dimensional problems, such as this one, ABAQUS requires that the model lie in a plane parallel to the global 1–2 plane.


2.3.3 Mesh

You must select the element types and design the mesh. Creating a proper mesh for a given problem requires experience. For this example you will use a single truss element to model each member of the frame, as shown in Figure 2–4.

Figure 2–4 Finite element mesh.

A truss element, which can carry only tensile and compressive axial loads, is ideal for modeling pin-jointed frameworks, such as the overhead hoist. Truss elements are described in Chapter 4, Finite Elements and Rigid Bodies,” and also in the ABAQUS Analysis User's Manual, which describes every element available in ABAQUS/Explicit. The index of element types (Section I.2, ABAQUS/Explicit Element Index,” of the ABAQUS Analysis User's Manual) makes locating a particular element easy. Whenever you are using an element for the first time, you should read the description, which includes the element connectivity and any element section properties needed to define the element's geometry.

The connectivity for the truss elements used in the overhead hoist model is shown in Figure 2–5.

Figure 2–5 Connectivity for the 2-node truss element (T2D2).

Node and element numbers are merely identification labels. They are usually generated automatically by ABAQUS/CAE or another preprocessor. The only requirement for node and element numbers is that they must be positive integers. Gaps in the numbering are allowed, and the order in which nodes and elements are defined does not matter. Any nodes that are defined but not associated with an element are removed automatically and are not included in the simulation.

In this case we use the node and element numbers shown in Figure 2–6.

Figure 2–6 Node and element numbers for the hoist model.


2.3.4 Model data

The first part of the input file must contain all of the model data. These data define the structure being analyzed. In the overhead hoist example the model data consist of the following:

  • Geometry:

    • Nodal coordinates.

    • Element connectivity.

    • Element section properties.

  • Material properties.

Heading

The first option in any ABAQUS input file must be *HEADING. The data lines that follow the *HEADING option are lines of text describing the problem being simulated. You should provide an accurate description to allow the input file to be identified at a later date. Moreover, it is often helpful to specify the system of units, directions of the global coordinate system, etc. For example, the *HEADING option block for the hoist problem contains the following:

*HEADING
Two-dimensional overhead hoist frame
SI units (kg, m, s, N)

Data file printing options

By default, ABAQUS will not print an echo of the input file or the model and history definition data to the printed output (.dat) file. However, it is recommended that you check your model and history definition in a datacheck run before performing the analysis. The datacheck run is discussed later in this chapter.

To request a printout of the input file and of the model and history definition data, add

*PREPRINT, ECHO=YES, MODEL=YES, HISTORY=YES
to the input file.

Nodal coordinates

The coordinates of each node can be defined once you select the mesh design and node numbering scheme. For this problem use the numbering shown in Figure 2–6. The coordinates of nodes are defined using the *NODE option, and the value of the NSET parameter defines the name of the node set to which the nodes belong. Each data line of this option block has the form

node number,-coordinate,-coordinate,-coordinate

The nodes for the hoist model belong to the node set NALL, and they are defined as follows:

*NODE, NSET=NALL
101, 0., 0., 0.
102, 1., 0., 0.
103, 2., 0., 0.
104, 0.5, 0.866, 0.
105, 1.5, 0.866, 0.

Element connectivity

The members of the overhead hoist are modeled with truss elements. The format of each data line for a truss element is

<element number>, <node 1>, <node 2>
where node 1 and node 2 are at the ends of the element (see Figure 2–5). For example, element 16 connects nodes 103 and 105 (see Figure 2–6), so the data line defining this element is
16, 103, 105
The TYPE parameter on the *ELEMENT option must be used to specify the kind of element being defined. In this case you will use T2D2 truss elements.

One of the most useful features in ABAQUS is the availability of node and element sets that are referenced by name. By using the ELSET parameter on the *ELEMENT option, all of the elements defined in the option block are added to an element set called FRAME. A set name can have as many as 80 characters and must start with a letter. Since element section properties are assigned through element set names, all elements in the model must belong to at least one element set.

The complete *ELEMENT option block for the overhead hoist model (see Figure 2–6) is shown below:

*ELEMENT, TYPE=T2D2, ELSET=FRAME
11, 101, 102
12, 102, 103
13, 101, 104
14, 102, 104
15, 102, 105
16, 103, 105
17, 104, 105

Element section properties

Each element must reference an element section property. The appropriate element section option for each element and the additional geometric data (if any) needed for each element are described in the ABAQUS Analysis User's Manual.

For the T2D2 element you must use the *SOLID SECTION option and give one data line with the cross-sectional area of the element. If you leave the data line blank, the cross-sectional area is assumed to be 1.0.

In this case all the members are circular bars that are 5 mm in diameter. Their cross-sectional area is 1.963 × 10–5 m2.

The MATERIAL parameter, which is required for most element section options, references the name of a material property definition that is to be used with the elements. The name can have up to 80 characters and must begin with a letter.

In this example all of the elements have the same section properties and are made of the same material. Typically, there will be several different element section properties in an analysis; for example, different components in a model may be made of different materials. The elements are associated with material properties through element sets. For the overhead hoist model the elements were included in an element set called FRAME. Element set FRAME is then used as the value of the ELSET parameter on the element section option. Add the following option block to your input file:

Materials

One of the features that makes ABAQUS easy to use is that almost any material model can be used with any element. Once the mesh has been created, material models can be associated, as appropriate, with the elements in the mesh.

ABAQUS has a large number of material models, many of which include nonlinear behavior. In this overhead hoist example we use the simplest form of material behavior: linear elasticity. A discussion of all the material models available in ABAQUS/Explicit can be found in the ABAQUS Analysis User's Manual.

Linear elasticity is appropriate for many materials at small strains, particularly for metals up to their yield point. It is characterized by a linear relationship between stress and strain (Hooke's law), as shown in Figure 2–7.

Figure 2–7 Linear elastic material.

The material behavior is characterized by two constants: Young's modulus, , and Poisson's ratio, .

A material definition in the ABAQUS input file starts with a *MATERIAL option. The parameter NAME is used to associate a material with an element section property. For example,

Material suboptions directly follow their associated *MATERIAL option. Several suboptions may be required to complete the material definition. All material suboptions are associated with the material that is listed on the most recent *MATERIAL option until another *MATERIAL option or a non-material option block is given.

Without considering thermal expansion effects (which would be defined with the *EXPANSION material option), two material options, *ELASTIC and *DENSITY, are required to define a linear elastic material. The form of this option block is the following:

*ELASTIC
<>,<>
*DENSITY
<>,
Therefore, the complete, isotropic, linear elastic material definition for the hoist members, which are made of steel, should be entered into your input file as
*MATERIAL, NAME=STEEL
*ELASTIC
200.E9, 0.3
*DENSITY
7800.,

The model definition portion of this problem is now complete since all the components describing the structure have been specified.


2.3.5 History data

The history data define the sequence of events for the simulation. This loading history is divided into a series of steps, each defining a different stage in the structure's loading. Each step contains the following information:

  • The type of simulation (dynamic, fully coupled thermal-stress, or anneal).

  • The loads and constraints.

  • The output required.

In this example we are interested in the dynamic response of the overhead hoist to a suddenly applied load of 10 kN at the center, with the left-hand end fully constrained and a roller constraint on the right-hand end (see Figure 2–1). This loading is a single event, so only a single step is needed for the simulation.

The *STEP option is used to mark the start of a step. Like the *HEADING option, this option may be followed by data lines containing a title for the step. You can choose whether or not to include nonlinear geometric effects in the analysis by setting the NLGEOM parameter equal to YES or NO. The default is YES. In your hoist model use the following *STEP option block:

*STEP
10kN central load

Analysis procedure

The analysis procedure (the type of simulation) must be defined immediately following the *STEP option block. In ABAQUS/Explicit the three analysis options are *DYNAMIC, EXPLICIT; *DYNAMIC TEMPERATURE-DISPLACEMENT, EXPLICIT; and *ANNEAL. The *DYNAMIC TEMPERATURE-DISPLACEMENT procedure simulates the fully coupled thermal-mechanical response of a body, while the *ANNEAL procedure simulates the relaxation of stresses and plastic strains that occurs as metals are heated to a high temperature. In this simulation we want to determine the dynamic response of the structure over a period of 0.01 s. Thus, we will use *DYNAMIC, EXPLICIT. Add the following lines to your input file:

*DYNAMIC, EXPLICIT
, 0.01

The remaining input data in the step define the boundary conditions, loads, and desired output and can be given in any convenient order.

Boundary conditions

Boundary conditions are applied to those parts of the model where the displacements are known. Such parts may be constrained to remain fixed (have zero displacement) during the simulation or may have specified, nonzero displacements. In either situation the constraints are applied directly to the nodes of the model.

In some cases a node may be constrained completely and, thus, cannot move in any direction (for example, node 101 in our case). In other cases a node is constrained in some directions but is free to move in others. For example, node 103 is fixed in the vertical direction but is free to move in the horizontal direction. The directions in which a node is able to move are called degrees of freedom (dof). In the case of our two-dimensional hoist, each node can move in the global 1- and 2-directions; therefore, there are two degrees of freedom at each node. If the hoist could move out of plane, the problem would be three-dimensional, and each node would have three degrees of freedom. Nodes attached to beam and shell elements have additional degrees of freedom representing the components of rotation and, thus, may have up to six degrees of freedom.

The labeling convention used for the degrees of freedom in ABAQUS is shown in Figure 2–8.

Figure 2–8 Labeling convention for degrees of freedom.

The degrees of freedom active at a node depend on the type of elements attached to that node. The two-dimensional truss element, T2D2, has two degrees of freedom active at each node: translation in the 1- and 2-directions (dof 1 and dof 2).

Constraints on nodes are defined by using the *BOUNDARY option and specifying the constrained degrees of freedom. Each data line is of the form

<node number>, <first dof>, <last dof>, <magnitude of displacement>

The first degree of freedom and last degree of freedom are used to give a range of degrees of freedom that will be constrained. For example,

101, 1, 3, 0.0
constrains degrees of freedom 1, 2, and 3 at node 101 to have zero displacement (the node cannot move in any of the global 1-, 2-, or 3-directions).

If the magnitude of the displacement is not specified on the data line, it is assumed to be zero. If the node is constrained in one direction only, the third field should be blank or equal to the second field. For example, to constrain node 103 in the 2-direction (degree of freedom 2) only, any of the following data line formats can be used:

103, 2, 2, 0.0
or
103, 2, 2
or
103, 2

Boundary conditions on a node are cumulative. Thus, the following input constrains node 101 in both directions 1 and 2:

101, 1
101, 2

Rather than specifying each constrained degree of freedom, some of the more common constraints can be given directly using the following named constraints:

ENCASTREConstraint on all displacements and rotations at a node.
PINNEDConstraint on all translational degrees of freedom.
XSYMMSymmetry constraint about a plane of constant .
YSYMMSymmetry constraint about a plane of constant .
ZSYMMSymmetry constraint about a plane of constant .
XASYMMAntisymmetry constraint about a plane of constant .
YASYMMAntisymmetry constraint about a plane of constant .
ZASYMMAntisymmetry constraint about a plane of constant .
Thus, another way to constrain all the active degrees of freedom at node 101 in the hoist model is
101, ENCASTRE

The complete *BOUNDARY option block for our hoist problem is

*BOUNDARY
101, ENCASTRE
103, 2

In this example all of the constraints are in the global 1- or 2-directions. In many cases constraints are required in directions that are not aligned with the global directions. The *TRANSFORM option can be used in such cases to define a local coordinate system for boundary condition application.

Loading

Loading is anything that causes the displacement or deformation of the structure, including:

  • concentrated loads;

  • pressure loads;

  • distributed traction loads,

  • distributed edge loads and moment on shells,

  • nonzero boundary conditions;

  • body loads; and

  • temperature (with thermal expansion of the material defined).

In reality there is no such thing as a concentrated, or point, load; the load will always be applied over some finite area. However, if the area being loaded is similar to or smaller than the elements in that area, it is an appropriate idealization to treat the load as a concentrated load applied to a node.

Concentrated loads are specified using the *CLOAD option. The data lines for this option have the form

<node number>, <dof>, <load magnitude>
In this simulation a load of –10 kN is applied in the 2-direction to node 102. The option block is the following:
*CLOAD
102, 2, -10.E3
By default, ABAQUS/Explicit assumes that the load is applied instantaneously at the start of the analysis.

Output requests

Finite element analyses can create vast amounts of output. ABAQUS allows you to control and manage this output so that only data required to interpret the results of your simulation are produced. Three types of output are available from ABAQUS/Explicit:

  • Output database (ODB) output (.odb file). Writes a neutral binary file used by ABAQUS/Viewer for postprocessing.

  • Restart output (.res file). Used to continue the analysis, thus allowing a simulation to be run in stages.

  • File output (.fil file). Writes results in a binary format; primarily used for subsequent postprocessing with third-party software.

You will use the first of these in the overhead hoist simulation.

By default, ABAQUS/Explicit writes a preselected set of the most commonly used output variables to the output database file. A list of preselected variables for default output database output is given in the ABAQUS Analysis User's Manual. You do not need to add any output requests to accept these defaults. For this example, the default output database output includes the deformed configuration.

Since you have now finished defining all the data required for the step, use the *END STEP option to mark the end of the step:

*END STEP

The input file is now complete. Compare the input file you have generated to the complete input file given in Figure 2–2. Save the data as frame_xpl.inp, and exit the editor.