2017.1 API Programmer's Guide

To create an *ELEMENT_SEATBELT_PRETENSIONER keyword, create a pretensioner entity with config 101:

*createentity pretensioner config=101

To update the values of different data names like type, sensorid1,curveid and pretensioner_time:

*setvalue pretensioner id=$id type=$type
*setvalue pretensioners id=$id sensorid1=$sensor1id
*setvalue pretensioners id=$id curveid=$curveid
*setvalue pretensioners id=$id pretensioner_time=$time

To create an *ELEMENT_SEATBELT_RETRACTOR keyword, create a retractor entity with config 101:

*createentity retractor config=101

To update the values of different data names like type, sensorid1,retractornodeid and pull:

*setvalue retractor id=$id type=$type
*setvalue retractor id=$id sensorid1=$sensor1id
*setvalue retractor id=$id retractornodeid=$retractornodeid
*setvalue retractor id=$id pull=$pull

To create an *ELEMENT_SEATBELT_SLIPRING keyword, create a slipring entity with config 101:

*createentity slipring config=101

To update the values of different data names like type, seatbeltelemid1,lockuptime and funcid:

*setvalue slipring id=$id type=$type
*setvalue slipring id=$id seatbeltelemid1=$seatbeltelemid1
*setvalue slipring id=$id lockuptime=$lockuptime
*setvalue slipring id=$id funcid=$funcid

To create a *HOURGLASS keyword, create an hourglass entity with config 101:

*createentity hourglass config=101

To update the values of different data names like controlType, coeff,bulkViscosity and viscosityDampCoeff:

*setvalue rigidwalls id=$id controlType=$controlType
*setvalue rigidwalls id=$id coeff=$coeff
*setvalue rigidwalls id=$id bulkViscosity=$bulkViscosity
*setvalue rigidwalls id=$id viscosityDampCoeff=$viscosityDampCoeff

• Collision
  • *collisioncheck_temp
  • *collisioncheck2_temp
  • *collisionfix_temp
  • *collisionrecheck_temp
• Connectors
  • hm_ce_getglobalsharedentitysettings
  • *CE_FE_AutoRegisterSharedEntitiesByMark
  • *CE_FE_RegisterSharedEntities
  • *CE_FE_RegisterSharedEntitiesByMark
  • *CE_FE_UnregisterSharedEntitiesByMark
  • *CE_SetGlobalSharedEntitySettings
• Composites
  • *plydrape
• Data Names
  • collisions
  • contactgroups
  • hourglass
  • panels
  • partsets
  • pretensioners
  • retractors
  • sliprings
• General/Core
  • *alternatefejointcreate
  • *alternatefejointupdate
  • *readnodepositionsfromdynainfile
  • *readnodepositionsfromh3dfile
  • *setentitytypesupportedbyenggid
  • *setsubmodeltype
  • *specialelements
• Geometry
  • hm_getgeomtopologytype
  • hm_getmidsurfcomp
  • *fixnarrowsurfaces
  • *midsurface_remove_plate_base_conflicts
  • *midsurface_unsuppress_conflict_edges
• HMASCII
  • *collisions()
  • *contactgroups()
  • *hourglass()
  • *panels()
  • *partsets()
  • *pretensioners()
  • *retractors()
  • *sliprings()
• Meshing
  • *hm_auto_elem_cleanup_new
• Model Checker
  • hm_getmodelcheckfailedcount
• Modules/Parts
  • hm_me_childrenget
  • hm_me_entitiesall
  • hm_me_entitiesget
  • hm_me_moduleget
  • hm_me_parentsget
  • *ME_ModuleOccurrencesPurge
  • *ME_ModuleOccurrencesReparent
• Template Commands
  • *collisions()
  • *contactgroups()
  • *hourglass()
  • *panels()
  • *partsets()
  • *pretensioners()
  • *retractors()
  • *sliprings()
• Template Functions
  • @getattributearrayvaluebyinternalid1()
  • @getattributearrayvaluebyinternalid2()
  • @writenastranoldcontact()

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:

• Collision
  • hm_collisionentitycreate - Updated the option descriptions to indicate their support for the opcode vs. collirad engines. Added values 100 and 200 to thickness_type.
  • hm_collisiongetconfig - Updated the option descriptions to indicate their support for the opcode vs. collirad engines, and the hm_collisioninit and *collisioncheck2_temp commands. Added constant_gap, edge2edge, intersections, neighborhood, penetrations, self and thick_reduction options for *collisioncheck2_temp.
• Contact
  • *detectandcreateface2facecontacts - Added support for Nastran (MSC).
• Data Names
  • crosssections - Added new data names cutplanegeometrytype, DisplayMode and offset.
  • designvars
    • free shape s
    • topography - Added new data names drawdirectiontoggle, patterngroupingtype, patterngroupingsubtype, reflective, tgboundaryskip, tganchorpointtriple, tgfirstgridtriple, tgsecondgridtriple, topography_bufferzone, topographymasterslave and topographymasterptr.
  • joints - Added new data names xsecondaryaxis, ysecondaryaxis and zsecondaryaxis.
  • modules - Added new data name rep_name.
  • optidscreens - Added new data names autolevel, autotoggle, cfailuremaxc, cfailurethreshold, cfailuretoggle, cogmaxc, cogthreshold, cogtoggle, cstraingtoggle, cstrainmaxc, cstrainthreshold, cstressmaxc, cstressthreshold, cstresstoggle, externalmaxc, externalthreshold, externaltoggle, forcemaxc, forcethreshold, forcetoggle, fracclmaxc, fracclthreshold, fraccltoggle, frdispmaxc, frdispthreshold, frdisptoggle, freqtoggle frequencymaxc, frequencythreshold, frerpmaxc, frerpthreshold, frerptoggle, frstrnmaxc, frstrnthreshold, frstrsmaxc, frstrsthreshold, frstrstoggle, frevelomaxc, frevolothreshold, frevolotoggle, inertiamaxc, inertiathreshold, inertiatoggle, lamamaxc, lamathreshold, lamatoggle, massfracmaxc, massfracthreshold, massfractoggle, massmaxc, massthreshold, masstoggle, strainmaxc, strainthreshold, straintoggle, volumefracmaxc, volumefracthreshold, volumefractoggle, volumemaxc, volumethreshold and volumetoggle.
  • optiresponses - Added new data names coord, coordinateoptions, coordcid, dreport, dreport_loadsteps, lallow, nl, nu and uallow.
  • regions - Added topo value 33 for 3-d soilds.
• General/Core
  • *convertlegacyentities - Added support for Nastran (MSC) groups to contactgroups conversion.
  • *createmark/hm_createmark/*appendmark/hm_appendmark - Added new "by topology" method.
  • *setoption - Added new options anti_aliasing, edge_lod_threshold, edge_lod_width_auto, lighting_mode, specular_intensity and solidedge_width.
  • *solverconvert - Added a new optional argument config_file_path. Updated list of supported solver versions.
• GUI
  • hm_getdirectionpanel/hm_getfilename/hm_getfloat/hm_getint/hm_getplanepanel/hm_getstring - Added new optional default_value argument.
• Geometry
  • hm_getedgeloops - Fixed issues where the command would return an extra space at the end of each sublist, and where masked/hidden entities were not being considered even though they were on the input mark.
  • hm_getsurfacesfromsolid - Added new optional argument type to filter the found and returned surfaces.
• Meshing
  • *compute_midmesh_thickness - New options AssignMidIntervalAsThickness, FixedInterval and StartThickness added to support thickness grouping into intervals.
  • *delete_logo - Solids are now supported.
  • *elementtestconnectivity - Now flags mid-side nodes connected to corner nodes as invalid.
  • *findflangesproximityshell - The last argument, previously reserved for future use, is now used to define the max_variation_percentage. Legacy behavior is not affected.
  • *normalsadjust2 - Added a new value of 4 for mode and a new optional argument feature_angle to support the auto adjustment of element normals, with the connected selection adjusted based on the feature angle.
  • *tetmesh - Added aft/delauney/octree values for the pars string.
• Modules/Parts
  • *ME_ModuleOccurrencePurge - Added new options values excluded_entity_type and reset_representation.

• Graphics
  • *setspecularity - Use *setoption lighting_mode=0, with specular_intensity to set the specular values instead.
• Meshing
  • *hm_auto_elem_cleanup - Use *hm_auto_elem_cleanup_new instead.