{"id":"data-provenance","title":"Data & Provenance","subtitle":"Where every number comes from: OpenKIM, NIST IPR, 559 potentials, the integrity gates.","category":"foundations","tags":["provenance","data","trust"],"source":"articles/docs/data-provenance.md","lang":"en","words":338,"readMinutes":2,"toc":[{"depth":2,"text":"Sources","id":"sources"},{"depth":2,"text":"Scope of the corpus","id":"scope-of-the-corpus"},{"depth":2,"text":"Integrity controls","id":"integrity-controls"},{"depth":2,"text":"What we do not claim","id":"what-we-do-not-claim"},{"depth":2,"text":"Reproducibility","id":"reproducibility"}],"html":"<h1 id=\"data-amp-provenance\">Data &amp; Provenance</h1><p>Where every number in the corpus comes from. The manifold is only as trustworthy as its\ninputs, so this page is deliberately explicit.</p>\n<h2 id=\"sources\">Sources</h2><div class=\"table-wrap\"><table><thead><tr>\n<th>Source</th>\n<th>Role</th>\n</tr>\n</thead><tbody><tr>\n<td data-label=\"Source\"><strong>OpenKIM</strong></td>\n<td data-label=\"Role\">Primary prediction source — elastic constants from published interatomic potentials, queried via the OpenKIM API.</td>\n</tr>\n<tr>\n<td data-label=\"Source\"><strong>NIST Interatomic Potentials Repository (IPR)</strong></td>\n<td data-label=\"Role\">Cross-reference and ground-truth anchor for potential identity and reference properties.</td>\n</tr>\n<tr>\n<td data-label=\"Source\"><strong>MLIP provenance records</strong></td>\n<td data-label=\"Role\">Lattice constants (<span class=\"katex\"><span class=\"katex-mathml\"><math xmlns=\"http://www.w3.org/1998/Math/MathML\"><semantics><mrow><msub><mi>a</mi><mn>0</mn></msub></mrow><annotation encoding=\"application/x-tex\">a_0</annotation></semantics></math></span><span class=\"katex-html\" aria-hidden=\"true\"><span class=\"base\"><span class=\"strut\" style=\"height:0.5806em;vertical-align:-0.15em;\"></span><span class=\"mord\"><span class=\"mord mathnormal\">a</span><span class=\"msupsub\"><span class=\"vlist-t vlist-t2\"><span class=\"vlist-r\"><span class=\"vlist\" style=\"height:0.3011em;\"><span style=\"top:-2.55em;margin-left:0em;margin-right:0.05em;\"><span class=\"pstrut\" style=\"height:2.7em;\"></span><span class=\"sizing reset-size6 size3 mtight\"><span class=\"mord mtight\">0</span></span></span></span><span class=\"vlist-s\">​</span></span><span class=\"vlist-r\"><span class=\"vlist\" style=\"height:0.15em;\"><span></span></span></span></span></span></span></span></span></span>) recovered from the originating MLIP runs — the basis for the de-myopization that proved the ribbon is not a <span class=\"katex\"><span class=\"katex-mathml\"><math xmlns=\"http://www.w3.org/1998/Math/MathML\"><semantics><mrow><msub><mi>C</mi><mrow><mi>i</mi><mi>j</mi></mrow></msub></mrow><annotation encoding=\"application/x-tex\">C_{ij}</annotation></semantics></math></span><span class=\"katex-html\" aria-hidden=\"true\"><span class=\"base\"><span class=\"strut\" style=\"height:0.9694em;vertical-align:-0.2861em;\"></span><span class=\"mord\"><span class=\"mord mathnormal\" style=\"margin-right:0.0715em;\">C</span><span class=\"msupsub\"><span class=\"vlist-t vlist-t2\"><span class=\"vlist-r\"><span class=\"vlist\" style=\"height:0.3117em;\"><span style=\"top:-2.55em;margin-left:-0.0715em;margin-right:0.05em;\"><span class=\"pstrut\" style=\"height:2.7em;\"></span><span class=\"sizing reset-size6 size3 mtight\"><span class=\"mord mtight\"><span class=\"mord mathnormal mtight\" style=\"margin-right:0.0572em;\">ij</span></span></span></span></span><span class=\"vlist-s\">​</span></span><span class=\"vlist-r\"><span class=\"vlist\" style=\"height:0.2861em;\"><span></span></span></span></span></span></span></span></span></span> artifact.</td>\n</tr>\n<tr>\n<td data-label=\"Source\"><strong>Phase-D compute lane</strong></td>\n<td data-label=\"Role\">Real LAMMPS runs (not cache) that produce <span class=\"katex\"><span class=\"katex-mathml\"><math xmlns=\"http://www.w3.org/1998/Math/MathML\"><semantics><mrow><msub><mi>E</mi><mtext>coh</mtext></msub></mrow><annotation encoding=\"application/x-tex\">E_\\text{coh}</annotation></semantics></math></span><span class=\"katex-html\" aria-hidden=\"true\"><span class=\"base\"><span class=\"strut\" style=\"height:0.8333em;vertical-align:-0.15em;\"></span><span class=\"mord\"><span class=\"mord mathnormal\" style=\"margin-right:0.0576em;\">E</span><span class=\"msupsub\"><span class=\"vlist-t vlist-t2\"><span class=\"vlist-r\"><span class=\"vlist\" style=\"height:0.3361em;\"><span style=\"top:-2.55em;margin-left:-0.0576em;margin-right:0.05em;\"><span class=\"pstrut\" style=\"height:2.7em;\"></span><span class=\"sizing reset-size6 size3 mtight\"><span class=\"mord text mtight\"><span class=\"mord mtight\">coh</span></span></span></span></span><span class=\"vlist-s\">​</span></span><span class=\"vlist-r\"><span class=\"vlist\" style=\"height:0.15em;\"><span></span></span></span></span></span></span></span></span></span>/<span class=\"katex\"><span class=\"katex-mathml\"><math xmlns=\"http://www.w3.org/1998/Math/MathML\"><semantics><mrow><msub><mi>B</mi><mn>0</mn></msub></mrow><annotation encoding=\"application/x-tex\">B_0</annotation></semantics></math></span><span class=\"katex-html\" aria-hidden=\"true\"><span class=\"base\"><span class=\"strut\" style=\"height:0.8333em;vertical-align:-0.15em;\"></span><span class=\"mord\"><span class=\"mord mathnormal\" style=\"margin-right:0.0502em;\">B</span><span class=\"msupsub\"><span class=\"vlist-t vlist-t2\"><span class=\"vlist-r\"><span class=\"vlist\" style=\"height:0.3011em;\"><span style=\"top:-2.55em;margin-left:-0.0502em;margin-right:0.05em;\"><span class=\"pstrut\" style=\"height:2.7em;\"></span><span class=\"sizing reset-size6 size3 mtight\"><span class=\"mord mtight\">0</span></span></span></span><span class=\"vlist-s\">​</span></span><span class=\"vlist-r\"><span class=\"vlist\" style=\"height:0.15em;\"><span></span></span></span></span></span></span></span></span></span> and surface recipe bugs the cached pipeline masked.</td>\n</tr>\n<tr>\n<td data-label=\"Source\"><strong>Kimi 2026-06-07 MLIP evidence import</strong></td>\n<td data-label=\"Role\">Cloud Run MACE/CHGNet/SevenNet elastic constants, Vandermonde checks, real early-exit timing, and MLIP/MD refusal evidence curated under <code>data/mlip_benchmarks/kimi_2026_06_07/</code>.</td>\n</tr>\n</tbody></table></div><h2 id=\"scope-of-the-corpus\">Scope of the corpus</h2><ul>\n<li><strong>559 interatomic potentials</strong> spanning 13 <code>pair_style</code> families.</li>\n<li><strong>15 benchmark metals</strong> — 8 FCC, 7 BCC (the IMMI element set).</li>\n<li>Plus the foundation-MLIP trio added on top: <strong>MACE-MP-0, CHGNet, Orb-v3</strong>.</li>\n<li>Plus the Kimi v7 Cloud Run trio: <strong>MACE-MP-0, CHGNet, SevenNet</strong> across the\nsame 15-metal IMMI set.</li>\n<li>Properties: elastic constants <span class=\"katex\"><span class=\"katex-mathml\"><math xmlns=\"http://www.w3.org/1998/Math/MathML\"><semantics><mrow><msub><mi>C</mi><mn>11</mn></msub><mo separator=\"true\">,</mo><msub><mi>C</mi><mn>12</mn></msub><mo separator=\"true\">,</mo><msub><mi>C</mi><mn>44</mn></msub></mrow><annotation encoding=\"application/x-tex\">C_{11}, C_{12}, C_{44}</annotation></semantics></math></span><span class=\"katex-html\" aria-hidden=\"true\"><span class=\"base\"><span class=\"strut\" style=\"height:0.8778em;vertical-align:-0.1944em;\"></span><span class=\"mord\"><span class=\"mord mathnormal\" style=\"margin-right:0.0715em;\">C</span><span class=\"msupsub\"><span class=\"vlist-t vlist-t2\"><span class=\"vlist-r\"><span class=\"vlist\" style=\"height:0.3011em;\"><span style=\"top:-2.55em;margin-left:-0.0715em;margin-right:0.05em;\"><span class=\"pstrut\" style=\"height:2.7em;\"></span><span class=\"sizing reset-size6 size3 mtight\"><span class=\"mord mtight\"><span class=\"mord mtight\">11</span></span></span></span></span><span class=\"vlist-s\">​</span></span><span class=\"vlist-r\"><span class=\"vlist\" style=\"height:0.15em;\"><span></span></span></span></span></span></span><span class=\"mpunct\">,</span><span class=\"mspace\" style=\"margin-right:0.1667em;\"></span><span class=\"mord\"><span class=\"mord mathnormal\" style=\"margin-right:0.0715em;\">C</span><span class=\"msupsub\"><span class=\"vlist-t vlist-t2\"><span class=\"vlist-r\"><span class=\"vlist\" style=\"height:0.3011em;\"><span style=\"top:-2.55em;margin-left:-0.0715em;margin-right:0.05em;\"><span class=\"pstrut\" style=\"height:2.7em;\"></span><span class=\"sizing reset-size6 size3 mtight\"><span class=\"mord mtight\"><span class=\"mord mtight\">12</span></span></span></span></span><span class=\"vlist-s\">​</span></span><span class=\"vlist-r\"><span class=\"vlist\" style=\"height:0.15em;\"><span></span></span></span></span></span></span><span class=\"mpunct\">,</span><span class=\"mspace\" style=\"margin-right:0.1667em;\"></span><span class=\"mord\"><span class=\"mord mathnormal\" style=\"margin-right:0.0715em;\">C</span><span class=\"msupsub\"><span class=\"vlist-t vlist-t2\"><span class=\"vlist-r\"><span class=\"vlist\" style=\"height:0.3011em;\"><span style=\"top:-2.55em;margin-left:-0.0715em;margin-right:0.05em;\"><span class=\"pstrut\" style=\"height:2.7em;\"></span><span class=\"sizing reset-size6 size3 mtight\"><span class=\"mord mtight\"><span class=\"mord mtight\">44</span></span></span></span></span><span class=\"vlist-s\">​</span></span><span class=\"vlist-r\"><span class=\"vlist\" style=\"height:0.15em;\"><span></span></span></span></span></span></span></span></span></span> (primary); lattice constant<span class=\"katex\"><span class=\"katex-mathml\"><math xmlns=\"http://www.w3.org/1998/Math/MathML\"><semantics><mrow><msub><mi>a</mi><mn>0</mn></msub></mrow><annotation encoding=\"application/x-tex\">a_0</annotation></semantics></math></span><span class=\"katex-html\" aria-hidden=\"true\"><span class=\"base\"><span class=\"strut\" style=\"height:0.5806em;vertical-align:-0.15em;\"></span><span class=\"mord\"><span class=\"mord mathnormal\">a</span><span class=\"msupsub\"><span class=\"vlist-t vlist-t2\"><span class=\"vlist-r\"><span class=\"vlist\" style=\"height:0.3011em;\"><span style=\"top:-2.55em;margin-left:0em;margin-right:0.05em;\"><span class=\"pstrut\" style=\"height:2.7em;\"></span><span class=\"sizing reset-size6 size3 mtight\"><span class=\"mord mtight\">0</span></span></span></span><span class=\"vlist-s\">​</span></span><span class=\"vlist-r\"><span class=\"vlist\" style=\"height:0.15em;\"><span></span></span></span></span></span></span></span></span></span> (de-myopization); <span class=\"katex\"><span class=\"katex-mathml\"><math xmlns=\"http://www.w3.org/1998/Math/MathML\"><semantics><mrow><msub><mi>E</mi><mtext>coh</mtext></msub><mo separator=\"true\">,</mo><msub><mi>B</mi><mn>0</mn></msub></mrow><annotation encoding=\"application/x-tex\">E_\\text{coh}, B_0</annotation></semantics></math></span><span class=\"katex-html\" aria-hidden=\"true\"><span class=\"base\"><span class=\"strut\" style=\"height:0.8778em;vertical-align:-0.1944em;\"></span><span class=\"mord\"><span class=\"mord mathnormal\" style=\"margin-right:0.0576em;\">E</span><span class=\"msupsub\"><span class=\"vlist-t vlist-t2\"><span class=\"vlist-r\"><span class=\"vlist\" style=\"height:0.3361em;\"><span style=\"top:-2.55em;margin-left:-0.0576em;margin-right:0.05em;\"><span class=\"pstrut\" style=\"height:2.7em;\"></span><span class=\"sizing reset-size6 size3 mtight\"><span class=\"mord text mtight\"><span class=\"mord mtight\">coh</span></span></span></span></span><span class=\"vlist-s\">​</span></span><span class=\"vlist-r\"><span class=\"vlist\" style=\"height:0.15em;\"><span></span></span></span></span></span></span><span class=\"mpunct\">,</span><span class=\"mspace\" style=\"margin-right:0.1667em;\"></span><span class=\"mord\"><span class=\"mord mathnormal\" style=\"margin-right:0.0502em;\">B</span><span class=\"msupsub\"><span class=\"vlist-t vlist-t2\"><span class=\"vlist-r\"><span class=\"vlist\" style=\"height:0.3011em;\"><span style=\"top:-2.55em;margin-left:-0.0502em;margin-right:0.05em;\"><span class=\"pstrut\" style=\"height:2.7em;\"></span><span class=\"sizing reset-size6 size3 mtight\"><span class=\"mord mtight\">0</span></span></span></span><span class=\"vlist-s\">​</span></span><span class=\"vlist-r\"><span class=\"vlist\" style=\"height:0.15em;\"><span></span></span></span></span></span></span></span></span></span> (Phase-D, in progress).</li>\n</ul>\n<h2 id=\"integrity-controls\">Integrity controls</h2><p>These exist because we got burned — see\n<a href=\"#/read/hyp-bccfcc-causal-shield\">the BCC/FCC self-correction</a>:</p>\n<ul>\n<li><strong>Ingest gate:</strong> records with <code>|pred| &gt; 1500</code> or <code>≤ 0</code> are rejected at ingestion.</li>\n<li><strong>Idempotent purge</strong> at fleet step 0, so a contaminated record cannot survive a\nre-run. The contamination event removed 19 corrupt records → <strong>1231 clean records</strong>.</li>\n<li><strong>Matched-n discipline:</strong> any cross-element correlation is reported alongside its\nsample-size-matched control (see <a href=\"#/read/methodology\">Methodology</a>).</li>\n<li><strong>Kimi import contract:</strong> the curated import is checked by\n<code>python tools/mlip_kimi_evidence.py --check</code>, preserving low-correlation\nsentinels, physical-instability flags, the irrep threshold failure, and the\nreal early-exit gap from the idealized speedup bound.</li>\n</ul>\n<h2 id=\"what-we-do-not-claim\">What we do <em>not</em> claim</h2><p>The corpus is metals-elastic-heavy. Statements outside that regime are methodological\n(&quot;the method transfers&quot;) not empirical (&quot;we measured it&quot;) until Phase-D widens the\nproperty basis. The ledger marks every such boundary explicitly.</p>\n<h2 id=\"reproducibility\">Reproducibility</h2><p>Every figure is regenerable from these sources via the open <code>atlas-distill</code> engine —\nsee <a href=\"#/read/reproduce\">Reproduce Our Results</a>.</p>\n"}