structure liner import command

Syntax

structure liner import keyword

Primary keywords:

from-file    from-geometry

Create liner elements from an outside source.

from-file s <format keyword> [linerimportoptions]

Create elements from the geometry file s

The optional format keyword can be used to specify the format of the file. The options are dxf, geom, or stl. [CS: work out what needs to happen here later; formats should have links] If not specified, the format is assumed from the file extension.

from-geometry s [linerimportoptions] <range>

Create elements from the geometry set named s. The range applies to the list of edges in the geometry set.


Keyword Block

The following keywords may be optionally provided on liner creation using any of the major keywords: from-file and from-geometry.

distinct

Eliminate sharing of nodes among created elements. Every element will create a new set of nodes, even if they are at the same location in space and elements share the same ID number. This option is most commonly used with a later structure node join command to create links connecting nodes at the same location in order to apply custom inter-element behavior.

id i

Specify the ID that will be assigned to all new elements created by this command. If this value is not given, then the next available ID will be used. The ID controls potential joining of the element nodes to an existing element as follows. At each potential new node location, a new node is created unless all of the following conditions are fulfilled: 1) the ID is given; 2) an existing node is found “near” the potential new node location; and 3) the found node is part of an element of the same type with ID equal to i.

group s1 <slot s2 >

Assign the created elements to group s1. The group is assigned to the slot named s2 if supplied; it is assigned to the slot named Default if not. Use of the group logic is described in Group.

cross-diagonal <b >

If specified, a cross-diagonal mesh of four triangles will be created with a node lying at the centroid of all quadrilaterals; otherwise, a cross-hatch mesh of two triangles will be created dividing the quadrilateral.

When connecting elements to the grid, it is best to locate nodes at gridpoints. If the finite-element type can resist bending (DKT, DKT-CST, or DKT-(CST Hybrid) elements), then incompatibilities can develop along element faces and zone faces, because the transverse (out-of-plane) displacement field varies cubically across element faces, but varies only linearly across zone faces. Thus, when connecting bending-resistant elements rigidly to zone faces, it is best to utilize a cross-hatch mesh, because the middle node of the cross-diagonal mesh will be constrained to translate according to the linear displacement field of the zone face. This over-constrains the elements and can produce near-zero moments at these mid-nodes when present in a nonzero moment field.

element-type keyword

Specify the finite element formulation used by each structural element. If no element type is specified, then the element type will be DKT-CST. Note that the type of finite element is associated with each structural element as it is created and cannot subsequently be altered. The finite element type of existing structural elements is printed by the structure liner list element-type command. The value of the keyword supplied must be one of the following three-noded finite elements:

s

Attempt to match the string s to one of the available keywords below, and treats as that option

cst

CST (6 degrees-of-freedom) finite element. This is a membrane element; it resists membrane, but not bending, loading.

csth

CST Hybrid (9 degrees-of-freedom) finite element. This is a membrane element; it resists membrane, but not bending, loading.

dkt

DKT (9 degrees-of-freedom) finite element. This is a plate-bending element; it resists bending, but not membrane, loading.

dkt-cst

DKT-CST (15 degrees-of-freedom) finite element. This is a shell element that combines the DKT and CST elements to resist both bending and membrane loading.

dkt-csth

DKT-(CST Hybrid) (18 degrees-of-freedom) finite element. This is a shell element that combines the DKT and CST Hybrid elements to resist both bending and membrane loading.

embedded

Specify that this liner is two-sided. If the embedded keyword is used, then the internal keyword is implied, even if not explicitly given.

internal

This keyword only applies if the from-faces option was used. Specifies that all internal and surface faces in the range will have elements created on them. Normally only surface faces are considered.

maximum-length f

Break the element into segments no greater than length f. The segments setting, if provided, is overridden as needed by this setting.

segments i

Break the element into i equal segments, creating new nodes as needed. The default value is 1, indicating that only one element will be created.

separate <origin v >

Select a group of internal faces and separate them into surfaces as with the zone separate command. A liner will be created set between the two surfaces. This keyword implies both embedded and internal. The origin point v is used to determine which side of the faces selected will be considered side 1 and which will be side 2. The vector from v to the face centroid is compared with the normal to the face. The side pointing toward v will be side 1, and the side pointing away from v will be side 2. If the origin keyword is not specified, it is assumed to be (0,0,0).

size i1 i2

This keyword only applies if the from-quadrilateral option was used. Increases the number of elements created by subdividing the quadrilateral into i1 segments along the first edge and i2 segments along the second. By default, only one quad is created.