Mechanical APDL files are organized into header records and simple records. The header records are used to store single values and addresses in the file to find other records. The content of Mechanical APDL files is described in Format of Binary Data Files in the Programmer's Reference.
Not all records can be addressed by the *XPL command.
You can only access those records listed by the Action = LIST
option.
Following is a simple representation of a file’s hierarchy of records.
Following is an example input listing that demonstrates use of the *XPL command.
*XPL,OPEN,file.rst,RST *XPL,LIST *XPL,STEP,GEO *XPL,LIST *XPL,WHERE *XPL,READ,ETY,MyVec *PRINT,MyVec
The action performed by each command in this example is explained next.
You must open a file (Action = OPEN) in order to scan it.
For example, you can open an .RST file and list the records
(Action = LIST).
*XPL,OPEN,file.rst,RST
=============================================== ===== ANSYS File Xplorer ====== =============================================== Opening the file.rst ANSYS File BEGIN:
*XPL,LIST
===== ANSYS File Xplorer : List Blocks in File file.rst ::RST::HEADER Size = 0.324 KB Total Size = 319.598 KB ::RST::DOF Size = 0.035 KB ::RST::NOD Size = 0.078 KB ::RST::ELM Size = 0.020 KB ::RST::DSI::HEADER Size = 78.137 KB Total Size = 120.234 KB ::RST::TIM Size = 78.137 KB ::RST::LSP Size = 117.199 KB ::RST::GEO::HEADER Size = 0.324 KB Total Size = 3.570 KB
A record name ending in “::HEADER” indicates a header. The record sizes are listed for each record. The “Total Size” value is the sum of the sizes of all the records addressed (recursively) by the corresponding header.
In this example the STEP option is used to go down one level under the GEO header:
*XPL,STEP,GEO
===== ANSYS File Xplorer : Step into Block GEO BEGIN:
*XPL,LIST
===== ANSYS File Xplorer : List Blocks in File apdl-196s.rst ::GEO::HEADER Size = 0.324 KB Total Size = 3.570 KB ::GEO::ETY Size = 0.809 KB ::GEO::LOC Size = 1.129 KB ::GEO::EID Size = 0.285 KB ::GEO::CENT Size = 0.926 KB ::GEO::NOD Size = 0.078 KB ::GEO::ELM Size = 0.020 KB
The WHERE option displays the current location in the tree of records:
*XPL,WHERE
===== ANSYS File Xplorer : Display Current Location
Current Location : RST::GEO
File Location : 280916
The READ option reads a record and fills an APDL Math vector:
*XPL,READ,ETY,MyVec
===== ANSYS File Xplorer : Read Block ETY into the Vector MYVEC
The APDL Math command *PRINT prints matrix values:
*PRINT,MyVec
MYVEC :
Size : 7
10 213 416 619 822
1025 1228