MINERALCO 💎 — Documentation

💎 Overview

Seven parameters to decode Earth's solid interior

"A mineral is not a passive lump of matter — it is an active physical system that continuously negotiates with its environment."

MINERALCO is a seven-parameter computational framework for the systematic characterisation of mineral behaviour under the extreme pressure and temperature conditions that prevail throughout Earth's interior. Pressures from 0.1 MPa at the surface to 363 GPa at the inner-core boundary, temperatures from 300 K to ~6,000 K at the core.

0.19%

RMS Error

Across 3,200 P-V-T points

91.5%

Phase Accuracy

43 of 47 minerals

19

Minerals

In benchmark database

363

GPa Max

Inner core pressure

7

Parameters

CIS framework

0.88

Sᵧ-K' r

Symmetry correlation

📄 Research Paper

Physics and Chemistry of Minerals (Springer)

MINERALCO Research Paper

Submitted to Physics and Chemistry of Minerals · March 14, 2026

Title: MINERALCO — Seven Parameters to Decode the Earth's Solid Interior
Author: Samir Baladi
Affiliation: Ronin Institute / Rite of Renaissance
DOI: 10.5281/zenodo.19009597
License: MIT License
Status: Under review
Keywords: mineral physics, equation of state, Birch-Murnaghan EOS, bulk modulus, lattice parameters, Grüneisen parameter, thermal expansion, crystal symmetry, high-pressure mineralogy, mantle phase transitions

📊 Key Results

Validation performance metrics

0.19%

RMS ΔV/V

All 47 minerals

91.5%

Phase Accuracy

43/47 minerals

0.971

r² γ

Grüneisen consistency

-0.88

Sᵧ-K' r

Symmetry correlation

0.4%

Vp vs PREM

At 660 km

0.1%

Vs vs PREM

At 660 km

🔬 Seven Parameters

Crystal Intelligence Septuplet (CIS)

Parameter	Symbol	CSI Weight	Description
Bulk Modulus	K₀	0.28	Zero-pressure incompressibility
Lattice Parameters	a,b,c,α,β,γ	—	Unit cell geometry
Pressure Derivative	K'	0.17	Stiffening rate under compression
Crystal Symmetry	Sᵧ	0.13	Space group classification
Thermal Expansion	α	0.10	Volumetric temperature response
Grüneisen Parameter	γ	0.09	Thermal pressure coupling
Specific Volume	Vₛ	0.19	Pressure-dependent molar volume

📈 Crystal Stability Index

Composite index

// Crystal Stability Index // MINERALCO Composite Formula CSI = 0.28 · K₀* // Bulk Modulus + 0.19 · Vₛ* // Specific Volume + 0.17 · K'* // Pressure Derivative + 0.13 · Sᵧ* // Crystal Symmetry + 0.10 · α* // Thermal Expansion + 0.09 · γ* // Grüneisen Parameter + 0.04 · Φ*ₗₐₜₜ // Lattice Energy // All parameters normalized to [0, 1] using 47-mineral benchmark // K₀ carries dominant weight as every major mantle phase transition // is accompanied by a characteristic K₀ anomaly

≥0.85

TRANSITION

Imminent within ±2 GPa

0.65-0.85

METASTABLE

Possible with overstepping

<0.65

STABLE

No transition predicted

⚠️ CSI Thresholds

Three-level stability framework

Level	CSI Range	Description	Action
🟢 STABLE	<0.65	No phase transition expected	Routine monitoring
🟡 METASTABLE	0.65-0.85	Transition possible with kinetic overstepping	Enhanced monitoring
🔴 TRANSITION	≥0.85	Phase transition imminent within ±2 GPa	Immediate attention

📦 Installation

Quick setup

# Install from PyPI pip install meneralco # Clone repository git clone https://github.com/gitedeeper9/mineralco.git cd mineralco # Install with pip pip install -r requirements.txt pip install -e . # Or using Docker docker-compose up -d # Verify installation python -c "import mineralco; print(mineralco.__version__)"

🔧 API Reference

Python interface

EOSFitter

Birch-Murnaghan Equation of State fitting

from mineralco import EOSFitter fitter = EOSFitter(method="BM3") result = fitter.fit( pressure=P_data, volume=V_data, mineral="bridgmanite" ) print(f"K₀ = {result.K0:.1f} GPa")

LatticeAnalyzer

Unit cell geometry and symmetry analysis

from mineralco import LatticeAnalyzer lattice = LatticeAnalyzer( a=4.775, b=4.929, c=6.897 ) print(lattice.crystal_system) # → orthorhombic print(f"K' prior = {lattice.get_kprime_prior()}")

PhaseMapper

Crystal Stability Index calculation

from mineralco import PhaseMapper mapper = PhaseMapper() result = mapper.compute_csi( K0=185.1, Vs=39.49, Kprime=4.14, Sy="cubic", alpha=2.10e-5, gamma=1.27 ) print(f"CSI = {result.csi:.3f} ({result.status})")

ThermalCorrector

Mie-Grüneisen thermal pressure correction

from mineralco import ThermalCorrector tc = ThermalCorrector( K0=260.7, Kprime=3.97, V0=24.45, gamma0=1.57, alpha0=2.0e-5 ) result = tc.pressure(V=20.0, T=2000) print(f"P_total = {result.P_total:.1f} GPa")

🧩 Core Modules

Physics engine

BM3

EOS

Birch-Murnaghan 3rd order

MG

Thermal

Mie-Grüneisen correction

SG

Symmetry

230 space groups

BL

Energy

Born-Landé lattice

👤 Author

Principal investigator

💎

Samir Baladi

Interdisciplinary AI Researcher — Mineral Physics, Crystallography & High-Pressure Phase Dynamics

Ronin Institute / Rite of Renaissance

Samir Baladi is an independent researcher affiliated with the Ronin Institute, developing the Rite of Renaissance interdisciplinary research program. MINERALCO is the fourth framework in a series of open‑source geophysical frameworks, following CORAL-CORE (coral reef systems), LITHO-SONIC (crustal stress), and INFRAS-CLOUD (atmospheric infrasound). The framework was validated against 3,200 experimental data points from synchrotron DAC and multi-anvil press studies.

No conflicts of interest declared.

📧 gitdeeper@gmail.com 🔗 ORCID: 0009-0003-8903-0029 🐙 GitHub 🦊 GitLab

📝 Citation

How to cite

@software{baladi2026mineralco, author = {Baladi, Samir}, title = {MINERALCO: Seven Parameters to Decode the Earth's Solid Interior}, year = {2026}, version = {1.0.0}, doi = {10.5281/zenodo.19009597}, url = {https://github.com/gitedeeper9/mineralco}, license = {MIT} }

"Seven parameters to decode the Earth's solid interior — MINERALCO makes it computable."

MINERAL-CO