gliquid 0.3.1__tar.gz → 0.3.3__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 (185) hide show
  1. {gliquid-0.3.1 → gliquid-0.3.3}/.gitattributes +3 -0
  2. {gliquid-0.3.1 → gliquid-0.3.3}/.githooks/pre-commit +4 -10
  3. {gliquid-0.3.1 → gliquid-0.3.3}/.github/workflows/release.yml +4 -19
  4. {gliquid-0.3.1 → gliquid-0.3.3}/.github/workflows/tests.yml +9 -15
  5. gliquid-0.3.3/.gitignore +42 -0
  6. {gliquid-0.3.1 → gliquid-0.3.3}/CHANGELOG.md +282 -1
  7. {gliquid-0.3.1 → gliquid-0.3.3}/CITATION.cff +7 -5
  8. {gliquid-0.3.1 → gliquid-0.3.3}/CONTRIBUTING.md +11 -20
  9. {gliquid-0.3.1 → gliquid-0.3.3}/PKG-INFO +2 -2
  10. {gliquid-0.3.1 → gliquid-0.3.3}/conftest.py +3 -3
  11. gliquid-0.3.3/notebooks/GaRu_adjustment.ipynb +377 -0
  12. gliquid-0.3.3/notebooks/PbTb_adjustment.ipynb +320 -0
  13. {gliquid-0.3.1 → gliquid-0.3.3}/notebooks/colab_demo.ipynb +1 -1
  14. gliquid-0.3.3/notebooks/fitting_demo.ipynb +335 -0
  15. gliquid-0.3.3/notebooks/interpolation_demo.ipynb +137 -0
  16. gliquid-0.3.3/pyproject.toml +142 -0
  17. {gliquid-0.3.1 → gliquid-0.3.3}/requirements/min-constraints.txt +2 -1
  18. {gliquid-0.3.1 → gliquid-0.3.3}/scripts/run_notebooks.py +2 -4
  19. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/_version.py +2 -2
  20. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/api.py +4 -5
  21. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/binary.py +347 -87
  22. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/cache.py +3 -0
  23. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/imputation/lifecycle.py +1 -1
  24. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/imputation/ternary_imputation.py +18 -1
  25. gliquid-0.3.3/src/gliquid/liquidus_sheets.py +1314 -0
  26. gliquid-0.3.3/src/gliquid/models/20261028_105725/features_antisymmetric.json +1 -0
  27. gliquid-0.3.3/src/gliquid/models/20261028_105725/features_symmetric.json +1 -0
  28. gliquid-0.3.3/src/gliquid/models/20261028_105725/manifest.json +447 -0
  29. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_0/L0_a.ubj +0 -0
  30. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_0/L0_b.ubj +0 -0
  31. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_0/L1_a.ubj +0 -0
  32. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_0/best_params.json +26 -0
  33. {gliquid-0.3.1/src/gliquid/models/20261017_003407 → gliquid-0.3.3/src/gliquid/models/20261028_105725}/seed_0/metadata.json +1 -1
  34. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_0/model_summary.txt +53 -0
  35. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_0/preprocess.json +317 -0
  36. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_10/L0_a.ubj +0 -0
  37. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_10/L0_b.ubj +0 -0
  38. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_10/L1_a.ubj +0 -0
  39. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_10/best_params.json +26 -0
  40. {gliquid-0.3.1/src/gliquid/models/20261017_003407 → gliquid-0.3.3/src/gliquid/models/20261028_105725}/seed_10/metadata.json +1 -1
  41. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_10/model_summary.txt +53 -0
  42. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_10/preprocess.json +317 -0
  43. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_20/L0_a.ubj +0 -0
  44. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_20/L0_b.ubj +0 -0
  45. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_20/L1_a.ubj +0 -0
  46. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_20/best_params.json +26 -0
  47. {gliquid-0.3.1/src/gliquid/models/20261017_003407 → gliquid-0.3.3/src/gliquid/models/20261028_105725}/seed_20/metadata.json +1 -1
  48. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_20/model_summary.txt +53 -0
  49. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_20/preprocess.json +317 -0
  50. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_30/L0_a.ubj +0 -0
  51. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_30/L0_b.ubj +0 -0
  52. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_30/L1_a.ubj +0 -0
  53. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_30/best_params.json +26 -0
  54. {gliquid-0.3.1/src/gliquid/models/20261017_003407 → gliquid-0.3.3/src/gliquid/models/20261028_105725}/seed_30/metadata.json +1 -1
  55. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_30/model_summary.txt +53 -0
  56. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_30/preprocess.json +317 -0
  57. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_42/L0_a.ubj +0 -0
  58. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_42/L0_b.ubj +0 -0
  59. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_42/L1_a.ubj +0 -0
  60. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_42/best_params.json +26 -0
  61. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_42/metadata.json +37 -0
  62. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_42/model_summary.txt +53 -0
  63. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_42/preprocess.json +317 -0
  64. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_50/L0_a.ubj +0 -0
  65. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_50/L0_b.ubj +0 -0
  66. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_50/L1_a.ubj +0 -0
  67. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_50/best_params.json +26 -0
  68. {gliquid-0.3.1/src/gliquid/models/20261017_003407 → gliquid-0.3.3/src/gliquid/models/20261028_105725}/seed_50/metadata.json +1 -1
  69. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_50/model_summary.txt +53 -0
  70. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_50/preprocess.json +317 -0
  71. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_60/L0_a.ubj +0 -0
  72. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_60/L0_b.ubj +0 -0
  73. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_60/L1_a.ubj +0 -0
  74. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_60/best_params.json +26 -0
  75. {gliquid-0.3.1/src/gliquid/models/20261017_003407 → gliquid-0.3.3/src/gliquid/models/20261028_105725}/seed_60/metadata.json +1 -1
  76. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_60/model_summary.txt +53 -0
  77. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_60/preprocess.json +317 -0
  78. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_70/L0_a.ubj +0 -0
  79. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_70/L0_b.ubj +0 -0
  80. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_70/L1_a.ubj +0 -0
  81. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_70/best_params.json +26 -0
  82. {gliquid-0.3.1/src/gliquid/models/20261017_003407 → gliquid-0.3.3/src/gliquid/models/20261028_105725}/seed_70/metadata.json +1 -1
  83. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_70/model_summary.txt +53 -0
  84. gliquid-0.3.3/src/gliquid/models/20261028_105725/seed_70/preprocess.json +317 -0
  85. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/mpds.py +44 -0
  86. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/phase.py +35 -4
  87. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/plotting/liquidus_fields.py +574 -119
  88. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/plotting/ternary_surface.py +34 -25
  89. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/production_model_runner.py +1 -1
  90. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/reference/phase_transitions.json +2045 -1523
  91. gliquid-0.3.3/src/gliquid/reference/spurious_structures.json +1037 -0
  92. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/solution.py +145 -25
  93. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/ternary.py +698 -130
  94. gliquid-0.3.3/tox.ini +89 -0
  95. gliquid-0.3.1/.gitignore +0 -55
  96. gliquid-0.3.1/notebooks/GaRu_adjustment.ipynb +0 -7863
  97. gliquid-0.3.1/notebooks/PbTb_adjustment.ipynb +0 -7688
  98. gliquid-0.3.1/notebooks/fitting_demo.ipynb +0 -18605
  99. gliquid-0.3.1/notebooks/interpolation_demo.ipynb +0 -326
  100. gliquid-0.3.1/pyproject.toml +0 -237
  101. gliquid-0.3.1/src/gliquid/liquidus_sheets.py +0 -478
  102. gliquid-0.3.1/src/gliquid/models/20261017_003407/features_antisymmetric.json +0 -1
  103. gliquid-0.3.1/src/gliquid/models/20261017_003407/features_symmetric.json +0 -1
  104. gliquid-0.3.1/src/gliquid/models/20261017_003407/manifest.json +0 -447
  105. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_0/L0_a.ubj +0 -0
  106. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_0/L0_b.ubj +0 -0
  107. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_0/L1_a.ubj +0 -0
  108. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_0/best_params.json +0 -26
  109. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_0/model_summary.txt +0 -53
  110. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_0/preprocess.json +0 -317
  111. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_10/L0_a.ubj +0 -0
  112. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_10/L0_b.ubj +0 -0
  113. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_10/L1_a.ubj +0 -0
  114. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_10/best_params.json +0 -26
  115. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_10/model_summary.txt +0 -53
  116. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_10/preprocess.json +0 -317
  117. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_20/L0_a.ubj +0 -0
  118. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_20/L0_b.ubj +0 -0
  119. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_20/L1_a.ubj +0 -0
  120. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_20/best_params.json +0 -26
  121. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_20/model_summary.txt +0 -53
  122. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_20/preprocess.json +0 -317
  123. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_30/L0_a.ubj +0 -0
  124. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_30/L0_b.ubj +0 -0
  125. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_30/L1_a.ubj +0 -0
  126. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_30/best_params.json +0 -26
  127. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_30/model_summary.txt +0 -53
  128. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_30/preprocess.json +0 -317
  129. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_40/L0_a.ubj +0 -0
  130. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_40/L0_b.ubj +0 -0
  131. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_40/L1_a.ubj +0 -0
  132. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_40/best_params.json +0 -26
  133. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_40/metadata.json +0 -37
  134. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_40/model_summary.txt +0 -53
  135. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_40/preprocess.json +0 -317
  136. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_50/L0_a.ubj +0 -0
  137. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_50/L0_b.ubj +0 -0
  138. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_50/L1_a.ubj +0 -0
  139. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_50/best_params.json +0 -26
  140. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_50/model_summary.txt +0 -53
  141. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_50/preprocess.json +0 -317
  142. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_60/L0_a.ubj +0 -0
  143. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_60/L0_b.ubj +0 -0
  144. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_60/L1_a.ubj +0 -0
  145. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_60/best_params.json +0 -26
  146. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_60/model_summary.txt +0 -53
  147. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_60/preprocess.json +0 -317
  148. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_70/L0_a.ubj +0 -0
  149. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_70/L0_b.ubj +0 -0
  150. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_70/L1_a.ubj +0 -0
  151. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_70/best_params.json +0 -26
  152. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_70/model_summary.txt +0 -53
  153. gliquid-0.3.1/src/gliquid/models/20261017_003407/seed_70/preprocess.json +0 -317
  154. gliquid-0.3.1/src/gliquid/reference/spurious_structures.json +0 -356
  155. gliquid-0.3.1/tox.ini +0 -137
  156. {gliquid-0.3.1 → gliquid-0.3.3}/.github/CODEOWNERS +0 -0
  157. {gliquid-0.3.1 → gliquid-0.3.3}/.github/dependabot.yml +0 -0
  158. {gliquid-0.3.1 → gliquid-0.3.3}/LICENSE +0 -0
  159. {gliquid-0.3.1 → gliquid-0.3.3}/README.md +0 -0
  160. {gliquid-0.3.1 → gliquid-0.3.3}/assets/digitized_pd_anatomy.png +0 -0
  161. {gliquid-0.3.1 → gliquid-0.3.3}/assets/gliq_logo_tall.png +0 -0
  162. {gliquid-0.3.1 → gliquid-0.3.3}/assets/invariant_points_and_reactions.png +0 -0
  163. {gliquid-0.3.1 → gliquid-0.3.3}/assets/ru_si_assessed_pd.png +0 -0
  164. {gliquid-0.3.1 → gliquid-0.3.3}/scripts/run_colab_notebook.py +0 -0
  165. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/__init__.py +0 -0
  166. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/config.py +0 -0
  167. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/hsx.py +0 -0
  168. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/hull_editor.py +0 -0
  169. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/imputation/__init__.py +0 -0
  170. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/imputation/ablation.py +0 -0
  171. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/imputation/binary_imputation.py +0 -0
  172. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/imputation/core.py +0 -0
  173. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/models/.gitkeep +0 -0
  174. {gliquid-0.3.1/src/gliquid/models/20261017_003407 → gliquid-0.3.3/src/gliquid/models/20261028_105725}/feature_names.json +0 -0
  175. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/plotting/__init__.py +0 -0
  176. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/plotting/binary_figs.py +0 -0
  177. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/plotting/binary_tx.py +0 -0
  178. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/plotting/export.py +0 -0
  179. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/plotting/phase_highlight.py +0 -0
  180. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/plotting/style.py +0 -0
  181. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/plotting/ternary_labels.py +0 -0
  182. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/plotting/ternary_projection.py +0 -0
  183. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/reference/omegas_hcp.json +0 -0
  184. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/shap_compat.py +0 -0
  185. {gliquid-0.3.1 → gliquid-0.3.3}/src/gliquid/solid_coverage.py +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
@@ -1,13 +1,7 @@
1
1
  #!/bin/sh
2
- # ruff format gate for staged Python, over the same three paths the CI lint job checks.
3
- #
4
- # Reformats the staged files and re-stages them, so the commit records formatted code. A file
5
- # with unstaged changes alongside its staged ones is left alone and the commit aborts: `git add`
6
- # on a partially staged file would sweep the unstaged hunks into the commit too.
7
- #
8
- # Activate: git config core.hooksPath .githooks
9
- # Skip once: git commit --no-verify
10
- # `ruff check` is not run here; the CI lint job runs it and fails on any finding.
2
+ # ruff format for staged Python under src/gliquid and tests/, re-staged after formatting.
3
+ # A file that also has unstaged changes aborts the commit instead of being re-staged.
4
+ # Activate: git config core.hooksPath .githooks. `ruff check` runs in CI, not here.
11
5
 
12
6
  ruff_bin=""
13
7
  if [ -n "$GLIQUID_RUFF" ] && [ -x "$GLIQUID_RUFF" ]; then
@@ -31,7 +25,7 @@ run_ruff() {
31
25
  }
32
26
 
33
27
  staged=$(git diff --cached --name-only --diff-filter=ACM \
34
- | grep -E '^(src/gliquid|tests|tests_internal)/.*\.py$')
28
+ | grep -E '^(src/gliquid|tests)/.*\.py$')
35
29
  [ -n "$staged" ] || exit 0
36
30
 
37
31
  unstaged=$(git diff --name-only)
@@ -6,11 +6,7 @@ on:
6
6
  push:
7
7
  tags: ['v*']
8
8
 
9
- # No API token appears anywhere in this file, by design. Both publish jobs use PyPI Trusted
10
- # Publishing (OIDC): GitHub mints a short-lived identity token at job runtime from
11
- # `permissions: id-token: write`, and the index trusts this repository + workflow + GitHub
12
- # environment. The token-based alternative (a stored __token__ password) is deliberately not
13
- # used -- a leaked long-lived token is exactly what Trusted Publishing removes.
9
+ # No API token: both publish jobs use PyPI Trusted Publishing (OIDC via id-token: write).
14
10
  permissions:
15
11
  contents: read
16
12
 
@@ -22,11 +18,7 @@ jobs:
22
18
  steps:
23
19
  - uses: actions/checkout@v4
24
20
  with:
25
- # NOT optional, and the single most dangerous thing to get wrong in this file.
26
- # hatch-vcs reads the version from git tags; the default shallow clone has none.
27
- # The build would NOT fail -- it would silently emit the pyproject
28
- # fallback-version (0.0.0) and publish it. That fallback is 0.0.0 rather than the
29
- # release version precisely so this failure is visible in the artifact name.
21
+ # Required: without tags hatch-vcs silently builds and publishes version 0.0.0.
30
22
  fetch-depth: 0
31
23
 
32
24
  - name: Set up Python
@@ -46,8 +38,7 @@ jobs:
46
38
  run: twine check dist/*
47
39
 
48
40
  - name: Show built version
49
- # Cheap tripwire for the fetch-depth failure above: a 0.0.0 filename here means the
50
- # tag was not visible to hatch-vcs, and nothing downstream should be released.
41
+ # A 0.0.0 filename means the build missed the tag: release nothing.
51
42
  run: ls -l dist/
52
43
 
53
44
  - name: Upload distributions
@@ -83,13 +74,7 @@ jobs:
83
74
  needs: [testpypi]
84
75
  runs-on: ubuntu-latest
85
76
 
86
- # LOAD-BEARING, NOT DECORATION. The `pypi` GitHub environment carries a
87
- # required-reviewer protection rule, configured in the repository settings UI and not
88
- # expressible in this file. That rule is the entire reason "TestPyPI first, then PyPI"
89
- # is real rather than aspirational: the run pauses here until a maintainer has looked at
90
- # what TestPyPI accepted and approves the deployment. Removing this line -- or deleting
91
- # the environment because it "looks empty" -- turns an irreversible publish into an
92
- # unattended one. PyPI cannot un-publish a version.
77
+ # Required: the `pypi` environment's reviewer rule pauses the run before PyPI. Do not remove.
93
78
  environment: pypi
94
79
  permissions:
95
80
  id-token: write # OIDC identity for Trusted Publishing; see the note at the top
@@ -1,8 +1,6 @@
1
1
  name: Run Tests
2
2
 
3
- # Every branch, not just main. This workflow previously triggered on main only, while the
4
- # code being released lived ~90 commits ahead of it -- so it had never actually run against
5
- # the package it guards.
3
+ # Every branch, and pull requests into main.
6
4
  on:
7
5
  push:
8
6
  branches: ['**']
@@ -28,10 +26,7 @@ jobs:
28
26
  steps:
29
27
  - uses: actions/checkout@v4
30
28
  with:
31
- # NOT optional. hatch-vcs derives the version from the git tag, and the default
32
- # shallow clone fetches none. Getting this wrong does not fail the checkout -- it
33
- # silently produces the pyproject fallback-version (0.0.0), which is why that
34
- # fallback is deliberately not the release version.
29
+ # Required: without tags hatch-vcs silently builds version 0.0.0.
35
30
  fetch-depth: 0
36
31
 
37
32
  - name: Set up Python
@@ -49,16 +44,15 @@ jobs:
49
44
  ${{ runner.os }}-pip-
50
45
 
51
46
  - name: Install package and test extra
52
- # Install the declared extra rather than a bare `pip install pytest`, so CI
53
- # exercises the same dependency set a contributor gets from CONTRIBUTING.md.
47
+ # The test extra, as CONTRIBUTING.md installs it.
54
48
  run: |
55
49
  python -m pip install --upgrade pip
56
50
  pip install -e '.[test]'
57
51
 
58
52
  - name: Run cached tests
59
- # Both tiers, in parallel. The live Materials Project fetches are deselected by marker;
60
- # the API job below runs the one in tests_internal.
61
- run: pytest tests tests_internal -n auto --dist worksteal -m "not needs_network" --tb=short --durations=25
53
+ # In parallel. The live Materials Project fetches are deselected by marker; the API
54
+ # job below runs them.
55
+ run: pytest tests -n auto --dist worksteal -m "not needs_network" --tb=short --durations=25
62
56
 
63
57
  test-api:
64
58
  name: API Tests
@@ -95,7 +89,7 @@ jobs:
95
89
  - name: Run API tests
96
90
  env:
97
91
  NEW_MP_API_KEY: ${{ secrets.NEW_MP_API_KEY }}
98
- run: pytest tests_internal/test_dft_data_loading.py -v --tb=short
92
+ run: pytest tests/test_dft_data_loading.py -v --tb=short
99
93
 
100
94
  lint:
101
95
  name: Lint and Format
@@ -117,7 +111,7 @@ jobs:
117
111
  pip install -e '.[test]'
118
112
 
119
113
  - name: Ruff lint
120
- run: ruff check src/gliquid tests tests_internal
114
+ run: ruff check src/gliquid tests
121
115
 
122
116
  - name: Ruff format check
123
- run: ruff format --check src/gliquid tests tests_internal
117
+ run: ruff format --check src/gliquid tests
@@ -0,0 +1,42 @@
1
+ notebooks/constraint_comparison.ipynb
2
+ notebooks/_executed/
3
+
4
+ # tox / compat testing
5
+ .tox/
6
+ compat-test-phase1.log
7
+
8
+ # pytest-testmon's record
9
+ .testmondata*
10
+
11
+ # Python build / cache / packaging artifacts
12
+ __pycache__/
13
+ *.py[cod]
14
+ build/
15
+ *.egg-info/
16
+ # Written by the hatch-vcs build hook.
17
+ src/gliquid/_version.py
18
+
19
+ # Logs
20
+ *.log
21
+
22
+ # Reagent knowledge-graph database (local only)
23
+ .reagent/
24
+
25
+ # Editor/IDE local config
26
+ .vscode/
27
+
28
+ # Local config. Keep tox.ini and requirements/ tracked: the compat matrix needs them.
29
+ .claude/
30
+ CONTEXT.md
31
+ # Path-anchored: rename these with the cache directory, or fetched files start being tracked.
32
+ cache/fit_results_cache_*
33
+ figures/benchmark_*/
34
+ # Newly fetched DFT caches; the tracked fixture set is unaffected.
35
+ cache/*_ENTRIES_MP_GGA.json
36
+
37
+ # Local secrets (API keys) - never commit
38
+ .env
39
+ .env.*
40
+
41
+ scripts/build_branch_feature_cache.py
42
+ tests/_figures/
@@ -9,6 +9,285 @@ source tree carries a version literal that could disagree with this file.
9
9
 
10
10
  ## [Unreleased]
11
11
 
12
+ ## [0.3.3] - 2026-11-09
13
+
14
+ ### Added
15
+
16
+ - `generate_comp_grid(..., edge_rows=0)`: with `edge_rows` > 0, each side of the composition
17
+ triangle also gets rows of nodes at `delta / 3**k` from it (k = 1..`edge_rows`).
18
+ - `SolutionModel.nonideal_h_s` and `SolutionModel.nonideal_gradients` return the two halves of
19
+ `nonideal_h_s_gradients`.
20
+ - `BinaryLiquid.update_phase_points(every_row=False)` and
21
+ `BinaryLiquid.liquid_tstar_row_errors(liq, every_row=False)`: with `every_row=True` the
22
+ liquid's linearization also converges the rows outside the digitized liquidus.
23
+
24
+ ### Changed
25
+
26
+ - **`BinaryLiquid(...)` takes its assessed (MPDS) reference as one
27
+ `reference=LiquidusReference(...)`** (`gliquid.mpds.LiquidusReference`, also importable from
28
+ `gliquid.binary`), holding `mpds_json`, `digitized_liq`, `temp_range`, `pd_ind`,
29
+ `liq_coverage` and `undigitized_comp_ranges`. The system keeps each as an attribute of the
30
+ same name, and `bl.reference` collects them again. Passing one of those keywords, or the
31
+ unused `invariants=`, raises `TypeError` naming its replacement. `BinaryLiquid.from_cache`
32
+ is unchanged.
33
+ - **`hull_mode='gtx'` ternaries default to a 25 K temperature grid.** `T_incr` now defaults to
34
+ `None`, which means 25 K for `gtx` and 10 K for `hsx`; pass `T_incr=10` to keep the old `gtx`
35
+ grid. A `gtx` figure takes about 0.84 times as long, and a solid-phase field's top can sit up
36
+ to one grid step lower. A `gtx` ternary imputation accepts a realized temperature within one
37
+ `T_incr` of its target, so that window is now 25 K by default.
38
+ - **Ternary grids carry extra rows of nodes along each side.** With `delta` at most 0.05 and no
39
+ solid solutions, `TernaryLiquidInterpolation` adds three rows at `delta / 3`, `delta / 9` and
40
+ `delta / 27` from each side, so `comp_grid`, `proc_df` and the hull hold more nodes.
41
+ `TernaryLiquidInterpolation.HULL_COMP_DECIMALS` is now 12 (was 4), so `hull_table()` keeps
42
+ those rows apart.
43
+ - **The ternary liquid's frames hold its H and S at the components' mean melting point.**
44
+ `hsx_df` and `surface_df` take the liquid's H and S at the mean component melting point instead
45
+ of the x-weighted melting point, and `proc_df` keeps them there instead of re-linearizing them
46
+ at each node's liquidus, so a ternary edge's rows in all three depend on the third element
47
+ again (0.3.2 had made them independent of it). The liquidus and the melting points are
48
+ unaffected (see Fixed).
49
+ - **`TernaryLiquidInterpolation.liquid_tstar` holds each liquid node's exact liquidus, K,** in
50
+ both hull modes, and `liquid_tstar_field()` builds from it.
51
+
52
+ ### Removed
53
+
54
+ - `gliquid.plotting.liquidus_fields.SIDE_FRACTION`: use `gliquid.liquidus_sheets.SIDE_FRACTION`.
55
+ - Tuning constants that are used together are grouped into one frozen object each, and their
56
+ old names are gone:
57
+ - in `gliquid.plotting.liquidus_fields`: `GRADING_SHARE` and `GRADING_EDGE` are
58
+ `GRADING.share` and `GRADING.edge`; `CROSSING_STEPS`, `CROSSING_TOLERANCE` and
59
+ `CROSSING_WIDTH` are `CROSSING.steps`, `.tolerance` and `.width`; `TRIPLE_POINT_STEPS` and
60
+ `TRIPLE_POINT_HALVINGS` are `TRIPLE_POINT.steps` and `.halvings`;
61
+ - in `gliquid.liquidus_sheets`: `BINODAL_RADII`, `BINODAL_MOVES`, `BINODAL_RISE` and
62
+ `BINODAL_REACH_STEPS` are `CLIMB.radii`, `.moves`, `.rise` and `.reach_steps`.
63
+ - `gliquid.solution.DEFAULT_TERNARY_TSTAR_MAX_HULLS`: a ternary liquid no longer iterates its
64
+ T*.
65
+ - The `tqdm` dependency: `hull_mode='gtx'` no longer prints a progress bar over its slices.
66
+
67
+ ### Fixed
68
+
69
+ - **`fig.show()` works in a bare Jupyter kernel.** `nbformat>=5.7` is now a base dependency. A
70
+ plain `pip install gliquid` plus `ipykernel` (the VS Code setup) lacked it, and plotly raised
71
+ `Mime type rendering requires nbformat>=4.2.0` on every figure. plotly checks for nbformat
72
+ once, at import, so installing it afterwards needs a kernel restart.
73
+ - **A ternary's liquidus and its solids' melting points are solved with the liquid's Gibbs energy
74
+ at temperature, in both hull modes.** This replaces the per-node re-linearization of 0.3.2,
75
+ which inside a liquid miscibility gap could cycle without converging and drew one-node spikes,
76
+ white holes and nodes missing from the surface.
77
+ - In `hull_mode='hsx'` every node's liquidus, and every solid's highest temperature on the
78
+ hull, is solved on its own HSX facet with the liquid's H and S at that temperature; a node no
79
+ facet solves is solved on lower hulls at fixed temperatures.
80
+ - In `hull_mode='gtx'` every slice carries the liquid's Gibbs energy at its own temperature,
81
+ and a node's liquidus is refined between the last slice it is off the hull at and the next,
82
+ instead of read off the slice. A solid's melting point is still the last slice it is on.
83
+ - Both hull modes take the liquidus sheets' T* from their own liquidus at the nodes, so they
84
+ draw the same sheets, where 0.3.2's two modes could differ by hundreds of kelvin. Both keep
85
+ the phase fields while no node of the hull lies more than 1 K above the sheets.
86
+ - `get_inter_melting_temps` and an imputed phase's realized temperature follow.
87
+ - **Two-liquid (L1 + L2) fields no longer drop out of the ternary liquidus.** Where the liquid
88
+ splits into two liquids only when it is hot, at the foot of a steep dome wall, in a narrow band
89
+ between the grid's rows, along a ridge or in a valley narrower than the grid, or in a narrow
90
+ temperature window, the L1 + L2 sheet came back missing or far too low, and the figure drew the
91
+ solid's sheet there instead: slots, teeth, fins and stray islands along two-liquid fields,
92
+ hundreds of kelvin below the liquidus, and a banded edge along steep dome walls.
93
+ - **A ternary whose miscibility gap tops out far above its nodes' liquidus draws its phase
94
+ fields** (for example Bi-Sn-Ti) instead of rejecting an infinite two-liquid sheet. Where the
95
+ binodal lies far above T*, the two-liquid sheet takes the whole liquid at the binodal's own
96
+ temperature, so in `hull_mode='hsx'` it lies on the exact binodal rather than up to 50 K off.
97
+ Such a ternary takes several times as long to draw as its figure without fields did.
98
+ - **No white holes from the binodal near a grid node.** Every liquid composition's H and S are
99
+ taken at the T* of the composition the binodal solves for. Taking each at its own T* had let a
100
+ single liquidus vertex sit far above its neighbours, which plotly clipped at the top of the
101
+ window as a white hole.
102
+ - **The edge of a two-liquid field that stands above the solids is drawn as a wall.** Where the
103
+ L1 + L2 sheet ends in a jump, the ternary liquidus figure drew a ramp across one mesh cell that
104
+ overshot the solid's liquidus on one side and fell short of the two-liquid liquidus on the
105
+ other. Both fields now keep their own liquidus up to the boundary, joined by a vertical wall,
106
+ and the mesh is refined on the two-liquid side where its liquidus climbs steeply from the wall.
107
+ - **A steep liquidus next to a binary edge or a corner is drawn** instead of being cut across one
108
+ mesh cell. The liquidus partition adds points in six rows near each side, down to 0.025 mole
109
+ fraction from each corner, where the mesh's straight-line liquidus misses the sheets by more
110
+ than 15 K, and takes each such point's solid sheets with the liquid at the hottest solid's own
111
+ temperature.
112
+ - **Curved liquidus domes sag less between grid nodes.** The liquidus partition adds the midpoint
113
+ of a mesh edge whose straight line misses the liquidus there by more than 15 K, so narrow
114
+ two-liquid domes and the creases between their basins are no longer drawn as facets up to
115
+ 75 K off. A figure holds about 6% more vertices.
116
+ - **A ternary liquidus surface no longer shows mottled patches where it overlaps itself in
117
+ view.** Each translucent surface mesh lists its faces coolest first, so they blend in a
118
+ consistent order.
119
+ - **No needle at the sides of the liquidus.** The liquidus sheets read a mole fraction within
120
+ `gliquid.liquidus_sheets.SIDE_FRACTION` of zero as zero, so a partition vertex that round-off
121
+ puts a hair off a side takes that side's liquidus instead of a phase holding the missing
122
+ element. A vertex the partition adds lies at most 25 K above the hottest vertex next to it, so
123
+ a steep wall near a corner no longer draws as a needle; the mesh nodes keep their liquidus.
124
+ - **A liquidus partition with a non-finite vertex falls back to the node mesh.** An infinite
125
+ two-liquid sheet at a refinement vertex no longer makes `get_plot('tx')` raise
126
+ `ValueError: arange: cannot compute length`; the figure is drawn without phase fields, as
127
+ when the sheets disagree with the hull at a node.
128
+ - **The drawn temperature window reaches the liquidus surface's hottest vertex** unless
129
+ `temp_range` pins its top, so a two-liquid dome a few K above the hull's window is no longer
130
+ cut flat.
131
+ - **A ternary `temp_range` with one end pinned past the other end's derived value** no longer
132
+ leaves an empty temperature grid (`IndexError`): a pinned floor above the derived ceiling gets a
133
+ padded ceiling above it, and a pinned ceiling below the derived floor (`hull_mode='gtx'`) caps
134
+ the floor at itself. A pinned range whose low end is above its high end raises `ValueError`.
135
+ A pinned ceiling that leaves too few liquidus nodes to triangulate draws the figure without a
136
+ liquidus mesh, and a WARNING says how few the window holds; one that leaves a patch of
137
+ liquidus nodes touching no side of the composition triangle splits it into the same phase
138
+ fields as the unpinned figure.
139
+ - **A ternary's binary edge figures match the ternary's own edges.** `build_binary_edge_figures`
140
+ converges every row of each edge's liquid (`every_row=True`). It had stopped once the rows
141
+ inside the digitized MPDS liquidus converged, so a predicted edge whose MPDS liquidus is a
142
+ corner fragment drew its liquidus and two-liquid dome up to 60 K off. Fits are unchanged.
143
+
144
+ ## [0.3.2] - 2026-10-29
145
+
146
+ ### Changed
147
+
148
+ - **The liquid is linearized at its own liquidus, in binaries and ternaries alike.** A liquid whose
149
+ excess terms depend on T ('combined', 'comb-exp') takes its H and S at a composition-dependent
150
+ temperature T*(x), not at the mean component melting point. The first hull takes the
151
+ x-weighted melting point. Each further hull re-evaluates every row at the previous hull's
152
+ liquidus, the step halved where it grew, until no row's |G_lin(T_liq; T*) - G(T_liq)| exceeds
153
+ `DEFAULT_TSTAR_TOL` (0.2143 J/mol, about 2 K of liquidus) or `DEFAULT_TSTAR_MAX_HULLS` (60)
154
+ hulls are built. A binary also needs every row's estimated liquidus shift, that difference
155
+ over the entropy step across its liquidus, at most `DEFAULT_TSTAR_LIQ_TOL` (1 K): near the
156
+ top of a liquid miscibility gap the entropy step vanishes, and a row that meets the energy
157
+ tolerance can still sit tens of K off its converged liquidus as a one-row spike
158
+ (`BinaryLiquid.liquidus_shift_estimate`). A binary checks the rows inside its digitized liquidus; a ternary checks
159
+ every liquid node and stops after `DEFAULT_TERNARY_TSTAR_MAX_HULLS` (3) hulls, the B pass and
160
+ two D passes. On the 96 ternaries of the melting-point benchmark that cap leaves every node's
161
+ liquidus within 3.7 K of the converged one and no melting point or eutectic moved, while
162
+ holding the slowest systems to about 1.7 s per interpolation instead of 2.9 s.
163
+ - The first pass restricts exactly to each binary on a ternary edge, so a ternary edge no longer
164
+ depends on the third element.
165
+ - `liquid_tstar` (on `BinaryLiquid` and `TernaryLiquidInterpolation`) holds the last
166
+ evaluation's T*.
167
+ - Parameters fitted before this change, and the v29.05 model's predictions, render
168
+ differently and should be refit and retrained: the notebook systems' liquidus moves by up to
169
+ 10.5 K (Pb-Tb).
170
+ - Refit over the 853 SOLIDCOV_Q binaries, the fits' exact comb-exp liquidus matches MPDS with a
171
+ mean absolute error of 77.4 K, against 79.9 K for fits under the mean melting point, and
172
+ fitting takes about twice as long.
173
+ - **The unexpected-gap penalty counts only real gaps.** A two-liquid tie of the fitted hull
174
+ counts only where the liquid's exact Gibbs energy, with the solids, also ties two liquids at
175
+ that temperature.
176
+ - **Nelder-Mead returns its best vertex at `max_iter`** instead of raising.
177
+ - **Every initial simplex spans at least `DEFAULT_B_SPREAD_MIN` in L*_b.** A small L*_b vertex
178
+ is moved by the spread rather than scaled by 0.8.
179
+ - **`liquidus_is_continuous` allows one missing grid row**, as its tolerance intends, despite
180
+ floating-point error in the grid spacing.
181
+ - **Ternary imputation reads the liquid's Gibbs energy at the target temperature.**
182
+ `TernaryLiquidInterpolation.liquid_gibbs` takes H and S at the temperature asked for, as the
183
+ binary imputation does. A ternary imputed entry with a T-dependent edge recorded before this
184
+ change reports itself stale (`liquid_gibbs` provenance).
185
+ - **`LiquidusSheets` and `Binodal` take a `TstarField`** (the liquid's T*(x)) in place of one
186
+ temperature. `TernaryLiquidInterpolation.liquid_tstar_field()` builds it.
187
+ - **One test suite.** `tests_internal/` is merged into `tests/`, so a bare `pytest` also runs the
188
+ value pins, figure goldens and cache/network-gated families. Deselect them by marker
189
+ (`-m "not pins"`, `-m "not needs_cache"`).
190
+ - **The unary reference data are anchored on Materials Project GGA/GGA+U energies.**
191
+ `phase_transitions.json` was built from MP's mixed GGA/GGA+U/r2SCAN energies while every
192
+ convex hull uses GGA entries; every DFT energy in it is now the GGA/GGA+U thermo energy. Sources
193
+ are used in a fixed order: MP-GGA for the ground state and every phase it has, the omegas GGA
194
+ lattice stabilities (Chen et al., Nat. Commun. 14, 2856 (2023)) for BCC/FCC/HCP references MP
195
+ lacks or places below the ground state, and SGTE or an assessed literature value only where the
196
+ observed 1 atm phase order needs it or no DFT BCC/FCC/HCP value lands above the ground state.
197
+ - Ten ground states move to the stable 1 atm structure: K and Cs to bcc, Kr and Xe to fcc,
198
+ As to rhombohedral, Se to trigonal, Pu to alpha-Pu (monoclinic), N to alpha-N2 (Pa-3), H to
199
+ solid para-H2 (hcp, mp-24504), and Na to its 9R martensite (R-3m), with bcc from 36 K.
200
+ `expected_gs_spacegroup` in `spurious_structures.json` now covers 85 elements (62 observed
201
+ ground states, the rest from SGTE's stable element reference or the existing anchor), so the
202
+ hull anchor guard covers them too.
203
+ - Every real phase whose ladder enthalpy is SGTE or assessed (28 MP entries, such as gamma-Fe,
204
+ fcc-Co, beta-Zr and the Pu allotropes) is in `spurious_structures.json` with
205
+ `category: "sgte_corrected"`, so no corrected DFT entry reaches a hull; the ladder phase keeps
206
+ the structure and its id becomes `sgte-<El>-<spacegroup>`. 26 further entries with no 1 atm
207
+ stability field are blacklisted as `spurious`, each with a literature source, among them the
208
+ former H anchor (mp-730101, the H sublattice of ammonium dideuterium phosphate); only fibrous
209
+ red P (mp-1198724) is still marked `status: "derived; literature review pending"`. The 7
210
+ computational BCC/FCC/HCP prototypes among them carry `ss_structure`.
211
+ - Liquid references move for fifteen elements: Pu by -47568 J/mol (every Pu step is now SGTE),
212
+ Ti by -2765 J/mol (beta-Ti from 13146.9 to 10381.94 J/mol), Li by -436 J/mol and
213
+ -4.955 J/mol/K (the 9R -> bcc step at 74 K instead of 80 K; Maier et al., Phys. Rev. B 55,
214
+ 113 (1997)), Na by +429 J/mol and +11.93 J/mol/K (the 9R -> bcc step at 36 K), Sr by
215
+ +576 J/mol and +0.628 J/mol/K, Ba by +730 J/mol and +0.73 J/mol/K, and Ca by -31 J/mol and
216
+ -0.043 J/mol/K. Ca, Sr and Ba take the assessment of Alcock, Chase & Itkin (J. Phys. Chem.
217
+ Ref. Data 22, 1 (1993)). Ca: fcc -> bcc at 716 K with 930 J/mol instead of an unverified
218
+ 961 J/mol. Sr: fcc -> bcc at 820 K with 850 J/mol, and fusion at 1041 K with 8000 J/mol,
219
+ instead of SGTE's 844 J/mol at 830 K and CRC's 7430 J/mol at 1050 K. Ba: fusion with
220
+ 7850 J/mol instead of CRC's 7120 J/mol, at the same 1000 K. La, Ce, Sm and Gd take Konings &
221
+ Beneš (J. Phys. Chem. Ref. Data 39, 043102 (2010)), Mn, Fe and the Be transition take
222
+ NIST-JANAF (Chase 1998), and Be's fusion takes Alcock et al.: Sm by +1063 J/mol and
223
+ +1.135 J/mol/K (alpha -> beta at 970 K and beta -> gamma at 1185 K instead of 1190 K and
224
+ 1345 K, with 100, 3170 and 9100 J/mol steps), Be by +1028 J/mol and +0.659 J/mol/K (fusion
225
+ 8000 J/mol instead of 6972 J/mol), Ce by -620 J/mol and -0.579 J/mol/K (fusion 5580 J/mol
226
+ instead of 6200 J/mol), Gd by +183 J/mol and +0.064 J/mol/K (alpha -> beta at 1534 K with
227
+ 3940 J/mol, fusion at 1591 K with 9800 J/mol), Tl by +171 J/mol and +0.289 J/mol/K (fusion
228
+ 4150 J/mol and SGTE's 360 J/mol beta step), Sn by -124 J/mol and -0.433 J/mol/K (SGTE's
229
+ 1966 J/mol beta step instead of 2090 J/mol), Mn by -81 J/mol and +0.034 J/mol/K (2226, 2122
230
+ and 1879 J/mol steps at 980, 1361 and 1412 K) and La by -36 J/mol (beta at 566 K, gamma at
231
+ 1140 K, fusion 6140 J/mol at 1192 K).
232
+ - Solid-solution references (`lattice_stabilities`): 95 change by more than 0.5 J/mol, 21 are
233
+ new and 7 are dropped. Omegas values are measured from the element's MP-GGA ground-state
234
+ energy instead of a shared structure, so FCC-Ga becomes +1923 J/mol instead of 0. Mg and Cd
235
+ FCC come from
236
+ omegas, and In FCC and Hg FCC/HCP from SGTE, because the DFT values before them land below
237
+ the ground state. Hg BCC, which no DFT or SGTE source places above the ground state, takes
238
+ the enthalpy of the fitted end member of the Hg-Tl assessment (Gierlotka, Sopousek &
239
+ Fitzner, Calphad 30, 425 (2006)): +5540 J/mol, id `assessed-Hg-229`, instead of +336 J/mol.
240
+ A structure with no source above the ground state is not emitted and is listed under the
241
+ element's new `excluded_lattice_stabilities` (Eu FCC, Xe BCC).
242
+ Fitted parameters made before this change do not carry over and must be refit.
243
+
244
+ - **A ladder phase is a solid solution's end member only if it has that structure's
245
+ prototype.** Spacegroup 194 holds hcp (hP2), dhcp and graphite (hP4); `Phase` now carries
246
+ `pearson_symbol`, and `ComponentRef.ss_polymorphs` picks the end member by spacegroup and
247
+ prototype. A dhcp or graphite ground state stands in for HCP only when no hP2 lattice stability
248
+ exists, and gliquid logs a warning when it does. Pr's HCP solid solution now uses the hP2
249
+ lattice stability (+2792.66 J/mol) and alpha-Pr (dhcp) stays a line compound beside it; C, La,
250
+ Nd and Sm keep their SG 194 phase as a stand-in.
251
+
252
+ - **`ref_mode="from_dft_entries"` takes the ladder step for a real phase with no DFT entry.** A
253
+ BCC, FCC or HCP phase on the element's ladder that the DFT entries lack, such as one the
254
+ blacklist keeps off hulls, takes its ladder enthalpy above the DFT ground state when that
255
+ ground state has the ladder ground state's spacegroup. Otherwise it is left to the omegas
256
+ fallback and gliquid logs a warning.
257
+
258
+ - **Candidate Nelder-Mead fits converge on one scale and start Lupis-Elliott-consistent.** The
259
+ convergence test weighs an `L*_b` coordinate by the mean liquidus temperature, so `L*_a` and
260
+ `L*_b` are measured by their contribution to `L_k` (J/mol); the tolerance is
261
+ `CANDIDATE_TOL_J_MOL` (100 J/mol). `BinaryLiquid.nelder_mead` takes the per-coordinate `scale`.
262
+ The offset vertex of a candidate's initial simplex moves `L*_b` toward excess entropy of the
263
+ sign of `L*_a` at 0 K, in the linear and `exp(-T/tau)` forms alike.
264
+
265
+ - **The packaged model is v29.07** (bundle `20261028_105725`, replacing `20261017_003407`).
266
+ It is the mean of eight XGBoost models trained at different seeds, on the 854 binaries refit
267
+ with the liquid linearized at its own liquidus, the GGA-anchored unary references and the
268
+ Nelder-Mead changes above, with 49 symmetric and 30 antisymmetric features. On its 100 held-out
269
+ test systems it predicts the liquidus with a mean absolute percentage error of 10.98 % (median
270
+ 8.91 %) and a mean absolute error of 169.6 K. Every predicted parameter changes from 0.3.1.
271
+
272
+ ### Fixed
273
+
274
+ - **The H-S partition seed fit honours a pinned `L*_b`.** In `'comb-exp'` it fitted `L1`
275
+ with `L1_b = L1_a / tau` (zero excess entropy at 0 K) and then handed `L1_a` to candidates that
276
+ hold `L1_b = 0`; it now fits the pinned model throughout.
277
+
278
+ - **The Bi-Sr hull follows the assessed diagram's compounds.** The Materials Project hull has
279
+ vertices at Sr2Bi3 (mp-31150, x_Sr = 0.400) and Sr4Bi3 (mp-30893, x_Sr = 0.571), which the
280
+ assessed Bi-Sr diagram does not draw, and takes the P6_3/mcm polymorph of Sr5Bi3 (mp-29620).
281
+ All three are now in `spurious_structures.json`; the hull becomes SrBi3, Sr11Bi10 and the
282
+ Pnma Sr5Bi3 (mp-1197242).
283
+
284
+ - **The ternary T-x figure draws each solid phase as one vertical segment per composition.**
285
+ `render_tx_surface` joined every point of a phase into one line, which zig-zagged between
286
+ compositions; the segments are now separate.
287
+
288
+ - **`copy.deepcopy` of a `SqliteBackend` returns the same backend** instead of copying the open
289
+ store.
290
+
12
291
  ## [0.3.1] - 2026-10-17
13
292
 
14
293
  ### Added
@@ -683,7 +962,9 @@ earlier published versions to diff against; this entry describes what the packag
683
962
  - **An empty Materials Project fetch now raises rather than being cached.** A zero-entry result
684
963
  used to be written out as a 2-byte `[]`, which every later read then accepted as a warm cache.
685
964
 
686
- [Unreleased]: https://github.com/willwerj/gliquid_python/compare/v0.3.1...HEAD
965
+ [Unreleased]: https://github.com/willwerj/gliquid_python/compare/v0.3.3...HEAD
966
+ [0.3.3]: https://github.com/willwerj/gliquid_python/compare/v0.3.2...v0.3.3
967
+ [0.3.2]: https://github.com/willwerj/gliquid_python/compare/v0.3.1...v0.3.2
687
968
  [0.3.1]: https://github.com/willwerj/gliquid_python/compare/v0.3.0...v0.3.1
688
969
  [0.3.0]: https://github.com/willwerj/gliquid_python/compare/v0.2.0...v0.3.0
689
970
  [0.2.0]: https://github.com/willwerj/gliquid_python/compare/v0.1.0...v0.2.0
@@ -6,11 +6,9 @@ abstract: >-
6
6
  phase boundaries, and for interpolating multicomponent phase diagrams from the fitted binary
7
7
  liquid descriptions.
8
8
  type: software
9
- # NOTE: this version is a literal and nothing derives it. The distribution version comes from
10
- # the git tag via hatch-vcs, so this file and `date-released` below must be bumped BY HAND at
11
- # each release -- see the release checklist in CONTRIBUTING.md.
12
- version: "0.3.1"
13
- date-released: "2026-10-17"
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"
14
12
  license: MIT
15
13
  repository-code: "https://github.com/willwerj/gliquid_python"
16
14
  url: "https://viz.whsunresearch.group/gliquid/interactive-matrix.html"
@@ -19,18 +17,22 @@ authors:
19
17
  family-names: Willwerth
20
18
  email: willwerj@umich.edu
21
19
  affiliation: "University of Michigan"
20
+ orcid: "https://orcid.org/0009-0004-6334-9426"
22
21
  - given-names: Abrar
23
22
  family-names: Rauf
24
23
  email: arauf@umich.edu
25
24
  affiliation: "University of Michigan"
25
+ orcid: "https://orcid.org/0000-0001-5205-0075"
26
26
  - given-names: Shibo
27
27
  family-names: Tan
28
28
  email: shibot@umich.edu
29
29
  affiliation: "University of Michigan"
30
+ orcid: "https://orcid.org/0000-0002-1193-5878"
30
31
  - given-names: Wenhao
31
32
  family-names: Sun
32
33
  email: whsun@umich.edu
33
34
  affiliation: "University of Michigan"
35
+ orcid: "https://orcid.org/0000-0002-8416-455X"
34
36
  keywords:
35
37
  - "density functional theory"
36
38
  - "thermodynamic modeling"
@@ -26,24 +26,15 @@ directory is named `gliquid_python`. The store is the first of: `set_cache_dir()
26
26
 
27
27
  ## Running the tests
28
28
 
29
- Run `pytest` from the repository root. The suite is tiered, and which tier you get depends on
30
- what you pass:
31
-
32
- ```bash
33
- pytest # the public tests/ suite -- the default, and what a contributor runs
34
- pytest tests_internal # the maintainer tier: value pins, figure goldens, gated families
35
- pytest tests tests_internal # everything
36
- ```
37
-
38
- A bare `pytest` collects only `tests/` because `testpaths = ["tests"]` says so in
39
- `pyproject.toml`; `tests_internal/` is tracked in git but never collected implicitly, and it is
40
- excluded from the sdist.
29
+ Run `pytest` from the repository root. It collects `tests/`, which is excluded from the sdist.
30
+ The value pins, figure goldens and gated families carry markers (below), so `-m "not pins"`
31
+ or `-m "not needs_cache"` deselects them.
41
32
 
42
33
  The gate is the whole suite in parallel under pytest-xdist. Run it before you push; CI runs the
43
34
  same command with `-m "not needs_network"`:
44
35
 
45
36
  ```bash
46
- pytest tests tests_internal -n auto --dist worksteal
37
+ pytest -n auto --dist worksteal
47
38
  ```
48
39
 
49
40
  - Use `-n 8` instead of `-n auto` while a fit campaign or another heavy job runs: each worker
@@ -56,8 +47,8 @@ optional and not part of `.[test]`:
56
47
 
57
48
  ```bash
58
49
  pip install pytest-testmon
59
- pytest tests tests_internal --testmon # first run: the whole suite, recording what each test executes
60
- pytest tests tests_internal --testmon # later runs: only the tests your edits affect
50
+ pytest --testmon # first run: the whole suite, recording what each test executes
51
+ pytest --testmon # later runs: only the tests your edits affect
61
52
  ```
62
53
 
63
54
  It keeps its record in `.testmondata` at the repository root (git-ignored), needs the cache
@@ -68,7 +59,7 @@ source as text, are not selected by a change under `src/`, so run the gate befor
68
59
  Without testmon, run one module (`pytest tests/test_phase.py`), or rerun the last failures with
69
60
  `--lf` (it also needs the cache provider).
70
61
 
71
- Only git-tracked test files are collected from `tests/` and `tests_internal/`. An untracked or
62
+ Only git-tracked test files are collected from `tests/`. An untracked or
72
63
  ignored `test_*.py` is skipped and listed in the terminal summary; `git add` it, or name it on
73
64
  the command line, to run it.
74
65
 
@@ -127,12 +118,12 @@ default, because this codebase already writes to roughly 95–100 characters and
127
118
  calls that read fine today.
128
119
 
129
120
  ```bash
130
- ruff format src/gliquid tests tests_internal # before you push
131
- ruff format --check src/gliquid tests tests_internal
132
- ruff check src/gliquid tests tests_internal # CI fails on any finding, as on unformatted code
121
+ ruff format src/gliquid tests # before you push
122
+ ruff format --check src/gliquid tests
123
+ ruff check src/gliquid tests # CI fails on any finding, as on unformatted code
133
124
  ```
134
125
 
135
- A pre-commit hook in `.githooks/` runs `ruff format` over the staged files in those same three
126
+ A pre-commit hook in `.githooks/` runs `ruff format` over the staged files in those same two
136
127
  paths and re-stages them, so a commit records formatted code. It is **not active until you
137
128
  switch git's hook path to it** — that setting lives in `.git/config` and is not carried by a
138
129
  clone:
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: gliquid
3
- Version: 0.3.1
3
+ Version: 0.3.3
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'
@@ -5,7 +5,7 @@ One OpenMP thread. ``OMP_NUM_THREADS`` is set to 1 for the session (XGBoost and
5
5
  every xdist worker and every fresh interpreter a test starts), before anything imports numpy
6
6
  or xgboost. A value already in the environment is kept.
7
7
 
8
- Tracked-only collection. Under ``tests/`` and ``tests_internal/`` only the ``test_*.py`` files
8
+ Tracked-only collection. Under ``tests/`` only the ``test_*.py`` files
9
9
  that git tracks are collected; an untracked or git-ignored one is skipped and listed in the
10
10
  terminal summary. A file named on the command line is always collected. Outside a git work
11
11
  tree, or without ``git`` on PATH, every file is collected.
@@ -25,7 +25,7 @@ Single-file store. Set ``GLIQUID_TEST_SQLITE_STORE=<path>.sqlite`` and the whole
25
25
  against a SQLite cache store instead of the ``cache/`` directory tree::
26
26
 
27
27
  python -m gliquid.cache migrate --from cache --to <path>.sqlite
28
- GLIQUID_TEST_SQLITE_STORE=<path>.sqlite python -m pytest tests tests_internal
28
+ GLIQUID_TEST_SQLITE_STORE=<path>.sqlite python -m pytest tests
29
29
 
30
30
  Unset, the suite runs against the directory store.
31
31
 
@@ -52,7 +52,7 @@ os.environ.setdefault("OMP_NUM_THREADS", "1")
52
52
  _SQLITE_STORE_ENV = "GLIQUID_TEST_SQLITE_STORE"
53
53
  _NO_HULL_MEMO_ENV = "GLIQUID_TEST_NO_HULL_MEMO"
54
54
  _HULL_MEMO_ENTRIES = 4000 # entries held across all memoised hulls; least recently used go first
55
- _GATED_DIRS = ("tests", "tests_internal")
55
+ _GATED_DIRS = ("tests",)
56
56
  _UNTRACKED_KEY = "gliquid_untracked_test_files"
57
57
  _HULL_MEMO_KEY = "gliquid_hull_memo_stats"
58
58
  _tracked_key = pytest.StashKey[frozenset | None]()