Primary Exploration, Mining and Metal Supply Scenario (PEMMSS) model Version: 1.3.1 Version Date: 2024-07-10 Developed 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 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 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.3.1 Notes: Feature Additions Added file requirements.txt Additional output files for Mine status through time for each iteration Users can now generate aggregated outputs for mines_depleted_count and mines_undeveloped_count by adding these to input_postprocessing.csv file. Prior version input files should continue to work correctly, so these changes are non-breaking. Bug Fixes File and directory path errors reported by multiple users on different platforms. Consistent use of the pathlib standard package and Path objects now implemented throughout the code base. Dependency on the os standard package removed as part of this. Code Improvement Building blocks put in place for further generation and processing of deposit/mines level statistics across iteration sets. Changelog: 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.

Please cite this repository when using or describing this model.