*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.
- createpropfromdata=<flag>
- Used to create property from metadata. Used only when propflag=1, usereference=1 and propmethod=bydata.
- 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
- 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
- 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
- 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.
- propflag=<flag>
- Used to update the property on the elements or components.
- 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.
- usereference=<flag>
- 0 - Update elements from user input (default)
Examples
*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
*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
if { [ catch {command_name...} ] } {
# Handle error
}
Version History
2020