Beam Section Temperature

A nested class within Temperature used to create beam section temperature loads that apply temperature gradients and variations across beam cross-sections.

Constructor

---

Temperature.BeamSection(element, lcname, section_type='General', type='Element', group="", dir='LZ', ref_pos='Centroid', b_value=0, value=None, elast=None, thermal=None, id=None)

Creates beam section temperature loads that apply temperature variations across beam cross-sections.

Parameters

• element: Single Element ID or list of Element IDs to apply the load (Required)
• lcname: Load case name (Required)
• section_type (default='General'): 'General' or 'PSC'
• type (default='Element'): 'Element' or 'Input'
• group (default=""): Load group name
• dir (default='LZ'): Direction, 'LY' or 'LZ'
• ref_pos (default='Centroid'): Reference Position, 'Centroid', 'Top', or 'Bot'
• b_value (default=0): The val_b parameter applied uniformly to all rows.
• value (default=None): List of temperature profile rows. Each row is [val_h1, val_h2, val_t1, val_t2] (4 values) or a short row [val_h1, val_h2, val_t1] (3 values, auto-padded with val_t2=0). Defaults to [[0, 0, 0, 0]] if not provided.
• General sections: numeric values only — e.g. [[0.1, 0.2, 3.0, 12.4]]
• PSC sections: val_h1 and val_h2 accept either a Z-string ('Z1', 'Z2', 'Z3') or a numeric value — e.g. [["Z1", "Z2", 17.8, 4], [0.15, 0.4, 4, 0]]
• elast (default=None): Modulus of Elasticity (required for 'Input' type)
• thermal (default=None): Thermal Coefficient (required for 'Input' type)
• id (default=None): Load ID (auto-generated if None)

Object Attributes

• ELEMENT (int): The element ID where temperature is applied.
• ID (int): The ID of the beam section temperature entry.
• ITEMS (list): List containing temperature load data for the element.

Methods

---

json

Returns JSON representation of all beam section temperature loads.

bst1 = Temperature.BeamSection(1, "Temp Gradient", "General", "Element", "LoadGroup1")
print(Temperature.BeamSection.json())

create

Sends beam section temperature loads to Civil NX.

Temperature.BeamSection.create()

get

Fetches beam section temperature loads from Civil NX.

print(Temperature.BeamSection.get())

sync

Synchronizes beam section temperature loads from Civil NX.

Temperature.BeamSection.sync()

delete

Deletes all beam section temperature loads from both Python and Civil NX.

Temperature.BeamSection.delete()

Examples

---

# Beam Section Temperature Example
# Create load cases first
Load_Case("T", "Temperature Case 1")
Load_Case("T", "Temperature Case 2")
Load_Case.create()

# Create load group
Group.Load("Temperature Loads")
Group.Load.create()

# Define Beam Section Temperature - General Section with Element type
# Each row: [val_h1, val_h2, val_t1, val_t2]
Temperature.BeamSection(
    element=1,
    lcname="Temperature Case 1",
    section_type='General',
    type='Element',
    group="Temperature Loads",
    dir='LZ',
    ref_pos='Centroid',
    b_value=0,
    value=[
        [10.0, 15.0, 5.0, 8.0],
    ]
)

# Define Beam Section Temperature - Input type with material properties
Temperature.BeamSection(
    element=2,
    lcname="Temperature Case 2",
    section_type='General',
    type='Input',
    group="Temperature Loads",
    b_value=0,
    value=[
        [12.0, 18.0, 6.0, 0],
    ],
    elast=30000000,   # Required for Input type
    thermal=0.0011    # Required for Input type
)

# Create all beam section temperature loads
Temperature.BeamSection.create()

# PSC Gradient Example
# Each row: [val_h1, val_h2, val_t1, val_t2]
# val_h1 / val_h2 accept 'Z1', 'Z2', 'Z3' (section-defined depths) or numeric values

# Positive Temp. Gradient — applied to elements 7, 8, 9
Temperature.BeamSection(
    element=[7, 8, 9],          # list of IDs
    lcname="Positive Temp. Grad",
    section_type='PSC',
    type='Element',
    ref_pos='Top',
    elast=0,
    thermal=0,
    value=[
        [0,    0.15, 17.8, 4  ],
        [0.15, 0.4,  4,    0  ],
        [2.85, 3,    0,    2.1],
    ],
)

# Negative Temp. Gradient — same elements
Temperature.BeamSection(
    element=[7, 8, 9],          # list of IDs
    lcname="Negative Temp. Grad",
    section_type='PSC',
    type='Element',
    ref_pos='Top',
    elast=0,
    thermal=0,
    value=[
        [0,    0.25, -10.3, -0.7],
        [0.25, 0.5,  -0.7,   0  ],
        [2.5,  2.75,  0,    -0.8],
    ],
)

# Create all beam section temperature loads
Temperature.BeamSection.create()

# PSC with Z-string depths Example
# Use 'Z1', 'Z2', 'Z3' for val_h1/val_h2 to reference section-defined depth zones

Temperature.BeamSection(
    element=[7, 8, 9],
    lcname="PSC Z-String Grad",
    section_type='PSC',
    type='Element',
    dir='LZ',
    ref_pos='Top',
    b_value=0,
    value=[
        ["Z1", "Z2", 17.8, 4],   # val_h1="Z1", val_h2="Z2" → section-defined depths
        [0.15,  0.4,  4,   0],   # numeric depths
    ],
)

Temperature.BeamSection.create()