*barelementupdatewithoffsets

Updates the vector, pin flags, property, direction node and offset for multiple bar and/or bar3 elements.

Syntax

*barelementupdatewithoffsets mark_id update_vector vector_option vector_id update_pins pin_flags_a pin_flags_b update_property property_name update_orientation orientation_node y_dir update_offset_a offset_system_a offset_x_a offset y_a offset_z_a update_offset_b offset_system_b offset_x_b offset_y_b offset_z_b

Type

HyperMesh Tcl Modify

Description

Updates the vector, pin flags, property, direction node and offset for multiple bar and/or bar3 elements.

Inputs

mark_id
The ID of the mark containing the bar and/or bar3 elements to update. Valid values are 1 and 2.
update_vector
If non-zero, vector_id is used to update the local y-axis.
vector_option
0 - Vector is defined by using global coordinate system.
1 - Vector is defined by using local coordinate system.
2 - Vector will be calculated by aligning element y-axis parallel to global XY plane.
3 - Vector will be calculated by aligning element y-xis parallel to global YZ plane.
4 - Vector will be calculated by aligning element y-axis parallel to global ZX plane
5 - Vector will be calculated by aligning element z-axis parallel to global XY plane.
6 - Vector will be calculated by aligning element z-axis parallel to global YZ plane.
7 - Vector will be calculated by aligning element z-axis parallel to global ZX plane.
vector_id
The ID of the y-axis vector to use, defined using the *createvector command. If used, this must be set to 1.
update_pins
If non-zero, pin_flags_a and pin_flags_b are used to update the pin flags.
pin_flags_a
The pin flags at end a. A pin flag of 0 passes forces in all degrees of freedom.
pin_flags_b
The pin flags at end b. A pin flag of 0 passes force in all degrees of freedom.
update_property
If non-zero, property_name is used to update the property.
property_name
The name of the property collector assigned to the bar.
update_orientation
If non-zero, the direction node will be updated.
orientation_node
The orientation node ID. y_dir specifies whether this node defines the local y- or local z-axis.
y_dir
If set to 1, then orientation_node defines the local y-axis of the bar. Otherwise, orientation_node defines the local z-axis.
update_offset_a
If non-zero, the offsets at end a are updated.
update_offset_b
If non-zero, the offsets at end b are updated.
offset_system_a
The system used to define the offsets at end a. Valid values are:
  • 0 - Offsets given in global coordinate system.
  • 1 - Offsets given in local coordinate system of node1.
  • 2 - Offsets given in elemental coordinate system.
offset_x_a
The offset in the x-direction at end a.
offset_y_a
The offset in the y-direction at end a.
offset_z_a
The offset in the z-direction at end a.
offset_system_b
The system used to define the offsets at end b. Valid values are:
  • 0 - Offsets given in global coordinate system.
  • 1 - Offsets given in local coordinate system of node1.
  • 2 - Offsets given in elemental coordinate system.
offset_x_b
The offset in the x-direction at end b.
offset_y_b
The offset in the y-direction at end b.
offset_z_b
The offset in the z-direction at end b.

Examples

To update the elements on mark 1 with y-axis defined by vector (0.0, 1.0, and 0.0):
*createvector 1 0.0000 1.0000 0.0000
*barelementupdatewithoffsets 1 1 0 1 0 0 0 0 "" 0 0 0 0 0 0.0 0.0 0.0 0 0 0.0 0.0 0.0
To update the elements on mark with y-axis oriented in global XY plane:
*barelementupdatewithoffsets 1 1 2 1 0 0 0 0 "" 0 0 0 0 0 0.0 0.0 0.0 0 0 0.0 0.0 0.0
To update the elements on mark 1 with orientation node 3 in y-direction:
*barelementupdatewithoffsets 1 0 0 1 0 0 0 0 "" 1 3 1 0 0 0.0 0.0 0.0 0 0 0.0 0.0 0.0
To update the elements on mark 1 with offsets a defined in global system having offset vector (0.2, 0.2, and 0.2) and offsets b defined in global system having offset vector (0.3, 0.3, and 0.3):
*barelementupdatewithoffsets 1 0 0 1 0 0 0 0 "" 0 0 0 1 0 0 0.2 0.2 0.2 1 0 0.3 0.3 0.3

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

11.0