Model.createfbdgroupfortraceplot#

Model.createfbdgroupfortraceplot(name, node_ids, entType, num_cuts, path_dir, userDir=hwTriple(0.0, 0.0, 0.0), sys_def='Global', system=Entity(), sys_ref_dir=hwTriple(0.0, 0.0, 0.0))#

Creates a freebodygroup entity, used for FBD trace plots. Options can be provided in any order.

Parameters:

  • name (hwString) – The name of the freebodygroup to create.

  • node_ids (EntityList) – The entity node list for the trace path, given in sequence. A minimum number of 2 nodes are required.

  • entType (EntityFullType) – The element entity type.

  • num_cuts (int) – The number of cuts between each sequential node in node_ids. If num_cuts=0 then sections are only created at the nodes.

  • path_dir (int) –

    0 - User direction

    1 - Trace path direction

  • userDir (hwTriple) – When path_dir=0, this is a triple double defining the direction vector.

  • sys_def (hwString) – The system definition. Valid values are “Global”, “Direction based” and “User defined”.

  • system (Entity) – The system entity.

  • sys_ref_dir (hwTriple) – The reference direction defined as a triple double defining the direction vector.

Example#

Create a freebodygroup named test with no cuts , a user direction , and system with ID 1#
import hm
import hm.entities as ent

model = hm.Model()

model.createfbdgroupfortraceplot(
name="test",
node_ids=[813, 664],
entType=ent.Element,
num_cuts=0,
path_dir=0,
userDir=[0.803557, 0.595228, 0.000000],
sys_def="User defined",
system=ent.System(model,1)
)
Create a freebodygroup named test with 4 cuts , a trace path direction , and no system#
import hm
import hm.entities as ent

model = hm.Model()

model.createfbdgroupfortraceplot(
name="test",
node_ids=[813, 664],
entType=ent.Element,
num_cuts=4,
path_dir=1,
)