Data for: A water temperature simulation model for rice paddies with variable water depths

Supporting Information for
A water temperature simulation model for rice paddies with variable water depths
https://doi.org/10.1002/2017WR021019

This dataset provides calculation samples and program code for the water temperature simulation model proposed in the paper. Program code is available in both VBA and Python versions. The VBA version includes calculation samples with input values and is compiled into an Excel file (XLSM). For the Python version of the program, sample input values (CSV) are provided separately for testing the calculation. Output values (CSV) are also provided for checking the calculation results.

These input values are based on observations at the experimental site in Saito, Japan (the location is shown in Fig. 3 of the paper). Observation was conducted from transplanting to harvest of rice in 2002. Additionally, for Python program code, a Japanese-annotated version is available that includes a function utilizing Agro-Meteorological Grid Square Data (AMGSD) as meteorological input values.

In the program code, the leaf area index (LAI) and canopy height (h) of rice are calculated from developmental stage (DVS: denoted as phenological stage Ps in the paper) using a crop growth model. Time step for the crop growth model is 1 day. On the other hand, time step for the energy balance model is 1 hour. The calculation includes a 10-day spin-up period to obtain water temperatures after eliminating the influence of initial values. Using the energy balance model, Canopy temperature and energy balance components including latent heat flux (evapotranspiration) are also calculated simultaneously with water temperature.

[Dataset]
1. PaddyWaterTemp.py: Python program code of the model
2. PaddyWaterTemp_INPUT.csv : Sample input values for Python program code
3. PaddyWaterTemp_OUTPUT.csv: Sample output values for Python program code
4. PaddyWaterTemp__JPN.py: Japanese version of Python program code
5. PaddyWaterTemp__VBA.xlsm: VBA program code and calculation sample of the model

Other calculation samples, such as water temperature simulation with change in water depth conducted in the paper, are available in previous versions of this dataset.
https://doi.org/10.17632/crbdbyc87j.2

可变水深稻田水温模拟模型补充材料
https://doi.org/10.1002/2017WR021019

本数据集提供了论文中提出的稻田水温模拟模型的计算示例与程序代码。程序代码包含VBA与Python两种版本。其中VBA版本集成了带输入参数的计算示例，并封装为Excel文件（XLSM格式）。针对Python版本程序，本数据集单独提供了用于计算测试的示例输入参数文件（CSV格式），同时也提供了用于验证计算结果的示例输出结果文件（CSV格式）。

上述输入参数基于日本齐藤（Saito）试验场地的观测数据（观测点位详见论文图3），观测时段为2002年水稻从插秧到收获的全生育周期。此外，Python版本程序还提供了日文注释版本，该版本包含了以农业气象网格数据（Agro-Meteorological Grid Square Data, AMGSD）作为气象输入参数的计算函数。

本程序代码基于作物生长模型，根据水稻生育期（DVS：论文中记为物候阶段Ps）计算水稻叶面积指数（Leaf Area Index, LAI）与冠层高度（h）。其中作物生长模型的时间步长为1天，而能量平衡模型的时间步长为1小时。整个计算流程包含10天的自旋启动时段，用于消除初始值影响以获得稳定的水温计算结果。借助能量平衡模型，本程序可在计算水温的同时同步获取冠层温度与包括潜热通量（蒸散）在内的各项能量平衡组分。

### 数据集文件清单
1. PaddyWaterTemp.py：本模型的Python程序代码
2. PaddyWaterTemp_INPUT.csv：Python程序代码所用的示例输入参数文件
3. PaddyWaterTemp_OUTPUT.csv：Python程序代码所用的示例输出结果文件
4. PaddyWaterTemp__JPN.py：带日文注释的Python程序代码版本
5. PaddyWaterTemp__VBA.xlsm：本模型的VBA程序代码与计算示例文件

本数据集的历史版本还包含论文中开展的其他计算示例，例如基于水深变化的水温模拟相关内容，其永久链接为：https://doi.org/10.17632/crbdbyc87j.2