PHASE
PHASE [phase name]*24 [data-type code]*8 [numb. subl.] [sites in subl. 1] [sites in subl. 2] etc... {auxiliary text string} !
This keyword defines a phase and its properties (except for what species are allowed to enter it and for its parameters).
The phase name (maximum 24 characters) must be unique; otherwise the DATA module sees it as an attempt to redefine a previously defined phase. This causes DATA to display an error message and ignore the rest of the line. A phase name can be suffixed by an underscore (_
and letters to identify the physical state(s) or structure type(s) of the phase.
Examples of Recommended Suffixes
Suffix | Definition |
---|---|
ABC_S
|
The ABC phase in solid state. |
ABC_S2
|
The ABC phase in solid state 2. |
ABC_S3
|
The ABC phase in solid state 3. |
ABC_LT
|
The ABC phase in solid state at low temperatures. |
ABC_HT
|
The ABC phase in solid state at high temperatures. |
ABC_L
|
The ABC phase in liquid state. |
ABC_LIQ
|
The ABC phase in liquid state. |
FCC_A1
|
The FCC phase in disordered structure type A1. |
FCC_L12
|
The FCC phase in ordered structure type L12. |
The phase name can also be attached with a colon sign (:
) and a letter for a legal GIBBS phase-type code (e.g. IONIC_
LIQ:Y
and GAS:G
).
GIBBS Phase-type Codes
Code |
Definition |
---|---|
G
|
Bit set for a gaseous mixture phase. |
A
|
Bit set for an aqueous solution phase. |
Y
|
Bit set for an ionic liquid solution phase (specially treated by the Ionic Two-Sublattice Liquid Model). |
L
|
Bit set for a liquid solution phase (but not A (aqueous) or Y (ionic liquid)). |
I
|
Bit set for a phase with charged species (but not G (gaseous), A (aqueous) or Y (ionic liquid)). |
F
|
Bit set for an ordered FCC or HCP solution phase using the Four Substitutional-Sublattice Ordering Model (additionally, such a phase can also have interstitial sublattices). |
B
|
Bit set for an ordered BCC solution phase using the Four Substitutional-Sublattice Ordering Model (additionally, such a phase can also have interstitial sublattices). |
Other invalid characters (e.g. M
or P
) are eventually treated, together with the colon (:) as a part of a phase name.
A G
phase (gaseous mixture) or an A
phase (aqueous solution) is usually treated as a substitutional phase without sublattice, and an L
phase (ordinary liquid solution) is normally (but not always) modeled as a substitutional phase without sublattice, too.
For ordered FCC or HCP phases, these four substitutional sublattices represent four corners of the regular tetrahedron on these lattices, all of which are the nearest neighbours, as shown.

An FCC unit cell with the lattice positions indicated that correspond to the G (FCC,A:B:C:D) end member. All lattice positions are equivalent for a four substitutional-sublattice ordering model.
A Normal 4-Sublattice Model requires that all the G
parameters for each of the end-members with the same elements but distributed on different sites be given separately. However, as these corners are identical lattice points, the phase-type option F
means that the G
parameters need be given only once. The possible permutations are handled automatically.
Additional Clarification
An A-B
binary solution phase (with the element A located on one sublattice site and B
on the other three sublattice sites) treated by the Normal 4-Sublattice Model has to have four G
parameters for four end-members, i.e.
- G(phase,A:B:B:B)
- G(phase,B:A:B:B)
- G(phase,B:B:A:B, and
- G(phase,B:B:B:A)
This is because in the general case these G
parameters can be different from each other. But for the FCC and HCP orderings, they are identical and thus all G
parameters of such end-members need to be given only once, and the possible permutations are then automatically handled by the GIBBS module. Also, only one of the identical permutations is listed; in this example, G(phase,A:B:B:B)
where it is alphabetically the first in the list of permutations. This significantly simplifies the usage of this model (Four Substitutional-Sublattice Ordering Model) in multicomponent alloys.
For ordered BCC phases, the phase-type option B
means the same thing but it is more complicated since the 4-substitutional-sublattice ordering phase represents an irregular tetrahedron with two pairs of sites that are next nearest neighbours as shown:

Two BCC unit cells with the lattice positions indicated that correspond to the G (BCC,A:B:C:D,0) end member. Lattice positions (A) and (B) are equivalent, as are lattice positions (C) and (B) for a four substitutional-sublattice ordering model.
For an end member described by the parameter G
(phase,A:B:C:D)
A and B are next nearest neighbours, as are C and D. And the nearest neighbours of A (or B) are C and D. Thus, for an A-B
binary solution phase (with the element A located on two sublattice sites and B
on two sublattice sites) treated by the Normal 4-Sublattice Model, the end-member described by the G(phase,A:A:B:B)
term has four nearest neighbour bonds between A and B atoms, whereas the end-member described by the G(phase,A:B:A:B)
term has two nearest neighbour bonds between A and B atoms and three next nearest neighbour bonds.
The first end-member (described by the G(phase,A:A:B:B)
term) represents B2-ordering and the second (described by the G(phase,A:B:A:B)
term) stands for B32-ordering. There are two permutations of the G(phase,A:A:B:B)
term and four permutations of the G(phase,A:B:A:B)
term, automatically conducted in the Four Substitutional-Sublattice Ordering Model. If you enter the unary, binary, ternary and quaternary parameters you are dealing with 1, 6, 21, 55 parameters for BCC:B, 1, 5, 15, 35 parameters for FCC:F and 1, 16, 81, 256 parameters for phases without F/B.
An additional feature with the phase-type options F
and B
is that a composition set that represents the solution phase has a suffix (indicating what ordering the phase has) that is automatically added to its phase name in some listings of equilibrium calculations (when performing either single-point or stepping or mapping calculations, and when plotting the calculated property diagrams or phase diagrams).
Such suffix indications can be:
Solution Phase | Suffix for Disordered Phase | Suffix for Ordered Phase |
---|---|---|
FCC PHASE
|
|
|
|
||
BCC PHASE
|
|
|
|
||
|
||
|
||
HCP PHASE
|
|
|
|
If you want to convert an existing database TDB file to use the F/B feature, add the phase-type code to the corresponding phase name in the PHASE and CONSTITUENT commands in the TDB-file, then when running the LIST_DATA command in the Gibbs (GES) module. The created database file is in this less verbose format.
The data-type code consists of 1 to 8 characters where each character must stand for an action, which is to be coupled to this phase. The keyword TYPE_DEFINITION, described below, must be used in the current database to specify what action should be taken by DATA for each character code.
The data entries [numb. subl.] [sites in subl. 1] [sites in subl. 2]
etc., specify the total number of sublattices (always as an integer digit) and the sites (i.e. stoichiometric coefficients) of each of the sublattices (given in either integer digits or real numerical factors) for the phase.
Optionally, an auxiliary text string (maximum 10,000 characters) can be given after the last [sites in sublattice #] but before the exclamation mark !
. This string displays in connection with the phase name in some listings within the DATA module.

PHASE GAS:G % 1 1.0 !
PHASE LIQUID:L %ZCDQ 2 1.0 1.0
> Metallic liquid solution, modeled by CEF Model. !
PHASE IONIC-LIQ:Y %ZCDQ 2 1.0 1.0
> Ionic liquid solution, modeled by Ionic Two-Sublattice Model. !
PHASE SPINEL:I %ZA 4 1 2 2 4
> Complex Spinel Solution, by CEF model with ionic constraints. !
PHASE M23C6 % 3 20.0 3.0 6.0 !
PHASE FCC_A1 %&A 2 1 1
> Disordered FCC phase; also as MX carbides/nitrides. !
PHASE FCC_L10 %&AX 3 0.75 0.25 1
> Ordered FCC phase, modeled by 2-Sublattice Model for Ordering. !
PHASE FCC_L12:F %&AX 5 0.25 0.25 0.25 0.25 1.0
> Ordered FCC phase, modeled by 4-Sublattice Model for Ordering. !
PHASE AQUEOUS:A %HIJMR 1 1.0
> Aqueous Solution: using the Complete Revised HKF Model. !