Class phy_ground
In: physics/phy_ground.f90

海面温度 (SST), 地表面諸量の設定

Configure sea surface temperature (SST), and various values on surface

Note that Japanese and English are described in parallel.

海面温度や地表面諸量の設定を行います. NAMELIST ファイルを利用することで NetCDF ファイルから データを読み込むことも可能です.

Sea surface temperature (SST), and various values on surface are configured. Using NAMELIST file, data can be loaded from NetCDF files.

Procedures List

Create :PHYGRD 型変数の初期設定
Get :海面温度 (SST), 地表面諸量の取得
Close :PHYGRD 型変数の終了処理
PutLine :PHYGRD 型変数に格納されている情報の印字
initialized :PHYGRD 型変数が初期設定されているか否か
———— :————
Create :Constructor of "PHYGRD"
Get :Get sea surface temperature (SST), and various values on surface
Close :Deconstructor of "PHYGRD"
PutLine :Print information of "PHYGRD"
initialized :Check initialization of "PHYGRD"

Usage

始めに, PHYGRD 型の変数を定義し, Create で初期設定を行います. 海面温度 (SST), 地表面諸量の取得には Get を用いてください. PHYGRD 型の変数の終了処理には Close を用いてください.

First, initialize "PHYGRD" by "Create". Use "Get" in order to get sea surface temperature (SST), and various values on surface. In order to terminate "PHYGRD", use "Close".

Methods

Included Modules

dc_types dc_trace dc_present dc_message dc_error gt4_history dc_string dc_iounit

Public Instance methods

Close( phy_grd, [err] )
Subroutine :
phy_grd :type(PHYGRD), intent(inout)
err :logical, intent(out), optional
: 例外処理用フラグ. デフォルトでは, この手続き内でエラーが 生じた場合, プログラムは強制終了します. 引数 err が与えられる場合, プログラムは強制終了せず, 代わりに err に .true. が代入されます.

Exception handling flag. By default, when error occur in this procedure, the program aborts. If this err argument is given, .true. is substituted to err and the program does not abort.

PHYGRD 型の変数の終了処理を行います. なお, 与えられた phy_grdCreate によって初期設定 されていない場合, プログラムはエラーを発生させます.

Deconstructor of "PHYGRD". Note that if phy_grd is not initialized by "Create" yet, error is occurred.

Alias for PhyGroundClose

Create( phy_grd, imax, jmax, [SurfTemp], [SurfAlbedo], [SurfHumidCoeff], [SurfRoughLength], [SurfHeatCapacity], [GroundTempFlux], [SurfCondition], [ground_nc], [SurfTemp_varname], [SurfAlbedo_varname], [SurfHumidCoeff_varname], [SurfRoughLength_varname], [SurfHeatCapacity_varname], [GroundTempFlux_varname], [SurfCondition_varname], [nmlfile], [err] )
Subroutine :
phy_grd :type(PHYGRD), intent(inout)
imax :integer, intent(in)
: 経度格子点数. Number of grid points in longitude
jmax :integer, intent(in)
: 緯度格子点数. Number of grid points in latitude
SurfTemp :real(DP), intent(in), optional
: 地表面温度. Surface temperature
SurfAlbedo :real(DP), intent(in), optional
: 地表アルベド. Surface albedo
SurfHumidCoeff :real(DP), intent(in), optional
: 地表湿潤度. Surface humidity coefficient
SurfRoughLength :real(DP), intent(in), optional
: 地表粗度長. Surface rough length
SurfHeatCapacity :real(DP), intent(in), optional
: 地表熱容量. Surface heat capacity
GroundTempFlux :real(DP), intent(in), optional
: 地中熱フラックス. Ground temperature flux
SurfCondition :integer, intent(in), optional
: 地表状態. Surface condition
ground_nc :character(*), intent(in), optional
: 海面温度 (SST), 地表面諸量データ が格納された NetCDF ファイル名. NetCDF filename in which sea surface temperature (SST), and various values on surface Data are stored.
SurfTemp_varname :character(*), intent(in), optional
: 地表面温度の変数名. Variable name of surface temperature
SurfAlbedo_varname :character(*), intent(in), optional
: 地表アルベドの変数名. Variable name of surface albedo
SurfHumidCoeff_varname :character(*), intent(in), optional
: 地表湿潤度の変数名. Variable name of surface humidity coefficient
SurfRoughLength_varname :character(*), intent(in), optional
: 地表粗度長の変数名. Variable name of surface rough length
SurfHeatCapacity_varname :character(*), intent(in), optional
: 地表熱容量の変数名. Variable name of surface heat capacity
GroundTempFlux_varname :character(*), intent(in), optional
: 地中熱フラックスの変数名. Variable name of ground temperature flux
SurfCondition_varname :character(*), intent(in), optional
: 地表状態の変数名. Variable name of surface condition
nmlfile :character(*), intent(in), optional
: NAMELIST ファイルの名称. この引数に空文字以外を与えた場合, 指定されたファイルから NAMELIST 変数群を読み込みます. ファイルを読み込めない場合にはエラーを 生じます.

NAMELIST 変数群の詳細に関しては NAMELIST#phy_ground_nml を参照してください.

NAMELIST file name. If nonnull character is specified to this argument, NAMELIST group name is loaded from the file. If the file can not be read, an error occurs.

See "NAMELIST#phy_ground_nml" for details about a NAMELIST group.

err :logical, intent(out), optional
: 例外処理用フラグ. デフォルトでは, この手続き内でエラーが 生じた場合, プログラムは強制終了します. 引数 err が与えられる場合, プログラムは強制終了せず, 代わりに err に .true. が代入されます.

Exception handling flag. By default, when error occur in this procedure, the program aborts. If this err argument is given, .true. is substituted to err and the program does not abort.

PHYGRD 型の変数の初期設定を行います. 他のサブルーチンを使用する前に必ずこのサブルーチンによって PHYGRD 型の変数を初期設定してください.

引数 SurfTemp, SurfAlbedo, SurfHumidCoeff, SurfRoughLength, SurfHeatCapacity, GroundTempFlux, SurfCondition を与えることで, 地表に関するパラメータを全球一様で設定できます. 非一様な分布を与えたい場合, NetCDF ファイルからデータを与える ことになります. ファイル名を ground_nc に, 変数名を SurfTemp_varname, SurfAlbedo_varname, SurfHumidCoeff_varname, SurfRoughLength_varname, SurfHeatCapacity_varname, GroundTempFlux_varname, SurfCondition_varname に与えてください. ファイル名や変数名は NAMELIST ファイル nmlfile 内で指定することも可能です. その場合は nmlfileNAMELIST ファイルを指定してください. ファイル名や変数名を指定する NAMELIST 変数に関しては, NAMELIST#phy_ground_nml を参照してください.

なお, 与えられた phy_grd が既に初期設定されている場合, プログラムはエラーを発生させます.

Constructor of "PHYGRD". Initialize phy_grd by this subroutine, before other procedures are used,

Homogeneous global surface parameters can be specified with arguments SurfTemp, SurfAlbedo, SurfHumidCoeff, SurfRoughLength, SurfHeatCapacity, GroundTempFlux, SurfCondition. If inhomogeneous profile is needed, input data from NetCDF files. Give the filename to ground_nc, and the variable names to SurfTemp_varname, SurfAlbedo_varname, SurfHumidCoeff_varname, SurfRoughLength_varname, SurfHeatCapacity_varname, GroundTempFlux_varname, SurfCondition_varname. The filename and the variable names can be specified from NAMELIST file nmlfile. In this case, give nmlfile. See NAMELIST#phy_ground_nml about NAMELIST variables for filename and variable names.

Note that if phy_grd is already initialized by this procedure, error is occurred.

Alias for PhyGroundCreate

Get( phy_grd, [xy_SurfTemp], [xy_SurfAlbedo], [xy_SurfHumidCoeff], [xy_SurfRoughLength], [xy_SurfHeatCapacity], [xy_GroundTempFlux], [xy_SurfCondition], [err] )
Subroutine :
phy_grd :type(PHYGRD), intent(inout)
xy_SurfTemp(0:phy_grd%imax-1, 0:phy_grd%jmax-1) :real(DP), intent(out), optional
: 地表面温度. Surface temperature
xy_SurfAlbedo(0:phy_grd%imax-1, 0:phy_grd%jmax-1) :real(DP), intent(out), optional
: 地表アルベド. Surface albedo
xy_SurfHumidCoeff(0:phy_grd%imax-1, 0:phy_grd%jmax-1) :real(DP), intent(out), optional
: 地表湿潤度. Surface humidity coefficient
xy_SurfRoughLength(0:phy_grd%imax-1, 0:phy_grd%jmax-1) :real(DP), intent(out), optional
: 地表粗度長. Surface rough length
xy_SurfHeatCapacity(0:phy_grd%imax-1, 0:phy_grd%jmax-1) :real(DP), intent(out), optional
: 地表熱容量. Surface heat capacity
xy_GroundTempFlux(0:phy_grd%imax-1, 0:phy_grd%jmax-1) :real(DP), intent(out), optional
: 地中熱フラックス. Ground temperature flux
xy_SurfCondition(0:phy_grd%imax-1, 0:phy_grd%jmax-1) :integer, intent(out), optional
: 地表状態. Surface condition
err :logical, intent(out), optional
: 例外処理用フラグ. デフォルトでは, この手続き内でエラーが 生じた場合, プログラムは強制終了します. 引数 err が与えられる場合, プログラムは強制終了せず, 代わりに err に .true. が代入されます.

Exception handling flag. By default, when error occur in this procedure, the program aborts. If this err argument is given, .true. is substituted to err and the program does not abort.

地表面諸量を取得します.

なお, 与えられた phy_grdCreate によって初期設定 されていない場合, プログラムはエラーを発生させます.

Get various values on surface.

If phy_grd is not initialized by "Create" yet, error is occurred.

Alias for PhyGroundGet

PHYGRD
Derived Type :
initialized = .false. :logical
: 初期設定フラグ. Initialization flag
imax :integer
: 経度格子点数. Number of grid points in longitude
jmax :integer
: 緯度格子点数. Number of grid points in latitude
 入力用データファイル名
 Data filename for input
ground_nc = ’’ :character(STRING)
: 海面温度 (SST), 地表面諸量データ が格納された NetCDF ファイル名. NetCDF filename in which sea surface temperature (SST), and various values on surface Data are stored.
xy_SurfTemp(:,:) =>null() :real(DP), pointer
: 地表面温度. Surface temperature
xy_SurfAlbedo(:,:) =>null() :real(DP), pointer
: 地表アルベド. Surface albedo
xy_SurfHumidCoeff(:,:) =>null() :real(DP), pointer
: 地表湿潤度. Surface humidity coefficient
xy_SurfRoughLength(:,:) =>null() :real(DP), pointer
: 地表粗度長. Surface rough length
xy_SurfHeatCapacity(:,:) =>null() :real(DP), pointer
: 地表熱容量. Surface heat capacity
xy_GroundTempFlux(:,:) =>null() :real(DP), pointer
: 地中熱フラックス. Ground temperature flux
xy_SurfCondition(:,:) =>null() :integer, pointer
: 地表状態. Surface condition
SurfTemp_varname = ’’ :character(TOKEN)
: 地表面温度の変数名. Variable name of surface temperature
SurfAlbedo_varname = ’’ :character(TOKEN)
: 地表アルベドの変数名. Variable name of surface albedo
SurfHumidCoeff_varname = ’’ :character(TOKEN)
: 地表湿潤度の変数名. Variable name of surface humidity coefficient
SurfRoughLength_varname = ’’ :character(TOKEN)
: 地表粗度長の変数名. Variable name of surface rough length
SurfHeatCapacity_varname = ’’ :character(TOKEN)
: 地表熱容量の変数名. Variable name of surface heat capacity
GroundTempFlux_varname = ’’ :character(TOKEN)
: 地中熱フラックスの変数名. Variable name of ground temperature flux
SurfCondition_varname = ’’ :character(TOKEN)
: 地表状態の変数名. Variable name of surface condition

まず, Create で "PHYGRD" 型の変数を初期設定して下さい. 初期設定された "PHYGRD" 型の変数を再度利用する際には, Close によって終了処理を行ってください.

Initialize "PHYGRD" variable by "Create" before usage. If you reuse "PHYGRD" variable again for another application, terminate by "Close".

PutLine( phy_grd, [unit], [indent], [err] )
Subroutine :
phy_grd :type(PHYGRD), intent(in)
unit :integer, intent(in), optional
: 出力先の装置番号. デフォルトの出力先は標準出力.

Unit number for output. Default value is standard output.

indent :character(*), intent(in), optional
: 表示されるメッセージの字下げ.

Indent of displayed messages.

err :logical, intent(out), optional
: 例外処理用フラグ. デフォルトでは, この手続き内でエラーが 生じた場合, プログラムは強制終了します. 引数 err が与えられる場合, プログラムは強制終了せず, 代わりに err に .true. が代入されます.

Exception handling flag. By default, when error occur in this procedure, the program aborts. If this err argument is given, .true. is substituted to err and the program does not abort.

引数 phy_grd に設定されている情報を印字します. デフォルトではメッセージは標準出力に出力されます. unit に装置番号を指定することで, 出力先を変更することが可能です.

Print information of phy_grd. By default messages are output to standard output. Unit number for output can be changed by unit argument.

Alias for PhyGroundPutLine

initialized( phy_grd ) result(result)
Function :
result :logical
phy_grd :type(PHYGRD), intent(in)

phy_grd が初期設定されている場合には .true. が, 初期設定されていない場合には .false. が返ります.

If phy_grd is initialized, .true. is returned. If phy_grd is not initialized, .false. is returned.

Alias for PhyGroundInitialized

Private Instance methods

NmlRead( nmlfile, ground_nc_, SurfTemp_varname_, SurfAlbedo_varname_, SurfHumidCoeff_varname_, SurfRoughLength_varname_, SurfHeatCapacity_varname_, GroundTempFlux_varname_, SurfCondition_varname_, [err] )
Subroutine :
nmlfile :character(*), intent(in)
: NAMELIST ファイルの名称. NAMELIST file name
ground_nc_ :character(*), intent(inout)
SurfTemp_varname_ :character(*), intent(inout)
SurfAlbedo_varname_ :character(*), intent(inout)
SurfHumidCoeff_varname_ :character(*), intent(inout)
SurfRoughLength_varname_ :character(*), intent(inout)
SurfHeatCapacity_varname_ :character(*), intent(inout)
GroundTempFlux_varname_ :character(*), intent(inout)
SurfCondition_varname_ :character(*), intent(inout)
err :logical, intent(out), optional
: 例外処理用フラグ. デフォルトでは, この手続き内でエラーが 生じた場合, プログラムは強制終了します. 引数 err が与えられる場合, プログラムは強制終了せず, 代わりに err に .true. が代入されます.

Exception handling flag. By default, when error occur in this procedure, the program aborts. If this err argument is given, .true. is substituted to err and the program does not abort.

NAMELIST ファイル nmlfile から値を入力するための 内部サブルーチンです. Create 内で呼び出されることを 想定しています.

値が NAMELIST ファイル内で指定されていない場合には, 入力された値がそのまま返ります.

なお, nmlfile に空文字が与えられた場合, または 与えられた nmlfile を読み込むことができない場合, プログラムはエラーを発生させます.

This is an internal subroutine to input values from NAMELIST file nmlfile. This subroutine is expected to be called by "Create".

A value not specified in NAMELIST file is returned without change.

If nmlfile is empty, or nmlfile can not be read, error is occurred.

This procedure input/output NAMELIST#phy_ground_nml .

Alias for PhyGroundNmlRead

Subroutine :
phy_grd :type(PHYGRD), intent(inout)
err :logical, intent(out), optional
: 例外処理用フラグ. デフォルトでは, この手続き内でエラーが 生じた場合, プログラムは強制終了します. 引数 err が与えられる場合, プログラムは強制終了せず, 代わりに err に .true. が代入されます.

Exception handling flag. By default, when error occur in this procedure, the program aborts. If this err argument is given, .true. is substituted to err and the program does not abort.

PHYGRD 型の変数の終了処理を行います. なお, 与えられた phy_grdCreate によって初期設定 されていない場合, プログラムはエラーを発生させます.

Deconstructor of "PHYGRD". Note that if phy_grd is not initialized by "Create" yet, error is occurred.

[Source]

  subroutine PhyGroundClose( phy_grd, err )
    !
    ! PHYGRD 型の変数の終了処理を行います.
    ! なお, 与えられた *phy_grd* が Create によって初期設定
    ! されていない場合, プログラムはエラーを発生させます.
    !
    ! Deconstructor of "PHYGRD".
    ! Note that if *phy_grd* is not initialized by "Create" yet,
    ! error is occurred.
    !
    use dc_trace, only: BeginSub, EndSub
    use dc_types, only: DP, STRING, TOKEN, STDOUT
    use dc_error, only: StoreError, DC_NOERR, DC_ENOTINIT
    implicit none
    type(PHYGRD), intent(inout):: phy_grd
    logical, intent(out), optional:: err
                              ! 例外処理用フラグ.
                              ! デフォルトでは, この手続き内でエラーが
                              ! 生じた場合, プログラムは強制終了します.
                              ! 引数 *err* が与えられる場合,
                              ! プログラムは強制終了せず, 代わりに
                              ! *err* に .true. が代入されます.
                              !
                              ! Exception handling flag. 
                              ! By default, when error occur in 
                              ! this procedure, the program aborts. 
                              ! If this *err* argument is given, 
                              ! .true. is substituted to *err* and 
                              ! the program does not abort. 

    !-----------------------------------
    !  作業変数
    !  Work variables
    integer:: stat
    character(STRING):: cause_c
    character(*), parameter:: subname = 'PhyGroundClose'
  continue
    call BeginSub( subname )
    stat = DC_NOERR
    cause_c = ''

    !-----------------------------------------------------------------
    !  初期設定のチェック
    !  Check initialization
    !-----------------------------------------------------------------
    if ( .not. phy_grd % initialized ) then
      stat = DC_ENOTINIT
      cause_c = 'PHYGRD'
      goto 999
    end if

    !-----------------------------------------------------------------
    !  "PHYGRD" の設定の消去
    !  Clear the settings for "PHYGRD"
    !-----------------------------------------------------------------


    !-----------------------------------------------------------------
    !  終了処理, 例外処理
    !  Termination and Exception handling
    !-----------------------------------------------------------------
    phy_grd % initialized = .false.
999 continue
    call StoreError( stat, subname, err, cause_c )
    call EndSub( subname )
  end subroutine PhyGroundClose
Subroutine :
phy_grd :type(PHYGRD), intent(inout)
imax :integer, intent(in)
: 経度格子点数. Number of grid points in longitude
jmax :integer, intent(in)
: 緯度格子点数. Number of grid points in latitude
SurfTemp :real(DP), intent(in), optional
: 地表面温度. Surface temperature
SurfAlbedo :real(DP), intent(in), optional
: 地表アルベド. Surface albedo
SurfHumidCoeff :real(DP), intent(in), optional
: 地表湿潤度. Surface humidity coefficient
SurfRoughLength :real(DP), intent(in), optional
: 地表粗度長. Surface rough length
SurfHeatCapacity :real(DP), intent(in), optional
: 地表熱容量. Surface heat capacity
GroundTempFlux :real(DP), intent(in), optional
: 地中熱フラックス. Ground temperature flux
SurfCondition :integer, intent(in), optional
: 地表状態. Surface condition
ground_nc :character(*), intent(in), optional
: 海面温度 (SST), 地表面諸量データ が格納された NetCDF ファイル名. NetCDF filename in which sea surface temperature (SST), and various values on surface Data are stored.
SurfTemp_varname :character(*), intent(in), optional
: 地表面温度の変数名. Variable name of surface temperature
SurfAlbedo_varname :character(*), intent(in), optional
: 地表アルベドの変数名. Variable name of surface albedo
SurfHumidCoeff_varname :character(*), intent(in), optional
: 地表湿潤度の変数名. Variable name of surface humidity coefficient
SurfRoughLength_varname :character(*), intent(in), optional
: 地表粗度長の変数名. Variable name of surface rough length
SurfHeatCapacity_varname :character(*), intent(in), optional
: 地表熱容量の変数名. Variable name of surface heat capacity
GroundTempFlux_varname :character(*), intent(in), optional
: 地中熱フラックスの変数名. Variable name of ground temperature flux
SurfCondition_varname :character(*), intent(in), optional
: 地表状態の変数名. Variable name of surface condition
nmlfile :character(*), intent(in), optional
: NAMELIST ファイルの名称. この引数に空文字以外を与えた場合, 指定されたファイルから NAMELIST 変数群を読み込みます. ファイルを読み込めない場合にはエラーを 生じます.

NAMELIST 変数群の詳細に関しては NAMELIST#phy_ground_nml を参照してください.

NAMELIST file name. If nonnull character is specified to this argument, NAMELIST group name is loaded from the file. If the file can not be read, an error occurs.

See "NAMELIST#phy_ground_nml" for details about a NAMELIST group.

err :logical, intent(out), optional
: 例外処理用フラグ. デフォルトでは, この手続き内でエラーが 生じた場合, プログラムは強制終了します. 引数 err が与えられる場合, プログラムは強制終了せず, 代わりに err に .true. が代入されます.

Exception handling flag. By default, when error occur in this procedure, the program aborts. If this err argument is given, .true. is substituted to err and the program does not abort.

PHYGRD 型の変数の初期設定を行います. 他のサブルーチンを使用する前に必ずこのサブルーチンによって PHYGRD 型の変数を初期設定してください.

引数 SurfTemp, SurfAlbedo, SurfHumidCoeff, SurfRoughLength, SurfHeatCapacity, GroundTempFlux, SurfCondition を与えることで, 地表に関するパラメータを全球一様で設定できます. 非一様な分布を与えたい場合, NetCDF ファイルからデータを与える ことになります. ファイル名を ground_nc に, 変数名を SurfTemp_varname, SurfAlbedo_varname, SurfHumidCoeff_varname, SurfRoughLength_varname, SurfHeatCapacity_varname, GroundTempFlux_varname, SurfCondition_varname に与えてください. ファイル名や変数名は NAMELIST ファイル nmlfile 内で指定することも可能です. その場合は nmlfileNAMELIST ファイルを指定してください. ファイル名や変数名を指定する NAMELIST 変数に関しては, NAMELIST#phy_ground_nml を参照してください.

なお, 与えられた phy_grd が既に初期設定されている場合, プログラムはエラーを発生させます.

Constructor of "PHYGRD". Initialize phy_grd by this subroutine, before other procedures are used,

Homogeneous global surface parameters can be specified with arguments SurfTemp, SurfAlbedo, SurfHumidCoeff, SurfRoughLength, SurfHeatCapacity, GroundTempFlux, SurfCondition. If inhomogeneous profile is needed, input data from NetCDF files. Give the filename to ground_nc, and the variable names to SurfTemp_varname, SurfAlbedo_varname, SurfHumidCoeff_varname, SurfRoughLength_varname, SurfHeatCapacity_varname, GroundTempFlux_varname, SurfCondition_varname. The filename and the variable names can be specified from NAMELIST file nmlfile. In this case, give nmlfile. See NAMELIST#phy_ground_nml about NAMELIST variables for filename and variable names.

Note that if phy_grd is already initialized by this procedure, error is occurred.

[Source]

  subroutine PhyGroundCreate( phy_grd, imax, jmax, SurfTemp, SurfAlbedo, SurfHumidCoeff, SurfRoughLength, SurfHeatCapacity, GroundTempFlux, SurfCondition, ground_nc, SurfTemp_varname, SurfAlbedo_varname, SurfHumidCoeff_varname, SurfRoughLength_varname, SurfHeatCapacity_varname, GroundTempFlux_varname, SurfCondition_varname, nmlfile, err )
    !
    ! PHYGRD 型の変数の初期設定を行います.
    ! 他のサブルーチンを使用する前に必ずこのサブルーチンによって
    ! PHYGRD 型の変数を初期設定してください.
    !
    ! 引数 *SurfTemp*, *SurfAlbedo*, *SurfHumidCoeff*, *SurfRoughLength*, 
    ! *SurfHeatCapacity*, *GroundTempFlux*, *SurfCondition* を与えることで, 
    ! 地表に関するパラメータを全球一様で設定できます. 
    ! 非一様な分布を与えたい場合, NetCDF ファイルからデータを与える
    ! ことになります. ファイル名を *ground_nc* に, 変数名を 
    ! *SurfTemp_varname*, *SurfAlbedo_varname*, *SurfHumidCoeff_varname*, 
    ! *SurfRoughLength_varname*, *SurfHeatCapacity_varname*, 
    ! *GroundTempFlux_varname*, *SurfCondition_varname* に与えてください. 
    ! ファイル名や変数名は NAMELIST ファイル 
    ! *nmlfile* 内で指定することも可能です. 
    ! その場合は *nmlfile* に NAMELIST ファイルを指定してください. 
    ! ファイル名や変数名を指定する NAMELIST 変数に関しては, 
    ! NAMELIST#phy_ground_nml を参照してください.
    !
    ! なお, 与えられた *phy_grd* が既に初期設定されている場合,
    ! プログラムはエラーを発生させます.
    !
    !
    ! Constructor of "PHYGRD".
    ! Initialize *phy_grd* by this subroutine, 
    ! before other procedures are used, 
    !
    ! Homogeneous global surface parameters can be specified with
    ! arguments *SurfTemp*, *SurfAlbedo*, *SurfHumidCoeff*, *SurfRoughLength*, 
    ! *SurfHeatCapacity*, *GroundTempFlux*, *SurfCondition*.
    ! If inhomogeneous profile is needed, input data from NetCDF files.
    ! Give the filename to *ground_nc*, and the variable names to
    ! *SurfTemp_varname*, *SurfAlbedo_varname*, *SurfHumidCoeff_varname*, 
    ! *SurfRoughLength_varname*, *SurfHeatCapacity_varname*, 
    ! *GroundTempFlux_varname*, *SurfCondition_varname*.
    ! The filename and the variable names can be specified from 
    ! NAMELIST file *nmlfile*.
    ! In this case, give *nmlfile*.
    ! See NAMELIST#phy_ground_nml about NAMELIST variables for 
    ! filename and variable names.
    !
    ! Note that if *phy_grd* is already initialized 
    ! by this procedure, error is occurred.
    !
    use dc_trace, only: BeginSub, EndSub
    use dc_types, only: DP, STRING, TOKEN, STDOUT
    use dc_present, only: present_and_not_empty, present_and_true
    use dc_message, only: MessageNotify
    use dc_error, only: StoreError, DC_NOERR, DC_EALREADYINIT, DC_EARGLACK, DC_ENEGATIVE, DC_ENOFILEREAD
    use gt4_history, only: HistoryGet
    implicit none
    type(PHYGRD), intent(inout):: phy_grd
    integer, intent(in):: imax ! 経度格子点数. 
                               ! Number of grid points in longitude
    integer, intent(in):: jmax ! 緯度格子点数. 
                               ! Number of grid points in latitude
    real(DP), intent(in), optional:: SurfTemp
                              ! 地表面温度. 
                              ! Surface temperature
    real(DP), intent(in), optional:: SurfAlbedo
                              ! 地表アルベド. 
                              ! Surface albedo
    real(DP), intent(in), optional:: SurfHumidCoeff
                              ! 地表湿潤度. 
                              ! Surface humidity coefficient
    real(DP), intent(in), optional:: SurfRoughLength
                              ! 地表粗度長. 
                              ! Surface rough length
    real(DP), intent(in), optional:: SurfHeatCapacity
                              ! 地表熱容量. 
                              ! Surface heat capacity
    real(DP), intent(in), optional:: GroundTempFlux
                              ! 地中熱フラックス. 
                              ! Ground temperature flux
    integer, intent(in), optional:: SurfCondition
                              ! 地表状態. 
                              ! Surface condition
    character(*), intent(in), optional:: ground_nc
                              ! 海面温度 (SST), 地表面諸量データ
                              ! が格納された NetCDF ファイル名. 
                              ! NetCDF filename in which sea surface 
                              ! temperature (SST), 
                              ! and various values on surface Data
                              ! are stored.
    character(*), intent(in), optional:: SurfTemp_varname
                              ! 地表面温度の変数名. 
                              ! Variable name of surface temperature
    character(*), intent(in), optional:: SurfAlbedo_varname
                              ! 地表アルベドの変数名. 
                              ! Variable name of surface albedo
    character(*), intent(in), optional:: SurfHumidCoeff_varname
                              ! 地表湿潤度の変数名. 
                              ! Variable name of surface humidity coefficient
    character(*), intent(in), optional:: SurfRoughLength_varname
                              ! 地表粗度長の変数名. 
                              ! Variable name of surface rough length
    character(*), intent(in), optional:: SurfHeatCapacity_varname
                              ! 地表熱容量の変数名. 
                              ! Variable name of surface heat capacity
    character(*), intent(in), optional:: GroundTempFlux_varname
                              ! 地中熱フラックスの変数名. 
                              ! Variable name of ground temperature flux
    character(*), intent(in), optional:: SurfCondition_varname
                              ! 地表状態の変数名. 
                              ! Variable name of surface condition
    character(*), intent(in), optional :: nmlfile
                              ! NAMELIST ファイルの名称. 
                              ! この引数に空文字以外を与えた場合, 
                              ! 指定されたファイルから 
                              ! NAMELIST 変数群を読み込みます. 
                              ! ファイルを読み込めない場合にはエラーを
                              ! 生じます.
                              !
                              ! NAMELIST 変数群の詳細に関しては 
                              ! NAMELIST#phy_ground_nml 
                              ! を参照してください. 
                              !
                              ! NAMELIST file name. 
                              ! If nonnull character is specified to
                              ! this argument, 
                              ! NAMELIST group name is loaded from the 
                              ! file. 
                              ! If the file can not be read, 
                              ! an error occurs.
                              ! 
                              ! See "NAMELIST#phy_ground_nml" 
                              ! for details about a NAMELIST group.
                              ! 
    logical, intent(out), optional:: err
                              ! 例外処理用フラグ.
                              ! デフォルトでは, この手続き内でエラーが
                              ! 生じた場合, プログラムは強制終了します.
                              ! 引数 *err* が与えられる場合,
                              ! プログラムは強制終了せず, 代わりに
                              ! *err* に .true. が代入されます.
                              !
                              ! Exception handling flag. 
                              ! By default, when error occur in 
                              ! this procedure, the program aborts. 
                              ! If this *err* argument is given, 
                              ! .true. is substituted to *err* and 
                              ! the program does not abort. 

    !-----------------------------------
    !  作業変数
    !  Work variables
    integer:: stat
    character(STRING):: cause_c
    character(*), parameter:: subname = 'PhyGroundCreate'
  continue
    call BeginSub( subname, version )
    stat = DC_NOERR
    cause_c = ''

    !-----------------------------------------------------------------
    !  初期設定のチェック
    !  Check initialization
    !-----------------------------------------------------------------
    if ( phy_grd % initialized ) then
      stat = DC_EALREADYINIT
      cause_c = 'PHYGRD'
      goto 999
    end if

    !-----------------------------------------------------------------
    !  引数の正当性のチェック
    !  Validate arguments
    !-----------------------------------------------------------------
    if (imax < 1) then
      stat = DC_ENEGATIVE
      cause_c = 'imax'
      goto 999
    end if
    if (jmax < 1) then
      stat = DC_ENEGATIVE
      cause_c = 'jmax'
      goto 999
    end if

    !-----------------------------------------------------------------
    !  波数・格子点の設定
    !  Configure wave number and grid point
    !-----------------------------------------------------------------
    phy_grd % imax = imax
    phy_grd % jmax = jmax

    !-----------------------------------------------------------------
    !  "PHYGRD" の設定
    !  Configure the settings for "PHYGRD"
    !-----------------------------------------------------------------

    !-------------------------
    !  デフォルト値
    !  Default values
    phy_grd % ground_nc = ''

    allocate( phy_grd % xy_SurfTemp (0:imax-1, 0:jmax-1) )
    allocate( phy_grd % xy_SurfAlbedo (0:imax-1, 0:jmax-1) )
    allocate( phy_grd % xy_SurfHumidCoeff (0:imax-1, 0:jmax-1) )
    allocate( phy_grd % xy_SurfRoughLength (0:imax-1, 0:jmax-1) )
    allocate( phy_grd % xy_SurfHeatCapacity (0:imax-1, 0:jmax-1) )
    allocate( phy_grd % xy_GroundTempFlux (0:imax-1, 0:jmax-1) )
    allocate( phy_grd % xy_SurfCondition (0:imax-1, 0:jmax-1) )

    phy_grd % xy_SurfTemp         = 273.0_DP
    phy_grd % xy_SurfAlbedo       = 0.3_DP
    phy_grd % xy_SurfHumidCoeff   = 0.0_DP
    phy_grd % xy_SurfRoughLength  = 0.0_DP
    phy_grd % xy_SurfHeatCapacity = 0.0_DP
    phy_grd % xy_GroundTempFlux   = 0.0_DP
    phy_grd % xy_SurfCondition    = 0.0_DP

    phy_grd % SurfTemp_varname         = ''
    phy_grd % SurfAlbedo_varname       = ''
    phy_grd % SurfHumidCoeff_varname   = ''
    phy_grd % SurfRoughLength_varname  = ''
    phy_grd % SurfHeatCapacity_varname = ''
    phy_grd % GroundTempFlux_varname   = ''
    phy_grd % SurfCondition_varname    = ''

    !-------------------------
    !  オプショナル引数からの値
    !  Values from optional arguments
    if ( present(ground_nc) )  phy_grd % ground_nc = ground_nc

    if ( present(SurfTemp        ) ) phy_grd % xy_SurfTemp         = SurfTemp
    if ( present(SurfAlbedo      ) ) phy_grd % xy_SurfAlbedo       = SurfAlbedo
    if ( present(SurfHumidCoeff  ) ) phy_grd % xy_SurfHumidCoeff   = SurfHumidCoeff
    if ( present(SurfRoughLength ) ) phy_grd % xy_SurfRoughLength  = SurfRoughLength
    if ( present(SurfHeatCapacity) ) phy_grd % xy_SurfHeatCapacity = SurfHeatCapacity
    if ( present(GroundTempFlux  ) ) phy_grd % xy_GroundTempFlux   = GroundTempFlux
    if ( present(SurfCondition   ) ) phy_grd % xy_SurfCondition    = SurfCondition

    if ( present(SurfTemp_varname        ) ) phy_grd % SurfTemp_varname         = SurfTemp_varname        
    if ( present(SurfAlbedo_varname      ) ) phy_grd % SurfAlbedo_varname       = SurfAlbedo_varname      
    if ( present(SurfHumidCoeff_varname  ) ) phy_grd % SurfHumidCoeff_varname   = SurfHumidCoeff_varname  
    if ( present(SurfRoughLength_varname ) ) phy_grd % SurfRoughLength_varname  = SurfRoughLength_varname 
    if ( present(SurfHeatCapacity_varname) ) phy_grd % SurfHeatCapacity_varname = SurfHeatCapacity_varname
    if ( present(GroundTempFlux_varname  ) ) phy_grd % GroundTempFlux_varname   = GroundTempFlux_varname  
    if ( present(SurfCondition_varname   ) ) phy_grd % SurfCondition_varname    = SurfCondition_varname   


    !-------------------------
    !  NAMELIST からの値
    !  Values from NAMELIST
    if ( present_and_not_empty(nmlfile) ) then
      call MessageNotify( 'M', subname, 'Loading NAMELIST file "%c" ...', c1=trim(nmlfile) )
      call NmlRead ( nmlfile = nmlfile, ground_nc_ = phy_grd % ground_nc, SurfTemp_varname_         = phy_grd % SurfTemp_varname, SurfAlbedo_varname_       = phy_grd % SurfAlbedo_varname, SurfHumidCoeff_varname_   = phy_grd % SurfHumidCoeff_varname, SurfRoughLength_varname_  = phy_grd % SurfRoughLength_varname, SurfHeatCapacity_varname_ = phy_grd % SurfHeatCapacity_varname, GroundTempFlux_varname_   = phy_grd % GroundTempFlux_varname, SurfCondition_varname_    = phy_grd % SurfCondition_varname, err = err )                            ! (out)
      if ( present_and_true(err) ) then
        call MessageNotify( 'W', subname, '"%c" can not be read.', c1=trim(nmlfile) )
        stat = DC_ENOFILEREAD
        cause_c = nmlfile
        goto 999
      end if
    end if

    if ( present_and_not_empty(phy_grd % ground_nc) ) then
      if ( present_and_not_empty(phy_grd % SurfTemp_varname) ) then
        call HistoryGet( file    = phy_grd % ground_nc, varname = phy_grd % SurfTemp_varname, array   = phy_grd % xy_SurfTemp )
      end if

      if ( present_and_not_empty(phy_grd % SurfAlbedo_varname) ) then
        call HistoryGet( file    = phy_grd % ground_nc, varname = phy_grd % SurfAlbedo_varname, array   = phy_grd % xy_SurfAlbedo )
      end if

      if ( present_and_not_empty(phy_grd % SurfHumidcoeff_varname) ) then
        call HistoryGet( file    = phy_grd % ground_nc, varname = phy_grd % SurfHumidcoeff_varname, array   = phy_grd % xy_SurfHumidcoeff )
      end if

      if ( present_and_not_empty(phy_grd % SurfRoughLength_varname) ) then
        call HistoryGet( file    = phy_grd % ground_nc, varname = phy_grd % SurfRoughLength_varname, array   = phy_grd % xy_SurfRoughLength )
      end if

      if ( present_and_not_empty(phy_grd % SurfHeatCapacity_varname) ) then
        call HistoryGet( file    = phy_grd % ground_nc, varname = phy_grd % SurfHeatCapacity_varname, array   = phy_grd % xy_SurfHeatCapacity )
      end if

      if ( present_and_not_empty(phy_grd % GroundTempFlux_varname) ) then
        call HistoryGet( file    = phy_grd % ground_nc, varname = phy_grd % GroundTempFlux_varname, array   = phy_grd % xy_GroundTempFlux )
      end if

      if ( present_and_not_empty(phy_grd % SurfCondition_varname) ) then
        call HistoryGet( file    = phy_grd % ground_nc, varname = phy_grd % SurfCondition_varname, array   = phy_grd % xy_SurfCondition )
      end if

    end if

    !-----------------------------------------------------------------
    !  終了処理, 例外処理
    !  Termination and Exception handling
    !-----------------------------------------------------------------
    phy_grd % initialized = .true.
999 continue
    call StoreError( stat, subname, err, cause_c )
    call EndSub( subname )
  end subroutine PhyGroundCreate
Subroutine :
phy_grd :type(PHYGRD), intent(inout)
xy_SurfTemp(0:phy_grd%imax-1, 0:phy_grd%jmax-1) :real(DP), intent(out), optional
: 地表面温度. Surface temperature
xy_SurfAlbedo(0:phy_grd%imax-1, 0:phy_grd%jmax-1) :real(DP), intent(out), optional
: 地表アルベド. Surface albedo
xy_SurfHumidCoeff(0:phy_grd%imax-1, 0:phy_grd%jmax-1) :real(DP), intent(out), optional
: 地表湿潤度. Surface humidity coefficient
xy_SurfRoughLength(0:phy_grd%imax-1, 0:phy_grd%jmax-1) :real(DP), intent(out), optional
: 地表粗度長. Surface rough length
xy_SurfHeatCapacity(0:phy_grd%imax-1, 0:phy_grd%jmax-1) :real(DP), intent(out), optional
: 地表熱容量. Surface heat capacity
xy_GroundTempFlux(0:phy_grd%imax-1, 0:phy_grd%jmax-1) :real(DP), intent(out), optional
: 地中熱フラックス. Ground temperature flux
xy_SurfCondition(0:phy_grd%imax-1, 0:phy_grd%jmax-1) :integer, intent(out), optional
: 地表状態. Surface condition
err :logical, intent(out), optional
: 例外処理用フラグ. デフォルトでは, この手続き内でエラーが 生じた場合, プログラムは強制終了します. 引数 err が与えられる場合, プログラムは強制終了せず, 代わりに err に .true. が代入されます.

Exception handling flag. By default, when error occur in this procedure, the program aborts. If this err argument is given, .true. is substituted to err and the program does not abort.

地表面諸量を取得します.

なお, 与えられた phy_grdCreate によって初期設定 されていない場合, プログラムはエラーを発生させます.

Get various values on surface.

If phy_grd is not initialized by "Create" yet, error is occurred.

[Source]

  subroutine PhyGroundGet( phy_grd, xy_SurfTemp, xy_SurfAlbedo, xy_SurfHumidCoeff, xy_SurfRoughLength, xy_SurfHeatCapacity, xy_GroundTempFlux, xy_SurfCondition, err )
    !
    ! 地表面諸量を取得します.
    !
    ! なお, 与えられた *phy_grd* が Create によって初期設定
    ! されていない場合, プログラムはエラーを発生させます.
    !
    ! Get various values on surface.
    !
    ! If *phy_grd* is not initialized by "Create" yet,
    ! error is occurred.
    !
    use dc_trace, only: BeginSub, EndSub
    use dc_types, only: DP, STRING, TOKEN, STDOUT
    use dc_error, only: StoreError, DC_NOERR, DC_ENOTINIT
    implicit none
    type(PHYGRD), intent(inout):: phy_grd
    real(DP), intent(out), optional:: xy_SurfTemp (0:phy_grd%imax-1, 0:phy_grd%jmax-1)
                              ! 地表面温度. 
                              ! Surface temperature
    real(DP), intent(out), optional:: xy_SurfAlbedo (0:phy_grd%imax-1, 0:phy_grd%jmax-1)
                              ! 地表アルベド. 
                              ! Surface albedo
    real(DP), intent(out), optional:: xy_SurfHumidCoeff (0:phy_grd%imax-1, 0:phy_grd%jmax-1)
                              ! 地表湿潤度. 
                              ! Surface humidity coefficient
    real(DP), intent(out), optional:: xy_SurfRoughLength (0:phy_grd%imax-1, 0:phy_grd%jmax-1)
                              ! 地表粗度長. 
                              ! Surface rough length
    real(DP), intent(out), optional:: xy_SurfHeatCapacity (0:phy_grd%imax-1, 0:phy_grd%jmax-1)
                              ! 地表熱容量. 
                              ! Surface heat capacity
    real(DP), intent(out), optional:: xy_GroundTempFlux (0:phy_grd%imax-1, 0:phy_grd%jmax-1)
                              ! 地中熱フラックス. 
                              ! Ground temperature flux
    integer, intent(out), optional:: xy_SurfCondition (0:phy_grd%imax-1, 0:phy_grd%jmax-1)
                              ! 地表状態. 
                              ! Surface condition
    logical, intent(out), optional:: err
                              ! 例外処理用フラグ.
                              ! デフォルトでは, この手続き内でエラーが
                              ! 生じた場合, プログラムは強制終了します.
                              ! 引数 *err* が与えられる場合,
                              ! プログラムは強制終了せず, 代わりに
                              ! *err* に .true. が代入されます.
                              !
                              ! Exception handling flag. 
                              ! By default, when error occur in 
                              ! this procedure, the program aborts. 
                              ! If this *err* argument is given, 
                              ! .true. is substituted to *err* and 
                              ! the program does not abort. 

    !-----------------------------------
    !  作業変数
    !  Work variables
    integer:: stat
    character(STRING):: cause_c
    character(*), parameter:: subname = 'PhyGroundGet'
  continue
    call BeginSub( subname )
    stat = DC_NOERR
    cause_c = ''

    !-----------------------------------------------------------------
    !  初期設定のチェック
    !  Check initialization
    !-----------------------------------------------------------------
    if ( .not. phy_grd % initialized ) then
      stat = DC_ENOTINIT
      cause_c = 'PHYGRD'
      goto 999
    end if

    !-----------------------------------------------------------------
    !  *phy_grd* に格納されている設定値の取り出し
    !  Fetch setting values stored in *phy_grd*
    !-----------------------------------------------------------------
    if ( present(xy_SurfTemp        ) ) xy_SurfTemp         = phy_grd % xy_SurfTemp         
    if ( present(xy_SurfAlbedo      ) ) xy_SurfAlbedo       = phy_grd % xy_SurfAlbedo       
    if ( present(xy_SurfHumidCoeff  ) ) xy_SurfHumidCoeff   = phy_grd % xy_SurfHumidCoeff   
    if ( present(xy_SurfRoughLength ) ) xy_SurfRoughLength  = phy_grd % xy_SurfRoughLength  
    if ( present(xy_SurfHeatCapacity) ) xy_SurfHeatCapacity = phy_grd % xy_SurfHeatCapacity 
    if ( present(xy_GroundTempFlux  ) ) xy_GroundTempFlux   = phy_grd % xy_GroundTempFlux   
    if ( present(xy_SurfCondition   ) ) xy_SurfCondition    = phy_grd % xy_SurfCondition    

    !-----------------------------------------------------------------
    !  終了処理, 例外処理
    !  Termination and Exception handling
    !-----------------------------------------------------------------
999 continue
    call StoreError( stat, subname, err, cause_c )
    call EndSub( subname )
  end subroutine PhyGroundGet
Function :
result :logical
phy_grd :type(PHYGRD), intent(in)

phy_grd が初期設定されている場合には .true. が, 初期設定されていない場合には .false. が返ります.

If phy_grd is initialized, .true. is returned. If phy_grd is not initialized, .false. is returned.

[Source]

  logical function PhyGroundInitialized( phy_grd ) result(result)
    !
    ! *phy_grd* が初期設定されている場合には .true. が,
    ! 初期設定されていない場合には .false. が返ります.
    !
    ! If *phy_grd* is initialized, .true. is returned.
    ! If *phy_grd* is not initialized, .false. is returned.
    !
    implicit none
    type(PHYGRD), intent(in):: phy_grd
  continue
    result = phy_grd % initialized
  end function PhyGroundInitialized
Subroutine :
nmlfile :character(*), intent(in)
: NAMELIST ファイルの名称. NAMELIST file name
ground_nc_ :character(*), intent(inout)
SurfTemp_varname_ :character(*), intent(inout)
SurfAlbedo_varname_ :character(*), intent(inout)
SurfHumidCoeff_varname_ :character(*), intent(inout)
SurfRoughLength_varname_ :character(*), intent(inout)
SurfHeatCapacity_varname_ :character(*), intent(inout)
GroundTempFlux_varname_ :character(*), intent(inout)
SurfCondition_varname_ :character(*), intent(inout)
err :logical, intent(out), optional
: 例外処理用フラグ. デフォルトでは, この手続き内でエラーが 生じた場合, プログラムは強制終了します. 引数 err が与えられる場合, プログラムは強制終了せず, 代わりに err に .true. が代入されます.

Exception handling flag. By default, when error occur in this procedure, the program aborts. If this err argument is given, .true. is substituted to err and the program does not abort.

NAMELIST ファイル nmlfile から値を入力するための 内部サブルーチンです. Create 内で呼び出されることを 想定しています.

値が NAMELIST ファイル内で指定されていない場合には, 入力された値がそのまま返ります.

なお, nmlfile に空文字が与えられた場合, または 与えられた nmlfile を読み込むことができない場合, プログラムはエラーを発生させます.

This is an internal subroutine to input values from NAMELIST file nmlfile. This subroutine is expected to be called by "Create".

A value not specified in NAMELIST file is returned without change.

If nmlfile is empty, or nmlfile can not be read, error is occurred.

This procedure input/output NAMELIST#phy_ground_nml .

[Source]

  subroutine PhyGroundNmlRead( nmlfile, ground_nc_, SurfTemp_varname_, SurfAlbedo_varname_, SurfHumidCoeff_varname_, SurfRoughLength_varname_, SurfHeatCapacity_varname_, GroundTempFlux_varname_, SurfCondition_varname_, err )
    !
    ! NAMELIST ファイル *nmlfile* から値を入力するための
    ! 内部サブルーチンです. Create 内で呼び出されることを
    ! 想定しています.
    !
    ! 値が NAMELIST ファイル内で指定されていない場合には,
    ! 入力された値がそのまま返ります.
    !
    ! なお, *nmlfile* に空文字が与えられた場合, または
    ! 与えられた *nmlfile* を読み込むことができない場合, 
    ! プログラムはエラーを発生させます.
    !
    ! This is an internal subroutine to input values from 
    ! NAMELIST file *nmlfile*. This subroutine is expected to be
    ! called by "Create".
    !
    ! A value not specified in NAMELIST file is returned
    ! without change.
    !
    ! If *nmlfile* is empty, or *nmlfile* can not be read, 
    ! error is occurred.
    !
    use dc_trace, only: BeginSub, EndSub
    use dc_types, only: DP, STRING, TOKEN, STDOUT
    use dc_iounit, only: FileOpen
    use dc_message, only: MessageNotify
    use dc_present, only: present_and_true
    use dc_error, only: StoreError, DC_NOERR, DC_ENOFILEREAD
    implicit none
    character(*), intent(in):: nmlfile
                              ! NAMELIST ファイルの名称. 
                              ! NAMELIST file name
    character(*), intent(inout):: ground_nc_
    character(STRING):: ground_nc
                              ! 海面温度 (SST), 地表面諸量データ
                              ! が格納された NetCDF ファイル名. 
                              ! NetCDF filename in which sea surface 
                              ! temperature (SST), 
                              ! and various values on surface Data
                              ! are stored.
    character(*), intent(inout):: SurfTemp_varname_
    character(TOKEN):: SurfTemp_varname = ''
                              ! 地表面温度の変数名. 
                              ! Variable name of surface temperature
    character(*), intent(inout):: SurfAlbedo_varname_
    character(TOKEN):: SurfAlbedo_varname = ''
                              ! 地表アルベドの変数名. 
                              ! Variable name of surface albedo
    character(*), intent(inout):: SurfHumidCoeff_varname_
    character(TOKEN):: SurfHumidCoeff_varname = ''
                              ! 地表湿潤度の変数名. 
                              ! Variable name of surface humidity coefficient
    character(*), intent(inout):: SurfRoughLength_varname_
    character(TOKEN):: SurfRoughLength_varname = ''
                              ! 地表粗度長の変数名. 
                              ! Variable name of surface rough length
    character(*), intent(inout):: SurfHeatCapacity_varname_
    character(TOKEN):: SurfHeatCapacity_varname = ''
                              ! 地表熱容量の変数名. 
                              ! Variable name of surface heat capacity
    character(*), intent(inout):: GroundTempFlux_varname_
    character(TOKEN):: GroundTempFlux_varname = ''
                              ! 地中熱フラックスの変数名. 
                              ! Variable name of ground temperature flux
    character(*), intent(inout):: SurfCondition_varname_
    character(TOKEN):: SurfCondition_varname = ''
                              ! 地表状態の変数名. 
                              ! Variable name of surface condition
    logical, intent(out), optional:: err
                              ! 例外処理用フラグ.
                              ! デフォルトでは, この手続き内でエラーが
                              ! 生じた場合, プログラムは強制終了します.
                              ! 引数 *err* が与えられる場合,
                              ! プログラムは強制終了せず, 代わりに
                              ! *err* に .true. が代入されます.
                              !
                              ! Exception handling flag. 
                              ! By default, when error occur in 
                              ! this procedure, the program aborts. 
                              ! If this *err* argument is given, 
                              ! .true. is substituted to *err* and 
                              ! the program does not abort. 

    namelist /phy_ground_nml/ ground_nc, SurfTemp_varname, SurfAlbedo_varname, SurfHumidCoeff_varname, SurfRoughLength_varname, SurfHeatCapacity_varname, GroundTempFlux_varname, SurfCondition_varname
                              ! phy_ground モジュール用
                              ! NAMELIST 変数群名.
                              !
                              ! phy_ground#Create を使用する際に, 
                              ! オプショナル引数 *nmlfile* へ NAMELIST 
                              ! ファイル名を指定することで, そのファイルから
                              ! この NAMELIST 変数群を読み込みます.
                              !
                              ! NAMELIST group name for
                              ! "phy_ground" module.
                              ! 
                              ! If a NAMELIST filename is specified to 
                              ! an optional argument *nmlfile* 
                              ! when "phy_ground#Create" is used, 
                              ! this NAMELIST group is loaded from 
                              ! the file.

    !-----------------------------------
    !  作業変数
    !  Work variables
    integer:: stat
    character(STRING):: cause_c
    integer:: unit_nml        ! NAMELIST ファイルオープン用装置番号. 
                              ! Unit number for NAMELIST file open
    integer:: iostat_nml      ! NAMELIST 読み込み時の IOSTAT. 
                              ! IOSTAT of NAMELIST read
    character(*), parameter:: subname = 'PhyGroundNmlRead'
  continue
    call BeginSub( subname )
    stat = DC_NOERR
    cause_c = ''

    !-----------------------------------------------------------------
    !  文字型引数を NAMELIST 変数群へ代入
    !  Substitute character arguments to NAMELIST group
    !-----------------------------------------------------------------
    ground_nc = ground_nc_
    if ( .not. trim(SurfTemp_varname_) == ''         ) SurfTemp_varname         = SurfTemp_varname_
    if ( .not. trim(SurfAlbedo_varname_) == ''       ) SurfAlbedo_varname       = SurfAlbedo_varname_
    if ( .not. trim(SurfHumidCoeff_varname_) == ''   ) SurfHumidCoeff_varname   = SurfHumidCoeff_varname_
    if ( .not. trim(SurfRoughLength_varname_) == ''  ) SurfRoughLength_varname  = SurfRoughLength_varname_
    if ( .not. trim(SurfHeatCapacity_varname_) == '' ) SurfHeatCapacity_varname = SurfHeatCapacity_varname_
    if ( .not. trim(GroundTempFlux_varname_) == ''   ) GroundTempFlux_varname   = GroundTempFlux_varname_
    if ( .not. trim(SurfCondition_varname_) == ''    ) SurfCondition_varname    = SurfCondition_varname_

    !----------------------------------------------------------------
    !  NAMELIST ファイルのオープン
    !  Open NAMELIST file
    !----------------------------------------------------------------
    call FileOpen( unit = unit_nml, file = nmlfile, mode = 'r', err = err )                   ! (out)
    if ( present_and_true(err) ) then
      stat = DC_ENOFILEREAD
      cause_c = nmlfile
      goto 999
    end if


    !-----------------------------------------------------------------
    !  NAMELIST 変数群の取得
    !  Get NAMELIST group
    !-----------------------------------------------------------------
    read( unit = unit_nml, nml = phy_ground_nml, iostat = iostat_nml ) ! (out)
    if ( iostat_nml == 0 ) then
      call MessageNotify( 'M', subname, 'NAMELIST group "%c" is loaded from "%c".', c1='phy_ground_nml', c2=trim(nmlfile) )
      write(STDOUT, nml = phy_ground_nml)
    else
      call MessageNotify( 'W', subname, 'NAMELIST group "%c" is not found in "%c" (iostat=%d).', c1='phy_ground_nml', c2=trim(nmlfile), i=(/iostat_nml/) )
    end if

    close( unit_nml )

    !-----------------------------------------------------------------
    !  NAMELIST 変数群を文字型引数へ代入
    !  Substitute NAMELIST group to character arguments
    !-----------------------------------------------------------------
    ground_nc_ = ground_nc
    SurfTemp_varname_         = SurfTemp_varname
    SurfAlbedo_varname_       = SurfAlbedo_varname
    SurfHumidCoeff_varname_   = SurfHumidCoeff_varname
    SurfRoughLength_varname_  = SurfRoughLength_varname
    SurfHeatCapacity_varname_ = SurfHeatCapacity_varname
    GroundTempFlux_varname_   = GroundTempFlux_varname
    SurfCondition_varname_    = SurfCondition_varname

    !-----------------------------------------------------------------
    !  終了処理, 例外処理
    !  Termination and Exception handling
    !-----------------------------------------------------------------
999 continue
    call StoreError( stat, subname, err, cause_c )
    call EndSub( subname )
  end subroutine PhyGroundNmlRead
Subroutine :
phy_grd :type(PHYGRD), intent(in)
unit :integer, intent(in), optional
: 出力先の装置番号. デフォルトの出力先は標準出力.

Unit number for output. Default value is standard output.

indent :character(*), intent(in), optional
: 表示されるメッセージの字下げ.

Indent of displayed messages.

err :logical, intent(out), optional
: 例外処理用フラグ. デフォルトでは, この手続き内でエラーが 生じた場合, プログラムは強制終了します. 引数 err が与えられる場合, プログラムは強制終了せず, 代わりに err に .true. が代入されます.

Exception handling flag. By default, when error occur in this procedure, the program aborts. If this err argument is given, .true. is substituted to err and the program does not abort.

引数 phy_grd に設定されている情報を印字します. デフォルトではメッセージは標準出力に出力されます. unit に装置番号を指定することで, 出力先を変更することが可能です.

Print information of phy_grd. By default messages are output to standard output. Unit number for output can be changed by unit argument.

[Source]

  subroutine PhyGroundPutLine( phy_grd, unit, indent, err )
    !
    ! 引数 *phy_grd* に設定されている情報を印字します.
    ! デフォルトではメッセージは標準出力に出力されます. 
    ! *unit* に装置番号を指定することで, 出力先を変更することが可能です.
    !
    ! Print information of *phy_grd*.
    ! By default messages are output to standard output.
    ! Unit number for output can be changed by *unit* argument.
    !
    use dc_trace, only: BeginSub, EndSub
    use dc_types, only: DP, STRING, TOKEN, STDOUT
    use dc_error, only: StoreError, DC_NOERR, DC_ENOTINIT
    use dc_string, only: Printf, PutLine
    implicit none
    type(PHYGRD), intent(in):: phy_grd
    integer, intent(in), optional:: unit
                              ! 出力先の装置番号.
                              ! デフォルトの出力先は標準出力.
                              !
                              ! Unit number for output.
                              ! Default value is standard output.
    character(*), intent(in), optional:: indent
                              ! 表示されるメッセージの字下げ.
                              !
                              ! Indent of displayed messages.
    logical, intent(out), optional:: err
                              ! 例外処理用フラグ.
                              ! デフォルトでは, この手続き内でエラーが
                              ! 生じた場合, プログラムは強制終了します.
                              ! 引数 *err* が与えられる場合,
                              ! プログラムは強制終了せず, 代わりに
                              ! *err* に .true. が代入されます.
                              !
                              ! Exception handling flag. 
                              ! By default, when error occur in 
                              ! this procedure, the program aborts. 
                              ! If this *err* argument is given, 
                              ! .true. is substituted to *err* and 
                              ! the program does not abort. 

    !-----------------------------------
    !  作業変数
    !  Work variables
    integer:: stat
    character(STRING):: cause_c
    integer:: out_unit
    integer:: indent_len
    character(STRING):: indent_str
    character(*), parameter:: subname = 'PhyGroundPutLine'
  continue
    call BeginSub( subname )
    stat = DC_NOERR
    cause_c = ''

    !-----------------------------------------------------------------
    !  初期設定のチェック
    !  Check initialization
    !-----------------------------------------------------------------
    if ( present(unit) ) then
      out_unit = unit
    else
      out_unit = STDOUT
    end if

    indent_len = 0
    indent_str = ''
    if ( present(indent) ) then
      if ( len(indent) /= 0 ) then
        indent_len = len(indent)
        indent_str(1:indent_len) = indent
      end if
    end if


    !-----------------------------------------------------------------
    !  "PHYGRD" の設定の印字
    !  Print the settings for "PHYGRD"
    !-----------------------------------------------------------------
    if ( phy_grd % initialized ) then
      call Printf(out_unit, indent_str(1:indent_len) // '#<PHYGRD:: @initialized=%y', l=(/phy_grd % initialized/))

      call Printf(out_unit, indent_str(1:indent_len) // ' @imax=%d @jmax=%d', i=(/phy_grd % imax, phy_grd % jmax/) )

      call Printf(out_unit, indent_str(1:indent_len) // ' @ground_nc=%c', c1=trim(phy_grd % ground_nc) )

      call Printf(out_unit, indent_str(1:indent_len) // ' @SurfTemp_varname=%c', c1=trim(phy_grd % SurfTemp_varname) )
      call PutLine( phy_grd % xy_SurfTemp, unit = out_unit, lbounds = lbound(phy_grd % xy_SurfTemp), ubounds = ubound(phy_grd % xy_SurfTemp), indent = indent_str(1:indent_len) // ' @xy_SurfTemp=' )

      call Printf(out_unit, indent_str(1:indent_len) // ' @SurfAlbedo_varname=%c', c1=trim(phy_grd % SurfAlbedo_varname) )
      call PutLine( phy_grd % xy_SurfAlbedo, unit = out_unit, lbounds = lbound(phy_grd % xy_SurfAlbedo), ubounds = ubound(phy_grd % xy_SurfAlbedo), indent = indent_str(1:indent_len) // ' @xy_SurfAlbedo=' )

      call Printf(out_unit, indent_str(1:indent_len) // ' @SurfHumidCoeff_varname=%c', c1=trim(phy_grd % SurfHumidCoeff_varname) )
      call PutLine( phy_grd % xy_SurfHumidCoeff, unit = out_unit, lbounds = lbound(phy_grd % xy_SurfHumidCoeff), ubounds = ubound(phy_grd % xy_SurfHumidCoeff), indent = indent_str(1:indent_len) // ' @xy_SurfHumidCoeff=' )

      call Printf(out_unit, indent_str(1:indent_len) // ' @SurfRoughLength_varname=%c', c1=trim(phy_grd % SurfRoughLength_varname) )
      call PutLine( phy_grd % xy_SurfRoughLength, unit = out_unit, lbounds = lbound(phy_grd % xy_SurfRoughLength), ubounds = ubound(phy_grd % xy_SurfRoughLength), indent = indent_str(1:indent_len) // ' @xy_SurfRoughLength=' )

      call Printf(out_unit, indent_str(1:indent_len) // ' @SurfHeatCapacity_varname=%c', c1=trim(phy_grd % SurfHeatCapacity_varname) )
      call PutLine( phy_grd % xy_SurfHeatCapacity, unit = out_unit, lbounds = lbound(phy_grd % xy_SurfHeatCapacity), ubounds = ubound(phy_grd % xy_SurfHeatCapacity), indent = indent_str(1:indent_len) // ' @xy_SurfHeatCapacity=' )

      call Printf(out_unit, indent_str(1:indent_len) // ' @GroundTempFlux_varname=%c', c1=trim(phy_grd % GroundTempFlux_varname) )
      call PutLine( phy_grd % xy_GroundTempFlux, unit = out_unit, lbounds = lbound(phy_grd % xy_GroundTempFlux), ubounds = ubound(phy_grd % xy_GroundTempFlux), indent = indent_str(1:indent_len) // ' @xy_GroundTempFlux=' )

      call Printf(out_unit, indent_str(1:indent_len) // ' @SurfCondition_varname=%c', c1=trim(phy_grd % SurfCondition_varname) )
      call PutLine( phy_grd % xy_SurfCondition, unit = out_unit, lbounds = lbound(phy_grd % xy_SurfCondition), ubounds = ubound(phy_grd % xy_SurfCondition), indent = indent_str(1:indent_len) // ' @xy_SurfCondition=' )

      call Printf(out_unit, indent_str(1:indent_len) // '>' )
    else
      call Printf(out_unit, indent_str(1:indent_len) // '#<PHYGRD:: @initialized=%y>', l=(/phy_grd % initialized/))
    end if

    !-----------------------------------------------------------------
    !  終了処理, 例外処理
    !  Termination and Exception handling
    !-----------------------------------------------------------------
999 continue
    call StoreError( stat, subname, err, cause_c )
    call EndSub( subname )
  end subroutine PhyGroundPutLine
version
Constant :
version = ’$Name: dcpam4-20080609-1 $’ // ’$Id: phy_ground.f90,v 1.8 2007-10-11 03:46:20 morikawa Exp $’ :character(*), parameter

[Validate]