HyperWorks Desktop

Home
HyperWorks Desktop Reference Guides
Overview of external readers and the Altair Binary Format, the generic ASCII reader, running HyperWorks in batch mode, using Tcl/Tk commands, translators, and result math.
HyperWorks Desktop
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.
Import Templates
Import templates are files that contain instructions for reading plot data files.
Import Statements
null
Causes the results of the current input operation to be ignored.

What's New
Get Started
Tutorials
Startup Procedures and Customizations
Manage Files and Data
Display Controls
Session Navigation
Publish Sessions
Parameterize Report Templates
Workflow Automation
HyperWorks Collaboration Tools
HyperWorks Desktop Reference Guides

HyperWorks Desktop

What's New
View new features for HyperWorks Desktop 2020.
Get Started
Learn the basics and discover the workspace.
Tutorials
Discover HyperWorks Desktop functionality with interactive tutorials.
Startup Procedures and Customizations
Start HyperWorks Desktop and configure the applications.
Manage Files and Data
Learn how to create, open, import and save models.
Display Controls
Control the view and display of your model in the modeling window.
Session Navigation
Use the Session Browser to view the current session and all the pages and windows it contains in a hierarchical display.
Publish Sessions
Publish your HyperWorks Desktop session to HTML, PowerPoint, or Report files.
Parameterize Report Templates
Use the Parameters Browser to parameterize the contents of a session file or report template and automate a variety of analysis processes with the Parameters Browser.
Workflow Automation
Automate common workflows using the Process Manager or Automate tool.
HyperWorks Collaboration Tools
Explore, organize and manage your personal data, collaborate in teams, and connect to other data sources, such as corporate PLM systems to access CAD data or publish simulation data.
HyperWorks Desktop Reference Guides
Overview of external readers and the Altair Binary Format, the generic ASCII reader, running HyperWorks in batch mode, using Tcl/Tk commands, translators, and result math.
- HyperWorks Desktop
  - 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.
    - External Resources for Preference Files
    - External Resources for Session Files
    - External Resources for Templex Files
    - Import Templates
      Import templates are files that contain instructions for reading plot data files.
      - Import Language
        Import is an interpretive computer language designed specifically to create templates for reading plottable data files, such as XY data or time-histories. It is not a general purpose language, like C or BASIC. Import focuses on reading data files in the fastest most reliable manner.
      - Import Template Structure
        Each template typically consists of four sections or blocks.
      - Read Import Data
        Import templates are based on sequential access. All commands that read information, with the exception of integer variables, transfer data into a list or an array.
      - Data Flow Control
        Import contains provisions for jumping ahead in a file and then backing up (using rewind).
      - Errors and Error Handling
        Many import commands can result in a failure condition. This means that the template cannot complete the execution of a command in a meaningful fashion.
      - Conditional Execution
        The only time that a failure condition does not terminate execution is if it occurs in an if block.
      - Loops
        Besides conditional execution, Import also supports iteration.
      - Variables and Integer Math
        Integer variables can be declared anywhere in the global block of a template by using the int directive.
      - MADYMO Example
      - ADAMS Example
      - Import Statements
        
        //
        Marks the beginning of a comment.
        
        {
        Begins program block.
        
        }
        Terminates a program block.
        
        =
        Sets the variable to the left of the "=" to the value of the expression on the right.
        
        assume
        Indicates that the following assumption can be made about a file format.
        
        ccount
        Counts the occurrences of one character in a data file before the next occurrence of a terminal character.
        
        compname
        A reserved variable which holds a list of the component names.
        
        component
        A reserved variable holding the list of component values for the current request.
        
        components
        Specifies the names of one or more components.
        
        count
        Counts the number of lines containing an occurrence of one regular expression in a file before another regular expression is encountered.
        
        demangle
        Sets a protocol for reversing the mangling process on requests.
        
        do
        Initiates a loop.
        
        else
        Executes the following program block only if the last if statement returned false; that is, failed.
        
        explicit
        Declares the presence of an expected feature in the file; that is, time values.
        
        fileext
        Compares the filename extension of the data file to a string.
        
        filename
        Compares the name of the current data file to a regular expression.
        
        find
        Searches the current data file until a regular expression is encountered.
        
        header
        Marks the beginning of first block of the template.
        
        if
        Stores the outcome of the following program block for determining the execution of program branches later on.
        
        int
        Declares an integer variable.
        
        isalpha
        Tests the next character in the input stream to see if it is alphabetic.
        
        isdigit
        Tests the next character in the input stream to see if it is a digit.
        
        linear
        Indicates that each request in the file is contained on one and only one line.
        
        long
        Declares that the distinction between long and short request names is valid.
        
        longname
        A reserved variable which holds a list of the long request names.
        
        magnitude
        Takes the magnitude of a three dimensional vector.
        
        mangle
        Combine several strings to specify the names of one or more requests.
        
        mark
        Records the current file position.
        
        mark2
        Records the secondary file position.
        
        maxfind
        Reserved variable holding the maximum number of lines to search.
        
        names
        Declares that the distinction between long and short request names is valid.
        
        null
        Causes the results of the current input operation to be ignored.
        
        numcomponents
        A predefined variable which holds the number of components in a file.
        
        numrecords
        A predefined variable which holds the number of records in a file.
        
        numrequests
        A predefined variable which holds the number of requests in a file.
        
        precision
        A predefined variable which defines the number of decimal places used when reading floating point values.
        
        print
        Sends a message to the message log.
        
        qcount
        Counts the number of lines containing an occurrence of one regular expression in a file before another regular expression is encountered.
        
        qfind
        Searches the current data file until a string is encountered.
        
        read
        Reads an integer, floating point number or short string (one word or token).
        
        readln
        Reads an integer, floating point number, or string.
        
        record
        Marks the start of the program block which handles the reading of each record from the file.
        
        request
        A reserved variable holding the list of request values for the current record.
        
        requests
        Specifies the names of one or more requests.
        
        rewind
        Return the file to the last position marked.
        
        rewind2
        Return the file to the last secondary position marked.
        
        set
        Sets an integer variable to the value of a constant, variable or simple function.
        
        shortname
        List of short request names.
        
        start
        Mark the beginning of the data to be read.
        
        strict
        Causes the read or readln statement to compare a string read from the data file to a regular expression.
        
        sum
        Takes the sum of two integer values.
        
        then
        Indicates that the following block should be executed if the result of the last if statement was true.
        
        time
        Directs a read statement to assume that the next request in the file contains only one component; that is, it’s time-like).
        
        type
        Sets the default data type for a file format.
        
        types
        Sets the data types of one or more requests.
        
        units
        Specifies the number of time units per second.
        
        until
        Truncates a line read by the readln command.
    - Export Templates
      Export templates are Templex programs that export curve data to files.
    - External Functions - Altair IPC
      You can create external programs for processing plot data in the program using the C programming language. Altair IPC, or inter-process communication, allows you to exchange data between the Altair program and an external program.
  - Tcl/Tk Commands
    The HyperWorks Desktop 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.
  - HyperWorks Record and Playback
    Record playback workflows in HyperView.
- HyperWorks Report
- HyperMesh
- MotionView
- Templex and Math Reference Guide
- Script Exchange
  The Script Exchange is a database of freely accessible scripts posted by users and Altair engineers.

View All Altair HyperWorks Help

HyperWorks Desktop

Home
HyperWorks Desktop Reference Guides
Overview of external readers and the Altair Binary Format, the generic ASCII reader, running HyperWorks in batch mode, using Tcl/Tk commands, translators, and result math.
HyperWorks Desktop
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.
Import Templates
Import templates are files that contain instructions for reading plot data files.
Import Statements
null
Causes the results of the current input operation to be ignored.

What's New
Get Started
Tutorials
Startup Procedures and Customizations
Manage Files and Data
Display Controls
Session Navigation
Publish Sessions
Parameterize Report Templates
Workflow Automation
HyperWorks Collaboration Tools
HyperWorks Desktop Reference Guides

null

Causes the results of the current input operation to be ignored.

Syntax

read null

or

readIn null

Comments

Causes the word, number or line read in to be discarded.

(c) 2020. Altair Engineering Inc. All Rights Reserved.

Intellectual Property Rights Notice | Technical Support