Model.loadsupdatecurve#

Model.loadsupdatecurve(collection, config, type, updatevector, comp1, comp2, comp3, comp4, comp5, comp6, updatemag, magnitude, update_system, system_id, transform_flag, updatecurve, curve_id, updatexscale, xscale, updatedisplaylocation, xlocation, ylocation, zlocation)#

Updates the magnitude, direction, coordinate system, and other information of selected loads entities.

When applying a force, the active components are comp1, comp2, and comp3, which represent a force x, y, and z-axis, respectively.

When applying a moment, the active components are also comp1, comp2, and comp3, and represent the moment about the x, y, and z-axis, respectively.

For constraints, all of the components are active unless they are set equal to -999999.0.

All of the other components of the constraints are active in the respective directions. For pressures, the active components are comp1, comp2, and comp3, which represent the x, y, and z-axis, respectively. To create a pressure that is normal to the element, set all components to zero.

Parameters:

  • collection (Collection) – The collection containing the loads entities to update.

  • config (int) –

    The configuration of the load:

    1 - Force

    2 - Moment

    3 - Constraints

    5 - Temperature

    6 - Flux

    8 - Velocity

    9 - Acceleration

  • type (int) – The type assigned to the load (as defined on the “load types” panel).

  • updatevector (int) – A variable that controls if the direction of the load should be updated.

  • comp1 (double) – Components of the load being applied. Representing force on x axis if force is being applied or moment about x axis if moment is being applied.

  • comp2 (double) – Components of the load being applied. Representing force on y axis if force is being applied or moment about y axis if moment is being applied.

  • comp3 (double) – Components of the load being applied. Representing force on z axis if force is being applied or moment about z axis if moment is being applied.

  • comp4 (double) – Components of the load being applied.

  • comp5 (double) – Components of the load being applied.

  • comp6 (double) – Components of the load being applied.

  • updatemag (int) – An integer variable that controls if the magnitude is updated.

  • magnitude (double) – The new value of magnitude of the load.

  • update_system (int) – A variable that controls if the system is updated.

  • system_id (unsigned int) – The ID of the local system.

  • transform_flag (int) – A simple integer variable that controls if the load is created in the local system.

  • updatecurve (int) – A flag to indicate whether the curve should be updated (0=no, 1=yes).

  • curve_id (unsigned int) – The ID of the new curve to use.

  • updatexscale (int) –

    A flag to indicate whether the curve’s scale factor should be updated.

    0 - No

    1 - Yes

  • xscale (double) – The new value to use for scale factor.

  • updatedisplaylocation (int) –

    A flag to indicate whether the curve’s display location should be updated.

    0 - No

    1 - Yes

  • xlocation (double) – The new display location in x axis (used only if updatedisplaylocation=1)

  • ylocation (double) – The new display location in y axis (used only if updatedisplaylocation=1)

  • zlocation (double) – The new display location in z axis (used only if updatedisplaylocation=1)

Example#

Update a force to use the curve with ID 7 to define its time - vary magnitude#
import hm
import hm.entities as ent

model = hm.Model()

model.loadsupdatecurve(
    collection=hm.Collection(model, ent.LoadForce, [4]),
    config=1,
    type=1,
    updatevector=0,
    comp1=0.0,
    comp2=0.0,
    comp3=0.0,
    comp4=0.0,
    comp5=0.0,
    comp6=0.0,
    updatemag=0,
    magnitude=0.0,
    update_system=0,
    system_id=0,
    transform_flag=0,
    updatecurve=1,
    curve_id=7,
    updatexscale=0,
    xscale=0.0,
    updatedisplaylocation=0,
    xlocation=0.0,
    ylocation=0.0,
    zlocation=0.0,
)