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.
数据文档:附带映射/聚合文件的GCAM美国州-glu空间边界 摘要:本数据集产品包含两类核心文件:其一为矢量文件,表征美国本土州界与GCAM流域单元(glu)边界的相交区域;其二为映射文件,可用于将流域级数据按面积权重映射至美国各州,或将州级数据按面积权重映射至美国各流域。该矢量文件附带元数据,包含州名称、州唯一标识、流域单元(glu)名称、流域单元(glu)唯一标识,以及每个多边形的唯一键值。用户可通过更新输入数据并采用下述描述的方法,复现或更新此类空间边界数据。 内容说明: `gcamusa_state_glu_wgs84` 文件夹包含以下内容: `shape_file` 文件夹内包含文件:`gcamusa_state_glu_wgs84.shp`。 输出文件的字段说明如下: - `key`:地理要素的唯一标识符 - `state_id`:州的唯一标识(州地理编码ID) - `glu_id`:流域单元(glu)的唯一标识(流域编号) - `state_nm`:州名称 - `glu_nm`:流域单元(glu)名称 `mapping_file` 文件夹包含以下内容:`state_glu_mapping_WGS84.csv`。 该映射文件的输出字段说明如下: - `state_id`:州的唯一标识(州地理编码ID) - `glu_id`:流域单元(glu)的唯一标识(流域编号) - `state_nm`:州名称 - `glu_nm`:流域单元(glu)名称 - `state_area`:各州计算得到的几何面积 - `glu_area`:各流域单元(glu)计算得到的几何面积 - `intersection_area`:每个州-流域单元相交区域计算得到的几何面积 - `state_proportion`:流域单元值在对应州内的占比 - `glu_proportion`:州值在对应流域单元内的占比 `input_files` 文件夹包含以下内容: - `glu_boundaries_moirai_combined_3p1_0p5arcmin`:包含GCAM流域单元边界的矢量文件,来源:https://zenodo.org/record/4014308#.X6nkQ2hKhaR - `tl_2019_us_state.shp`:包含美国州界的矢量文件,来源:https://www.census.gov/geographies/mapping-files/time-series/geo/tiger-line-file.html 方法学与可复现性: 本矢量文件与映射文件通过下述路径的函数生成:https://github.com/JGCRI/rgis/pull/7/commits/32ccb8cf8a30a66a84044da317b9041f492777be。 若需复现或更新输出结果,用户需执行以下步骤: 1. 从GitHub克隆rgis工具包:https://github.com/JGCRI/rgis 2. 使用`get_intersection_fractions()`函数,将`shpfile_1`参数设置为最新州界文件的路径,将`shpfile_2`参数设置为流域单元边界矢量文件的路径 3. 将`out_csv`参数设置为所需的映射文件名称,将`out_shape_file`参数设置为所需的矢量输出文件名称。



