Welcome to PetThermoTools’s documentation!

Getting Started:

• Introduction
  • Important Notice
  • Useful links and information
  • Using MELTS
  • Using MAGEMin
  • Citing PetThermoTools and underlying packages
  • YouTube Channel
  • Reporting bugs/issues with the code
• Installation of alphaMELTS for Python
  • Step 0 - Only use if you’ve previously installed alphaMELTS for Python via PetThermoTools. Alternatively go straight to Step 1.
    • To update alphaMELTS for Python installation run the update function below.
  • Step 1 - Install Python
  • Step 2 - Pip install PetThermoTools and it’s dependencies
  • Step 3 - Installing alphaMELTS for Python.
  • Step 4 - Test installation
• Running MAGEMin calculations through Julia
  • Step 1 - install juliacall
  • Step 2 - Install MAGEMin
  • Step 2b - Update MAGEMin
  • Step 3 - test the installation
  • Step 4 - Restart the kernel and test running calculations through PetThermoTools
  • Step 5 - use PetThermoTools alongside MAGEMin in your research!
• Available functions
• How to effectively use PetThermoTools
  • Step 1 - load your data
  • Step 2 - understanding and running PetThermoTools functions
  • Step 3 - Plotting results

You Tube videos and workshops

• YouTube Tutorials
  • Why did we develop PetThermoTools?
  • Installation help
  • Example fractional crystallization calculation
  • Example Fractional crystallization calculation comparing MELTS and MAGEMin
  • Example degassing calculation
  • Example Phase Diagram Calculation
• Workshops

Education Materials to use PetThermoTools in teaching

• PetThermoTools in the Classroom!
  • Investigating viscosity, liquidus temperatures, and fractional crystallization trends
  • Investigating Volatile Solubility and degassing behavoir

Melt liquidus temperature

• Using MELTS to find the liquidus temperature

Crystallisation calculations

• Modelling liquid-line-of-descents
• Modelling liquid-line-of-descents with MAGEMin
• Polybaric liquid-line-of-descents
• Comparing fractional crystallization in different models
  • Lets make a nice figure showing chemistry for these
  • Lets look at the phase proportions
  • And plot phase abundances at 3000 bars
  • Whats up with Cpx2?
  • Lets compare the Cpx (all from each model)
  • Lets plot clinopyroxene components.
  • Lets do the Cpx components

Exporting calculation results

• How to save your model results
  • What about calculations with multiple models?

Decompression Calculations

• Isothermal decompression calculations
  • Lets look at fluid composition vs. pressure and H2O and CO2 in the melt remaining
  • Why is SiO2 changing?
  • Lets plot what the phases are doing
  • We can do the same for phase volume
  • Lets think about what happens to liquid viscosity as we ascend
  • Lets plot the Plag compositions on a ternary diagram to compare to measured microlite chemistry

Phase Diagram calculations

• Phase Diagram calculations
  • Calculations using MELTS
  • Calculations using MAGEMin
  • Phase Diagram of pyroxenite lithologies
• Phase Diagram calculations at Mauna Loa
  • Bulk composition
  • Lets try Melts V.1.0.2
  • Lets calculate Mg# as that was a big part of the original arguements
  • We can also plot the P-T conditions where Ol and Opx are stable (the observed phase assemblage)

Melting calculations

• Adiabatic Decompression melting of peridotite and pyroxenite mantle sources
  • Examining the influence of source lithology on melting behaviours
  • Utilizing outputs to calculate the SCSS of mantle melts

MELTS barometry

• MELTS geobarometry part 1 - quartz - 2-feldspar saturated rhyolites
  • How does parallel processing affect calculation speeds?
• MELTS geobarometry part 2 - plagioclase - 2-pyroxene saturated magmas
• MELTS geobarometry part 3 - multi-phase saturation in mafic magmas

Helpful Information

• Mineral phases available in MELTS
  • Solid solution phases
  • Pure phases included in all versions of MELTS
  • Additional pure phases included in alphaMELTS
• Mineral phases available in MAGEMin calculations
  • Green et al. (2025) - named ig in MAGEMin
  • Weller et al. (2024) - named igad in MAGEMin
• Naming conventions
  • Thermodynamic properties

Updates and Version Information

• Change Log
  • Version 0.4.0 (March 2026)
  • Version 0.3.22 (March 2026)
  • Version 0.3.22 (March 2026)
  • Version 0.3.21 (February 2026)
  • Version 0.3.20 (January 2026)
  • Version 0.3.16 (January 2026)
  • Version 0.3.12 (January 2026)
  • Version 0.3.11 (January 2026)
  • Version 0.3.10 (January 2026)
  • Version 0.3.9 (January 2026)
  • Version 0.3.8 (January 2026)
  • Version 0.3.7 (January 2026)
  • Version 0.3.6 (January 2026)
  • Version 0.3.4 (January 2026)
  • Version 0.3.2 (December 2025)
  • Version 0.3.0 (December 2025)
  • Version 0.2.55 (November 2025)
  • Version 0.2.49 (October 2025)
  • Version 0.2.40 (August 2025)
  • Version 0.2.39 (July 2025)
  • Version 0.2.32 (March 28th 2025)
  • Version 0.2.30 (January 16th 2025)
  • Version 0.2.25 (November 28th 2024)
  • Version 0.2.20 (October 20th 2024)
  • Version 0.2.18 (October 10th 2024)
  • Version 0.2.13 (September 17th 2024)
  • Version 0.2.5 (January 11th, 2024)
  • Version 0.2.4 (January 9th, 2024)
  • Version 0.2.1 (November 22nd, 2023)
  • Version 0.1.29 (November 10th, 2023)
  • Version 0.1.28 (October 11th, 2023)
  • Version 0.1.25 (August 8th, 2023)