PSCF v1.1
Thermodynamic Properties

Command Files (Prev)         Examples (Next)

The thermodynamic properties obtained for a converged SCFT solution are output by PSCF in a standard format that we refer to a thermo file block, or simply a thermo block. A thermo block can also be written to a specified file by the WRITE_THERMO command. A thermo block also appears within the log information that is written to standard output during execution of an ITERATE command, as well as within each of the state files that are created by a SWEEP command.

Thermo File Block Format

An example of the thermo block format produced by an SCFT calculation for a periodic system is shown below:

fHelmholtz -2.75154924314e+01
pressure 3.24415250701e+01
fIdeal -3.44570175013e+01
fInter 6.94152506994e+00
polymers:
phi mu
0 5.00000000000e-01 2.74031671637e+01
solvents:
phi mu
0 5.00000000000e-01 -3.51022037728e-01
cellParams:
0 1.62132469978e+01

The following section discusses each of the entries in this file format, describing the meaning of each property and the units and conventions used to define its numerical value.

Properties

Helmholtz Free Energy

The property "fHelmholtz" is a non-dimensional form of the Helmholtz free energy, which will be denoted here by the symbol \( \tilde{f} \). The reported value is actually the free energy per monomer reference volume in thermal energy units. That is, the value reported for "fHelmholtz" for a system with a total Helmholtz free energy \( F \) and associated volume \( V \) is given by ratio

\[ \tilde{f} \equiv \frac{Fv}{Vk_{B}T} \]

where \( v \) is the monomer reference volume.

In the special case of a one-component block polymer melt for which the input parameters are given using the theorists convention that overall chain length is equal to 1.0, the monomer reference volume is equal to the volume per chain. In this case, the value reported for "fHelmholtz" is also the free energy per chain in thermal energy units, with \( k_{B}T = 1 \). More generally, in a mixture, one can obtain the free energy associated with the volume occupied by a molecular species by multiplying the overall contour length (for polymers) or size (for solvents) of the species by the value reported for "fHelmholtz".

Pressure and Grand-Canonical Free Energy

The property "pressure" reported by PSCF is a non-dimensionalized thermodynamic pressure that is computed from the value of the grand-canonical free energy density. Consider a system that contains a total of \( N_{a} \) molecules of molecular species \( a \), and let \( \mu_{a} \) denote the chemical potential of species \( a \), for each polymer and solvent species. Let \( \Phi \) denote the so-called "grand" or "grand-canonical" free energy, defined as

\[ \Phi \equiv F - \sum_{a}\mu_{a}N_{a} \quad, \]

in which the sum is taken over all polymer and solvent molecular species in the system. We define a thermodynamic pressure \( P \) via the identity

\[ \Phi = -PV \quad, \]

where \( V \) is total system volume. The property reported by PSCF as "pressure", which is denoted here by the symbol \( \tilde{p} \), is actually the value of the ratio

\[ \tilde{p} = \frac{Pv}{k_{B}T} = -\frac{\Phi v}{Vk_{B}T} \quad. \]

The value of pressure reported by PSCF is thus \( -1 \) times the grand-canonical free energy per monomer reference volume, in thermal energy units.

Free Energy Components

The next two parameters, "fIdeal" and "fInter", are individual components of the Helmholtz free energy. "fInter" is an interaction free energy, representing the contribution to the Helmholtz free energy arising from interactions between dissimilar monomer species. "fIdeal" is the contribution to the Helmholtz free energy from everything else. This can be thought of as the free energy of a non-interacting ideal gas of polymers in the self-consistent chemical potential fields.

In calculations with an external field, a third term will appear here: "fExt". This represents the contribution to the Helmholtz free energy arising from interactions between the monomer species and the external potential fields.

Polymer and Solvent Species

The next two sections of the example given above are labeled "polymers" and "solvents". These are lists, with one row per chemical species, in which each row gives the species index, the overall volume fraction "phi", and the chemical potential "mu" of that chemical species. Note that the chemical potential values are in thermal energy units, so the numerical value reported for species \( a \) actually \( \mu_{a} / k_{B}T \).

Lattice Parameters

The final section, labeled "cellParams", lists the lattice parameters for the converged SCFT solution. This section appears in the output of SCFT calculations for periodic systems performed using pscf_pc or pscf_pg programs. It does not appear in the output of calculations for one-dimensional systems performed using pscf_fd, since the domain size is fixed by the user in pscf_fd calculations. In pscf_pc and pscf_pg calculations, some or all of the lattice parameters may be flexible, and are adjusted during the SCFT calculation so as to minimize the free energy density. In this case, the converged values of lattice parameters values that are allowed to vary are important output of the calculation. If an SCFT calculation is run with no flexible lattice parameters (i.e., a rigid unit cell) this section of the thermo block simply reports the lattice parameters values that were used as inputs. Input values for lattice parameters are normally provided within the header block of the file used to provide an initial guess for the monomer chemical potential fields (the w fields). The lattice parameters are reported in whatever length units were used in the input field and parameter files.

State Files

A "state" file is a type of file that is created for each state (i.e., each set of input parameters) during a parameter sweep performed by a SWEEP command. Each such state file is comprised of a parameter file block followed by a thermo file block. The parameter file block contains the input parameters used for the SCFT calculation at that state, with the Sweep block excluded, formatted in the nested curly-bracket syntax of a PSCF parameter file. The thermo block contains thermodynamic properties computed for the converged solution. Each state file thus gives all of the input and output parameters for a single calculation, fully describing that state. Names of state files that are generated by a SWEEP command contain an integer index followed by the file extension ".stt".

A state file can also be generated for an individual calculation (as opposed to a parameter sweep) by using the command WRITE_PARAM followed by the command WRITE_THERMO, while using the same file name argument for both commands. In the command file, this might look like

WRITE_PARAM out/state
WRITE_THERMO out/state

The WRITE_THERMO command is designed to append to the end of an existing file rather than overwrite it in order to allow both blocks to be written to a single file.

An example of the format of a state file is shown below for a system that forms a lamellar phase of a diblock copolymer in a selective solvent.

System{
Mixture{
nMonomer 3
monomers[
6.07000000e+00
6.07000000e+00
6.07000000e+00
]
nPolymer 1
nSolvent 1
Polymer{
type linear
nBlock 2
blocks[
0 3.500000000000e-01
1 6.500000000000e-01
]
phi 5.000000000000e-01
}
Solvent{
monomerId 2
size 2.000000000000e-02
phi 5.000000000000e-01
}
ds 1.000000000000e-02
}
Interaction{
chi(
0 0 0.000000000000e+00
1 0 3.000000000000e+01
1 1 0.000000000000e+00
2 0 3.000000000000e+01
2 1 1.000000000000e+02
2 2 0.000000000000e+00
)
}
Domain{
mesh 100
lattice lamellar
groupName P_-1
}
AmIterator{
epsilon 1.000000000000e-11
maxItr 200
maxHist 30
verbose 1
isFlexible 1
}
}
fHelmholtz -2.75154924314e+01
pressure 3.24415250701e+01
fIdeal -3.44570175013e+01
fInter 6.94152506994e+00
polymers:
phi mu
0 5.00000000000e-01 2.74031671637e+01
solvents:
phi mu
0 5.00000000000e-01 -3.51022037728e-01
cellParams:
0 1.62132469978e+01


Command Files (Prev)         User Guide (Up)         Examples (Next)