Class saturate_DennouAGCM
In: saturate/saturate_DennouAGCM.f90

Dennou AGCM �����������蕋遵��罸�羚帥�����

Evaluate saturation specific humidity with method used by Dennou AGCM

Note that Japanese and English are described in parallel.

Dennou AGCM �х��������������綣������������御��с��荐�膊����障��. �������, ���� 羃弱� (1992) ����ｃ�����障��.

Saturation specific humidity and temperature derivative of it are calculated with a formula used in Dennou AGCM. This formula is originaly obtained from Numaguti (1992).

References

  • Numaguti, 1992: <title in Japanese>, Doctor thesis, University of Tokyo.

Procedures List

CalcQVapSat :蕋遵��罸�羚帥���膊�
CalcDQVapSatDTemp :蕋遵��罸�羚帥��県綺�小�����膊�
———— :————
CalcQVapSat :Calculate saturation specific humidity
CalcDQVapSatDTemp :Calculate temperature derivative of saturation specific humidity

Methods

Es0   FlagSublimation   SaturateInit   module_name   saturate_DennouAGCM_inited   version   xyz_CalcDQVapSatDTempOnLiq   xyz_CalcDQVapSatDTempOnSol   xyz_CalcQVapSatOnLiq   xyz_CalcQVapSatOnSol  

Included Modules

dc_types dc_message constants namelist_util dc_iounit dc_string gtool_historyauto

Public Instance methods

SaturateInit( )
Subroutine :

saturate_DennouAGCM �≪�吾�ャ�若������������茵����障��.

"saturate_DennouAGCM" module is initialized.

This procedure input/output NAMELIST#saturate_DennouAGCM_nml .

[Source]

  subroutine SaturateInit
    !
    ! saturate_DennouAGCM �≪�吾�ャ�若������������茵����障��. 
    !
    !
    ! "saturate_DennouAGCM" module is initialized. 
    !

    ! �≪�吾�ャ�若����� ; USE statements
    !

    ! NAMELIST ���＜�ゃ���ュ�����≪�������若���ｃ������
    ! Utilities for NAMELIST file input
    !
    use namelist_util, only: namelist_filename, NmlutilMsg

    ! ���＜�ゃ���ュ�阪��茖���
    ! File I/O support
    !
    use dc_iounit, only: FileOpen

    ! 腮��ュ�������＜��
    ! Kind type parameter
    !
    use dc_types, only: STDOUT ! 罔�羣��阪�����臀����. Unit number of standard output

    ! ��絖�����篏�
    ! Character handling
    !
    use dc_string, only: StoA

    ! ���鴻�������若�水�阪��
    ! History data output
    !
    use gtool_historyauto, only: HistoryAutoAddVariable

    ! 絎ｈ��� ; Declaration statements
    !
    implicit none

    integer:: unit_nml        ! NAMELIST ���＜�ゃ�����若���括���臀����. 
                              ! Unit number for NAMELIST file open
    integer:: iostat_nml      ! NAMELIST 茯���粋昭�炊���� IOSTAT. 
                              ! IOSTAT of NAMELIST read

    ! NAMELIST 紊��亥召
    ! NAMELIST group name
    !
    namelist /saturate_DennouAGCM_nml/ FlagSublimation
          !
          ! �����������ゃ���ゃ��������������膓� "saturate_DennouAGCM#SaturateInit" 
          ! ���純�若�鴻�潟�若�������с������. 
          !
          ! Refer to source codes in the initialization procedure
          ! "saturate_DennouAGCM#SaturateInit" for the default values. 
          !

    ! 絎�茵��� ; Executable statement
    !

    if ( saturate_DennouAGCM_inited ) return


    ! �����������ゃ��┃絎�
    ! Default values settings
    !
    FlagSublimation = .false.


    ! NAMELIST ����粋昭��
    ! NAMELIST is input
    !
    if ( trim(namelist_filename) /= '' ) then
      call FileOpen( unit_nml, namelist_filename, mode = 'r' ) ! (in)

      rewind( unit_nml )
      read( unit_nml, nml = saturate_DennouAGCM_nml, iostat = iostat_nml )   ! (out)
      close( unit_nml )

      call NmlutilMsg( iostat_nml, module_name ) ! (in)
    end if

    ! �医� ; Print
    !
    call MessageNotify( 'M', module_name, '----- Initialization Messages -----' )
    call MessageNotify( 'M', module_name, '  FlagSublimation = %b', l = (/ FlagSublimation /) )
    call MessageNotify( 'M', module_name, '-- version = %c', c1 = trim(version) )

    saturate_DennouAGCM_inited = .true.

  end subroutine SaturateInit
saturate_DennouAGCM_inited
Variable :
saturate_DennouAGCM_inited = .false. :logical, save, public
: ����荐���������. Initialization flag
xyz_CalcDQVapSatDTempOnLiq( xyz_Temp, xyz_QVapSat ) result(xyz_DQVapSatDTemp)
Function :
xyz_DQVapSatDTemp(size(xyz_Temp,1), size(xyz_Temp,2), size(xyz_Temp,3)) :real(DP)
: $ DP{q^{*}}{T} $ . 蕋遵��罸�羚帥��県綺�小��. Temperature derivative of saturation specific humidity.
xyz_Temp(:,:,:) :real(DP), intent(in)
: $ T $ . 羝�墾. Temperature
xyz_QVapSat(:,:,:) :real(DP), intent(in)
: $ q^{*} $ . 蕋遵��罸�羚�. Saturation specific humidity

羝�墾 Temp �����罸�羚� QVapSat ������, 蕋遵��罸�羚帥��県綺�小�� DQVapSatDTemp ��羆����障��.

Calculate temperature derivative of saturation specific humidity DQVapSatDTemp using temperature Temp and saturation specific humidity QVapSat.

[Source]

  function xyz_CalcDQVapSatDTempOnLiq( xyz_Temp, xyz_QVapSat ) result( xyz_DQVapSatDTemp )
    !
    ! 羝�墾 *Temp* �����罸�羚� *QVapSat* ������, 
    ! 蕋遵��罸�羚帥��県綺�小�� *DQVapSatDTemp* ��羆����障��. 
    !
    ! Calculate temperature derivative of saturation specific humidity 
    ! *DQVapSatDTemp* using
    ! temperature *Temp* and saturation specific humidity *QVapSat*. 
    !

    ! �≪�吾�ャ�若����� ; USE statements
    !

    ! ����絎��域┃絎�
    ! Physical constants settings
    !
    use constants, only: GasRWet, LatentHeat, LatentHeatFusion, EpsV                  ! $ \epsilon_v $ . 
                              ! 羂頑�御���絖��閴�. 
                              ! Molecular weight of water vapor

    ! 絎ｈ��� ; Declaration statements
    !
    implicit none

    real(DP), intent(in):: xyz_Temp   (:,:,:)
                              ! $ T $ . 羝�墾. Temperature
    real(DP), intent(in):: xyz_QVapSat(:,:,:)
                              ! $ q^{*} $ . 蕋遵��罸�羚�. Saturation specific humidity
    real(DP):: xyz_DQVapSatDTemp(size(xyz_Temp,1), size(xyz_Temp,2), size(xyz_Temp,3))
                              ! $ \DP{q^{*}}{T} $ . 蕋遵��罸�羚帥��県綺�小��. 
                              ! Temperature derivative of saturation specific humidity. 

    ! 篏�罐�����
    ! Work variables
    !
    real(DP):: LatentHeatLocal
                              !
                              ! Latent heat used in this routine


    ! 絎�茵��� ; Executable statement
    !

    if ( .not. saturate_DennouAGCM_inited ) then
      call MessageNotify( 'E', module_name, 'This module has not been initialized.' )
    end if

    ! Set a value for latent heat
    if ( FlagSublimation ) then
      LatentHeatLocal = LatentHeat + LatentHeatFusion
    else
      LatentHeatLocal = LatentHeat
    end if

    xyz_DQVapSatDTemp = LatentHeatLocal * xyz_QVapSat / ( GasRWet * xyz_Temp**2 )


  end function xyz_CalcDQVapSatDTempOnLiq
xyz_CalcDQVapSatDTempOnSol( xyz_Temp, xyz_QVapSat ) result(xyz_DQVapSatDTemp)
Function :
xyz_DQVapSatDTemp(size(xyz_Temp,1), size(xyz_Temp,2), size(xyz_Temp,3)) :real(DP)
: $ DP{q^{*}}{T} $ . 蕋遵��罸�羚帥��県綺�小��. Temperature derivative of saturation specific humidity.
xyz_Temp(:,:,:) :real(DP), intent(in)
: $ T $ . 羝�墾. Temperature
xyz_QVapSat(:,:,:) :real(DP), intent(in)
: $ q^{*} $ . 蕋遵��罸�羚�. Saturation specific humidity

羝�墾 Temp �����罸�羚� QVapSat ������, 蕋遵��罸�羚帥��県綺�小�� DQVapSatDTemp ��羆����障��.

Calculate temperature derivative of saturation specific humidity DQVapSatDTemp using temperature Temp and saturation specific humidity QVapSat.

[Source]

  function xyz_CalcDQVapSatDTempOnSol( xyz_Temp, xyz_QVapSat ) result( xyz_DQVapSatDTemp )
    !
    ! 羝�墾 *Temp* �����罸�羚� *QVapSat* ������, 
    ! 蕋遵��罸�羚帥��県綺�小�� *DQVapSatDTemp* ��羆����障��. 
    !
    ! Calculate temperature derivative of saturation specific humidity 
    ! *DQVapSatDTemp* using
    ! temperature *Temp* and saturation specific humidity *QVapSat*. 
    !

    ! �≪�吾�ャ�若����� ; USE statements
    !

    ! ����絎��域┃絎�
    ! Physical constants settings
    !
    use constants, only: GasRWet, LatentHeat, LatentHeatFusion, EpsV                  ! $ \epsilon_v $ . 
                              ! 羂頑�御���絖��閴�. 
                              ! Molecular weight of water vapor

    ! 絎ｈ��� ; Declaration statements
    !
    implicit none

    real(DP), intent(in):: xyz_Temp   (:,:,:)
                              ! $ T $ . 羝�墾. Temperature
    real(DP), intent(in):: xyz_QVapSat(:,:,:)
                              ! $ q^{*} $ . 蕋遵��罸�羚�. Saturation specific humidity
    real(DP):: xyz_DQVapSatDTemp(size(xyz_Temp,1), size(xyz_Temp,2), size(xyz_Temp,3))
                              ! $ \DP{q^{*}}{T} $ . 蕋遵��罸�羚帥��県綺�小��. 
                              ! Temperature derivative of saturation specific humidity. 

    ! 篏�罐�����
    ! Work variables
    !
    real(DP):: LatentHeatLocal
                              !
                              ! Latent heat used in this routine


    ! 絎�茵��� ; Executable statement
    !

    if ( .not. saturate_DennouAGCM_inited ) then
      call MessageNotify( 'E', module_name, 'This module has not been initialized.' )
    end if

    ! Set a value for latent heat
    LatentHeatLocal = LatentHeat + LatentHeatFusion

    xyz_DQVapSatDTemp = LatentHeatLocal * xyz_QVapSat / ( GasRWet * xyz_Temp**2 )


  end function xyz_CalcDQVapSatDTempOnSol
xyz_CalcQVapSatOnLiq( xyz_Temp, xyz_Press ) result(xyz_QVapSat)
Function :
xyz_QVapSat(1:size(xyz_Temp,1), 1:size(xyz_Temp,2), 1:size(xyz_Temp,3)) :real(DP)
: $ q^{*} $ . 蕋遵��罸�羚�. Saturation specific humidity
xyz_Temp(:,:,:) :real(DP), intent(in)
: $ T $ . 羝�墾. Temperature
xyz_Press(:,:,:) :real(DP), intent(in)
: $ p $ . 羂���. Air pressure

羝�墾 Temp ����� Press ������, 蕋遵��罸�羚� QVapSat ��羆����障��.

Calculate saturation specific humidity QVapSat using temperature Temp and air pressure Press.

[Source]

  function xyz_CalcQVapSatOnLiq( xyz_Temp, xyz_Press ) result( xyz_QVapSat )
    !
    ! 羝�墾 *Temp* ����� *Press* ������, 
    ! 蕋遵��罸�羚� *QVapSat* ��羆����障��. 
    !
    ! Calculate saturation specific humidity *QVapSat* using
    ! temperature *Temp* and air pressure *Press*. 
    !

    ! �≪�吾�ャ�若����� ; USE statements
    !

    ! ����絎��域┃絎�
    ! Physical constants settings
    !
    use constants, only: GasRWet, LatentHeat, LatentHeatFusion, EpsV                  ! $ \epsilon_v $ . 
                              ! 羂頑�御���絖��閴�. 
                              ! Molecular weight of water vapor

    ! 絎ｈ��� ; Declaration statements
    !
    implicit none

    real(DP), intent(in):: xyz_Temp (:,:,:)
                              ! $ T $ . 羝�墾. Temperature
    real(DP), intent(in):: xyz_Press(:,:,:)
                              ! $ p $ . 羂���. Air pressure

    real(DP):: xyz_QVapSat(1:size(xyz_Temp,1), 1:size(xyz_Temp,2), 1:size(xyz_Temp,3))
                              ! $ q^{*} $ . 蕋遵��罸�羚�. Saturation specific humidity

    ! 篏�罐�����
    ! Work variables
    !
    real(DP):: LatentHeatLocal
                              !
                              ! Latent heat used in this routine


    ! 絎�茵��� ; Executable statement
    !

    ! ������腆肴�
    ! Initialization check
    !

    if ( .not. saturate_DennouAGCM_inited ) then
      call MessageNotify( 'E', module_name, 'This module has not been initialized.' )
    end if

    ! Set a value for latent heat
    if ( FlagSublimation ) then
      LatentHeatLocal = LatentHeat + LatentHeatFusion
    else
      LatentHeatLocal = LatentHeat
    end if

    xyz_QVapSat = EpsV * Es0 * exp( LatentHeatLocal / GasRWet * ( 1.0_DP/273.0_DP - 1.0_DP/xyz_Temp ) ) / xyz_Press


  end function xyz_CalcQVapSatOnLiq
xyz_CalcQVapSatOnSol( xyz_Temp, xyz_Press ) result(xyz_QVapSat)
Function :
xyz_QVapSat(1:size(xyz_Temp,1), 1:size(xyz_Temp,2), 1:size(xyz_Temp,3)) :real(DP)
: $ q^{*} $ . 蕋遵��罸�羚�. Saturation specific humidity
xyz_Temp(:,:,:) :real(DP), intent(in)
: $ T $ . 羝�墾. Temperature
xyz_Press(:,:,:) :real(DP), intent(in)
: $ p $ . 羂���. Air pressure

羝�墾 Temp ����� Press ������, 蕋遵��罸�羚� QVapSat ��羆����障��.

Calculate saturation specific humidity QVapSat using temperature Temp and air pressure Press.

[Source]

  function xyz_CalcQVapSatOnSol( xyz_Temp, xyz_Press ) result( xyz_QVapSat )
    !
    ! 羝�墾 *Temp* ����� *Press* ������, 
    ! 蕋遵��罸�羚� *QVapSat* ��羆����障��. 
    !
    ! Calculate saturation specific humidity *QVapSat* using
    ! temperature *Temp* and air pressure *Press*. 
    !

    ! �≪�吾�ャ�若����� ; USE statements
    !

    ! ����絎��域┃絎�
    ! Physical constants settings
    !
    use constants, only: GasRWet, LatentHeat, LatentHeatFusion, EpsV                  ! $ \epsilon_v $ . 
                              ! 羂頑�御���絖��閴�. 
                              ! Molecular weight of water vapor

    ! 絎ｈ��� ; Declaration statements
    !
    implicit none

    real(DP), intent(in):: xyz_Temp (:,:,:)
                              ! $ T $ . 羝�墾. Temperature
    real(DP), intent(in):: xyz_Press(:,:,:)
                              ! $ p $ . 羂���. Air pressure

    real(DP):: xyz_QVapSat(1:size(xyz_Temp,1), 1:size(xyz_Temp,2), 1:size(xyz_Temp,3))
                              ! $ q^{*} $ . 蕋遵��罸�羚�. Saturation specific humidity

    ! 篏�罐�����
    ! Work variables
    !
    real(DP):: LatentHeatLocal
                              !
                              ! Latent heat used in this routine


    ! 絎�茵��� ; Executable statement
    !

    ! ������腆肴�
    ! Initialization check
    !

    if ( .not. saturate_DennouAGCM_inited ) then
      call MessageNotify( 'E', module_name, 'This module has not been initialized.' )
    end if

    ! Set a value for latent heat
    LatentHeatLocal = LatentHeat + LatentHeatFusion

    xyz_QVapSat = EpsV * Es0 * exp( LatentHeatLocal / GasRWet * ( 1./273. - 1./xyz_Temp ) ) / xyz_Press


  end function xyz_CalcQVapSatOnSol

Private Instance methods

Es0
Constant :
Es0 = 611.0_DP :real(DP), parameter
: 0 ��������御��� [Pa]. Saturation water vapor pressure at 0 deg C [Pa]
FlagSublimation
Variable :
FlagSublimation :logical, save
: flag for treating sublimation
module_name
Constant :
module_name = ‘saturate_DennouAGCM‘ :character(*), parameter
: �≪�吾�ャ�若������腱�. Module name
version
Constant :
version = ’$Name: $’ // ’$Id: saturate_DennouAGCM.f90,v 1.6 2015/01/29 12:07:16 yot Exp $’ :character(*), parameter
: �≪�吾�ャ�若�������若�吾�с�� Module version