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

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

Version: 1.4.0 Version Date: 2025-08-11

PEMMSS codebase contributors:

Stephen A. Northey | PEMMSS Architect and Lead Developer

Jayden Hyman | PEMMSS GUI Developer (app.py) and Expert User

Bernardo Mendonca Severiano | PEMMSS Developer (spatial.py) and Expert User

PEMMSS model initial conceptualisation: S.A. Northey, S. Pauliuk, S. Klose, M. Yellishetty, D. Giurco

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

This scenario model simulates mine development, mineral exploration and co-product recovery in response to changing primary demand over-time.

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

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

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

v1.4.0 Notes:

Feature Additions

Added web-browser based GUI that ca be used by running app.py Added some functionality for use of spatial data and mine coordinates

Added significant optimisations for memory usage and execution time, particularly for post-processing Prior version input files will no longer work correctly. These changes are breaking. Please compare CSV headers and associated import function docstrings in modules/file_import.py.

Some minor bugfixes for non-typical CSV encodings.

Changelog:

v1.3.1 to v1.4.0 - Added GUI and spatial data handling. Optimised speed and memory management. Breaking change, older input CSVs will require update for new column headers. v1.3.0 to v1.3.1 - Added functionality for outputting more detailed mine status statistics overtime. Minor bugfixes related to end_year when using multiple ore tranches. requirements.txt added for improved transparency of dependencies. This is a non-breaking change. v1.2.0 to v1.3.0 - Added functionality to value models and plotting. Some bugfixes related to ore tranches and plotting. Input header columns changed so pre-v1.3.0 input files will not work. v1.1.0 to v1.2.0 - Changed python environment requirements and package dependencies. A number of bugfixes. Significant optimisation for improved speed and memory management, providing a pathways towards high scenario regionalisation and iteration count. Addition of experimental functionality for isolated results post-processing. v1.0.2 to v1.1.0 - Added features ore tranches, development probability, production capacity uncertainty, ALL syntax for region/deposit type factor updates. Added additional input file examples for sensitivity analysis. Input header columns changed so pre-v1.1.0 input files will not work. v1.0.1 to v1.0.2 - Fixed bugs with file importation, the value prioritisation algorithm, the capacity_generate() function. Some input file column headers renamed to improve clarity, so v1.0.1 and earlier input files will no longer work. v1.0.0 to v1.0.1 - New release created to trigger establishment of a Zenodo archive. Updated version number and date.

Full Changelog: https://github.com/sanorthey/pemmss/compare/v1.3.1...v1.4.0