diff --git a/physics/GFS_DCNV_generic.f90 b/physics/GFS_DCNV_generic.f90 index 64e093e08..a00178b9a 100644 --- a/physics/GFS_DCNV_generic.f90 +++ b/physics/GFS_DCNV_generic.f90 @@ -66,7 +66,7 @@ end subroutine GFS_DCNV_generic_post_finalize !! | Model | FV3-GFS_Control_type | Fortran DDT containing FV3-GFS model control parameters | DDT | 0 | GFS_typedefs%GFS_control_type | | in | F | !! | Stateout | FV3-GFS_Stateout_type | Fortran DDT containing FV3-GFS prognostic state to return to dycore | DDT | 0 | GFS_typedefs%GFS_stateout_type| | in | F | !! | frain | dynamics_to_physics_timestep_ratio | ratio of dynamics timestep to physics timestep | none | 0 | real | kind_phys | in | F | -!! | rain1 | rainfall_amount_on_dynamics_timestep | convective rainfall amount on dynamics timestep | m | 1 | real | kind_phys | in | F | +!! | rain1 | rainfall_amount_on_physics_timestep | convective rainfall amount on physics timestep | m | 1 | real | kind_phys | in | F | !! | cld1d | cloud_work_function | cloud work function | m2 s-2 | 1 | real | kind_phys | in | F | !! | save_u | x_wind_save | x-wind before entering a physics scheme | m s-1 | 2 | real | kind_phys | in | F | !! | save_v | y_wind_save | y-wind before entering a physics scheme | m s-1 | 2 | real | kind_phys | in | F | diff --git a/physics/GFS_MP_generic_post.f90 b/physics/GFS_MP_generic_post.f90 index e28ba4e5a..0c85988fc 100644 --- a/physics/GFS_MP_generic_post.f90 +++ b/physics/GFS_MP_generic_post.f90 @@ -11,35 +11,35 @@ module GFS_MP_generic_post !> \defgroup GFS_MP_generic_post GFS MP generic post !! @{ -!!\section arg_table_GFS_MP_generic_post_init Argument Table +!! \section arg_table_GFS_MP_generic_post_init Argument Table !! subroutine GFS_MP_generic_post_init end subroutine GFS_MP_generic_post_init -!!\section arg_table_GFS_MP_generic_post_run Argument Table -!!| local var name | longname | description | units | rank | type | kind | intent | optional | -!!|----------------|------------------------------------------------------------|----------------------------------------------------------------|-------------|------|---------|-----------|--------|----------| -!!| im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | -!!| ix | horizontal_dimension | horizontal dimension | index | 0 | integer | | in | F | -!!| levs | vertical_dimension | vertical layer dimension | index | 0 | integer | | in | F | -!!| dtf | time_step_for_dynamics | dynamics time step | s | 0 | real | kind_phys | in | F | -!!| del | air_pressure_difference_between_midlayers | air pressure difference between midlayers | Pa | 2 | real | kind_phys | in | F | -!!| lssav | flag_diagnostics | logical flag for model physics diagnostics | flag | 0 | logical | | in | F | -!!| ldiag3d | flag_diagnostics_3D | logical flag for 3D diagnostics | flag | 0 | logical | | in | F | -!!| rain | timestep_total_rainfall_amount | total precipitation at surface (APCP) | m | 1 | real | kind_phys | in | F | -!!| frain | dynamics_to_physics_timestep_ratio | dtf/dtp, dynamics to physics timestep ratio | none | 0 | real | kind_phys | in | F | -!!| ntcw | index_for_liquid_cloud_condensate | cloud condensate index in tracer array(3) | index | 0 | integer | | in | F | -!!| ncld | number_of_hydrometeors | number_of_hydrometeors(1 for Z-C) | none | 0 | integer | | in | F | -!!| cwm | cloud_condensed_water_specific_humidity_updated_by_physics | cloud condensed water specific humidity | kg kg-1 | 2 | real | kind_phys | in | F | -!!| t | air_temperature_updated_by_physics | layer mean air temperature | K | 2 | real | kind_phys | in | F | -!!| q | water_vapor_specific_humidity_updated_by_physics | water vapor specific humidity | kg kg-1 | 2 | real | kind_phys | in | F | -!!| save_t | air_temperature_save | air temperature before entering a physics scheme | K | 2 | real | kind_phys | in | F | -!!| save_qv | water_vapor_specific_humidity_save | water vapor specific humidity before entering a physics scheme | kg kg-1 | 2 | real | kind_phys | in | F | -!!| totprcp | precipitation_rate_at_surface | precipitation rate at surface | kg m-2 s-1 | 1 | real | kind_phys | inout | F | -!!| dt3dt6 | large_scale_condensate_heating_rate_at_model_layers | large scale condensate heating rate at model layers | K s-1 | 2 | real | kind_phys | inout | F | -!!| dq3dt4 | large_scale_condensate_moistening_rate_at_model_layers | large scale condensate moistening rate at model layers | kg kg-1 s-1 | 2 | real | kind_phys | inout | F | -!!| pwat | column_precipitable_water | column integrated precipitable water | kg m-2 | 1 | real | kind_phys | out | F | +!! \section arg_table_GFS_MP_generic_post_run Argument Table +!! | local var name | longname | description | units | rank | type | kind | intent | optional | +!! |----------------|------------------------------------------------------------|----------------------------------------------------------------|-------------|------|---------|-----------|--------|----------| +!! | im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | +!! | ix | horizontal_dimension | horizontal dimension | index | 0 | integer | | in | F | +!! | levs | vertical_dimension | vertical layer dimension | index | 0 | integer | | in | F | +!! | dtf | time_step_for_dynamics | dynamics time step | s | 0 | real | kind_phys | in | F | +!! | del | air_pressure_difference_between_midlayers | air pressure difference between midlayers | Pa | 2 | real | kind_phys | in | F | +!! | lssav | flag_diagnostics | logical flag for model physics diagnostics | flag | 0 | logical | | in | F | +!! | ldiag3d | flag_diagnostics_3D | logical flag for 3D diagnostics | flag | 0 | logical | | in | F | +!! | rain | timestep_total_rainfall_amount | total precipitation at surface (APCP) | m | 1 | real | kind_phys | in | F | +!! | frain | dynamics_to_physics_timestep_ratio | dtf/dtp, dynamics to physics timestep ratio | none | 0 | real | kind_phys | in | F | +!! | ntcw | index_for_liquid_cloud_condensate | cloud condensate index in tracer array(3) | index | 0 | integer | | in | F | +!! | ncld | number_of_hydrometeors | number_of_hydrometeors(1 for Z-C) | count | 0 | integer | | in | F | +!! | cwm | cloud_condensed_water_specific_humidity_updated_by_physics | cloud condensed water specific humidity | kg kg-1 | 2 | real | kind_phys | in | F | +!! | t | air_temperature_updated_by_physics | layer mean air temperature | K | 2 | real | kind_phys | in | F | +!! | q | water_vapor_specific_humidity_updated_by_physics | water vapor specific humidity | kg kg-1 | 2 | real | kind_phys | in | F | +!! | save_t | air_temperature_save | air temperature before entering a physics scheme | K | 2 | real | kind_phys | in | F | +!! | save_qv | water_vapor_specific_humidity_save | water vapor specific humidity before entering a physics scheme | kg kg-1 | 2 | real | kind_phys | in | F | +!! | totprcp | precipitation_rate_at_surface | precipitation rate at surface | kg m-2 s-1 | 1 | real | kind_phys | inout | F | +!! | dt3dt6 | large_scale_condensate_heating_rate_at_model_layers | large scale condensate heating rate at model layers | K s-1 | 2 | real | kind_phys | inout | F | +!! | dq3dt4 | large_scale_condensate_moistening_rate_at_model_layers | large scale condensate moistening rate at model layers | kg kg-1 s-1 | 2 | real | kind_phys | inout | F | +!! | pwat | column_precipitable_water | column integrated precipitable water | kg m-2 | 1 | real | kind_phys | out | F | !! subroutine GFS_MP_generic_post_run(im, ix, levs,dtf,del, & lssav,ldiag3d,rain,frain,ntcw,ncld,cwm, & !input @@ -112,7 +112,7 @@ subroutine GFS_MP_generic_post_run(im, ix, levs,dtf,del, & end subroutine GFS_MP_generic_post_run -!!\setction arg_table_GFS_MP_generic_post_finalize Argument Table +!! \section arg_table_GFS_MP_generic_post_finalize Argument Table !! subroutine GFS_MP_generic_post_finalize end subroutine GFS_MP_generic_post_finalize diff --git a/physics/GFS_MP_generic_pre.f90 b/physics/GFS_MP_generic_pre.f90 index 4051a88d6..3425f4208 100644 --- a/physics/GFS_MP_generic_pre.f90 +++ b/physics/GFS_MP_generic_pre.f90 @@ -7,29 +7,29 @@ module GFS_MP_generic_pre !> \defgroup GFS_MP_generic_pre GFS MP generic pre !! @{ -!!\section arg_table_GFS_MP_generic_pre_init Argument Table +!! \section arg_table_GFS_MP_generic_pre_init Argument Table !! - subroutine GFS_MP_generic_pre_init + subroutine GFS_MP_generic_pre_init end subroutine GFS_MP_generic_pre_init -!!\section arg_table_GFS_MP_generic_pre_run Argument Table -!!| local var name | longname |description | units | rank | type | kind | intent | optional | -!!|----------------|------------------------------------------------------------|--------------------------------------------------------------------------|-------------|------|---------|-----------|--------|----------| -!!| im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | -!!| ix | horizontal_dimension | horizontal dimension | index | 0 | integer | | in | F | -!!| levs | vertical_dimension | vertical layer dimension | index | 0 | integer | | in | F | -!!| clw1 | cloud_ice_specific_humidity | cloud ice specific humidity | kg kg-1 | 2 | real | kind_phys | in | F | -!!| clw2 | cloud_liquid_water_specific_humidity | cloud water specific humidity | kg kg-1 | 2 | real | kind_phys | in | F | -!!| ldiag3d | flag_diagnostics_3D | logical flag for 3D diagnostics | flag | 0 | logical | | in | F | -!!| ntcw | index_for_liquid_cloud_condensate | cloud condensate index in tracer array(3) | none | 0 | integer | | in | F | -!!| ncld | number_of_hydrometeors | number of hydrometeors(1 for Z-C) | none | 0 | integer | | in | F | -!!| num_p3d | array_dimension_of_microphysics | number of 3D arrays needed for microphysics | none | 0 | integer | | in | F | -!!| t | air_temperature_updated_by_physics | layer mean air temperature | K | 2 | real | kind_phys | in | F | -!!| q | water_vapor_specific_humidity_updated_by_physics | water vapor specific humidity | kg kg-1 | 2 | real | kind_phys | in | F | -!!| save_t | air_temperature_save | air temperature before entering a physics scheme | K | 2 | real | kind_phys | out | F | -!!| save_qv | water_vapor_specific_humidity_save | water vapor specific humidity before entering a physics scheme | kg kg-1 | 2 | real | kind_phys | out | F | -!!| save_qcw | cloud_condensed_water_specific_humidity_save | cloud condensed water specific humidity before entering a physics scheme | kg kg-1 | 2 | real | kind_phys | out | F | +!> \section arg_table_GFS_MP_generic_pre_run Argument Table +!! | local var name | longname |description | units | rank | type | kind | intent | optional | +!! |----------------|------------------------------------------------------------|--------------------------------------------------------------------------|-------------|------|---------|-----------|--------|----------| +!! | im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | +!! | ix | horizontal_dimension | horizontal dimension | index | 0 | integer | | in | F | +!! | levs | vertical_dimension | vertical layer dimension | index | 0 | integer | | in | F | +!! | clw1 | cloud_ice_specific_humidity | cloud ice specific humidity | kg kg-1 | 2 | real | kind_phys | in | F | +!! | clw2 | cloud_liquid_water_specific_humidity | cloud water specific humidity | kg kg-1 | 2 | real | kind_phys | in | F | +!! | ldiag3d | flag_diagnostics_3D | logical flag for 3D diagnostics | flag | 0 | logical | | in | F | +!! | ntcw | index_for_liquid_cloud_condensate | cloud condensate index in tracer array(3) | index | 0 | integer | | in | F | +!! | ncld | number_of_hydrometeors | number of hydrometeors(1 for Z-C) | count | 0 | integer | | in | F | +!! | num_p3d | array_dimension_of_microphysics | number of 3D arrays needed for microphysics | count | 0 | integer | | in | F | +!! | t | air_temperature_updated_by_physics | layer mean air temperature | K | 2 | real | kind_phys | in | F | +!! | q | water_vapor_specific_humidity_updated_by_physics | water vapor specific humidity | kg kg-1 | 2 | real | kind_phys | in | F | +!! | save_t | air_temperature_save | air temperature before entering a physics scheme | K | 2 | real | kind_phys | out | F | +!! | save_qv | water_vapor_specific_humidity_save | water vapor specific humidity before entering a physics scheme | kg kg-1 | 2 | real | kind_phys | out | F | +!! | save_qcw | cloud_condensed_water_specific_humidity_save | cloud condensed water specific humidity before entering a physics scheme | kg kg-1 | 2 | real | kind_phys | out | F | !! subroutine GFS_MP_generic_pre_run(im, ix, levs, clw1, clw2, & ldiag3d, ntcw, ncld, num_p3d, t, q, & !input @@ -75,7 +75,7 @@ subroutine GFS_MP_generic_pre_run(im, ix, levs, clw1, clw2, & end subroutine GFS_MP_generic_pre_run -!!\setction arg_table_GFS_MP_generic_pre_finalize Argument Table +!> \section arg_table_GFS_MP_generic_pre_finalize Argument Table !! subroutine GFS_MP_generic_pre_finalize end subroutine GFS_MP_generic_pre_finalize diff --git a/physics/GFS_PBL_generic.f90 b/physics/GFS_PBL_generic.f90 index de15fd0a4..f38d550e0 100644 --- a/physics/GFS_PBL_generic.f90 +++ b/physics/GFS_PBL_generic.f90 @@ -55,7 +55,7 @@ end subroutine GFS_PBL_generic_post_finalize !! | dvdt | tendency_of_y_wind_due_to_model_physics | updated tendency of the y wind | m s-2 | 2 | real | kind_phys | in | F | !! | dtdt | tendency_of_air_temperature_due_to_model_physics | updated tendency of the temperature | K s-1 | 2 | real | kind_phys | in | F | !! | dqdt | tendency_of_tracers_due_to_model_physics | updated tendency of the tracers | kg kg-1 s-1 | 3 | real | kind_phys | in | F | -!! | xmu | zenith_angle_temporal_adjustment_factor_for_shortwave_fluxes | zenith angle temporal adjustment factor for shortwave fluxes | none | 2 | real | kind_phys | in | F | +!! | xmu | zenith_angle_temporal_adjustment_factor_for_shortwave_fluxes | zenith angle temporal adjustment factor for shortwave fluxes | none | 1 | real | kind_phys | in | F | !! | Diag | FV3-GFS_Diag_type | Fortran DDT containing FV3-GFS fields targeted for diagnostic output | DDT | 0 | GFS_typedefs%GFS_diag_type | | in | F | !! subroutine GFS_PBL_generic_post_run (Grid, Model, Radtend, dusfc1, dvsfc1, dtsfc1, dqsfc1, & diff --git a/physics/GFS_RRTMG_post.f90 b/physics/GFS_RRTMG_post.f90 index 8451a92e1..7285b05ba 100644 --- a/physics/GFS_RRTMG_post.f90 +++ b/physics/GFS_RRTMG_post.f90 @@ -5,33 +5,33 @@ module GFS_RRTMG_post !>\defgroup GFS_RRTMG_post GFS RRTMG Scheme Post !! @{ -!>\section arg_table_GFS_RRTMG_post_init Argument Table +!> \section arg_table_GFS_RRTMG_post_init Argument Table !! subroutine GFS_RRTMG_post_init () end subroutine GFS_RRTMG_post_init -!>\section arg_table_GFS_RRTMG_post_run Argument Table -!!| local var name | longname | description | units | rank | type | kind | intent | optional | -!!|-------------------|---------------------------------------------------------------|-------------------------------------------------------------------------------|----------|------|-------------------------------|-----------|--------|----------| -!!| Model | FV3-GFS_Control_type | Fortran DDT containing FV3-GFS model control parameters | DDT | 0 | GFS_typedefs%GFS_control_type | | in | F | -!!| Grid | FV3-GFS_Grid_type | Fortran DDT containing FV3-GFS grid and interpolation related data | DDT | 0 | GFS_typedefs%GFS_grid_type | | in | F | -!!| Diag | FV3-GFS_Diag_type | Fortran DDT containing FV3-GFS diagnotics data | DDT | 0 | GFS_typedefs%GFS_diag_type | | inout | F | -!!| Radtend | FV3-GFS_Radtend_type | Fortran DDT containing FV3-GFS radiation tendencies | DDT | 0 | GFS_typedefs%GFS_radtend_type | | in | F | -!!| Statein | FV3-GFS_Statein_type | Fortran DDT containing FV3-GFS prognostic state data in from dycore | DDT | 0 | GFS_typedefs%GFS_stateout_type| | in | F | -!!| Coupling | FV3-GFS_Coupling_type | Fortran DDT containing FV3-GFS fields to/from coupling with other components | DDT | 0 | GFS_typedefs%GFS_coupling_type| | inout | F | -!!| scmpsw | components_of_surface_downward_shortwave_fluxes | derived type for special components of surface downward shortwave fluxes | W m-2 | 1 | cmpfsw_type | | in | F | -!!| im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | -!!| lm | vertical_layer_dimension_for_radiation | number of vertical layers for radiation calculation | index | 0 | integer | | in | F | -!!| ltp | extra_top_layer | extra top layers | none | 0 | integer | | in | F | -!!| kt | vertical_index_difference_between_layer_and_upper_bound | vertical index difference between layer and upper bound | index | 0 | integer | | in | F | -!!| kb | vertical_index_difference_between_layer_and_lower_bound | vertical index difference between layer and lower bound | index | 0 | integer | | in | F | -!!| kd | vertical_index_difference_between_in-out_and_local | vertical index difference between in/out and local | index | 0 | integer | | in | F | -!!| raddt | time_step_for_radiation | radiation time step | s | 0 | real | kind_phys | in | F | -!!| aerodp | atmosphere_optical_thickness_due_to_ambient_aerosol_particals | vertical integrated optical depth for various aerosol species | none | 2 | real | kind_phys | in | F | -!!| cldsa | cloud_area_fraction | fraction of clouds for low, middle, high, total and BL | frac | 2 | real | kind_phys | in | F | -!!| mtopa | model_layer_number_at_cloud_top | vertical indices for low, middle and high cloud tops | index | 2 | integer | | in | F | -!!| mbota | model_layer_number_at_cloud_base | vertical indices for low, middle and high cloud bases | index | 2 | integer | | in | F | -!!| clouds1 | total_cloud_fraction | layer total cloud fraction | frac | 2 | real | kind_phys | in | F | +!> \section arg_table_GFS_RRTMG_post_run Argument Table +!! | local var name | longname | description | units | rank | type | kind | intent | optional | +!! |-------------------|---------------------------------------------------------------|-------------------------------------------------------------------------------|----------|------|-------------------------------|-----------|--------|----------| +!! | Model | FV3-GFS_Control_type | Fortran DDT containing FV3-GFS model control parameters | DDT | 0 | GFS_typedefs%GFS_control_type | | in | F | +!! | Grid | FV3-GFS_Grid_type | Fortran DDT containing FV3-GFS grid and interpolation related data | DDT | 0 | GFS_typedefs%GFS_grid_type | | in | F | +!! | Diag | FV3-GFS_Diag_type | Fortran DDT containing FV3-GFS diagnotics data | DDT | 0 | GFS_typedefs%GFS_diag_type | | inout | F | +!! | Radtend | FV3-GFS_Radtend_type | Fortran DDT containing FV3-GFS radiation tendencies | DDT | 0 | GFS_typedefs%GFS_radtend_type | | in | F | +!! | Statein | FV3-GFS_Statein_type | Fortran DDT containing FV3-GFS prognostic state data in from dycore | DDT | 0 | GFS_typedefs%GFS_statein_type | | in | F | +!! | Coupling | FV3-GFS_Coupling_type | Fortran DDT containing FV3-GFS fields to/from coupling with other components | DDT | 0 | GFS_typedefs%GFS_coupling_type| | inout | F | +!! | scmpsw | components_of_surface_downward_shortwave_fluxes | derived type for special components of surface downward shortwave fluxes | W m-2 | 1 | cmpfsw_type | | in | F | +!! | im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | +!! | lm | vertical_layer_dimension_for_radiation | number of vertical layers for radiation calculation | index | 0 | integer | | in | F | +!! | ltp | extra_top_layer | extra top layers | none | 0 | integer | | in | F | +!! | kt | vertical_index_difference_between_layer_and_upper_bound | vertical index difference between layer and upper bound | index | 0 | integer | | in | F | +!! | kb | vertical_index_difference_between_layer_and_lower_bound | vertical index difference between layer and lower bound | index | 0 | integer | | in | F | +!! | kd | vertical_index_difference_between_in-out_and_local | vertical index difference between in/out and local | index | 0 | integer | | in | F | +!! | raddt | time_step_for_radiation | radiation time step | s | 0 | real | kind_phys | in | F | +!! | aerodp | atmosphere_optical_thickness_due_to_ambient_aerosol_particals | vertical integrated optical depth for various aerosol species | none | 2 | real | kind_phys | in | F | +!! | cldsa | cloud_area_fraction_for_radiation | fraction of clouds for low, middle, high, total and BL | frac | 2 | real | kind_phys | in | F | +!! | mtopa | model_layer_number_at_cloud_top | vertical indices for low, middle and high cloud tops | index | 2 | integer | | in | F | +!! | mbota | model_layer_number_at_cloud_base | vertical indices for low, middle and high cloud bases | index | 2 | integer | | in | F | +!! | clouds1 | total_cloud_fraction | layer total cloud fraction | frac | 2 | real | kind_phys | in | F | !! subroutine GFS_RRTMG_post_run (Model, Grid, Diag, Radtend, Statein, & Coupling, scmpsw, im, lm, ltp, kt, kb, kd, raddt, aerodp, & @@ -164,7 +164,7 @@ subroutine GFS_RRTMG_post_run (Model, Grid, Diag, Radtend, Statein, & ! end subroutine GFS_RRTMG_post_run -!>\section arg_table_GFS_RRTMG_post_finalize Argument Table +!> \section arg_table_GFS_RRTMG_post_finalize Argument Table !! subroutine GFS_RRTMG_post_finalize () end subroutine GFS_RRTMG_post_finalize diff --git a/physics/GFS_RRTMG_pre.f90 b/physics/GFS_RRTMG_pre.f90 index 19386bdd6..ef9b043d9 100644 --- a/physics/GFS_RRTMG_pre.f90 +++ b/physics/GFS_RRTMG_pre.f90 @@ -8,68 +8,68 @@ module GFS_RRTMG_pre !> \defgroup GFS_RRTMG_pre GFS RRTMG Scheme Pre !! @{ -!!\section arg_table_GFS_RRTMG_pre_init Argument Table +!! \section arg_table_GFS_RRTMG_pre_init Argument Table !! subroutine GFS_RRTMG_pre_init () end subroutine GFS_RRTMG_pre_init -!!\section arg_table_GFS_RRTMG_pre_run Argument Table -!!| local var name | longname | description | units | rank | type | kind | intent | optional | -!!|-------------------|---------------------------------------------------------------|-------------------------------------------------------------------------------|----------|------|-------------------------------|-----------|--------|----------| -!!| Model | FV3-GFS_Control_type | Fortran DDT containing FV3-GFS model control parameters | DDT | 0 | GFS_typedefs%GFS_control_type | | in | F | -!!| Grid | FV3-GFS_Grid_type | Fortran DDT containing FV3-GFS grid and interpolation related data | DDT | 0 | GFS_typedefs%GFS_grid_type | | in | F | -!!| Sfcprop | FV3-GFS_Sfcprop_type | Fortran DDT containing FV3-GFS surface fields | DDT | 0 | GFS_typedefs%GFS_sfcprop_type | | in | F | -!!| Statein | FV3-GFS_Statein_type | Fortran DDT containing FV3-GFS prognostic state data in from dycore | DDT | 0 | GFS_typedefs%GFS_stateout_type| | in | F | -!!| Tbd | FV3-GFS_Tbd_type | Fortran DDT containing FV3-GFS data not yet assigned to a defined container | DDT | 0 | GFS_typedefs%GFS_tbd_type | | in | F | -!!| Cldprop | FV3-GFS_Cldprop_type | Fortran DDT containing FV3-GFS cloud fields needed by radiation from physics | DDT | 0 | GFS_typedefs%GFS_cldprop_type | | in | F | -!!| Radtend | FV3-GFS_Radtend_type | Fortran DDT containing FV3-GFS radiation tendencies | DDT | 0 | GFS_typedefs%GFS_radtend_type | | in | F | -!!| lm | vertical_layer_dimension_for_radiation | number of vertical layers for radiation calculation | index | 0 | integer | | out | F | -!!| im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | out | F | -!!| lmk | adjusted_vertical_layer_dimension_for_radiation | number of vertical layers for radiation | index | 0 | integer | | out | F | -!!| lmp | adjusted_vertical_level_dimension_for_radiation | number of vertical levels for radiation | index | 0 | integer | | out | F | -!!| kd | vertical_index_difference_between_in-out_and_local | vertical index difference between in/out and local | index | 0 | integer | | out | F | -!!| kt | vertical_index_difference_between_layer_and_upper_bound | vertical index difference between layer and upper bound | index | 0 | integer | | out | F | -!!| kb | vertical_index_difference_between_layer_and_lower_bound | vertical index difference between layer and lower bound | index | 0 | integer | | out | F | -!!| raddt | time_step_for_radiation | radiation time step | s | 0 | real | kind_phys | out | F | -!!| plvl | air_pressure_at_interface_for_radiation_in_hPa | air pressure at vertical interface for radiation calculation | hPa | 2 | real | kind_phys | out | F | -!!| plyr | air_pressure_at_layer_for_radiation_in_hPa | air pressure at vertical layer for radiation calculation | hPa | 2 | real | kind_phys | out | F | -!!| tlvl | air_temperature_at_interface_for_radiation | air temperature at vertical interface for radiation calculation | K | 2 | real | kind_phys | out | F | -!!| tlyr | air_temperature_at_layer_for_radiation | air temperature at vertical layer for radiation calculation | K | 2 | real | kind_phys | out | F | -!!| tsfg | surface_ground_temperature_for_radiation | surface ground temperature for radiation | K | 1 | real | kind_phys | out | F | -!!| tsfa | surface_air_temperature_for_radiation | lowest model layer air temperature for radiation | K | 1 | real | kind_phys | out | F | -!!| qlyr | water_vapor_specific_humidity_at_layer_for_radiation | water vapor specific humidity at vertical layer for radiation calculation | kg kg-1 | 2 | real | kind_phys | out | F | -!!| nday | daytime_points_dimension | daytime points dimension | index | 0 | integer | | out | F | -!!| idxday | daytime_points | daytime points | none | 1 | integer | | out | F | -!!| olyr | ozone_concentration_at_layer_for_radiation | ozone concentration | gm gm-1 | 2 | real | kind_phys | out | F | -!!| gasvmr_co2 | volume_mixing_ratio_co2 | CO2 volume mixing ratio | gm gm-1 | 2 | real | kind_phys | out | F | -!!| gasvmr_n2o | volume_mixing_ratio_n2o | N2O volume mixing ratio | gm gm-1 | 2 | real | kind_phys | out | F | -!!| gasvmr_ch4 | volume_mixing_ratio_ch4 | CH4 volume mixing ratio | gm gm-1 | 2 | real | kind_phys | out | F | -!!| gasvmr_o2 | volume_mixing_ratio_o2 | O2 volume mixing ratio | gm gm-1 | 2 | real | kind_phys | out | F | -!!| gasvmr_co | volume_mixing_ratio_co | CO volume mixing ratio | gm gm-1 | 2 | real | kind_phys | out | F | -!!| gasvmr_cfc11 | volume_mixing_ratio_cfc11 | CFC11 volume mixing ratio | gm gm-1 | 2 | real | kind_phys | out | F | -!!| gasvmr_cfc12 | volume_mixing_ratio_cfc12 | CFC12 volume mixing ratio | gm gm-1 | 2 | real | kind_phys | out | F | -!!| gasvmr_cfc22 | volume_mixing_ratio_cfc22 | CFC22 volume mixing ratio | gm gm-1 | 2 | real | kind_phys | out | F | -!!| gasvmr_ccl4 | volume_mixing_ratio_ccl4 | CCL4 volume mixing ratio | gm gm-1 | 2 | real | kind_phys | out | F | -!!| gasvmr_cfc113 | volume_mixing_ratio_cfc113 | CFC113 volume mixing ratio | gm gm-1 | 2 | real | kind_phys | out | F | -!!| faersw1 | aerosol_optical_depth_for_shortwave_bands_01-16 | aerosol optical depth for shortwave bands 01-16 | none | 3 | real | kind_phys | out | F | -!!| faersw2 | aerosol_single_scattering_albedo_for_shortwave_bands_01-16 | aerosol single scattering albedo for shortwave bands 01-16 | none | 3 | real | kind_phys | out | F | -!!| faersw3 | aerosol_asymmetry_parameter_for_shortwave_bands_01-16 | aerosol asymmetry parameter for shortwave bands 01-16 | none | 3 | real | kind_phys | out | F | -!!| faerlw1 | aerosol_optical_depth_for_longwave_bands_01-16 | aerosol optical depth for longwave bands 01-16 | none | 3 | real | kind_phys | out | F | -!!| faerlw2 | aerosol_single_scattering_albedo_for_longwave_bands_01-16 | aerosol single scattering albedo for longwave bands 01-16 | none | 3 | real | kind_phys | out | F | -!!| faerlw3 | aerosol_asymmetry_parameter_for_longwave_bands_01-16 | aerosol asymmetry parameter for longwave bands 01-16 | none | 3 | real | kind_phys | out | F | -!!| aerodp | atmosphere_optical_thickness_due_to_ambient_aerosol_particals | vertical integrated optical depth for various aerosol species | none | 2 | real | kind_phys | out | F | -!!| clouds1 | total_cloud_fraction | layer total cloud fraction | frac | 2 | real | kind_phys | out | F | -!!| clouds2 | cloud_liquid_water_path | layer cloud liquid water path | g m-2 | 2 | real | kind_phys | out | F | -!!| clouds3 | mean_effective_radius_for_liquid_cloud | mean effective radius for liquid cloud | micron | 2 | real | kind_phys | out | F | -!!| clouds4 | cloud_ice_water_path | layer cloud ice water path | g m-2 | 2 | real | kind_phys | out | F | -!!| clouds5 | mean_effective_radius_for_ice_cloud | mean effective radius for ice cloud | micron | 2 | real | kind_phys | out | F | -!!| clouds6 | cloud_rain_water_path | cloud rain water path | g m-2 | 2 | real | kind_phys | out | F | -!!| clouds7 | mean_effective_radius_for_rain_drop | mean effective radius for rain drop | micron | 2 | real | kind_phys | out | F | -!!| clouds8 | cloud_snow_water_path | cloud snow water path | g m-2 | 2 | real | kind_phys | out | F | -!!| clouds9 | mean_effective_radius_for_snow_flake | mean effective radius for snow flake | micron | 2 | real | kind_phys | out | F | -!!| cldsa | cloud_area_fraction | fraction of clouds for low, middle,high, total and bl (IX,5) | frac | 2 | real | kind_phys | out | F | -!!| mtopa | model_layer_number_at_cloud_top | vertical indices for low, middle and high cloud tops | index | 2 | integer | | out | F | -!!| mbota | model_layer_number_at_cloud_base | vertical indices for low, middle and high cloud bases | index | 2 | integer | | out | F | +!> \section arg_table_GFS_RRTMG_pre_run Argument Table +!! | local var name | longname | description | units | rank | type | kind | intent | optional | +!! |-------------------|---------------------------------------------------------------|-------------------------------------------------------------------------------|----------|------|-------------------------------|-----------|--------|----------| +!! | Model | FV3-GFS_Control_type | Fortran DDT containing FV3-GFS model control parameters | DDT | 0 | GFS_typedefs%GFS_control_type | | in | F | +!! | Grid | FV3-GFS_Grid_type | Fortran DDT containing FV3-GFS grid and interpolation related data | DDT | 0 | GFS_typedefs%GFS_grid_type | | in | F | +!! | Sfcprop | FV3-GFS_Sfcprop_type | Fortran DDT containing FV3-GFS surface fields | DDT | 0 | GFS_typedefs%GFS_sfcprop_type | | in | F | +!! | Statein | FV3-GFS_Statein_type | Fortran DDT containing FV3-GFS prognostic state data in from dycore | DDT | 0 | GFS_typedefs%GFS_statein_type | | in | F | +!! | Tbd | FV3-GFS_Tbd_type | Fortran DDT containing FV3-GFS data not yet assigned to a defined container | DDT | 0 | GFS_typedefs%GFS_tbd_type | | in | F | +!! | Cldprop | FV3-GFS_Cldprop_type | Fortran DDT containing FV3-GFS cloud fields needed by radiation from physics | DDT | 0 | GFS_typedefs%GFS_cldprop_type | | in | F | +!! | Radtend | FV3-GFS_Radtend_type | Fortran DDT containing FV3-GFS radiation tendencies | DDT | 0 | GFS_typedefs%GFS_radtend_type | | in | F | +!! | lm | vertical_layer_dimension_for_radiation | number of vertical layers for radiation calculation | index | 0 | integer | | out | F | +!! | im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | out | F | +!! | lmk | adjusted_vertical_layer_dimension_for_radiation | number of vertical layers for radiation | index | 0 | integer | | out | F | +!! | lmp | adjusted_vertical_level_dimension_for_radiation | number of vertical levels for radiation | index | 0 | integer | | out | F | +!! | kd | vertical_index_difference_between_in-out_and_local | vertical index difference between in/out and local | index | 0 | integer | | out | F | +!! | kt | vertical_index_difference_between_layer_and_upper_bound | vertical index difference between layer and upper bound | index | 0 | integer | | out | F | +!! | kb | vertical_index_difference_between_layer_and_lower_bound | vertical index difference between layer and lower bound | index | 0 | integer | | out | F | +!! | raddt | time_step_for_radiation | radiation time step | s | 0 | real | kind_phys | out | F | +!! | plvl | air_pressure_at_interface_for_radiation_in_hPa | air pressure at vertical interface for radiation calculation | hPa | 2 | real | kind_phys | out | F | +!! | plyr | air_pressure_at_layer_for_radiation_in_hPa | air pressure at vertical layer for radiation calculation | hPa | 2 | real | kind_phys | out | F | +!! | tlvl | air_temperature_at_interface_for_radiation | air temperature at vertical interface for radiation calculation | K | 2 | real | kind_phys | out | F | +!! | tlyr | air_temperature_at_layer_for_radiation | air temperature at vertical layer for radiation calculation | K | 2 | real | kind_phys | out | F | +!! | tsfg | surface_ground_temperature_for_radiation | surface ground temperature for radiation | K | 1 | real | kind_phys | out | F | +!! | tsfa | surface_air_temperature_for_radiation | lowest model layer air temperature for radiation | K | 1 | real | kind_phys | out | F | +!! | qlyr | water_vapor_specific_humidity_at_layer_for_radiation | water vapor specific humidity at vertical layer for radiation calculation | kg kg-1 | 2 | real | kind_phys | out | F | +!! | nday | daytime_points_dimension | daytime points dimension | index | 0 | integer | | out | F | +!! | idxday | daytime_points | daytime points | count | 1 | integer | | out | F | +!! | olyr | ozone_concentration_at_layer_for_radiation | ozone concentration | kg kg-1 | 2 | real | kind_phys | out | F | +!! | gasvmr_co2 | volume_mixing_ratio_co2 | CO2 volume mixing ratio | kg kg-1 | 2 | real | kind_phys | out | F | +!! | gasvmr_n2o | volume_mixing_ratio_n2o | N2O volume mixing ratio | kg kg-1 | 2 | real | kind_phys | out | F | +!! | gasvmr_ch4 | volume_mixing_ratio_ch4 | CH4 volume mixing ratio | kg kg-1 | 2 | real | kind_phys | out | F | +!! | gasvmr_o2 | volume_mixing_ratio_o2 | O2 volume mixing ratio | kg kg-1 | 2 | real | kind_phys | out | F | +!! | gasvmr_co | volume_mixing_ratio_co | CO volume mixing ratio | kg kg-1 | 2 | real | kind_phys | out | F | +!! | gasvmr_cfc11 | volume_mixing_ratio_cfc11 | CFC11 volume mixing ratio | kg kg-1 | 2 | real | kind_phys | out | F | +!! | gasvmr_cfc12 | volume_mixing_ratio_cfc12 | CFC12 volume mixing ratio | kg kg-1 | 2 | real | kind_phys | out | F | +!! | gasvmr_cfc22 | volume_mixing_ratio_cfc22 | CFC22 volume mixing ratio | kg kg-1 | 2 | real | kind_phys | out | F | +!! | gasvmr_ccl4 | volume_mixing_ratio_ccl4 | CCL4 volume mixing ratio | kg kg-1 | 2 | real | kind_phys | out | F | +!! | gasvmr_cfc113 | volume_mixing_ratio_cfc113 | CFC113 volume mixing ratio | kg kg-1 | 2 | real | kind_phys | out | F | +!! | faersw1 | aerosol_optical_depth_for_shortwave_bands_01-16 | aerosol optical depth for shortwave bands 01-16 | none | 3 | real | kind_phys | out | F | +!! | faersw2 | aerosol_single_scattering_albedo_for_shortwave_bands_01-16 | aerosol single scattering albedo for shortwave bands 01-16 | frac | 3 | real | kind_phys | out | F | +!! | faersw3 | aerosol_asymmetry_parameter_for_shortwave_bands_01-16 | aerosol asymmetry parameter for shortwave bands 01-16 | none | 3 | real | kind_phys | out | F | +!! | faerlw1 | aerosol_optical_depth_for_longwave_bands_01-16 | aerosol optical depth for longwave bands 01-16 | none | 3 | real | kind_phys | out | F | +!! | faerlw2 | aerosol_single_scattering_albedo_for_longwave_bands_01-16 | aerosol single scattering albedo for longwave bands 01-16 | frac | 3 | real | kind_phys | out | F | +!! | faerlw3 | aerosol_asymmetry_parameter_for_longwave_bands_01-16 | aerosol asymmetry parameter for longwave bands 01-16 | none | 3 | real | kind_phys | out | F | +!! | aerodp | atmosphere_optical_thickness_due_to_ambient_aerosol_particals | vertical integrated optical depth for various aerosol species | none | 2 | real | kind_phys | out | F | +!! | clouds1 | total_cloud_fraction | layer total cloud fraction | frac | 2 | real | kind_phys | out | F | +!! | clouds2 | cloud_liquid_water_path | layer cloud liquid water path | g m-2 | 2 | real | kind_phys | out | F | +!! | clouds3 | mean_effective_radius_for_liquid_cloud | mean effective radius for liquid cloud | micron | 2 | real | kind_phys | out | F | +!! | clouds4 | cloud_ice_water_path | layer cloud ice water path | g m-2 | 2 | real | kind_phys | out | F | +!! | clouds5 | mean_effective_radius_for_ice_cloud | mean effective radius for ice cloud | micron | 2 | real | kind_phys | out | F | +!! | clouds6 | cloud_rain_water_path | cloud rain water path | g m-2 | 2 | real | kind_phys | out | F | +!! | clouds7 | mean_effective_radius_for_rain_drop | mean effective radius for rain drop | micron | 2 | real | kind_phys | out | F | +!! | clouds8 | cloud_snow_water_path | cloud snow water path | g m-2 | 2 | real | kind_phys | out | F | +!! | clouds9 | mean_effective_radius_for_snow_flake | mean effective radius for snow flake | micron | 2 | real | kind_phys | out | F | +!! | cldsa | cloud_area_fraction_for_radiation | fraction of clouds for low, middle,high, total and BL | frac | 2 | real | kind_phys | out | F | +!! | mtopa | model_layer_number_at_cloud_top | vertical indices for low, middle and high cloud tops | index | 2 | integer | | out | F | +!! | mbota | model_layer_number_at_cloud_base | vertical indices for low, middle and high cloud bases | index | 2 | integer | | out | F | !! subroutine GFS_RRTMG_pre_run (Model, Grid, Sfcprop, Statein, & ! input Tbd, Cldprop, Radtend, & @@ -600,7 +600,7 @@ subroutine GFS_RRTMG_pre_run (Model, Grid, Sfcprop, Statein, & ! input end subroutine GFS_RRTMG_pre_run -!!\section arg_table_GFS_RRTMG_pre_finalize Argument Table +!> \section arg_table_GFS_RRTMG_pre_finalize Argument Table !! subroutine GFS_RRTMG_pre_finalize () end subroutine GFS_RRTMG_pre_finalize diff --git a/physics/GFS_calpreciptype.f90 b/physics/GFS_calpreciptype.f90 index d5fe86688..a20d134fb 100644 --- a/physics/GFS_calpreciptype.f90 +++ b/physics/GFS_calpreciptype.f90 @@ -5,41 +5,41 @@ module GFS_calpreciptype contains -!>\section arg_table_GFS_calpreciptype_init Argument Table +!> \section arg_table_GFS_calpreciptype_init Argument Table !! subroutine GFS_calpreciptype_init end subroutine GFS_calpreciptype_init -!!\section arg_table_GFS_calpreciptype_run Argument Table -!!| local var name | longname | description | units | rank | type | kind | intent | optional | -!!|----------------|---------------------------------------------------|-------------------------------------------------------|---------|------|---------|-----------|--------|----------| -!!| kdt | index_of_time_step | current time step index | index | 0 | integer | | in | F | -!!| nrcm | array_dimension_of_random_number | second dimension of random number array | count | 0 | integer | | in | F | -!!| im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | -!!| ix | horizontal_dimension | horizontal dimension | index | 0 | integer | | in | F | -!!| lm | vertical_dimension | vertical layer dimension | index | 0 | integer | | in | F | -!!| lp1 | vertical_interface_dimension | vertical interface dimension | index | 0 | integer | | in | F | -!!| randomno | random_number_array | random number array | none | 2 | real | | in | F | -!!| cal_pre | flag_for_precipitation_type_algorithm | flag controls precip type algorithm | flag | 0 | logical | | in | F | -!!| gt0 | air_temperature_updated_by_physics | layer mean air temperature | K | 2 | real | kind_phys | in | F | -!!| gq0 | water_vapor_specific_humidity_updated_by_physics | water vapor specific humidity | kg kg-1 | 2 | real | kind_phys | in | F | -!!| prsl | air_pressure | layer mean pressure | Pa | 2 | real | kind_phys | in | F | -!!| prsi | air_pressure_at_interface | pressure at layer interface | Pa | 2 | real | kind_phys | in | F | -!!| rainc | timestep_convective_rainfall_amount | convective rain | m | 1 | real | kind_phys | in | F | -!!| frain | dynamics_to_physics_timestep_ratio | dtf/dtp, dynamics to physics timestep ratio | none | 0 | real | kind_phys | in | F | -!!| rain1 | rainfall_amount_on_dynamics_timestep | convective rainfall amount on dynamics timestep | m | 1 | real | kind_phys | in | F | -!!| phii | geopotential_at_interface | geopotential at model layer interfaces | m2 s-2 | 2 | real | kind_phys | in | F | -!!| n3dfercld | array_dimension_of_microphysics | number of 3D arrays needed for microphysics | count | 0 | integer | | in | F | -!!| tskin | surface_skin_temperature | surface skin temperature | K | 1 | real | kind_phys | in | F | -!!| sr | ratio_of_snowfall_to_rainfall | ratio of snowfall to rainfall | frac | 1 | real | kind_phys | in | F | -!!| phy_f3d | air_temperature_at_previous_time_step | air temperature at previous time step | K | 2 | real | kind_phys | in | F | -!!| prec | timestep_total_rainfall_amount | total rain | m | 1 | real | kind_phys | out | F | -!!| domr | dominant_rain_type | dominant rain type | none | 1 | real | kind_phys | out | F | -!!| domzr | dominant_freezing_rain_type | dominant freezing rain type | none | 1 | real | kind_phys | out | F | -!!| domip | dominant_sleet_type | dominant sleet type | none | 1 | real | kind_phys | out | F | -!!| doms | dominant_snow_type | dominant snow type | none | 1 | real | kind_phys | out | F | -!!| srflag | flag_for_precipitation_type | snow(1)/rain(0) flag for precipitation | 1 | 1 | real | kind_phys | out | F | -!!| tprcp | precipitation_amount_in_one_dynamics_time_step | precipitation amount in one dynamics time step | m | 1 | real | kind_phys | out | F | +!> \section arg_table_GFS_calpreciptype_run Argument Table +!! | local var name | longname | description | units | rank | type | kind | intent | optional | +!! |----------------|---------------------------------------------------|-------------------------------------------------------|---------|------|---------|-----------|--------|----------| +!! | kdt | index_of_time_step | current time step index | index | 0 | integer | | in | F | +!! | nrcm | array_dimension_of_random_number | second dimension of random number array | count | 0 | integer | | in | F | +!! | im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | +!! | ix | horizontal_dimension | horizontal dimension | index | 0 | integer | | in | F | +!! | lm | vertical_dimension | vertical layer dimension | index | 0 | integer | | in | F | +!! | lp1 | vertical_interface_dimension | vertical interface dimension | index | 0 | integer | | in | F | +!! | randomno | random_number_array | random number array | none | 2 | real | | in | F | +!! | cal_pre | flag_for_precipitation_type_algorithm | flag controls precip type algorithm | flag | 0 | logical | | in | F | +!! | gt0 | air_temperature_updated_by_physics | layer mean air temperature | K | 2 | real | kind_phys | in | F | +!! | gq0 | water_vapor_specific_humidity_updated_by_physics | water vapor specific humidity | kg kg-1 | 2 | real | kind_phys | in | F | +!! | prsl | air_pressure | layer mean pressure | Pa | 2 | real | kind_phys | in | F | +!! | prsi | air_pressure_at_interface | pressure at layer interface | Pa | 2 | real | kind_phys | in | F | +!! | rainc | timestep_convective_rainfall_amount | convective rain | m | 1 | real | kind_phys | in | F | +!! | frain | dynamics_to_physics_timestep_ratio | dtf/dtp, dynamics to physics timestep ratio | none | 0 | real | kind_phys | in | F | +!! | rain1 | rainfall_amount_on_physics_timestep | convective rainfall amount on physics timestep | m | 1 | real | kind_phys | in | F | +!! | phii | geopotential_at_interface | geopotential at model layer interfaces | m2 s-2 | 2 | real | kind_phys | in | F | +!! | n3dfercld | array_dimension_of_microphysics | number of 3D arrays needed for microphysics | count | 0 | integer | | in | F | +!! | tskin | surface_skin_temperature | surface skin temperature | K | 1 | real | kind_phys | in | F | +!! | sr | ratio_of_snowfall_to_rainfall | ratio of snowfall to rainfall | frac | 1 | real | kind_phys | in | F | +!! | phy_f3d | air_temperature_at_previous_time_step | air temperature at previous time step | K | 2 | real | kind_phys | in | F | +!! | prec | timestep_total_rainfall_amount | total rain | m | 1 | real | kind_phys | out | F | +!! | domr | dominant_rain_type | dominant rain type | none | 1 | real | kind_phys | out | F | +!! | domzr | dominant_freezing_rain_type | dominant freezing rain type | none | 1 | real | kind_phys | out | F | +!! | domip | dominant_sleet_type | dominant sleet type | none | 1 | real | kind_phys | out | F | +!! | doms | dominant_snow_type | dominant snow type | none | 1 | real | kind_phys | out | F | +!! | srflag | flag_for_precipitation_type | snow(1)/rain(0) flag for precipitation | flag | 1 | real | kind_phys | out | F | +!! | tprcp | precipitation_amount_in_one_dynamics_time_step | precipitation amount in one dynamics time step | m | 1 | real | kind_phys | out | F | !! subroutine GFS_calpreciptype_run(kdt,nrcm,im,ix,lm,lp1,randomno, & cal_pre, & diff --git a/physics/GFS_rad_time_vary.f90 b/physics/GFS_rad_time_vary.f90 index 2087988e6..0a3aa0138 100644 --- a/physics/GFS_rad_time_vary.f90 +++ b/physics/GFS_rad_time_vary.f90 @@ -5,21 +5,21 @@ module GFS_rad_time_vary !>\defgroup GFS_rad_time_vary GFS RRTMG Update !! @{ -!!\section arg_table_GFS_rad_time_vary_init Argument Table +!! \section arg_table_GFS_rad_time_vary_init Argument Table !! subroutine GFS_rad_time_vary_init end subroutine GFS_rad_time_vary_init -!!\section arg_table_GFS_rad_time_vary_run Argument Table -!!| local var name | longname | description | units | rank | type | kind | intent | optional | -!!|-------------------|---------------------------------------------------------------|-------------------------------------------------------------------------------|----------|------|-------------------------------|-----------|--------|----------| -!!| Model | FV3-GFS_Control_type | Fortran DDT containing FV3-GFS model control parameters | DDT | 0 | GFS_typedefs%GFS_control_type | | in | F | -!!| Statein | FV3-GFS_Statein_type | Fortran DDT containing FV3-GFS prognostic state data in from dycore | DDT | 0 | GFS_typedefs%GFS_stateout_type| | in | F | -!!| Tbd | FV3-GFS_Tbd_type | Fortran DDT containing FV3-GFS data not yet assigned to a defined container | DDT | 0 | GFS_typedefs%GFS_tbd_type | | in | F | -!!| blksz | horizontal_block_size | horizontal block size for explicit data blocking | none | 1 | integer | | in | F | -!!| sec | seconds_elapsed_since_model_initialization | seconds elapsed since model initialization | s | 0 | real | kind_phys | in | F | -!!| ictmflg | flag_for_initial_time-date_control | flag for initial time/date control | none | 0 | integer | | in | F | -!!| isolar | flag_for_solar_constant | solar constant control flag | none | 0 | integer | | in | F | +!> \section arg_table_GFS_rad_time_vary_run Argument Table +!! | local var name | longname | description | units | rank | type | kind | intent | optional | +!! |-------------------|---------------------------------------------------------------|-------------------------------------------------------------------------------|----------|------|-------------------------------|-----------|--------|----------| +!! | Model | FV3-GFS_Control_type | Fortran DDT containing FV3-GFS model control parameters | DDT | 0 | GFS_typedefs%GFS_control_type | | in | F | +!! | Statein | FV3-GFS_Statein_type | Fortran DDT containing FV3-GFS prognostic state data in from dycore | DDT | 0 | GFS_typedefs%GFS_statein_type | | in | F | +!! | Tbd | FV3-GFS_Tbd_type | Fortran DDT containing FV3-GFS data not yet assigned to a defined container | DDT | 0 | GFS_typedefs%GFS_tbd_type | | in | F | +!! | blksz | horizontal_block_size | horizontal block size for explicit data blocking | none | 1 | integer | | in | F | +!! | sec | seconds_elapsed_since_model_initialization | seconds elapsed since model initialization | s | 0 | real | kind_phys | in | F | +!! | ictmflg | flag_for_initial_time-date_control | flag for initial time/date control | none | 0 | integer | | in | F | +!! | isolar | flag_for_solar_constant | solar constant control flag | none | 0 | integer | | in | F | !! subroutine GFS_rad_time_vary_run (Model, Statein, Tbd, blksz, sec, ictmflg, isolar) @@ -99,7 +99,7 @@ subroutine GFS_rad_time_vary_run (Model, Statein, Tbd, blksz, sec, ictmflg, isol end subroutine GFS_rad_time_vary_run -!!\section arg_table_GFS_rad_time_vary_finalize Argument Table +!> \section arg_table_GFS_rad_time_vary_finalize Argument Table !! subroutine GFS_rad_time_vary_finalize() end subroutine GFS_rad_time_vary_finalize diff --git a/physics/GFS_radlw_post.f90 b/physics/GFS_radlw_post.f90 index c55aea5b3..e7348d083 100644 --- a/physics/GFS_radlw_post.f90 +++ b/physics/GFS_radlw_post.f90 @@ -5,24 +5,24 @@ module GFS_radlw_post !>\defgroup GFS_radlw_post GFS RRTMG/RADLW Scheme Post !! @{ -!>\section arg_table_GFS_radlw_post_init Argument Table +!> \section arg_table_GFS_radlw_post_init Argument Table !! subroutine GFS_radlw_post_init() end subroutine GFS_radlw_post_init -!>\section arg_table_GFS_radlw_post_run Argument Table -!!| local var name | longname | description | units | rank | type | kind | intent | optional | -!!|-------------------|-----------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------|----------|------|-------------------------------|-----------|-----------|----------| -!!| Model | FV3-GFS_Control_type | Fortran DDT containing FV3-GFS model control parameters | DDT | 0 | GFS_typedefs%GFS_control_type | | in | F | -!!| Grid | FV3-GFS_Grid_type | Fortran DDT containing FV3-GFS grid and interpolation related data | DDT | 0 | GFS_typedefs%GFS_grid_type | | in | F | -!!| Radtend | FV3-GFS_Radtend_type | Fortran DDT containing FV3-GFS fields targetted for diagnostic output | DDT | 0 | GFS_typedefs%GFS_radtend_type | | inout | F | -!!| Coupling | FV3-GFS_Coupling_type | Fortran DDT containing FV3-GFS fields to/from coupling with other components | DDT | 0 | GFS_typedefs%GFS_coupling_type| | inout | F | -!!| ltp | extra_top_layer | extra top layers | none | 0 | integer | | in | F | -!!| lm | vertical_layer_dimension_for_radiation | number of vertical layers for radiation calculation | index | 0 | integer | | in | F | -!!| kd | vertical_index_difference_between_in-out_and_local | vertical index difference between in/out and local | index | 0 | integer | | in | F | -!!| tsfa | surface_air_temperature_for_radiation | lowest model layer air temperature for radiation | K | 1 | real | kind_phys | in | F | -!!| htlwc | tendency_of_air_temperature_due_to_longwave_heating_on_radiation_time_step | total sky heating rate due to longwave radiation | K s-1 | 2 | real | kind_phys | in | F | -!!| htlw0 | tendency_of_air_temperature_due_to_longwave_heating_assuming_clear_sky_on_radiation_time_step | clear sky heating rate due to longwave radiation | K s-1 | 2 | real | kind_phys | in | F | +!> \section arg_table_GFS_radlw_post_run Argument Table +!! | local var name | longname | description | units | rank | type | kind | intent | optional | +!! |-------------------|-----------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------|----------|------|-------------------------------|-----------|-----------|----------| +!! | Model | FV3-GFS_Control_type | Fortran DDT containing FV3-GFS model control parameters | DDT | 0 | GFS_typedefs%GFS_control_type | | in | F | +!! | Grid | FV3-GFS_Grid_type | Fortran DDT containing FV3-GFS grid and interpolation related data | DDT | 0 | GFS_typedefs%GFS_grid_type | | in | F | +!! | Radtend | FV3-GFS_Radtend_type | Fortran DDT containing FV3-GFS fields targetted for diagnostic output | DDT | 0 | GFS_typedefs%GFS_radtend_type | | inout | F | +!! | Coupling | FV3-GFS_Coupling_type | Fortran DDT containing FV3-GFS fields to/from coupling with other components | DDT | 0 | GFS_typedefs%GFS_coupling_type| | inout | F | +!! | ltp | extra_top_layer | extra top layers | none | 0 | integer | | in | F | +!! | lm | vertical_layer_dimension_for_radiation | number of vertical layers for radiation calculation | index | 0 | integer | | in | F | +!! | kd | vertical_index_difference_between_in-out_and_local | vertical index difference between in/out and local | index | 0 | integer | | in | F | +!! | tsfa | surface_air_temperature_for_radiation | lowest model layer air temperature for radiation | K | 1 | real | kind_phys | in | F | +!! | htlwc | tendency_of_air_temperature_due_to_longwave_heating_on_radiation_time_step | total sky heating rate due to longwave radiation | K s-1 | 2 | real | kind_phys | in | F | +!! | htlw0 | tendency_of_air_temperature_due_to_longwave_heating_assuming_clear_sky_on_radiation_time_step | clear sky heating rate due to longwave radiation | K s-1 | 2 | real | kind_phys | in | F | !! subroutine GFS_radlw_post_run (Model, Grid, Radtend, Coupling, & ltp, lm, kd, tsfa, htlwc, htlw0) @@ -80,7 +80,7 @@ subroutine GFS_radlw_post_run (Model, Grid, Radtend, Coupling, & end subroutine GFS_radlw_post_run -!>\section arg_table_GFS_radlw_post_finalize Argument Table +!> \section arg_table_GFS_radlw_post_finalize Argument Table !! subroutine GFS_radlw_post_finalize () end subroutine GFS_radlw_post_finalize diff --git a/physics/GFS_radlw_pre.f90 b/physics/GFS_radlw_pre.f90 index 76b019475..23349e894 100644 --- a/physics/GFS_radlw_pre.f90 +++ b/physics/GFS_radlw_pre.f90 @@ -6,21 +6,21 @@ module GFS_radlw_pre !>\defgroup GFS_radlw_pre GFS RADLW Scheme Pre !! @{ -!>\section arg_table_GFS_radlw_pre_init Argument Table +!> \section arg_table_GFS_radlw_pre_init Argument Table !! subroutine GFS_radlw_pre_init () end subroutine GFS_radlw_pre_init -!>\section arg_table_GFS_radlw_pre_run Argument Table -!!| local var name | longname | description | units | rank | type | kind | intent | optional | -!!|-------------------|-------------------------------------------|----------------------------------------------------------------------|----------|------|-------------------------------|-----------|--------|----------| -!!| Model | FV3-GFS_Control_type | Fortran DDT containing FV3-GFS model control parameters | DDT | 0 | GFS_typedefs%GFS_control_type | | in | F | -!!| Grid | FV3-GFS_Grid_type | Fortran DDT containing FV3-GFS grid and interpolation related data | DDT | 0 | GFS_typedefs%GFS_grid_type | | in | F | -!!| Sfcprop | FV3-GFS_Sfcprop_type | Fortran DDT containing FV3-GFS surface fields | DDT | 0 | GFS_typedefs%GFS_sfcprop_type | | in | F | -!!| Radtend | FV3-GFS_Radtend_type | Fortran DDT containing FV3-GFS radiation tendencies | DDT | 0 | GFS_typedefs%GFS_radtend_type | | inout | F | -!!| im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | -!!| tsfg | surface_ground_temperature_for_radiation | surface ground temperature for radiation | K | 1 | real | kind_phys | in | F | -!!| tsfa | surface_air_temperature_for_radiation | lowest model layer air temperature for radiation | K | 1 | real | kind_phys | in | F | +!> \section arg_table_GFS_radlw_pre_run Argument Table +!! | local var name | longname | description | units | rank | type | kind | intent | optional | +!! |-------------------|-------------------------------------------|----------------------------------------------------------------------|----------|------|-------------------------------|-----------|--------|----------| +!! | Model | FV3-GFS_Control_type | Fortran DDT containing FV3-GFS model control parameters | DDT | 0 | GFS_typedefs%GFS_control_type | | in | F | +!! | Grid | FV3-GFS_Grid_type | Fortran DDT containing FV3-GFS grid and interpolation related data | DDT | 0 | GFS_typedefs%GFS_grid_type | | in | F | +!! | Sfcprop | FV3-GFS_Sfcprop_type | Fortran DDT containing FV3-GFS surface fields | DDT | 0 | GFS_typedefs%GFS_sfcprop_type | | in | F | +!! | Radtend | FV3-GFS_Radtend_type | Fortran DDT containing FV3-GFS radiation tendencies | DDT | 0 | GFS_typedefs%GFS_radtend_type | | inout | F | +!! | im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | +!! | tsfg | surface_ground_temperature_for_radiation | surface ground temperature for radiation | K | 1 | real | kind_phys | in | F | +!! | tsfa | surface_air_temperature_for_radiation | lowest model layer air temperature for radiation | K | 1 | real | kind_phys | in | F | !! subroutine GFS_radlw_pre_run (Model, Grid, Sfcprop, Radtend, im, tsfg, tsfa) @@ -52,7 +52,7 @@ subroutine GFS_radlw_pre_run (Model, Grid, Sfcprop, Radtend, im, tsfg, tsfa) end subroutine GFS_radlw_pre_run -!>\section arg_table_GFS_radlw_pre_finalize Argument Table +!> \section arg_table_GFS_radlw_pre_finalize Argument Table !! subroutine GFS_radlw_pre_finalize () end subroutine GFS_radlw_pre_finalize diff --git a/physics/GFS_radsw_post.f90 b/physics/GFS_radsw_post.f90 index 18428fb27..68d70f2c7 100644 --- a/physics/GFS_radsw_post.f90 +++ b/physics/GFS_radsw_post.f90 @@ -5,30 +5,30 @@ module GFS_radsw_post !>\defgroup GFS_radsw_post GFS RRTMG/RADSW Scheme Post !! @{ -!>\section arg_table_GFS_radsw_post_init Argument Table +!> \section arg_table_GFS_radsw_post_init Argument Table !! subroutine GFS_radsw_post_init () end subroutine GFS_radsw_post_init -!>\section arg_table_GFS_radsw_post_run Argument Table -!!| local var name | longname | description | units | rank | type | kind | intent | optional | -!!|-------------------|-------------------------------------------------------------------------|-------------------------------------------------------------------------------|----------|------|-------------------------------|-----------|-----------|----------| -!!| Model | FV3-GFS_Control_type | Fortran DDT containing FV3-GFS model control parameters | DDT | 0 | GFS_typedefs%GFS_control_type | | in | F | -!!| Grid | FV3-GFS_Grid_type | Fortran DDT containing FV3-GFS grid and interpolation related data | DDT | 0 | GFS_typedefs%GFS_grid_type | | in | F | -!!| Diag | FV3-GFS_Diag_type | Fortran DDT containing FV3-GFS diagnotics data | DDT | 0 | GFS_typedefs%GFS_diag_type | | inout | F | -!!| Radtend | FV3-GFS_Radtend_type | Fortran DDT containing FV3-GFS fields targetted for diagnostic output | DDT | 0 | GFS_typedefs%GFS_radtend_type | | inout | F | -!!| Coupling | FV3-GFS_Coupling_type | Fortran DDT containing FV3-GFS fields to/from coupling with other components | DDT | 0 | GFS_typedefs%GFS_coupling_type| | inout | F | -!!| ltp | extra_top_layer | extra top layers | none | 0 | integer | | in | F | -!!| nday | daytime_points_dimension | daytime points dimension | index | 0 | integer | | in | F | -!!| lm | vertical_layer_dimension_for_radiation | number of vertical layers for radiation calculation | index | 0 | integer | | in | F | -!!| kd | vertical_index_difference_between_in-out_and_local | vertical index difference between in/out and local | index | 0 | integer | | in | F | -!!| htswc | tendency_of_air_temperature_due_to_shortwave_heating | total sky heating rate due to shortwave radiation | K s-1 | 2 | real | kind_phys | in | F | -!!| htsw0 | tendency_of_air_temperature_due_to_shortwave_heating_assuming_clear_sky | clear sky heating rates due to shortwave radiation | K s-1 | 2 | real | kind_phys | in | F | -!!| sfcalb1 | surface_albedo_due_to_near_IR_direct | surface albedo due to near IR direct beam | none | 1 | real | kind_phys | in | F | -!!| sfcalb2 | surface_albedo_due_to_near_IR_diffused | surface albedo due to near IR diffused beam | none | 1 | real | kind_phys | in | F | -!!| sfcalb3 | surface_albedo_due_to_UV_and_VIS_direct | surface albedo due to UV+VIS direct beam | none | 1 | real | kind_phys | in | F | -!!| sfcalb4 | surface_albedo_due_to_UV_and_VIS_diffused | surface albedo due to UV+VIS diffused beam | none | 1 | real | kind_phys | in | F | -!!| scmpsw | components_of_surface_downward_shortwave_fluxes | derived type for special components of surface downward shortwave fluxes | W m-2 | 1 | cmpfsw_type | | out | F | +!> \section arg_table_GFS_radsw_post_run Argument Table +!! | local var name | longname | description | units | rank | type | kind | intent | optional | +!! |-------------------|-------------------------------------------------------------------------|-------------------------------------------------------------------------------|----------|------|-------------------------------|-----------|-----------|----------| +!! | Model | FV3-GFS_Control_type | Fortran DDT containing FV3-GFS model control parameters | DDT | 0 | GFS_typedefs%GFS_control_type | | in | F | +!! | Grid | FV3-GFS_Grid_type | Fortran DDT containing FV3-GFS grid and interpolation related data | DDT | 0 | GFS_typedefs%GFS_grid_type | | in | F | +!! | Diag | FV3-GFS_Diag_type | Fortran DDT containing FV3-GFS diagnotics data | DDT | 0 | GFS_typedefs%GFS_diag_type | | inout | F | +!! | Radtend | FV3-GFS_Radtend_type | Fortran DDT containing FV3-GFS fields targetted for diagnostic output | DDT | 0 | GFS_typedefs%GFS_radtend_type | | inout | F | +!! | Coupling | FV3-GFS_Coupling_type | Fortran DDT containing FV3-GFS fields to/from coupling with other components | DDT | 0 | GFS_typedefs%GFS_coupling_type| | inout | F | +!! | ltp | extra_top_layer | extra top layers | none | 0 | integer | | in | F | +!! | nday | daytime_points_dimension | daytime points dimension | index | 0 | integer | | in | F | +!! | lm | vertical_layer_dimension_for_radiation | number of vertical layers for radiation calculation | index | 0 | integer | | in | F | +!! | kd | vertical_index_difference_between_in-out_and_local | vertical index difference between in/out and local | index | 0 | integer | | in | F | +!! | htswc | tendency_of_air_temperature_due_to_shortwave_heating | total sky heating rate due to shortwave radiation | K s-1 | 2 | real | kind_phys | in | F | +!! | htsw0 | tendency_of_air_temperature_due_to_shortwave_heating_assuming_clear_sky | clear sky heating rates due to shortwave radiation | K s-1 | 2 | real | kind_phys | in | F | +!! | sfcalb1 | surface_albedo_due_to_near_IR_direct | surface albedo due to near IR direct beam | frac | 1 | real | kind_phys | in | F | +!! | sfcalb2 | surface_albedo_due_to_near_IR_diffused | surface albedo due to near IR diffused beam | frac | 1 | real | kind_phys | in | F | +!! | sfcalb3 | surface_albedo_due_to_UV_and_VIS_direct | surface albedo due to UV+VIS direct beam | frac | 1 | real | kind_phys | in | F | +!! | sfcalb4 | surface_albedo_due_to_UV_and_VIS_diffused | surface albedo due to UV+VIS diffused beam | frac | 1 | real | kind_phys | in | F | +!! | scmpsw | components_of_surface_downward_shortwave_fluxes | derived type for special components of surface downward shortwave fluxes | W m-2 | 1 | cmpfsw_type | | out | F | !! subroutine GFS_radsw_post_run (Model, Grid, Diag, Radtend, Coupling, & ltp, nday, lm, kd, htswc, htsw0, & ! --input @@ -131,7 +131,7 @@ subroutine GFS_radsw_post_run (Model, Grid, Diag, Radtend, Coupling, & end subroutine GFS_radsw_post_run -!>\section arg_table_GFS_radsw_post_finalize Argument Table +!> \section arg_table_GFS_radsw_post_finalize Argument Table !! subroutine GFS_radsw_post_finalize () end subroutine GFS_radsw_post_finalize diff --git a/physics/GFS_radsw_pre.f90 b/physics/GFS_radsw_pre.f90 index 2150ddd31..81bf62681 100644 --- a/physics/GFS_radsw_pre.f90 +++ b/physics/GFS_radsw_pre.f90 @@ -6,25 +6,25 @@ module GFS_radsw_pre !>\defgroup GFS_radsw_pre GFS RADSW Scheme Pre !! @{ -!>\section arg_table_GFS_radsw_pre_init Argument Table +!> \section arg_table_GFS_radsw_pre_init Argument Table !! subroutine GFS_radsw_pre_init () end subroutine GFS_radsw_pre_init -!>\section arg_table_GFS_radsw_pre_run Argument Table -!!| local var name | longname | description | units | rank | type | kind | intent | optional | -!!|----------------|-------------------------------------------|----------------------------------------------------------------------|----------|------|-------------------------------|-----------|--------|----------| -!!| Model | FV3-GFS_Control_type | Fortran DDT containing FV3-GFS model control parameters | DDT | 0 | GFS_typedefs%GFS_control_type | | in | F | -!!| Grid | FV3-GFS_Grid_type | Fortran DDT containing FV3-GFS grid and interpolation related data | DDT | 0 | GFS_typedefs%GFS_grid_type | | in | F | -!!| Sfcprop | FV3-GFS_Sfcprop_type | Fortran DDT containing FV3-GFS surface fields | DDT | 0 | GFS_typedefs%GFS_sfcprop_type | | in | F | -!!| Radtend | FV3-GFS_Radtend_type | Fortran DDT containing FV3-GFS radiation tendencies | DDT | 0 | GFS_typedefs%GFS_radtend_type | | inout | F | -!!| im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | -!!| tsfg | surface_ground_temperature_for_radiation | surface ground temperature for radiation | K | 1 | real | kind_phys | in | F | -!!| tsfa | surface_air_temperature_for_radiation | lowest model layer air temperature for radiation | K | 1 | real | kind_phys | in | F | -!!| sfcalb1 | surface_albedo_due_to_near_IR_direct | surface albedo due to near IR direct beam | none | 1 | real | kind_phys | out | F | -!!| sfcalb2 | surface_albedo_due_to_near_IR_diffused | surface albedo due to near IR diffused beam | none | 1 | real | kind_phys | out | F | -!!| sfcalb3 | surface_albedo_due_to_UV_and_VIS_direct | surface albedo due to UV+VIS direct beam | none | 1 | real | kind_phys | out | F | -!!| sfcalb4 | surface_albedo_due_to_UV_and_VIS_diffused | surface albedo due to UV+VIS diffused beam | none | 1 | real | kind_phys | out | F | +!> \section arg_table_GFS_radsw_pre_run Argument Table +!! | local var name | longname | description | units | rank | type | kind | intent | optional | +!! |----------------|-------------------------------------------|----------------------------------------------------------------------|----------|------|-------------------------------|-----------|--------|----------| +!! | Model | FV3-GFS_Control_type | Fortran DDT containing FV3-GFS model control parameters | DDT | 0 | GFS_typedefs%GFS_control_type | | in | F | +!! | Grid | FV3-GFS_Grid_type | Fortran DDT containing FV3-GFS grid and interpolation related data | DDT | 0 | GFS_typedefs%GFS_grid_type | | in | F | +!! | Sfcprop | FV3-GFS_Sfcprop_type | Fortran DDT containing FV3-GFS surface fields | DDT | 0 | GFS_typedefs%GFS_sfcprop_type | | in | F | +!! | Radtend | FV3-GFS_Radtend_type | Fortran DDT containing FV3-GFS radiation tendencies | DDT | 0 | GFS_typedefs%GFS_radtend_type | | inout | F | +!! | im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | +!! | tsfg | surface_ground_temperature_for_radiation | surface ground temperature for radiation | K | 1 | real | kind_phys | in | F | +!! | tsfa | surface_air_temperature_for_radiation | lowest model layer air temperature for radiation | K | 1 | real | kind_phys | in | F | +!! | sfcalb1 | surface_albedo_due_to_near_IR_direct | surface albedo due to near IR direct beam | frac | 1 | real | kind_phys | out | F | +!! | sfcalb2 | surface_albedo_due_to_near_IR_diffused | surface albedo due to near IR diffused beam | frac | 1 | real | kind_phys | out | F | +!! | sfcalb3 | surface_albedo_due_to_UV_and_VIS_direct | surface albedo due to UV+VIS direct beam | frac | 1 | real | kind_phys | out | F | +!! | sfcalb4 | surface_albedo_due_to_UV_and_VIS_diffused | surface albedo due to UV+VIS diffused beam | frac | 1 | real | kind_phys | out | F | !! subroutine GFS_radsw_pre_run (Model, Grid, Sfcprop, Radtend, im, & tsfg, tsfa, sfcalb1,sfcalb2, sfcalb3, sfcalb4 ) @@ -80,7 +80,7 @@ subroutine GFS_radsw_pre_run (Model, Grid, Sfcprop, Radtend, im, & end subroutine GFS_radsw_pre_run -!>\section arg_table_GFS_radsw_pre_finalize Argument Table +!> \section arg_table_GFS_radsw_pre_finalize Argument Table !! subroutine GFS_radsw_pre_finalize () end subroutine GFS_radsw_pre_finalize diff --git a/physics/GFS_suite_interstitial.f90 b/physics/GFS_suite_interstitial.f90 index 08bfcffd2..ac06ee452 100644 --- a/physics/GFS_suite_interstitial.f90 +++ b/physics/GFS_suite_interstitial.f90 @@ -165,7 +165,7 @@ end subroutine GFS_suite_interstitial_3_finalize !! | adjsfculw | surface_upwelling_longwave_flux | surface upwelling longwave flux at current time | W m-2 | 1 | real | kind_phys | in | F | !! | xmu | zenith_angle_temporal_adjustment_factor_for_shortwave_fluxes | zenith angle temporal adjustment factor for shortwave fluxes | none | 1 | real | kind_phys | in | F | !! | Diag | FV3-GFS_Diag_type | Fortran DDT containing FV3-GFS fields targeted for diagnostic output | DDT | 0 | GFS_typedefs%GFS_diag_type | | inout | F | -!! | kcnv | flag_deep_convection | flag indicating whether convection occurs in column (0 or 1) | index | 1 | integer | | out | F | +!! | kcnv | flag_deep_convection | flag indicating whether convection occurs in column (0 or 1) | flag | 1 | integer | | out | F | !! | heat | kinematic_surface_upward_sensible_heat_flux | kinematic surface upward sensible heat flux | K m s-1 | 1 | real | kind_phys | out | F | !! | evap | kinematic_surface_upward_latent_heat_flux | kinematic surface upward latent heat flux | kg kg-1 m s-1 | 1 | real | kind_phys | out | F | !! diff --git a/physics/GFS_suite_setup.f90 b/physics/GFS_suite_setup.f90 index 216b556ee..c7457faab 100644 --- a/physics/GFS_suite_setup.f90 +++ b/physics/GFS_suite_setup.f90 @@ -81,13 +81,13 @@ end subroutine GFS_suite_setup_2_finalize !> \section arg_table_GFS_suite_setup_2_run Argument Table !! | local var name | longname | description | units | rank | type | kind | intent | optional | !! |----------------|-------------------------------------------------------------------------|-------------------------------------------------------------------------|---------------|------|-------------------------------|-----------|--------|----------| -!! | blksz | horizontal_block_size | number of grid columns used for explicit data blocking for physics | count | 1 | integer | | in | F | -!! | Grid | FV3-GFS_Grid_type | Fortran DDT containing FV3-GFS grid and interpolation related data | DDT | 1 | GFS_typedefs%GFS_grid_type | | in | F | +!! | blksz | horizontal_block_size_tmp_all_blocks | number of grid columns used for explicit data blocking for physics | count | 1 | integer | | in | F | +!! | Grid | FV3-GFS_Grid_type_tmp_all_blocks | Fortran DDT containing FV3-GFS grid and interpolation related data | DDT | 1 | GFS_typedefs%GFS_grid_type | | in | F | !! | Model | FV3-GFS_Control_type | Fortran DDT containing FV3-GFS model control parameters | DDT | 0 | GFS_typedefs%GFS_control_type | | inout | F | -!! | Tbd | FV3-GFS_Tbd_type | Fortran DDT containing FV3-GFS miscellaneous data | DDT | 1 | GFS_typedefs%GFS_tbd_type | | inout | F | -!! | Sfcprop | FV3-GFS_Sfcprop_type | Fortran DDT containing FV3-GFS surface fields | DDT | 1 | GFS_typedefs%GFS_sfcprop_type | | inout | F | -!! | Cldprop | FV3-GFS_Cldprop_type | Fortran DDT containing FV3-GFS cloud fields | DDT | 1 | GFS_typedefs%GFS_cldprop_type | | inout | F | -!! | Diag | FV3-GFS_Diag_type | Fortran DDT containing FV3-GFS fields targeted for diagnostic output | DDT | 1 | GFS_typedefs%GFS_diag_type | | inout | F | +!! | Tbd | FV3-GFS_Tbd_type_tmp_all_blocks | Fortran DDT containing FV3-GFS miscellaneous data | DDT | 1 | GFS_typedefs%GFS_tbd_type | | inout | F | +!! | Sfcprop | FV3-GFS_Sfcprop_type_tmp_all_blocks | Fortran DDT containing FV3-GFS surface fields | DDT | 1 | GFS_typedefs%GFS_sfcprop_type | | inout | F | +!! | Cldprop | FV3-GFS_Cldprop_type_tmp_all_blocks | Fortran DDT containing FV3-GFS cloud fields | DDT | 1 | GFS_typedefs%GFS_cldprop_type | | inout | F | +!! | Diag | FV3-GFS_Diag_type_tmp_all_blocks | Fortran DDT containing FV3-GFS fields targeted for diagnostic output | DDT | 1 | GFS_typedefs%GFS_diag_type | | inout | F | !! subroutine GFS_suite_setup_2_run (blksz, Grid, Model, Tbd, Sfcprop, Cldprop, Diag) use mersenne_twister, only: random_setseed, random_number diff --git a/physics/GFS_zhao_carr_pre.f90 b/physics/GFS_zhao_carr_pre.f90 index 029815ea4..0e39f4bb2 100644 --- a/physics/GFS_zhao_carr_pre.f90 +++ b/physics/GFS_zhao_carr_pre.f90 @@ -7,20 +7,20 @@ module GFS_zhao_carr_pre !> \defgroup GFS_zhao_carr_pre GFS Zhao-Carr Scheme pre !! @{ -!!\section arg_table_GFS_zhao_carr_pre_init Argument Table +!! \section arg_table_GFS_zhao_carr_pre_init Argument Table !! subroutine GFS_zhao_carr_pre_init end subroutine GFS_zhao_carr_pre_init -!!\section arg_table_GFS_zhao_carr_pre_run Argument Table -!!| local var name | longname | description | units | rank | type | kind | intent | optional | -!!|----------------|------------------------------------------------------------|----------------------------------------------------------|-------------|------|---------|-----------|--------|----------| -!!| im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | -!!| ix | horizontal_dimension | horizontal dimension | index | 0 | integer | | in | F | -!!| levs | vertical_dimension | vertical layer dimension | index | 0 | integer | | in | F | -!!| cwm | cloud_condensed_water_specific_humidity_updated_by_physics | cloud condensed water specific humidity | kg kg-1 | 2 | real | kind_phys | in | F | -!!| clw1 | cloud_ice_specific_humidity | cloud ice specific humidity | kg kg-1 | 2 | real | kind_phys | out | F | +!> \section arg_table_GFS_zhao_carr_pre_run Argument Table +!! | local var name | longname | description | units | rank | type | kind | intent | optional | +!! |----------------|------------------------------------------------------------|----------------------------------------------------------|-------------|------|---------|-----------|--------|----------| +!! | im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | +!! | ix | horizontal_dimension | horizontal dimension | index | 0 | integer | | in | F | +!! | levs | vertical_dimension | vertical layer dimension | index | 0 | integer | | in | F | +!! | cwm | cloud_condensed_water_specific_humidity_updated_by_physics | cloud condensed water specific humidity | kg kg-1 | 2 | real | kind_phys | in | F | +!! | clw1 | cloud_ice_specific_humidity | cloud ice specific humidity | kg kg-1 | 2 | real | kind_phys | out | F | !! subroutine GFS_zhao_carr_pre_run (im, ix, levs, cwm, clw1 ) @@ -45,7 +45,7 @@ subroutine GFS_zhao_carr_pre_run (im, ix, levs, cwm, clw1 ) end subroutine GFS_zhao_carr_pre_run -!!\section arg_table_GFS_zhao_carr_pre_finalize Argument Table +!> \section arg_table_GFS_zhao_carr_pre_finalize Argument Table !! subroutine GFS_zhao_carr_pre_finalize end subroutine GFS_zhao_carr_pre_finalize diff --git a/physics/dcyc2.f b/physics/dcyc2.f index 6171e6cc6..aac73294a 100644 --- a/physics/dcyc2.f +++ b/physics/dcyc2.f @@ -155,7 +155,7 @@ end subroutine dcyc2t3_init !! \section arg_table_dcyc2t3_run Argument Table !! | local var name | longname | description | units | rank | type | kind | intent | optional | !! |----------------|------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------|---------|------|---------|-----------|--------|----------| -!! | solhr | forecast_hour | forecast time in 24-hour form | hr | 0 | real | kind_phys | in | F | +!! | solhr | forecast_hour | forecast time in 24-hour form | h | 0 | real | kind_phys | in | F | !! | slag | equation_of_time | equation of time | radians | 0 | real | kind_phys | in | F | !! | sdec | sine_of_solar_declination_angle | sine of solar declination angle | none | 0 | real | kind_phys | in | F | !! | cdec | cosine_of_solar_declination_angle | cosine of solar declination angle | none | 0 | real | kind_phys | in | F | diff --git a/physics/gscond.f b/physics/gscond.f index 27506f8ee..764f590aa 100644 --- a/physics/gscond.f +++ b/physics/gscond.f @@ -63,30 +63,30 @@ end subroutine gscond_init !! steps, and on the temperature. Evaporation of cloud is allowed at !! points where the relative humidity is lower than the critical value !! required for condensation. -!!\section arg_table_gscond_run Argument Table -!!| local var name | longname | description | units | rank | type | kind | intent | optional | -!!|----------------|------------------------------------------------------------|----------------------------------------------------------|---------|------|---------|-----------|--------|----------| -!!| im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | -!!| ix | horizontal_dimension | horizontal dimension | index | 0 | integer | | in | F | -!!| km | vertical_dimension | vertical layer dimension | index | 0 | integer | | in | F | -!!| dt | time_step_for_physics | physics time step | s | 0 | real | kind_phys | in | F | -!!| dtf | time_step_for_dynamics | dynamics time step | s | 0 | real | kind_phys | in | F | -!!| prsl | air_pressure | layer mean air pressure | Pa | 2 | real | kind_phys | in | F | -!!| ps | surface_air_pressure | surface pressure | Pa | 1 | real | kind_phys | in | F | -!!| q | water_vapor_specific_humidity_updated_by_physics | water vapor specific humidity | kg kg-1 | 2 | real | kind_phys | inout | F | -!!| clw1 | cloud_ice_specific_humidity | cloud ice specific humidity | kg kg-1 | 2 | real | kind_phys | in | F | -!!| clw2 | cloud_liquid_water_specific_humidity | cloud water specific humidity | kg kg-1 | 2 | real | kind_phys | in | F | -!!| cwm | cloud_condensed_water_specific_humidity_updated_by_physics | cloud condensed water specific humidity | kg kg-1 | 2 | real | kind_phys | out | F | -!!| t | air_temperature_updated_by_physics | layer mean air temperature | K | 2 | real | kind_phys | inout | F | -!!| tp | air_temperature_at_two_time_step_back | air temperature at two time step back | K | 2 | real | kind_phys | inout | F | -!!| qp | water_vapor_specific_humidity_at_two_time_step_back | water vapor specific humidity at two time step back | kg kg-1 | 2 | real | kind_phys | inout | F | -!!| psp | surface_air_pressure_at_two_time_step_back | surface air pressure at two time step back | Pa | 1 | real | kind_phys | inout | F | -!!| tp1 | air_temperature_at_previous_time_step | air temperature at previous time step | K | 2 | real | kind_phys | inout | F | -!!| qp1 | water_vapor_specific_humidity_at_previous_time_step | water vapor specific humidity at previous time step | kg kg-1 | 2 | real | kind_phys | inout | F | -!!| psp1 | surface_air_pressure_at_previous_time_step | surface air surface pressure at previous time step | Pa | 1 | real | kind_phys | inout | F | -!!| u | critical_relative_humidity | critical relative humidity | 1 | 2 | real | kind_phys | in | F | -!!| lprnt | flag_print | flag for printing diagnostics to output | flag | 0 | logical | | in | F | -!!| ipr | horizontal_index_of_printed_column | horizontal index of printed column | index | 0 | integer | | in | F | +!! \section arg_table_gscond_run Argument Table +!! | local var name | longname | description | units | rank | type | kind | intent | optional | +!! |----------------|------------------------------------------------------------|----------------------------------------------------------|---------|------|---------|-----------|--------|----------| +!! | im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | +!! | ix | horizontal_dimension | horizontal dimension | index | 0 | integer | | in | F | +!! | km | vertical_dimension | vertical layer dimension | index | 0 | integer | | in | F | +!! | dt | time_step_for_physics | physics time step | s | 0 | real | kind_phys | in | F | +!! | dtf | time_step_for_dynamics | dynamics time step | s | 0 | real | kind_phys | in | F | +!! | prsl | air_pressure | layer mean air pressure | Pa | 2 | real | kind_phys | in | F | +!! | ps | surface_air_pressure | surface pressure | Pa | 1 | real | kind_phys | in | F | +!! | q | water_vapor_specific_humidity_updated_by_physics | water vapor specific humidity | kg kg-1 | 2 | real | kind_phys | inout | F | +!! | clw1 | cloud_ice_specific_humidity | cloud ice specific humidity | kg kg-1 | 2 | real | kind_phys | in | F | +!! | clw2 | cloud_liquid_water_specific_humidity | cloud water specific humidity | kg kg-1 | 2 | real | kind_phys | in | F | +!! | cwm | cloud_condensed_water_specific_humidity_updated_by_physics | cloud condensed water specific humidity | kg kg-1 | 2 | real | kind_phys | out | F | +!! | t | air_temperature_updated_by_physics | layer mean air temperature | K | 2 | real | kind_phys | inout | F | +!! | tp | air_temperature_at_two_time_step_back | air temperature at two time step back | K | 2 | real | kind_phys | inout | F | +!! | qp | water_vapor_specific_humidity_at_two_time_step_back | water vapor specific humidity at two time step back | kg kg-1 | 2 | real | kind_phys | inout | F | +!! | psp | surface_air_pressure_at_two_time_step_back | surface air pressure at two time step back | Pa | 1 | real | kind_phys | inout | F | +!! | tp1 | air_temperature_at_previous_time_step | air temperature at previous time step | K | 2 | real | kind_phys | inout | F | +!! | qp1 | water_vapor_specific_humidity_at_previous_time_step | water vapor specific humidity at previous time step | kg kg-1 | 2 | real | kind_phys | inout | F | +!! | psp1 | surface_air_pressure_at_previous_time_step | surface air surface pressure at previous time step | Pa | 1 | real | kind_phys | inout | F | +!! | u | critical_relative_humidity | critical relative humidity | frac | 2 | real | kind_phys | in | F | +!! | lprnt | flag_print | flag for printing diagnostics to output | flag | 0 | logical | | in | F | +!! | ipr | horizontal_index_of_printed_column | horizontal index of printed column | index | 0 | integer | | in | F | !! !! \section def Definition of symbols !! - \f$C_{g}\f$: grid-scale condensation rate (\f$s^{-1}\f$) diff --git a/physics/mfdeepcnv.f b/physics/mfdeepcnv.f index f9804727e..e106ebeba 100755 --- a/physics/mfdeepcnv.f +++ b/physics/mfdeepcnv.f @@ -50,7 +50,7 @@ end subroutine sasasdeep_finalize !! | u1 | x_wind_updated_by_physics | updated x-direction wind | m s-1 | 2 | real | kind_phys | inout | F | !! | v1 | y_wind_updated_by_physics | updated y-direction wind | m s-1 | 2 | real | kind_phys | inout | F | !! | cldwrk | cloud_work_function | cloud work function | m2 s-2 | 1 | real | kind_phys | out | F | -!! | rn | rainfall_amount_on_dynamics_timestep | convective rainfall amount on dynamics timestep | m | 1 | real | kind_phys | out | F | +!! | rn | rainfall_amount_on_physics_timestep | convective rainfall amount on physics timestep | m | 1 | real | kind_phys | out | F | !! | kbot | vertical_index_at_cloud_base | index for cloud base | index | 1 | integer | | out | F | !! | ktop | vertical_index_at_cloud_top | index for cloud top | index | 1 | integer | | out | F | !! | kcnv | flag_deep_convection | deep convection: 0=no, 1=yes | flag | 1 | integer | | out | F | diff --git a/physics/mfshalcnv.f b/physics/mfshalcnv.f index bc98beb27..3b6e9c207 100755 --- a/physics/mfshalcnv.f +++ b/physics/mfshalcnv.f @@ -36,7 +36,7 @@ end subroutine sasasshal_init !! | t1 | air_temperature_updated_by_physics | updated temperature | K | 2 | real | kind_phys | inout | F | !! | u1 | x_wind_updated_by_physics | updated x-direction wind | m s-1 | 2 | real | kind_phys | inout | F | !! | v1 | y_wind_updated_by_physics | updated y-direction wind | m s-1 | 2 | real | kind_phys | inout | F | -!! | rn | rainfall_amount_on_dynamics_timestep | convective rainfall amount on dynamics timestep | m | 1 | real | kind_phys | out | F | +!! | rn | rainfall_amount_on_physics_timestep | convective rainfall amount on physics timestep | m | 1 | real | kind_phys | out | F | !! | kbot | vertical_index_at_cloud_base | index at cloud base | index | 1 | integer | | out | F | !! | ktop | vertical_index_at_cloud_top | index at cloud top | index | 1 | integer | | out | F | !! | kcnv | flag_deep_convection | deep convection: 0=no, 1=yes | flag | 1 | integer | | out | F | @@ -1515,7 +1515,7 @@ module sasas_shal_post !! | local var name | longname | description | units | rank | type | kind | intent | optional | !! |----------------|-------------------------------------------------|----------------------------------------------------------------------|---------|------|-------------------------------|-----------|--------|----------| !! | frain | dynamics_to_physics_timestep_ratio | ratio of dynamics timestep to physics timestep | none | 0 | real | kind_phys | in | F | -!! | rain1 | rainfall_amount_on_dynamics_timestep | convective rainfall amount on dynamics timestep | m | 1 | real | kind_phys | in | F | +!! | rain1 | rainfall_amount_on_physics_timestep | convective rainfall amount on physics timestep | m | 1 | real | kind_phys | in | F | !! | cnvc | convective_cloud_cover | convective cloud cover | frac | 2 | real | kind_phys | in | F | !! | cnvw | convective_cloud_water_specific_humidity | convective cloud water specific humidity | kg kg-1 | 2 | real | kind_phys | in | F | !! | Model | FV3-GFS_Control_type | Fortran DDT containing FV3-GFS model control parameters | DDT | 0 | GFS_typedefs%GFS_control_type | | in | F | diff --git a/physics/precpd.f b/physics/precpd.f index de5349507..1c5c61f52 100644 --- a/physics/precpd.f +++ b/physics/precpd.f @@ -22,29 +22,29 @@ end subroutine precpd_init !! \brief This subroutine computes the conversion from condensation to !! precipitation (snow or rain) or evaporation of rain. !! -!!\section arg_table_precpd_run Argument Table -!!| local var name | longname | description | units | rank | type | kind | intent | optional | -!!|----------------|---------------------------------------------------------------|-------------------------------------------------------------------|---------|------|---------|----------|---------|----------| -!!| im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | -!!| ix | horizontal_dimension | horizontal dimension | index | 0 | integer | | in | F | -!!| km | vertical_dimension | vertical layer dimension | index | 0 | integer | | in | F | -!!| dt | time_step_for_physics | physics time step | s | 0 | real | kind_phys| in | F | -!!| del | air_pressure_difference_between_midlayers | pressure level thickness | Pa | 2 | real | kind_phys| in | F | -!!| prsl | air_pressure | layer mean pressure | Pa | 2 | real | kind_phys| in | F | -!!| q | water_vapor_specific_humidity_updated_by_physics | water vapor specific humidity | kg kg-1 | 2 | real | kind_phys| inout | F | -!!| cwm | cloud_condensed_water_specific_humidity_updated_by_physics | cloud condensed water specific humidity | kg kg-1 | 2 | real | kind_phys| inout | F | -!!| t | air_temperature_updated_by_physics | layer mean air temperature | K | 2 | real | kind_phys| inout | F | -!!| rn | rainfall_amount_on_dynamics_timestep | convective rainfall amount on dynamics timestep | m | 1 | real | kind_phys| out | F | -!!| sr | ratio_of_snowfall_to_rainfall | ratio of snowfall to large-scale rainfall | frac | 1 | real | kind_phys| out | F | -!!| rainp | rain_water_path | rainwater path | kg m-3 | 2 | real | kind_phys| out | F | -!!| u00k | critical_relative_humidity | critical relative humidity | 1 | 2 | real | kind_phys| in | F | -!!| psautco | coefficient_from_cloud_ice_to_snow | conversion coefficient from cloud ice to snow | 1 | 0 | real | kind_phys| in | F | -!!| prautco | coefficient_from_cloud_water_to_rain | conversion coefficient from cloud water to rain | 1 | 0 | real | kind_phys| in | F | -!!| evpco | coefficient_for_evaporation_of_rainfall | coefficient for evaporation of rainfall | 1 | 0 | real | kind_phys| in | F | -!!| wminco | cloud_condensed_water_conversion_threshold | conversion coefficient from cloud liquid and ice to precipitation | 1 | 0 | real | kind_phys| in | F | -!!| wk1 | grid_size_related_coefficient_used_in_scale-sensitive_schemes | grid size related coefficient used in scale-sensitive schemes | | 1 | real | kind_phys| in | F | -!!| lprnt | flag_print | flag for printing diagnostics to output | flag | 0 | logical | | in | F | -!!| jpr | horizontal_index_of_printed_column | horizontal index of printed column | index | 0 | integer | | in | F | +!! \section arg_table_precpd_run Argument Table +!! | local var name | longname | description | units | rank | type | kind | intent | optional | +!! |----------------|---------------------------------------------------------------|-------------------------------------------------------------------|---------|------|---------|----------|---------|----------| +!! | im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | +!! | ix | horizontal_dimension | horizontal dimension | index | 0 | integer | | in | F | +!! | km | vertical_dimension | vertical layer dimension | index | 0 | integer | | in | F | +!! | dt | time_step_for_physics | physics time step | s | 0 | real | kind_phys| in | F | +!! | del | air_pressure_difference_between_midlayers | pressure level thickness | Pa | 2 | real | kind_phys| in | F | +!! | prsl | air_pressure | layer mean pressure | Pa | 2 | real | kind_phys| in | F | +!! | q | water_vapor_specific_humidity_updated_by_physics | water vapor specific humidity | kg kg-1 | 2 | real | kind_phys| inout | F | +!! | cwm | cloud_condensed_water_specific_humidity_updated_by_physics | cloud condensed water specific humidity | kg kg-1 | 2 | real | kind_phys| inout | F | +!! | t | air_temperature_updated_by_physics | layer mean air temperature | K | 2 | real | kind_phys| inout | F | +!! | rn | rainfall_amount_on_physics_timestep | convective rainfall amount on physics timestep | m | 1 | real | kind_phys| out | F | +!! | sr | ratio_of_snowfall_to_rainfall | ratio of snowfall to large-scale rainfall | frac | 1 | real | kind_phys| out | F | +!! | rainp | rain_water_path | rainwater path | kg m-3 | 2 | real | kind_phys| out | F | +!! | u00k | critical_relative_humidity | critical relative humidity | frac | 2 | real | kind_phys| in | F | +!! | psautco | coefficient_from_cloud_ice_to_snow | conversion coefficient from cloud ice to snow | 1 | 0 | real | kind_phys| in | F | +!! | prautco | coefficient_from_cloud_water_to_rain | conversion coefficient from cloud water to rain | 1 | 0 | real | kind_phys| in | F | +!! | evpco | coefficient_for_evaporation_of_rainfall | coefficient for evaporation of rainfall | 1 | 0 | real | kind_phys| in | F | +!! | wminco | cloud_condensed_water_conversion_threshold | conversion coefficient from cloud liquid and ice to precipitation | 1 | 0 | real | kind_phys| in | F | +!! | wk1 | grid_size_related_coefficient_used_in_scale-sensitive_schemes | grid size related coefficient used in scale-sensitive schemes | none | 1 | real | kind_phys| in | F | +!! | lprnt | flag_print | flag for printing diagnostics to output | flag | 0 | logical | | in | F | +!! | jpr | horizontal_index_of_printed_column | horizontal index of printed column | index | 0 | integer | | in | F | !! !! \section general General Algorithm !! The parameterization of precipitation is required in order to remove diff --git a/physics/radlw_main.f b/physics/radlw_main.f index 0d02d0af8..1df691f1b 100644 --- a/physics/radlw_main.f +++ b/physics/radlw_main.f @@ -458,27 +458,27 @@ end subroutine lwrad_init !! | plvl | air_pressure_at_interface_for_radiation_in_hPa | air pressure level | hPa | 2 | real | kind_phys | in | F | !! | tlyr | air_temperature_at_layer_for_radiation | air temperature layer | K | 2 | real | kind_phys | in | F | !! | tlvl | air_temperature_at_interface_for_radiation | air temperature level | K | 2 | real | kind_phys | in | F | -!! | qlyr | water_vapor_specific_humidity_at_layer_for_radiation | specific humidity layer | gm gm-1 | 2 | real | kind_phys | in | F | -!! | olyr | ozone_concentration_at_layer_for_radiation | ozone concentration layer | gm gm-1 | 2 | real | kind_phys | in | F | -!! | gasvmr_co2 | volume_mixing_ratio_co2 | volume mixing ratio co2 | gm gm-1 | 2 | real | kind_phys | in | F | -!! | gasvmr_n2o | volume_mixing_ratio_n2o | volume mixing ratio no2 | gm gm-1 | 2 | real | kind_phys | in | F | -!! | gasvmr_ch4 | volume_mixing_ratio_ch4 | volume mixing ratio ch4 | gm gm-1 | 2 | real | kind_phys | in | F | -!! | gasvmr_o2 | volume_mixing_ratio_o2 | volume mixing ratio o2 | gm gm-1 | 2 | real | kind_phys | in | F | -!! | gasvmr_co | volume_mixing_ratio_co | volume mixing ratio co | gm gm-1 | 2 | real | kind_phys | in | F | -!! | gasvmr_cfc11 | volume_mixing_ratio_cfc11 | volume mixing ratio cfc11 | gm gm-1 | 2 | real | kind_phys | in | F | -!! | gasvmr_cfc12 | volume_mixing_ratio_cfc12 | volume mixing ratio cfc12 | gm gm-1 | 2 | real | kind_phys | in | F | -!! | gasvmr_cfc22 | volume_mixing_ratio_cfc22 | volume mixing ratio cfc22 | gm gm-1 | 2 | real | kind_phys | in | F | -!! | gasvmr_ccl4 | volume_mixing_ratio_ccl4 | volume mixing ratio ccl4 | gm gm-1 | 2 | real | kind_phys | in | F | -!! | icseed | seed_random_numbers | seed for random number generation | | 2 | integer | | in | F | -!! | aeraod | aerosol_optical_depth_for_longwave_bands_01-16 | aerosol optical depth for longwave bands 01-16 | | 3 | real | kind_phys | in | F | -!! | aerssa | aerosol_single_scattering_albedo_for_longwave_bands_01-16 | aerosol single scattering albedo for longwave bands 01-16 | | 3 | real | kind_phys | in | F | +!! | qlyr | water_vapor_specific_humidity_at_layer_for_radiation | specific humidity layer | kg kg-1 | 2 | real | kind_phys | in | F | +!! | olyr | ozone_concentration_at_layer_for_radiation | ozone concentration layer | kg kg-1 | 2 | real | kind_phys | in | F | +!! | gasvmr_co2 | volume_mixing_ratio_co2 | volume mixing ratio co2 | kg kg-1 | 2 | real | kind_phys | in | F | +!! | gasvmr_n2o | volume_mixing_ratio_n2o | volume mixing ratio no2 | kg kg-1 | 2 | real | kind_phys | in | F | +!! | gasvmr_ch4 | volume_mixing_ratio_ch4 | volume mixing ratio ch4 | kg kg-1 | 2 | real | kind_phys | in | F | +!! | gasvmr_o2 | volume_mixing_ratio_o2 | volume mixing ratio o2 | kg kg-1 | 2 | real | kind_phys | in | F | +!! | gasvmr_co | volume_mixing_ratio_co | volume mixing ratio co | kg kg-1 | 2 | real | kind_phys | in | F | +!! | gasvmr_cfc11 | volume_mixing_ratio_cfc11 | volume mixing ratio cfc11 | kg kg-1 | 2 | real | kind_phys | in | F | +!! | gasvmr_cfc12 | volume_mixing_ratio_cfc12 | volume mixing ratio cfc12 | kg kg-1 | 2 | real | kind_phys | in | F | +!! | gasvmr_cfc22 | volume_mixing_ratio_cfc22 | volume mixing ratio cfc22 | kg kg-1 | 2 | real | kind_phys | in | F | +!! | gasvmr_ccl4 | volume_mixing_ratio_ccl4 | volume mixing ratio ccl4 | kg kg-1 | 2 | real | kind_phys | in | F | +!! | icseed | seed_random_numbers | seed for random number generation | none | 2 | integer | | in | F | +!! | aeraod | aerosol_optical_depth_for_longwave_bands_01-16 | aerosol optical depth for longwave bands 01-16 | none | 3 | real | kind_phys | in | F | +!! | aerssa | aerosol_single_scattering_albedo_for_longwave_bands_01-16 | aerosol single scattering albedo for longwave bands 01-16 | frac | 3 | real | kind_phys | in | F | !! | sfemis | surface_longwave_emissivity | surface emissivity | frac | 1 | real | kind_phys | in | F | !! | sfgtmp | surface_ground_temperature_for_radiation | surface ground temperature for radiation | K | 1 | real | kind_phys | in | F | !! | npts | horizontal_loop_extent | horizontal dimension | index | 0 | integer | | in | F | !! | nlay | adjusted_vertical_layer_dimension_for_radiation | number of vertical layers for radiation | index | 0 | integer | | in | F | !! | nlp1 | adjusted_vertical_level_dimension_for_radiation | number of vertical levels for radiation | index | 0 | integer | | in | F | !! | lprnt | flag_to_print | logical flag to print | logical | 0 | logical | | in | F | -!! | cld_cf | total_cloud_fraction | total cloud fraction | | 2 | real | kind_phys | in | F | +!! | cld_cf | total_cloud_fraction | total cloud fraction | frac | 2 | real | kind_phys | in | F | !! | lslwr | flag_to_calc_lw | logical flag to calculate LW irradiances | logical | 0 | logical | | in | F | !! | hlwc | tendency_of_air_temperature_due_to_longwave_heating_on_radiation_time_step | longwave total sky heating rate | K s-1 | 2 | real | kind_phys | out | F | !! | topflx | lw_fluxes_top_atmosphere | longwave total sky fluxes at the top of the atm | W m-2 | 1 | topflw_type | kind_phys | out | F | @@ -494,7 +494,7 @@ end subroutine lwrad_init !! | cld_ref_rain | mean_effective_radius_for_rain_drop | mean effective radius for rain drop | micron | 2 | real | kind_phys | in | T | !! | cld_swp | cloud_snow_water_path | cloud snow water path | g m-2 | 2 | real | kind_phys | in | T | !! | cld_ref_snow | mean_effective_radius_for_snow_flake | mean effective radius for snow flake | micron | 2 | real | kind_phys | in | T | -!! | cld_od | cloud_optical_depth | cloud optical depth | | 2 | real | kind_phys | in | T | +!! | cld_od | cloud_optical_depth | cloud optical depth | none | 2 | real | kind_phys | in | T | !! !> \section gen_lwrad General Algorithm !> @{ diff --git a/physics/radsw_main.f b/physics/radsw_main.f index 77a88ec79..e547d562d 100644 --- a/physics/radsw_main.f +++ b/physics/radsw_main.f @@ -591,31 +591,31 @@ end subroutine swrad_init !! | plvl | air_pressure_at_interface_for_radiation_in_hPa | air pressure level | hPa | 2 | real | kind_phys | in | F | !! | tlyr | air_temperature_at_layer_for_radiation | air temperature layer | K | 2 | real | kind_phys | in | F | !! | tlvl | air_temperature_at_interface_for_radiation | air temperature level | K | 2 | real | kind_phys | in | F | -!! | qlyr | water_vapor_specific_humidity_at_layer_for_radiation | specific humidity layer | gm gm-1 | 2 | real | kind_phys | in | F | -!! | olyr | ozone_concentration_at_layer_for_radiation | ozone concentration layer | gm gm-1 | 2 | real | kind_phys | in | F | -!! | gasvmr_co2 | volume_mixing_ratio_co2 | volume mixing ratio co2 | gm gm-1 | 2 | real | kind_phys | in | F | -!! | gasvmr_n2o | volume_mixing_ratio_n2o | volume mixing ratio no2 | gm gm-1 | 2 | real | kind_phys | in | F | -!! | gasvmr_ch4 | volume_mixing_ratio_ch4 | volume mixing ratio ch4 | gm gm-1 | 2 | real | kind_phys | in | F | -!! | gasvmr_o2 | volume_mixing_ratio_o2 | volume mixing ratio o2 | gm gm-1 | 2 | real | kind_phys | in | F | -!! | icseed | seed_random_numbers | seed for random number generation | | 2 | integer | | in | F | -!! | aeraod | aerosol_optical_depth_for_shortwave_bands_01-16 | aerosol optical depth for shortwave bands 01-16 | | 3 | real | kind_phys | in | F | -!! | aerssa | aerosol_single_scattering_albedo_for_shortwave_bands_01-16 | aerosol single scattering albedo for shortwave bands 01-16 | | 3 | real | kind_phys | in | F | -!! | aerasy | aerosol_asymmetry_parameter_for_shortwave_bands_01-16 | aerosol asymmetry paramter for shortwave bands 01-16 | | 3 | real | kind_phys | in | F | -!! | sfcalb_nir_dir | surface_albedo_due_to_near_IR_direct | surface albedo due to near IR direct beam | | 1 | real | kind_phys | in | F | -!! | sfcalb_nir_dif | surface_albedo_due_to_near_IR_diffused | surface albedo due to near IR diffused beam | | 1 | real | kind_phys | in | F | -!! | sfcalb_uvis_dir | surface_albedo_due_to_UV_and_VIS_direct | surface albedo due to UV+VIS direct beam | | 1 | real | kind_phys | in | F | -!! | sfcalb_uvis_dif | surface_albedo_due_to_UV_and_VIS_diffused | surface albedo due to UV+VIS diffused beam | | 1 | real | kind_phys | in | F | +!! | qlyr | water_vapor_specific_humidity_at_layer_for_radiation | specific humidity layer | kg kg-1 | 2 | real | kind_phys | in | F | +!! | olyr | ozone_concentration_at_layer_for_radiation | ozone concentration layer | kg kg-1 | 2 | real | kind_phys | in | F | +!! | gasvmr_co2 | volume_mixing_ratio_co2 | volume mixing ratio co2 | kg kg-1 | 2 | real | kind_phys | in | F | +!! | gasvmr_n2o | volume_mixing_ratio_n2o | volume mixing ratio no2 | kg kg-1 | 2 | real | kind_phys | in | F | +!! | gasvmr_ch4 | volume_mixing_ratio_ch4 | volume mixing ratio ch4 | kg kg-1 | 2 | real | kind_phys | in | F | +!! | gasvmr_o2 | volume_mixing_ratio_o2 | volume mixing ratio o2 | kg kg-1 | 2 | real | kind_phys | in | F | +!! | icseed | seed_random_numbers | seed for random number generation | none | 2 | integer | | in | F | +!! | aeraod | aerosol_optical_depth_for_shortwave_bands_01-16 | aerosol optical depth for shortwave bands 01-16 | none | 3 | real | kind_phys | in | F | +!! | aerssa | aerosol_single_scattering_albedo_for_shortwave_bands_01-16 | aerosol single scattering albedo for shortwave bands 01-16 | frac | 3 | real | kind_phys | in | F | +!! | aerasy | aerosol_asymmetry_parameter_for_shortwave_bands_01-16 | aerosol asymmetry paramter for shortwave bands 01-16 | none | 3 | real | kind_phys | in | F | +!! | sfcalb_nir_dir | surface_albedo_due_to_near_IR_direct | surface albedo due to near IR direct beam | frac | 1 | real | kind_phys | in | F | +!! | sfcalb_nir_dif | surface_albedo_due_to_near_IR_diffused | surface albedo due to near IR diffused beam | frac | 1 | real | kind_phys | in | F | +!! | sfcalb_uvis_dir | surface_albedo_due_to_UV_and_VIS_direct | surface albedo due to UV+VIS direct beam | frac | 1 | real | kind_phys | in | F | +!! | sfcalb_uvis_dif | surface_albedo_due_to_UV_and_VIS_diffused | surface albedo due to UV+VIS diffused beam | frac | 1 | real | kind_phys | in | F | !! | cosz | cosine_of_zenith_angle | cosine of the solar zenit angle | none | 1 | real | kind_phys | in | F | !! | solcon | solar_constant | solar constant | W m-2 | 0 | real | kind_phys | in | F | !! | nday | daytime_points_dimension | daytime points dimension | index | 0 | integer | | in | F | -!! | idxday | daytime_points | daytime points | | 1 | integer | | in | F | +!! | idxday | daytime_points | daytime points | count | 1 | integer | | in | F | !! | npts | horizontal_loop_extent | horizontal dimension | index | 0 | integer | | in | F | !! | nlay | adjusted_vertical_layer_dimension_for_radiation | number of vertical layers for radiation | index | 0 | integer | | in | F | !! | nlp1 | adjusted_vertical_level_dimension_for_radiation | number of vertical levels for radiation | index | 0 | integer | | in | F | !! | lprnt | flag_to_print | logical flag to print | logical | 0 | logical | | in | F | -!! | cld_cf | total_cloud_fraction | total cloud fraction | | 2 | real | kind_phys | in | F | +!! | cld_cf | total_cloud_fraction | total cloud fraction | frac | 2 | real | kind_phys | in | F | !! | lsswr | flag_to_calc_sw | logical flag to calculate SW irradiances | logical | 0 | logical | | in | F | -!! | hswc | tendency_of_air_temperature_due_to_shortwave_heating | shortwave total sky heating rate | k s-1 | 2 | real | kind_phys | out | F | +!! | hswc | tendency_of_air_temperature_due_to_shortwave_heating | shortwave total sky heating rate | K s-1 | 2 | real | kind_phys | out | F | !! | topflx | sw_fluxes_top_atmosphere | shortwave total sky fluxes at the top of the atm | W m-2 | 1 | topfsw_type | kind_phys | out | F | !! | sfcflx | sw_fluxes_sfc | shortwave total sky fluxes at the Earth surface | W m-2 | 1 | sfcfsw_type | kind_phys | out | F | !! | hsw0 | tendency_of_air_temperature_due_to_shortwave_heating_assuming_clear_sky | shortwave clear sky heating rate | K s-1 | 2 | real | kind_phys | out | T | @@ -630,9 +630,9 @@ end subroutine swrad_init !! | cld_ref_rain | mean_effective_radius_for_rain_drop | mean effective radius for rain drop | micron | 2 | real | kind_phys | in | T | !! | cld_swp | cloud_snow_water_path | cloud snow water path | g m-2 | 2 | real | kind_phys | in | T | !! | cld_ref_snow | mean_effective_radius_for_snow_flake | mean effective radius for snow flake | micron | 2 | real | kind_phys | in | T | -!! | cld_od | cloud_optical_depth | cloud optical depth | | 2 | real | kind_phys | in | T | -!! | cld_ssa | cloud_single_scattering_albedo | cloud single scattering albedo | | 2 | real | kind_phys | in | T | -!! | cld_asy | cloud_asymetry_parameter | cloud asymetry parameter | | 2 | real | kind_phys | in | T | +!! | cld_od | cloud_optical_depth | cloud optical depth | none | 2 | real | kind_phys | in | T | +!! | cld_ssa | cloud_single_scattering_albedo | cloud single scattering albedo | frac | 2 | real | kind_phys | in | T | +!! | cld_asy | cloud_asymetry_parameter | cloud asymetry parameter | none | 2 | real | kind_phys | in | T | !! !> \section General_swrad General Algorithm !> @{ diff --git a/physics/sfc_drv.f b/physics/sfc_drv.f index e9527a96f..075e7491f 100644 --- a/physics/sfc_drv.f +++ b/physics/sfc_drv.f @@ -291,7 +291,7 @@ end subroutine lsm_noah_finalize !!| weasd | water_equivalent_accumulated_snow_depth | water equivalent accumulated snow depth | mm | 1 | real | kind_phys | inout | F | !!| snwdph | surface_snow_thickness_water_equivalent | water equivalent snow depth over land | mm | 1 | real | kind_phys | inout | F | !!| tskin | surface_skin_temperature | surface skin temperature | K | 1 | real | kind_phys | inout | F | -!!| tprcp | precipitation_amount_in_one_dynamics_time_step | total precipitation in each time step | kg m-2 | 1 | real | kind_phys | inout | F | +!!| tprcp | precipitation_amount_in_one_dynamics_time_step | total precipitation in each time step | m | 1 | real | kind_phys | inout | F | !!| srflag | flag_for_precipitation_type | flag for snow or rain precipitation | flag | 1 | real | kind_phys | inout | F | !!| smc | volume_fraction_of_soil_moisture | volumetric fraction of soil moisture | frac | 2 | real | kind_phys | inout | F | !!| stc | soil_temperature | soil temperature | K | 2 | real | kind_phys | inout | F | diff --git a/physics/sfc_nst.f b/physics/sfc_nst.f index e97c5c563..2ab3b9b75 100644 --- a/physics/sfc_nst.f +++ b/physics/sfc_nst.f @@ -54,67 +54,67 @@ end subroutine sfc_nst_finalize !! !! This subroutine calls the Thermal Skin-layer and Diurnal Thermocline models to update the NSST profile. !! -!!\section arg_table_sfc_nst_run Argument Table -!!| local var name | longname | description | units | rank | type | kind | intent | optional | -!!|----------------|------------------------------------------------------------------------------|----------------------------------------------------- |---------------|------|---------|-----------|--------|----------| -!!| im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | -!!| km | soil_vertical_dimension | vertical layer dimension | index | 0 | integer | | in | F | -!!| ps | surface_air_pressure | surface pressure | Pa | 1 | real | kind_phys | in | F | -!!| u1 | x_wind_at_lowest_model_layer | x component of surface layer wind | m s-1 | 1 | real | kind_phys | in | F | -!!| v1 | y_wind_at_lowest_model_layer | y component of surface layer wind | m s-1 | 1 | real | kind_phys | in | F | -!!| t1 | air_temperature_at_lowest_model_layer | surface layer mean temperature | K | 1 | real | kind_phys | in | F | -!!| q1 | specific_humidity_at_lowest_model_layer | surface layer mean specific humidity | kg kg-1 | 1 | real | kind_phys | in | F | -!!| tref | sea_surface_foundation_temperature | reference/foundation temperature | K | 1 | real | kind_phys | in | F | -!!| cm | surface_drag_coefficient_for_momentum_in_air | surface exchange coeff for momentum | none | 1 | real | kind_phys | in | F | -!!| ch | surface_drag_coefficient_for_heat_and_moisture_in_air | surface exchange coeff heat & moisture | none | 1 | real | kind_phys | in | F | -!!| prsl1 | air_pressure_at_lowest_model_layer | surface layer mean pressure | Pa | 1 | real | kind_phys | in | F | -!!| prslki | ratio_of_exner_function_between_midlayer_and_interface_at_lowest_model_layer | Exner function at 1st layer | ratio | 1 | real | kind_phys | in | F | -!!| islimsk | sea_land_ice_mask | landmask: sea/land/ice=0/1/2 | flag | 1 | integer | | in | F | -!!| xlon | longitude | longitude | radians | 1 | real | kind_phys | in | F | -!!| sinlat | sine_of_latitude | sin of latitude | none | 1 | real | kind_phys | in | F | -!!| stress | surface_wind_stress | wind stress | m2 s-2 | 1 | real | kind_phys | in | F | -!!| sfcemis | surface_longwave_emissivity | surface longwave emissivity | frac | 1 | real | kind_phys | in | F | -!!| dlwflx | surface_downwelling_longwave_flux_absorbed_by_ground | total sky sfc downward lw flux absorbed by the ocean | W m-2 | 1 | real | kind_phys | in | F | -!!| sfcnsw | surface_net_downwelling_shortwave_flux | total sky sfc net sw flx into ocean | W m-2 | 1 | real | kind_phys | in | F | -!!| rain | precipitation_amount_in_one_dynamics_time_step | rainfall rate | kg m-2 s-1 | 1 | real | kind_phys | in | F | -!!| timestep | time_step_for_dynamics | timestep interval | s | 0 | real | kind_phys | in | F | -!!| kdt | index_of_time_step | time step counter | count | 0 | integer | | in | F | -!!| solhr | forecast_hour | fcst hour at the end of prev time step | none | 0 | real | kind_phys | in | F | -!!| xcosz | instantaneous_cosine_of_zenith_angle | cosine of solar zenith angle | none | 1 | real | kind_phys | in | F | -!!| ddvel | surface_wind_enhancement_due_to_convection | wind enhancement due to convection | m s-1 | 1 | real | kind_phys | in | F | -!!| flag_iter | flag_for_iteration | flag for iteration | flag | 1 | logical | | in | F | -!!| flag_guess | flag_for_guess_run | flag for guess run | flag | 1 | logical | | in | F | -!!| nstf_name1 | flag_for_nsstm_run | NSSTM flag: off/uncoupled/coupled=0/1/2 | flag | 1 | integer | | in | F | -!!| nstf_name4 | vertical_temperature_average_range_lower_bound | zsea1 | mm | 1 | integer | | in | F | -!!| nstf_name5 | vertical_temperature_average_range_upper_bound | zsea2 | mm | 1 | integer | | in | F | -!!| lprnt | flag_print | flag for printing diagnostics to output | flag | 0 | logical | | in | F | -!!| ipr | horizontal_index_of_printed_column | horizontal index of printed column | index | 0 | integer | | in | F | -!!| tskin | surface_skin_temperature | ocean surface skin temperature | K | 1 | real | kind_phys | inout | F | -!!| tsurf | surface_skin_temperature_after_iteration | ocean surface skin temperature for guess run | K | 1 | real | kind_phys | inout | F | -!!| xt | diurnal thermocline layer_heat_content | heat content in diurnal thermocline layer | K m | 1 | real | kind_phys | inout | F | -!!| xs | sea_water_salinity | salinity content in diurnal thermocline layer | ppt m | 1 | real | kind_phys | inout | F | -!!| xu | diurnal_thermocline_layer_x_current | u-current content in diurnal thermocline layer | m2 s-1 | 1 | real | kind_phys | inout | F | -!!| xv | diurnal_thermocline_layer_y_current | v-current content in diurnal thermocline layer | m2 s-1 | 1 | real | kind_phys | inout | F | -!!| xz | diurnal_thermocline_layer_thickness | diurnal thermocline layer thickness | m | 1 | real | kind_phys | inout | F | -!!| zm | ocean_mixed_layer_thickness | mixed layer thickness | m | 1 | real | kind_phys | inout | F | -!!| xtts | sensitivity_of_dtl_heat_content_to_surface_temperature | d(xt)/d(ts) | m | 1 | real | kind_phys | inout | F | -!!| xzts | sensitivity_of_dtl_thickness_to_surface_temperature | d(xz)/d(ts) | m K-1 | 1 | real | kind_phys | inout | F | -!!| dt_cool | sub-layer_cooling_amount | sub-layer cooling amount | K | 1 | real | kind_phys | inout | F | -!!| z_c | sub-layer_cooling_thickness | sub-layer cooling thickness | m | 1 | real | kind_phys | inout | F | -!!| c_0 | coefficient_c_0 | coefficient1 to calculate d(tz)/d(ts) | none | 1 | real | kind_phys | inout | F | -!!| c_d | coefficient_c_d | coefficient2 to calculate d(tz)/d(ts) | none | 1 | real | kind_phys | inout | F | -!!| w_0 | coefficient_w_0 | coefficient3 to calculate d(tz)/d(ts) | none | 1 | real | kind_phys | inout | F | -!!| w_d | coefficient_w_d | coefficient4 to calculate d(tz)/d(ts) | none | 1 | real | kind_phys | inout | F | -!!| d_conv | free_convection_layer_thickness | thickness of free convection layer | m | 1 | real | kind_phys | inout | F | -!!| ifd | index_of_dtlm_start | index to start dtlm run or not | index | 1 | real | kind_phys | inout | F | -!!| qrain | sensible_heat_flux_due_to_rainfall | sensible heat flux due to rainfall | W | 1 | real | kind_phys | inout | F | -!!| qsurf | surface_specific_humidity | surface air saturation specific humidity | kg kg-1 | 1 | real | kind_phys | out | F | -!!| gflux | upward_heat_flux_in_soil | soil heat flux | W m-2 | 1 | real | kind_phys | out | F | -!!| cmm | surface_drag_wind_speed_for_momentum_in_air | surf mom exch coef time mean surf wind | m s-1 | 1 | real | kind_phys | out | F | -!!| chh | surface_drag_mass_flux_for_heat_and_moisture_in_air | surf h&m exch coef time surf wind & density | kg m-2 s-1 | 1 | real | kind_phys | out | F | -!!| evap | kinematic_surface_upward_latent_heat_flux | kinematic from latent heat flux | kg kg-1 m s-1 | 1 | real | kind_phys | out | F | -!!| hflx | kinematic_surface_upward_sensible_heat_flux | kinematic sensible heat flux | K m s-1 | 1 | real | kind_phys | out | F | -!!| ep | surface_upward_potential_latent_heat_flux | potential evaporation | W m-2 | 1 | real | kind_phys | out | F | +!! \section arg_table_sfc_nst_run Argument Table +!! | local var name | longname | description | units | rank | type | kind | intent | optional | +!! |----------------|------------------------------------------------------------------------------|----------------------------------------------------- |---------------|------|---------|-----------|--------|----------| +!! | im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | +!! | km | soil_vertical_dimension | vertical layer dimension | index | 0 | integer | | in | F | +!! | ps | surface_air_pressure | surface pressure | Pa | 1 | real | kind_phys | in | F | +!! | u1 | x_wind_at_lowest_model_layer | x component of surface layer wind | m s-1 | 1 | real | kind_phys | in | F | +!! | v1 | y_wind_at_lowest_model_layer | y component of surface layer wind | m s-1 | 1 | real | kind_phys | in | F | +!! | t1 | air_temperature_at_lowest_model_layer | surface layer mean temperature | K | 1 | real | kind_phys | in | F | +!! | q1 | specific_humidity_at_lowest_model_layer | surface layer mean specific humidity | kg kg-1 | 1 | real | kind_phys | in | F | +!! | tref | sea_surface_foundation_temperature | reference/foundation temperature | K | 1 | real | kind_phys | in | F | +!! | cm | surface_drag_coefficient_for_momentum_in_air | surface exchange coeff for momentum | none | 1 | real | kind_phys | in | F | +!! | ch | surface_drag_coefficient_for_heat_and_moisture_in_air | surface exchange coeff heat & moisture | none | 1 | real | kind_phys | in | F | +!! | prsl1 | air_pressure_at_lowest_model_layer | surface layer mean pressure | Pa | 1 | real | kind_phys | in | F | +!! | prslki | ratio_of_exner_function_between_midlayer_and_interface_at_lowest_model_layer | Exner function at 1st layer | ratio | 1 | real | kind_phys | in | F | +!! | islimsk | sea_land_ice_mask | landmask: sea/land/ice=0/1/2 | flag | 1 | integer | | in | F | +!! | xlon | longitude | longitude | radians | 1 | real | kind_phys | in | F | +!! | sinlat | sine_of_latitude | sin of latitude | none | 1 | real | kind_phys | in | F | +!! | stress | surface_wind_stress | wind stress | m2 s-2 | 1 | real | kind_phys | in | F | +!! | sfcemis | surface_longwave_emissivity | surface longwave emissivity | frac | 1 | real | kind_phys | in | F | +!! | dlwflx | surface_downwelling_longwave_flux_absorbed_by_ground | total sky sfc downward lw flux absorbed by the ocean | W m-2 | 1 | real | kind_phys | in | F | +!! | sfcnsw | surface_net_downwelling_shortwave_flux | total sky sfc net sw flx into ocean | W m-2 | 1 | real | kind_phys | in | F | +!! | rain | precipitation_amount_in_one_dynamics_time_step | precipitation amount in one dynamics time step | m | 1 | real | kind_phys | in | F | +!! | timestep | time_step_for_dynamics | timestep interval | s | 0 | real | kind_phys | in | F | +!! | kdt | index_of_time_step | current time step index | index | 0 | integer | | in | F | +!! | solhr | forecast_hour | fcst hour at the end of prev time step | h | 0 | real | kind_phys | in | F | +!! | xcosz | instantaneous_cosine_of_zenith_angle | cosine of solar zenith angle | none | 1 | real | kind_phys | in | F | +!! | ddvel | surface_wind_enhancement_due_to_convection | wind enhancement due to convection | m s-1 | 1 | real | kind_phys | in | F | +!! | flag_iter | flag_for_iteration | flag for iteration | flag | 1 | logical | | in | F | +!! | flag_guess | flag_for_guess_run | flag for guess run | flag | 1 | logical | | in | F | +!! | nstf_name1 | flag_for_nsstm_run | NSSTM flag: off/uncoupled/coupled=0/1/2 | flag | 0 | integer | | in | F | +!! | nstf_name4 | vertical_temperature_average_range_lower_bound | zsea1 | mm | 1 | integer | | in | F | +!! | nstf_name5 | vertical_temperature_average_range_upper_bound | zsea2 | mm | 1 | integer | | in | F | +!! | lprnt | flag_print | flag for printing diagnostics to output | flag | 0 | logical | | in | F | +!! | ipr | horizontal_index_of_printed_column | horizontal index of printed column | index | 0 | integer | | in | F | +!! | tskin | surface_skin_temperature | ocean surface skin temperature | K | 1 | real | kind_phys | inout | F | +!! | tsurf | surface_skin_temperature_after_iteration | ocean surface skin temperature for guess run | K | 1 | real | kind_phys | inout | F | +!! | xt | diurnal thermocline layer_heat_content | heat content in diurnal thermocline layer | K m | 1 | real | kind_phys | inout | F | +!! | xs | sea_water_salinity | salinity content in diurnal thermocline layer | ppt m | 1 | real | kind_phys | inout | F | +!! | xu | diurnal_thermocline_layer_x_current | u-current content in diurnal thermocline layer | m2 s-1 | 1 | real | kind_phys | inout | F | +!! | xv | diurnal_thermocline_layer_y_current | v-current content in diurnal thermocline layer | m2 s-1 | 1 | real | kind_phys | inout | F | +!! | xz | diurnal_thermocline_layer_thickness | diurnal thermocline layer thickness | m | 1 | real | kind_phys | inout | F | +!! | zm | ocean_mixed_layer_thickness | mixed layer thickness | m | 1 | real | kind_phys | inout | F | +!! | xtts | sensitivity_of_dtl_heat_content_to_surface_temperature | d(xt)/d(ts) | m | 1 | real | kind_phys | inout | F | +!! | xzts | sensitivity_of_dtl_thickness_to_surface_temperature | d(xz)/d(ts) | m K-1 | 1 | real | kind_phys | inout | F | +!! | dt_cool | sub-layer_cooling_amount | sub-layer cooling amount | K | 1 | real | kind_phys | inout | F | +!! | z_c | sub-layer_cooling_thickness | sub-layer cooling thickness | m | 1 | real | kind_phys | inout | F | +!! | c_0 | coefficient_c_0 | coefficient1 to calculate d(tz)/d(ts) | none | 1 | real | kind_phys | inout | F | +!! | c_d | coefficient_c_d | coefficient2 to calculate d(tz)/d(ts) | none | 1 | real | kind_phys | inout | F | +!! | w_0 | coefficient_w_0 | coefficient3 to calculate d(tz)/d(ts) | none | 1 | real | kind_phys | inout | F | +!! | w_d | coefficient_w_d | coefficient4 to calculate d(tz)/d(ts) | none | 1 | real | kind_phys | inout | F | +!! | d_conv | free_convection_layer_thickness | thickness of free convection layer | m | 1 | real | kind_phys | inout | F | +!! | ifd | index_of_dtlm_start | index to start dtlm run or not | index | 1 | real | kind_phys | inout | F | +!! | qrain | sensible_heat_flux_due_to_rainfall | sensible heat flux due to rainfall | W | 1 | real | kind_phys | inout | F | +!! | qsurf | surface_specific_humidity | surface air saturation specific humidity | kg kg-1 | 1 | real | kind_phys | out | F | +!! | gflux | upward_heat_flux_in_soil | soil heat flux | W m-2 | 1 | real | kind_phys | out | F | +!! | cmm | surface_drag_wind_speed_for_momentum_in_air | surf mom exch coef time mean surf wind | m s-1 | 1 | real | kind_phys | out | F | +!! | chh | surface_drag_mass_flux_for_heat_and_moisture_in_air | surf h&m exch coef time surf wind & density | kg m-2 s-1 | 1 | real | kind_phys | out | F | +!! | evap | kinematic_surface_upward_latent_heat_flux | kinematic from latent heat flux | kg kg-1 m s-1 | 1 | real | kind_phys | out | F | +!! | hflx | kinematic_surface_upward_sensible_heat_flux | kinematic sensible heat flux | K m s-1 | 1 | real | kind_phys | out | F | +!! | ep | surface_upward_potential_latent_heat_flux | potential evaporation | W m-2 | 1 | real | kind_phys | out | F | !! !! \section NSST_general_algorithm General Algorithm !! @@ -197,6 +197,11 @@ subroutine sfc_nst_run & ! sfcemis - real, sfc lw emissivity (fraction) im ! ! dlwflx - real, total sky sfc downward lw flux (w/m**2) im ! ! sfcnsw - real, total sky sfc netsw flx into ocean (w/m**2) im ! +! DH* +! The actual unit of rain passed in is m ! see below line 438, qrain(i) = ... +! where 1000*rain in the nominator converts m to kg m^2; there is still a +! time unit 's' missing. Need to double-check what is going on. +! *DH ! rain - real, rainfall rate (kg/m**2/s) im ! ! timestep - real, timestep interval (second) 1 ! ! kdt - integer, time step counter 1 ! @@ -736,16 +741,16 @@ end subroutine sfc_nst_pre_finalize !! !! Blah blah description of subroutine !! -!!\section arg_table_sfc_nst_pre_run Argument Table -!!| local var name | longname | description | units | rank | type | kind | intent | optional | -!!|----------------|------------------------------------------------------------------------------|----------------------------------------------- |---------------|------|---------|-----------|--------|----------| -!!| im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | -!!| islimsk | sea_land_ice_mask | landmask: sea/land/ice=0/1/2 | flag | 1 | integer | | in | F | -!!| oro | orography | orography | | 1 | real | kind_phys | in | F | -!!| oro_uf | orography_unfiltered | unfiltered orographyo | | 1 | real | kind_phys | in | F | -!!| tsfc | surface_skin_temperature | ocean surface skin temperature | K | 1 | real | kind_phys | in | F | -!!| tsurf | surface_skin_temperature_after_iteration | ocean surface skin temperature for guess run | K | 1 | real | kind_phys | inout | F | -!!| tskin | surface_skin_temperature | ocean surface skin temperature | K | 1 | real | kind_phys | out | F | +!! \section arg_table_sfc_nst_pre_run Argument Table +!! | local var name | longname | description | units | rank | type | kind | intent | optional | +!! |----------------|------------------------------------------------------------------------------|----------------------------------------------- |---------------|------|---------|-----------|--------|----------| +!! | im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | +!! | islimsk | sea_land_ice_mask | landmask: sea/land/ice=0/1/2 | flag | 1 | integer | | in | F | +!! | oro | orography | orography | | 1 | real | kind_phys | in | F | +!! | oro_uf | orography_unfiltered | unfiltered orographyo | | 1 | real | kind_phys | in | F | +!! | tsfc | surface_skin_temperature | ocean surface skin temperature | K | 1 | real | kind_phys | in | F | +!! | tsurf | surface_skin_temperature_after_iteration | ocean surface skin temperature for guess run | K | 1 | real | kind_phys | inout | F | +!! | tskin | surface_skin_temperature | ocean surface skin temperature | K | 1 | real | kind_phys | out | F | !! !! \section NSST_general_algorithm General Algorithm !! @@ -835,26 +840,26 @@ end subroutine sfc_nst_post_finalize !! !! Blah blah description of subroutine !! -!!\section arg_table_sfc_nst_post_run Argument Table -!!| local var name | longname | description | units | rank | type | kind | intent | optional | -!!|----------------|------------------------------------------------------------------------------|----------------------------------------------- |---------------|------|---------|-----------|--------|----------| -!!| im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | -!!| islimsk | sea_land_ice_mask | landmask: sea/land/ice=0/1/2 | flag | 1 | integer | | in | F | -!!| oro | orography | orography | | 1 | real | kind_phys | in | F | -!!| oro_uf | orography_unfiltered | unfiltered orographyo | | 1 | real | kind_phys | in | F | -!!| nstf_name1 | flag_for_nsstm_run | NSSTM flag: off/uncoupled/coupled=0/1/2 | flag | 1 | integer | | in | F | -!!| nstf_name4 | vertical_temperature_average_range_lower_bound | zsea1 | mm | 1 | integer | | in | F | -!!| nstf_name5 | vertical_temperature_average_range_upper_bound | zsea2 | mm | 1 | integer | | in | F | -!!| xt | diurnal thermocline layer_heat_content | heat content in diurnal thermocline layer | K m | 1 | real | kind_phys | in | F | -!!| xz | diurnal_thermocline_layer_thickness | diurnal thermocline layer thickness | m | 1 | real | kind_phys | in | F | -!!| dt_cool | sub-layer_cooling_amount | sub-layer cooling amount | K | 1 | real | kind_phys | in | F | -!!| z_c | sub-layer_cooling_thickness | sub-layer cooling thickness | m | 1 | real | kind_phys | in | F | -!!| rslimsk | sea_land_ice_mask_real | landmask: sea/land/ice=0/1/2 | flag | 1 | real | kind_phys | in | F | -!!| tref | sea_surface_foundation_temperature | reference/foundation temperature | K | 1 | real | kind_phys | in | F | -!!| xlon | longitude | longitude | radians | 1 | real | kind_phys | in | F | -!!| tsurf | surface_skin_temperature_after_iteration | ocean surface skin temperature for guess run | K | 1 | real | kind_phys | inout | F | -!!| dtzm | mean_change_over_depth_in_sea_water_temperature | mean of dT(z) (zsea1 to zsea2) | K | 1 | real | kind_phys | out | F | -!!| tsfc | surface_skin_temperature | ocean surface skin temperature | K | 1 | real | kind_phys | out | F | +!! \section arg_table_sfc_nst_post_run Argument Table +!! | local var name | longname | description | units | rank | type | kind | intent | optional | +!! |----------------|------------------------------------------------------------------------------|----------------------------------------------- |---------------|------|---------|-----------|--------|----------| +!! | im | horizontal_loop_extent | horizontal loop extent, start at 1 | index | 0 | integer | | in | F | +!! | islimsk | sea_land_ice_mask | landmask: sea/land/ice=0/1/2 | flag | 1 | integer | | in | F | +!! | oro | orography | orography | | 1 | real | kind_phys | in | F | +!! | oro_uf | orography_unfiltered | unfiltered orographyo | | 1 | real | kind_phys | in | F | +!! | nstf_name1 | flag_for_nsstm_run | NSSTM flag: off/uncoupled/coupled=0/1/2 | flag | 0 | integer | | in | F | +!! | nstf_name4 | vertical_temperature_average_range_lower_bound | zsea1 | mm | 1 | integer | | in | F | +!! | nstf_name5 | vertical_temperature_average_range_upper_bound | zsea2 | mm | 1 | integer | | in | F | +!! | xt | diurnal thermocline layer_heat_content | heat content in diurnal thermocline layer | K m | 1 | real | kind_phys | in | F | +!! | xz | diurnal_thermocline_layer_thickness | diurnal thermocline layer thickness | m | 1 | real | kind_phys | in | F | +!! | dt_cool | sub-layer_cooling_amount | sub-layer cooling amount | K | 1 | real | kind_phys | in | F | +!! | z_c | sub-layer_cooling_thickness | sub-layer cooling thickness | m | 1 | real | kind_phys | in | F | +!! | rslimsk | sea_land_ice_mask_real | landmask: sea/land/ice=0/1/2 | flag | 1 | real | kind_phys | in | F | +!! | tref | sea_surface_foundation_temperature | reference/foundation temperature | K | 1 | real | kind_phys | in | F | +!! | xlon | longitude | longitude | radians | 1 | real | kind_phys | in | F | +!! | tsurf | surface_skin_temperature_after_iteration | ocean surface skin temperature for guess run | K | 1 | real | kind_phys | inout | F | +!! | dtzm | mean_change_over_depth_in_sea_water_temperature | mean of dT(z) (zsea1 to zsea2) | K | 1 | real | kind_phys | out | F | +!! | tsfc | surface_skin_temperature | ocean surface skin temperature | K | 1 | real | kind_phys | out | F | !! !! \section NSST_general_algorithm General Algorithm !! diff --git a/physics/sfc_sice.f b/physics/sfc_sice.f index be1ebfbd2..54871e214 100644 --- a/physics/sfc_sice.f +++ b/physics/sfc_sice.f @@ -55,7 +55,7 @@ end subroutine sfc_sice_finalize !! | tice | sea_ice_temperature | sea-ice surface temperature | K | 1 | real | kind_phys | inout | F | !! | weasd | water_equivalent_accumulated_snow_depth | water equivalent accumulated snow depth | mm | 1 | real | kind_phys | inout | F | !! | tskin | surface_skin_temperature | ground surface skin temperature | K | 1 | real | kind_phys | inout | F | -!! | tprcp | precipitation_amount_in_one_dynamics_time_step | total precipitation | kg m-2 | 1 | real | kind_phys | inout | F | +!! | tprcp | precipitation_amount_in_one_dynamics_time_step | total precipitation | m | 1 | real | kind_phys | inout | F | !! | stc | soil_temperature | soil temp | K | 2 | real | kind_phys | inout | F | !! | ep | surface_upward_potential_latent_heat_flux | potential evaporation | W m-2 | 1 | real | kind_phys | inout | F | !! | snwdph | surface_snow_thickness_water_equivalent | water equivalent snow depth | mm | 1 | real | kind_phys | out | F |