Colorado River Coding

Small and bigger coding efforts to support Colorado River work. See Folder contents #1-20 below. Most of these efforts are beginning coding efforts and works in progress.

Download data, models, code, and directions at https://doi.org/10.5281/zenodo.5501466.

Find current versions at https://github.com/dzeke/ColoradoRiverCoding.
## Explanation of Contents

1. **500PlusPlan** - Total costs for different 500,000 acre-feet plan for Lake Mead prices and volumes.
2. **BlogDrafts** - Preprints of blogs in the series \"Encouraging more water conservation in the Colorado River Basin\".
3. **CombinedPowellMead** - Plots of combined Lake Powell and Lake Mead storage over time.
4. **EvapCalcs** - Plots to show reservoir evaporation for Lakes Mead and Powell as a function of reservoir storage/level. This supports
an alternative management paradigm where reservoir evaporation is counted as part of lower basin users consumptive use.
5. **GrandCanyonInterveningFlow** - Plots of Grand Canyon intervening flow between Lake Powell and Lake Mead to help characterize inflows to Lake Mead.
6. **HeadwatersReservoirs** - Storage for Upper Basin headwaters reservoirs (Fontenelle, Flaming Gorge).
7. **ICS** - Plots of intentionally created surplus (ICS) for Lake Mead account balances, puts and takes, limits, and comparison of ICS efforts to mandatory Drought Contigency Plan contributions.
8. **InterimShortageGuidelines** - Plots of cutbacks in deliveries as a function of Lake Mead level. Both for the Interim Guidelines and newly released Drought Contingency Plan.
9. **LakePowellTemperatureScenarios** - Calcualtes the Lake Powell release temperatures for different lake levels. Assigns release temperatures to different fish scenarios.
10. **LowerBasinAgUses** - Plots of CRSS consumptive use input data for Lower Basin states.
11. **MeadInflowSimulations** - Adapt Lake Mead releases to reservoir inflow. Smulations of Lake Mead draw down, stabilization, and recover for different scenarios of Lake Mead inflow and addition water conservation beyond mandatory targets.
12. **MeadPowellPlots** - Visualization of the Lake Powell-Lake Mead Equalization rules. This is Powell annual release as a function of Powell storage and Mead storage. Also includes plots that show the reservoir zones.
13. **ModelMusings** - Pilot flex accounting to encourage more water conservation in a combined Lake Powell-Lake Mead system. Cloud-based interactive model for the Colorado River basin. When participants synchronously connect, they can role play Upper Basin, Lower Basin, Mexico, and other parties. Participants make
year-to-year water conservation, consumption, purchase, and sale decisions for their party while they track other players' choices, account balances, reservoir storage, and impacts to Grand Canyon fish.
14. **Powell10Year** - Plots showing Lake Powell 10-year releases in comparison to Colorado River Compact Article III(d) requirement
15. **Pre1922CompactWaterUse** - Table of Pre-1922 Compact water use by state.
16. **ProtectLakePowell** - Figure of tools to protect Lake Powell elevations of 3,525 and 3,490 feet.
17. **Runge_MCDM_Analysis** - interactive parallel coordinate plot visualization of the 18 objectives use in the analysis by Runge et al of Glend Canyon Dam management alternatives. Runge, M. C., et al. (2015). \"Decision analysis to support development of the Glen Canyon Dam long-term experimental and management plan.\" 2015-5176, U.S. Geological Survey, Reston, VA. http://pubs.er.usgs.gov/publication/sir20155176.
18. **TimeToDeadPool** - a steady deterministic scenario analysis of the number of years to hit Lake Mead dead pool (or other target elevation) given a starting storage volume and steady reservoir inflow. Used to explore scenarios of inflow from 7 to 14 maf per year every year and identify potential effects of additional voluntary water conservation.
19. **TribalWater** - Digitizes some of the data in the Tribal Water Study by the USBR.
20. **UpperBasinAgriculture** - Costs of demand management in Upper Basin.

## License
BSD-3-Clause (https://github.com/dzeke/ColoradoRiverFutures/blob/master/LICENSE). Available to use, modify, distribute, etc. for free.
All modified or derivative products must use the same BSD-3-Clause license. This license keeps this work in the public domain forever.

本数据集包含支撑科罗拉多河相关工作的小型及大型代码开发项目，详见下文1-20号文件夹内容。其中绝大多数项目尚处于初始开发阶段或未完成状态。

可通过 https://doi.org/10.5281/zenodo.5501466 下载数据集、模型、代码及操作指南。

最新版本可于 https://github.com/dzeke/ColoradoRiverCoding 获取。

## 文件夹内容说明

1. **500PlusPlan**：针对米德湖不同规模（50万英亩-英尺（acre-foot））方案的成本、水量及价格相关数据。
2. **BlogDrafts**：《科罗拉多河流域节水推广》系列博客的预印稿件。
3. **CombinedPowellMead**：鲍威尔湖与米德湖联合蓄水量随时间变化的可视化图表。
4. **EvapCalcs**：展示米德湖与鲍威尔湖水库蒸发量随蓄水量/水位变化的图表，支撑将水库蒸发量计入下游流域用户消耗性用水的新型管理范式。
5. **GrandCanyonInterveningFlow**：鲍威尔湖与米德湖之间的大峡谷区间流量图表，用于辅助分析米德湖的入境流量特征。
6. **HeadwatersReservoirs**：科罗拉多河上游源头水库（方特内尔水库、火烈峡谷水库）的蓄水量数据。
7. **ICS**：米德湖账户余额、借入与借出额度、限额的人工盈余（ICS）相关图表，以及人工盈余措施与强制性干旱应急计划缴款的对比分析。
8. **InterimShortageGuidelines**：基于米德湖水位变化的供水削减量图表，涵盖临时指南与最新发布的干旱应急计划两种场景。
9. **LakePowellTemperatureScenarios**：针对不同水位的鲍威尔湖出库水温进行计算，并为不同鱼类生存场景分配出库水温参数。
10. **LowerBasinAgUses**：下游流域各州的CRSS消耗性用水输入数据可视化图表。
11. **MeadInflowSimulations**：适配米德湖出库流量与水库入境流量的模型，针对米德湖入境流量及超出强制性目标的额外节水场景，模拟米德湖的水位下降、稳定及恢复过程。
12. **MeadPowellPlots**：鲍威尔湖-米德湖水量均衡规则的可视化内容，即鲍威尔湖年出库流量随鲍威尔湖蓄水量及米德湖蓄水量的变化关系，同时包含水库分区相关图表。
13. **ModelMusings**：用于在鲍威尔湖-米德湖联合系统中推广节水的试点弹性核算工具。本数据集包含科罗拉多河流域的云端交互式模型：当参与者同步接入后，可分别扮演上游流域、下游流域、墨西哥及其他参与方，逐年为所属方做出节水、用水、购水及售水决策，并可实时追踪其他参与方的决策、账户余额、水库蓄水量及对大峡谷鱼类的影响。
14. **Powell10Year**：鲍威尔湖10年出库流量与《科罗拉多河协议》第III(d)条要求的对比图表。
15. **Pre1922CompactWaterUse**：各州1922年《科罗拉多河协议》签订前的用水情况统计表。
16. **ProtectLakePowell**：用于维持鲍威尔湖水位3525英尺及3490英尺的相关工具图表。
17. **Runge_MCDM_Analysis**：Runge等人用于格伦峡谷大坝管理方案分析的18项评估目标的交互式平行坐标图可视化内容。参考文献：Runge, M. C. 等(2015). 《支撑格伦峡谷大坝长期试验与管理计划制定的决策分析》，2015-5176，美国地质调查局（USBR, United States Bureau of Reclamation），弗农，弗吉尼亚州。http://pubs.er.usgs.gov/publication/sir20155176。
18. **TimeToDeadPool**：基于初始蓄水量及稳定入境流量的确定性情景分析，用于计算米德湖达到死水位（dead pool，即水库无法通过重力自流放水的临界水位）或其他目标水位所需的年限。本工具用于探索入境流量为每年700万至1400万英亩-英尺（maf, million acre-foot）的场景，并评估额外自愿节水措施的潜在影响。
19. **TribalWater**：美国垦务局（USBR, United States Bureau of Reclamation）《部落用水研究》中部分数据的数字化成果。
20. **UpperBasinAgriculture**：上游流域的需求管理成本数据。

## 许可协议

本数据集采用BSD-3-Clause协议（https://github.com/dzeke/ColoradoRiverFutures/blob/master/LICENSE）。可免费使用、修改、分发本作品及进行其他相关操作。所有修改或衍生作品必须采用相同的BSD-3-Clause许可协议，该协议将使本作品永久处于公共领域。