pemmss - PEMMSS v1.4.0

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 endyear 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 capacitygenerate() 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

- Python
Published by sanorthey 10 months ago

pemmss - PEMMSS v1.3.1

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 minesdepletedcount and minesundevelopedcount 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 endyear 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 capacitygenerate() 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.

- Python
Published by sanorthey almost 2 years ago

pemmss - PEMMSS v1.3.0

Primary Exploration, Mining and Metal Supply Scenario (PEMMSS) model Version: 1.3.0 Version Date: 2024-06-04

Developed by Stephen A. Northey in collaboration with S. Pauliuk, S. Klose, M. Yellishetty and 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 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

Changelog:

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.

- Python
Published by sanorthey about 2 years ago

pemmss - PEMMSS v.1.2.0

Primary Exploration, Mining and Metal Supply Scenario (PEMMSS) model Version: 1.2.0 Version Date: 2023-12-22

Developed by Stephen A. Northey in collaboration with S. Pauliuk, S. Klose, M. Yellishetty and 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 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

Changelog:

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.

- Python
Published by sanorthey over 2 years ago

pemmss - PEMMSS v1.1.0

Primary Exploration, Mining and Metal Supply Scenario (PEMMSS) model Version: 1.1.0 Version Date: 2022-12-31

Developed by Stephen A. Northey in collaboration with S. Pauliuk, S. Klose, M. Yellishetty and 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 repository and the journal article under preparation that describes the model design and rationale. See CITATION.cff for specific details.

Changelog: 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.

- Python
Published by sanorthey over 3 years ago

pemmss - PEMMSS v1.0.2

Primary Exploration, Mining and Metal Supply Scenario (PEMMSS) model Version: 1.0.2 Version Date: 2022-09-08

Developed by Stephen A. Northey in collaboration with S. Pauliuk, S. Klose, M. Yellishetty and 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 repository and the journal article under preparation that describes the model design and rationale. See CITATION.cff for specific details.

Changelog: 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.

- Python
Published by sanorthey almost 4 years ago

pemmss - PEMMSS v1.0.1

Primary Exploration, Mining and Metal Supply Scenario (PEMMSS) model Version: 1.0.1 Version Date: 2022-08-17

Developed by Stephen A. Northey in collaboration with S. Pauliuk, S. Klose, M. Yellishetty and 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 repository and the journal article under preparation that describes the model design and rationale. See CITATION.cff for specific details.

Changelog: v1.0.0 to v1.0.1 - New release created to trigger establishment of a Zenodo archive. Updated version number and date.

- Python
Published by sanorthey almost 4 years ago

pemmss - PEMMSS v1.0.0

Primary Exploration, Mining and Metal Supply Scenario (PEMMSS) model Version: 1.0.0 Version Date: 2022-07-15

Developed by Stephen A. Northey in collaboration with S. Pauliuk, S. Klose, M. Yellishetty and 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 repository and the journal article under preparation that describes the model design and rationale. See CITATION.cff for specific details.

- Python
Published by sanorthey almost 4 years ago