Model.freebodysectiondisplacement#

Model.freebodysectiondisplacement(freebodysection_ids, freenode, arrlen=75.0, arroworigin=0, colorfx=3, colorfy=4, colorfz=5, colorfxy=1, colorfyz=2, colorfxz=7, colorfxyz=6, colormx=3, colormy=4, colormz=5, colormxy=1, colormyz=2, colormxz=7, colormxyz=6, createfield=0, createload=0, declim=2, display=1, displacement=0, fx=3, fxy=1, fxyz=6, fxz=7, fy=4, fyz=2, fz=5, mx=3, mxy=1, mxyz=6, mxz=7, my=4, myz=2, mz=5, resFileID=INT_MAX, resolvein_sys=0, resultID=Entity(), rotation=0, scid=0, scientific=0, showvalue=0, sizescale=0, stepid=0, tolerance=0.0001, userSysID=Entity(), vecstyle=0)#

Creates an FBD displacement plot and fields or loads from the results for a freebodysection entity with config=3 (FBD Plot). This queries the displacement data from the result entity on a freebodysection.

Parameters:

  • freebodysection_ids (EntityList) – A list containing the freebodysection entity objects.

  • freenode (int) – Currently must be set to 2. This is a mandatory argument.

  • arrlen (double) – Controls the FBD plot arrow length. Default is 75 (%).

  • arroworigin (unsigned int) –

    0 - Tail of arrow at node for the plot (default)

    1 - Tip of arrow at node for the plot

  • colorfx (unsigned int) – The color of the Fx arrow. Valid values are 1-64.

  • colorfy (unsigned int) – The color of the Fy arrow. Valid values are 1-64.

  • colorfz (unsigned int) – The color of the Fz arrow. Valid values are 1-64.

  • colorfxy (unsigned int) – The color of the Fxy arrow. Valid values are 1-64.

  • colorfyz (unsigned int) – The color of the Fyz arrow. Valid values are 1-64.

  • colorfxz (unsigned int) – The color of the Fxz arrow. Valid values are 1-64.

  • colorfxyz (unsigned int) – The color of the Fxyz arrow. Valid values are 1-64.

  • colormx (unsigned int) – The color of the Mx arrow. Valid values are 1-64.

  • colormy (unsigned int) – The color of the My arrow. Valid values are 1-64.

  • colormz (unsigned int) – The color of the Mz arrow. Valid values are 1-64.

  • colormxy (unsigned int) – The color of the Mxy arrow. Valid values are 1-64.

  • colormyz (unsigned int) – The color of the Myz arrow. Valid values are 1-64.

  • colormxz (unsigned int) – The color of the Mxz arrow. Valid values are 1-64.

  • colormxyz (unsigned int) – The color of the Mxyz arrow. Valid values are 1-64.

  • createfield (unsigned int) –

    0 - Do not create a nodal displacement field (default)

    1 - Create a nodal displacement field

  • createload (unsigned int) –

    0 - Do not create FBD displacement loads (default)

    1 - Create FBD displacement loads

  • declim (int) – Controls the decimal limit. Default is 2.

  • display (unsigned int) –

    0 - Do not plot FBD displacements

    1 - Plot FBD displacements (default)

  • displacement (unsigned int) –

    0 - Applied forces are not participating in the FBD calculation (default)

    1 - Applied forces are participating in the FBD calculation

  • fx (unsigned int) –

    0 - Fx translations are not included in the plot, load or field creation (default)

    1 - Fx translations are included in the plot, load or field creation

  • fxy (unsigned int) –

    0 - Fxy resultant translations are not included in the plot (default)

    1 - Fxy resultant translations are included in the plot

  • fxyz (unsigned int) –

    0 - Fxyz resultant translations are not included in the plot (default)

    1 - Fxyz resultant translations are included in the plot

  • fxz (unsigned int) –

    0 - Fxz resultant translations are not included in the plot (default)

    1 - Fxz resultant translations are included in the plot

  • fy (unsigned int) –

    0 - Fy translations are not included in the plot, load or field creation (default)

    1 - Fy translations are included in the plot, load or field creation

  • fyz (unsigned int) –

    0 - Fyz resultant translations are not included in the plot (default)

    1 - Fyz resultant translations are included in the plot

  • fz (unsigned int) –

    0 - Fz translations are not included in the plot, load or field creation (default)

    1 - Fz translations are included in the plot, load or field creation

  • mx (unsigned int) –

    0 - Mx rotations are not included in the plot, load or field creation (default)

    1 - Mx rotations are included in the plot, load or field creation

  • mxy (unsigned int) –

    0 - Mxy resultant rotations are not included in the plot (default)

    1 - Mxy resultant rotations are included in the plot

  • mxyz (unsigned int) –

    0 - Mxyz resultant rotations are not included in the plot (default)

    1 - Mxyz resultant rotations are included in the plot

  • mxz (unsigned int) –

    0 - Mxz resultant rotations are not included in the plot (default)

    1 - Mxz resultant rotations are included in the plot

  • my (unsigned int) –

    0 - My rotations are not included in the plot, load or field creation (default)

    1 - My rotations are included in the plot, load or field creation

  • myz (unsigned int) –

    0 - Myz resultant rotations are not included in the plot (default)

    1 - Myz resultant rotations are included in the plot

  • mz (unsigned int) –

    0 - Mz rotations are not included in the plot, load or field creation (default)

    1 - Mz rotations are included in the plot, load or field creation

  • resFileID (int) – The result file ID for resultid. Useful when multiple result files are loaded for a single result entity.

  • resolvein_sys (unsigned int) –

    1 - Resolve in global system

    2 - Resolve in user system

    3 - Freebody section system

  • resultID (Entity) – The object describing the result entity.

  • rotation (unsigned int) –

    0 - SPC forces are not participating in the FBD calculation (default)

    1 - SPC forces are participating in the FBD calculation

  • scid (unsigned int) – The results subcase ID for result entity specified by resultid.

  • scientific (unsigned int) –

    0 - Fixed format text (default)

    1 - Scientific format text

  • showvalue (unsigned int) –

    0 - Show text (default)

    1 - Hide text

  • sizescale (unsigned int) –

    0 - Constant FBD plot arrow length (default)

    1 - Magnitude FBD plot arrow length

  • stepid (unsigned int) – The step/simulation ID for results subcase specified by scid.

  • tolerance (double) – The tolerance to limit the values. Default is 0.0001.

  • userSysID (Entity) – The object describing the system entity when resolvein_sys =2.

  • vecstyle (unsigned int) –

    0 - 3D FBD plot arrow (default)

    1 - 2D FBD plot arrow

Example#

Create an FBD Displacement plot#
import hm
import hm.entities as ent

model = hm.Model()

model.freebodysectiondisplacement(
freebodysection_ids=[ent.Freebodysection(model, i) for i in range(1,4)],
freenode=2,
arrlen=75.0,
arroworigin=0,
colorfx=3,
colorfy=4,
colorfz=5,
colorfxy=1,
colorfyz=2,
colorfxz=7,
colorfxyz=6,
colormx=3,
colormy=4,
colormz=5,
colormxy=1,
colormyz=2,
colormxz=7,
colormxyz=6,
createfield=0,
createload=0,
declim=3,
display=1,
displacement=1,
fx=3,
fxy=0,
fxyz=0,
fxz=0,
fy=1,
fyz=0,
fz=1,
mx=0,
mxy=0,
mxyz=0,
mxz=0,
my=0,
myz=0,
mz=0,
resFileID=2,
resolvein_sys=3,
resultID=ent.Result(model, 1),
rotation=1,
scid=1,
scientific=0,
showvalue=1,
sizescale=0,
stepid=0,
tolerance=0.0001,
userSysID=ent.System(model, 1),
vecstyle=0,
)