pemmss

Primary Exploration, Mining and Metal Supply Scenario (PEMMSS) model

This scenario modeling framework evaluates the rates of mine development, mineral exploration and co-product recovery required to meet primary demand over-time.

Development led by Stephen A. Northey

in collaboration with:

S. Pauliuk, S. Klose, M. Yellishetty, D. Giurco, B. Mendonca Severiano and J. Hyman

For further information or enquiries email: stephen.northey@uts.edu.au

How to use:

1. Install python and dependent packages

This version of the model has been developed and tested using python 3.12.1. Additional required packages and the version used during development and testing are shown in requirements.txt.

• Instructions for installing python are available at: https://www.python.org/
• Instructions for installing matplotlib are available at: https://matplotlib.org/
• Instructions for installing numpy are available at: https://numpy.org/install/
• Instructions for installing pandas are available at: https://pandas.pydata.org/pandas-docs/stable/getting_started/install.html
• Instructions for installing imageio are available at: https://imageio.readthedocs.io/en/stable/user_guide/installation.html

2. Scenario Data Input and Calibration

Adjust scenario parameters and calibrate the model by modifying the CSV files located in the input_files/ subdirectory.

The expected structure and data formats for each CSV file are documented in the associated import function defined in modules/file_import.py.

Example input files are available in the input_files_examples/ subdirectory and can be copied into the input_files/ directory to get started.

3. Execute pemmss.py

Run the model by executing pemmss.py using python.

4. View Results Data and Graphs

The results will be saved to a new sub-directory created for model execution, output_files/[EXECUTION_DATE_TIME]/

This will include:

• A folder containing copies of the input files used for the model run to ensure reproduceability.
• A folder containing data generated for each demand scenario, with individual results CSVs for each iteration of this.
• A folder containing aggregated statistics from all demand scenarios and iterations.
• A folder containing any generated graphs.
• A log file containing information useful for benchmarking and debugging.

License:

This model is licensed under a BSD 3-Clause License. See LICENSE.md for further information.

Attribution and Citation:

We request that any reference to this model in publications or presentations cite this GitHub repository and the journal article describing the model design and rationale. See CITATION.cff or below for specific details:

Northey, S.A., Klose, S., Pauliuk, S., Yellishetty, M., Giurco, D. (2023). Primary Exploration, Mining and Metal Supply Scenario (PEMMSS) model: Towards a stochastic understanding of the mineral discovery, mine development and co-product recovery requirements to meet demand in a low-carbon future. Resources, Conservation & Recycling Advances 17: 200137. https://doi.org/10.1016/j.rcradv.2023.200137