Home
API, Reference Guides
Overview of external readers and the Altair Binary Format, the generic ASCII reader, running applications in batch mode, using Tcl/Tk commands, translators, and result math.
HyperMesh
FE Input Readers
FE input readers are C programs that read information from ASCII or binary finite element models files into the HyperMesh database.
Commands and Functions
hmreslib Functions
Conversion and Math Functions
HMRES_calculateprincipals()
Calculates principal stresses given triaxial and shear stresses.

Welcome
What's New
View new features for version 2025.1.
Get Started
Learn the basics and discover the workspace.
Tutorials
Discover product functionality with interactive tutorials.
API, Reference Guides
Overview of external readers and the Altair Binary Format, the generic ASCII reader, running applications in batch mode, using Tcl/Tk commands, translators, and result math.
- Extensions
  Extensions are programs integrated with the application to enhance or extend the user experience.
- External Readers and Altair Binary Format
  Altair Binary Format (ABF) is the standard binary format read by the program. A library called abflib allows you to create files in ABF.
- Generic ASCII Reader
  A generic ASCII reader is now available which allows you to bring custom results directly into HyperView. The Altair ASCII format is useful for reading the results of any in-house or propriety codes which are saved in a generic format.
- Batch Mode
  Batch mode allows you perform a series of operations outside the program interface.
- External Resources
  External resources can be registered in preference files, session files, or Templex files. If an external resource is registered in a program session, it is automatically registered in the session file when the session is saved.
- Python API
  The Python API documentation for HyperMesh applications.
- Tcl/Tk Commands
  The application's scripting interface is a set of Tcl/Tk commands that follow a simple and consistent syntax.
- Translators
  Translators are utilities that are run from the command line of the operating system to convert various types of files into different formats.
- Result Math
  XML commands in the Result Math Module.
- HWC Console
  Record playback workflows in the application.
- HyperMesh Report
- Task Manager
  Use the Task Manager to load an XML file that defines tasks and their attributes.
- HyperMesh
  - API Programmer's Guides
    These provide an overview of all additions, updates, and changes to the HyperMesh APIs for each release.
  - Data Names
    Details on the core data that can be queried and manipulated.
  - Ext API
    This API allows external applications to link HyperMesh as a library and provides a limited set of functions and structures to access specific functionality.
  - FE Input Readers
    FE input readers are C programs that read information from ASCII or binary finite element models files into the HyperMesh database.
    - Result Readers
    - hmlib
      hmlib is a library which contains a set of routines to aid you in writing a C program.
    - hminlib
      hminlib is a set of routines which allows you to write an external input translator.
    - hmmodlib
      hmmodlib is a library of C routines which allows you to perform results translation of more complex data types, such as integration point results or node-on-element results.
    - hmreslib
    - Create FE Input Readers
    - Commands and Functions
      - hmlib Functions
      - hminlib Functions
      - hmmodlib Functions
      - hmreslib Functions
        Argument Functions
        Conversion and Math Functions
        HMRES_calculateprincipals()
        Calculates principal stresses given triaxial and shear stresses.
        HMRES_calculatevonmises()
        Calculates the vonMises stress given triaxial and shear stresses.
        HMRES_convertbuffertodouble()
        Converts a buffer containing floating point information from one machine type to another machine type.
        HMRES_convertbuffertofloat()
        Converts a buffer containing floating point information from one machine type to another machine type.
        HMRES_convertbuffertoint()
        Converts a buffer containing integer information from one machine type to another machine type.
        HMRES_convertdoublebuffer()
        Converts a buffer containing floating point information from one machine type to another machine type.
        HMRES_convertfloatbuffer()
        Converts a buffer containing floating point information from one machine type to another machine type.
        HMRES_convertintbuffer()
        Converts a buffer containing integer information from one machine type to another machine type.
        HMRES_magnitudephasetorealimaginary()
        Use to convert a complex number in magnitude/phase format to real/imaginary format. This function modifies the values passed.
        HMRES_readbinaryfloat()
        Reads a floating-point number from a binary file which opened with HMRES_openinputfile(). It pays attention to the cross platform flags and does a conversion on the number, making it understandable to the machine the program is running on.
        HMRES_readbinaryint()
        Reads a binary integer from a binary file opened with HMRES_openinputfile(). It pays attention to the cross platform flags and does a conversion on the integer, making it understandable to the machine the program is running on.
        HMRES_readbinaryint2()
        Reads a 2-byte integer from a binary file opened with HMRES_openinputfile(). It pays attention to the cross-platform flags and does a conversion on the number, making it understandable to the machine on which the program is running.
        HMRES_realimaginarytomagnitudephase()
        Use to convert a complex number in real/imaginary format to magnitude/phase format. This function modifies the values passed.
        Data Type Functions
        Result Record Functions
        Simulation Functions
        Utility Functions
  - HMASCII
    Details on the HMASCII format and associated commands.
  - Scripts
    This section contains details on general HyperWorks scripting concepts, along with documentation on the Tcl commands that can be used to query and modify the database and GUI.
  - Solver Templates
    Solver templates are ASCII data files containing HyperMesh Template Language Commands and HyperMesh Template Language Functions.
- MotionView
- Templex and Math Reference Guide
- Script and Model Library
  The Script and Model Library is a database of freely accessible scripts and models posted by users and Altair engineers.

HMRES_calculateprincipals()

Calculates principal stresses given triaxial and shear stresses.

Syntax

void HMRES_calculateprincipals(double sigx, double sigy, double sigz, double tauxy, double tauyz, double tauxz, double *principal1, double *principal2, double *principal3);

Type

HyperMesh hmreslib Function

Description

Calculates principal stresses given triaxial and shear stresses.

Inputs

sigx: The normal stress in the x-direction.
sigy: The normal stress in the y-direction.
sigz: The normal stress in the z-direction.
tauxy: The shear stress in the x-y plane.
tauyz: The shear stress in the y-z plane.
tauxz: The shear stress in the x-z plane.
principal1: The principal1 stress result.
principal2: The principal2 stress result.
principal3: The principal3 stress result.

Errors

None.