gliquid 0.3.3__tar.gz → 0.3.5__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 (127) hide show
  1. {gliquid-0.3.3 → gliquid-0.3.5}/CHANGELOG.md +250 -1
  2. {gliquid-0.3.3 → gliquid-0.3.5}/CITATION.cff +2 -2
  3. {gliquid-0.3.3 → gliquid-0.3.5}/PKG-INFO +1 -1
  4. {gliquid-0.3.3 → gliquid-0.3.5}/notebooks/GaRu_adjustment.ipynb +1 -1
  5. {gliquid-0.3.3 → gliquid-0.3.5}/notebooks/PbTb_adjustment.ipynb +1 -1
  6. {gliquid-0.3.3 → gliquid-0.3.5}/notebooks/colab_demo.ipynb +1 -1
  7. {gliquid-0.3.3 → gliquid-0.3.5}/notebooks/fitting_demo.ipynb +1 -1
  8. {gliquid-0.3.3 → gliquid-0.3.5}/notebooks/interpolation_demo.ipynb +1 -1
  9. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/_version.py +2 -2
  10. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/binary.py +12 -3
  11. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/hsx.py +12 -5
  12. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/imputation/__init__.py +4 -0
  13. gliquid-0.3.5/src/gliquid/imputation/entry_list.py +245 -0
  14. gliquid-0.3.5/src/gliquid/imputation/ternary_imputation.py +1198 -0
  15. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/liquidus_sheets.py +142 -78
  16. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/mpds.py +13 -2
  17. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/plotting/binary_tx.py +117 -39
  18. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/plotting/liquidus_fields.py +490 -126
  19. gliquid-0.3.5/src/gliquid/plotting/solidus_view.py +232 -0
  20. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/plotting/style.py +32 -4
  21. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/plotting/ternary_labels.py +116 -14
  22. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/plotting/ternary_surface.py +112 -38
  23. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/reference/phase_transitions.json +15 -11
  24. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/solution.py +5 -4
  25. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/ternary.py +681 -49
  26. gliquid-0.3.3/src/gliquid/imputation/ternary_imputation.py +0 -549
  27. {gliquid-0.3.3 → gliquid-0.3.5}/.gitattributes +0 -0
  28. {gliquid-0.3.3 → gliquid-0.3.5}/.githooks/pre-commit +0 -0
  29. {gliquid-0.3.3 → gliquid-0.3.5}/.github/CODEOWNERS +0 -0
  30. {gliquid-0.3.3 → gliquid-0.3.5}/.github/dependabot.yml +0 -0
  31. {gliquid-0.3.3 → gliquid-0.3.5}/.github/workflows/release.yml +0 -0
  32. {gliquid-0.3.3 → gliquid-0.3.5}/.github/workflows/tests.yml +0 -0
  33. {gliquid-0.3.3 → gliquid-0.3.5}/.gitignore +0 -0
  34. {gliquid-0.3.3 → gliquid-0.3.5}/CONTRIBUTING.md +0 -0
  35. {gliquid-0.3.3 → gliquid-0.3.5}/LICENSE +0 -0
  36. {gliquid-0.3.3 → gliquid-0.3.5}/README.md +0 -0
  37. {gliquid-0.3.3 → gliquid-0.3.5}/assets/digitized_pd_anatomy.png +0 -0
  38. {gliquid-0.3.3 → gliquid-0.3.5}/assets/gliq_logo_tall.png +0 -0
  39. {gliquid-0.3.3 → gliquid-0.3.5}/assets/invariant_points_and_reactions.png +0 -0
  40. {gliquid-0.3.3 → gliquid-0.3.5}/assets/ru_si_assessed_pd.png +0 -0
  41. {gliquid-0.3.3 → gliquid-0.3.5}/conftest.py +0 -0
  42. {gliquid-0.3.3 → gliquid-0.3.5}/pyproject.toml +0 -0
  43. {gliquid-0.3.3 → gliquid-0.3.5}/requirements/min-constraints.txt +0 -0
  44. {gliquid-0.3.3 → gliquid-0.3.5}/scripts/run_colab_notebook.py +0 -0
  45. {gliquid-0.3.3 → gliquid-0.3.5}/scripts/run_notebooks.py +0 -0
  46. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/__init__.py +0 -0
  47. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/api.py +0 -0
  48. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/cache.py +0 -0
  49. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/config.py +0 -0
  50. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/hull_editor.py +0 -0
  51. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/imputation/ablation.py +0 -0
  52. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/imputation/binary_imputation.py +0 -0
  53. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/imputation/core.py +0 -0
  54. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/imputation/lifecycle.py +0 -0
  55. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/.gitkeep +0 -0
  56. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/feature_names.json +0 -0
  57. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/features_antisymmetric.json +0 -0
  58. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/features_symmetric.json +0 -0
  59. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/manifest.json +0 -0
  60. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_0/L0_a.ubj +0 -0
  61. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_0/L0_b.ubj +0 -0
  62. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_0/L1_a.ubj +0 -0
  63. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_0/best_params.json +0 -0
  64. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_0/metadata.json +0 -0
  65. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_0/model_summary.txt +0 -0
  66. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_0/preprocess.json +0 -0
  67. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_10/L0_a.ubj +0 -0
  68. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_10/L0_b.ubj +0 -0
  69. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_10/L1_a.ubj +0 -0
  70. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_10/best_params.json +0 -0
  71. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_10/metadata.json +0 -0
  72. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_10/model_summary.txt +0 -0
  73. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_10/preprocess.json +0 -0
  74. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_20/L0_a.ubj +0 -0
  75. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_20/L0_b.ubj +0 -0
  76. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_20/L1_a.ubj +0 -0
  77. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_20/best_params.json +0 -0
  78. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_20/metadata.json +0 -0
  79. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_20/model_summary.txt +0 -0
  80. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_20/preprocess.json +0 -0
  81. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_30/L0_a.ubj +0 -0
  82. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_30/L0_b.ubj +0 -0
  83. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_30/L1_a.ubj +0 -0
  84. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_30/best_params.json +0 -0
  85. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_30/metadata.json +0 -0
  86. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_30/model_summary.txt +0 -0
  87. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_30/preprocess.json +0 -0
  88. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_42/L0_a.ubj +0 -0
  89. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_42/L0_b.ubj +0 -0
  90. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_42/L1_a.ubj +0 -0
  91. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_42/best_params.json +0 -0
  92. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_42/metadata.json +0 -0
  93. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_42/model_summary.txt +0 -0
  94. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_42/preprocess.json +0 -0
  95. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_50/L0_a.ubj +0 -0
  96. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_50/L0_b.ubj +0 -0
  97. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_50/L1_a.ubj +0 -0
  98. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_50/best_params.json +0 -0
  99. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_50/metadata.json +0 -0
  100. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_50/model_summary.txt +0 -0
  101. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_50/preprocess.json +0 -0
  102. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_60/L0_a.ubj +0 -0
  103. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_60/L0_b.ubj +0 -0
  104. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_60/L1_a.ubj +0 -0
  105. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_60/best_params.json +0 -0
  106. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_60/metadata.json +0 -0
  107. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_60/model_summary.txt +0 -0
  108. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_60/preprocess.json +0 -0
  109. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_70/L0_a.ubj +0 -0
  110. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_70/L0_b.ubj +0 -0
  111. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_70/L1_a.ubj +0 -0
  112. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_70/best_params.json +0 -0
  113. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_70/metadata.json +0 -0
  114. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_70/model_summary.txt +0 -0
  115. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/models/20261028_105725/seed_70/preprocess.json +0 -0
  116. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/phase.py +0 -0
  117. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/plotting/__init__.py +0 -0
  118. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/plotting/binary_figs.py +0 -0
  119. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/plotting/export.py +0 -0
  120. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/plotting/phase_highlight.py +0 -0
  121. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/plotting/ternary_projection.py +0 -0
  122. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/production_model_runner.py +0 -0
  123. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/reference/omegas_hcp.json +0 -0
  124. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/reference/spurious_structures.json +0 -0
  125. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/shap_compat.py +0 -0
  126. {gliquid-0.3.3 → gliquid-0.3.5}/src/gliquid/solid_coverage.py +0 -0
  127. {gliquid-0.3.3 → gliquid-0.3.5}/tox.ini +0 -0
@@ -9,6 +9,253 @@ source tree carries a version literal that could disagree with this file.
9
9
 
10
10
  ## [Unreleased]
11
11
 
12
+ ## [0.3.5] - 2026-11-20
13
+
14
+ ### Added
15
+
16
+ - **A ternary imputation record reports the enthalpies that bound it on the 0 K hull.**
17
+ `hull_enthalpy` is the hull's formation enthalpy at the phase's composition without the phase:
18
+ below it the phase is on the 0 K hull. `hull_limit_enthalpy`, on a phase that names
19
+ `displaces` and was placed with `force` or `hold_hull`, is the deepest enthalpy that keeps
20
+ those phases.
21
+ - **`force=True` with `hold_hull=True`** holds a phase at the hull limit where an entropy still
22
+ reaches its temperature and places it at its inverted enthalpy where none does; a phase given
23
+ an `enthalpy` or an `entropy` is placed as given. Before, `force` switched `hold_hull` off.
24
+ - **`build_binary_edge_figures(tie_lines={})`** fills the dict with the tie lines each edge
25
+ figure draws.
26
+ - **`plot_tx(canvas=TxCanvas(...))` draws a binary figure at a given size** (figure, margins,
27
+ phase-label and `L` fonts) and places its labels to fit that size; a figure resized after
28
+ `plot_tx` keeps labels placed for the default 750 × 600 px and can overlap at a smaller size.
29
+ `build_binary_edge_figures(canvas=...)` and `TLIPlotter(edge_canvas=...)` pass it to the
30
+ edge figures.
31
+ - **`build_phase_color_map(keep={...})` keeps phase colors across redraws.** A phase listed
32
+ in `keep` keeps its color; a listed phase that is absent holds its color until the palette
33
+ has no other free, and new phases take the free colors. Before, editing a phase moved it to
34
+ the imputed group and shifted the colors after it. `TLIPlotter(keep_colors=...)` passes it to
35
+ the ternary and edge figures.
36
+ - **`TernaryLiquidInterpolation.modified_phase_names()`** names the imputed phases on the solid
37
+ hull that stand in for a DFT entry.
38
+ - **`gliquid.imputation.phase_tops(ti)` gives each line phase's highest stable temperature**
39
+ and what it becomes above it (`PhaseTop`): it melts congruently or incongruently, turns
40
+ into another solid of its composition, or decomposes into other solids. `phase_top` does
41
+ the same for a solid with a given composition, enthalpy and entropy.
42
+ - **A ternary imputation refused for a temperature below the liquid reports
43
+ `lowest_top_k`**, the lowest temperature the phase can be given to leave the hull at, to
44
+ 0.01 K.
45
+ - **`refine_liquid=True` places a ternary phase against the liquid itself.**
46
+ `impute_ternary_phases`, `edit_phases`, `phase_top` and `phase_tops` then read the liquid at
47
+ the phase's own composition and on a fine lattice around the liquid its envelope rests on,
48
+ not on the composition grid alone, and the guard margin raises the phase's temperature by at
49
+ most 0.05 K. The phase leaves the hull where the liquidus sheets of the ternary figure put it;
50
+ the processed diagram reads the liquid on the grid and can show it higher, so use it with
51
+ `screen=False`.
52
+
53
+ ### Changed
54
+
55
+ - **`get_plot('tx', solidus=True)` draws the binary solidus lines in place of the solidus
56
+ triangles**: the tie lines of the three binary edge figures, each on its side of the figure at
57
+ its temperature. In a browser the parts of a line behind the liquidus are still not drawn.
58
+ The triangles' outlines and hover fill are gone, and the temperature window no longer reaches
59
+ down to the coldest triangle. `TLIPlotter.solidus_triangles()` and the bottoms of
60
+ `liquidus_ranges()` are unchanged.
61
+ - **The temperature-axis title of the ternary liquidus figure stands beside the axis.** It is a
62
+ scene annotation at the vertical edge of the box plotly draws the z axis on, upright as before;
63
+ in a browser it follows the axis as the camera turns, and
64
+ `gliquid.plotting.ternary_labels.orient_labels` places it for a camera set in Python. It was
65
+ an annotation fixed to the left margin of the figure.
66
+ - **An imputed phase that stands in for a DFT entry is named `(modified)`** in the legend and
67
+ hover text of the ternary liquidus figure; any other imputed phase is still `(imputed)`.
68
+ - **The line of an imputed or user-defined phase in the ternary liquidus figure is dashed more
69
+ densely**: each dash is 1.4% of the temperature window long, each gap 0.6%
70
+ (`gliquid.plotting.style.SOLID_LINE_DASH_3D`). The dashes are drawn as separate segments, so
71
+ the trace's `line.dash` is no longer set.
72
+ - **The ternary liquidus legend lists the elemental polymorphs by component, in the order of
73
+ the system name, and then by transition temperature**, ahead of the other phases; the other
74
+ line phases follow by composition, richest in the first component first, and the solid
75
+ solutions come last.
76
+ `TernaryLiquidInterpolation.color_map` keeps that order; the colours are unchanged. They were
77
+ listed in the order of the hull's phase names.
78
+
79
+ - **`edit_phases` keeps the interpolated liquid when it removes no phase.** It was interpolated
80
+ again for every edit.
81
+ - **A ternary phase given an `enthalpy` or an `entropy` beside its `temperature` leaves the
82
+ hull at that temperature in the diagram drawn with it.** Its energy is solved without the
83
+ phases without an entropy that it pushes off the 0 K hull, which the hull drawn with it leaves
84
+ out. It was solved with them, and the phase could top out at another temperature.
85
+ - **A ternary phase given an `enthalpy` or an `entropy` beside its `temperature` can leave the
86
+ hull into solids alone.** Where no liquid lies around it at that temperature it takes the
87
+ entropy, below theirs, that puts it on their tie line there: it decomposes into them on
88
+ heating. It was refused as `below_solidus`.
89
+ - **The Colab notebooks install `gliquid` without capping pymatgen.** emmet-core reaches
90
+ `pymatgen-core` through `pymatgen-io-validation` whatever pymatgen is capped at, and every
91
+ `pymatgen-core` release needs `requests>=2.32.5`, so `pymatgen<2026` kept neither Colab's
92
+ `requests` 2.32.4 nor a single pymatgen version. pip still notes that google-colab pins
93
+ `requests==2.32.4`; the install and the notebooks work.
94
+ - **The Hf-Zr diagram in `cache/` is `cache/Hf-Zr.json`**, named like the others, and loads
95
+ with `pd_ind=0` or `pd_ind=None`. The Pb-Rb and Bi-La diagrams and DFT entries and the Al-Mg
96
+ DFT entries are no longer in `cache/`.
97
+
98
+ ### Fixed
99
+
100
+ - **An imputed phase whose name reads as a formula other than its composition keeps that name**
101
+ in the legend and hover text of the ternary liquidus figure. A phase named `Ce12Fe34Si56` at
102
+ Ce2FeSi was shown as Ce6Fe17Si28, the name's formula reduced.
103
+ - **Where two solid phases meet on one vertical line of the ternary liquidus figure, the
104
+ change is drawn at the temperature at which their Gibbs energies cross**, so an elemental
105
+ polymorph transition lies at its transition temperature, level with the binary solidus line
106
+ of that transition. It was drawn at the last temperature of the grid below it.
107
+ - **A solid phase's line in the ternary liquidus figure ends on the liquidus surface** where
108
+ the surface lies below its last stable temperature or within one grid step above it, so no
109
+ line rises through the surface; a line that ends
110
+ further below the surface (a phase that decomposes in the solid state or melts
111
+ incongruently) ends on the binary edge tie line through it where one lies within that grid
112
+ step, and otherwise still ends at its last stable grid temperature.
113
+ - **The ternary liquidus figure and its binary edge figures name compounds in the order of the
114
+ system's components** (`gliquid.plotting.style.standard_formula`), in the legend, the hover
115
+ text and the field labels: `Ga3Y` in Ga-Y, where they showed pymatgen's `YGa3`. The phase
116
+ names the model stores and returns are unchanged.
117
+ - **An edge figure's MAPE chip names the ranges a gapped digitized liquidus covers**:
118
+ `MAPE 13.2% (0–7, 89–100 at.% Ba)` where its points leave a gap wider than
119
+ `gliquid.ternary.LIQUIDUS_GAP`. The MAPE is taken over whatever the liquidus covers, so an
120
+ edge whose liquidus covers less than 70% of the composition range now gets a chip; it had
121
+ none.
122
+
123
+ ## [0.3.4] - 2026-11-16
124
+
125
+ ### Added
126
+
127
+ - **The ternary liquidus figure draws the solidus with `get_plot('tx', solidus=True)`** (off by
128
+ default). Each triangle of three solid phases is drawn flat at the temperature the liquid leaves
129
+ it, outlined in the colour of a binary tie line. In a browser, the parts of an outline that lie
130
+ behind the liquidus from the camera are not drawn, and the triangle under the pointer is lightly
131
+ filled with the three phases' colours, each strongest at its own corner; a static export draws
132
+ every outline whole and no fill.
133
+ `TLIPlotter.solidus_triangles()` returns the triangles: the three phases, their
134
+ compositions, the liquid's composition and the temperature. They are read from the
135
+ three-field joints of the drawn liquidus; a triangle whose last liquid is too dilute in a
136
+ component for the surface to hold its joint (next to a low-melting element that does not mix
137
+ with the others) is solved from the solids' lower hull instead. The bottom of a phase's
138
+ `liquidus_ranges()` is lowered to its coldest solidus triangle whether or not the triangles
139
+ are drawn; with `solidus=True` the drawn temperature window reaches down to the coldest
140
+ triangle unless `temp_range` pins its floor.
141
+ - **`TLIPlotter.liquidus_ranges()`** returns each solid phase's lowest and highest temperature
142
+ in contact with the liquid, read from the phase fields of the last `'tx'` plot. The hull
143
+ table reports a phase's top on its `T_incr` ladder (25 K with `hull_mode='gtx'`); the field
144
+ gives it to the mesh, and exactly for a phase that melts congruently.
145
+ - **`TernaryLiquidInterpolation.edit_phases(edits)`** (`gliquid.imputation.edit_ternary_phases`)
146
+ applies a list of phase removals, temperature changes and additions in one call. A removal
147
+ leaves every DFT entry at the phase's composition off the hull.
148
+ - **`hold_hull=True`** on the ternary imputation calls places a phase that would push a stable
149
+ phase off the 0 K hull instead of refusing it: its enthalpy is held at the deepest value that
150
+ keeps those phases, and it carries the entropy at which it still leaves the hull at the
151
+ requested temperature. The record reports that entropy (`entropy`) and the phases the
152
+ unheld enthalpy would have displaced (`displaces`).
153
+ - **A ternary system's entries as a list, and a list read back.**
154
+ `TernaryLiquidInterpolation.export_entries()` lists the entries of the 0 K solid hull as
155
+ `ComputedEntry` dicts of plain JSON types, imputed and user-defined phases included, each
156
+ with its corrections folded into its energy and its entropy under
157
+ `data["entropy_j_per_mol_k"]`;
158
+ `PhaseDiagram([ComputedEntry.from_dict(d) for d in entries])` builds the same hull.
159
+ `entry_list_edits(entries)` compares such a list with the system and returns the `edit_phases`
160
+ edits that give it the list's phases: a phase whose formation enthalpy or entropy differs is
161
+ changed, a phase at a new composition is added, and a phase the list has no entry for is
162
+ removed. Formation enthalpies are taken against the list's own elemental references, and the
163
+ elements whose reference differs from the system's are reported (`reference_shifts`).
164
+ - **`edit_phases` removes a phase the store imputed**, with the entries it stands in for, and
165
+ takes `"force": True` on a single edit.
166
+ - **`enthalpy=` and `entropy=`** on the ternary imputation calls and in `edit_phases` place a
167
+ phase by its formation enthalpy (J/mol-atom) or its entropy (J/mol-atom/K). Given both, the
168
+ phase carries them as they are. Given one with a temperature, the other is solved so the
169
+ phase leaves the hull at that temperature; given one with a `solidus` and no temperature, so
170
+ it joins the hull there on heating. A phase above the 0 K hull needs a positive entropy, and
171
+ a given enthalpy that would push a stable phase off the 0 K hull is refused (`hold_hull` does
172
+ not move it) unless `force` is set. `impute_phase` takes its temperature as optional.
173
+ - **`solidus=`** on the ternary imputation calls and in `edit_phases` places a phase on the
174
+ hull between two temperatures: it joins the hull at the solidus on heating and leaves it at
175
+ its temperature. Its enthalpy and entropy are solved from the envelope at both, so it lies
176
+ above the 0 K hull and displaces nothing there. The solidus must be a temperature at which
177
+ the liquid reaches the phase's composition, and the solved entropy may take up to 0.9 of the
178
+ envelope's at the top (`SOLIDUS_ENTROPY_SHARE`); a refusal reports the nearest solidus that
179
+ works (`solidus_limit_k`).
180
+ - **An imputed entry carrying an entropy is placed above the 0 K hull**, as a user-defined
181
+ one already was, and a binary edge figure draws a hull entry with the entropy it carries
182
+ (it used zero).
183
+
184
+ ### Changed
185
+
186
+ - **Ternary phase fields with a two-liquid region are drawn faster in both hull modes: about
187
+ 1.5 times over a 2,300-system set, more than 4 times where they were slowest** (Bi-Sn-Th 458 s
188
+ to 96 s with `hull_mode='gtx'`, 642 s to 92 s with `'hsx'`). The binodal solver calls the
189
+ liquid model fewer times, on more points per call, and a triple point's Jacobian and its step
190
+ halvings each take one evaluation of the sheets; these steps leave the drawn surface as it
191
+ was. The lower hulls of one build share the hull of their composition points, which shortens
192
+ the hull stage by about a tenth. The search for a re-entrant two-liquid window drops a point
193
+ once its best value lies far from a window (`SEARCH.hump_reach`), which takes a further sixth
194
+ off the 14 slowest systems and leaves their surfaces bit-identical.
195
+ - **The edge of a two-liquid field is located to 2e-4 in mole fraction** (`WALL.width`), or
196
+ to 0.8% of the distance to the nearest side of the triangle where that is narrower,
197
+ instead of a millionth of each mesh edge, and a crossing with the two-liquid sheet is placed
198
+ once the two sheets agree to the 0.01 K that sheet is solved to. A wall's two vertices sit at
199
+ the two ends of that bracket. The liquidus at the grid nodes is unchanged; vertices next to a
200
+ two-liquid wall move by less than the bracket.
201
+ - **The binary edge figures of a ternary build are made about three times faster** (a median
202
+ of 1.6 s to 0.5 s per system over 30 systems), which shortens `process_data()` by a fifth
203
+ with `hull_mode='gtx'` and by over a quarter with `'hsx'`. `plot_tx` makes each phase line
204
+ and tie line as one trace instead of building a `plotly.express` figure for it; the figures
205
+ are unchanged.
206
+ - **A cliff at the edge of a two-liquid field is drawn without dark slivers or fins.** Every
207
+ face of the partition lists its vertices counter-clockwise, so neighbouring faces are shaded
208
+ alike; a wall's vertex on the two-liquid side sits `WALL.setback` (5e-4 in plot units) inside
209
+ the wall and takes the two-liquid sheet there; and an edge that leaves the field up a rise of
210
+ more than `WALL.jump` is split until the surface follows the sheet, its miss measured across
211
+ the surface as for the edges leaving a side. Vertices next to walls and steep edges move; the
212
+ fields and the liquidus at the grid nodes are unchanged.
213
+ - **The dotted outline of the two-liquid field is not drawn along the sides of the composition
214
+ triangle.** Stretches within `GAP_OUTLINE_CLEARANCE` (0.01 in mole fraction) of a side are
215
+ left out, and so is a run of the rest that never gets twice that far from the sides.
216
+ `field_boundaries(partition, phase, clear=...)` takes the clearance and returns the whole
217
+ outline without it.
218
+ - **A piece of the two-liquid field that leads the solids by at most 10 K (`SHALLOW_GAP`)
219
+ belongs to the solids' fields**: it has no outline, and each of its faces goes to the solid
220
+ hottest there. The surface keeps its temperatures.
221
+
222
+ ### Fixed
223
+
224
+ - **`adjust_phase_temperature` no longer refuses a move because of a phase that is only
225
+ stable while the adjusted phase is lifted out.** The 0 K hull guard protected every compound
226
+ stable once the phase's DFT entries were left off, including ones the phase normally hides
227
+ (Ag-Na: moving NaAg2 was refused for displacing NaAg3, which is not on the hull). It now
228
+ protects the compounds that are stable with those entries in place.
229
+ - **Three solid phase fields on the ternary liquidus now meet at their triple point.** Where
230
+ the triple point lay outside the mesh triangle whose three nodes carry the three phases, the
231
+ fields were joined at the nearest point of that triangle, and one triple point could be drawn
232
+ as several such joints. This happened next to a side or a corner of the diagram, where a
233
+ liquidus sheet is steep: on a 31-system sample, 23 systems had a joint whose three sheets
234
+ differed by more than 1 K and 7 by more than 25 K (251 K in Rb-Si-V). Such a triangle now has
235
+ an edge split, where the third phase is the hottest at the crossing of the edge's two phases,
236
+ until it holds the triple point; every joint of the sample is then within 0.005 K. Over a
237
+ 2,300-system set the surface gains 0.9% more vertices (17% at most) and the figure is drawn
238
+ 4% faster, because the refinement no longer samples new triangles that are too small to
239
+ split. The lowest and highest temperatures `TLIPlotter.liquidus_ranges` reports for a field
240
+ move with its joints.
241
+ - **Two solid phase fields now meet the two-liquid field where their own boundary enters
242
+ it.** Such a joint was left at the nearest point of the mesh triangle whose nodes carry the
243
+ three fields: on 100 systems with a two-liquid field, 203 of 447 joints away from the sides
244
+ had the two solids' sheets more than 0.05 K apart (44 K at most). The edges of these
245
+ triangles are now split as those of three solid phases are, and the joint is placed by
246
+ bisecting the solids' boundary on whether the two-liquid sheet is the hottest
247
+ (`GAP_JOINT`), which also places a joint on a two-liquid wall, where the three sheets are
248
+ never equal. One of the 450 joints is then more than 0.05 K apart (0.18 K). A joint the
249
+ bisection leaves with the two solids' sheets more than 1 K apart, as against a side of the
250
+ triangle, takes the point where the three sheets meet when the solids are closer there. A
251
+ joint at a corner of the triangle can still be open.
252
+ - `extract_digitized_liquidus` reads a narrow few-vertex `L` wedge (at most 0.05 wide in
253
+ composition) from its whole outline instead of keeping its hottest tip as the only point.
254
+ - `phase_transitions.json` cites the CRC Handbook instead of Wolfram ElementData for the
255
+ melting points of Ce, Nd, Tb, Ho and Yb (92nd ed.) and the enthalpies of fusion of Tb, Dy, Ho,
256
+ Lu and Pm (97th ed., "Physical Properties of the Rare Earth Metals"; Ho, Lu and Pm are
257
+ estimates). No value changes.
258
+
12
259
  ## [0.3.3] - 2026-11-09
13
260
 
14
261
  ### Added
@@ -962,7 +1209,9 @@ earlier published versions to diff against; this entry describes what the packag
962
1209
  - **An empty Materials Project fetch now raises rather than being cached.** A zero-entry result
963
1210
  used to be written out as a 2-byte `[]`, which every later read then accepted as a warm cache.
964
1211
 
965
- [Unreleased]: https://github.com/willwerj/gliquid_python/compare/v0.3.3...HEAD
1212
+ [Unreleased]: https://github.com/willwerj/gliquid_python/compare/v0.3.5...HEAD
1213
+ [0.3.5]: https://github.com/willwerj/gliquid_python/compare/v0.3.4...v0.3.5
1214
+ [0.3.4]: https://github.com/willwerj/gliquid_python/compare/v0.3.3...v0.3.4
966
1215
  [0.3.3]: https://github.com/willwerj/gliquid_python/compare/v0.3.2...v0.3.3
967
1216
  [0.3.2]: https://github.com/willwerj/gliquid_python/compare/v0.3.1...v0.3.2
968
1217
  [0.3.1]: https://github.com/willwerj/gliquid_python/compare/v0.3.0...v0.3.1
@@ -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.3"
11
- date-released: "2026-11-09"
10
+ version: "0.3.5"
11
+ date-released: "2026-11-20"
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"
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: gliquid
3
- Version: 0.3.3
3
+ Version: 0.3.5
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/
@@ -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.3\" \"pymatgen<2026\" # keeps Colab's requests==2.32.4\n",
24
+ "# !pip install -q \"gliquid==0.3.5\"\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.3\" \"pymatgen<2026\" # keeps Colab's requests==2.32.4\n",
24
+ "# !pip install -q \"gliquid==0.3.5\"\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.3\" \"pymatgen<2026\"\n",
74
+ "!pip install -q \"gliquid==0.3.5\"\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.3\" \"pymatgen<2026\" # keeps Colab's requests==2.32.4\n",
33
+ "# !pip install -q \"gliquid==0.3.5\"\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.3\" \"pymatgen<2026\" # keeps Colab's requests==2.32.4\n",
25
+ "# !pip install -q \"gliquid==0.3.5\"\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",
@@ -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.3'
22
- __version_tuple__ = version_tuple = (0, 3, 3)
21
+ __version__ = version = '0.3.5'
22
+ __version_tuple__ = version_tuple = (0, 3, 5)
23
23
 
24
24
  __commit_id__ = commit_id = None
@@ -32,6 +32,7 @@ import gliquid.plotting.export as plot_export
32
32
  import gliquid.solid_coverage as solid_coverage
33
33
  import gliquid.solution as solution
34
34
  from gliquid.cache import (
35
+ ENTROPY_KEY,
35
36
  imputed_entry_label,
36
37
  non_dft_entry_kind,
37
38
  non_dft_entry_label,
@@ -489,10 +490,18 @@ def build_phases_from_chull(
489
490
 
490
491
  Returns:
491
492
  list[Phase]: Elemental polymorphs and line compounds sorted by composition,
492
- with the 'L' liquid sentinel appended last.
493
+ with the 'L' liquid sentinel appended last. A line compound is a stable entry of
494
+ ``ch``, or an entry carrying an entropy (``data[ENTROPY_KEY]``, J/mol-atom/K), which is
495
+ placed even above the hull.
493
496
  """
494
497
  phases = _endpoint_polymorphs(components, component_data, exclude_spacegroups)
495
- for entry in ch.stable_entries:
498
+ stable = list(ch.stable_entries)
499
+ lifted = [
500
+ e
501
+ for e in ch.all_entries
502
+ if e not in stable and (getattr(e, "data", None) or {}).get(ENTROPY_KEY)
503
+ ]
504
+ for entry in stable + lifted:
496
505
  composition = api.entry_frac_along(ch, entry, components)[0]
497
506
  if composition in [
498
507
  p.fraction_in(components)[0] for p in phases
@@ -504,7 +513,7 @@ def build_phases_from_chull(
504
513
  phase_type="solid",
505
514
  composition=api.entry_original(entry).composition,
506
515
  enthalpy=EV_ATOM_TO_J_MOL * ch.get_form_energy_per_atom(entry),
507
- entropy=0,
516
+ entropy=float((getattr(entry, "data", None) or {}).get(ENTROPY_KEY, 0.0)),
508
517
  **hull_phase_fields(entry),
509
518
  ),
510
519
  )
@@ -9,6 +9,7 @@ ORCID: https://orcid.org/0000-0001-5205-0075
9
9
  from __future__ import annotations
10
10
 
11
11
  from collections import defaultdict
12
+ from functools import lru_cache
12
13
 
13
14
  import numpy as np
14
15
  import pandas as pd
@@ -38,15 +39,21 @@ def _hull_from_fictitious(real_points, fict_points, second_filter=None):
38
39
  return real_simplices
39
40
 
40
41
 
42
+ @lru_cache(maxsize=8)
43
+ def _base_hull(coordinates: bytes, columns: int) -> np.ndarray:
44
+ """The convex-hull vertices of the points whose float64 bytes are ``coordinates``
45
+ (``columns`` per point), followed by their mean. Shared between calls: do not modify."""
46
+ points = np.frombuffer(coordinates).reshape(-1, columns)
47
+ vertices = points[ConvexHull(points).vertices]
48
+ return np.vstack((vertices, np.mean(vertices, axis=0)))
49
+
50
+
41
51
  def lower_convex_hull(points, vertical_simplices=False):
42
52
  # Lower convex hull of an N-dimensional Xi-E space (energy-like axis last) by the
43
53
  # sub-hull-centroid fictitious-point strategy; returns the lower-hull simplices.
44
54
 
45
- sub_points = points[:, :-1]
46
- sub_hull = ConvexHull(sub_points)
47
- sub_hull_points = sub_points[sub_hull.vertices]
48
- center = np.mean(sub_hull_points, axis=0)
49
- sub_hull_points = np.vstack((sub_hull_points, center))
55
+ sub_points = np.ascontiguousarray(points[:, :-1], dtype=float)
56
+ sub_hull_points = _base_hull(sub_points.tobytes(), sub_points.shape[1])
50
57
 
51
58
  # Compute upper bound for fictitious points using single-pass ptp
52
59
  h_data = points[:, -1]
@@ -20,6 +20,10 @@ _EXPORTS: dict[str, str] = {
20
20
  "list_binary_imputation_targets": "gliquid.imputation.binary_imputation",
21
21
  "impute_ternary_phase": "gliquid.imputation.ternary_imputation",
22
22
  "adjust_ternary_phase_temperature": "gliquid.imputation.ternary_imputation",
23
+ "edit_ternary_phases": "gliquid.imputation.ternary_imputation",
24
+ "PhaseTop": "gliquid.imputation.ternary_imputation",
25
+ "phase_top": "gliquid.imputation.ternary_imputation",
26
+ "phase_tops": "gliquid.imputation.ternary_imputation",
23
27
  "IMPUTED_ID_PREFIX": "gliquid.cache",
24
28
  "PROVENANCE_KEY": "gliquid.imputation.core",
25
29
  "REPLACES_KEY": "gliquid.imputation.core",