7.1. Reading Results Data into the Database

The first step in POST1 is to read data from the results file into the database. To do so, model data (nodes, elements, etc.) must exist in the database. If the database does not already contain model data, issue the RESUME command to read the database file, Jobname.DB. The database should contain the same model for which the solution was calculated, including the element types, nodes, elements, element real constants, material properties, and nodal coordinate systems.


Caution:  The database should contain the same set of selected nodes and elements that were selected for the solution. Otherwise, a data mismatch can occur. For more information about data mismatches, see Appending Data to the Database.


Table 7.1:  Saving the Database Properly for Postprocessing

When postprocessing analysis results are obtained using...Save the database:
Linear perturbation procedures

After solving.

Reason: The node coordinates are updated with the base analysis displacements during the solution.

Contact analysis

After solving.

Reason: The nodal connectivity of contact elements is updated and internal nodes are added during the solution.

ELBOW290 elements

After the first solution.

Reason: The nodal connectivity of elbow elements is updated and internal nodes are added during the solution.


After model data are in the database, load the results data from the results file by issuing one of the following commands: SET, SUBSET, or APPEND.

7.1.1. Reading Results Data

The SET command reads results data over the entire model from the results file into the database for a particular loading condition, replacing any data previously stored in the database.

The boundary condition information (constraints and force loads) is also read, but only if either element nodal loads or reaction loads are available. (See the OUTRES command for more information.) If they are not available, no boundary conditions will be available for listing or plotting. Only constraints and forces are read; surface and body loads are not updated and remain at their last specified value. If the surface and body loads have been specified via tabular boundary conditions, however, they will reflect the values corresponding to this results set. Loading conditions are identified either by load step and substep or by time (or frequency).

The arguments specified on the SET command identify the data to be read into the database.

Example 7.1:  Specifying Results Data to Read
SET,2,5          ! Reads results for load step 2, substep 5
SET,,,,,3.89     ! Reads in results at TIME = 3.89 (or 
!                    frequency = 3.89 depending on the analysis type)

If you specify a time via the SET command for which no results are available, the program performs linear interpolation to calculate results for that time. For a nonlinear analysis, interpolation between time points usually degrades accuracy; postprocess at a time value for which a solution is available.


The default maximum number of substeps in the results file (Jobname.RST) is 1000. When the number of substeps exceeds this limit, issue SET,Lstep,LAST to read in the 1000th load step. (Issue /CONFIG to increase the limit.)

Some convenience labels are also available for SET:

  • SET,FIRST reads in the first substep.

    SET,NEXT reads in the next substep.

  • SET,LAST reads in the last substep.

  • The NSET field on the SET command retrieves data that corresponds to its unique data set number, rather than its load step and substep number. The LIST option on the SET command lists the data set number along with its corresponding load step and substep numbers. You can enter this data set number on the NSET field of the next SET command to request the proper set of results.

  • The ANGLE field on SET specifies the circumferential location for harmonic elements (structural - PLANE25, PLANE83, and SHELL61; thermal - PLANE75 and PLANE78).

You can postprocess results without reading in the results data if the solution results were saved to the database file (Jobname.DB).


Caution:  While in some cases you can skip reading the results (SET command) if the results from the last solved time point are already in the database, these results may not be up to date. For example, if OUTRES was used to write data at a prior time but not for the last time point, data for that prior time point will be in the database. Likewise, if a contact element was in contact at a prior time but not in contact (far-field) at the last time point, contact results for that prior time point will be in the database. In these cases, you must issue a SET command to insure the most up-to-date results are in memory for postprocessing.


Distributed ANSYS can only postprocess using the results file (Jobname.RST), as no solution results are written to the database. If using Distributed ANSYS, a SET command is necessary before postprocessing.

7.1.2. Other Options for Retrieving Results Data

7.1.2.1. Defining Data to be Retrieved

The INRES command in POST1 is a companion to the OUTRES command in the PREP7 and SOLUTION processors. Where the OUTRES command controls data written to the database and the results file, the INRES command defines the type of data to be retrieved from the results file for placement into the database through commands such as SET, SUBSET, and APPEND. Although not required for postprocessing of data, the INRES command limits the amount of data retrieved and written to the database. As a result, postprocessing your data may require less time.

7.1.2.2. Reading Selected Results Information

To read a data set from the results file into the database for the selected portions of the model only, issue the SUBSET command. Data that has not been specified for retrieval from the results file by the INRES command will be listed as having a zero value.

The SUBSET command behaves like the SET command except that it retrieves data for the selected portions of the model only. It is very convenient to issue the SUBSET command to look at the results data for a portion of the model. For example, if you are interested only in surface results, you can select the exterior nodes and elements, then issue SUBSET to retrieve results data for just those selected items.

7.1.2.3. Appending Data to the Database

Each time you issue the SET or SUBSET command, the program writes a new set of data over the data currently in the database. The APPEND command reads a data set from the results file and merges it with the existing data in the database, for the selected model only. The existing database is not zeroed (or overwritten in total), allowing the requested results data to be merged into the database.

You can issue the commands SET, SUBSET, or APPEND to read data from the results file into the database. The only difference between the commands or paths is how much or what type of data you want to retrieve.

To clear the database of any previous data, issue the LCZERO command. The command gives you a fresh start for further data storage.

If you set the database to zero before appending data to it, the result is the same as issuing the SUBSET command, assuming that the arguments on SUBSET and APPEND are equivalent.

All of the options available for the SET command are also available for the SUBSET and APPEND commands.

By default, the SET, SUBSET, and APPEND commands look for one of these results files: Jobname.RST, Jobname.RTH, or Jobname.RMG. You can specify a different file name by issuing the FILE command before issuing SET, SUBSET, or APPEND.

7.1.2.3.1. Avoiding Data Mismatch

When appending data (APPEND), use care not to generate a data mismatch.

Example 7.2:  Data Mismatch
/POST1
INRES,NSOL            ! Flag data from nodal DOF solution
NSEL,S,NODE,,1,5      ! Select nodes 1 to 5
SUBSET,1              ! Write data from load step 1 to database

At this point, results data for nodes 1 to 5 from load step 1 are in the database.

NSEL,S,NODE,,6,10     ! Select nodes 6 to 10
APPEND,2              ! Merge data from load step 2 into database
NSEL,S,NODE,,1,10     ! Select nodes 1 to 10
PRNSOL,DOF            ! Print nodal DOF solution results

The database now contains data for both load steps 1 and 2. This is a data mismatch.


When issuing the PRNSOL command, the program indicates that you will have data from the second load step, when actually data from two different load steps now exist in the database. The load step listed is merely the one corresponding to the most recent load step stored.

Appending data to the database is helpful if you wish to compare results from different load steps; however, if you purposely intend to mix data, it is crucial to keep track of the source of the data appended.

To avoid data mismatches when solving a subset of a model that was solved previously using a different set of elements:

  • Do not reselect any of the elements that were deselected for the solution currently being postprocessed, or

  • Remove the earlier solution from the database (by exiting from the program between solutions or by saving the database between solutions).

7.1.3. Creating an Element Table

The element table serves two functions:

  • It is a tool for performing arithmetic operations among results data.

  • It allows access to certain element results data that are not otherwise directly accessible, such as derived data for structural line elements. (Although the SET, SUBSET, and APPEND commands read all requested results items into the database, not all data are directly accessible via commands such as PLNSOL, PLESOL, etc.).

Think of the element table as a spreadsheet, where each row represents an element, and each column represents a particular data item for the elements. For example, one column might contain the average SX stress for the elements, while another might contain the element volumes, while yet a third might contain the Y coordinate of the centroid for each element.

To create or erase the element table, issue the ETABLE command.

7.1.3.1. Filling the Element Table for Variables Identified By Name

To identify an element table column, assign a label to it via the Lab argument on the ETABLE command. The label is used as the identifier for all subsequent POST1 commands involving this variable. The data to fill the columns is identified by an Item name and a Comp (component) name, the other two arguments on the ETABLE command. For example, for the SX stresses, SX could be the Lab, S would be the Item, and X would be the Comp argument.

Some items, such as the element volumes, do not require Comp; in such cases, Item is VOLU and Comp is left blank. Identifying data items by an Item, and Comp if necessary, is called the "Component Name" method of filling the element table. The data which are accessible with the component name method are data generally calculated for most element types or groups of element types.

The ETABLE command documentation lists, in general, all the Item and Comp combinations. See the "Element Output Definitions" table in each element description in the Element Reference to see which combinations are valid.

Table 188.1: BEAM188 Element Output Definitions is an example of such a table for BEAM188. You can use any name in the Name column of the table that contains a colon (:) to fill the element table via the Component Name method. The portion of the name before the colon should be input for the Item argument of the ETABLE command. The portion (if any) after the colon should be input for the Comp argument. The O and R columns indicate the availability of the items in the file Jobname.OUT (O) or in the results file (R): a Y indicates that the item is always available, a number refers to a table footnote which describes when the item is conditionally available, and a - indicates that the item is not available.

7.1.3.2. Filling the Element Table for Variables Identified By Sequence Number

You can load data that is not averaged, or that is not naturally single-valued for each element, into the element table. This type of data includes integration point data, all derived data for structural line elements (such as spars, beams, and pipes) and contact elements, all derived data for thermal line elements, layer data for layered elements, etc. These data are listed in the "Item and Sequence Numbers for the ETABLE and ESOL Commands" table with each element type description in the Command Reference. Table 188.2: BEAM188 Item and Sequence Numbers is an example of such a table for BEAM188.

The data in the tables is broken down into item groups, such as LS, LEPEL, SMISC, etc. Each item within the item group has an identifying "sequence" number listed. You load these data into the element table by giving the item group as the Item argument on the ETABLE command, and the sequence number as the Comp argument. This is referred to as the "Sequence Number" method of filling the element table.

For some line elements, KEYOPT settings govern the amount of data calculated. This can change the sequence number of a particular data item. Therefore, in these cases a table for each KEYOPT setting is provided.

7.1.3.3. Considerations for Defining Element Tables

The ETABLE command works only on the selected elements. That is, only data for the elements you have selected are moved to the element table. By changing the selected elements between ETABLE commands, you can selectively fill rows of the element table.

The same Sequence Number combination may mean different data for different element types. For example, the combination SMISC,1 means P1 for SOLID185 (pressure on face 1), and MECHPOWER for TRANS126 (mechanical power); therefore, if your model has a combination of element types, select elements of one type (ESEL) before issuing the ETABLE command.

The element table is not automatically refilled (updated) when you read in a different set of results (such as for a different load step) or when you alter the results in the database (such as by a load case combination). For example, suppose your model consists of our sample elements, and you issue the following commands in POST1:

SET,1							! Read in results for load step 1
ETABLE,ABC,lS,6			! Move SDIR at end J (KEYOPT(9)=0) to the element table 
									!    under heading "ABC"
SET,2							! Read in results for load step 2

At this point, the "ABC" column in the element table still contains data for load step 1. To refill (update) the column with load step 2 values, issue an ETABLE,REFL command.

  • You can use the element table as a "worksheet" to do calculations among results data. This feature is described in Additional POST1 Postprocessing.

  • To save the element table, issue SAVE,Fname,Ext in POST1 or issue /EXIT,ALL when exiting the program. This saves the table along with the rest of the database onto the database file.

  • To erase the entire element table from memory, issue ETABLE,ERASE. (Or issue ETABLE,Lab,ERASE to erase just the Lab column of the element table.) The RESET command erases the element table from memory.

7.1.4. Special Considerations for Principal Stresses

Principal stresses for SHELL61 elements are not readily available for review in POST1. By default, the principal stresses are available for all line elements except in either of the following cases:

  • You have requested an interpolated time point or angle specification on the SET command.

  • You have performed load case operations.

In the above cases (including all cases for SHELL61), you must issue the command LCOPER,LPRIN in order to calculate the principal stresses. You can then access this data via ETABLE or any appropriate printing or plotting command.

7.1.5. Resetting the Database

The RESET command reinitializes the POST1 command defaults portion of the database without exiting POST1. The command has the same effect as leaving and re-entering the program.


Release 18.2 - © ANSYS, Inc. All rights reserved.