module GRID (real space) More...

Functions/Subroutines
subroutine, public	real_setup
	Setup. More...

subroutine, public	real_update_z
	Re-setup with updated topography. More...

subroutine, public	real_calc_areavol (MAPF)
	Calc control area/volume. More...

Variables
real(rp), dimension(:,:), allocatable, public	real_lon
	longitude [rad,0-2pi] More...

real(rp), dimension(:,:), allocatable, public	real_lat
	latitude [rad,-pi,pi] More...

real(rp), dimension(:,:,:), allocatable, public	real_cz
	geopotential height [m] (cell center) More...

real(rp), dimension(:,:,:), allocatable, public	real_fz
	geopotential height [m] (cell face ) More...

real(rp), public	real_basepoint_lon
	position of base point in real world [rad,0-2pi] More...

real(rp), public	real_basepoint_lat
	position of base point in real world [rad,-pi,pi] More...

real(rp), dimension(:,:), allocatable, public	real_lonx
	longitude at staggered point (uy) [rad,0-2pi] More...

real(rp), dimension(:,:), allocatable, public	real_lony
	longitude at staggered point (xv) [rad,0-2pi] More...

real(rp), dimension(:,:), allocatable, public	real_lonxy
	longitude at staggered point (uv) [rad,0-2pi] More...

real(rp), dimension(:,:), allocatable, public	real_latx
	latitude at staggered point (uy) [rad,-pi,pi] More...

real(rp), dimension(:,:), allocatable, public	real_laty
	latitude at staggered point (xv) [rad,-pi,pi] More...

real(rp), dimension(:,:), allocatable, public	real_latxy
	latitude at staggered point (uv) [rad,-pi,pi] More...

real(rp), dimension(:,:), allocatable, public	real_dlon
	delta longitude More...

real(rp), dimension(:,:), allocatable, public	real_dlat
	delta latitude More...

real(rp), dimension(:,:), allocatable, public	real_z1
	Height of the lowermost grid from surface (cell center) [m]. More...

real(rp), public	real_aspect_max
	maximum aspect ratio of the grid cell More...

real(rp), public	real_aspect_min
	minimum aspect ratio of the grid cell More...

real(rp), dimension(:,:,:), allocatable, public	real_phi
	geopotential [m2/s2] (cell center) More...

real(rp), dimension(:,:), allocatable, public	real_area
	horizontal area [m2] More...

real(rp), dimension(:,:,:), allocatable, public	real_vol
	control volume [m3] More...

real(rp), dimension(:,:,:), allocatable, public	real_domain_catalogue
	domain latlon catalogue [rad] More...

real(rp), public	real_totarea
	total area (local) [m2] More...

real(rp), public	real_totvol
	total volume (local) [m3] More...

Detailed Description

module GRID (real space)

Description: Grid module for orthogonal curvelinear, terrain-following coordinate

Author: Team SCALE

History

2011-10-24 (H.Yashiro) [new] reconstruction from scale_REAL & scale_topography

NAMELIST

PARAM_DOMAIN_CATALOGUE

name	type	default value	comment
DOMAIN_CATALOGUE_FNAME	character(len=H_LONG)	'latlon_domain_catalogue.txt'	metadata files for lat-lon domain for all processes
DOMAIN_CATALOGUE_OUTPUT	logical	.false.

History Output: No history output

Function/Subroutine Documentation

◆ real_setup()

subroutine, public scale_grid_real::real_setup ( )

Setup.

Definition at line 85 of file scale_grid_real.F90.

References scale_fileio::fileio_set_coordinates(), scale_grid::grid_domain_center_x, scale_grid::grid_domain_center_y, scale_grid_index::ia, scale_stdio::io_fid_conf, scale_stdio::io_fid_log, scale_stdio::io_fid_nml, scale_stdio::io_l, scale_stdio::io_nml, scale_grid_index::ja, scale_grid_index::ka, scale_mapproj::mprj_setup(), scale_process::prc_mpistop(), scale_process::prc_nprocs, real_area, real_cz, real_dlat, real_dlon, real_domain_catalogue, real_fz, real_lat, real_latx, real_latxy, real_laty, real_lon, real_lonx, real_lonxy, real_lony, real_phi, real_vol, and real_z1.

Referenced by mod_rm_driver::scalerm(), and mod_rm_prep::scalerm_prep().

     use scale_process, only: &
        prc_nprocs,  &
        prc_mpistop
     use scale_grid, only: &
        grid_domain_center_x, &
        grid_domain_center_y
     use scale_mapproj, only: &
        mprj_setup
     use scale_fileio, only: &
        fileio_set_coordinates
     implicit none
 
     character(len=H_LONG) :: DOMAIN_CATALOGUE_FNAME  = 'latlon_domain_catalogue.txt'
     logical               :: DOMAIN_CATALOGUE_OUTPUT = .false.
 
     namelist / param_domain_catalogue / &
        domain_catalogue_fname,  &
        domain_catalogue_output
 
     integer :: ierr
     !---------------------------------------------------------------------------
 
     if( io_l ) write(io_fid_log,*)
     if( io_l ) write(io_fid_log,*) '++++++ Module[GRID_REAL] / Categ[ATMOS-RM GRID] / Origin[SCALElib]'
 
     !--- read namelist
     rewind(io_fid_conf)
     read(io_fid_conf,nml=param_domain_catalogue,iostat=ierr)
     if( ierr < 0 ) then !--- missing
        if( io_l ) write(io_fid_log,*) '*** Not found namelist. Default used.'
     elseif( ierr > 0 ) then !--- fatal error
        write(*,*) 'xxx Not appropriate names in namelist PARAM_DOMAIN_CATALOGUE. Check!'
        call prc_mpistop
     endif
     if( io_nml ) write(io_fid_nml,nml=param_domain_catalogue)
 
     allocate( real_lon(  ia,  ja) )
     allocate( real_lat(  ia,  ja) )
     allocate( real_lonx(0:ia,  ja) )
     allocate( real_lony(  ia,0:ja) )
     allocate( real_lonxy(0:ia,0:ja) )
     allocate( real_latx(0:ia,  ja) )
     allocate( real_laty(  ia,0:ja) )
     allocate( real_latxy(0:ia,0:ja) )
     allocate( real_dlon(  ia,  ja) )
     allocate( real_dlat(  ia,  ja) )
 
     allocate( real_cz(  ka,ia,ja) )
     allocate( real_fz(0:ka,ia,ja) )
     allocate( real_z1(     ia,ja) )
     allocate( real_phi(  ka,ia,ja) )
 
     allocate( real_area(   ia,ja) )
     allocate( real_vol(ka,ia,ja) )
 
     allocate( real_domain_catalogue(prc_nprocs,4,2) )
 
     ! setup map projection
     call mprj_setup( grid_domain_center_x, grid_domain_center_y )
 
     ! calc longitude & latitude
     call real_calc_latlon( domain_catalogue_fname, domain_catalogue_output )
 
     ! calc real height
     call real_calc_z
 
     ! calc control area & volume
     ! call REAL_calc_areavol ! must be called after GTRANS_setup
 
     ! set latlon and z to fileio module
     call fileio_set_coordinates( real_lon, real_lonx, real_lony, real_lonxy, &
                                  real_lat, real_latx, real_laty, real_latxy, &
                                  real_cz,  real_fz    )
 
     return

Here is the call graph for this function:

Here is the caller graph for this function:

◆ real_update_z()

subroutine, public scale_grid_real::real_update_z ( )

Re-setup with updated topography.

Definition at line 165 of file scale_grid_real.F90.

References scale_const::const_d2r, scale_const::const_grav, scale_const::const_pi, scale_fileio::fileio_set_coordinates(), scale_grid::grid_cdx, scale_grid::grid_cdy, scale_grid::grid_cx, scale_grid::grid_cy, scale_grid::grid_cz, scale_grid::grid_fx, scale_grid::grid_fy, scale_grid::grid_fz, scale_grid_index::ia, scale_grid_index::ie, scale_stdio::io_fid_log, scale_stdio::io_get_available_fid(), scale_stdio::io_l, scale_grid_index::is, scale_grid_index::ja, scale_grid_index::je, scale_grid_index::js, scale_grid_index::ka, scale_grid_index::ke, scale_grid_index::ks, scale_mapproj::mprj_basepoint_lat, scale_mapproj::mprj_basepoint_lon, scale_mapproj::mprj_xy2lonlat(), scale_process::prc_ismaster, scale_process::prc_mpistop(), scale_process::prc_nprocs, real_aspect_max, real_aspect_min, real_basepoint_lat, real_basepoint_lon, real_cz, real_dlat, real_dlon, real_domain_catalogue, real_fz, real_lat, real_latx, real_latxy, real_laty, real_lon, real_lonx, real_lonxy, real_lony, real_phi, real_z1, and scale_topography::topo_zsfc.

Referenced by mod_rm_prep::scalerm_prep().

     use scale_process, only: &
        prc_mpistop
     use scale_fileio, only: &
        fileio_set_coordinates
     implicit none
     !---------------------------------------------------------------------------
 
     ! calc real height
     call real_calc_z
 
     ! set latlon and z to fileio module
     call fileio_set_coordinates( real_lon, real_lonx, real_lony, real_lonxy, &
                                  real_lat, real_latx, real_laty, real_latxy, &
                                  real_cz,  real_fz    )
 
     return

Here is the call graph for this function:

Here is the caller graph for this function:

◆ real_calc_areavol()

subroutine, public scale_grid_real::real_calc_areavol ( real(rp), dimension(ia,ja,2), intent(in) MAPF )

Calc control area/volume.

Definition at line 407 of file scale_grid_real.F90.

References scale_const::const_radius, scale_grid::dx, scale_grid::dy, scale_grid::dz, scale_grid_index::ie, scale_grid_index::is, scale_grid_index::je, scale_grid_index::js, scale_grid_index::ke, scale_grid_index::ks, real_area, real_fz, real_totarea, real_totvol, and real_vol.

Referenced by scale_gridtrans::gtrans_setup().

     use scale_const, only: &
        radius => const_radius
     use scale_grid, only: &
        dz, &
        dx, &
        dy
     implicit none
     real(RP), intent(in) :: MAPF(IA,JA,2)
 
     integer :: k, i, j
     !---------------------------------------------------------------------------
 
     real_totarea   = 0.0_rp
     real_area(:,:) = 0.0_rp
     do j = js, je
     do i = is, ie
        real_area(i,j) = dx * dy / ( mapf(i,j,1) * mapf(i,j,2) )
        real_totarea = real_totarea + real_area(i,j)
     enddo
     enddo
 
     real_totvol     = 0.0_rp
     real_vol(:,:,:) = 0.0_rp
     do j = js, je
     do i = is, ie
     do k = ks, ke
        real_vol(k,i,j) = ( real_fz(k,i,j) - real_fz(k-1,i,j) ) * real_area(i,j)
        real_totvol = real_totvol + real_vol(k,i,j)
     enddo
     enddo
     enddo
 
     return

Here is the caller graph for this function:

Variable Documentation

◆ real_lon

real(rp), dimension(:,:), allocatable, public scale_grid_real::real_lon

longitude [rad,0-2pi]

Definition at line 38 of file scale_grid_real.F90.

Referenced by mod_atmos_phy_rd_driver::atmos_phy_rd_driver(), mod_copytopo::copytopo(), scale_gridtrans::gtrans_rotcoef(), scale_history::hist_setup(), scale_grid_nest::nest_domain_shape(), scale_grid_nest::nest_setup(), real_setup(), and real_update_z().

38 real(RP), public, allocatable :: REAL_LON(:,:)

◆ real_lat

real(rp), dimension(:,:), allocatable, public scale_grid_real::real_lat

latitude [rad,-pi,pi]

Definition at line 39 of file scale_grid_real.F90.

Referenced by mod_atmos_dyn_driver::atmos_dyn_driver_setup(), mod_atmos_phy_rd_driver::atmos_phy_rd_driver(), mod_copytopo::copytopo(), scale_gridtrans::gtrans_rotcoef(), scale_gridtrans::gtrans_setup(), scale_history::hist_setup(), scale_grid_nest::nest_domain_shape(), scale_grid_nest::nest_setup(), real_setup(), and real_update_z().

39 real(RP), public, allocatable :: REAL_LAT(:,:)

◆ real_cz

real(rp), dimension (:,:,:), allocatable, public scale_grid_real::real_cz

geopotential height [m] (cell center)

Definition at line 40 of file scale_grid_real.F90.

Referenced by scale_atmos_diagnostic::atmos_diagnostic_get(), scale_atmos_hydrostatic::atmos_hydrostatic_buildrho_3d(), scale_atmos_hydrostatic::atmos_hydrostatic_buildrho_bytemp_3d(), scale_atmos_hydrostatic::atmos_hydrostatic_buildrho_bytemp_atmos_3d(), scale_atmos_hydrostatic::atmos_hydrostatic_buildrho_real_3d(), scale_atmos_phy_cp_kf::atmos_phy_cp_kf_setup(), scale_atmos_phy_mp_common::atmos_phy_mp_precipitation(), mod_atmos_phy_rd_driver::atmos_phy_rd_driver(), mod_atmos_phy_sf_driver::atmos_phy_sf_driver(), mod_atmos_phy_tb_driver::atmos_phy_tb_driver_setup(), scale_atmos_phy_tb_mynn::atmos_phy_tb_mynn(), scale_atmos_refstate::atmos_refstate_calc3d(), scale_atmos_refstate::atmos_refstate_write(), mod_atmos_driver::atmos_surface_set(), mod_atmos_vars::atmos_vars_history(), mod_atmos_vars::atmos_vars_history_setpres(), mod_atmos_vars::atmos_vars_monitor(), mod_atmos_vars::atmos_vars_total(), scale_gridtrans::gtrans_rotcoef(), scale_history::hist_setup(), scale_interpolation::interp_setup(), scale_interpolation::interp_vertical_xi2z(), scale_interpolation::interp_vertical_z2xi(), scale_grid_nest::nest_domain_shape(), scale_grid_nest::nest_setup(), mod_mkinit::read_sounding(), real_setup(), and real_update_z().

40 real(RP), public, allocatable :: REAL_CZ (:,:,:)

◆ real_fz

real(rp), dimension (:,:,:), allocatable, public scale_grid_real::real_fz

geopotential height [m] (cell face )

Definition at line 41 of file scale_grid_real.F90.

Referenced by scale_atmos_diagnostic::atmos_diagnostic_get(), scale_atmos_hydrostatic::atmos_hydrostatic_buildrho_3d(), scale_atmos_hydrostatic::atmos_hydrostatic_buildrho_bytemp_3d(), scale_atmos_hydrostatic::atmos_hydrostatic_buildrho_real_3d(), scale_atmos_phy_mp_common::atmos_phy_mp_precipitation(), mod_atmos_phy_rd_driver::atmos_phy_rd_driver(), scale_atmos_refstate::atmos_refstate_calc3d(), mod_atmos_vars::atmos_vars_history(), scale_atmos_phy_cp_kf::cp_kf_main(), scale_atmos_phy_tb_mynn::get_length(), scale_gridtrans::gtrans_rotcoef(), scale_history::hist_setup(), scale_interpolation::interp_setup(), scale_grid_nest::nest_domain_shape(), scale_grid_nest::nest_setup(), mod_mkinit::read_sounding(), real_calc_areavol(), real_setup(), and real_update_z().

41 real(RP), public, allocatable :: REAL_FZ (:,:,:)

◆ real_basepoint_lon

real(rp), public scale_grid_real::real_basepoint_lon

position of base point in real world [rad,0-2pi]

Definition at line 43 of file scale_grid_real.F90.

Referenced by scale_atmos_solarins::atmos_solarins_setup(), scale_gridtrans::gtrans_rotcoef(), and real_update_z().

43 real(RP), public :: REAL_BASEPOINT_LON

◆ real_basepoint_lat

real(rp), public scale_grid_real::real_basepoint_lat

position of base point in real world [rad,-pi,pi]

Definition at line 44 of file scale_grid_real.F90.

Referenced by scale_atmos_phy_rd_mstrnx::atmos_phy_rd_mstrnx(), scale_atmos_phy_rd_mstrnx::atmos_phy_rd_mstrnx_setup(), scale_atmos_solarins::atmos_solarins_setup(), scale_gridtrans::gtrans_rotcoef(), and real_update_z().

44 real(RP), public :: REAL_BASEPOINT_LAT

◆ real_lonx

real(rp), dimension (:,:), allocatable, public scale_grid_real::real_lonx

longitude at staggered point (uy) [rad,0-2pi]

Definition at line 46 of file scale_grid_real.F90.

Referenced by mod_cnvlanduse::cnvlanduse(), mod_cnvtopo::cnvtopo(), scale_history::hist_setup(), scale_grid_nest::nest_domain_shape(), scale_grid_nest::nest_setup(), real_setup(), and real_update_z().

46 real(RP), public, allocatable :: REAL_LONX (:,:)

◆ real_lony

real(rp), dimension (:,:), allocatable, public scale_grid_real::real_lony

longitude at staggered point (xv) [rad,0-2pi]

Definition at line 47 of file scale_grid_real.F90.

Referenced by scale_history::hist_setup(), scale_grid_nest::nest_domain_shape(), scale_grid_nest::nest_setup(), real_setup(), and real_update_z().

47 real(RP), public, allocatable :: REAL_LONY (:,:)

◆ real_lonxy

real(rp), dimension(:,:), allocatable, public scale_grid_real::real_lonxy

longitude at staggered point (uv) [rad,0-2pi]

Definition at line 48 of file scale_grid_real.F90.

Referenced by scale_history::hist_setup(), scale_grid_nest::nest_setup(), real_setup(), and real_update_z().

48 real(RP), public, allocatable :: REAL_LONXY(:,:)

◆ real_latx

real(rp), dimension (:,:), allocatable, public scale_grid_real::real_latx

latitude at staggered point (uy) [rad,-pi,pi]

Definition at line 49 of file scale_grid_real.F90.

Referenced by scale_gridtrans::gtrans_setup(), scale_history::hist_setup(), scale_grid_nest::nest_domain_shape(), scale_grid_nest::nest_setup(), real_setup(), and real_update_z().

49 real(RP), public, allocatable :: REAL_LATX (:,:)

◆ real_laty

real(rp), dimension (:,:), allocatable, public scale_grid_real::real_laty

latitude at staggered point (xv) [rad,-pi,pi]

Definition at line 50 of file scale_grid_real.F90.

Referenced by mod_cnvlanduse::cnvlanduse(), mod_cnvtopo::cnvtopo(), scale_gridtrans::gtrans_setup(), scale_history::hist_setup(), scale_grid_nest::nest_domain_shape(), scale_grid_nest::nest_setup(), real_setup(), and real_update_z().

50 real(RP), public, allocatable :: REAL_LATY (:,:)

◆ real_latxy

real(rp), dimension(:,:), allocatable, public scale_grid_real::real_latxy

latitude at staggered point (uv) [rad,-pi,pi]

Definition at line 51 of file scale_grid_real.F90.

Referenced by scale_gridtrans::gtrans_setup(), scale_history::hist_setup(), scale_grid_nest::nest_setup(), real_setup(), and real_update_z().

51 real(RP), public, allocatable :: REAL_LATXY(:,:)

◆ real_dlon

real(rp), dimension (:,:), allocatable, public scale_grid_real::real_dlon

delta longitude

Definition at line 52 of file scale_grid_real.F90.

Referenced by mod_cnvlanduse::cnvlanduse_setup(), mod_cnvtopo::cnvtopo_setup(), real_setup(), and real_update_z().

52 real(RP), public, allocatable :: REAL_DLON (:,:)

◆ real_dlat

real(rp), dimension (:,:), allocatable, public scale_grid_real::real_dlat

delta latitude

Definition at line 53 of file scale_grid_real.F90.

Referenced by mod_cnvlanduse::cnvlanduse_setup(), mod_cnvtopo::cnvtopo_setup(), real_setup(), and real_update_z().

53 real(RP), public, allocatable :: REAL_DLAT (:,:)

◆ real_z1

real(rp), dimension (:,:), allocatable, public scale_grid_real::real_z1

Height of the lowermost grid from surface (cell center) [m].

Definition at line 55 of file scale_grid_real.F90.

Referenced by mod_atmos_phy_sf_driver::atmos_phy_sf_driver(), mod_atmos_driver::atmos_surface_set(), mod_atmos_vars::atmos_vars_history_setpres(), mod_land_phy_driver::land_phy_driver(), mod_ocean_phy_driver::ocean_phy_driver(), real_setup(), real_update_z(), and mod_urban_phy_driver::urban_phy_driver().

55 real(RP), public, allocatable :: REAL_Z1 (:,:)

◆ real_aspect_max

real(rp), public scale_grid_real::real_aspect_max

maximum aspect ratio of the grid cell

Definition at line 56 of file scale_grid_real.F90.

Referenced by real_update_z().

56 real(RP), public :: REAL_ASPECT_MAX

◆ real_aspect_min

real(rp), public scale_grid_real::real_aspect_min

minimum aspect ratio of the grid cell

Definition at line 57 of file scale_grid_real.F90.

Referenced by real_update_z().

57 real(RP), public :: REAL_ASPECT_MIN

◆ real_phi

real(rp), dimension (:,:,:), allocatable, public scale_grid_real::real_phi

geopotential [m2/s2] (cell center)

Definition at line 59 of file scale_grid_real.F90.

Referenced by mod_atmos_dyn_driver::atmos_dyn_driver(), scale_atmos_refstate::atmos_refstate_calc3d(), real_setup(), and real_update_z().

59 real(RP), public, allocatable :: REAL_PHI (:,:,:)

◆ real_area

real(rp), dimension(:,:), allocatable, public scale_grid_real::real_area

horizontal area [m2]

Definition at line 61 of file scale_grid_real.F90.

Referenced by real_calc_areavol(), real_setup(), and scale_rm_statistics::stat_total_2d().

61 real(RP), public, allocatable :: REAL_AREA(:,:)

◆ real_vol

real(rp), dimension (:,:,:), allocatable, public scale_grid_real::real_vol

control volume [m3]

Definition at line 62 of file scale_grid_real.F90.

Referenced by scale_atmos_dyn::atmos_dyn(), scale_atmos_dyn_tstep_large_fvm_heve::check_mass(), real_calc_areavol(), real_setup(), and scale_rm_statistics::stat_total_3d().

62 real(RP), public, allocatable :: REAL_VOL (:,:,:)

◆ real_domain_catalogue

real(rp), dimension(:,:,:), allocatable, public scale_grid_real::real_domain_catalogue

domain latlon catalogue [rad]

Definition at line 64 of file scale_grid_real.F90.

Referenced by scale_grid_nest::nest_domain_shape(), real_setup(), and real_update_z().

64 real(RP), public, allocatable :: REAL_DOMAIN_CATALOGUE(:,:,:)

◆ real_totarea

real(rp), public scale_grid_real::real_totarea

total area (local) [m2]

Definition at line 66 of file scale_grid_real.F90.

Referenced by real_calc_areavol().

66 real(RP), public :: REAL_TOTAREA

◆ real_totvol

real(rp), public scale_grid_real::real_totvol

total volume (local) [m3]

Definition at line 67 of file scale_grid_real.F90.

Referenced by real_calc_areavol().

67 real(RP), public :: REAL_TOTVOL

Functions/Subroutines

Variables

Detailed Description

Function/Subroutine Documentation

◆ real_setup()

◆ real_update_z()

◆ real_calc_areavol()

Variable Documentation

◆ real_lon

◆ real_lat

◆ real_cz

◆ real_fz

◆ real_basepoint_lon

◆ real_basepoint_lat

◆ real_lonx

◆ real_lony

◆ real_lonxy

◆ real_latx

◆ real_laty

◆ real_latxy

◆ real_dlon

◆ real_dlat

◆ real_z1

◆ real_aspect_max

◆ real_aspect_min

◆ real_phi

◆ real_area

◆ real_vol

◆ real_domain_catalogue

◆ real_totarea

◆ real_totvol