LIST_DATA

This command is for the Gibbs Energy System (GES) module.

Use the LIST_DATA command to retrieve and then list the data included with a database in the DATA module or directly entered in the GIBBS module. All data for the current system that is defined within the current GIBBS workspace is written in a readable manner in the output file. If no output file is specified, by default the data displays on screen. The behavior of this command differs slightly based on whether you are using GES6 (the default) or GES5.

For encrypted commercial databases you may not be able to use this command to list any retrieved data. However, it can be used to list some basic definitions (such as phase models and phase-constituents) retrieved from an encrypted database, as well as all the references related to original assessments (but not thermodynamic parameters) for the currently-defined system.

Command Prompts

After entering the command in the console, the following prompt options are available.

Syntax

list_data

Prompts

Output to screen or file /Screen/: <File name>

Specify the name of a file in which the data shall be written in a readable manner. The default value is the screen (by pressing <Enter>).

 

Options?: <Option(s)>

Choose one or several of the following options for output.

See the section about the differences between GES5 and GES6 output for these options.

  • N the output is written as a user database format. For GES6, and only for an unencrypted database, this option has a subcommand that allows filtering of phase parameters with respect to the property type e.g., to include only volume parameters and/or viscosity parameters in the output.
    • The subprompt is Property type /All/. Choose All or enter the property type. The valid alternatives (when available) are: V0, VA, VB, VC, VK, TC, TN, BM, MQ, MF, DQ, DF, OQ, VS, G, L, THCD, ELRS, ESPD, VISC, GD, SIGM or XI
  • P the output is written as a macro file for future input. This is useful for creating *SETUP files for data assessments.
  • S the symbols are suppressed.
  • R the references for the parameters are listed (only for some databases in which references are available)
  • L the output is written suitable for a LaTeX preprocessor.

Output Differences: GES5 vs GES6

GES6 is a re-write and new implementation of the Gibbs Energy System module of Thermo‑Calc and it is the default engine. The previous version, GES5, is still available and will continue to work in the background of the program where necessary. The main purpose of GES6 is to support faster development of new features.

As required you can set Thermo‑Calc to use GES5 instead of the default with the SET_GES_VERSION command. The application may also automatically and temporarily switch to GES5 when a database is being used that is not compatible with GES6.

For both GES5 and GES6 and when you enter P, S, R, or L, the output data consists of a list of all elements and the data followed by a list of all phases and the data associated with each phase. The thermochemical parameters listed for each phase are always in SI units.

For GES6, and only when option N, P, or nothing is entered, the output data consists of a list of all elements and the data followed by a list of all phase definitions and the data associated with the phases, sorted by system. In these modes, and only for unencrypted databases, there is a subcommand that allows filtering of phase parameters with respect to the property type e.g., to include only volume parameters and/or viscosity parameters in the output.

Other differences between the GES5 and GES6 output are related to the output as shown below.

Output

GES5

GES6

Parameters Includes implicitly defined zero-valued thermodynamic parameters Only contains parameters that are actually defined in the database
Automatically suspended phases Does not include Includes
References Contains references of functions and parameters with generic names, such as "REF123"
  • Retains the original reference names that are used in the database