Model.beamsectionsetdatastandard#

Model.beamsectionsetdatastandard(parameter_array, beam_sect_id, beam_sect_type, orientation_angle, beam_sect_subtype)#

Updating a shell beam section requires two functions of which this is the second. This function will update all data for a shell type beam section. The function Model.beamsectionsetdataroot() should precede use of this function.

Beam section data cannot be updated piecemeal with this function; all data must be known for the beam and sent in as arguments.

Results will be calculated for the beam section automatically after updating.

Parameters:

parameter_array (hwDoubleList) –

The ID of the double array that contains the standard section parameters.

The contents of this array are stored in threes with one group of three for each parameter. The first three values are the initial, minimum, and maximum values for the first parameter, such as the height, in that order. The second three values are the initial, minimum, and maximum values for the second parameter, such as the length. This repeats for all parameters. See the table below for a list of the number of parameters and descriptions of them for each section, solver, and subtype.

The terms height, width, top, bottom, vertical, horizontal, left and right refer to the directions when viewing the section, such that the y-axis is pointing upward and the z-axis is pointing to the right. If the beam section type can have multiple orientation angles, the terms apply to the zero degree case.

Section	Type	# of Param	Parameter values (at zero or default angle)	Analysis code	Section subtype
Box	0	3	1: Thickness 2: Height 3: Width	HyperMesh	HMBox
		4	1: Thickness (top and bottom) 2: Height 3: Width 4: Thickness (left and right)	Rad/OS/Nas LS-DYNA Permas	Box Tubular Box Type3 PROFIL_7
		6	1: Thickness (bottom) 2: Height 3: Width 4: Thickness (left) 5: Thickness (top) 6: Thickness (right)	Rad/OS/Nas Ansys LS-DYNA Abaqus	Box1 HREC Box-shape1 BOX
General Symmetric	1	8	1: Thickness 2: A/T 3: J/T 4: Iyy/T 5: Izz/T 6: Width 7: Height 8: Bredt Area	HyperMesh	HMGensym
General Asymmetric	2	9	1: Thickness 2: A/T 3: J/T 4: Iyy/T 5: Izz/T 6: Stress Recovery Y 7: Stress Recovery Z 8: Bredt Area 9: Iyz/T	HyperMesh	HMGennonsym
Constant Perimeter Box	3	3	1: Thickness 2: Width & Height 3: Perimeter	HyperMesh	HMCpbox
Hat	4	4	1: Width 2: Thickness 3: Height (without flanges) 4: Flange length	HyperMesh LS-DYNA	HMHat Hat-shape
		4	1: Height 2: Thickness 3: Height (without flanges) 4: Flange length	Rad/OS/Nas	HAT
		9	1: Width 2: Leg thickness (top) 3: Height (without flanges) 4: Flange length (bottom) 5: Flange thickness (bottom) 6: Arch thickness 7: Flange thickness (top) 8: Flange length (top) 9: Leg Thickness (bottom)	ANSYS	HATS
Tube	7	2	1: Inner radius 2: Outer radius	HyperMesh Rad/OS/Nas ANSYS Abaqus LS-DYNA Permas	HMTube Tube CTUBE PIPE Tubular Type2 PROFIL_9
Rectangle	10	2	1: Height 2: Width	HyperMesh ANSYS Abaqus LS-DYNA	HMRect RECT RECT Solid box PROFIL_6
Rectangle	10	2	1: Width 2: Height	Rad/OS/Nas	Bar
Circle	11	1	1: Radius	HyperMesh Rad/OS/Nas ANSYS Abaqus LS-DYNA	HMCirc Rod CSOLID CIRC Circular PROFIL_8
I-Section	12	4	1: Total width (flange) 2: Total height (web) 3: Web thickness 4: Flange length	LS-DYNA	I-shape
		6	1: Total width (web) 2: Flange width (left) 3: Flange width (right) 4: Web thickness 5: Flange thickness (left) 6: Flange thickness (right)	HyperMesh ANSYS Abaqus LS-DYNA LS-DYNA	HMIsec I I I-shape1 I-shape2 PROFIL_1B
		6	1: Total width (web) 2: Flange width (bottom) 3: Flange width (top) 4: Web thickness 5: Flange thickness (bottom) 6: Flange thickness (top)	Rad/OS/Nas	I
Channel	13	4	1: Leg length 2: Base length 3: Base thickness 4: Leg thickness (both)	HyperMesh Rad/OS/Nas Rad/OS/Nas Rad/OS/Nas LS-DYNA LS-DYNA LS-DYNA	HMChan Chan Chan1 Chan2 Channel Channel1 Channel2 PROFIL_2
Channel	13	6	1: Base length 2: Leg length (right) 3: Leg length (left) 4: Leg thickness (right) 5: Leg thickness (left) 6: Base thickness	ANSYS	CHAN
L-section	14	4	1: Leg length (height) 2: Base length (width) 3: Leg thickness (vertical) 4: Base thickness (horizontal)	HyperMesh Rad/OS/Nas ANSYS Abaqus LS-DYNA	HMLsec L L L L-shape PROFIL_3 PROFIL_3B
T-section	15	4	1: Flange length (total) 2: Web length + flange thickness 3: Flange thickness 4: Web thickness	HyperMesh Rad/OS/Nas Rad/OS/Nas Rad/OS/Nas ANSYS Abaqus LS-DYNA LS-DYNA LS-DYNA	HMTsec T T1 T2 T T T-shape T-shape1 T-shape2 PROFIL_5
H-section	16	4	1: Web height (excluding flanges) 2: Flange thickness (each) 3: Flange thickness (total) 4: Web thicknes	HyperMesh Rad/OS/Nas Rad/OS/Nas LS-DYNA	HMHsec H I1 H-shape PROFIL_1
Asymmetric	17	4	1: Base length (total) 2: One leg length + base thickness 3: Base thickness 4: Leg thickness (each)	Rad/OS/Nas	Z PROFIL_4 PROFIL_4B
		6	1: Base length (total) 2: Leg length (right/down) 3: Leg length (left/up) 4: Leg thickness (right/down) 5: Leg thickness (left/up) 6: Base thickness	ANSYS	Z
		8	1: Total width (web) 2: Total flange length (left) 3: Total flange length (right) 4: Web thickness 5: Flange thickness (left) 6: Flange thickness (right) 7: Flange offset (left) 8: Flange offset (right)	Permas	Type1
Cross	18	4	1: Leg length (horizontal - exclude web) 2: Web thickness (vertical) 3: Total web length (vertical) 4: Leg thickness (horizontal)	Rad/OS/Nas LS-DYNA	Cross Cross
Trapezoid	19	3	1: Altitude (horizontal) 2: Base length (left) 3: Base length (right)	Abaqus	TRAPEZOID

beam_sect_id (unsigned int) – The beam section ID to update.
beam_sect_type (int) –
Standard beam section type. Valid values are:

0 - Thin walled box section

1 - Generic symmetric section

2 - Generic non-symmetric section

3 - Constant perimeter box section

4 - Hat section

7 - Tube section

10 - Rectangle section

11 - Circle section

12 - Symmetric I-section

13 - Channel section

14 - L-section

15 - T-section

16 - H-section

17 - Asymmetric section

18 - Cross section

19 - Trapezoid section

Not all section types are supported for all solvers. Consult the beam_sect_subtype table below.

orientation_angle (int) –

Angle of rotation for the standard section. Valid values are:

0 - 0 degrees.

1 - 90 degrees.

2 - 180 degrees.

3 - 270 degrees.

Section	Type	HyperMesh	OptiStruct Nastran	ANSYS	Abaqus	LS-DYNA	Permas
Box	0	0	0	0	0	0	0
General Symmetric	1	0	---	---	---	---	---
General Asymmetric	2	0	---	---	---	---	---
Constant Perimeter Box	3	0	---	---	---	---	---
Hat	4	0	270	0	---	0	---
Tube	7	0	0	0	0	0	0
Rectangle	10	0	90	0	0	0	---
Circle	11	0	0	0	0	0	---
I-Section	12	0	270	0	0	0	---
Channel	13	0	0 (chan2) 90 (chan) 90 (chan1)	0	---	0 (Channel) 0 (Channel1) 90 (Channel2)	---
L-Section	14	0	0	0	0	0	---
T-Section	15	0	0 (T1) 90 (T2) 270 (T)	180	0	0 (T-shape) 90 (T-shape1) 180 (T-shape2)	---
H-Section	16	0	0 (I1) 90 (H)	---	---	0	---
Asymmetric	17	---	90	0	---	0	0
Cross	18	---	0	---	---	0	---
Trapezoid	19	---	---	---	0	---	---

Note

Not all angles are supported for all beam sections for all Solvers. Consult the table below. The angles are shown where they differ for the full list of supported types.

beam_sect_subtype (hwString) –

The name of the section subtype. Consult the table below for supported values for each Solver and section type.

Section	Type	HyperMesh	OptiStruct Nastran	ANSYS	Abaqus	LS-DYNA	Permas
Box	0	HMBox	Box Box1	HREC	BOX	Box-shape1 Tubular box	Type3
General Symmetric	1	HMGensym	---	---	---	---	---
General Asymmetric	2	HMGennonsym	---	---	---	---	---
Constant Perimeter Box	3	HMCpbox	---	---	---	---	---
Hat	4	HMHat	HAT	HATS	---	Hat-shape	---
Tube	7	HMTube	Tube	CTUBE	PIPE	Tubular	Type2
Rectangle	10	HMRect	Bar	RECT	RECT	Solid box	---
Circle	11	HMCirc	Rod	CSOLID	CIRC	Circular	---
I-Section	12	HMIsec	I	I	I	I-shape I-shape1 I-shape2	---
Channel	13	HMChan	Chan Chan1 Chan2	CHAN	---	Channel Channel1 Channel2	---
L-Section	14	HMLsec	L	L	L	L-shape	---
T-Section	15	HMTsec	T1 T2 T	T	T	T-shape T-shape1 T-shape2	---
H-Section	16	HMHsec	H 11	---	---	H-shape	---
Asymmetric	17	---	Z	Z	---	---	Type1
Cross	18	---	Cross	---	---	Cross	---
Trapezoid	19	---	---	---	TRAPEZOID	---	---

Update the parameter data for a standard hat section with ID 1. Note that this function should be used in tandem with Model.beamsectionsetdatastandard() as follows#

import hm

model = hm.Model()

model.beamsectionsetdataroot(
  beam_sect_id=1,
  collector_id=1,
  solver=0,
  beam_config=2,
  line_color=7,
  fill_color=1,
  flags=0,
  torsion_factor=1,
  warping_factor=1,
  orient_vector1=0,
  orient_vector2=0,
  orient_origin1=0,
  orient_origin2=0
)

model.beamsectionsetdatastandard(
  parameter_array=[6.0, 6.0, 6.0, 0.5, 0.5, 0.5, 4.0, 4.0, 4.0, 1.0, 1.0, 1.0],
  beam_sect_id=1,
  beam_sect_type=4,
  orientation_angle=0,
  beam_sect_subtype="HMHat"
)