Transforms one year of raw site operational data into a normalised
0-100 SDG scorecard. Each KPI is derived from the raw fields, then
linearly rescaled between the poor_value (score 0) and good_value
(score 100) reference thresholds in mining_kpi_registry, respecting
the KPI's improvement direction. Scores are aggregated to SDG-goal
level and into a materiality-weighted composite (weights from
sdg_mining_ontology).
Usage
score_site_sdg(site_data, registry = MineSDG::mining_kpi_registry)Arguments
- site_data
A one-row data.frame (e.g. one site-year of demo_mine_sites).
- registry
KPI registry data frame. Default mining_kpi_registry. Supply a customised copy to calibrate thresholds to your commodity.
Value
An object of class minesdg_site_score: a list with
scorecard (data.table: kpi_id, kpi_name, sdg_goal, value, unit,
score), goal_scores (data.table: sdg_goal, mining_domain, weight,
goal_score), composite_score (0-100), and grade (A-E).
Details
Expected columns in site_data (one row; extra columns are ignored):
ore_processed_kt, ghg_scope1_t, ghg_scope2_t, energy_gj,
renewable_energy_pct, water_withdrawal_m3, water_recycled_m3,
land_disturbed_ha, land_rehabilitated_ha, hours_worked,
recordable_injuries, lost_time_injuries, fatalities,
female_employment_pct, local_employment_pct, revenue_musd,
community_investment_musd, tailings_kt, waste_rock_kt.
Missing fields simply drop the corresponding KPIs from the scorecard.
Examples
site <- demo_mine_sites[demo_mine_sites$site_id == "CU-ATAC" &
demo_mine_sites$year == 2024, ]
score_site_sdg(site)
#> == MineSDG Site SDG Scorecard ==
#> Site: CU-ATAC (2024)
#> Composite score: 66.8 / 100 | Grade: C
#>
#> Goal-level scores (materiality-weighted):
#> Key: <sdg_goal>
#> sdg_goal mining_domain weight goal_score
#> <int> <char> <num> <num>
#> 1: 1 Economic Development 3 66.5
#> 2: 5 Community & Social Impact 3 64.4
#> 3: 6 Water & Resource Efficiency 5 57.6
#> 4: 7 Climate & Energy 4 84.7
#> 5: 8 Economic Development 4 86.3
#> 6: 12 Water & Resource Efficiency 4 40.1
#> 7: 13 Climate & Energy 5 69.1
#> 8: 15 Biodiversity & Land 5 66.5
#>
#> KPI detail available in $scorecard (14 KPIs).