gliquid 0.3.2__tar.gz → 0.3.4__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (129) hide show
  1. {gliquid-0.3.2 → gliquid-0.3.4}/.gitattributes +3 -0
  2. {gliquid-0.3.2 → gliquid-0.3.4}/CHANGELOG.md +271 -1
  3. {gliquid-0.3.2 → gliquid-0.3.4}/CITATION.cff +6 -2
  4. {gliquid-0.3.2 → gliquid-0.3.4}/PKG-INFO +2 -2
  5. {gliquid-0.3.2 → gliquid-0.3.4}/notebooks/GaRu_adjustment.ipynb +1 -1
  6. {gliquid-0.3.2 → gliquid-0.3.4}/notebooks/PbTb_adjustment.ipynb +1 -1
  7. {gliquid-0.3.2 → gliquid-0.3.4}/notebooks/colab_demo.ipynb +1 -1
  8. {gliquid-0.3.2 → gliquid-0.3.4}/notebooks/fitting_demo.ipynb +1 -1
  9. {gliquid-0.3.2 → gliquid-0.3.4}/notebooks/interpolation_demo.ipynb +1 -1
  10. {gliquid-0.3.2 → gliquid-0.3.4}/pyproject.toml +2 -1
  11. {gliquid-0.3.2 → gliquid-0.3.4}/requirements/min-constraints.txt +2 -1
  12. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/_version.py +2 -2
  13. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/binary.py +72 -55
  14. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/hsx.py +12 -5
  15. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/imputation/__init__.py +1 -0
  16. gliquid-0.3.4/src/gliquid/imputation/entry_list.py +245 -0
  17. gliquid-0.3.4/src/gliquid/imputation/ternary_imputation.py +908 -0
  18. gliquid-0.3.4/src/gliquid/liquidus_sheets.py +1378 -0
  19. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/mpds.py +57 -2
  20. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/plotting/binary_tx.py +31 -10
  21. gliquid-0.3.4/src/gliquid/plotting/liquidus_fields.py +1676 -0
  22. gliquid-0.3.4/src/gliquid/plotting/solidus_view.py +309 -0
  23. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/plotting/style.py +8 -0
  24. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/plotting/ternary_surface.py +51 -26
  25. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/reference/phase_transitions.json +15 -11
  26. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/solution.py +30 -17
  27. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/ternary.py +1160 -200
  28. gliquid-0.3.2/src/gliquid/imputation/ternary_imputation.py +0 -549
  29. gliquid-0.3.2/src/gliquid/liquidus_sheets.py +0 -527
  30. gliquid-0.3.2/src/gliquid/plotting/liquidus_fields.py +0 -857
  31. {gliquid-0.3.2 → gliquid-0.3.4}/.githooks/pre-commit +0 -0
  32. {gliquid-0.3.2 → gliquid-0.3.4}/.github/CODEOWNERS +0 -0
  33. {gliquid-0.3.2 → gliquid-0.3.4}/.github/dependabot.yml +0 -0
  34. {gliquid-0.3.2 → gliquid-0.3.4}/.github/workflows/release.yml +0 -0
  35. {gliquid-0.3.2 → gliquid-0.3.4}/.github/workflows/tests.yml +0 -0
  36. {gliquid-0.3.2 → gliquid-0.3.4}/.gitignore +0 -0
  37. {gliquid-0.3.2 → gliquid-0.3.4}/CONTRIBUTING.md +0 -0
  38. {gliquid-0.3.2 → gliquid-0.3.4}/LICENSE +0 -0
  39. {gliquid-0.3.2 → gliquid-0.3.4}/README.md +0 -0
  40. {gliquid-0.3.2 → gliquid-0.3.4}/assets/digitized_pd_anatomy.png +0 -0
  41. {gliquid-0.3.2 → gliquid-0.3.4}/assets/gliq_logo_tall.png +0 -0
  42. {gliquid-0.3.2 → gliquid-0.3.4}/assets/invariant_points_and_reactions.png +0 -0
  43. {gliquid-0.3.2 → gliquid-0.3.4}/assets/ru_si_assessed_pd.png +0 -0
  44. {gliquid-0.3.2 → gliquid-0.3.4}/conftest.py +0 -0
  45. {gliquid-0.3.2 → gliquid-0.3.4}/scripts/run_colab_notebook.py +0 -0
  46. {gliquid-0.3.2 → gliquid-0.3.4}/scripts/run_notebooks.py +0 -0
  47. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/__init__.py +0 -0
  48. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/api.py +0 -0
  49. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/cache.py +0 -0
  50. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/config.py +0 -0
  51. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/hull_editor.py +0 -0
  52. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/imputation/ablation.py +0 -0
  53. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/imputation/binary_imputation.py +0 -0
  54. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/imputation/core.py +0 -0
  55. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/imputation/lifecycle.py +0 -0
  56. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/.gitkeep +0 -0
  57. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/feature_names.json +0 -0
  58. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/features_antisymmetric.json +0 -0
  59. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/features_symmetric.json +0 -0
  60. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/manifest.json +0 -0
  61. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_0/L0_a.ubj +0 -0
  62. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_0/L0_b.ubj +0 -0
  63. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_0/L1_a.ubj +0 -0
  64. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_0/best_params.json +0 -0
  65. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_0/metadata.json +0 -0
  66. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_0/model_summary.txt +0 -0
  67. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_0/preprocess.json +0 -0
  68. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_10/L0_a.ubj +0 -0
  69. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_10/L0_b.ubj +0 -0
  70. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_10/L1_a.ubj +0 -0
  71. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_10/best_params.json +0 -0
  72. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_10/metadata.json +0 -0
  73. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_10/model_summary.txt +0 -0
  74. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_10/preprocess.json +0 -0
  75. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_20/L0_a.ubj +0 -0
  76. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_20/L0_b.ubj +0 -0
  77. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_20/L1_a.ubj +0 -0
  78. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_20/best_params.json +0 -0
  79. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_20/metadata.json +0 -0
  80. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_20/model_summary.txt +0 -0
  81. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_20/preprocess.json +0 -0
  82. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_30/L0_a.ubj +0 -0
  83. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_30/L0_b.ubj +0 -0
  84. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_30/L1_a.ubj +0 -0
  85. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_30/best_params.json +0 -0
  86. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_30/metadata.json +0 -0
  87. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_30/model_summary.txt +0 -0
  88. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_30/preprocess.json +0 -0
  89. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_42/L0_a.ubj +0 -0
  90. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_42/L0_b.ubj +0 -0
  91. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_42/L1_a.ubj +0 -0
  92. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_42/best_params.json +0 -0
  93. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_42/metadata.json +0 -0
  94. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_42/model_summary.txt +0 -0
  95. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_42/preprocess.json +0 -0
  96. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_50/L0_a.ubj +0 -0
  97. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_50/L0_b.ubj +0 -0
  98. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_50/L1_a.ubj +0 -0
  99. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_50/best_params.json +0 -0
  100. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_50/metadata.json +0 -0
  101. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_50/model_summary.txt +0 -0
  102. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_50/preprocess.json +0 -0
  103. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_60/L0_a.ubj +0 -0
  104. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_60/L0_b.ubj +0 -0
  105. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_60/L1_a.ubj +0 -0
  106. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_60/best_params.json +0 -0
  107. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_60/metadata.json +0 -0
  108. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_60/model_summary.txt +0 -0
  109. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_60/preprocess.json +0 -0
  110. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_70/L0_a.ubj +0 -0
  111. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_70/L0_b.ubj +0 -0
  112. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_70/L1_a.ubj +0 -0
  113. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_70/best_params.json +0 -0
  114. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_70/metadata.json +0 -0
  115. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_70/model_summary.txt +0 -0
  116. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/models/20261028_105725/seed_70/preprocess.json +0 -0
  117. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/phase.py +0 -0
  118. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/plotting/__init__.py +0 -0
  119. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/plotting/binary_figs.py +0 -0
  120. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/plotting/export.py +0 -0
  121. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/plotting/phase_highlight.py +0 -0
  122. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/plotting/ternary_labels.py +0 -0
  123. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/plotting/ternary_projection.py +0 -0
  124. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/production_model_runner.py +0 -0
  125. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/reference/omegas_hcp.json +0 -0
  126. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/reference/spurious_structures.json +0 -0
  127. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/shap_compat.py +0 -0
  128. {gliquid-0.3.2 → gliquid-0.3.4}/src/gliquid/solid_coverage.py +0 -0
  129. {gliquid-0.3.2 → gliquid-0.3.4}/tox.ini +0 -0
@@ -5,3 +5,6 @@ src/gliquid/models/** -text
5
5
 
6
6
  # The pre-commit hook is run by sh; CRLF in it fails at the shebang line.
7
7
  .githooks/** text eol=lf
8
+
9
+ # Keeps cache/ out of GitHub source archives (and the Zenodo record built from them).
10
+ cache/** export-ignore
@@ -9,6 +9,274 @@ source tree carries a version literal that could disagree with this file.
9
9
 
10
10
  ## [Unreleased]
11
11
 
12
+ ## [0.3.4] - 2026-11-16
13
+
14
+ ### Added
15
+
16
+ - **The ternary liquidus figure draws the solidus with `get_plot('tx', solidus=True)`** (off by
17
+ default). Each triangle of three solid phases is drawn flat at the temperature the liquid leaves
18
+ it, outlined in the colour of a binary tie line. In a browser, the parts of an outline that lie
19
+ behind the liquidus from the camera are not drawn, and the triangle under the pointer is lightly
20
+ filled with the three phases' colours, each strongest at its own corner; a static export draws
21
+ every outline whole and no fill.
22
+ `TLIPlotter.solidus_triangles()` returns the triangles: the three phases, their
23
+ compositions, the liquid's composition and the temperature. They are read from the
24
+ three-field joints of the drawn liquidus; a triangle whose last liquid is too dilute in a
25
+ component for the surface to hold its joint (next to a low-melting element that does not mix
26
+ with the others) is solved from the solids' lower hull instead. The bottom of a phase's
27
+ `liquidus_ranges()` is lowered to its coldest solidus triangle whether or not the triangles
28
+ are drawn; with `solidus=True` the drawn temperature window reaches down to the coldest
29
+ triangle unless `temp_range` pins its floor.
30
+ - **`TLIPlotter.liquidus_ranges()`** returns each solid phase's lowest and highest temperature
31
+ in contact with the liquid, read from the phase fields of the last `'tx'` plot. The hull
32
+ table reports a phase's top on its `T_incr` ladder (25 K with `hull_mode='gtx'`); the field
33
+ gives it to the mesh, and exactly for a phase that melts congruently.
34
+ - **`TernaryLiquidInterpolation.edit_phases(edits)`** (`gliquid.imputation.edit_ternary_phases`)
35
+ applies a list of phase removals, temperature changes and additions in one call. A removal
36
+ leaves every DFT entry at the phase's composition off the hull.
37
+ - **`hold_hull=True`** on the ternary imputation calls places a phase that would push a stable
38
+ phase off the 0 K hull instead of refusing it: its enthalpy is held at the deepest value that
39
+ keeps those phases, and it carries the entropy at which it still leaves the hull at the
40
+ requested temperature. The record reports that entropy (`entropy`) and the phases the
41
+ unheld enthalpy would have displaced (`displaces`).
42
+ - **A ternary system's entries as a list, and a list read back.**
43
+ `TernaryLiquidInterpolation.export_entries()` lists the entries of the 0 K solid hull as
44
+ `ComputedEntry` dicts of plain JSON types, imputed and user-defined phases included, each
45
+ with its corrections folded into its energy and its entropy under
46
+ `data["entropy_j_per_mol_k"]`;
47
+ `PhaseDiagram([ComputedEntry.from_dict(d) for d in entries])` builds the same hull.
48
+ `entry_list_edits(entries)` compares such a list with the system and returns the `edit_phases`
49
+ edits that give it the list's phases: a phase whose formation enthalpy or entropy differs is
50
+ changed, a phase at a new composition is added, and a phase the list has no entry for is
51
+ removed. Formation enthalpies are taken against the list's own elemental references, and the
52
+ elements whose reference differs from the system's are reported (`reference_shifts`).
53
+ - **`edit_phases` removes a phase the store imputed**, with the entries it stands in for, and
54
+ takes `"force": True` on a single edit.
55
+ - **`enthalpy=` and `entropy=`** on the ternary imputation calls and in `edit_phases` place a
56
+ phase by its formation enthalpy (J/mol-atom) or its entropy (J/mol-atom/K). Given both, the
57
+ phase carries them as they are. Given one with a temperature, the other is solved so the
58
+ phase leaves the hull at that temperature; given one with a `solidus` and no temperature, so
59
+ it joins the hull there on heating. A phase above the 0 K hull needs a positive entropy, and
60
+ a given enthalpy that would push a stable phase off the 0 K hull is refused (`hold_hull` does
61
+ not move it) unless `force` is set. `impute_phase` takes its temperature as optional.
62
+ - **`solidus=`** on the ternary imputation calls and in `edit_phases` places a phase on the
63
+ hull between two temperatures: it joins the hull at the solidus on heating and leaves it at
64
+ its temperature. Its enthalpy and entropy are solved from the envelope at both, so it lies
65
+ above the 0 K hull and displaces nothing there. The solidus must be a temperature at which
66
+ the liquid reaches the phase's composition, and the solved entropy may take up to 0.9 of the
67
+ envelope's at the top (`SOLIDUS_ENTROPY_SHARE`); a refusal reports the nearest solidus that
68
+ works (`solidus_limit_k`).
69
+ - **An imputed entry carrying an entropy is placed above the 0 K hull**, as a user-defined
70
+ one already was, and a binary edge figure draws a hull entry with the entropy it carries
71
+ (it used zero).
72
+
73
+ ### Changed
74
+
75
+ - **Ternary phase fields with a two-liquid region are drawn faster in both hull modes: about
76
+ 1.5 times over a 2,300-system set, more than 4 times where they were slowest** (Bi-Sn-Th 458 s
77
+ to 96 s with `hull_mode='gtx'`, 642 s to 92 s with `'hsx'`). The binodal solver calls the
78
+ liquid model fewer times, on more points per call, and a triple point's Jacobian and its step
79
+ halvings each take one evaluation of the sheets; these steps leave the drawn surface as it
80
+ was. The lower hulls of one build share the hull of their composition points, which shortens
81
+ the hull stage by about a tenth. The search for a re-entrant two-liquid window drops a point
82
+ once its best value lies far from a window (`SEARCH.hump_reach`), which takes a further sixth
83
+ off the 14 slowest systems and leaves their surfaces bit-identical.
84
+ - **The edge of a two-liquid field is located to 2e-4 in mole fraction** (`WALL.width`), or
85
+ to 0.8% of the distance to the nearest side of the triangle where that is narrower,
86
+ instead of a millionth of each mesh edge, and a crossing with the two-liquid sheet is placed
87
+ once the two sheets agree to the 0.01 K that sheet is solved to. A wall's two vertices sit at
88
+ the two ends of that bracket. The liquidus at the grid nodes is unchanged; vertices next to a
89
+ two-liquid wall move by less than the bracket.
90
+ - **The binary edge figures of a ternary build are made about three times faster** (a median
91
+ of 1.6 s to 0.5 s per system over 30 systems), which shortens `process_data()` by a fifth
92
+ with `hull_mode='gtx'` and by over a quarter with `'hsx'`. `plot_tx` makes each phase line
93
+ and tie line as one trace instead of building a `plotly.express` figure for it; the figures
94
+ are unchanged.
95
+ - **A cliff at the edge of a two-liquid field is drawn without dark slivers or fins.** Every
96
+ face of the partition lists its vertices counter-clockwise, so neighbouring faces are shaded
97
+ alike; a wall's vertex on the two-liquid side sits `WALL.setback` (5e-4 in plot units) inside
98
+ the wall and takes the two-liquid sheet there; and an edge that leaves the field up a rise of
99
+ more than `WALL.jump` is split until the surface follows the sheet, its miss measured across
100
+ the surface as for the edges leaving a side. Vertices next to walls and steep edges move; the
101
+ fields and the liquidus at the grid nodes are unchanged.
102
+ - **The dotted outline of the two-liquid field is not drawn along the sides of the composition
103
+ triangle.** Stretches within `GAP_OUTLINE_CLEARANCE` (0.01 in mole fraction) of a side are
104
+ left out, and so is a run of the rest that never gets twice that far from the sides.
105
+ `field_boundaries(partition, phase, clear=...)` takes the clearance and returns the whole
106
+ outline without it.
107
+ - **A piece of the two-liquid field that leads the solids by at most 10 K (`SHALLOW_GAP`)
108
+ belongs to the solids' fields**: it has no outline, and each of its faces goes to the solid
109
+ hottest there. The surface keeps its temperatures.
110
+
111
+ ### Fixed
112
+
113
+ - **`adjust_phase_temperature` no longer refuses a move because of a phase that is only
114
+ stable while the adjusted phase is lifted out.** The 0 K hull guard protected every compound
115
+ stable once the phase's DFT entries were left off, including ones the phase normally hides
116
+ (Ag-Na: moving NaAg2 was refused for displacing NaAg3, which is not on the hull). It now
117
+ protects the compounds that are stable with those entries in place.
118
+ - **Three solid phase fields on the ternary liquidus now meet at their triple point.** Where
119
+ the triple point lay outside the mesh triangle whose three nodes carry the three phases, the
120
+ fields were joined at the nearest point of that triangle, and one triple point could be drawn
121
+ as several such joints. This happened next to a side or a corner of the diagram, where a
122
+ liquidus sheet is steep: on a 31-system sample, 23 systems had a joint whose three sheets
123
+ differed by more than 1 K and 7 by more than 25 K (251 K in Rb-Si-V). Such a triangle now has
124
+ an edge split, where the third phase is the hottest at the crossing of the edge's two phases,
125
+ until it holds the triple point; every joint of the sample is then within 0.005 K. Over a
126
+ 2,300-system set the surface gains 0.9% more vertices (17% at most) and the figure is drawn
127
+ 4% faster, because the refinement no longer samples new triangles that are too small to
128
+ split. The lowest and highest temperatures `TLIPlotter.liquidus_ranges` reports for a field
129
+ move with its joints.
130
+ - **Two solid phase fields now meet the two-liquid field where their own boundary enters
131
+ it.** Such a joint was left at the nearest point of the mesh triangle whose nodes carry the
132
+ three fields: on 100 systems with a two-liquid field, 203 of 447 joints away from the sides
133
+ had the two solids' sheets more than 0.05 K apart (44 K at most). The edges of these
134
+ triangles are now split as those of three solid phases are, and the joint is placed by
135
+ bisecting the solids' boundary on whether the two-liquid sheet is the hottest
136
+ (`GAP_JOINT`), which also places a joint on a two-liquid wall, where the three sheets are
137
+ never equal. One of the 450 joints is then more than 0.05 K apart (0.18 K). A joint the
138
+ bisection leaves with the two solids' sheets more than 1 K apart, as against a side of the
139
+ triangle, takes the point where the three sheets meet when the solids are closer there. A
140
+ joint at a corner of the triangle can still be open.
141
+ - `extract_digitized_liquidus` reads a narrow few-vertex `L` wedge (at most 0.05 wide in
142
+ composition) from its whole outline instead of keeping its hottest tip as the only point.
143
+ - `phase_transitions.json` cites the CRC Handbook instead of Wolfram ElementData for the
144
+ melting points of Ce, Nd, Tb, Ho and Yb (92nd ed.) and the enthalpies of fusion of Tb, Dy, Ho,
145
+ Lu and Pm (97th ed., "Physical Properties of the Rare Earth Metals"; Ho, Lu and Pm are
146
+ estimates). No value changes.
147
+
148
+ ## [0.3.3] - 2026-11-09
149
+
150
+ ### Added
151
+
152
+ - `generate_comp_grid(..., edge_rows=0)`: with `edge_rows` > 0, each side of the composition
153
+ triangle also gets rows of nodes at `delta / 3**k` from it (k = 1..`edge_rows`).
154
+ - `SolutionModel.nonideal_h_s` and `SolutionModel.nonideal_gradients` return the two halves of
155
+ `nonideal_h_s_gradients`.
156
+ - `BinaryLiquid.update_phase_points(every_row=False)` and
157
+ `BinaryLiquid.liquid_tstar_row_errors(liq, every_row=False)`: with `every_row=True` the
158
+ liquid's linearization also converges the rows outside the digitized liquidus.
159
+
160
+ ### Changed
161
+
162
+ - **`BinaryLiquid(...)` takes its assessed (MPDS) reference as one
163
+ `reference=LiquidusReference(...)`** (`gliquid.mpds.LiquidusReference`, also importable from
164
+ `gliquid.binary`), holding `mpds_json`, `digitized_liq`, `temp_range`, `pd_ind`,
165
+ `liq_coverage` and `undigitized_comp_ranges`. The system keeps each as an attribute of the
166
+ same name, and `bl.reference` collects them again. Passing one of those keywords, or the
167
+ unused `invariants=`, raises `TypeError` naming its replacement. `BinaryLiquid.from_cache`
168
+ is unchanged.
169
+ - **`hull_mode='gtx'` ternaries default to a 25 K temperature grid.** `T_incr` now defaults to
170
+ `None`, which means 25 K for `gtx` and 10 K for `hsx`; pass `T_incr=10` to keep the old `gtx`
171
+ grid. A `gtx` figure takes about 0.84 times as long, and a solid-phase field's top can sit up
172
+ to one grid step lower. A `gtx` ternary imputation accepts a realized temperature within one
173
+ `T_incr` of its target, so that window is now 25 K by default.
174
+ - **Ternary grids carry extra rows of nodes along each side.** With `delta` at most 0.05 and no
175
+ solid solutions, `TernaryLiquidInterpolation` adds three rows at `delta / 3`, `delta / 9` and
176
+ `delta / 27` from each side, so `comp_grid`, `proc_df` and the hull hold more nodes.
177
+ `TernaryLiquidInterpolation.HULL_COMP_DECIMALS` is now 12 (was 4), so `hull_table()` keeps
178
+ those rows apart.
179
+ - **The ternary liquid's frames hold its H and S at the components' mean melting point.**
180
+ `hsx_df` and `surface_df` take the liquid's H and S at the mean component melting point instead
181
+ of the x-weighted melting point, and `proc_df` keeps them there instead of re-linearizing them
182
+ at each node's liquidus, so a ternary edge's rows in all three depend on the third element
183
+ again (0.3.2 had made them independent of it). The liquidus and the melting points are
184
+ unaffected (see Fixed).
185
+ - **`TernaryLiquidInterpolation.liquid_tstar` holds each liquid node's exact liquidus, K,** in
186
+ both hull modes, and `liquid_tstar_field()` builds from it.
187
+
188
+ ### Removed
189
+
190
+ - `gliquid.plotting.liquidus_fields.SIDE_FRACTION`: use `gliquid.liquidus_sheets.SIDE_FRACTION`.
191
+ - Tuning constants that are used together are grouped into one frozen object each, and their
192
+ old names are gone:
193
+ - in `gliquid.plotting.liquidus_fields`: `GRADING_SHARE` and `GRADING_EDGE` are
194
+ `GRADING.share` and `GRADING.edge`; `CROSSING_STEPS`, `CROSSING_TOLERANCE` and
195
+ `CROSSING_WIDTH` are `CROSSING.steps`, `.tolerance` and `.width`; `TRIPLE_POINT_STEPS` and
196
+ `TRIPLE_POINT_HALVINGS` are `TRIPLE_POINT.steps` and `.halvings`;
197
+ - in `gliquid.liquidus_sheets`: `BINODAL_RADII`, `BINODAL_MOVES`, `BINODAL_RISE` and
198
+ `BINODAL_REACH_STEPS` are `CLIMB.radii`, `.moves`, `.rise` and `.reach_steps`.
199
+ - `gliquid.solution.DEFAULT_TERNARY_TSTAR_MAX_HULLS`: a ternary liquid no longer iterates its
200
+ T*.
201
+ - The `tqdm` dependency: `hull_mode='gtx'` no longer prints a progress bar over its slices.
202
+
203
+ ### Fixed
204
+
205
+ - **`fig.show()` works in a bare Jupyter kernel.** `nbformat>=5.7` is now a base dependency. A
206
+ plain `pip install gliquid` plus `ipykernel` (the VS Code setup) lacked it, and plotly raised
207
+ `Mime type rendering requires nbformat>=4.2.0` on every figure. plotly checks for nbformat
208
+ once, at import, so installing it afterwards needs a kernel restart.
209
+ - **A ternary's liquidus and its solids' melting points are solved with the liquid's Gibbs energy
210
+ at temperature, in both hull modes.** This replaces the per-node re-linearization of 0.3.2,
211
+ which inside a liquid miscibility gap could cycle without converging and drew one-node spikes,
212
+ white holes and nodes missing from the surface.
213
+ - In `hull_mode='hsx'` every node's liquidus, and every solid's highest temperature on the
214
+ hull, is solved on its own HSX facet with the liquid's H and S at that temperature; a node no
215
+ facet solves is solved on lower hulls at fixed temperatures.
216
+ - In `hull_mode='gtx'` every slice carries the liquid's Gibbs energy at its own temperature,
217
+ and a node's liquidus is refined between the last slice it is off the hull at and the next,
218
+ instead of read off the slice. A solid's melting point is still the last slice it is on.
219
+ - Both hull modes take the liquidus sheets' T* from their own liquidus at the nodes, so they
220
+ draw the same sheets, where 0.3.2's two modes could differ by hundreds of kelvin. Both keep
221
+ the phase fields while no node of the hull lies more than 1 K above the sheets.
222
+ - `get_inter_melting_temps` and an imputed phase's realized temperature follow.
223
+ - **Two-liquid (L1 + L2) fields no longer drop out of the ternary liquidus.** Where the liquid
224
+ splits into two liquids only when it is hot, at the foot of a steep dome wall, in a narrow band
225
+ between the grid's rows, along a ridge or in a valley narrower than the grid, or in a narrow
226
+ temperature window, the L1 + L2 sheet came back missing or far too low, and the figure drew the
227
+ solid's sheet there instead: slots, teeth, fins and stray islands along two-liquid fields,
228
+ hundreds of kelvin below the liquidus, and a banded edge along steep dome walls.
229
+ - **A ternary whose miscibility gap tops out far above its nodes' liquidus draws its phase
230
+ fields** (for example Bi-Sn-Ti) instead of rejecting an infinite two-liquid sheet. Where the
231
+ binodal lies far above T*, the two-liquid sheet takes the whole liquid at the binodal's own
232
+ temperature, so in `hull_mode='hsx'` it lies on the exact binodal rather than up to 50 K off.
233
+ Such a ternary takes several times as long to draw as its figure without fields did.
234
+ - **No white holes from the binodal near a grid node.** Every liquid composition's H and S are
235
+ taken at the T* of the composition the binodal solves for. Taking each at its own T* had let a
236
+ single liquidus vertex sit far above its neighbours, which plotly clipped at the top of the
237
+ window as a white hole.
238
+ - **The edge of a two-liquid field that stands above the solids is drawn as a wall.** Where the
239
+ L1 + L2 sheet ends in a jump, the ternary liquidus figure drew a ramp across one mesh cell that
240
+ overshot the solid's liquidus on one side and fell short of the two-liquid liquidus on the
241
+ other. Both fields now keep their own liquidus up to the boundary, joined by a vertical wall,
242
+ and the mesh is refined on the two-liquid side where its liquidus climbs steeply from the wall.
243
+ - **A steep liquidus next to a binary edge or a corner is drawn** instead of being cut across one
244
+ mesh cell. The liquidus partition adds points in six rows near each side, down to 0.025 mole
245
+ fraction from each corner, where the mesh's straight-line liquidus misses the sheets by more
246
+ than 15 K, and takes each such point's solid sheets with the liquid at the hottest solid's own
247
+ temperature.
248
+ - **Curved liquidus domes sag less between grid nodes.** The liquidus partition adds the midpoint
249
+ of a mesh edge whose straight line misses the liquidus there by more than 15 K, so narrow
250
+ two-liquid domes and the creases between their basins are no longer drawn as facets up to
251
+ 75 K off. A figure holds about 6% more vertices.
252
+ - **A ternary liquidus surface no longer shows mottled patches where it overlaps itself in
253
+ view.** Each translucent surface mesh lists its faces coolest first, so they blend in a
254
+ consistent order.
255
+ - **No needle at the sides of the liquidus.** The liquidus sheets read a mole fraction within
256
+ `gliquid.liquidus_sheets.SIDE_FRACTION` of zero as zero, so a partition vertex that round-off
257
+ puts a hair off a side takes that side's liquidus instead of a phase holding the missing
258
+ element. A vertex the partition adds lies at most 25 K above the hottest vertex next to it, so
259
+ a steep wall near a corner no longer draws as a needle; the mesh nodes keep their liquidus.
260
+ - **A liquidus partition with a non-finite vertex falls back to the node mesh.** An infinite
261
+ two-liquid sheet at a refinement vertex no longer makes `get_plot('tx')` raise
262
+ `ValueError: arange: cannot compute length`; the figure is drawn without phase fields, as
263
+ when the sheets disagree with the hull at a node.
264
+ - **The drawn temperature window reaches the liquidus surface's hottest vertex** unless
265
+ `temp_range` pins its top, so a two-liquid dome a few K above the hull's window is no longer
266
+ cut flat.
267
+ - **A ternary `temp_range` with one end pinned past the other end's derived value** no longer
268
+ leaves an empty temperature grid (`IndexError`): a pinned floor above the derived ceiling gets a
269
+ padded ceiling above it, and a pinned ceiling below the derived floor (`hull_mode='gtx'`) caps
270
+ the floor at itself. A pinned range whose low end is above its high end raises `ValueError`.
271
+ A pinned ceiling that leaves too few liquidus nodes to triangulate draws the figure without a
272
+ liquidus mesh, and a WARNING says how few the window holds; one that leaves a patch of
273
+ liquidus nodes touching no side of the composition triangle splits it into the same phase
274
+ fields as the unpinned figure.
275
+ - **A ternary's binary edge figures match the ternary's own edges.** `build_binary_edge_figures`
276
+ converges every row of each edge's liquid (`every_row=True`). It had stopped once the rows
277
+ inside the digitized MPDS liquidus converged, so a predicted edge whose MPDS liquidus is a
278
+ corner fragment drew its liquidus and two-liquid dome up to 60 K off. Fits are unchanged.
279
+
12
280
  ## [0.3.2] - 2026-10-29
13
281
 
14
282
  ### Changed
@@ -830,7 +1098,9 @@ earlier published versions to diff against; this entry describes what the packag
830
1098
  - **An empty Materials Project fetch now raises rather than being cached.** A zero-entry result
831
1099
  used to be written out as a 2-byte `[]`, which every later read then accepted as a warm cache.
832
1100
 
833
- [Unreleased]: https://github.com/willwerj/gliquid_python/compare/v0.3.2...HEAD
1101
+ [Unreleased]: https://github.com/willwerj/gliquid_python/compare/v0.3.4...HEAD
1102
+ [0.3.4]: https://github.com/willwerj/gliquid_python/compare/v0.3.3...v0.3.4
1103
+ [0.3.3]: https://github.com/willwerj/gliquid_python/compare/v0.3.2...v0.3.3
834
1104
  [0.3.2]: https://github.com/willwerj/gliquid_python/compare/v0.3.1...v0.3.2
835
1105
  [0.3.1]: https://github.com/willwerj/gliquid_python/compare/v0.3.0...v0.3.1
836
1106
  [0.3.0]: https://github.com/willwerj/gliquid_python/compare/v0.2.0...v0.3.0
@@ -7,8 +7,8 @@ abstract: >-
7
7
  liquid descriptions.
8
8
  type: software
9
9
  # A literal: bump `version` and `date-released` by hand at each release (CONTRIBUTING.md).
10
- version: "0.3.2"
11
- date-released: "2026-10-29"
10
+ version: "0.3.4"
11
+ date-released: "2026-11-16"
12
12
  license: MIT
13
13
  repository-code: "https://github.com/willwerj/gliquid_python"
14
14
  url: "https://viz.whsunresearch.group/gliquid/interactive-matrix.html"
@@ -17,18 +17,22 @@ authors:
17
17
  family-names: Willwerth
18
18
  email: willwerj@umich.edu
19
19
  affiliation: "University of Michigan"
20
+ orcid: "https://orcid.org/0009-0004-6334-9426"
20
21
  - given-names: Abrar
21
22
  family-names: Rauf
22
23
  email: arauf@umich.edu
23
24
  affiliation: "University of Michigan"
25
+ orcid: "https://orcid.org/0000-0001-5205-0075"
24
26
  - given-names: Shibo
25
27
  family-names: Tan
26
28
  email: shibot@umich.edu
27
29
  affiliation: "University of Michigan"
30
+ orcid: "https://orcid.org/0000-0002-1193-5878"
28
31
  - given-names: Wenhao
29
32
  family-names: Sun
30
33
  email: whsun@umich.edu
31
34
  affiliation: "University of Michigan"
35
+ orcid: "https://orcid.org/0000-0002-8416-455X"
32
36
  keywords:
33
37
  - "density functional theory"
34
38
  - "thermodynamic modeling"
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: gliquid
3
- Version: 0.3.2
3
+ Version: 0.3.4
4
4
  Summary: A package for fitting DFT-referenced liquid free energies from digitized equilibrium phase boundaries
5
5
  Project-URL: Homepage, https://viz.whsunresearch.group/gliquid/interactive-matrix.html
6
6
  Project-URL: TernaryInterpolation, https://viz.whsunresearch.group/gliquid/ternary-interpolation/
@@ -27,13 +27,13 @@ Requires-Python: <3.14,>=3.10
27
27
  Requires-Dist: emmet-core<0.86,>=0.84
28
28
  Requires-Dist: matplotlib>=3.10.0
29
29
  Requires-Dist: mp-api>=0.45.1
30
+ Requires-Dist: nbformat>=5.7
30
31
  Requires-Dist: numpy>=1.24
31
32
  Requires-Dist: pandas>=2.0
32
33
  Requires-Dist: plotly<6.0.0,>=5.24
33
34
  Requires-Dist: pymatgen>=2024.1.1
34
35
  Requires-Dist: scipy>=1.11
35
36
  Requires-Dist: sympy>=1.13
36
- Requires-Dist: tqdm>=4.65
37
37
  Provides-Extra: ml
38
38
  Requires-Dist: xgboost-cpu<4,>=2.1.1; (sys_platform != 'darwin') and extra == 'ml'
39
39
  Requires-Dist: xgboost<4,>=2.0; (sys_platform == 'darwin') and extra == 'ml'
@@ -21,7 +21,7 @@
21
21
  "source": [
22
22
  "## UNCOMMENT THIS BLOCK FOR GOOGLE COLAB\n",
23
23
  "# !git clone --depth 1 https://github.com/willwerj/gliquid_python.git # per-system data in cache/\n",
24
- "# !pip install -q \"gliquid==0.3.2\" \"pymatgen<2026\" # keeps Colab's requests==2.32.4\n",
24
+ "# !pip install -q \"gliquid==0.3.4\" \"pymatgen<2026\" # keeps Colab's requests==2.32.4\n",
25
25
  "# import gliquid.config as cfg\n",
26
26
  "# cfg.set_cache_dir(\"/content/gliquid_python/cache\")\n",
27
27
  "# from google.colab import output\n",
@@ -21,7 +21,7 @@
21
21
  "source": [
22
22
  "## UNCOMMENT THIS BLOCK FOR GOOGLE COLAB\n",
23
23
  "# !git clone --depth 1 https://github.com/willwerj/gliquid_python.git # per-system data in cache/\n",
24
- "# !pip install -q \"gliquid==0.3.2\" \"pymatgen<2026\" # keeps Colab's requests==2.32.4\n",
24
+ "# !pip install -q \"gliquid==0.3.4\" \"pymatgen<2026\" # keeps Colab's requests==2.32.4\n",
25
25
  "# import gliquid.config as cfg\n",
26
26
  "# cfg.set_cache_dir(\"/content/gliquid_python/cache\")\n",
27
27
  "# from google.colab import output\n",
@@ -71,7 +71,7 @@
71
71
  "outputs": [],
72
72
  "source": [
73
73
  "!git clone --depth 1 https://github.com/willwerj/gliquid_python.git\n",
74
- "!pip install -q \"gliquid==0.3.2\" \"pymatgen<2026\"\n",
74
+ "!pip install -q \"gliquid==0.3.4\" \"pymatgen<2026\"\n",
75
75
  "from google.colab import output\n",
76
76
  "output.enable_custom_widget_manager()"
77
77
  ]
@@ -30,7 +30,7 @@
30
30
  "source": [
31
31
  "## UNCOMMENT THIS BLOCK FOR GOOGLE COLAB\n",
32
32
  "# !git clone --depth 1 https://github.com/willwerj/gliquid_python.git # per-system data in cache/\n",
33
- "# !pip install -q \"gliquid==0.3.2\" \"pymatgen<2026\" # keeps Colab's requests==2.32.4\n",
33
+ "# !pip install -q \"gliquid==0.3.4\" \"pymatgen<2026\" # keeps Colab's requests==2.32.4\n",
34
34
  "# import gliquid.config as cfg\n",
35
35
  "# cfg.set_cache_dir(\"/content/gliquid_python/cache\")\n",
36
36
  "# from google.colab import output\n",
@@ -22,7 +22,7 @@
22
22
  "source": [
23
23
  "## UNCOMMENT THIS BLOCK FOR GOOGLE COLAB\n",
24
24
  "# !git clone --depth 1 https://github.com/willwerj/gliquid_python.git # per-system data in cache/\n",
25
- "# !pip install -q \"gliquid==0.3.2\" \"pymatgen<2026\" # keeps Colab's requests==2.32.4\n",
25
+ "# !pip install -q \"gliquid==0.3.4\" \"pymatgen<2026\" # keeps Colab's requests==2.32.4\n",
26
26
  "# import gliquid.config as cfg\n",
27
27
  "# cfg.set_cache_dir(\"/content/gliquid_python/cache\")\n",
28
28
  "# from google.colab import output\n",
@@ -9,6 +9,8 @@ dynamic = ["version"]
9
9
  dependencies = [
10
10
  # >=5.24 works with pandas 3; <6 keeps the fill behaviour the solid-solution envelope uses.
11
11
  "plotly>=5.24,<6.0.0",
12
+ # fig.show() inside a Jupyter kernel needs nbformat.
13
+ "nbformat>=5.7",
12
14
  # <0.86: later emmet-core breaks live Materials Project fetches. Do not lift.
13
15
  "emmet-core>=0.84,<0.86",
14
16
  "mp-api>=0.45.1",
@@ -18,7 +20,6 @@ dependencies = [
18
20
  "scipy>=1.11",
19
21
  "matplotlib>=3.10.0",
20
22
  "sympy>=1.13",
21
- "tqdm>=4.65",
22
23
  # No ML packages here: they are the `ml` extra (test_optional_ml_extras.py checks this).
23
24
  ]
24
25
  requires-python = ">=3.10,<3.14"
@@ -16,6 +16,7 @@
16
16
  # - plotly 5.24.0 is the minimum: 5.18's express layer calls grouped.get_group(s[0]),
17
17
  # which pandas 3.x rejects (KeyError). Measured in the compat matrix on every -min
18
18
  # env at py311+, where pandas 3 is installable; py310-min escapes on pandas 2.3.3.
19
+ # - nbformat 5.7.0 is the floor nbconvert 7 and jupyter already require.
19
20
  # - emmet-core is now capped <0.86 in pyproject: 0.87.1 imports pymatgen.core.entries,
20
21
  # removed from current pymatgen, breaking every live MP fetch on py311+.
21
22
  # - emmet-core is not pinned here; mp-api==0.45.1 resolves it within pyproject's >=0.84,<0.86.
@@ -33,7 +34,7 @@
33
34
  # pin stays. Removing it is a matrix experiment, not a cleanup.
34
35
 
35
36
  plotly==5.24.0
36
- nbformat==4.2.0
37
+ nbformat==5.7.0
37
38
  mp-api==0.45.1
38
39
  matplotlib==3.10.0
39
40
  sympy==1.13
@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
18
18
  commit_id: str | None
19
19
  __commit_id__: str | None
20
20
 
21
- __version__ = version = '0.3.2'
22
- __version_tuple__ = version_tuple = (0, 3, 2)
21
+ __version__ = version = '0.3.4'
22
+ __version_tuple__ = version_tuple = (0, 3, 4)
23
23
 
24
24
  __commit_id__ = commit_id = None