ILThermoPy Cookbook

Data snapshot — 16 October 2026
This cookbook accompanies ILThermoPy 1.1.3 and its compound/SMILES data updated on 16 October 2026 (ILThermo 2.0 reports its last database update as 22 July 2026). ILThermo is a live service: subsequent database updates may change property keys, compound and entry IDs, search results, row counts, and individual values for the same requests. The outputs illustrate the workflow; rerun the cells to obtain current results and check the database status with ilt.CheckLastUpdate().

ILThermo 2.0 is a curated NIST database of experimental physicochemical properties of ionic liquids and related systems. This cookbook demonstrates accessing its records with the ILThermoPy Python package.

Properties

You can search by a property name or its internal ILThermo key. The names and keys available in the current database can be inspected with ilt.ShowPropertyList():

[3]:
ilt.ShowPropertyList()

# Activity, fugacity, and osmotic properties
OeGx: Activity
IzuI: Mean ionic activity coefficient of component
ATdF: Osmotic coefficient

# Composition at phase equilibrium
xcJP: Composition at phase equilibrium
XSWH: Eutectic composition
lwkH: Henry's Law constant
AqYC: Tieline
aEcx: Upper consolute composition

# Critical properties
lsOT: Critical pressure
WuhL: Critical temperature
xUze: Upper consolute pressure
NMMC: Upper consolute temperature

# Excess, partial, and apparent energetic properties
TtDG: Apparent enthalpy
aJDm: Apparent isobaric molar heat capacity
mcIy: Enthalpy of dilution per amount of solute
aREM: Enthalpy of mixing of a binary solvent with component
iQPY: Excess enthalpy
iOPb: Integral enthalpy of solution
TMtf: Partial molar enthalpy

# Heat capacity and derived properties
KfbC: Enthalpy
jFrV: Enthalpy function {H(T)-H(0)}/T
LoTK: Entropy
Qneg: Heat capacity at constant pressure
MuWM: Heat capacity at constant volume
FXxs: Heat capacity at vapor saturation pressure

# Phase transition properties
DCQw: Enthalpy of transition or fusion
KwJt: Enthalpy of vaporization or sublimation
JniP: Equilibrium temperature
HDIB: Eutectic temperature
YQCb: Monotectic temperature
LPuZ: Normal melting temperature

# Refraction, surface tension, and speed of sound
IzOV: Interfacial tension
OMVT: Molar refraction (Na D-line)
RbfA: Optical rotation (Na D-line)
FoWP: Refractive index
TGKW: Relative permittivity
JYHK: Speed of sound
CTsx: Surface tension liquid-gas

# Transport properties
UIrH: Binary diffusion coefficient
LCor: Electrical conductivity
cMuo: Molar conductivity of component
ySQn: Self diffusion coefficient
rSEB: Thermal conductivity
qRpR: Thermal diffusivity
CweK: Tracer diffusion coefficient
tplC: Viscosity

# Vapor pressure, boiling temperature, and azeotropic T & P
gGNp: Equilibrium pressure
zmIG: Vapor or sublimation pressure

# Volumetric properties
QoVJ: Apparent molar volume
jBwV: Density
VYqQ: Excess volume
NEyp: Isobaric coefficient of volume expansion
aSWJ: Isothermal compressibility
TGTi: Partial molar volume

The property names and internal keys can change between ILThermo database versions. The prop argument of ilt.Search() resolves the name against the current property list, while prop_key passes a specific internal key. Prefer prop unless you explicitly need the key. An unknown property name raises ValueError.

For programmatic access to the current names and keys, use ilt.PropertyList():

[4]:
plist = ilt.PropertyList()
help(plist)
Help on PropertyList in module ilthermopy.data_structs object:

class PropertyList(builtins.object)
 |  Contains info on available physico-chemical properties and their API keys
 |
 |  Attributes:
 |      properties (dict): two-level organized dictionary, interconnecting property
 |          types, properties, and their API keys
 |      key2prop (dict): maps API keys to property names
 |      prop2key (dict): maps property names to their API keys
 |
 |  Methods defined here:
 |
 |  Show(self) -> None
 |      Prints list of properties available in ILThermo 2.0 database
 |      formatted as api_key: property_name
 |
 |  __init__(self)
 |      Initialize self.  See help(type(self)) for accurate signature.
 |
 |  ----------------------------------------------------------------------
 |  Data descriptors defined here:
 |
 |  __dict__
 |      dictionary for instance variables (if defined)
 |
 |  __weakref__
 |      list of weak references to the object (if defined)

[5]:
prop_name = 'Activity'
prop_key = plist.prop2key.get(prop_name, None)
print(prop_key)
OeGx

However, in most cases you do not need this functionality since the ilt.Search function supports the prop argument.

Retrieving data

To retrieve the full experimental measurements for a search result, pass its entry identifier to ilt.GetEntry():

[6]:
# Find entries for two-component systems published in 2004
df = ilt.Search(n_compounds=2, year=2004)
# Retrieve the first result (one API request)
entry = ilt.GetEntry(df['id'].iloc[0])
entry

[6]:
Entry(id='srPOo', ref=Reference(full='Rebelo, L. P. N.; Najdanovic-Visak, V.; Visak, Z. P.; Nunes da Ponte, M.; Szydlowski, J.; Cerdeirina, C. A.; Troncoso, J.; Romani, L.; Esperanca, J. M. S. S.; Guedes, H. J. R.; de Sousa, H. C. (2004) Green Chem. 6(8), 369-381.'), property='Excess volume', property_type='Volumetric properties', phases=['Liquid'], components=[Compound(id='AADYJk', name='water', smiles='O'), Compound(id='AArYBF', name='1-butyl-3-methylimidazolium tetrafluoroborate', smiles='CCCC[n+]1ccn(C)c1.F[B-](F)(F)F')], num_data_points=185)

Entry object contains detailed information on the data entry, including:

  • id: data entry ID;

  • ref: reference to the source article;

  • property, property_type: measured property and its type;

  • phases: list of system’s phases;

  • components: list of system’s components;

  • num_phases, num_components, num_data_points: number of system’s components and phases, and number of measured data points;

  • expmeth: experimental method used to obtain the physchemical data;

  • solvent: solvent used in the experiment;

  • constraints: list of experimental constraints;

  • data: dataframe containing measured data;

  • header: full column names to the data, containing info on the measured property, measurement units, component, and phase;

  • footnotes: notes to the data;

  • response: original response.

Let’s illustrate the main attributes. Reference contains reference itself and the article’s title:

[7]:
entry.ref.full, entry.ref.title
[7]:
('Rebelo, L. P. N.; Najdanovic-Visak, V.; Visak, Z. P.; Nunes da Ponte, M.; Szydlowski, J.; Cerdeirina, C. A.; Troncoso, J.; Romani, L.; Esperanca, J. M. S. S.; Guedes, H. J. R.; de Sousa, H. C. (2004) Green Chem. 6(8), 369-381.',
 'A detailed thermodynamic analysis of [C4mim][BF4] + water as a case study to model ionic liquid aqueous solutions')

Each component is a Compound object and contains the following fields:

  • id: compound id;

  • name: compound name;

  • formula: chemical formula;

  • smiles: compound SMILES;

  • smiles_error: if compounds SMILES was not retrieved, this field describes the reason;

  • sample: dictionary containing info on compound’s source, purity, etc.;

  • mw: molar weight of the compound, g/mol.

[8]:
cmp1 = entry.components[0]
cmp1.id, cmp1.name, cmp1.formula, cmp1.smiles, cmp1.smiles_error, cmp1.sample, cmp1.mw
[8]:
('AADYJk',
 'water',
 'H2 O',
 'O',
 None,
 {'Source': 'commercial source',
  'Purification': 'estimated by the compiler',
  'Purity': '99.8 mass %(fractional distillation)'},
 18.02)

The data attribute is a DataFrame containing the measured quantities. Its columns have short labels (V1, V2, …); when a measurement uncertainty is present, the corresponding column uses a d prefix (e.g. V4 and dV4):

[9]:
entry.data
[9]:
V1 V2 V3 V4 dV4
0 100.0 0.0040 278.15 -3.600000e-08 1.000000e-08
1 100.0 0.0040 283.15 -3.350000e-08 1.000000e-08
2 100.0 0.0040 288.15 -3.070000e-08 1.000000e-08
3 100.0 0.0040 293.15 -2.830000e-08 1.000000e-08
4 100.0 0.0040 298.15 -2.580000e-08 1.000000e-08
... ... ... ... ... ...
180 60000.0 0.5905 298.15 4.620000e-07 1.100000e-08
181 60000.0 0.5905 303.15 4.550000e-07 1.100000e-08
182 60000.0 0.5905 313.15 4.510000e-07 1.100000e-08
183 60000.0 0.5905 323.15 5.420000e-07 1.200000e-08
184 60000.0 0.5905 333.15 5.830000e-07 1.200000e-08

185 rows × 5 columns

header field contains full names of the corresponding columns, including measured property, its measurement unit, and optionally compound and phase:

[10]:
entry.header
[10]:
{'V1': 'Pressure, kPa',
 'V2': 'Mole fraction of 1-butyl-3-methylimidazolium tetrafluoroborate => Liquid',
 'V3': 'Temperature, K',
 'V4': 'Excess volume, m<SUP>3</SUP>/mol => Liquid',
 'dV4': 'Error of excess volume, m<SUP>3</SUP>/mol => Liquid'}

Combining entries from different experiments may require harmonizing variables, units, compositions, and constraints. This example focuses on retrieving and inspecting the original records.