2024.1 API Programmer's Guide

Changes to beamsections

Beamsections are now defined using two new data names – source and engine. The config data name has been deprecated. Existing scripts are not affected and remain functional, but it is recommended to update the code using the source and engine.

The source represents how the section topology has been defined:
  • Generic has no topology associated
  • Database is a repository of standard sections
  • Shape points to a sketch entity

The engine defines the theory used to compute the section properties and could be set to Closed form theory, FEM, or Thinwall.

Mapping for the new data names:
source engine config (deprecated)
0 (Generic) - 1 (Generic)
1 (Database) 2 (Closed Form) 2 (Standard)
2 (Shape) 3 (FEM) 4 (Elastic)/0 (Solid)
2 (Shape) 4 (Thinwall) 3 (Shell)

Removal of Multibody Entities

Ellipsoids, mbjoints, mbplanes, and multibodies are no longer supported. All commands facilitating the creation of these entities have been removed and the support for these entities has been removed from any related commands.

New Commands

Modified Commands

The following commands have modified behavior that potentially require script updates:
  • General/Core
    • *createmark/hm_createmark - Removed methods “by multibody”, “by multibody id”, “by multibody name”, “by ellipsoid”, “by ellipsoid id”, “by ellipsoid name”, “by mbjoint”, “by mbjoint id”, “by mbjoint name”, “by mbplane”, “by mbplane id”, “by mbplane name”.
The following commands have new options or enhanced capabilities. Existing scripts are not affected and only need to be updated if usage of the new functionality is desired:
  • Data Names
    • beamsects - Deprecated data name config. Added new data names source and engine.
    • failures - Added new config values 241, 242. Added new data names BiquadDcrit, ChangSigma_1t, ChangSigma_2t, ChangSigma_12, ChangSigma_1c, ChangSigma_2c, ChangTau_max, dmgevonum, dmgininum, EPS1_MAX, EPS2_MAX, Fcut0, flat, G_11C, G_11T, G_12C, G_12T, G_22C, G_22T, G_23C, G_23T, G_31C, G_31T, G_33C, G_33T, GAM12_MAX, Icoup, ISHAP11C, ISHAP11T, ISHAP12C, ISHAP12T, ISHAP22C, ISHAP22T, ISHAP23C, ISHAP23T, ISHAP31C, ISHAP31T, ISHAP33C, ISHAP33T, lode, NMOD, PuckFcut, S12, SIGMA_11C, SIGMA_11T, SIGMA_12C, SIGMA_12T, SIGMA_22C, SIGMA_22T, SIGMA_23C, SIGMA_23T, SIGMA_31C, SIGMA_31T, SIGMA_33C, SIGMA_33T, x_dmgevo, x_dmgini, X11, X22, xi_1, xi_2, xi_3, and y.
    • loads
      • moments - Added new data name for LS-DYNA engineering loads: node_set_option
    • resultsubcases - Added new data name stepsEqns.
    • retractors - Added new data name deactivationSensor_SID.
    • seatbelts - Added new data names deletelinkedentities, elems1dset, elems2dset, and elems4nset.
    • solvermasses - Added new data name nsm_elemtype.
  • General/Core
    • *createandadjustmass - Added new optional arguments nodalmass, iterations, and optimizetargetflag.
    • *setoption/hm_getoption- Added new options g_ce_ae_label_display, g_ce_calculation_changes, g_ce_physical_changes, and morph_large_domain_count_threshold.
    • hm_info - Added new -appinfo option TITLEVERSION.
  • Morphing
  • Skeleton

Removed Commands

The following commands/options have been removed and are no longer available for use in scripts:
  • Data Names
    • ellipsoids
    • mbjoints
    • mbplanes
    • multibodies
  • HMASCII
    • *assemblymultibody()
    • *ellipsoids()
    • *mbjoint()
    • *mbplane()
    • *multibodies()
  • Multibody Entities
    • *createellipsoids
    • *createellipsoidsbypoints
    • *mbjointcreate
    • *mbplanecreate
    • *mbplanecreatewithcoords
  • Template Commands
    • *ellipsoids()
    • *mbjoints()
    • *mbplanes()
    • *multibodies()