Data from: Expanded potential growing region and yield increase for Agave americana with future climate

In Davis et al (2021) we simulated the potential productivity of Agave americana under current and future climates, with and without water management using either irrigation or rock mulch.
This repository contains data generated for the analyses in Davis et al (2021). The code and code documentation can be more easily browsed on GitHub at https://github.com/cct-datascience/agave-prediction, but are also archived here.
The key dataset of interest is allbiomass.nc, which provides predicted annual biomass increments for Agave americana under present and future climates and under rainfed, irrigated, and rock mulch + irrigation scenarios. It contains the model predictions of annual biomass production with units of Mg/ha/y for six scenarios on the same latitude and longitude dimensions as the TERRACLIMATE dataset:

biomass: rainfed, historical climate
biomass_irrig: irrigated, historical climate
biomass_rockmulch: rainfed with rock mulch, historical climate
biomass4C: rainfed, +4C climate
biomass_irrig: irrigated, +4C climate
biomass_rockmulch: rainfed with rock mulch, +4C climate

Other files likely of interest generated as intermediate steps in the analysis:
absmin19812010.nc and absmin4C.nc
These files contain the variable absmin, the absolute minimum temperature. These files also contain tmin, adjustC, and cadj used to compute absmin as described in the text and Calculating Absolute Minimum Annual Temperature section of the README.

tmin: Average minimum 2-m air temperature, from TERRACLIMATE
absmin: Absolute minimum 2-m temperature, calculated for this study to determine viable range of Agave americana

coefs19812010.nc and coefs4C.nc
These files provide calculated values of environmental productivity index model parameters alpha, beta, and gamma. These coefficients have values in the range [0,1], with 0 indicating that the environment does not allow growth and 1 indicating that the environmental factor does not limit growth. These coefficients are calculated monthly for each grid cell under 1981-2010 and +4C climate normals, and beta is calculated for the three water availability scenarios. These coefficients have values in the range [0,1], with 0 indicating that the environment does not allow growth and 1 indicating that the environmental factor does not limit growth.

alpha: light limitation coefficient
beta: water limitation coefficient
beta2: water limitation coefficient to simulate irrigation
beta3: water limitation coefficient to simulate rainfed with rock mulch
gamma: minimum temperature coefficient 

Files provided for reference, not intended for reuse:

README.pdf contains the README that explains the analysis steps, data sources, and outputs in more detail.
The file not_suitable.gpkg contains polygons representing the union of land that is either protected (UNEP-WCMC and IUCN 2021) or urbanized (Kelso and Patterson 2010). As UNEP-WCMC is updated monthly, researchers are advised to download the current version.
figures.zip contains all map figures generated using Panoply, as well as Panoply settings files with the extension .pcl.
agave-prediction-master_20220511.zip contains a snapshot of code in the GitHub repository.
The original files containing adjustC and cadj are archived in the file absmin_adjustments.zip because these are the inputs to the analysis. The same data layers are also provided alongside calculated absmin in the files absmin19802010.nc and absmin4C.nc.

All NetCDF files (those ending in .nc) have additional metadata. The paper and software repository provide additional details.
To cite the research:

Davis, S.C.; Abatzoglou, J.T.; LeBauer, D.S. Expanded Potential Growing Region and Yield Increase for Agave americana with Future Climate. Agronomy 2021, 11, 2109. https://doi.org/10.3390/agronomy11112109

To cite these datasets (this archive):

LeBauer, David Shaner; Davis, Sarah; Abatzoglou, John (2022): Data from: Expanded potential growing region and yield increase for Agave americana with future climate. University of Arizona Research Data Repository. Dataset. https://doi.org/10.25422/azu.data.16828279  

To cite the code: 

LeBauer, D., Davis, S., & Abatzoglou, J. (2021). Data and Code from: Expanded potential growing region and yield increase for Agave americana with future climate (Version davis_etal_2021) [Computer software]. https://github.com/cct-datascience/agave-prediction

For inquiries regarding the contents of this dataset, please contact the Corresponding Author listed in the README.txt file. Administrative inquiries (e.g., removal requests, trouble downloading, etc.) can be directed to [e-mail]

在 Davis 等人（2021年）的研究中，我们模拟了在当前及未来气候条件下，利用灌溉或石块覆盖层进行水分管理与否，对美国龙舌兰（Agave americana）潜在生产力的影响。本存储库包含了 Davis 等人（2021年）分析所生成的数据。代码及其文档可以在 GitHub 上更为便捷地浏览，网址为 https://github.com/cct-datascience/agave-prediction，但同时也存档于此。

值得关注的关键数据集为 allbiomass.nc，该数据集提供了在现有及未来气候条件下，以及雨水灌溉、灌溉和石块覆盖层加灌溉情景下，美国龙舌兰的预测年生物量增量。它包含了与 TERRACLIMATE 数据集相同的经纬度维度上，六个情景的年生物量生产模型预测，单位为 Mg/ha/y：

- 生物量：雨水灌溉，历史气候
- 生物量灌溉：灌溉，历史气候
- 生物量石块覆盖层：雨水灌溉加石块覆盖层，历史气候
- 生物量4C：雨水灌溉，+4℃气候
- 生物量灌溉：灌溉，+4℃气候
- 生物量石块覆盖层：雨水灌溉加石块覆盖层，+4℃气候

其他可能在分析中间步骤中生成的文件，可能值得关注的有：

- absmin19812010.nc 和 absmin4C.nc：这些文件包含了绝对最低温度变量 absmin，以及用于计算 absmin 的 tmin、adjustC 和 cadj。这些文件还包含了计算 absmin 所需的文本描述以及 README 中的“计算绝对最低年温度”部分。
- coefs19812010.nc 和 coefs4C.nc：这些文件提供了环境生产力指数模型参数 alpha、beta 和 gamma 的计算值。这些系数的取值范围为 [0,1]，其中 0 表示环境不允许生长，1 表示环境因素不限制生长。这些系数按月为每个网格单元在 1981-2010 年和 +4℃ 气候正常值下计算，beta 在三种水分可用性情景下计算。这些系数的取值范围为 [0,1]，其中 0 表示环境不允许生长，1 表示环境因素不限制生长。

提供供参考的文件，不推荐用于重复使用：

- README.pdf：包含解释分析步骤、数据来源和输出的详细说明的 README。
- not_suitable.gpkg：包含代表受保护（UNEP-WCMC 和 IUCN 2021）或城市化（Kelso 和 Patterson 2010）的土地多边形的文件。由于 UNEP-WCMC 每月更新，研究人员建议下载最新版本。
- figures.zip：包含使用 Panoply 生成的所有地图图形以及 Panoply 设置文件（扩展名为 .pcl）。
- agave-prediction-master_20220511.zip：包含 GitHub 仓库中代码的快照。
- 包含 adjustC 和 cadj 的原始文件存档在 absmin_adjustments.zip 文件中，因为这些是分析的输入。相同的数据层也随计算出的 absmin 一起提供，存放在 absmin19802010.nc 和 absmin4C.nc 文件中。

所有 NetCDF 文件（以 .nc 结尾）都包含额外的元数据。论文和软件仓库提供了更多详细信息。

为了引用该研究，请参阅：

Davis, S.C.; Abatzoglou, J.T.; LeBauer, D.S. 扩展 Agave americana 的潜在生长区域和未来气候下的产量增加。农业学 2021，11，2109。https://doi.org/10.3390/agronomy11112109

为了引用这些数据集（本存档），请参阅：

LeBauer, David Shaner; Davis, Sarah; Abatzoglou, John (2022)：来自：Agave americana 的潜在生长区域和未来气候下的产量增加的数据。亚利桑那大学研究数据存储库。数据集。https://doi.org/10.25422/azu.data.16828279

为了引用代码，请参阅：

LeBauer, D., Davis, S., & Abatzoglou, J. (2021)。来自：Agave americana 的潜在生长区域和未来气候下的产量增加的数据和代码（版本 davis_etal_2021）[计算机软件]。https://github.com/cct-datascience/agave-prediction

有关本数据集内容的咨询，请联系 README.txt 文件中列出的通讯作者。行政查询（例如，移除请求、下载问题等）可发送至 [e-mail]。