14.0.130 API Programmer's Guide

Elements to Accelerometers

The LS-DYNA keyword *ELEMENT_SEATBELT_ACCELEROMETER has been mapped from the element entity to the accelerometer entity. See the accelerometer data names documentation for more details.

This keyword was previously mapped to elements, using config 103 and type 2. This keyword can now be created using an accelerometer entity with config 101. The ID pool under which it was previously supported was ELEMENT_SEATBELT_ACCELEROMETER_IDPOOL. As this ID pool is no longer required, it has been removed.

Scripts that created or queried the element entity for this keyword must be updated to use the accelerometer entity. Below are a few examples.

To create a *ELEMENT_SEATBELT_ACCELEROMETER keyword, create an accelerometer entity with config 101:
*createentity accelerometer config=101
To update the values of different data names like nodes, gravitational acceleration, integration option or mass values:
*setvalue accelerometers id=$id node1=$node1_id
*setvalue accelerometers id=$id node2=$node2_id
*setvalue accelerometers id=$id node3=$node3_id
*setvalue accelerometers id=$id multi_nodes={$node1_id $node2_id $node3_id}
*setvalue accelerometers id=$id igrav=$igrav_value
*setvalue accelerometers id=$id intopt=$intopt_value
*setvalue accelerometers id=$id mass=$mass_value

Entity Bundles

An entity bundle is persistent grouping of entities designed to be used by GUI widgets that need to store some of their data with the user’s model. Bundle names are unique, and each bundle can have up to 10 entity types. Entities can be added and removed from a bundle by specifying which data number to use.

The name and signature definition of a bundle is part of the HyperWorks Desktop session, but any entity data associated to that bundle is part of the model.

New Commands

Modified Commands

The following commands have modified behavior that potentially require script updates:
  • Data Names
    • contactsurfs - Added new data names node5, node6, node7 and node8. Updated the facetype data name to return 6 or 8 for second order elements, where previously it would return 3 or 4. These changes may require logic updates in Tcl scripts, or in custom templates, where contactsurfs with second order elements are being handled.
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:

Deprecated Commands

While still continuing to work as before, the following are all deprecated by *setoption and may be removed in a future release:
  • *allowduplicateids - Use duplicate_ids instead.
  • *bitmapanimationmode - Use bitmap_animation_mode instead.
  • *centroid1dmode - Use 1d_at_centroid instead.
  • *cleantoleranceset - Use cleanup_tolerance instead.
  • *clipboundaryelements - Use clip_boundary_elements instead.
  • *coincidentnodepickmode - Use coincident_picking instead.
  • *coincidentpickmode - Use coincident_picking instead.
  • *deleteelementsmode - Use delete_elements_mode instead.
  • *detailedelements - Use detailed_elements instead.
  • *detailedelements_beamvis - Use detailed_elements_beamvis instead.
  • *detailedelements_shellvis - Use detailed_elements_shellvis instead.
  • *displayimporterrors - Use display_import_errors instead.
  • *elementhandle - Use element_handle instead.
  • *elementorder - Use element_order instead.
  • *elementsizeset - Use element_size instead.
  • *entityhighlighting - Use entity_highlighting instead.
  • *equationhandle - Use equation_handle instead.
  • *exponentialdisplay - Use exponential_display instead.
  • *featureangleset - Use feature_angle instead.
  • *feoutputtimeinfo - Use feoutput_time_info instead.
  • *fieldofview - Use perspective_fov instead.
  • *fixedpointhandle - Use fixed_point_handle instead.
  • *forcetextblack - Use force_text_black instead.
  • *geometrytoleranceset - Use cleanup_tolerance instead.
  • *geomfeatureangleset - Use geom_feature_angle instead.
  • *geomstitching - Use geom_stitching instead.
  • *graphic_label - Use load_solver_label instead.
  • *graphicsfileblankbackground - Use graphics_file_blank_background instead.
  • *graphicsimplificationmode - Use graphics_simplification_component and graphics_simplification_mode instead.
  • *loadhandle - Use load_handle instead.
  • *loadlabel - Use load_label instead.
  • *loadlabelsetcolor - Use load_label_color instead.
  • *loadsize - Use load_size_magnitude, load_size_type and load_size_uniform instead.
  • *loadvisualvector - Use load_visual_vector instead.
  • *mixedpropertywarning - Use mixed_property_warning instead.
  • *morphupdateparameter domainicons - Use domain_handle instead.
  • *perspectiveview - Use perspective_view instead.
  • *picktoleranceset - Use pick_tolerance instead.
  • *resultcolormode - Use contour_type instead.
  • *retainloads - Use retain_loads instead.
  • *rotationangleset - Use rotation_angle instead.
  • *rotationcentermode - Use rotation_center_mode instead.
  • *setautomeshcolormode - Use auto_mesh_color_mode instead.
  • *setbackgroundcolors - Use background_colors instead.
  • *setelementcolormode - Use element_color_mode instead.
  • *setelementinternaledgesmode - Use element_internal_edges_mode instead.
  • *setgeomrefinelevel - Use geom_refine_level instead.
  • *sethvlaunchflag - Use hv_launch_flag instead.
  • *setlodthreshold - Use lod_threshold instead.
  • *setmeshlinecolor - Use mesh_line_color instead.
  • *setmeshlodthreshold - Use mesh_lod_threshold instead.
  • *setmeshtransparency - Use mesh_transparency instead.
  • *setperformancenormalmode - Use performance_normal instead.
  • *setscaleoption - Use scale_color, scale_height, scale_position and scale_width instead.
  • *settopologydisplay - Use topology_display_mode instead.
  • *settopologydisplaymode - Use topology_display_mode instead.
  • *settopologyedgedisplay - Use topology_edge_display_mode instead.
  • *settopologysoliddisplay - Use solid_transparency and topology_solid_display_mode instead.
  • *settransparentwithmeshlines - Use transparent_with_mesh_lines instead.
  • *showcompositelayers - Use show_composite_layers instead.
  • *showgeomlinedir - Use show_line_dir instead.
  • *showglobalaxes - Use show_global_axes instead.
  • *showscale - Use show_scale instead.
  • *shrink - Use shrink_factor and shrink_mode instead.
  • *stereodisplay - Use stereo_display instead.
  • *surfaceuvlines - Use surface_uv_lines instead.
  • *systemsize - Use system_size_uniform instead.
  • *tagdisplay - Use tag_display instead.
  • *tagtextdisplaymode - Use tag_text_display_mode instead.
  • *thick1dlines - Use thick_1d_lines instead.
  • *thickmeshlines - Use thick_mesh_lines instead.
  • *toleranceset - Use node_tolerance instead.
  • *vectorautoscale - Use vector_auto_scale instead.
  • *vectordrawoptions - Use vector_size_magnitude, vector_size_type and vector_size_uniform instead.
  • *vectorhandle - Use vector_handle instead.
  • *vectorlabel - Use vector_label instead.
  • *zoomfactorset - Use mesh_line_color instead.
  • hm_blockerrormessages - Use block_error_messages instead.
  • hm_blockmessages - Use block_messages instead.
  • hm_blockredraw - Use block_redraw instead.
  • hm_buffercommandfile - Use buffer_command_file instead.
  • hm_commandfilestate - Use command_file_state instead.
While still continuing to work as before, the following are all deprecated by hm_getoption and may be removed in a future release:
  • hm_blockerrormessages - Use block_error_messages instead.
  • hm_blockmessages - Use block_messages instead.
  • hm_commandfilestate - Use command_file_state instead.
  • hm_getcleanuptol - Use cleanup_tolerance instead.
  • hm_getdeleteelementsmode - Use delete_elements_mode instead.
  • hm_getdisplaycolor - Use background_colors instead.
  • hm_getelementsize - Use element_size instead.
  • hm_getloadoption - Use equation_handle, load_handle, load_label, load_size_magnitude, load_size_type, load_size_uniform and load_solver_label instead.
  • hm_getmeshlinecolor - Use mesh_line_color instead.
  • hm_getnodetol - Use node_tolerance instead.
  • hm_gettopologyoption - Use solid_transparency, topology_edge_display_mode and topology_solid_display_mode instead.
  • hm_getsystemoption - Use system_size_uniform instead.
  • hm_getvectoroption - Use vector_auto_scale, vector_handle, vector_label, vector_size_magnitude, vector_size_type and vector_size_uniform instead.
  • hm_morph_getinfo parameter domainicons - Use domain_handle instead.
While still continuing to work as before, the following hm_info options are deprecated by hm_getoption and may be removed in a future release:
  • automeshcolormode - Use auto_mesh_color_mode instead.
  • blockredraw - Use block_redraw instead.
  • clipboundaryelements - Use clip_boundary_elements instead.
  • displayimporterrors - Use display_import_errors instead.
  • duplicateids - Use duplicate_ids instead.
  • elementcolormode - Use element_color_mode instead.
  • elementinternaledgesmode - Use element_internal_edges_mode instead.
  • entityhighlighting - Use entity_highlighting instead.
  • fieldofview - Use perspective_fov instead.
  • geomrefinelevel - Use geom_refine_level instead.
  • geomstitching - Use geom_stitching instead.
  • lodthreshold - Use lod_threshold instead.
  • meshlinecolor - Use mesh_line_color instead.
  • meshlodthreshold - Use mesh_lod_threshold instead.
  • meshtransparency - Use mesh_transparency instead.
  • mixedpropertywarning - Use mixed_property_warning instead.
  • perspectiveview - Use perspective_view instead.
  • picktolerance - Use pick_tolerance instead.
  • retainloads - Use retain_loads instead.
  • rotationangle - Use rotation_angle instead.
  • rotationcentermode - Use rotation_center_mode instead.
  • scalecolor - Use scale_color instead.
  • scaleheight - Use scale_height instead.
  • scaleposition - Use scale_position instead.
  • scalewidth - Use scale_width instead.
  • showcompositelayers - Use show_composite_layers instead.
  • showglobalaxes - Use show_global_axes instead.
  • showscale - Use show_scale instead.
  • shrinkoptionvalue - Use shrink_factor instead.
  • shrinkvalue - Use shrink_mode instead.
  • stereodisplay - Use stereo_display instead.
  • surfaceuvlines - Use surface_uv_lines instead.
  • topologydisplaymode - Use topology_display_mode instead.
  • transparentwithmeshlines - Use transparent_with_mesh_lines instead.
  • zoomfactor - Use zoom_factor instead.
While still continuing to work as before, the following hm_getoption options have been deprecated in favor of renamed options and may be removed in a future release:
  • displayscale - Use show_scale instead.
  • fixed_points - Use fixed_point_handle instead.
  • geometryhandle - Use line_handle instead.
  • geomstitching - Use geom_stitching instead.
  • loadvisualvector - Use load_visual_vector instead.
  • outputtimeinfo - Use feoutput_time_info instead.
  • perspective_value - Use perspective_fov instead.
  • outputtimeinfo - Use feoutput_time_info instead.
  • shrink_value - Use shrink_factor and shrink_mode instead.
  • tagdisplay - Use tag_display instead.
  • tagtextdisplaymode - Use tag_text_display_mode instead.
  • view_acceleration - Use graphics_simplification_mode instead.