==========
安装手册
==========

.. toctree::
   :maxdepth: 2
   :caption: Contents:

源码的编译和运行
=======================

* 目录结构::

    > tree
    ├── da_blending.f90
    ├── namelist.blend
    ├── namelist.blend.example
    ├── raymond.f
    └── readme



编译Fortran程序

* GNU编译器::

    > gfortran -c -fdefault-real-8 raymond.f
    > gfortran -c -fdefault-real-8 -I$NETCDF/include da_blending.f90
    > gfortran -o da_blending.exe da_blending.o raymond.o   -L$NETCDF/lib -lnetcdff -lnetcdf

* INTEL编译器::

    > ifort -c -r8 -i4 raymond.f
    > ifort -c -r8 -i4 -I$NETCDF/include da_blending.f90
    > ifort -o da_blending.exe da_blending.o raymond.o   -L$NETCDF/lib -lnetcdff -lnetcdf

编译成功后生成 :code:`da_blending.exe` 文件

.. note::
    
    融合程序需要独写wrfinput和wrfout等nc格式文件，依赖netcdf库，需要提前安装好。设置环境变量NETCDF为
    netcdf的安装路径，例如：
    export NETCDF=/home/user/app/netcdf

使用方法

* namelist.blend配置文件说明::

    &param
    f_fg         = './fg'
    f_bg         = './bg'
    f_out        = 'fg_blend'
    length_scale = '1200.0,1200.0,1200.0,1200.0,1200.0,1200.0,1200.0,1200.0,1200.00,1200.0,1200.0,1200.0,1200.0'
    vNam         = 'U,V,T,QVAPOR,PH,P,MU,U10,V10,T2,Q2,PSFC,TH2'
    dbg_lev      = 1,
    /

其中，f_fg为初猜场文件，f_bg为背景场文件，f_out为融合后的场，length_scale为截断长度尺度，vNam为需要融合的变量，dbg_lev为日志等级。

* 用法::

    > ./da_blending.exe -h
    Usage : da_blending.exe[-h] [-fg filename] [-bg filename] [-o outputfile] [-v variables] [-Lx cut-off length-scale]
      -fg    Optional, first guest from last forecast
                       default - fg
      -bg    Optional, host model analysis/forecast
                       default - bg
      -o     Optional, blended first guest
                       default - fg_blend
      -v     Optional, variables list spererated by ","
                       default - U,V,T,QVAPOR,PH,P,MU,U10,V10,T2,Q2,PSFC,TH
      -Lx    Optional, individual cut-off length-scale seperated by ","
                       in km, default - 1200
      -debug Optional, debug level
                       default - 0
      -h     Show this help

:code:`-fg` 为区域模式的分析场/预报场，:code:`-bg` 为全球模式的分析场/预报场（插值到WRF网格），:code:`-o`为融合后的文件，:code:`-v`为需要融合的变量，
:code:`-Lx` 为截断长度尺度，:code:`-debug` 日志等级，:code:`-h` 帮助。

.. note::

    运行时加的参数会覆盖 :code:`namelist.blend` 里的设置。

* 举例::

    > ./da_blending.exe -fg ../var/wrfvar_output -bg ../cold-start/wrfinput_d01


业务化运行
=======================

加入到 :code:`RAP/HRRR` 快速更新同化预报系统。