关于模型开发和维护的几点说明

[crazyzlj]

1.Wiki的更新

Github中Wiki可认为是独立的库，可通过如下命令克隆到本地，进行修改：

git clone https://github.com/lreis2415/SEIMS.wiki.git

采用Markdown语法，推荐使用Markdown Pad2或者Typora编辑器，当然，也可直接采用文本编辑器，如Notepad++。

大家在模型开发或使用过程中，可及时更新Wiki内容，特别是对于刚接触SEIMS的同学。@shiyaxingstar

2.master分支的管理

目前，按照开发规范，master分支上的代码应该是相对稳定，可以运行的。因此，我整理了一个示例数据（位于/data/dianbu2），并利用Python代码对数据预处理、模型运行、结果制图等方面进行测试。

因此，要求大家，自己修改模型代码后，要对dianbu2示例数据、模型运行流程测试代码（/seims/test/run_seims_demo_data.py）进行修正之后，再将自己的分支代码合并至master分支。

• 原则上的测试流程如下（以linux下的操作为例，Windows中类似。前提是已经配置好了GDAL，mongo-c-driver的C++库和Python包，以及模型预处理、后处理所需的第三方包，如matplotlib，numpy，pygeoc等）：

cd SEIMS
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j4
make install
cd ..
python seims/test/run_seims_demo_data.py

• 按照目前的设计，预处理程序产生的中间文件存放在/data/dianbu2/workspace中，如下图所示：

• 在MongoDB数据库中对应有3个数据库，分别是情景措施数据库、水文气象数据库和空间数据库，如下图所示：

• 目前代码中，默认的情景编号为0，因此，在模型文件夹中的输出目录为OUTPUT0，后处理程序只绘制了流域出口流量和降雨量图，如下：

3.关于模型基本框架的修改

模型所用栅格读写类RasterClass、基本操作类UtilsClass和MongoDB操作类MongoUtilClass独立成Github库进行维护，并采用Google Test单元测试框架进行测试，目前RasterClass的完成度较高，但仍需测试完善，有兴趣的同学可以学习并改进。

关于模型框架，阅读代码时如有疑问，或者有改进的想法，欢迎大家及时提出并讨论！

@liujunzhi321 @Shenfang1993 @shiyaxingstar