asiri1/al3ni-mace

Al3Ni / Ni-Al MACE potentials (LoRA fine-tunes of MACE-MATPES-PBE-0)

Three LoRA fine-tunes of the MACE-MATPES-PBE-0 foundation model on 227 QE/PBE configurations covering five Ni-Al intermetallic phases: Al3Ni, Al3Ni2, AlNi, Al3Ni5, AlNi3.

The three checkpoints are seed replicas: same training data, same hyperparameters, three different random seeds. They are published together because the reproducibility claim for this model is statistical, not bitwise (see below).

Files

File	Seed	Role
al3ni_combined227_lora_v1.model	20260811	The production model. Use this one unless you specifically want a seed study. It is the artifact named in the project's sealed acceptance record and the one every reported validation number refers to.
al3ni_combined227_seed20260812_lora_v1.model	20260812	Seed replica.
al3ni_combined227_seed20260813_lora_v1.model	20260813	Seed replica.

SHA256

e4fd54cc8a4a090fc9e32d6625269142824bfada8315433127b3aa3118c65cee  al3ni_combined227_lora_v1.model
4328154a37f55c1ba99c209e978ad76a0f36e5f3d8a41b25c107b27efefe17af  al3ni_combined227_seed20260812_lora_v1.model
f676d87f8463a8ffcd4fa7d6b81796b5d42b89602267109010316cbdb4c97e6a  al3ni_combined227_seed20260813_lora_v1.model

The first hash is pinned inside the public configs/AL3NI_ROUND285_FINAL_UNSEALING_RESULT.txt, so the file you download can be confirmed to be the exact artifact named in the sealed record.

What the two seed replicas are for

They are not alternative production models — do not average them, and do not pick between them by which scores best on your system. They exist so that two specific claims can be checked by someone who does not have access to the original training environment:

1. The seed-noise floor. The three seeds agree to 0.078 meV/atom in overall relative-energy MAE, far inside the measured 0.43 meV/atom noise floor. Any effect smaller than that is seed noise, not signal — which is the standard a reader needs in order to judge which of the reported differences mean anything.

2. The 2.6183 meV/atom acceptance threshold. The project's locked acceptance bar is the maximum, across these three seeds, of each seed's own maximum |E_rel| error over the 19 reserved configurations. The per-seed maxima are 2.5232 / 2.4333 / 2.6183, and the same configuration (cfg060) anchors all three. Without the two replicas that number can only be asserted; with them it can be re-derived from published artifacts alone.

Reported relative-energy accuracy on the 227-config evaluation set:

model	E_rel MAE (meV/atom)	E_rel RMSE	E_rel MAX	F MAE (eV/Å)	S MAE (GPa)
MACE-MATPES-PBE-0 (no fine-tuning)	4.1429	7.4763	53.5123	0.0188	0.8642
combined227 (seed 20260811)	0.9598	1.6103	9.7142	0.0012	0.2143
seed 20260812	1.0375	1.7653	10.3661	0.0013	0.2211
seed 20260813	1.0196	1.7211	10.1229	0.0013	0.2210

E_rel = (E(config) − E(phase_relaxed))/N. Absolute MACE energies carry a model-dependent per-element offset, so only relative energies are comparable across models.

Usage

from mace.calculators import MACECalculator
from huggingface_hub import hf_hub_download

path = hf_hub_download("asiri1/al3ni-mace", "al3ni_combined227_lora_v1.model")
calc = MACECalculator(model_paths=path, device="cpu", default_dtype="float64")

atoms.calc = calc
atoms.get_potential_energy()

Use default_dtype="float64" — the reported errors are float64 numbers.

Scope — read before using

Fit for

• Relative energetics, forces and stresses of the five phases above, within x_Ni ∈ [0.25, 0.75], at strains up to about ±3%.
• Lattice parameters and equation of state (V₀ to ≤ 0.2%).
• Formation energies and phase-stability ranking, using QE chemical potentials.
• Elastic constants for AlNi, AlNi3, Al3Ni, Al3Ni2 (cross-validated against LAMMPS).
• Phonon and dynamical-stability screening.

Not fit for, without further DFT

• Any composition outside x_Ni ∈ [0.25, 0.75], including the pure elements.
• Strains beyond about ±4%, where error rises to 4.1 meV/atom mean, 9.7 maximum.
• Al3Ni at high expansion (+3.5 to +4.5%) at the 2.6183 meV/atom accuracy level.
• Quantitative Al3Ni5 shear or alpha-angle energetics.
• Radiation damage, collision cascades, or any close-approach regime.
• Defect, diffusion or creep studies relying on vacancy energies, until confirmed by DFT.
• Finite-temperature claims — the MD stability screen is not yet complete.

Reference lattice parameters

From this project's DFT-relaxed structures:

Phase	Structure	a (Å)	Notes
AlNi	B2 (CsCl-type)	~2.89	cubic, 2 atoms/cell
AlNi3	L1₂	~3.57	cubic, 4 atoms/cell
Al3Ni	orthorhombic	see MP mp-622209	16 atoms/cell
Al3Ni2	trigonal	see MP mp-1057	5 atoms/cell
Al3Ni5	orthorhombic	see MP mp-16514	8 atoms/cell

Reproducibility: statistical, not bitwise

Retraining from the public configs/al3ni_combined227_lora_v1.yaml is not expected to regenerate these files bitwise. The config sets a seed but no determinism controls, training ran on CUDA, and the toolchain (Python 3.12.3, torch 2.8.0+cu128, CUDA 12.8, RTX 4090) is pinned by documentation rather than by a container. This is normal for GPU training and is not a defect.

The claim that is supported is the one the three seeds above establish: independent training runs on identical data land within 0.078 meV/atom of each other.

Training data and code

Datasets, splits, configs and training scripts are public at Asiri1108/ni-al-mlip. Base model: ACEsuit/mace-foundations, release mace_matpes_0 (e618ad582b84239905b9c3b77ce6e9ce111b0ecd1533223a1a6aac7a696b8aa0).

Verifying on Windows: clone with git -c core.autocrlf=false clone …. With autocrlf enabled, git rewrites LF to CRLF on checkout and every text artifact's SHA256 will differ from the recorded value — 32 of 43 artifacts appear tampered with when they are not.