{
"cells": [
{
"cell_type": "markdown",
"id": "cell-00",
"metadata": {},
"source": [
"# Halite solubility\n",
"\n",
"\n",
"**Evidence: physical comparison**, with numerical balance and complementarity\n",
"checks. At 298.15 K and 101,325 Pa, add 5, 6.5 and 7.5 mol NaCl to 1 kg water.\n",
"\n",
"The liquid uses Held et al. (2014), Tables 1–3\n",
"([paper](https://doi.org/10.1016/j.cherd.2014.05.017)), specifically\n",
"`held-2014-strategy2/1`. Clarke and Glew (1985)\n",
"([paper](https://doi.org/10.1063/1.555730)), Table 34, supplies dissolution\n",
"ΔG = −9038.7 J/mol; Table 17A supplies the measured 6.1476 mol/kg solubility.\n",
"The retained PHREEQC `pitzer.dat` record supplies 27.1 × 10⁻⁶ m³/mol solid\n",
"molar volume, as documented in the existing halite reference case.\n"
]
},
{
"cell_type": "markdown",
"id": "cell-01",
"metadata": {},
"source": [
"## Read the inputs\n",
"\n",
"Use a repository checkout with the environment described in the installation\n",
"guide. The wheel alone does not contain these data. All density, association,\n",
"equilibrium and parameter-fit iterations below run in the native Engine.\n"
]
},
{
"cell_type": "code",
"execution_count": 1,
"id": "cell-02",
"metadata": {
"execution": {
"iopub.execute_input": "2026-10-20T20:17:22.546285Z",
"iopub.status.busy": "2026-10-20T20:17:22.546168Z",
"iopub.status.idle": "2026-10-20T20:17:22.832001Z",
"shell.execute_reply": "2026-10-20T20:17:22.831243Z"
}
},
"outputs": [],
"source": [
"from pathlib import Path\n",
"import pandas as pd\n",
"from IPython.display import display\n",
"from epcsaft import (\n",
" Parameters,\n",
" Mixture,\n",
")\n",
"from epcsaft import equilibrium as eq\n",
"\n",
"pd.set_option(\"display.max_columns\", None)\n",
"pd.set_option(\"display.max_colwidth\", None)\n",
"\n",
"ROOT = next(\n",
" folder\n",
" for folder in (Path.cwd(), *Path.cwd().parents)\n",
" if (folder / \"ARCHITECTURE.yaml\").is_file()\n",
")\n",
"PACKETS = ROOT / \"data\" / \"packets\"\n",
"\n",
"\n",
"def equilibrium_values(solved):\n",
" \"\"\"Keep the returned physical state and the equation residuals together.\"\"\"\n",
" assert solved.success, solved.message\n",
" assert solved.requested_tolerance_met\n",
" assert solved.classified_residuals\n",
" residual = max(map(abs, solved.classified_residuals), default=0)\n",
" assert residual <= 1e-10\n",
" return dict(\n",
" temperature_K=solved.temperature,\n",
" pressure_Pa=solved.pressure,\n",
" amounts_mol=solved.amounts,\n",
" mole_fractions=solved.mole_fractions,\n",
" molar_densities_mol_m3=solved.molar_densities,\n",
" residual=residual,\n",
" linear_solver=solved.linear_solver,\n",
" )\n"
]
},
{
"cell_type": "markdown",
"id": "cell-03",
"metadata": {},
"source": [
"## Declare a stoichiometric solid\n",
"\n",
"NaCl(s) contains one sodium ion and one chloride ion. The source standard is\n",
"infinite dilution on a 1 mol/kg molality basis at 101,325 Pa. Declare the\n",
"accepted scalar ln K = 3.6461705031852696 only at 298.15 K; no temperature law\n",
"is inferred. The Engine owns reference conversion and solid complementarity.\n",
"\n",
"For each feed, require sodium plus solid balance within 10⁻¹⁰ times feed and\n",
"classified residuals at most 10⁻¹⁰. An absent solid has negative saturation\n",
"index; each present solid must have index within 10⁻¹⁰ of zero. Saturated\n",
"liquid molalities must agree within 10⁻⁸ mol/kg. Retain the existing 3%\n",
"relative comparison with the measured solubility.\n"
]
},
{
"cell_type": "code",
"execution_count": 2,
"id": "cell-04",
"metadata": {
"execution": {
"iopub.execute_input": "2026-10-20T20:17:22.833967Z",
"iopub.status.busy": "2026-10-20T20:17:22.833778Z",
"iopub.status.idle": "2026-10-20T20:17:22.863257Z",
"shell.execute_reply": "2026-10-20T20:17:22.862711Z"
}
},
"outputs": [
{
"data": {
"text/html": [
"
\n",
"\n",
"
\n",
" \n",
" \n",
" | \n",
" feed_mol_kg | \n",
" liquid_molality_mol_kg | \n",
" solid_amount_mol | \n",
" saturation_index | \n",
" residual | \n",
"
\n",
" \n",
" \n",
" \n",
" | 0 | \n",
" 5.0 | \n",
" 5.000000 | \n",
" 0.000000 | \n",
" -0.302933 | \n",
" 1.902069e-15 | \n",
"
\n",
" \n",
" | 1 | \n",
" 6.5 | \n",
" 6.298905 | \n",
" 0.201095 | \n",
" 0.000000 | \n",
" 3.343514e-14 | \n",
"
\n",
" \n",
" | 2 | \n",
" 7.5 | \n",
" 6.298905 | \n",
" 1.201095 | \n",
" 0.000000 | \n",
" 4.074832e-15 | \n",
"
\n",
" \n",
"
\n",
"
"
],
"text/plain": [
" feed_mol_kg liquid_molality_mol_kg solid_amount_mol saturation_index \\\n",
"0 5.0 5.000000 0.000000 -0.302933 \n",
"1 6.5 6.298905 0.201095 0.000000 \n",
"2 7.5 6.298905 1.201095 0.000000 \n",
"\n",
" residual \n",
"0 1.902069e-15 \n",
"1 3.343514e-14 \n",
"2 4.074832e-15 "
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"model = Mixture(\n",
" Parameters.from_json(\n",
" PACKETS / \"held-2014-strategy2/1/parameters/parameters.json\",\n",
" components=[\"water\", \"sodium-cation\", \"chloride-anion\"],\n",
" )\n",
")\n",
"ln_k = 3.6461705031852696\n",
"law = eq.ReactionLogPolynomial(\n",
" ln_k, 0, 0, 0, 298.15, 298.15, 298.15, \"molality-infinite-dilution\"\n",
")\n",
"solid = eq.Solid(\n",
" \"halite\",\n",
" formula={\"sodium-cation\": 1, \"chloride-anion\": 1},\n",
" correlation=law,\n",
" reference=eq.ReactionReference(\n",
" eq.ReferenceSourceBasis.CommonMolalityInfiniteDilution, 101325\n",
" ),\n",
" molar_volume_m3_per_mol=2.71e-05,\n",
")\n",
"solved = []\n",
"for feed in (5.0, 6.5, 7.5):\n",
" problem = eq.Problem(\n",
" T=298.15,\n",
" P=101325,\n",
" phases=[eq.Phase(\"L\", kind=\"liquid\")],\n",
" solids=[solid],\n",
" feed=eq.Molalities(\n",
" {\"sodium-cation\": feed, \"chloride-anion\": feed},\n",
" solvent=[\"water\"],\n",
" solvent_mass_kg=1,\n",
" ),\n",
" neutral_reference=eq.NeutralReference(\n",
" solvent=\"water\",\n",
" solute_molality_ratios={\"sodium-cation\": 1, \"chloride-anion\": 1},\n",
" standard_molality_mol_per_kg=1,\n",
" ),\n",
" )\n",
" equilibrium_result = eq.solve_equilibrium(model, problem)\n",
" solved_values = equilibrium_values(equilibrium_result)\n",
" molality = equilibrium_result.amounts[0] * equilibrium_result.mole_fractions[1]\n",
" assert abs(molality + equilibrium_result.solid_amounts[0] - feed) <= 1e-10 * feed\n",
" solved_values.update(\n",
" feed_mol_kg=feed,\n",
" liquid_molality_mol_kg=molality,\n",
" solid_amount_mol=equilibrium_result.solid_amounts[0],\n",
" saturation_index=equilibrium_result.solid_affinity_decades[0],\n",
" )\n",
" solved.append(solved_values)\n",
"assert abs(solved[1][\"liquid_molality_mol_kg\"] / 6.1476 - 1) < 0.03\n",
"assert (\n",
" abs(solved[1][\"liquid_molality_mol_kg\"] - solved[2][\"liquid_molality_mol_kg\"])\n",
" < 1e-08\n",
")\n",
"assert solved[0][\"solid_amount_mol\"] == 0 and solved[0][\"saturation_index\"] < 0\n",
"assert all((abs(row[\"saturation_index\"]) < 1e-10 for row in solved[1:]))\n",
"values = dict(\n",
" ln_K=ln_k,\n",
" solves=solved,\n",
" source_solubility_mol_kg=6.1476,\n",
" relative_discrepancy=solved[1][\"liquid_molality_mol_kg\"] / 6.1476 - 1,\n",
")\n",
"display(\n",
" pd.DataFrame(solved)[\n",
" [\n",
" \"feed_mol_kg\",\n",
" \"liquid_molality_mol_kg\",\n",
" \"solid_amount_mol\",\n",
" \"saturation_index\",\n",
" \"residual\",\n",
" ]\n",
" ]\n",
")\n"
]
},
{
"cell_type": "markdown",
"id": "cell-05",
"metadata": {},
"source": [
"## Show excess salt entering the solid\n",
"\n",
"Each point is a computed feed case. The connecting line guides the eye.\n"
]
},
{
"cell_type": "code",
"execution_count": 3,
"id": "cell-06",
"metadata": {
"execution": {
"iopub.execute_input": "2026-10-20T20:17:22.864670Z",
"iopub.status.busy": "2026-10-20T20:17:22.864492Z",
"iopub.status.idle": "2026-10-20T20:17:23.703343Z",
"shell.execute_reply": "2026-10-20T20:17:23.702705Z"
}
},
"outputs": [
{
"data": {
"image/png": "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jBCPABIZienTp+PMmTMICwvD8OHDYWVlhRMnTiAkJAQ9evSAjY0N1q9fjxEjRiAmJgZdu3ZFYmIizp07pw09kyZNwpo1a/Doo49i4MCB1V5892E6d+6MESNGYOPGjdpQ4ujoiGeffRajR4/G6NGjcfv2bZw7d65CO9Dc3Bw7d+7Es88+i8DAQAwePBiOjo64efMmzp8/jwULFuDRRx+V5htWheXLl6Nv377o27cvgoODsXXrVnTq1Kna9uukSZMwYsQI5ObmQi6XY9OmTbVqmZubm6Nnz55455130L9/f/j7++PVV18FALRp0wZdu3bFkSNH8OWXXz5wO5GRkejevTsUCkXNX2wNvfPOO9iyZQs6duyIAQMG4PTp07h165b2Pxa1NW3aNAgh8PTTT2P37t14/PHH8dlnn+Hxxx9Hr169EBYWhl27dsHd3b3WAZOI/sYASNREBAcHY968ebC2tq7yeUtLS2zfvh1Hjx7FiRMnYGNjg1dffRXt27fXrtO7d2/cvHkTO3fuRGJiIrp164Yff/xRO+nD0tIShw8fxoYNG5CWloZhw4YhMDDwoZfjmDdvnvbixuUWL16MsLAwBAYGapf997//xfbt23H16lU8+uij+OWXX/D9998jJCREu46vry+OHTuGEydOaO8E0qNHD6xatUobcHr27AlXV9dq6/Hz88O8efMqXMsuKCgI8+bNq/Q9nTVrlvZxhw4dcPXqVWzduhWZmZn47rvv8PTTT2uDSPkkm/I6Bg0ahDNnzmD//v0wMTHBW2+9hcTERGRmZmq3OWXKFAQFBWkf338haADYsWMHNm3apG2r3q9nz55ISUlBz549q32twMMv/1Ju5syZFb7XAPDJJ5+gdevW2sempqaYN28eAgICAADW1tY4evQoIiMjte/b0KFDK4TNd999F506dap2v6NHj64Q5j744AP4+Pjg9OnT6Ny5M1q3bo2LFy9i06ZNMDExwaRJk7B8+XKkpaU99DURUdV4KzgiokZIrVajRYsWeP311zF16tRq18vLy4OTkxOioqLQsmXLBqxQOvfu3UNRUZF24kf5RcqnTZuGd955R8/VETVOPAJIRNTIfPPNN9i1axdKSkoeemmTzMxMfPrpp402/AGlM46feOIJPPbYY7CxscH27dsRFBTEy7oQ1QOPABIRNTI//PAD8vLyMGrUKO3s5KYuKysLu3btQmpqKlq3bo3+/fvzHECiemAAJCIiIjIy/O8TERERkZFhACQiIiIyMgyAREREREaGAZCIiIjIyDAAEhERERkZBkAiIiIiI8MASERERGRkGACJiIiIjAwDIBEREZGRYQAkIiIiMjIMgERERERGhgGQiIiIyMgwABIREREZGQZAIiIiIiPz/3anxOr+0oggAAAAAElFTkSuQmCC",
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"from io import BytesIO\n",
"from IPython.display import Image\n",
"import matplotlib.pyplot as plt\n",
"\n",
"plt.plot(\n",
" [solved[\"feed_mol_kg\"] for solved in values[\"solves\"]],\n",
" [solved[\"solid_amount_mol\"] for solved in values[\"solves\"]],\n",
" marker=\"o\",\n",
")\n",
"plt.xlabel(\"Feed NaCl molality / mol kg$^{-1}$\")\n",
"plt.ylabel(\"Halite amount / mol\")\n",
"buffer = BytesIO()\n",
"plt.tight_layout()\n",
"plt.savefig(buffer, format=\"png\")\n",
"plt.close()\n",
"display(Image(data=buffer.getvalue()))\n"
]
},
{
"cell_type": "code",
"execution_count": 4,
"id": "cell-08",
"metadata": {
"execution": {
"iopub.execute_input": "2026-10-20T20:17:23.704632Z",
"iopub.status.busy": "2026-10-20T20:17:23.704415Z",
"iopub.status.idle": "2026-10-20T20:17:23.707319Z",
"shell.execute_reply": "2026-10-20T20:17:23.706715Z"
}
},
"outputs": [
{
"data": {
"text/html": [
"\n",
"\n",
"
\n",
" \n",
" \n",
" | \n",
" Temperature / K | \n",
" Pressure / Pa | \n",
" Phase amounts / mol | \n",
" Mole fractions / 1 | \n",
" Phase densities / mol m^-3 | \n",
" Linear solver | \n",
"
\n",
" \n",
" \n",
" \n",
" | 0 | \n",
" 298.15 | \n",
" 101325.0 | \n",
" [65.50843506179199] | \n",
" [0.8473479027461528, 0.07632604862692358, 0.07632604862692358] | \n",
" [58395.80192102178] | \n",
" mumps | \n",
"
\n",
" \n",
" | 1 | \n",
" 298.15 | \n",
" 101325.0 | \n",
" [68.10624428000193] | \n",
" [0.8150271043222239, 0.09248644783888807, 0.09248644783888807] | \n",
" [59045.75616417029] | \n",
" mumps | \n",
"
\n",
" \n",
" | 2 | \n",
" 298.15 | \n",
" 101325.0 | \n",
" [68.1062442800019] | \n",
" [0.815027104322224, 0.09248644783888799, 0.09248644783888799] | \n",
" [59045.75616417027] | \n",
" mumps | \n",
"
\n",
" \n",
"
\n",
"
"
],
"text/plain": [
" Temperature / K Pressure / Pa Phase amounts / mol \\\n",
"0 298.15 101325.0 [65.50843506179199] \n",
"1 298.15 101325.0 [68.10624428000193] \n",
"2 298.15 101325.0 [68.1062442800019] \n",
"\n",
" Mole fractions / 1 \\\n",
"0 [0.8473479027461528, 0.07632604862692358, 0.07632604862692358] \n",
"1 [0.8150271043222239, 0.09248644783888807, 0.09248644783888807] \n",
"2 [0.815027104322224, 0.09248644783888799, 0.09248644783888799] \n",
"\n",
" Phase densities / mol m^-3 Linear solver \n",
"0 [58395.80192102178] mumps \n",
"1 [59045.75616417029] mumps \n",
"2 [59045.75616417027] mumps "
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"text/html": [
"\n",
"\n",
"
\n",
" \n",
" \n",
" | \n",
" ln K / 1 | \n",
" Source solubility / mol kg^-1 | \n",
" Relative discrepancy / 1 | \n",
"
\n",
" \n",
" \n",
" \n",
" | 0 | \n",
" 3.646171 | \n",
" 6.1476 | \n",
" 0.024612 | \n",
"
\n",
" \n",
"
\n",
"
"
],
"text/plain": [
" ln K / 1 Source solubility / mol kg^-1 Relative discrepancy / 1\n",
"0 3.646171 6.1476 0.024612"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"display(pd.DataFrame(values[\"solves\"])[[\n",
" \"temperature_K\", \"pressure_Pa\", \"amounts_mol\", \"mole_fractions\",\n",
" \"molar_densities_mol_m3\", \"linear_solver\",\n",
"]].rename(columns={\n",
" \"temperature_K\": \"Temperature / K\",\n",
" \"pressure_Pa\": \"Pressure / Pa\",\n",
" \"amounts_mol\": \"Phase amounts / mol\",\n",
" \"mole_fractions\": \"Mole fractions / 1\",\n",
" \"molar_densities_mol_m3\": \"Phase densities / mol m^-3\",\n",
" \"residual\": \"Maximum classified residual / 1\",\n",
" \"linear_solver\": \"Linear solver\",\n",
" }))\n",
"display(pd.DataFrame([{\n",
" \"ln K / 1\": values[\"ln_K\"],\n",
" \"Source solubility / mol kg^-1\": values[\"source_solubility_mol_kg\"],\n",
" \"Relative discrepancy / 1\": values[\"relative_discrepancy\"],\n",
"}]))\n"
]
},
{
"cell_type": "markdown",
"id": "cell-07",
"metadata": {},
"source": [
"## Meaning and limits\n",
"\n",
"\n",
"The comparison covers one salt, one temperature and one source convention.\n",
"These concentrations exceed the packet's broader assessment ending at\n",
"4.5 mol/kg; the existing solubility reference case supplies this bounded use.\n",
"The 3% criterion is a comparison criterion, not a measurement uncertainty or\n",
"general salt-accuracy claim. Keep the packet's private scientific verification\n",
"use basis; this example does not relicense its source collection.\n"
]
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.13.14"
}
},
"nbformat": 4,
"nbformat_minor": 5
}