*update1delements

Updates 1D beams, bars and rods, and optionally assigns properties.

Syntax

*update1delements <option1>=<value1> <option2>=<value2> ... <optionN>=<valueN>

Type

HyperMesh Tcl Modify Command

Description

Updates 1D beams, bars and rods, and optionally assigns properties.

Inputs

adjustoffset=<value>
Adjust the offset when offsetflag=1. Valid values are all, reset and vert.
allshells=<value>
Flag to consider all neighboring shells. For orientation, use usereference=1, orientflag=1 and orientmethod=auto. For offset, use usereference=0 and offsetflag=1.
0 - Do not consider
1 - Consider.
createpropfromdata=<flag>
Used to create property from metadata. Used only when propflag=1, usereference=1 and propmethod=bydata.
0 - Do not create (default)
1 - Create
inputentitytype=<entity_type>
The type of input entity. Valid value is elems. Used only when usereference=0.
inputmark=<mark_id>
The ID of the mark of input entities. Valid values are 1 and 2. Used only when usereference=0.
offsetends=<method>
The method of offsetting element ends. Used only when offsetflag=1. Valid values are start (offset at start/end A), end (offset at end/end B), and startend (offset at both ends).
offsetflag=<flag>
0 - Do not update element offset values
1 - Update element offset values
offsetlateral=<value>
The lateral offset direction. Valid values are pos or neg. Used when offsetflag=1.
offsetmethod=<method>
The element offset method. Valid values are auto (when adjustoffset=auto) and reset (when adjustoffset=reset). Used only when offsetflag=1.
offsetnormal=<value>
The normal offset direction. Valid values are pos or neg. Used when offsetflag=1.
orient=<value>
0 - Do not update element orientation using autoupdate1delements
1 - Update element orientation using autoupdate1delements. Used only when orientflag=1 and orientmethod=auto.
orientdatatype=<method>
Provide a label as metadata, which uses inclination information stored as metadata. Used only when orientflag=1, usereference=1 and orientmethod=bydata.
orientflag=<flag>
0 - Do not update element orientation
1 - Update element orientation, use orientmethod
orientmetadataent=<entity_type>
The entity type to use for metadata. Valid value is lines. Used only when orientflag=1, usereference=1 and orientmethod=bydata.
orientmetadatamark=<mark_id>
The ID of the mark for orientmetadataent. Used only when orientflag=1, usereference=1 and orientmethod=bydata.
orientmetadataname=<label>
Provide a label as metadata name where orientation inclination exists. Used only when orientflag=1, usereference=1 and orientmethod=bydata.
orientmetadatatype=<label>
Provide a label as byentity, to use metadata from the entity. Used only when orientflag=1, usereference=1 and orientmethod=bydata.
orientmethod=<method>
The element orientation method. Valid values are auto (normal to plates), bydata, bynodeid, and bysystem. Used only when orientflag=1.
orientnodeid=<id>
The ID of the orientation node. Used only when orientflag=1 and orientmethod=bynodeid
orientsysid=<id>
The ID of the orientation system. Used only when orientflag=1 and orientmethod=bysystem
orientvector=<id>
The ID of the orientation vector. Used only when orientflag=1 and orientmethod=bysystem
propdatalabel=<label>
Provide a label as metadata, which uses property information stored as metadata. If beam section exists, then a beam property is created. If thickness exists, then a shell property is created. Used only when propflag=1, usereference=1 and propmethod=bydata.
0 - Do not update
1 - Update
propflag=<flag>
Used to update the property on the elements or components.
0 - Do not update
1 - Update
propid=<id>
The ID of the property to apply to elements or components. Used only when propflag=1 and propmethod=byid.
propmetadataentitytype=<entity_type>
The entity type to use for metadata. Valid value is lines. Used only when propflag=1, usereference=1 and propmethod=bydata.
propmetadatamark=<mark_id>
The ID of the mark for propmetadataentitytype. Used only when propflag=1, usereference=1 and propmethod=bydata.
propmetadatatype=<label>
Provide a label as byentity, to use metadata from the entity. Used only when propflag=1, usereference=1 and propmethod=bydata.
propmethod=<method>
The method of updating the property. Valid values are bydata and byid. Used only when propflag=1.
refentmark=<mark_id>
The ID of the mark of reference entities. Valid values are 1 and 2. Used only when usereference=1.
refentsearchtol=<tolerance>
The search tolerance used by the reference entity (default -1). Used only when usereference=1.
refenttype=<entity_type>
The type of reference entity. Valid value is lines. Used only when usereference=1.
refmethod=<method>
Use metadata from the input entity. Valid value is byentity. Used only when usereference=1.
thickness=<method>
The method of assigning shell thickness in case multiple neighboring shells have different thickness values. Used only when offsetflag=1. Valid values are avg, max and min.
usercompsbydata=<flag>
Used only when propflag=1 and either propmethod=bymethod and usereference=1, or propmethod=byid.
0 - Do not apply property to components (default)
1 - Apply property to components
usereference=<flag>
0 - Update elements from user input (default)
1 - Update elements by using metadata from entities

Examples

Update 1D elements using lines, assign properties to elements which exist along the lines, update the orientation using metadata, and offset these elements using neighboring shells:
*createmark lines 1 1 2 3 4
*update1delements usereference=1 refmethod=byentity refenttype=lines refentmark=1 refentsearchtol=-1.0 orientflag=1 orientmethod=bydata orientdatatype=metadata orientmetadatatype=byentity orientmetadataent=lines orientmetadatamark=1 orientmetadataname=Inclination offsetflag=1 offsetnormal=pos adjustoffset=vert offsetlateral=pos offsetends=startend thickness=avg offsetmethod=auto allshells=1 propflag=1 propmethod=bydata propdatatype=metadata propmetadatatype=byentity propmetadataentitytype=lines propmetadatamark=1 usecompsbydata=1 createpropfromdata=1
Update 1D elements orientation, offset and property using usereference=0:
*createmark lines 1 1 2 3 4
*update1delements inputenttype=elems inputmark=1 orientflag=1 orientmethod=auto offsetflag=1 offsetnormal=pos adjustoffset=vert offsetlateral=pos offsetends=startend thickness=avg offsetmethod=auto allshells=1 propflag=1 propmethod=byid propid=1

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

2020