Mining Industry SDG Impact Calculator

Provides tools to calculate quantitative scores for the United Nations Sustainable Development Goals (SDGs) for the mining, minerals and metals sector. Retrieves official indicator data from the 'United Nations SDG API', runs trend, stability, benchmarking and convergence diagnostics, maps indicators to mining-sector materiality domains via a bundled ontology, computes site-level Key Performance Indicators (KPIs) aligned with Global Reporting Initiative (GRI) 11, International Council on Mining and Metals (ICMM) Mining Principles and Sustainability Accounting Standards Board (SASB) EM-MM conventions, scores sites on a 0-100 SDG scorecard, and ships an interactive 'shiny' dashboard with demonstration datasets. An Environmental, Social and Governance (ESG) reporting layer generates Global Reporting Initiative (GRI), International Council on Mining and Metals (ICMM) and Business Responsibility and Sustainability Reporting (BRSR) reports from a disclosure bundle interface, with framework mappings shipped as data and rendering to 'HTML', 'PDF', 'Word' and 'Excel' via 'Quarto' and 'openxlsx2'. Official Sustainable Development Goals information and indicator methodology are available from the United Nations Sustainable Development Goals website < https://sdgs.un.org/goals>.



R-CMD-check Lifecycle:experimental


MineSDG: Strategic Analytics & Sector Intelligence

R-CMD-check

MineSDG is a research-grade R framework designed to bridge the gap between raw operational data and the United Nations Sustainable Development Goals (SDGs). While generic tools rely on text-mining, MineSDG utilizes a quantitative "Sector Intelligence" layer to provide deep, actionable insights into mining sustainability.

The framework is architected for multi-source data agility, enabling users to integrate global sustainability indicators with regional benchmarks and internal corporate metrics to create a unified "Single Source of Truth" for Environmental, Social and Governance (ESG) performance.

It transforms fragmented metrics into executive-ready intelligence through four analytical pillars:

  • Agnostic Data Integration: Robust retrieval and harmonization of global, regional, and sector-specific sustainability datasets.

  • Advanced Statistical Diagnostics: Trend analysis, volatility indexing, and convergence testing.

  • Mining-Specific Interpretation: Mapping indicators to industry domains like Biodiversity & Land or Resource Efficiency.

  • Strategic Reporting: Automated generation of board-ready executive summaries and publication-quality visualizations.

Key Capabilities

  • SDG Analytics Engine: Perform CAGR calculations, linear trend slopes, and percent change analysis on sustainability metrics.

  • Stability & Risk Diagnostics: Evaluate ESG risk through volatility indexing and coefficient of variation.

  • Benchmarking & Ranking: Compare performance against global benchmarks with automated Z-scoring and percentile ranking.

  • Mining Risk Engine: Generate sector-aware risk profiles by integrating indicator trends with domain-specific relevance scoring.

  • Composite ESG Indexing: Build weighted indices (e.g., Biodiversity, Climate, or Social Impact) tailored to the mining sector's materiality.

Installation

The stable version (v0.4.0) of MineSDG is available as a formal release. You can install it directly from GitHub like so:

# install.packages("devtools")
devtools::install_github("imanojkumar/[email protected]")

For the latest version (v0.4.0), including the Environmental, Social and Governance (ESG) Reporting Layer (Global Reporting Initiative (GRI), International Council on Mining and Metals (ICMM), Business Responsibility and Sustainability Reporting (BRSR)), the Disclosure Bundle, Site KPI Engine, SDG Scorecards, the SDG-Mining Ontology, bundled demo datasets, and the Shiny Dashboard:

# install.packages("devtools")
devtools::install_github("imanojkumar/MineSDG")

New in v0.4.0: ESG Reporting Layer

MineSDG is now a reporting engine: one call turns site data into a GRI, ICMM or BRSR report, with every number sourced from the existing KPI engine through the disclosure bundle (single source of truth, zero duplicate calculations):

library(MineSDG)

# GRI 302/303/304/305/306/403/413 in one line
rep <- generate_gri_report(demo_mine_sites, site_id = "CU-ATAC",
                           years = 2022:2024)
gri_content_index(rep)

# ICMM: board scorecard, traffic lights, recommendations
icmm <- generate_icmm_report(demo_mine_sites, site_id = "CU-ATAC",
                             years = 2023:2024)
icmm$extras$traffic_lights

# BRSR Sections A/B/C (INR lakh via entity_meta$fx_usd_inr)
generate_brsr_kpis(demo_mine_sites, site_id = "CO-JHAR",
                   years = 2023:2024,
                   entity_meta = list(fx_usd_inr = 83.2))

# Render to HTML / PDF / DOCX (Quarto) or Excel (openxlsx2)
render_minesdg_report(rep, "gri_2024.pdf", format = "pdf")
write_report_xlsx(rep, "gri_2024.xlsx")

Framework mappings are data (gri_crosswalk, icmm_crosswalk, brsr_crosswalk): adding a disclosure means editing a dataset, not code. The dashboard gains Benchmark and Radar tabs (score_portfolio_sdg(), plot_sdg_radar(), plot_domain_radar()). Tutorial: vignette("esg-reporting").

New in v0.3.0: Site Intelligence & Dashboard

MineSDG now works at site level as well as country level — fully offline, on bundled demo data or your own:

library(MineSDG)

# Score one site-year against SDG-aligned KPI thresholds
site <- demo_mine_sites[demo_mine_sites$site_id == "CU-ATAC" &
                          demo_mine_sites$year == 2024, ]
score_site_sdg(site)
#> Composite score: 66.8 / 100  |  Grade: C

# Framework-referenced calculators (Global Reporting Initiative (GRI) 11 /
# International Council on Mining and Metals (ICMM) /
# Sustainability Accounting Standards Board (SASB) /
# Greenhouse Gas (GHG) Protocol
calculate_ghg_intensity(636000, 342000, 18481)      # SDG 13
calculate_safety_performance(6400000, 32, 10)       # SDG 8.8 (TRIFR/LTIFR)
calculate_waste_intensity(18481, 17750, 45412)      # SDG 12

# Explore the SDG-to-mining ontology and KPI registry
explore_sdg_ontology(domain = "water")
list_mining_kpis(sdg_goal = 8)

# Launch the interactive dashboard (requires shiny)
run_minesdg_dashboard()

Tutorials: vignette("site-level-kpis") and vignette("sdg-ontology-and-scorecard").

Quick Start: Strategic Workflow

MineSDG leverages open-access global data. No API keys are required for standard retrieval, allowing you to move from raw data to sector-specific intelligence in seconds:

The following example demonstrates how to retrieve data, analyze trends, and generate a mining-specific risk profile:

library(MineSDG)

# 1. Retrieve Global Data (e.g., Land Degradation / SDG 15.3.1)
# Accesses the official 'United Nations SDG API' directly
dt <- fetch_sdg_country_data(
  indicator  = "15.3.1",
  country    = "IND",
  year_range = c(2015, 2020)
)

# 2. Generate Sector-Specific Risk Profile
# Integrates trend, volatility, and domain relevance
risk_profile <- generate_mining_risk_profile(dt, indicator = "15.3.1")

# 3. View Executive Summary
# Produces board-ready narrative interpretation
cat(risk_profile$executive_summary)

# 4. Visualize the Strategic Trend
plot_sdg_trend(dt)



Citation & Data Acknowledgement

If you use MineSDG in your research, ESG reports, or strategic reviews, please cite it as follows:

Citation - APA 7th Edition:

Kumar, M. (2026). MineSDG: Strategic Analytics & Sector Intelligence for Mining Sustainability (Version 0.4.0) [R package]. GitHub. https://github.com/imanojkumar/MineSDG

BibTeX:

@Manual{,
  title = {MineSDG: Strategic Analytics & Sector Intelligence for Mining Sustainability},
  author = {Manoj Kumar},
  year = {2026},
  note = {R package version 0.4.0},
  url = {https://github.com/imanojkumar/MineSDG},
}

Data Acknowledgement

MineSDG acts as a client for the official 'United Nations SDG API'. Users of this package are bound by the United Nations Data Terms of Use. We gratefully acknowledge the UN Statistics Division for maintaining the global SDG indicator database.




Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("MineSDG")

0.4.0 by Manoj Kumar, 2 months ago


https://imanojkumar.github.io/MineSDG/


Report a bug at https://github.com/imanojkumar/MineSDG/issues/


Browse source code at https://github.com/cran/MineSDG


Authors: Manoj Kumar [aut, cre]


Documentation:   PDF Manual  


MIT + file LICENSE license


Imports httr2, data.table, dplyr, ggplot2, stats

Suggests testthat, knitr, rmarkdown, shiny, DT, quarto, openxlsx2

System requirements: Quarto CLI (>= 1.4) (optional, for report rendering)


See at CRAN