Home
Altair HyperWorks Tools
Administrative tools to customize your Altair HyperWorks installation.
HyperWorks Automation Toolkit
The HyperWorks Automation Toolkit (HWAT) is a collection of functions and widgets that allows an application to quickly assemble HyperWorks automations with minimal effort and maximum portability.
Functions
Math Functions
::hwat::math::ConvertMatrixToRotations
Convert a cosine matrix into three successive rotations.

What's New
View new features for Altair HyperWorks 2024.1.
Altair HyperWorks Introduction
Quick introduction to Altair HyperWorks products.
Tutorials
Discover the functionality of Altair HyperWorks products with interactive tutorials.
Altair HyperWorks Tools
Administrative tools to customize your Altair HyperWorks installation.
- Altair License Utility
  Use the Altair License Utility to determine a managed Altair Licensing ID, check license usage, borrow licenses, and set up managed Altair Units.
- Altair Compute Console
  Altair Compute Console (ACC) is a utility that allows you to start different Altair HyperWorks Solvers.
- Remote Job Submission
  Remote Job Submission in Altair Compute Console (ACC) is implemented as an alternative to a local run.
- Remote Server User Guide
- AbaqusODB Upgrade
  AbaqusODB UpGrade is a HyperView tool, which upgrades ODB files created in Abaqus 2018 (or earlier) to Abaqus 2023.
- HgTrans
  HgTrans translates solver results files from their native file format to Altair Binary Format (ABF). This can be done using the HgTrans GUI or via the HgTrans batch mode.
- HvTrans
  HvTrans is a result translator for HyperView that translates solver result files to .h3d files.
- HWTK GUI Toolkit
  The HWTK GUI Toolkit is a resource tool for coding Tcl/Tk dialogs. It contains documentation of the HWTK GUI Toolkit commands, demo pages that illustrate our Altair GUI standards, and sample code for creating those examples.
- Cleanup Utility
  The Cleanup Utility is a script for Windows that removes any custom settings that you may have due to the Altair applications installed.
- Model Identification Tool
  The Model Identification Tool (MIT) is a profile in HyperGraph for fitting test data from frequency- and amplitude-dependent bushings to analytical models. The MIT operates in conjunction with HyperGraph, MotionView and MotionSolve to provide you with a comprehensive solution for modeling and analysis.
- Register HVPcontrol
  Register HVPcontrol registers the HVP ActiveX control for HyperView Player.
- HyperWorks Automation Toolkit
  The HyperWorks Automation Toolkit (HWAT) is a collection of functions and widgets that allows an application to quickly assemble HyperWorks automations with minimal effort and maximum portability.
  - Coding Conventions
  - Functions
    - I/O Functions
    - Math Functions
      - ::hwat::math::AngleBetweenVectors
        Finds the angle in degrees between two vectors.
      - ::hwat::math::AverageVectorComponents
        This function will average the vector components.
      - ::hwat::math::CheckReflection
        Check a given cosine matrix for reflection properties.
      - ::hwat::math::CheckTransformMatrix
        Checks the validity of the given transormation matrix.
      - ::hwat::math::ConvertMatrixToRotations
        Convert a cosine matrix into three successive rotations.
      - ::hwat::math::DegreesToRadians
        Converts an angle from degrees to radians.
      - ::hwat::math::GetVector
        Finds the i, j, and k components of a vector given the coordinates of the start and end point.
      - ::hwat::math::IfEqual
        Check the equality of two float numbers.
      - ::hwat::math::IsIdentityMatrix
        Check if the matrix is identity.
      - ::hwat::math::PointOnVector
        Finds a point on a vector at a given distance from the tail (starting point) of the vector. If the distance is given in percentage, it finds a point at percentage of the total vector length.
      - ::hwat::math::RadiansToDegrees
        Converts an angle from radians to degrees.
      - ::hwat::math::VectorAverage
        Finds the average of two vectors.
      - ::hwat::math::VectorCrossProduct
        Finds the cross product of two vectors.
      - ::hwat::math::VectorDotProduct
        Finds the dot product of two vectors.
      - ::hwat::math::VectorMagnitude
        Given a list of values returns the square root of the sum of the squares.
      - ::hwat::math::VectorNormalize
        Given a list of values returns the list after normalization.
    - Solver Functions
    - Utils
    - XML Functions
      These functions use a SAX-based parser.
    - Core Functions
      These are primarily private functions, and are not called directly in most cases. They are usually called privately by other functions as helpers.
- H3D Validation Tools
  The H3D Validation Tools available are H3D Info and H3D Validate.
- Uninstall
  Use the Altair HyperWorks Products Uninstaller to remove all files from the installation directory.

::hwat::math::ConvertMatrixToRotations

Convert a cosine matrix into three successive rotations.

Syntax

::hwat::math::ConvertMatrixToRotations d_MatrixList

Arguments

d_MatrixList: The list contains 9 elements – 3 rotation components for X, Y, and Z respectively

Returns

Success

1; matrix appears to be valid. The ordered rotation list: {rotX rotY rotZ} on success:

rotX – rotation X component
rotY – rotation Y component
rotZ – rotation Z component

Failure

{}; matrix is not valid transform matrix

Example

::hwat::math::ConvertMatrixToRotations $theMatrixList

Comments

The rotation order is always X, then Y, and then Z.