hm_info

Query general information about HyperMesh options and paths.

Syntax

hm_info option|-appinfo info_option ?value?

Type

HyperMesh Tcl Query

Description

This command returns general information about HyperMesh options and paths.

Inputs

-appinfoinfo_option
Valid info_option values are:
  • ALTAIR_HOME: Current installation base directory.
  • ARCHITECTURE: Current system architecture.
  • COPYRIGHT: The HyperWorks copyright text.
  • CURRENTWORKINGDIR: Current working directory.
  • DISPLAYVERSION: The full application version number (e.g. 10.0b40).
  • EXECUTABLEDIR: Full directory path of the application’s executable. Same as HMBIN_DIR.
  • EXECUTABLEPATH: Full directory path and file name of the application’s executable.
  • HMBIN_DIR: Full directory path of the application’s executable. Same as EXECUTABLE_DIR.
  • LICENSE_FEATURE: Application’s license feature.
  • LICENSEVERSION: Application’s license version.
  • NAME: Get the applications name.
  • PATCH_NUMBER: The base application patch number (e.g. 101, 102).
  • SPECIFIEDPATH type: Full path name of the specified type. Valid type values are:
    • altair_lic.dat
    • EXTERNALFUNCS_DIR
    • EXTERNALREADERS_DIR
    • EXTERNALWRITERS_DIR
    • hm
    • hm_dll_readers
    • hm_feinput_readers
    • hm_mac
    • hm_module
    • hm_scripts_dir
    • hm_user_profiles
    • hm40_translator
    • hw_help_dir
    • hw_readers
    • hw_tcl_common
    • hyperbeam
    • hypercrash
    • mv_solver_writers
    • nastran_to_abaqus_converter
    • radioss_launchdir
    • standard_statistics_template
    • tcl_lib
    • TEMPLATES_DIR
    • tk_lib
    • TRANSLATORS_DIR
    • wish
  • SUPPORTEMAIL: The HyperMesh tech support email address.
  • TITLE: Title of the application.
  • VERSION: The base application version number (e.g. 10.0).
  • XDISPLAYNAME: The name of the current X display.
analysisfileset
Returns 1 if the global results file is set; 0 otherwise. Identical to resultfileset.
automeshcolormode
Returns the value set by *setautomeshcolormode. See also meshlinecolor.
blockredraw
Returns the block redraw value set by hm_blockredraw.
cardprev_displayed
Returns 1 if the card previewer is displayed; 0 otherwise.
clipboundaryelements
Returns the clip boundary elements value set by the *clipboundaryelements command.
commandfilename
Full path and file name of the command file from the "files" panel. This option cannot be used in HyperMesh Batch Mode.
currentcollector type
Returns the current collector ID of the specified type or 0 for no current collector. Valid type values are beamsectcol, comp, loadcol, module, multibody, systcol, and vectorcol.
currentcomponent
Returns the current component collector ID.
currentinclude
Returns the current include file shortname.
currentfile
Full path and file name of the current HyperMesh database. Identical to hmfilename.
database_empty
Returns 1 if the database is empty; 0 otherwise.
database_modified
Returns 1 if the database has been modified since the last save operation; 0 otherwise.
displayimporterrors
Returns the display import errors value set by *displayimporterrors.
duplicateids
Returns 1 if the allow duplicate IDs option is enabled; 0 otherwise.
elementcolormode
Returns the element color mode value set by *setelementcolormode.
elementinternaledgesmode
Returns the value set by *setelementinternaledgesmode.
elems_cleanup
Returns 1 if the user is in the quality index panel; 0 otherwise.
emptylist entity_type
Returns the list of empty entities of the given entity_type. Valid entity_type values are: assems and comps
entityhighlighting
Returns the entity highlighting value set by *entityhighlighting.
entity_types_allowing_undefined
Returns the entity types that are supported as allowing undefined entities.
executing_command
Returns 1 if HyperMesh is currently in the process of executing a command; 0 otherwise.
exportfilename
Full path and file name of the export file from the "files" panel. This option cannot be used in HyperMesh Batch Mode.
exporttemplate
Full path and file name of the export template from the "files" panel. This option cannot be used in HyperMesh Batch Mode.
functionlock
Returns 1 if HyperMesh is currently in the function lock mode due to being in a secondary menu like automeshing; 0 otherwise.
geomrefinelevel
Returns the current geometry refinement level value from *setgeomrefinelevel.
geomstitching
Returns the current geometry automatic stitching mode from *geomstitching.
geomstyle
Returns the geometry color mode value set by *settopologydisplaytype.
hmfilename
Full path and file name of the current HyperMesh database. Identical to currentfile.
hyperstudy_running
Returns 1 if HyperStudy is currently in the process of running after being launched from HyperMesh; 0 otherwise.
importfilename
Full path and file name of the import file from the "files" panel. This option cannot be used in HyperMesh Batch Mode.
importtranslator
Full path and file name of the import translator from the "files" panel. This option cannot be used in HyperMesh Batch Mode.
istemplateloaded
Returns 1 if a template file is loaded; 0 otherwise.
lastselectedentity entity_type
Returns the ID of the entity of the specified entity_type that has been selected using *createentitypanel. This command must be called immediately after the *createentitypanel command. If there are any errors or no entity has been selected, the value returned will be 0.
lodthreshold
Returns the value set by *setlodthreshold.
macrofilename
Full path and file name of the macro file. This option cannot be used in HyperMesh Batch Mode.
macromenupage
Returns the page number that the Utility tab is currently set to.
meshlinecolor
Returns the value set by *setmeshlinecolor. See also automeshcolormode.
meshlodthreshold
Returns the value set by *setmeshlodthreshold.
meshtransparency
Returns the value set by *setmeshtransparency.
mixedpropertywarning
Returns the value set by *mixedpropertywarning.
picktolerance
Returns the pick tolerance value set by *picktoleranceset.
plottingdisplay
Returns 1 if HyperMesh is currently involved in a plotting process that makes use of the alternative display list (fill plot for hidden lines, contour, etc…); 0 otherwise.
plythicknessfactor
Returns the ply thickness factor value set by *plythicknessfactor.
prompting
Returns 1 if HyperMesh is currently prompting the user for an immediate response using an Overlay or a Popup; 0 otherwise.
pushtofront entity_type
Returns the value set by *pushtofront for the specified entity type. Currently only supported for tags.
readingfile
Returns 1 if HyperMesh is currently in the process of reading an HM file; 0 otherwise.
resultfilename
Full path and file name of the result file.
resultfileset
Returns 1 if the global results file is set; 0 otherwise. Identical to analysisfileset.
retainloads
Returns the retain loads value set by *retainloads.
reviewmode
Returns the review mode value set by *setreviewmode.
rotationangle
Returns the rotation angle value set by *rotationangleset.
rotationcentermode
Returns the value set by *rotationcentermode.
rotationcenteroffscreen
Returns the value set by *rotationcenteroffscreen.
scalecolor
Returns the scale color set by *setscaleoption.
scaleheight
Returns the scale height set by *setscaleoption.
scaleposition
Returns the scale position set by *setscaleoption.
scalewidth
Returns the scale width set by *setscaleoption.
showcompositelayers
Returns the show composite layers visualization mode set by *showcompositelayers.
showglobalaxes
Returns the global axes visualization state set by *showglobalaxes.
showscale
Returns the scale visualization state set by *showscale.
shrinkvalue
Returns the element shrink value set by *shrink if shrink is enabled; 0 otherwise.
shrinkoptionvalue
Returns the element shrink value set by *shrink, regardless of if shrink is enabled.
somethingtoreject
Returns 1 if the reject operation will have any effect if executed now; 0 otherwise.
surfaceuvlines
Returns the value set by *surfaceuvlines.
templatecodename
The name reported from the current template’s *codename() command.
templatefilename
Full path and file name of the current tempate file.
templateid
The ID reported from the current template’s *codename() command.
templatetype
Current template type. This is one of the predefined template types, currently one of the following: nastran, abaqus, marc, autodv, hyperopt, pamcrash, patran, ansys, lsdyna, dytran, simex, phlex, pdm, masterfile, or none. Some template type names are not reported. For example, a madymo template will be reported as an lsdyna template.
tempnam
Full path and file name of a temporary file. The value returned from each call is unique.
topologydisplaymode
Returns the value set by *settopologydisplaymode.
transparentwithmeshlines
Returns the value set by *settransparentwithmeshlines.
unusedlist entity_type
Returns the list of unused entities of the given entity_type. The list will contain names for named entity types and IDs for all other types. Valid entity_type values are curves, contactsurfs, ellipsoids. mats, mbjoints, props, and systs.
writeviewcommands
Returns the value set by hm_writeviewcommands or the -nowriteviewcommands start-up option.
zoomfactor
Returns the zoom factor set by *zoomfactorset.

Examples

To get the path to the Altair home directory:

set trans_dir [hm_info -appinfo ALTAIR_HOME]

To get the path to the translators directory:

set trans_dir [hm_info -appinfo SPECIFIEDPATH TRANSLATORS_DIR]

To get the current vector collector:

set cur_veccol [hm_info currentcollector vectorcol]

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}