Map a disclosure bundle onto a reporting framework — map_bundle_to

Joins a disclosure bundle against a framework's crosswalk dataset and resolves every disclosure to a value and a status (reported, partial, narrative_provided, narrative_required, not_in_scope). Contains no framework-specific logic: frameworks differ only in their crosswalk data.

Usage

map_bundle_to_framework(bundle, framework, include_voluntary = TRUE, ...)

Arguments

bundle: A minesdg_disclosure_bundle (or site data.frame, compiled automatically).
framework: One of "gri", "icmm", "brsr".
include_voluntary: Include non-mandatory disclosures (default TRUE).
...: Passed to compile_site_disclosures when bundle is a data.frame.

Value

An object of class minesdg_framework_mapping: a list with framework, table (one row per disclosure with value, value_prior, narrative, status), coverage and meta.

Examples

b <- compile_site_disclosures(demo_mine_sites, site_id = "CU-ATAC",
                              years = 2023:2024)
m <- map_bundle_to_framework(b, "gri")
m
#> == MineSDG Framework Mapping: GRI ==
#> Site: CU-ATAC | Reporting year: 2024 
#> Disclosures: 25 
#>   reported: 19 | partial: 0 | narrative provided: 0 | narrative required: 5 | not in scope: 1
#> Mandatory coverage: 17 / 22 (77.3%) 
summary(m)
#> == Coverage by section: GRI ==
#>                                   section     n covered
#>                                    <char> <int>   <int>
#> 1:                         GRI 302 Energy     3       3
#> 2:            GRI 303 Water and Effluents     5       4
#> 3:                   GRI 304 Biodiversity     3       2
#> 4:                      GRI 305 Emissions     3       3
#> 5:                          GRI 306 Waste     2       2
#> 6: GRI 403 Occupational Health and Safety     5       4
#> 7:              GRI 413 Local Communities     4       1
#> 
#> Disclosure lineage (id | status | source):
#>   302-1          reported           raw:energy_gj
#>   302-1b         reported           raw:renewable_energy_pct
#>   302-3          reported           kpi:energy_intensity
#>   303-1          narrative_required narrative:nar_water_mgmt
#>   303-3          reported           raw:water_withdrawal_m3
#>   303-4          reported           raw:water_discharge_m3
#>   303-5          reported           kpi:water_intensity
#>   303-R          reported           kpi:water_recycling_rate
#>   304-1          narrative_required narrative:nar_biodiv_sites
#>   304-3          reported           raw:land_rehabilitated_ha
#>   304-3b         reported           kpi:land_rehabilitation_pct
#>   305-1          reported           raw:ghg_scope1_t
#>   305-2          reported           raw:ghg_scope2_t
#>   305-4          reported           kpi:ghg_intensity
#>   306-3          reported           raw:tailings_kt+waste_rock_kt
#>   306-3b         reported           kpi:tailings_ratio
#>   403-1          narrative_required narrative:nar_ohs_system
#>   403-9a         reported           kpi:trifr
#>   403-9b         reported           kpi:ltifr
#>   403-9c         reported           kpi:fatality_rate
#>   403-9d         reported           raw:hours_worked
#>   413-1a         reported           kpi:community_investment_pct
#>   413-1b         not_in_scope       kpi:grievances_resolved_pct
#>   413-1c         narrative_required narrative:nar_community
#>   413-2          narrative_required narrative:nar_community_impacts