Home
Reference Guides
Explore the Extended Definitions, OML Guides, Block Library, API Guide and Glossary.
Reference Guide for OpenMatrix Language Functions
The Reference Guide contains documentation for all functions supported in the OpenMatrix language.
CAE Reader Commands
getcompname
Returns the name of a component for a given data type. The function has two forms. Use the first form when there is zero or at most one subcase and second form when there are multiple subcases.

Welcome
What's New
Discover new features and enhancements.
Get Started
New to Twin Activate? Learn the basics here.
Tutorials
Start using Twin Activate with our interactive tutorials.
User Guide
Learn about the features and functionality available in Twin Activate.
Reference Guides
Explore the Extended Definitions, OML Guides, Block Library, API Guide and Glossary.
- Extended Definitions for Advanced Users
  PDF file with in-depth information on key topics in the User's Guide.
- Scripting Guide for OpenMatrix Language
  OpenMatrix is a mathematical scripting language.
- Reference Guide for OpenMatrix Language Functions
  The Reference Guide contains documentation for all functions supported in the OpenMatrix language.
  - ABF Commands
  - Altair Integration Commands
  - Audio Commands
  - CAE Commands
  - CAE Reader Commands
    - extract
      Extracts specific subcase-type-request-component selections from the result of readmultvectors command.
    - getcompindex
      Returns the index of a component for a given data type. The function has two forms. Use the first form when there is zero or at most one subcase and second form when there are multiple subcases.
    - getcomplist
      Returns the valid components for a given data type. The function has two forms. Use the first form when there is zero or at most one subcase and second form when there are multiple subcases.
    - getcompname
      Returns the name of a component for a given data type. The function has two forms. Use the first form when there is zero or at most one subcase and second form when there are multiple subcases.
    - getfilteredcomplist
      Returns the component list for a given data type and request. The function has two forms. Use the first form when there is zero or at most one subcase and second form when there are multiple subcases.
    - getfilteredtypelist
      Returns a list of data types in a file, excludes time.
    - getnumcomps
      Returns the number of components within a given data type. The function has two forms. Use the first form when there is zero or at most one subcase and second form when there are multiple subcases.
    - getnumreqs
      Returns the number of requests for a given data type. The function has two forms. Use the first form when there is zero or at most one subcase and second form when there are multiple subcases.
    - getnumtypes
      Returns the number of data types in a file. By default the first subcase is used.
    - getreqindex
      Returns the index of a request for a given data type. The function has two forms. Use the first form when there is zero or at most one subcase and second form when there are multiple subcases.
    - getreqlist
      Returns a list requests for a given data type. The function has two forms. Use the first form when there is zero or at most one subcase and second form when there are multiple subcases.
    - getreqname
      Returns the name of a request within a data type. The function has two forms. Use the first form when there is zero or at most one subcase and second form when there are multiple subcases.
    - getsubcaseindex
      Returns the index of a subcase.
    - getsubcaselist
      Returns a list of all subcases within a file.
    - getsubcasename
      Returns the name of a subcase in a file.
    - gettimesteplist
      Returns a list of time steps associated with the given subcase, type, request, and component.
    - gettotalsubcases
      Returns total count of subcases in a data file.
    - gettypeindex
      Return the index of a datatype in a data file. The function has two forms. Use the first form when there is zero or at most one subcase and second form when there are multiple subcases.
    - gettypelist
      Returns a list of data types in a file. By default, the first subcase is used.
    - gettypename
      Gets the name of a data type from its index. The function has two forms. Use the first form when there is zero or at most one subcase and second form when there are multiple subcases.
    - getunitlist
      Returns a list of supported units for a given unittype.
    - getunittypelist
      Returns supported unit types.
    - readcae
      Reads data from a given file. readcae uses the CAE readers provided with Twin Activate and supports a large set of file formats.
    - readfiletoc
      Reads a file and display its table of contents (data structure) in a hierarchical way using nested cells. Files are read using the CAE readers provided with Twin Activate, which support a large set of file formats.
    - readmultvectors
      Reads data from a given file. readmultvectors uses the CAE readers provided with Twin Activate and supports a large set of file formats. The function has two main forms. See the Comments section for more information on these forms.
    - readunits
      Returns a cell with the unit type and unit associated with the subcase, datatype, request and component of a given file.
    - readvector
      Reads data vector from a file. The data is organized in terms of subcase, type, request, and component. The function has two forms. Use the first form when there is zero or at most one subcase and use the second form when there are multiple subcases.
    - releasedata
      Releases data from memory after using the functions readvectors, readmultvectors or readcae. The function has two forms and take similar arguments as readvector.
    - releasefileinfo
      The data read through readvectors, readcae , readmultvectors and metadata read through getsubcaselist, gettypelist, getreqlist, getcomplist and readfiletoc is not necessarily auto-released from memory when the vectors they were assigned to are emptied. They can be released explicitly, though, as shown below.
  - CAE Reader 3D Commands
  - CAE Writer Commands
  - Calculus Commands
  - Computer Vision Commands
  - Communication Commands
  - Control System Commands
  - Core Minimal Interpreter Commands
  - Data Structure Commands
  - Differential Equations Commands
  - Elementary Math Commands
  - File I/O Commands
  - Geometry Commands
  - GUI Commands
  - HDF5 Reader Commands
  - HDF5 Writer Commands
  - hstpyfit Commands
  - Image Commands
  - JSON Commands
  - Library Manager Commands
  - Linear Algebra Commands
  - Logical Commands
  - Machine Learning Commands
  - Optimization Commands
  - Plotting Commands
  - Polynomial Math Commands
  - Signal Processing Commands
  - Statistical Analysis Commands
  - String Operations Commands
  - System Commands
  - Table Commands
  - Time Commands
  - Trigonometry Commands
  - OML to Python Bridge Commands
  - Python to OML Bridge Commands
- Block Reference Guide
  Describes all of the blocks in the installed Twin Activate library.
- Function Guide for Twin Activate
  Provides information about developing and simulating models through the Twin Activate Application Program Interface.
- Glossary
  Key terms associated with the software.
Frequently Asked Questions
You've got questions? We've got answers!

getcompname

Returns the name of a component for a given data type. The function has two forms. Use the first form when there is zero or at most one subcase and second form when there are multiple subcases.

Attention: Available only with Twin Activate commercial edition.

Syntax

getcompname(filename, datatype, compindex)

getcompname(filename, subcase, datatype, compindex)

R = getcompname(...)

Inputs

filename: Path of the file.; Type: string
subcase: Subcase name or index in the file.; Type: string | int
datatype: Data type name or index in the file.; Type: string | int
compindex: Index of a component in the file.; Type: integer

Outputs

R: Name of component.

Examples

Basic getcompname without subcase:

getcompname('Path/To/File/ANGACC','Angular Acceleration',2)

R = X-comp. ang. acc.

Basic getcompname with subcase:

getcompname('Path/To/File/vdd_crc_r60_acc_crc.res','Results','Request_ptr_rear_brake_torque_data',2)

R = velocity