GCAM USA state-glu spatial boundaries with mapping/aggregation file

<strong>Data documentation: GCAM USA state-glu spatial boundaries with mapping/aggregation file</strong> <strong>Summary: </strong>These data products present a vector file which represents the intersections of state boundaries for USA with GCAM basin boundaries within USA and a mapping file that can be used to map basin level data to states within the USA region (based on area) map state level data to basins within the USA region (based on area) The vector file presents metadata to the user regarding the state name, state id, glu name and glu id along with a unique key for each polygon. These spatial boundaries can be reproduced/updated by updating the inputs and making use of the methodology described below. <strong>CONTENTS:</strong> <strong>gcamusa_state_glu_wgs84 </strong>folder contains the following, <strong> shape_file</strong> folder contains the following, <strong>gcamusa_state_glu_wgs84.shp </strong> <strong> </strong> column names in outputs: <strong><em>key</em></strong>: Unique identifier for feature <strong><em>state_id:</em></strong> Unique identifier for state (state geo id) <strong><em>glu_id: </em></strong>Unique identifier for basin (basin number) <strong><em>state_nm:</em></strong> State name <strong><em>glu_nm: </em></strong>Basin name <strong> mapping_file </strong>folder contains the following, <strong>state_glu_mapping_WGS84.csv</strong> column names in outputs: <strong><em>state_id:</em></strong> Unique identifier for state (state geo id) <strong><em>glu_id: </em></strong>Unique identifier for basin (basin number) <strong><em>state_nm:</em></strong> State name <strong><em>glu_nm: </em></strong>Basin name <strong><em>state_area</em></strong>: Geometric area calculated for each state <strong><em>glu_area</em></strong>: Geometric area calculated for basin/glu <strong><em>intersection_area: </em></strong>Geometric area calculated for each basin-glu intersection <strong><em>state_proportion: </em></strong>Share of glu value in a state <strong><em>glu_proportion: </em></strong>Share of state value in a glu <strong> input_files </strong>folder contains the following, <em>glu_boundaries_moirai_combined_3p1_0p5arcmin : </em>A shape file containing boundaries for the GCAM glu’s. source: https://zenodo.org/record/4014308#.X6nkQ2hKhaR <em>tl_2019_us_state.shp : </em>A shape file containing boundaries for USA states. Source: https://www.census.gov/geographies/mapping-files/time-series/geo/tiger-line-file.html <strong>Methodology and reproducibility: </strong>The vector and mapping files were generated using the function located here- https://github.com/JGCRI/rgis/pull/7/commits/32ccb8cf8a30a66a84044da317b9041f492777be In order to reproduce or update the outputs the user would have to follow the following steps: Clone the rgis package from GitHub - https://github.com/JGCRI/rgis Use the <em>get_intersection_fractions</em>() function. Set the <em>shpfile_1</em> parameter to the path to the latest state boundaries and set <em>shpfile_2</em> parameter to the path to the glu boundaries shape file. Set the <em>out_csv</em> parameter to the desired mapping file name and set the <em>out_shape_file</em> parameter name to the desired vector output name.