水利部模型平台适配技术流程

水利部模型平台适配技术流程本文档主要介绍水利专业模型评测适配的基本流程，包括输入输出接口改造、模型封装测试、镜像推送注册等步骤，帮助各参评单位能较为独立的完成水利部模型平台适配工作。一、互联网操作此阶段需参评单位根据相关规范对所需适配的模型进行输入输出接口改造和模型封装，更多是对数据传递过程和Linux运行环境的完善或设置。操作过程可根据《水利部数字孪生平台水利专业模型输入输出数据结构规范（试行）》和《水利部数字孪生平台水利专业模型封装技术要求(试行)》两个技术要求以及平台技术指导人员提供的输入输出结构化规范以及模型封装说明文件进行自主设置。输入输出接口改造输入输出接口改造中对水网模型常见的变量进行了示例说明，对字段名称、英文名称、字段数据项类型、字段数据类型、维度排序、默认值同样进行了规范。以下给出部分模型改造示例供参考。（1）逐日来水预报模型表1.1-1输入数据_模拟断面设置字段名称英文名称数据结构数据类型维度排序单位默认值备注关注区域类型数量RECORD维度整型关注区域类型TYPE一维数组整型RECORD--关注类型FOCUS_TYPE一维数组整型RECORD--起始子流域START_ID一维数组整型RECORD--结束子流域END_ID一维数组整型RECORD--区域河长RIVER_LEN一维数组整型RECORD--区域名称NAME一维数组字符串RECORD--表1.1-2输入数据_日尺度降雨数据字段名称英文名称数据结构数据类型维度排序单位默认值备注时间维度TM维度整型区域数量SUBBASINS维度整型关注区域SUBBASIN一维数组整型SUBBASINS--日尺度降雨VALUE二维数组双精度浮点型TM,SUBBASINS--开始时间BGTM单值字符串结束时间EDTM单值字符串时间步长DT单值整型时间单位DT_UNIT单值字符串表1.1-3输出数据_省区月尺度数据字段名称英文名称数据结构数据类型维度排序单位默认值备注时间维度TM维度整型区域数量REGION维度整型区域面积AREA二维数组双精度浮点型TM,REGION--降水RAINFALL二维数组双精度浮点型TM,REGION--区域总蒸发EVAPORATION二维数组双精度浮点型TM,REGION--区域入渗INFILTRATION二维数组双精度浮点型TM,REGION--地下水补充量GW_RECHARGE二维数组双精度浮点型TM,REGION--坡面产流量SLOPE_RUNOFF二维数组双精度浮点型TM,REGION--平均气温TEMPERATURE二维数组双精度浮点型TM,REGION--地表水资源量SURFACE_WATER二维数组双精度浮点型TM,REGION--地表-地下重复量GW_RECHARGE_REPEAT二维数组双精度浮点型TM,REGION--不重复量地下水GW_RECHARGE_UNIQUE二维数组双精度浮点型TM,REGION--地下水排泄量GW_DRAINAGE二维数组双精度浮点型TM,REGION--水资源总量TOTAL_WATER二维数组双精度浮点型TM,REGION--有效蒸散发EVAPO_EFFECTIVE二维数组双精度浮点型TM,REGION--无效蒸散发EVAPO_INVALID二维数组双精度浮点型TM,REGION--开始时间BGTM单值字符串结束时间EDTM单值字符串时间步长DT单值整型时间单位DT_UNIT单值字符串（2）区域水资源配置模型表1.2-1输入数据_供水渠道属性字段名称英文名称数据结构数据类型维度排序单位默认值备注供水渠道数量维度MN维度整型时间维度TM维度整型供水渠道属性SPLCAN二维数组单精度浮点型MN,TM--表1.2-2输入数据_水库类数据字段名称英文名称数据结构数据类型维度排序单位默认值备注年份YEAR单值整型数量维度MN维度整型时间维度TM维度整型河道内生态时间维度INNEEDTM维度整型河道内生态编号维度INNEEDBH维度整型河道内生态编号表征维度INNEEDBHCOL维度整型初始蓄水量表征维度RETAIN维度整型入库水量INFLOW二维数组单精度浮点型MN,TM--河道内生态编号INNEED_BH二维数组字符串INNEEDBH,INNEEDBHCOL--河道内生态数据INNEED_DATA二维数组单精度浮点型INNEEDBH,INNEEDTM--农业调度线LAGRI二维数组单精度浮点型MN,TM--工业调度线LINDUSTR二维数组单精度浮点型MN,TM--生活调度线LLIFE二维数组单精度浮点型MN,TM--初始蓄水量VBEG二维数组单精度浮点型MN,RETAIN--最大蓄水量VMAX二维数组单精度浮点型MN,TM--表1.2-3输入数据_单元类数据字段名称英文名称数据结构数据类型维度排序单位默认值备注年份YEAR单值整型单元数量维度MN维度整型时间维度TM维度整型再生水利用维度ATTR维度整型农业供水量AGRICULT二维数组单精度浮点型MN,TM--深层地下水开采参数AQUIFAV二维数组单精度浮点型MN,TM--引提水利用系数CEXTRACT二维数组单精度浮点型MN,TM--城镇生活需水量CITYLIFE二维数组单精度浮点型MN,TM--河网水利用系数CNETUSE二维数组单精度浮点型MN,TM--浅层地下水可开采量GWAV二维数组单精度浮点型MN,TM--工业需水量INDUSTRY二维数组单精度浮点型MN,TM--城镇生态需水量MINECO二维数组单精度浮点型MN,TM--农村生态需水量RURALECO二维数组单精度浮点型MN,TM--农村生活需水量RURALIFE二维数组单精度浮点型MN,TM--再生水利用系数SEWAGE二维数组单精度浮点型MN,ATTR--地表水资源量UNITSURF二维数组单精度浮点型MN,TM--表1.2-4输出数据_供水管道供水量字段名称英文名称数据结构数据类型维度排序单位默认值备注类型维度TYPE维度整型渠道数量维度MN维度整型时间维度TM维度整型洪水渠道供水量SPLCANDATA三维数组单精度浮点型MN,TYPE,TM--表1.2-5输出数据_水库水量平衡数据字段名称英文名称数据结构数据类型维度排序单位默认值备注类型维度TYPE维度整型渠道数量维度MN维度整型时间维度TM维度整型水库水量平衡数据RESERVDATA三维数组单精度浮点型MN,TYPE,TM--表1.2-6输出数据_单元数据字段名称英文名称数据结构数据类型维度排序单位默认值备注类型维度TYPE维度整型单元数量维度MN维度整型时间维度TM维度整型农业供水量AGRICULTDATAN维数组单精度浮点型MN,TYPE,TM--生活供水量CITYLIFEDATAN维数组单精度浮点型MN,TYPE,TM--农村生态供水量ECOSYSDATAN维数组单精度浮点型MN,TYPE,TM--工业供水量INDUSTRYDATAN维数组单精度浮点型MN,TYPE,TM--城镇生态供水量MINECODATAN维数组单精度浮点型MN,TYPE,TM--农村生活供水量RURALIFEDATAN维数组单精度浮点型MN,TYPE,TM--（3）调水工程调度模型表1.3-1输入数据_控制参数字段名称英文名称数据结构数据类型维度排序单位默认值备注开始时间BGTM单值字符串结束时间EDTM单值字符串启调水位WATER_LEVEL单值字符串表1.3-2输入数据_汇水区来水数据字段名称英文名称数据结构数据类型维度排序单位默认值备注月份MONTH一维数组整型TM径流数据RUNOFF一维数组双精度浮点型TM时间维度TM维度整型所属水库BASE单值字符串表1.3-3输入数据_用水单元需水数据字段名称英文名称数据结构数据类型维度排序单位默认值备注生活用水量DOMESTIC_WATER二维数组双精度浮点型UNIT,TM农业用水量AGRICULTURAL_WATER二维数组双精度浮点型UNIT,TM--工业用水量INDUSTRIAL_WATER二维数组双精度浮点型UNIT,TM--生态用水量ECOLOGICAL_WATER二维数组双精度浮点型UNIT,TM--时间维度TM维度整型用水单元数量UNIT维度整型表1.3-4输出数据_主要断面过流数据字段名称英文名称数据结构数据类型维度排序单位默认值备注断面DM一维数组字符串NUM数据类型编号BH一维数组整型SECTION时间数据TMDATAN维数组整型NUM,TM,YMDHMS断面过流数据DATAN维数组双精度浮点型NUM,TM,SECTION断面数量维度NUM维度整型数据类型维度SECTION维度整型年月日时分秒维度YMDHMS维度整型时间维度TM维度整型表1.3-5输出数据_用水区逐月取水量字段名称英文名称数据结构数据类型维度排序单位默认值备注断面DM一维数组字符串NUM数据类型编号BH一维数组整型SECTION时间数据TMDATAN维数组整型NUM,TM,YMDHMS断面过流数据DATAN维数组双精度浮点型NUM,TM,SECTION断面数量维度NUM维度整型数据类型维度SECTION维度整型年月日时分秒维度YMDHMS维度整型时间维度TM维度整型模型封装根据程序语言的不同，需要参评单位在Linux系统下将模型程序制作为动态链接库（.so文件）、可执行程序（.o文件）或jar包，推荐模型提供方将模型封装为动态链接库（.so文件）或jar包。程序封装的主要操作步骤包括构建Linux操作环境、动态链接库（.so文件）等的封装制作、封装模型测试等环节，适配时将提供更为详细的说明或视频教程。二、业务网操作线上注册需要在水利业务网环境下进行部分操作，完成模型接口改造和封装后，注册登记等环节也可由模型评价组织方工作人员代为处理。具体流程如下：模型镜像推送对于完成模型输入输出结构标准化以及模型封装的用户，可进一步参考《水利部harbor私有镜像库使用指南》开展模型镜像的推送。注册信息登记点击审核通过的报名场次的“进入”，再点击“模型适配”，跳转至模型注册的页面图1模型适配图2模型适配-模型注册信息登记在线测试按要求完成注册信息登记之后，开展模型线上测试。点击模型组件管理列表内自己所注册的模型后方“操