!> @virtual_measurement_mod.f90 !------------------------------------------------------------------------------! ! This file is part of the PALM model system. ! ! PALM is free software: you can redistribute it and/or modify it under the ! terms of the GNU General Public License as published by the Free Software ! Foundation, either version 3 of the License, or (at your option) any later ! version. ! ! PALM is distributed in the hope that it will be useful, but WITHOUT ANY ! WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR ! A PARTICULAR PURPOSE. See the GNU General Public License for more details. ! ! You should have received a copy of the GNU General Public License along with ! PALM. If not, see . ! ! Copyright 2017 Leibniz Universitaet Hannover !------------------------------------------------------------------------------! ! ! Current revisions: ! ----------------- ! ! ! Former revisions: ! ----------------- ! $Id: virtual_measurement_mod.f90 4408 2020-02-14 10:04:39Z suehring $ ! write fill_value attribute ! ! 4406 2020-02-13 20:06:29Z knoop ! Bugix: removed oro_rel wrong loop bounds and removed unnecessary restart method ! ! 4400 2020-02-10 20:32:41Z suehring ! Revision of the module: ! - revised input from NetCDF setup file ! - parallel NetCDF output via data-output module ( Tobias Gronemeier ) ! - variable attributes added ! - further variables defined ! ! 4346 2019-12-18 11:55:56Z motisi ! Introduction of wall_flags_total_0, which currently sets bits based on static ! topography information used in wall_flags_static_0 ! ! 4329 2019-12-10 15:46:36Z motisi ! Renamed wall_flags_0 to wall_flags_static_0 ! ! 4226 2019-09-10 17:03:24Z suehring ! Netcdf input routine for dimension length renamed ! ! 4182 2019-08-22 15:20:23Z scharf ! Corrected "Former revisions" section ! ! 4168 2019-08-16 13:50:17Z suehring ! Replace function get_topography_top_index by topo_top_ind ! ! 3988 2019-05-22 11:32:37Z kanani ! Add variables to enable steering of output interval for virtual measurements ! ! 3913 2019-04-17 15:12:28Z gronemeier ! Bugfix: rotate positions of measurements before writing them into file ! ! 3910 2019-04-17 11:46:56Z suehring ! Bugfix in rotation of UTM coordinates ! ! 3904 2019-04-16 18:22:51Z gronemeier ! Rotate coordinates of stations by given rotation_angle ! ! 3876 2019-04-08 18:41:49Z knoop ! Remove print statement ! ! 3854 2019-04-02 16:59:33Z suehring ! renamed nvar to nmeas, replaced USE chem_modules by USE chem_gasphase_mod and ! nspec by nvar ! ! 3766 2019-02-26 16:23:41Z raasch ! unused variables removed ! ! 3718 2019-02-06 11:08:28Z suehring ! Adjust variable name connections between UC2 and chemistry variables ! ! 3717 2019-02-05 17:21:16Z suehring ! Additional check + error numbers adjusted ! ! 3706 2019-01-29 20:02:26Z suehring ! unused variables removed ! ! 3705 2019-01-29 19:56:39Z suehring ! - initialization revised ! - binary data output ! - list of allowed variables extended ! ! 3704 2019-01-29 19:51:41Z suehring ! Sampling of variables ! ! 3473 2018-10-30 20:50:15Z suehring ! Initial revision ! ! Authors: ! -------- ! @author Matthias Suehring ! @author Tobias Gronemeier ! ! Description: ! ------------ !> The module acts as an interface between 'real-world' observations and !> model simulations. Virtual measurements will be taken in the model at the !> coordinates representative for the 'real-world' observation coordinates. !> More precisely, coordinates and measured quanties will be read from a !> NetCDF file which contains all required information. In the model, !> the same quantities (as long as all the required components are switched-on) !> will be sampled at the respective positions and output into an extra file, !> which allows for straight-forward comparison of model results with !> observations. !> !> @todo Check why there is an error when _FillValue attributes are added via !> dom. !> @todo Output of character variable station_name (dom hasn't this feature !> yet implemented). !------------------------------------------------------------------------------! MODULE virtual_measurement_mod USE arrays_3d, & ONLY: dzw, & exner, & hyp, & q, & ql, & pt, & rho_air, & u, & v, & w, & zu, & zw USE basic_constants_and_equations_mod, & ONLY: convert_utm_to_geographic, & degc_to_k, & magnus, & pi, & rd_d_rv USE chem_gasphase_mod, & ONLY: nvar USE chem_modules, & ONLY: chem_species USE control_parameters, & ONLY: air_chemistry, & coupling_char, & dz, & end_time, & humidity, & message_string, & neutral, & origin_date_time, & rho_surface, & surface_pressure, & time_since_reference_point, & virtual_measurement USE cpulog, & ONLY: cpu_log, & log_point USE data_output_module USE grid_variables, & ONLY: ddx, & ddy, & dx, & dy USE indices, & ONLY: nbgp, & nzb, & nzt, & nxl, & nxlg, & nxr, & nxrg, & nys, & nysg, & nyn, & nyng, & topo_top_ind, & wall_flags_total_0 USE kinds USE netcdf_data_input_mod, & ONLY: close_input_file, & coord_ref_sys, & crs_list, & get_attribute, & get_dimension_length, & get_variable, & init_model, & input_file_atts, & input_file_vm, & input_pids_static, & input_pids_vm, & inquire_fill_value, & open_read_file, & pids_id USE pegrid USE surface_mod, & ONLY: surf_lsm_h, & surf_usm_h USE land_surface_model_mod, & ONLY: m_soil_h, & nzb_soil, & nzt_soil, & t_soil_h, & zs USE radiation_model_mod, & ONLY: rad_lw_in, & rad_lw_out, & rad_sw_in, & rad_sw_in_diff, & rad_sw_out, & radiation_scheme USE urban_surface_mod, & ONLY: nzb_wall, & nzt_wall, & t_wall_h IMPLICIT NONE TYPE virt_general INTEGER(iwp) :: nvm = 0 !< number of virtual measurements END TYPE virt_general TYPE virt_var_atts CHARACTER(LEN=100) :: coordinates !< defined longname of the variable CHARACTER(LEN=100) :: grid_mapping !< defined longname of the variable CHARACTER(LEN=100) :: long_name !< defined longname of the variable CHARACTER(LEN=100) :: name !< variable name CHARACTER(LEN=100) :: standard_name !< defined standard name of the variable CHARACTER(LEN=100) :: units !< unit of the output variable REAL(wp) :: fill_value = -9999.0 !< _FillValue attribute END TYPE virt_var_atts TYPE virt_mea CHARACTER(LEN=100) :: feature_type !< type of the real-world measurement CHARACTER(LEN=100) :: feature_type_out = 'timeSeries' !< type of the virtual measurement !< (all will be timeSeries, even trajectories) CHARACTER(LEN=100) :: nc_filename !< name of the NetCDF output file for the station CHARACTER(LEN=100) :: site !< name of the measurement site CHARACTER(LEN=1000) :: data_content = REPEAT(' ', 1000) !< string of measured variables (data output only) INTEGER(iwp) :: end_coord_a = 0 !< end coordinate in NetCDF file for local atmosphere observations INTEGER(iwp) :: end_coord_s = 0 !< end coordinate in NetCDF file for local soil observations INTEGER(iwp) :: file_time_index = 0 !< time index in NetCDF output file INTEGER(iwp) :: ns = 0 !< number of observation coordinates on subdomain, for atmospheric measurements INTEGER(iwp) :: ns_tot = 0 !< total number of observation coordinates, for atmospheric measurements INTEGER(iwp) :: n_tr_st !< number of trajectories / station of a measurement INTEGER(iwp) :: nmeas !< number of measured variables (atmosphere + soil) INTEGER(iwp) :: ns_soil = 0 !< number of observation coordinates on subdomain, for soil measurements INTEGER(iwp) :: ns_soil_tot = 0 !< total number of observation coordinates, for soil measurements INTEGER(iwp) :: start_coord_a = 0 !< start coordinate in NetCDF file for local atmosphere observations INTEGER(iwp) :: start_coord_s = 0 !< start coordinate in NetCDF file for local soil observations INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: dim_t !< number observations individual for each trajectory !< or station that are no _FillValues INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: i !< grid index for measurement position in x-direction INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: j !< grid index for measurement position in y-direction INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: k !< grid index for measurement position in k-direction INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: i_soil !< grid index for measurement position in x-direction INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: j_soil !< grid index for measurement position in y-direction INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: k_soil !< grid index for measurement position in k-direction LOGICAL :: trajectory = .FALSE. !< flag indicating that the observation is a mobile observation LOGICAL :: timseries = .FALSE. !< flag indicating that the observation is a stationary point measurement LOGICAL :: timseries_profile = .FALSE. !< flag indicating that the observation is a stationary profile measurement LOGICAL :: soil_sampling = .FALSE. !< flag indicating that soil state variables were sampled REAL(wp) :: fill_eutm !< fill value for UTM coordinates in case of missing values REAL(wp) :: fill_nutm !< fill value for UTM coordinates in case of missing values REAL(wp) :: fill_zar !< fill value for heigth coordinates in case of missing values REAL(wp) :: fillout = -9999.0 !< fill value for output in case a observation is taken !< e.g. from inside a building REAL(wp) :: origin_x_obs !< origin of the observation in UTM coordiates in x-direction REAL(wp) :: origin_y_obs !< origin of the observation in UTM coordiates in y-direction REAL(wp), DIMENSION(:), ALLOCATABLE :: zar !< measurement height above ground level REAL(wp), DIMENSION(:), ALLOCATABLE :: depth !< measurement depth in soil REAL(wp), DIMENSION(:,:), ALLOCATABLE :: measured_vars !< measured variables REAL(wp), DIMENSION(:,:), ALLOCATABLE :: measured_vars_soil !< measured variables TYPE( virt_var_atts ), DIMENSION(:), ALLOCATABLE :: var_atts !< variable attributes END TYPE virt_mea CHARACTER(LEN=5) :: char_eutm = "E_UTM" !< dimension name for UTM coordinate easting CHARACTER(LEN=11) :: char_feature = "featureType" !< attribute name for feature type ! This need to be generalized CHARACTER(LEN=10) :: char_fill = '_FillValue' !< attribute name for fill value CHARACTER(LEN=9) :: char_long = 'long_name' !< attribute name for long_name CHARACTER(LEN=13) :: char_standard = 'standard_name' !< attribute name for standard_name CHARACTER(LEN=5) :: char_unit = 'units' !< attribute name for standard_name CHARACTER(LEN=11) :: char_soil = "soil_sample" !< attribute name for soil sampling indication CHARACTER(LEN=18) :: char_mv = "measured_variables" !< variable name for the array with the measured variable names CHARACTER(LEN=5) :: char_nutm = "N_UTM" !< dimension name for UTM coordinate northing CHARACTER(LEN=18) :: char_numstations = "number_of_stations" !< attribute name for number of stations CHARACTER(LEN=8) :: char_origx = "origin_x" !< attribute name for station coordinate in x CHARACTER(LEN=8) :: char_origy = "origin_y" !< attribute name for station coordinate in y CHARACTER(LEN=4) :: char_site = "site" !< attribute name for site name CHARACTER(LEN=9) :: char_station_h = "station_h" !< variable name indicating height of the site CHARACTER(LEN=1) :: char_zar = "z" !< attribute name indicating height above reference level CHARACTER(LEN=10) :: type_ts = 'timeSeries' !< name of stationary point measurements CHARACTER(LEN=10) :: type_traj = 'trajectory' !< name of line measurements CHARACTER(LEN=17) :: type_tspr = 'timeSeriesProfile' !< name of stationary profile measurements CHARACTER(LEN=6), DIMENSION(1:5) :: soil_vars = (/ & !< list of soil variables 't_soil', & 'm_soil', & 'lwc ', & 'lwcs ', & 'smp ' /) CHARACTER(LEN=10), DIMENSION(0:1,1:8) :: chem_vars = RESHAPE( (/ & 'mcpm1 ', 'PM1 ', & 'mcpm2p5 ', 'PM2.5 ', & 'mcpm10 ', 'PM10 ', & 'mfno2 ', 'NO2 ', & 'mfno ', 'NO ', & 'mcno2 ', 'NO2 ', & 'mcno ', 'NO ', & 'tro3 ', 'O3 ' & /), (/ 2, 8 /) ) LOGICAL :: global_attribute = .TRUE. !< flag indicating a global attribute LOGICAL :: initial_write_coordinates = .FALSE. !< flag indicating a global attribute LOGICAL :: use_virtual_measurement = .FALSE. !< Namelist parameter INTEGER(iwp) :: maximum_name_length = 32 !< maximum name length of station names INTEGER(iwp) :: ntimesteps !< number of timesteps defined in NetCDF output file INTEGER(iwp) :: off_pr = 1 !< number neighboring grid points (in each direction) where virtual profile !< measurements shall be taken, in addition to the given coordinates in the driver INTEGER(iwp) :: off_ts = 1 !< number neighboring grid points (in each direction) where virtual timeseries !< measurements shall be taken, in addition to the given coordinates in the driver INTEGER(iwp) :: off_tr = 1 !< number neighboring grid points (in each direction) where virtual trajectory !< measurements shall be taken, in addition to the given coordinates in the driver REAL(wp) :: dt_virtual_measurement = 0.0_wp !< sampling interval REAL(wp) :: time_virtual_measurement = 0.0_wp !< time since last sampling REAL(wp) :: vm_time_start = 0.0 !< time after which sampling shall start TYPE( virt_general ) :: vmea_general !< data structure which encompass global variables TYPE( virt_mea ), DIMENSION(:), ALLOCATABLE :: vmea !< data structure contain station-specific variables INTERFACE vm_check_parameters MODULE PROCEDURE vm_check_parameters END INTERFACE vm_check_parameters INTERFACE vm_data_output MODULE PROCEDURE vm_data_output END INTERFACE vm_data_output INTERFACE vm_init MODULE PROCEDURE vm_init END INTERFACE vm_init INTERFACE vm_init_output MODULE PROCEDURE vm_init_output END INTERFACE vm_init_output INTERFACE vm_parin MODULE PROCEDURE vm_parin END INTERFACE vm_parin INTERFACE vm_sampling MODULE PROCEDURE vm_sampling END INTERFACE vm_sampling SAVE PRIVATE ! !-- Public interfaces PUBLIC vm_check_parameters, & vm_data_output, & vm_init, & vm_init_output, & vm_parin, & vm_sampling ! !-- Public variables PUBLIC dt_virtual_measurement, & time_virtual_measurement, & vmea, & vmea_general, & vm_time_start CONTAINS !------------------------------------------------------------------------------! ! Description: ! ------------ !> Check parameters for virtual measurement module !------------------------------------------------------------------------------! SUBROUTINE vm_check_parameters IF ( .NOT. virtual_measurement ) RETURN ! !-- Virtual measurements require a setup file. IF ( .NOT. input_pids_vm ) THEN message_string = 'If virtual measurements are taken, a setup input ' // & 'file for the site locations is mandatory.' CALL message( 'vm_check_parameters', 'PA0533', 1, 2, 0, 6, 0 ) ENDIF ! !-- In case virtual measurements are taken, a static input file is required. !-- This is because UTM coordinates for the PALM domain origin are required !-- for correct mapping of the measurements. !-- ToDo: Revise this later and remove this requirement. IF ( .NOT. input_pids_static ) THEN message_string = 'If virtual measurements are taken, a static input ' //& 'file is mandatory.' CALL message( 'vm_check_parameters', 'PA0534', 1, 2, 0, 6, 0 ) ENDIF #if !defined( __netcdf4_parallel ) ! !-- In case of non-parallel NetCDF the virtual measurement output is not !-- working. This is only designed for parallel NetCDF. message_string = 'If virtual measurements are taken, parallel ' // & 'NetCDF is required.' CALL message( 'vm_check_parameters', 'PA0708', 1, 2, 0, 6, 0 ) #endif ! !-- Check if the given number of neighboring grid points do not exceeds the number !-- of ghost points. IF ( off_pr > nbgp - 1 .OR. off_ts > nbgp - 1 .OR. off_tr > nbgp - 1 ) & THEN WRITE(message_string,*) & 'If virtual measurements are taken, the number ' // & 'of surrounding grid points must not be larger ' // & 'than the number of ghost points - 1, which is: ', & nbgp - 1 CALL message( 'vm_check_parameters', 'PA0705', 1, 2, 0, 6, 0 ) ENDIF IF ( dt_virtual_measurement <= 0.0 ) THEN message_string = 'dt_virtual_measurement must be > 0.0' CALL message( 'check_parameters', 'PA0706', 1, 2, 0, 6, 0 ) ENDIF END SUBROUTINE vm_check_parameters !------------------------------------------------------------------------------! ! Description: ! ------------ !> Subroutine defines variable attributes according to UC2 standard. Note, later !> this list can be moved to the data-output module where it can be re-used also !> for other output. !------------------------------------------------------------------------------! SUBROUTINE vm_set_attributes( output_variable ) TYPE( virt_var_atts ), INTENT(INOUT) :: output_variable !< data structure with attributes that need to be set output_variable%long_name = 'none' output_variable%standard_name = 'none' output_variable%units = 'none' output_variable%coordinates = 'lon lat E_UTM N_UTM x y z time station_name' output_variable%grid_mapping = 'crs' SELECT CASE ( TRIM( output_variable%name ) ) CASE ( 'u' ) output_variable%long_name = 'u wind component' output_variable%units = 'm s-1' CASE ( 'ua' ) output_variable%long_name = 'eastward wind' output_variable%standard_name = 'eastward_wind' output_variable%units = 'm s-1' CASE ( 'v' ) output_variable%long_name = 'v wind component' output_variable%units = 'm s-1' CASE ( 'va' ) output_variable%long_name = 'northward wind' output_variable%standard_name = 'northward_wind' output_variable%units = 'm s-1' CASE ( 'w' ) output_variable%long_name = 'w wind component' output_variable%standard_name = 'upward_air_velocity' output_variable%units = 'm s-1' CASE ( 'wspeed' ) output_variable%long_name = 'wind speed' output_variable%standard_name = 'wind_speed' output_variable%units = 'm s-1' CASE ( 'wdir' ) output_variable%long_name = 'wind from direction' output_variable%standard_name = 'wind_from_direction' output_variable%units = 'degrees' CASE ( 'theta' ) output_variable%long_name = 'air potential temperature' output_variable%standard_name = 'air_potential_temperature' output_variable%units = 'K' CASE ( 'utheta' ) output_variable%long_name = 'eastward kinematic sensible heat flux in air' output_variable%units = 'K m s-1' CASE ( 'vtheta' ) output_variable%long_name = 'northward kinematic sensible heat flux in air' output_variable%units = 'K m s-1' CASE ( 'wtheta' ) output_variable%long_name = 'upward kinematic sensible heat flux in air' output_variable%units = 'K m s-1' CASE ( 'ta' ) output_variable%long_name = 'air temperature' output_variable%standard_name = 'air_temperature' output_variable%units = 'degree_C' CASE ( 'tva' ) output_variable%long_name = 'virtual acoustic temperature' output_variable%units = 'K' CASE ( 'haa' ) output_variable%long_name = 'absolute atmospheric humidity' output_variable%units = 'kg m-3' CASE ( 'hus' ) output_variable%long_name = 'specific humidity' output_variable%standard_name = 'specific_humidity' output_variable%units = 'kg kg-1' CASE ( 'hur' ) output_variable%long_name = 'relative humidity' output_variable%standard_name = 'relative_humidity' output_variable%units = '1' CASE ( 'rlu' ) output_variable%long_name = 'upwelling longwave flux in air' output_variable%standard_name = 'upwelling_longwave_flux_in_air' output_variable%units = 'W m-2' CASE ( 'rlus' ) output_variable%long_name = 'surface upwelling longwave flux in air' output_variable%standard_name = 'surface_upwelling_longwave_flux_in_air' output_variable%units = 'W m-2' CASE ( 'rld' ) output_variable%long_name = 'downwelling longwave flux in air' output_variable%standard_name = 'downwelling_longwave_flux_in_air' output_variable%units = 'W m-2' CASE ( 'rsddif' ) output_variable%long_name = 'diffuse downwelling shortwave flux in air' output_variable%standard_name = 'diffuse_downwelling_shortwave_flux_in_air' output_variable%units = 'W m-2' CASE ( 'rsd' ) output_variable%long_name = 'downwelling shortwave flux in air' output_variable%standard_name = 'downwelling_shortwave_flux_in_air' output_variable%units = 'W m-2' CASE ( 'rnds' ) output_variable%long_name = 'surface net downward radiative flux' output_variable%standard_name = 'surface_net_downward_radiative_flux' output_variable%units = 'W m-2' CASE ( 'rsu' ) output_variable%long_name = 'upwelling shortwave flux in air' output_variable%standard_name = 'upwelling_shortwave_flux_in_air' output_variable%units = 'W m-2' CASE ( 'rsus' ) output_variable%long_name = 'surface upwelling shortwave flux in air' output_variable%standard_name = 'surface_upwelling_shortwave_flux_in_air' output_variable%units = 'W m-2' CASE ( 'rsds' ) output_variable%long_name = 'surface downwelling shortwave flux in air' output_variable%standard_name = 'surface_downwelling_shortwave_flux_in_air' output_variable%units = 'W m-2' CASE ( 'hfss' ) output_variable%long_name = 'surface upward sensible heat flux' output_variable%standard_name = 'surface_upward_sensible_heat_flux' output_variable%units = 'W m-2' CASE ( 'hfls' ) output_variable%long_name = 'surface upward latent heat flux' output_variable%standard_name = 'surface_upward_latent_heat_flux' output_variable%units = 'W m-2' CASE ( 'ts' ) output_variable%long_name = 'surface temperature' output_variable%standard_name = 'surface_temperature' output_variable%units = 'K' CASE ( 'thetas' ) output_variable%long_name = 'surface layer temperature scale' output_variable%units = 'K' CASE ( 'us' ) output_variable%long_name = 'friction velocity' output_variable%units = 'm s-1' CASE ( 'uw' ) output_variable%long_name = 'upward eastward kinematic momentum flux in air' output_variable%units = 'm2 s-2' CASE ( 'vw' ) output_variable%long_name = 'upward northward kinematic momentum flux in air' output_variable%units = 'm2 s-2' CASE ( 'uv' ) output_variable%long_name = 'eastward northward kinematic momentum flux in air' output_variable%units = 'm2 s-2' CASE ( 'plev' ) output_variable%long_name = 'air pressure' output_variable%standard_name = 'air_pressure' output_variable%units = 'Pa' CASE ( 'm_soil' ) output_variable%long_name = 'soil moisture volumetric' output_variable%units = 'm3 m-3' CASE ( 't_soil' ) output_variable%long_name = 'soil temperature' output_variable%standard_name = 'soil_temperature' output_variable%units = 'degree_C' CASE ( 'hfdg' ) output_variable%long_name = 'downward heat flux at ground level in soil' output_variable%standard_name = 'downward_heat_flux_at_ground_level_in_soil' output_variable%units = 'W m-2' CASE ( 'hfds' ) output_variable%long_name = 'downward heat flux in soil' output_variable%standard_name = 'downward_heat_flux_in_soil' output_variable%units = 'W m-2' CASE ( 'hfla' ) output_variable%long_name = 'upward latent heat flux in air' output_variable%standard_name = 'upward_latent_heat_flux_in_air' output_variable%units = 'W m-2' CASE ( 'hfsa' ) output_variable%long_name = 'upward latent heat flux in air' output_variable%standard_name = 'upward_sensible_heat_flux_in_air' output_variable%units = 'W m-2' CASE ( 'jno2' ) output_variable%long_name = 'photolysis rate of nitrogen dioxide' output_variable%standard_name = 'photolysis_rate_of_nitrogen_dioxide' output_variable%units = 's-1' CASE ( 'lwcs' ) output_variable%long_name = 'liquid water content of soil layer' output_variable%standard_name = 'liquid_water_content_of_soil_layer' output_variable%units = 'kg m-2' CASE ( 'lwp' ) output_variable%long_name = 'liquid water path' output_variable%standard_name = 'atmosphere_mass_content_of_cloud_liquid_water' output_variable%units = 'kg m-2' CASE ( 'ps' ) output_variable%long_name = 'surface air pressure' output_variable%standard_name = 'surface_air_pressure' output_variable%units = 'hPa' CASE ( 'pswrtg' ) output_variable%long_name = 'platform speed wrt ground' output_variable%standard_name = 'platform_speed_wrt_ground' output_variable%units = 'm s-1' CASE ( 'pswrta' ) output_variable%long_name = 'platform speed wrt air' output_variable%standard_name = 'platform_speed_wrt_air' output_variable%units = 'm s-1' CASE ( 'pwv' ) output_variable%long_name = 'water vapor partial pressure in air' output_variable%standard_name = 'water_vapor_partial_pressure_in_air' output_variable%units = 'hPa' CASE ( 'ssdu' ) output_variable%long_name = 'duration of sunshine' output_variable%standard_name = 'duration_of_sunshine' output_variable%units = 's' CASE ( 't_lw' ) output_variable%long_name = 'land water temperature' output_variable%units = 'degree_C' CASE ( 'tb' ) output_variable%long_name = 'brightness temperature' output_variable%standard_name = 'brightness_temperature' output_variable%units = 'K' CASE ( 'uqv' ) output_variable%long_name = 'eastward kinematic latent heat flux in air' output_variable%units = 'g kg-1 m s-1' CASE ( 'vqv' ) output_variable%long_name = 'northward kinematic latent heat flux in air' output_variable%units = 'g kg-1 m s-1' CASE ( 'wqv' ) output_variable%long_name = 'upward kinematic latent heat flux in air' output_variable%units = 'g kg-1 m s-1' CASE ( 'zcb' ) output_variable%long_name = 'cloud base altitude' output_variable%standard_name = 'cloud_base_altitude' output_variable%units = 'm' CASE ( 'zmla' ) output_variable%long_name = 'atmosphere boundary layer thickness' output_variable%standard_name = 'atmosphere_boundary_layer_thickness' output_variable%units = 'm' CASE ( 'mcpm1' ) output_variable%long_name = 'mass concentration of pm1 ambient aerosol particles in air' output_variable%standard_name = 'mass_concentration_of_pm1_ambient_aerosol_particles_in_air' output_variable%units = 'kg m-3' CASE ( 'mcpm10' ) output_variable%long_name = 'mass concentration of pm10 ambient aerosol particles in air' output_variable%standard_name = 'mass_concentration_of_pm10_ambient_aerosol_particles_in_air' output_variable%units = 'kg m-3' CASE ( 'mcpm2p5' ) output_variable%long_name = 'mass concentration of pm2p5 ambient aerosol particles in air' output_variable%standard_name = 'mass_concentration_of_pm2p5_ambient_aerosol_particles_in_air' output_variable%units = 'kg m-3' CASE ( 'mfno', 'mcno' ) output_variable%long_name = 'mole fraction of nitrogen monoxide in air' output_variable%standard_name = 'mole_fraction_of_nitrogen_monoxide_in_air' output_variable%units = 'ppm' !'mol mol-1' CASE ( 'mfno2', 'mcno2' ) output_variable%long_name = 'mole fraction of nitrogen dioxide in air' output_variable%standard_name = 'mole_fraction_of_nitrogen_dioxide_in_air' output_variable%units = 'ppm' !'mol mol-1' CASE ( 'tro3' ) output_variable%long_name = 'mole fraction of ozone in air' output_variable%standard_name = 'mole_fraction_of_ozone_in_air' output_variable%units = 'ppm' !'mol mol-1' CASE DEFAULT END SELECT END SUBROUTINE vm_set_attributes !------------------------------------------------------------------------------! ! Description: ! ------------ !> Read namelist for the virtual measurement module !------------------------------------------------------------------------------! SUBROUTINE vm_parin CHARACTER (LEN=80) :: line !< dummy string that contains the current line of the parameter file NAMELIST /virtual_measurement_parameters/ dt_virtual_measurement, & off_ts, & off_pr, & off_tr, & use_virtual_measurement, & vm_time_start line = ' ' ! !-- Try to find stg package REWIND ( 11 ) line = ' ' DO WHILE ( INDEX( line, '&virtual_measurement_parameters' ) == 0 ) READ ( 11, '(A)', END=20 ) line ENDDO BACKSPACE ( 11 ) ! !-- Read namelist READ ( 11, virtual_measurement_parameters, ERR = 10, END = 20 ) ! !-- Set flag that indicates that the virtual measurement module is switched on IF ( use_virtual_measurement ) virtual_measurement = .TRUE. GOTO 20 10 BACKSPACE( 11 ) READ( 11 , '(A)') line CALL parin_fail_message( 'virtual_measurement_parameters', line ) 20 CONTINUE END SUBROUTINE vm_parin !------------------------------------------------------------------------------! ! Description: ! ------------ !> Initialize virtual measurements: read coordiante arrays and measured !> variables, set indicies indicating the measurement points, read further !> attributes, etc.. !------------------------------------------------------------------------------! SUBROUTINE vm_init CHARACTER(LEN=5) :: dum !< dummy string indicating station id CHARACTER(LEN=100), DIMENSION(50) :: measured_variables_file = '' !< array with all measured variables read from NetCDF CHARACTER(LEN=100), DIMENSION(50) :: measured_variables = '' !< dummy array with all measured variables that are allowed INTEGER(iwp) :: dim_ntime !< dimension size of time coordinate INTEGER(iwp) :: i !< grid index of virtual observation point in x-direction INTEGER(iwp) :: is !< grid index of real observation point of the respective station in x-direction INTEGER(iwp) :: j !< grid index of observation point in x-direction INTEGER(iwp) :: js !< grid index of real observation point of the respective station in y-direction INTEGER(iwp) :: k !< grid index of observation point in x-direction INTEGER(iwp) :: kl !< lower vertical index of surrounding grid points of an observation coordinate INTEGER(iwp) :: ks !< grid index of real observation point of the respective station in z-direction INTEGER(iwp) :: ksurf !< topography top index INTEGER(iwp) :: ku !< upper vertical index of surrounding grid points of an observation coordinate INTEGER(iwp) :: l !< running index over all stations INTEGER(iwp) :: len_char !< character length of single measured variables without Null character INTEGER(iwp) :: ll !< running index over all measured variables in file INTEGER(iwp) :: m !< running index for surface elements INTEGER(iwp) :: n !< running index over trajectory coordinates INTEGER(iwp) :: nofill !< dummy for nofill return value (not used) INTEGER(iwp) :: ns !< counter variable for number of observation points on subdomain INTEGER(iwp) :: off !< number of surrounding grid points to be sampled INTEGER(iwp) :: t !< running index over number of trajectories INTEGER(KIND=1) :: soil_dum !< dummy variable to input a soil flag INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: ns_all !< dummy array used to sum-up the number of observation coordinates INTEGER(iwp), DIMENSION(:,:), ALLOCATABLE :: ns_atmos !< number of observation points for each station on each mpi rank INTEGER(iwp), DIMENSION(:,:), ALLOCATABLE :: ns_soil !< number of observation points for each station on each mpi rank INTEGER(iwp), DIMENSION(:,:,:), ALLOCATABLE :: meas_flag !< mask array indicating measurement positions LOGICAL :: on_pe !< flag indicating that the respective measurement coordinate is on subdomain REAL(wp) :: fill_eutm !< _FillValue for coordinate array E_UTM REAL(wp) :: fill_nutm !< _FillValue for coordinate array N_UTM REAL(wp) :: fill_zar !< _FillValue for height coordinate REAL(wp), DIMENSION(:,:), ALLOCATABLE :: e_utm !< easting UTM coordinate, temporary variable REAL(wp), DIMENSION(:,:), ALLOCATABLE :: n_utm !< northing UTM coordinate, temporary variable REAL(wp), DIMENSION(:,:), ALLOCATABLE :: e_utm_tmp !< EUTM coordinate before rotation REAL(wp), DIMENSION(:,:), ALLOCATABLE :: n_utm_tmp !< NUTM coordinate before rotation REAL(wp), DIMENSION(:,:), ALLOCATABLE :: station_h !< station height above reference REAL(wp), DIMENSION(:,:), ALLOCATABLE :: zar !< observation height above reference #if defined( __netcdf ) ! !-- Open the input file. CALL open_read_file( input_file_vm, pids_id ) ! !-- Obtain number of sites. CALL get_attribute( pids_id, & char_numstations, & vmea_general%nvm, & global_attribute ) ! !-- Allocate data structure which encompass all required information, such as !-- grid points indicies, absolute UTM coordinates, the measured quantities, !-- etc. . ALLOCATE( vmea(1:vmea_general%nvm) ) ! !-- Allocate flag array. This dummy array is used to identify grid points !-- where virtual measurements should be taken. Please note, in order to !-- include also the surrounding grid points of the original coordinate !-- ghost points are required. ALLOCATE( meas_flag(nzb:nzt+1,nysg:nyng,nxlg:nxrg) ) meas_flag = 0 ! !-- Loop over all sites in the setup file. DO l = 1, vmea_general%nvm ! !-- Determine suffix which contains the ID, ordered according to the number !-- of measurements. IF( l < 10 ) THEN WRITE( dum, '(I1)') l ELSEIF( l < 100 ) THEN WRITE( dum, '(I2)') l ELSEIF( l < 1000 ) THEN WRITE( dum, '(I3)') l ELSEIF( l < 10000 ) THEN WRITE( dum, '(I4)') l ELSEIF( l < 100000 ) THEN WRITE( dum, '(I5)') l ENDIF ! !-- Read the origin site coordinates (UTM). CALL get_attribute( pids_id, & char_origx // TRIM( dum ), & vmea(l)%origin_x_obs, & global_attribute ) CALL get_attribute( pids_id, & char_origy // TRIM( dum ), & vmea(l)%origin_y_obs, & global_attribute ) ! !-- Read site name. CALL get_attribute( pids_id, & char_site // TRIM( dum ), & vmea(l)%site, & global_attribute ) ! !-- Read a flag which indicates that also soil quantities are take at the !-- respective site (is part of the virtual measurement driver). CALL get_attribute( pids_id, & char_soil // TRIM( dum ), & soil_dum, & global_attribute ) ! !-- Set flag indicating soil-sampling. IF ( soil_dum == 1 ) vmea(l)%soil_sampling = .TRUE. ! !-- Read type of the measurement (trajectory, profile, timeseries). CALL get_attribute( pids_id, & char_feature // TRIM( dum ), & vmea(l)%feature_type, & global_attribute ) ! !--- Set logicals depending on the type of the measurement IF ( INDEX( vmea(l)%feature_type, type_tspr ) /= 0 ) THEN vmea(l)%timseries_profile = .TRUE. ELSEIF ( INDEX( vmea(l)%feature_type, type_ts ) /= 0 ) THEN vmea(l)%timseries = .TRUE. ELSEIF ( INDEX( vmea(l)%feature_type, type_traj ) /= 0 ) THEN vmea(l)%trajectory = .TRUE. ! !-- Give error message in case the type matches non of the pre-defined types. ELSE message_string = 'Attribue featureType = ' // & TRIM( vmea(l)%feature_type ) // & ' is not allowed.' CALL message( 'vm_init', 'PA0535', 1, 2, 0, 6, 0 ) ENDIF ! !-- Read string with all measured variables at this site. measured_variables_file = '' CALL get_variable( pids_id, & char_mv // TRIM( dum ), & measured_variables_file ) ! !-- Count the number of measured variables. !-- Please note, for some NetCDF interal reasons characters end with a NULL, !-- i.e. also empty characters contain a NULL. Therefore, check the strings !-- for a NULL to get the correct character length in order to compare !-- them with the list of allowed variables. vmea(l)%nmeas = 1 DO ll = 1, SIZE( measured_variables_file ) IF ( measured_variables_file(ll)(1:1) /= CHAR(0) .AND. & measured_variables_file(ll)(1:1) /= ' ') THEN ! !-- Obtain character length of the character len_char = 1 DO WHILE ( measured_variables_file(ll)(len_char:len_char) /= CHAR(0)& .AND. measured_variables_file(ll)(len_char:len_char) /= ' ' ) len_char = len_char + 1 ENDDO len_char = len_char - 1 measured_variables(vmea(l)%nmeas) = & measured_variables_file(ll)(1:len_char) vmea(l)%nmeas = vmea(l)%nmeas + 1 ENDIF ENDDO vmea(l)%nmeas = vmea(l)%nmeas - 1 ! !-- Allocate data-type array for the measured variables names and attributes !-- at the respective site. ALLOCATE( vmea(l)%var_atts(1:vmea(l)%nmeas) ) ! !-- Store the variable names in a data structures, which assigns further !-- attributes to this name. Further, for data output reasons, create a !-- string of output variables, which will be written into the attribute !-- data_content. DO ll = 1, vmea(l)%nmeas vmea(l)%var_atts(ll)%name = TRIM( measured_variables(ll) ) vmea(l)%data_content = TRIM( vmea(l)%data_content ) // " " // & TRIM( vmea(l)%var_atts(ll)%name ) ENDDO ! !-- Read all the UTM coordinates for the site. Based on the coordinates, !-- define the grid-index space on each subdomain where virtual measurements !-- should be taken. Note, the entire coordinate array (on the entire model !-- domain) won't be stored as this would exceed memory requirements, !-- particularly for trajectories. IF ( vmea(l)%nmeas > 0 ) THEN ! !-- For stationary measurements UTM coordinates are just one value and !-- its dimension is "station", while for mobile measurements UTM !-- coordinates are arrays depending on the number of trajectories and !-- time, according to (UC)2 standard. First, inquire dimension length !-- of the UTM coordinates. IF ( vmea(l)%trajectory ) THEN ! !-- For non-stationary measurements read the number of trajectories !-- and the number of time coordinates. CALL get_dimension_length( pids_id, & vmea(l)%n_tr_st, & "traj" // TRIM( dum ) ) CALL get_dimension_length( pids_id, & dim_ntime, & "ntime" // TRIM( dum ) ) ! !-- For stationary measurements the dimension for UTM is station !-- and for the time-coordinate it is one. ELSE CALL get_dimension_length( pids_id, & vmea(l)%n_tr_st, & "station" // TRIM( dum ) ) dim_ntime = 1 ENDIF ! !- Allocate array which defines individual time/space frame for each !-- trajectory or station. ALLOCATE( vmea(l)%dim_t(1:vmea(l)%n_tr_st) ) ! !-- Allocate temporary arrays for UTM and height coordinates. Note, !-- on file UTM coordinates might be 1D or 2D variables ALLOCATE( e_utm(1:vmea(l)%n_tr_st,1:dim_ntime) ) ALLOCATE( n_utm(1:vmea(l)%n_tr_st,1:dim_ntime) ) ALLOCATE( station_h(1:vmea(l)%n_tr_st,1:dim_ntime) ) ALLOCATE( zar(1:vmea(l)%n_tr_st,1:dim_ntime) ) e_utm = 0.0_wp n_utm = 0.0_wp station_h = 0.0_wp zar = 0.0_wp ALLOCATE( e_utm_tmp(1:vmea(l)%n_tr_st,1:dim_ntime) ) ALLOCATE( n_utm_tmp(1:vmea(l)%n_tr_st,1:dim_ntime) ) ! !-- Read UTM and height coordinates coordinates for all trajectories and !-- times. Note, in case these obtain any missing values, replace them !-- with default _FillValues. CALL inquire_fill_value( pids_id, & char_eutm // TRIM( dum ), & nofill, & fill_eutm ) CALL inquire_fill_value( pids_id, & char_nutm // TRIM( dum ), & nofill, & fill_nutm ) CALL inquire_fill_value( pids_id, & char_zar // TRIM( dum ), & nofill, & fill_zar ) ! !-- Further line is just to avoid compiler warnings. nofill might be used !-- in future. IF ( nofill == 0 .OR. nofill /= 0 ) CONTINUE ! !-- Read observation coordinates. Please note, for trajectories the !-- observation height is stored directly in z, while for timeSeries !-- it is stored in z - station_h, according to UC2-standard. IF ( vmea(l)%trajectory ) THEN CALL get_variable( pids_id, & char_eutm // TRIM( dum ), & e_utm, & 0, dim_ntime-1, & 0, vmea(l)%n_tr_st-1 ) CALL get_variable( pids_id, & char_nutm // TRIM( dum ), & n_utm, & 0, dim_ntime-1, & 0, vmea(l)%n_tr_st-1 ) CALL get_variable( pids_id, & char_zar // TRIM( dum ), & zar, & 0, dim_ntime-1, & 0, vmea(l)%n_tr_st-1 ) ELSE CALL get_variable( pids_id, & char_eutm // TRIM( dum ), & e_utm(:,1) ) CALL get_variable( pids_id, & char_nutm // TRIM( dum ), & n_utm(:,1) ) CALL get_variable( pids_id, & char_station_h // TRIM( dum ), & station_h(:,1) ) CALL get_variable( pids_id, & char_zar // TRIM( dum ), & zar(:,1) ) ENDIF e_utm = MERGE( e_utm, vmea(l)%fillout, e_utm /= fill_eutm ) n_utm = MERGE( n_utm, vmea(l)%fillout, n_utm /= fill_nutm ) zar = MERGE( zar, vmea(l)%fillout, zar /= fill_zar ) ! !-- Compute observation height above ground. zar = zar - station_h ! !-- Based on UTM coordinates, check if the measurement station or parts !-- of the trajectory are on subdomain. This case, setup grid index space !-- sample these quantities. meas_flag = 0 DO t = 1, vmea(l)%n_tr_st ! !-- First, compute relative x- and y-coordinates with respect to the !-- lower-left origin of the model domain, which is the difference !-- between UTM coordinates. Note, if the origin is not correct, the !-- virtual sites will be misplaced. Further, in case of an rotated !-- model domain, the UTM coordinates must be also rotated. e_utm_tmp(t,1:dim_ntime) = e_utm(t,1:dim_ntime) - init_model%origin_x n_utm_tmp(t,1:dim_ntime) = n_utm(t,1:dim_ntime) - init_model%origin_y e_utm(t,1:dim_ntime) = COS( init_model%rotation_angle * pi / 180.0_wp ) & * e_utm_tmp(t,1:dim_ntime) & - SIN( init_model%rotation_angle * pi / 180.0_wp ) & * n_utm_tmp(t,1:dim_ntime) n_utm(t,1:dim_ntime) = SIN( init_model%rotation_angle * pi / 180.0_wp ) & * e_utm_tmp(t,1:dim_ntime) & + COS( init_model%rotation_angle * pi / 180.0_wp ) & * n_utm_tmp(t,1:dim_ntime) ! !-- Determine the individual time coordinate length for each station and !-- trajectory. This is required as several stations and trajectories !-- are merged into one file but they do not have the same number of !-- points in time, hence, missing values may occur and cannot be !-- processed further. This is actually a work-around for the specific !-- (UC)2 dataset, but it won't harm anyway. vmea(l)%dim_t(t) = 0 DO n = 1, dim_ntime IF ( e_utm(t,n) /= fill_eutm .AND. & n_utm(t,n) /= fill_nutm .AND. & zar(t,n) /= fill_zar ) vmea(l)%dim_t(t) = n ENDDO ! !-- Compute grid indices relative to origin and check if these are !-- on the subdomain. Note, virtual measurements will be taken also !-- at grid points surrounding the station, hence, check also for !-- these grid points. !-- The number of surrounding grid points is set according to the !-- featureType. IF ( vmea(l)%timseries_profile ) THEN off = off_pr ELSEIF ( vmea(l)%timseries ) THEN off = off_ts ELSEIF ( vmea(l)%trajectory ) THEN off = off_tr ENDIF DO n = 1, vmea(l)%dim_t(t) is = INT( ( e_utm(t,n) + 0.5_wp * dx ) * ddx, KIND = iwp ) js = INT( ( n_utm(t,n) + 0.5_wp * dy ) * ddy, KIND = iwp ) ! !-- Is the observation point on subdomain? on_pe = ( is >= nxl .AND. is <= nxr .AND. & js >= nys .AND. js <= nyn ) ! !-- Check if observation coordinate is on subdomain IF ( on_pe ) THEN ! !-- Determine vertical index which correspond to the observation !-- height. ksurf = topo_top_ind(js,is,0) ks = MINLOC( ABS( zu - zw(ksurf) - zar(t,n) ), DIM = 1 ) - 1 ! !-- Set mask array at the observation coordinates. Also, flag the !-- surrounding coordinate points, but first check whether the !-- surrounding coordinate points are on the subdomain. kl = MERGE( ks-off, ksurf, ks-off >= nzb .AND. ks-off >= ksurf ) ku = MERGE( ks+off, nzt, ks+off < nzt+1 ) DO i = is-off, is+off DO j = js-off, js+off DO k = kl, ku meas_flag(k,j,i) = MERGE( & IBSET( meas_flag(k,j,i), 0 ), & 0, & BTEST( wall_flags_total_0(k,j,i), 0 ) & ) ENDDO ENDDO ENDDO ENDIF ENDDO ENDDO ! !-- Based on the flag array count the number of sampling coordinates. !-- Please note, sampling coordinates in atmosphere and soil may be !-- different, as within the soil all levels will be measured. !-- Hence, count individually. Start with atmoshere. ns = 0 DO i = nxl-off, nxr+off DO j = nys-off, nyn+off DO k = nzb, nzt+1 ns = ns + MERGE( 1, 0, BTEST( meas_flag(k,j,i), 0 ) ) ENDDO ENDDO ENDDO ! !-- Store number of observation points on subdomain and allocate index !-- arrays as well as array containing height information. vmea(l)%ns = ns ALLOCATE( vmea(l)%i(1:vmea(l)%ns) ) ALLOCATE( vmea(l)%j(1:vmea(l)%ns) ) ALLOCATE( vmea(l)%k(1:vmea(l)%ns) ) ALLOCATE( vmea(l)%zar(1:vmea(l)%ns) ) ! !-- Based on the flag array store the grid indices which correspond to !-- the observation coordinates. ns = 0 DO i = nxl-off, nxr+off DO j = nys-off, nyn+off DO k = nzb, nzt+1 IF ( BTEST( meas_flag(k,j,i), 0 ) ) THEN ns = ns + 1 vmea(l)%i(ns) = i vmea(l)%j(ns) = j vmea(l)%k(ns) = k vmea(l)%zar(ns) = zu(k) - zw(topo_top_ind(j,i,0)) ENDIF ENDDO ENDDO ENDDO ! !-- Same for the soil. Based on the flag array, count the number of !-- sampling coordinates in soil. Sample at all soil levels in this case. !-- Please note, soil variables can only be sampled on subdomains, not !-- on ghost layers. IF ( vmea(l)%soil_sampling ) THEN DO i = nxl, nxr DO j = nys, nyn IF ( ANY( BTEST( meas_flag(:,j,i), 0 ) ) ) THEN IF ( surf_lsm_h%start_index(j,i) <= & surf_lsm_h%end_index(j,i) ) THEN vmea(l)%ns_soil = vmea(l)%ns_soil + & nzt_soil - nzb_soil + 1 ENDIF IF ( surf_usm_h%start_index(j,i) <= & surf_usm_h%end_index(j,i) ) THEN vmea(l)%ns_soil = vmea(l)%ns_soil + & nzt_wall - nzb_wall + 1 ENDIF ENDIF ENDDO ENDDO ENDIF ! !-- Allocate index arrays as well as array containing height information !-- for soil. IF ( vmea(l)%soil_sampling ) THEN ALLOCATE( vmea(l)%i_soil(1:vmea(l)%ns_soil) ) ALLOCATE( vmea(l)%j_soil(1:vmea(l)%ns_soil) ) ALLOCATE( vmea(l)%k_soil(1:vmea(l)%ns_soil) ) ALLOCATE( vmea(l)%depth(1:vmea(l)%ns_soil) ) ENDIF ! !-- For soil, store the grid indices. ns = 0 IF ( vmea(l)%soil_sampling ) THEN DO i = nxl, nxr DO j = nys, nyn IF ( ANY( BTEST( meas_flag(:,j,i), 0 ) ) ) THEN IF ( surf_lsm_h%start_index(j,i) <= & surf_lsm_h%end_index(j,i) ) THEN m = surf_lsm_h%start_index(j,i) DO k = nzb_soil, nzt_soil ns = ns + 1 vmea(l)%i_soil(ns) = i vmea(l)%j_soil(ns) = j vmea(l)%k_soil(ns) = k vmea(l)%depth(ns) = - zs(k) ENDDO ENDIF IF ( surf_usm_h%start_index(j,i) <= & surf_usm_h%end_index(j,i) ) THEN m = surf_usm_h%start_index(j,i) DO k = nzb_wall, nzt_wall ns = ns + 1 vmea(l)%i_soil(ns) = i vmea(l)%j_soil(ns) = j vmea(l)%k_soil(ns) = k vmea(l)%depth(ns) = - surf_usm_h%zw(k,m) ENDDO ENDIF ENDIF ENDDO ENDDO ENDIF ! !-- Allocate array to save the sampled values. ALLOCATE( vmea(l)%measured_vars(1:vmea(l)%ns,1:vmea(l)%nmeas) ) IF ( vmea(l)%soil_sampling ) & ALLOCATE( vmea(l)%measured_vars_soil(1:vmea(l)%ns_soil, & 1:vmea(l)%nmeas) ) ! !-- Initialize with _FillValues vmea(l)%measured_vars(1:vmea(l)%ns,1:vmea(l)%nmeas) = vmea(l)%fillout IF ( vmea(l)%soil_sampling ) & vmea(l)%measured_vars_soil(1:vmea(l)%ns_soil,1:vmea(l)%nmeas) = & vmea(l)%fillout ! !-- Deallocate temporary coordinate arrays IF ( ALLOCATED( e_utm ) ) DEALLOCATE( e_utm ) IF ( ALLOCATED( n_utm ) ) DEALLOCATE( n_utm ) IF ( ALLOCATED( e_utm_tmp ) ) DEALLOCATE( e_utm_tmp ) IF ( ALLOCATED( n_utm_tmp ) ) DEALLOCATE( n_utm_tmp ) IF ( ALLOCATED( n_utm ) ) DEALLOCATE( n_utm ) IF ( ALLOCATED( zar ) ) DEALLOCATE( vmea(l)%dim_t ) IF ( ALLOCATED( zar ) ) DEALLOCATE( zar ) IF ( ALLOCATED( station_h ) ) DEALLOCATE( station_h ) ENDIF ENDDO ! !-- Dellocate flag array DEALLOCATE( meas_flag ) ! !-- Close input file for virtual measurements. CALL close_input_file( pids_id ) ! !-- Sum-up the number of observation coordiates, for atmosphere first. !-- This is actually only required for data output. ALLOCATE( ns_all(1:vmea_general%nvm) ) ns_all = 0 #if defined( __parallel ) CALL MPI_ALLREDUCE( vmea(:)%ns, ns_all(:), vmea_general%nvm, MPI_INTEGER, & MPI_SUM, comm2d, ierr ) #else ns_all(:) = vmea(:)%ns #endif vmea(:)%ns_tot = ns_all(:) ! !-- Now for soil ns_all = 0 #if defined( __parallel ) CALL MPI_ALLREDUCE( vmea(:)%ns_soil, ns_all(:), vmea_general%nvm, & MPI_INTEGER, MPI_SUM, comm2d, ierr ) #else ns_all(:) = vmea(:)%ns_soil #endif vmea(:)%ns_soil_tot = ns_all(:) DEALLOCATE( ns_all ) ! !-- In case of parallel NetCDF the start coordinate for each mpi rank needs to !-- be defined, so that each processor knows where to write the data. #if defined( __netcdf4_parallel ) ALLOCATE( ns_atmos(0:numprocs-1,1:vmea_general%nvm) ) ALLOCATE( ns_soil(0:numprocs-1,1:vmea_general%nvm) ) ns_atmos = 0 ns_soil = 0 DO l = 1, vmea_general%nvm ns_atmos(myid,l) = vmea(l)%ns ns_soil(myid,l) = vmea(l)%ns_soil ENDDO #if defined( __parallel ) CALL MPI_ALLREDUCE( MPI_IN_PLACE, ns_atmos, numprocs * vmea_general%nvm, & MPI_INTEGER, MPI_SUM, comm2d, ierr ) CALL MPI_ALLREDUCE( MPI_IN_PLACE, ns_soil, numprocs * vmea_general%nvm, & MPI_INTEGER, MPI_SUM, comm2d, ierr ) #else ns_atmos(0,:) = vmea(:)%ns ns_soil(0,:) = vmea(:)%ns_soil #endif ! !-- Determine the start coordinate in NetCDF file for the local arrays. !-- Note, start coordinates are initialized with zero for sake of simplicity !-- in summation. However, in NetCDF the start coordinates must be >= 1, !-- so that a one needs to be added at the end. DO l = 1, vmea_general%nvm DO n = 0, myid - 1 vmea(l)%start_coord_a = vmea(l)%start_coord_a + ns_atmos(n,l) vmea(l)%start_coord_s = vmea(l)%start_coord_s + ns_soil(n,l) ENDDO ! !-- Start coordinate in NetCDF starts always at one not at 0. vmea(l)%start_coord_a = vmea(l)%start_coord_a + 1 vmea(l)%start_coord_s = vmea(l)%start_coord_s + 1 ! !-- Determine the local end coordinate vmea(l)%end_coord_a = vmea(l)%start_coord_a + vmea(l)%ns - 1 vmea(l)%end_coord_s = vmea(l)%start_coord_s + vmea(l)%ns_soil - 1 ENDDO DEALLOCATE( ns_atmos ) DEALLOCATE( ns_soil ) #endif #endif END SUBROUTINE vm_init !------------------------------------------------------------------------------! ! Description: ! ------------ !> Initialize output using data-output module !------------------------------------------------------------------------------! SUBROUTINE vm_init_output CHARACTER(LEN=100) :: variable_name !< name of output variable INTEGER(iwp) :: l !< loop index INTEGER(iwp) :: n !< loop index INTEGER :: return_value !< returned status value of called function INTEGER(iwp), DIMENSION(:), ALLOCATABLE :: ndim !< dummy to write dimension REAL(wp) :: dum_lat !< transformed geographical coordinate (latitude) REAL(wp) :: dum_lon !< transformed geographical coordinate (longitude) ! !-- Determine the number of output timesteps. Set a maximum value of 80000 !-- timesteps. ntimesteps = CEILING( & ( end_time - MAX( vm_time_start, time_since_reference_point )& ) / dt_virtual_measurement ) ! !-- Create directory where output files will be stored. CALL local_system( 'mkdir -p VM_OUTPUT' // TRIM( coupling_char ) ) ! !-- Loop over all sites. DO l = 1, vmea_general%nvm ! !-- Skip if no observations will be taken for this site. IF ( vmea(l)%ns_tot == 0 .AND. vmea(l)%ns_soil_tot == 0 ) CYCLE ! !-- Define output file. WRITE( vmea(l)%nc_filename, '(A,I4.4)') 'VM_OUTPUT' // & TRIM( coupling_char ) // '/' //& 'site', l return_value = dom_def_file( vmea(l)%nc_filename, 'netcdf4-parallel' ) ! !-- Define global attributes. !-- Before, transform UTM into geographical coordinates. CALL convert_utm_to_geographic( crs_list, & vmea(l)%origin_x_obs, & vmea(l)%origin_y_obs, & dum_lon, & dum_lat ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'site', & value = TRIM( vmea(l)%site ) ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'title', & value = 'Virtual measurement output') return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'source', & value = 'PALM-4U') return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'institution', & value = input_file_atts%institution ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'acronym', & value = input_file_atts%acronym ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'author', & value = input_file_atts%author ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'contact_person', & value = input_file_atts%contact_person ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'iop', & value = input_file_atts%campaign ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'campaign', & value = 'PALM-4U' ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'origin_time ', & value = origin_date_time) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'location', & value = input_file_atts%location ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'origin_x', & value = vmea(l)%origin_x_obs ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'origin_y', & value = vmea(l)%origin_y_obs ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'origin_lon', & value = dum_lon ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'origin_lat', & value = dum_lat ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'origin_z', & value = 0.0 ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'rotation_angle', & value = input_file_atts%rotation_angle ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'featureType', & value = TRIM( vmea(l)%feature_type_out ) ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'data_content', & value = TRIM( vmea(l)%data_content ) ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'creation_time', & value = input_file_atts%creation_time ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'version', & value = 1 ) !input_file_atts%version ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'creation_time', & value = TRIM( vmea(l)%site ) ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'Conventions', & value = input_file_atts%conventions ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'dependencies', & value = input_file_atts%dependencies ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'history', & value = input_file_atts%history ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'references', & value = input_file_atts%references ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'comment', & value = input_file_atts%comment ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'keywords', & value = input_file_atts%keywords ) return_value = dom_def_att( vmea(l)%nc_filename, & attribute_name = 'licence', & value = '[UC]2 Open Licence; see [UC]2 ' // & 'data policy available at ' // & 'www.uc2-program.org/uc2_data_policy.pdf' ) ! !-- Define dimensions. !-- station ALLOCATE( ndim(1:vmea(l)%ns_tot) ) DO n = 1, vmea(l)%ns_tot ndim(n) = n ENDDO return_value = dom_def_dim( vmea(l)%nc_filename, & dimension_name = 'station', & output_type = 'int32', & bounds = (/1_iwp, vmea(l)%ns_tot/), & values_int32 = ndim ) DEALLOCATE( ndim ) ! !-- ntime ALLOCATE( ndim(1:ntimesteps) ) DO n = 1, ntimesteps ndim(n) = n ENDDO return_value = dom_def_dim( vmea(l)%nc_filename, & dimension_name = 'ntime', & output_type = 'int32', & bounds = (/1_iwp, ntimesteps/), & values_int32 = ndim ) DEALLOCATE( ndim ) ! !-- nv ALLOCATE( ndim(1:2) ) DO n = 1, 2 ndim(n) = n ENDDO return_value = dom_def_dim( vmea(l)%nc_filename, & dimension_name = 'nv', & output_type = 'int32', & bounds = (/1_iwp, 2_iwp/), & values_int32 = ndim ) DEALLOCATE( ndim ) ! !-- maximum name length ALLOCATE( ndim(1:maximum_name_length) ) DO n = 1, maximum_name_length ndim(n) = n ENDDO return_value = dom_def_dim( vmea(l)%nc_filename, & dimension_name = 'max_name_len', & output_type = 'int32', & bounds = (/1_iwp, 32_iwp/), & values_int32 = ndim ) DEALLOCATE( ndim ) ! !-- Define coordinate variables. !-- time variable_name = 'time' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/ 'station ', & 'ntime '/), & output_type = 'real32' ) ! !-- station_name. DOM needs to be enabled to define CHARACTER variables. ! variable_name = 'station_name' ! return_value = dom_def_var( vmea(l)%nc_filename, & ! variable_name = variable_name, & ! dimension_names = (/ 'max_name_len', & ! 'station '/), & ! output_type = 'char' ) ! !-- vrs (vertical reference system) variable_name = 'vrs' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/ 'station' /), & output_type = 'int8' ) ! !-- crs (coordinate reference system) variable_name = 'crs' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/ 'station' /), & output_type = 'int8' ) ! !-- z variable_name = 'z' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/'station'/), & output_type = 'real32' ) ! !-- station_h variable_name = 'station_h' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/'station'/), & output_type = 'real32' ) ! !-- x variable_name = 'x' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/'station'/), & output_type = 'real32' ) ! !-- y variable_name = 'y' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/'station'/), & output_type = 'real32' ) ! !-- E-UTM variable_name = 'E_UTM' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/'station'/), & output_type = 'real32' ) ! !-- N-UTM variable_name = 'N_UTM' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/'station'/), & output_type = 'real32' ) ! !-- latitude variable_name = 'lat' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/'station'/), & output_type = 'real32' ) ! !-- longitude variable_name = 'lon' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/'station'/), & output_type = 'real32' ) ! !-- Set attributes for the coordinate variables. Note, not all coordinates !-- have the same number of attributes. !-- Units return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'time', & attribute_name = char_unit, & value = 'seconds since ' // origin_date_time ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'z', & attribute_name = char_unit, & value = 'm' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'station_h', & attribute_name = char_unit, & value = 'm' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'x', & attribute_name = char_unit, & value = 'm' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'y', & attribute_name = char_unit, & value = 'm' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'E_UTM', & attribute_name = char_unit, & value = 'm' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'N_UTM', & attribute_name = char_unit, & value = 'm' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'lat', & attribute_name = char_unit, & value = 'degrees_north' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'lon', & attribute_name = char_unit, & value = 'degrees_east' ) ! !-- Long name return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'station_name', & attribute_name = char_long, & value = 'station name') return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'time', & attribute_name = char_long, & value = 'time') return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'z', & attribute_name = char_long, & value = 'height above origin' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'station_h', & attribute_name = char_long, & value = 'surface altitude' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'x', & attribute_name = char_long, & value = 'distance to origin in x-direction' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'y', & attribute_name = char_long, & value = 'distance to origin in y-direction' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'E_UTM', & attribute_name = char_long, & value = 'easting' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'N_UTM', & attribute_name = char_long, & value = 'northing' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'lat', & attribute_name = char_long, & value = 'latitude' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'lon', & attribute_name = char_long, & value = 'longitude' ) ! !-- Standard name return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'station_name', & attribute_name = char_standard, & value = 'platform_name') return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'time', & attribute_name = char_standard, & value = 'time') return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'z', & attribute_name = char_standard, & value = 'height_above_mean_sea_level' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'station_h', & attribute_name = char_standard, & value = 'surface_altitude' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'E_UTM', & attribute_name = char_standard, & value = 'projection_x_coordinate' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'N_UTM', & attribute_name = char_standard, & value = 'projection_y_coordinate' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'lat', & attribute_name = char_standard, & value = 'latitude' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'lon', & attribute_name = char_standard, & value = 'longitude' ) ! !-- Axis return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'time', & attribute_name = 'axis', & value = 'T') return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'z', & attribute_name = 'axis', & value = 'Z' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'x', & attribute_name = 'axis', & value = 'X' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'y', & attribute_name = 'axis', & value = 'Y' ) ! !-- Set further individual attributes for the coordinate variables. !-- For station name return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'station_name', & attribute_name = 'cf_role', & value = 'timeseries_id' ) ! !-- For time return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'time', & attribute_name = 'calendar', & value = 'proleptic_gregorian' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'time', & attribute_name = 'bounds', & value = 'time_bounds' ) ! !-- For vertical reference system return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'vrs', & attribute_name = char_long, & value = 'vertical reference system' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'vrs', & attribute_name = 'system_name', & value = 'DHHN2016' ) ! !-- For z return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'z', & attribute_name = 'positive', & value = 'up' ) ! !-- For coordinate reference system return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'crs', & attribute_name = 'epsg_code', & value = coord_ref_sys%epsg_code ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'crs', & attribute_name = 'false_easting', & value = coord_ref_sys%false_easting ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'crs', & attribute_name = 'false_northing', & value = coord_ref_sys%false_northing ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'crs', & attribute_name = 'grid_mapping_name', & value = coord_ref_sys%grid_mapping_name ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'crs', & attribute_name = 'inverse_flattening', & value = coord_ref_sys%inverse_flattening ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'crs', & attribute_name = 'latitude_of_projection_origin',& value = coord_ref_sys%latitude_of_projection_origin ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'crs', & attribute_name = char_long, & value = coord_ref_sys%long_name ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'crs', & attribute_name = 'longitude_of_central_meridian', & value = coord_ref_sys%longitude_of_central_meridian ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'crs', & attribute_name = 'longitude_of_prime_meridian', & value = coord_ref_sys%longitude_of_prime_meridian ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'crs', & attribute_name = 'scale_factor_at_central_meridian', & value = coord_ref_sys%scale_factor_at_central_meridian ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'crs', & attribute_name = 'semi_major_axis', & value = coord_ref_sys%semi_major_axis ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'crs', & attribute_name = char_unit, & value = coord_ref_sys%units ) ! !-- In case of sampled soil quantities, define further dimensions and !-- coordinates. IF ( vmea(l)%soil_sampling ) THEN ! !-- station for soil ALLOCATE( ndim(1:vmea(l)%ns_soil_tot) ) DO n = 1, vmea(l)%ns_soil_tot ndim(n) = n ENDDO return_value = dom_def_dim( vmea(l)%nc_filename, & dimension_name = 'station_soil', & output_type = 'int32', & bounds = (/1_iwp,vmea(l)%ns_soil_tot/), & values_int32 = ndim ) DEALLOCATE( ndim ) ! !-- ntime for soil ALLOCATE( ndim(1:ntimesteps) ) DO n = 1, ntimesteps ndim(n) = n ENDDO return_value = dom_def_dim( vmea(l)%nc_filename, & dimension_name = 'ntime_soil', & output_type = 'int32', & bounds = (/1_iwp,ntimesteps/), & values_int32 = ndim ) DEALLOCATE( ndim ) ! !-- time for soil variable_name = 'time_soil' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/'station_soil', & 'ntime_soil '/), & output_type = 'real32' ) ! !-- station_name for soil variable_name = 'station_name_soil' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/ 'max_name_len', & 'station_soil'/), & output_type = 'char' ) ! !-- z variable_name = 'z_soil' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/'station_soil'/), & output_type = 'real32' ) ! !-- station_h for soil variable_name = 'station_h_soil' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/'station_soil'/), & output_type = 'real32' ) ! !-- x soil variable_name = 'x_soil' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/'station_soil'/), & output_type = 'real32' ) ! !- y soil variable_name = 'y_soil' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/'station_soil'/), & output_type = 'real32' ) ! !-- E-UTM soil variable_name = 'E_UTM_soil' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/'station_soil'/), & output_type = 'real32' ) ! !-- N-UTM soil variable_name = 'N_UTM_soil' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/'station_soil'/), & output_type = 'real32' ) ! !-- latitude soil variable_name = 'lat_soil' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/'station_soil'/), & output_type = 'real32' ) ! !-- longitude soil variable_name = 'lon_soil' return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/'station_soil'/), & output_type = 'real32' ) ! !-- Set attributes for the coordinate variables. Note, not all coordinates !-- have the same number of attributes. !-- Units return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'time_soil', & attribute_name = char_unit, & value = 'seconds since ' // origin_date_time ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'z_soil', & attribute_name = char_unit, & value = 'm' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'station_h_soil', & attribute_name = char_unit, & value = 'm' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'x_soil', & attribute_name = char_unit, & value = 'm' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'y_soil', & attribute_name = char_unit, & value = 'm' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'E_UTM_soil', & attribute_name = char_unit, & value = 'm' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'N_UTM_soil', & attribute_name = char_unit, & value = 'm' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'lat_soil', & attribute_name = char_unit, & value = 'degrees_north' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'lon_soil', & attribute_name = char_unit, & value = 'degrees_east' ) ! !-- Long name return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'station_name_soil', & attribute_name = char_long, & value = 'station name') return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'time_soil', & attribute_name = char_long, & value = 'time') return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'z_soil', & attribute_name = char_long, & value = 'height above origin' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'station_h_soil', & attribute_name = char_long, & value = 'surface altitude' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'x_soil', & attribute_name = char_long, & value = 'distance to origin in x-direction' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'y_soil', & attribute_name = char_long, & value = 'distance to origin in y-direction' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'E_UTM_soil', & attribute_name = char_long, & value = 'easting' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'N_UTM_soil', & attribute_name = char_long, & value = 'northing' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'lat_soil', & attribute_name = char_long, & value = 'latitude' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'lon_soil', & attribute_name = char_long, & value = 'longitude' ) ! !-- Standard name return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'station_name_soil', & attribute_name = char_standard, & value = 'platform_name') return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'time_soil', & attribute_name = char_standard, & value = 'time') return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'z_soil', & attribute_name = char_standard, & value = 'height_above_mean_sea_level' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'station_h_soil', & attribute_name = char_standard, & value = 'surface_altitude' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'E_UTM_soil', & attribute_name = char_standard, & value = 'projection_x_coordinate' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'N_UTM_soil', & attribute_name = char_standard, & value = 'projection_y_coordinate' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'lat_soil', & attribute_name = char_standard, & value = 'latitude' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'lon_soil', & attribute_name = char_standard, & value = 'longitude' ) ! !-- Axis return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'time_soil', & attribute_name = 'axis', & value = 'T') return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'z_soil', & attribute_name = 'axis', & value = 'Z' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'x_soil', & attribute_name = 'axis', & value = 'X' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'y_soil', & attribute_name = 'axis', & value = 'Y' ) ! !-- Set further individual attributes for the coordinate variables. !-- For station name soil return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'station_name_soil', & attribute_name = 'cf_role', & value = 'timeseries_id' ) ! !-- For time soil return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'time_soil', & attribute_name = 'calendar', & value = 'proleptic_gregorian' ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'time_soil', & attribute_name = 'bounds', & value = 'time_bounds' ) ! !-- For z soil return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = 'z_soil', & attribute_name = 'positive', & value = 'up' ) ENDIF ! !-- Define variables that shall be sampled. DO n = 1, vmea(l)%nmeas variable_name = TRIM( vmea(l)%var_atts(n)%name ) ! !-- In order to link the correct dimension names, atmosphere and soil !-- variables need to be distinguished. IF ( vmea(l)%soil_sampling .AND. & ANY( TRIM( vmea(l)%var_atts(n)%name) == soil_vars ) ) THEN return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/'station_soil', & 'ntime_soil '/), & output_type = 'real32' ) ELSE return_value = dom_def_var( vmea(l)%nc_filename, & variable_name = variable_name, & dimension_names = (/'station', & 'ntime '/), & output_type = 'real32' ) ENDIF ! !-- Set variable attributes. Please note, for some variables not all !-- attributes are defined, e.g. standard_name for the horizontal wind !-- components. CALL vm_set_attributes( vmea(l)%var_atts(n) ) IF ( vmea(l)%var_atts(n)%long_name /= 'none' ) THEN return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = variable_name, & attribute_name = char_long, & value = TRIM( vmea(l)%var_atts(n)%long_name ) ) ENDIF IF ( vmea(l)%var_atts(n)%standard_name /= 'none' ) THEN return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = variable_name, & attribute_name = char_standard, & value = TRIM( vmea(l)%var_atts(n)%standard_name ) ) ENDIF IF ( vmea(l)%var_atts(n)%units /= 'none' ) THEN return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = variable_name, & attribute_name = char_unit, & value = TRIM( vmea(l)%var_atts(n)%units ) ) ENDIF return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = variable_name, & attribute_name = 'grid_mapping', & value = TRIM( vmea(l)%var_atts(n)%grid_mapping ) ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = variable_name, & attribute_name = 'coordinates', & value = TRIM( vmea(l)%var_atts(n)%coordinates ) ) return_value = dom_def_att( vmea(l)%nc_filename, & variable_name = variable_name, & attribute_name = char_fill, & value = REAL( vmea(l)%var_atts(n)%fill_value, KIND=4 ) ) ENDDO ! loop over variables per site ENDDO ! loop over sites END SUBROUTINE vm_init_output !------------------------------------------------------------------------------! ! Description: ! ------------ !> Parallel NetCDF output via data-output module. !------------------------------------------------------------------------------! SUBROUTINE vm_data_output CHARACTER(LEN=100) :: variable_name !< name of output variable INTEGER(iwp) :: l !< loop index INTEGER(iwp) :: n !< loop index INTEGER :: return_value !< returned status value of called function INTEGER(iwp) :: t_ind !< time index REAL(wp), DIMENSION(:), ALLOCATABLE :: oro_rel !< relative altitude of model surface REAL(wp), DIMENSION(:), POINTER :: output_values_1d_pointer !< pointer for 1d output array REAL(wp), DIMENSION(:), ALLOCATABLE, TARGET :: output_values_1d_target !< target for 1d output array REAL(wp), DIMENSION(:,:), POINTER :: output_values_2d_pointer !< pointer for 2d output array REAL(wp), DIMENSION(:,:), ALLOCATABLE, TARGET :: output_values_2d_target !< target for 2d output array ! !-- At the first call of this routine write the spatial coordinates. IF ( .NOT. initial_write_coordinates ) THEN ! !-- Write spatial coordinates. DO l = 1, vmea_general%nvm ! !-- Skip if no observations were taken. IF ( vmea(l)%ns_tot == 0 .AND. vmea(l)%ns_soil_tot == 0 ) CYCLE ALLOCATE( output_values_1d_target(vmea(l)%start_coord_a:vmea(l)%end_coord_a) ) ! !-- Output of Easting coordinate. Before output, recalculate EUTM. output_values_1d_target = init_model%origin_x & + REAL( vmea(l)%i(1:vmea(l)%ns) + 0.5_wp, KIND = wp ) * dx & * COS( init_model%rotation_angle * pi / 180.0_wp ) & + REAL( vmea(l)%j(1:vmea(l)%ns) + 0.5_wp, KIND = wp ) * dy & * SIN( init_model%rotation_angle * pi / 180.0_wp ) output_values_1d_pointer => output_values_1d_target return_value = & dom_write_var( vmea(l)%nc_filename, & 'E_UTM', & values_realwp_1d = output_values_1d_pointer, & bounds_start = (/vmea(l)%start_coord_a/), & bounds_end = (/vmea(l)%end_coord_a /) ) ! !-- Output of Northing coordinate. Before output, recalculate NUTM. output_values_1d_target = init_model%origin_y & - REAL( vmea(l)%i(1:vmea(l)%ns) + 0.5_wp, KIND = wp ) * dx & * SIN( init_model%rotation_angle * pi / 180.0_wp ) & + REAL( vmea(l)%j(1:vmea(l)%ns) + 0.5_wp, KIND = wp ) * dy & * COS( init_model%rotation_angle * pi / 180.0_wp ) output_values_1d_pointer => output_values_1d_target return_value = & dom_write_var( vmea(l)%nc_filename, & 'N_UTM', & values_realwp_1d = output_values_1d_pointer, & bounds_start = (/vmea(l)%start_coord_a/), & bounds_end = (/vmea(l)%end_coord_a /) ) ! !-- Output of relative height coordinate. !-- Before this is output, first define the relative orographie height !-- and add this to z. ALLOCATE( oro_rel(1:vmea(l)%ns) ) DO n = 1, vmea(l)%ns oro_rel(n) = zw(topo_top_ind(vmea(l)%j(n),vmea(l)%i(n),3)) ENDDO output_values_1d_target = vmea(l)%zar(1:vmea(l)%ns) + oro_rel(:) output_values_1d_pointer => output_values_1d_target return_value = & dom_write_var( vmea(l)%nc_filename, & 'z', & values_realwp_1d = output_values_1d_pointer, & bounds_start = (/vmea(l)%start_coord_a/), & bounds_end = (/vmea(l)%end_coord_a /) ) ! !-- Write surface altitude for the station. Note, since z is already !-- a relative observation height, station_h must be zero, in order !-- to obtain the observation level. output_values_1d_target = oro_rel(:) output_values_1d_pointer => output_values_1d_target return_value = & dom_write_var( vmea(l)%nc_filename, & 'station_h', & values_realwp_1d = output_values_1d_pointer, & bounds_start = (/vmea(l)%start_coord_a/), & bounds_end = (/vmea(l)%end_coord_a /) ) DEALLOCATE( oro_rel ) DEALLOCATE( output_values_1d_target ) ! !-- In case of sampled soil quantities, output also the respective !-- coordinate arrays. IF ( vmea(l)%soil_sampling ) THEN ALLOCATE( output_values_1d_target(vmea(l)%start_coord_s:vmea(l)%end_coord_s) ) ! !-- Output of Easting coordinate. Before output, recalculate EUTM. output_values_1d_target = init_model%origin_x & + REAL( vmea(l)%i(1:vmea(l)%ns_soil) + 0.5_wp, KIND = wp ) * dx & * COS( init_model%rotation_angle * pi / 180.0_wp ) & + REAL( vmea(l)%j(1:vmea(l)%ns_soil) + 0.5_wp, KIND = wp ) * dy & * SIN( init_model%rotation_angle * pi / 180.0_wp ) output_values_1d_pointer => output_values_1d_target return_value = & dom_write_var( vmea(l)%nc_filename, & 'E_UTM_soil', & values_realwp_1d = output_values_1d_pointer, & bounds_start = (/vmea(l)%start_coord_s/), & bounds_end = (/vmea(l)%end_coord_s /) ) ! !-- Output of Northing coordinate. Before output, recalculate NUTM. output_values_1d_target = init_model%origin_y & - REAL( vmea(l)%i(1:vmea(l)%ns_soil) + 0.5_wp, KIND = wp ) * dx & * SIN( init_model%rotation_angle * pi / 180.0_wp ) & + REAL( vmea(l)%j(1:vmea(l)%ns_soil) + 0.5_wp, KIND = wp ) * dy & * COS( init_model%rotation_angle * pi / 180.0_wp ) output_values_1d_pointer => output_values_1d_target return_value = & dom_write_var( vmea(l)%nc_filename, & 'N_UTM_soil', & values_realwp_1d = output_values_1d_pointer, & bounds_start = (/vmea(l)%start_coord_s/), & bounds_end = (/vmea(l)%end_coord_s /) ) ! !-- Output of relative height coordinate. !-- Before this is output, first define the relative orographie height !-- and add this to z. ALLOCATE( oro_rel(1:vmea(l)%ns_soil) ) DO n = 1, vmea(l)%ns_soil oro_rel(n) = zw(topo_top_ind(vmea(l)%j_soil(n),vmea(l)%i_soil(n),3)) ENDDO output_values_1d_target = vmea(l)%depth(1:vmea(l)%ns_soil) + oro_rel(:) output_values_1d_pointer => output_values_1d_target return_value = & dom_write_var( vmea(l)%nc_filename, & 'z_soil', & values_realwp_1d = output_values_1d_pointer, & bounds_start = (/vmea(l)%start_coord_s/), & bounds_end = (/vmea(l)%end_coord_s /) ) ! !-- Write surface altitude for the station. Note, since z is already !-- a relative observation height, station_h must be zero, in order !-- to obtain the observation level. output_values_1d_target = oro_rel(:) output_values_1d_pointer => output_values_1d_target return_value = & dom_write_var( vmea(l)%nc_filename, & 'station_h_soil', & values_realwp_1d = output_values_1d_pointer, & bounds_start = (/vmea(l)%start_coord_s/), & bounds_end = (/vmea(l)%end_coord_s /) ) DEALLOCATE( oro_rel ) DEALLOCATE( output_values_1d_target ) ! !-- Write the stations name ENDIF ENDDO ! loop over sites initial_write_coordinates = .TRUE. ENDIF ! !-- Loop over all sites. DO l = 1, vmea_general%nvm ! !-- Skip if no observations were taken. IF ( vmea(l)%ns_tot == 0 .AND. vmea(l)%ns_soil_tot == 0 ) CYCLE ! !-- Determine time index in file. t_ind = vmea(l)%file_time_index + 1 ! !-- Write output variables. Distinguish between atmosphere and soil variables. DO n = 1, vmea(l)%nmeas IF ( vmea(l)%soil_sampling .AND. & ANY( TRIM( vmea(l)%var_atts(n)%name) == soil_vars ) ) THEN ! !-- Write time coordinate to file variable_name = 'time_soil' ALLOCATE( output_values_2d_target(t_ind:t_ind,vmea(l)%start_coord_s:vmea(l)%end_coord_s) ) output_values_2d_target(t_ind,:) = time_since_reference_point output_values_2d_pointer => output_values_2d_target return_value = dom_write_var( vmea(l)%nc_filename, & variable_name, & values_realwp_2d = output_values_2d_pointer, & bounds_start = (/vmea(l)%start_coord_s, t_ind/), & bounds_end = (/vmea(l)%end_coord_s, t_ind /) ) variable_name = TRIM( vmea(l)%var_atts(n)%name ) output_values_2d_target(t_ind,:) = vmea(l)%measured_vars_soil(:,n) output_values_2d_pointer => output_values_2d_target return_value = & dom_write_var( vmea(l)%nc_filename, & variable_name, & values_realwp_2d = output_values_2d_pointer, & bounds_start = (/vmea(l)%start_coord_s, t_ind/), & bounds_end = (/vmea(l)%end_coord_s, t_ind /) ) DEALLOCATE( output_values_2d_target ) ELSE ! !-- Write time coordinate to file variable_name = 'time' ALLOCATE( output_values_2d_target(t_ind:t_ind,vmea(l)%start_coord_a:vmea(l)%end_coord_a) ) output_values_2d_target(t_ind,:) = time_since_reference_point output_values_2d_pointer => output_values_2d_target return_value = dom_write_var( vmea(l)%nc_filename, & variable_name, & values_realwp_2d = output_values_2d_pointer, & bounds_start = (/vmea(l)%start_coord_a, t_ind/), & bounds_end = (/vmea(l)%end_coord_a, t_ind/) ) variable_name = TRIM( vmea(l)%var_atts(n)%name ) output_values_2d_target(t_ind,:) = vmea(l)%measured_vars(:,n) output_values_2d_pointer => output_values_2d_target return_value = & dom_write_var( vmea(l)%nc_filename, & variable_name, & values_realwp_2d = output_values_2d_pointer, & bounds_start = (/ vmea(l)%start_coord_a, t_ind /), & bounds_end = (/ vmea(l)%end_coord_a, t_ind /) ) DEALLOCATE( output_values_2d_target ) ENDIF ENDDO ! !-- Update number of written time indices vmea(l)%file_time_index = t_ind ENDDO ! loop over sites END SUBROUTINE vm_data_output !------------------------------------------------------------------------------! ! Description: ! ------------ !> Sampling of the actual quantities along the observation coordinates !------------------------------------------------------------------------------! SUBROUTINE vm_sampling USE radiation_model_mod, & ONLY: radiation USE surface_mod, & ONLY: surf_def_h, & surf_lsm_h, & surf_usm_h INTEGER(iwp) :: i !< grid index in x-direction INTEGER(iwp) :: j !< grid index in y-direction INTEGER(iwp) :: k !< grid index in z-direction INTEGER(iwp) :: ind_chem !< dummy index to identify chemistry variable and translate it from (UC)2 standard to interal naming INTEGER(iwp) :: l !< running index over the number of stations INTEGER(iwp) :: m !< running index over all virtual observation coordinates INTEGER(iwp) :: mm !< index of surface element which corresponds to the virtual observation coordinate INTEGER(iwp) :: n !< running index over all measured variables at a station INTEGER(iwp) :: nn !< running index over the number of chemcal species LOGICAL :: match_lsm !< flag indicating natural-type surface LOGICAL :: match_usm !< flag indicating urban-type surface REAL(wp) :: e_s !< saturation water vapor pressure REAL(wp) :: q_s !< saturation mixing ratio REAL(wp) :: q_wv !< mixing ratio ! !-- Loop over all sites. DO l = 1, vmea_general%nvm ! !-- At the beginning, set _FillValues IF ( ALLOCATED( vmea(l)%measured_vars ) ) & vmea(l)%measured_vars = vmea(l)%fillout IF ( ALLOCATED( vmea(l)%measured_vars_soil ) ) & vmea(l)%measured_vars_soil = vmea(l)%fillout ! !-- Loop over all variables measured at this site. DO n = 1, vmea(l)%nmeas SELECT CASE ( TRIM( vmea(l)%var_atts(n)%name ) ) CASE ( 'theta' ) ! potential temperature IF ( .NOT. neutral ) THEN DO m = 1, vmea(l)%ns k = vmea(l)%k(m) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = pt(k,j,i) ENDDO ENDIF CASE ( 'ta' ) ! absolute temperature IF ( .NOT. neutral ) THEN DO m = 1, vmea(l)%ns k = vmea(l)%k(m) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = pt(k,j,i) * exner( k ) & - degc_to_k ENDDO ENDIF CASE ( 't_va' ) CASE ( 'hus' ) ! mixing ratio IF ( humidity ) THEN DO m = 1, vmea(l)%ns k = vmea(l)%k(m) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = q(k,j,i) ENDDO ENDIF CASE ( 'haa' ) ! absolute humidity IF ( humidity ) THEN DO m = 1, vmea(l)%ns k = vmea(l)%k(m) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = ( q(k,j,i) & / ( 1.0_wp - q(k,j,i) ) ) & * rho_air(k) ENDDO ENDIF CASE ( 'pwv' ) ! water vapor partial pressure IF ( humidity ) THEN ! DO m = 1, vmea(l)%ns ! k = vmea(l)%k(m) ! j = vmea(l)%j(m) ! i = vmea(l)%i(m) ! vmea(l)%measured_vars(m,n) = ( q(k,j,i) & ! / ( 1.0_wp - q(k,j,i) ) ) & ! * rho_air(k) ! ENDDO ENDIF CASE ( 'hur' ) ! relative humidity IF ( humidity ) THEN DO m = 1, vmea(l)%ns k = vmea(l)%k(m) j = vmea(l)%j(m) i = vmea(l)%i(m) ! !-- Calculate actual temperature, water vapor saturation !-- pressure, and based on this the saturation mixing ratio. e_s = magnus( exner(k) * pt(k,j,i) ) q_s = rd_d_rv * e_s / ( hyp(k) - e_s ) q_wv = ( q(k,j,i) / ( 1.0_wp - q(k,j,i) ) ) * rho_air(k) vmea(l)%measured_vars(m,n) = q_wv / ( q_s + 1E-10_wp ) ENDDO ENDIF CASE ( 'u', 'ua' ) ! u-component DO m = 1, vmea(l)%ns k = vmea(l)%k(m) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = 0.5_wp * ( u(k,j,i) + u(k,j,i+1) ) ENDDO CASE ( 'v', 'va' ) ! v-component DO m = 1, vmea(l)%ns k = vmea(l)%k(m) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = 0.5_wp * ( v(k,j,i) + v(k,j+1,i) ) ENDDO CASE ( 'w' ) ! w-component DO m = 1, vmea(l)%ns k = MAX ( 1, vmea(l)%k(m) ) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = 0.5_wp * ( w(k,j,i) + w(k-1,j,i) ) ENDDO CASE ( 'wspeed' ) ! horizontal wind speed DO m = 1, vmea(l)%ns k = vmea(l)%k(m) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = SQRT( & ( 0.5_wp * ( u(k,j,i) + u(k,j,i+1) ) )**2 + & ( 0.5_wp * ( v(k,j,i) + v(k,j+1,i) ) )**2 & ) ENDDO CASE ( 'wdir' ) ! wind direction DO m = 1, vmea(l)%ns k = vmea(l)%k(m) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = 180.0_wp + 180.0_wp / pi & * ATAN2( & 0.5_wp * ( v(k,j,i) + v(k,j+1,i) ), & 0.5_wp * ( u(k,j,i) + u(k,j,i+1) ) & ) ENDDO CASE ( 'utheta' ) DO m = 1, vmea(l)%ns k = vmea(l)%k(m) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = 0.5_wp * & ( u(k,j,i) + u(k,j,i+1) ) * & pt(k,j,i) ENDDO CASE ( 'vtheta' ) DO m = 1, vmea(l)%ns k = vmea(l)%k(m) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = 0.5_wp * & ( v(k,j,i) + v(k,j+1,i) ) * & pt(k,j,i) ENDDO CASE ( 'wtheta' ) DO m = 1, vmea(l)%ns k = MAX ( 1, vmea(l)%k(m) ) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = 0.5_wp * & ( w(k-1,j,i) + w(k,j,i) ) * & pt(k,j,i) ENDDO CASE ( 'uqv' ) IF ( humidity ) THEN DO m = 1, vmea(l)%ns k = vmea(l)%k(m) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = 0.5_wp * & ( u(k,j,i) + u(k,j,i+1) ) *& q(k,j,i) ENDDO ENDIF CASE ( 'vqv' ) IF ( humidity ) THEN DO m = 1, vmea(l)%ns k = vmea(l)%k(m) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = 0.5_wp * & ( v(k,j,i) + v(k,j+1,i) ) *& q(k,j,i) ENDDO ENDIF CASE ( 'wqv' ) IF ( humidity ) THEN DO m = 1, vmea(l)%ns k = MAX ( 1, vmea(l)%k(m) ) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = 0.5_wp * & ( w(k-1,j,i) + w(k,j,i) ) *& q(k,j,i) ENDDO ENDIF CASE ( 'uw' ) DO m = 1, vmea(l)%ns k = MAX ( 1, vmea(l)%k(m) ) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = 0.25_wp * & ( w(k-1,j,i) + w(k,j,i) ) * & ( u(k,j,i) + u(k,j,i+1) ) ENDDO CASE ( 'vw' ) DO m = 1, vmea(l)%ns k = MAX ( 1, vmea(l)%k(m) ) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = 0.25_wp * & ( w(k-1,j,i) + w(k,j,i) ) * & ( v(k,j,i) + v(k,j+1,i) ) ENDDO CASE ( 'uv' ) DO m = 1, vmea(l)%ns k = vmea(l)%k(m) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = 0.25_wp * & ( u(k,j,i) + u(k,j,i+1) ) * & ( v(k,j,i) + v(k,j+1,i) ) ENDDO ! !-- Chemistry variables. List of variables may need extension. !-- Note, gas species in PALM are in ppm and no distinction is made !-- between mole-fraction and concentration quantities (all are !-- output in ppm so far). CASE ( 'mcpm1', 'mcpm2p5', 'mcpm10', 'mfno', 'mfno2', & 'mcno', 'mcno2', 'tro3' ) IF ( air_chemistry ) THEN ! !-- First, search for the measured variable in the chem_vars !-- list, in order to get the internal name of the variable. DO nn = 1, UBOUND( chem_vars, 2 ) IF ( TRIM( vmea(l)%var_atts(n)%name ) == & TRIM( chem_vars(0,nn) ) ) ind_chem = nn ENDDO ! !-- Run loop over all chemical species, if the measured !-- variable matches the interal name, sample the variable. !-- Note, nvar as a chemistry-module variable. DO nn = 1, nvar IF ( TRIM( chem_vars(1,ind_chem) ) == & TRIM( chem_species(nn)%name ) ) THEN DO m = 1, vmea(l)%ns k = vmea(l)%k(m) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = & chem_species(nn)%conc(k,j,i) ENDDO ENDIF ENDDO ENDIF CASE ( 'us' ) ! friction velocity DO m = 1, vmea(l)%ns ! !-- Surface data is only available on inner subdomains, not !-- on ghost points. Hence, limit the indices. j = MERGE( vmea(l)%j(m), nys, vmea(l)%j(m) > nys ) j = MERGE( j , nyn, j < nyn ) i = MERGE( vmea(l)%i(m), nxl, vmea(l)%i(m) > nxl ) i = MERGE( i , nxr, i < nxr ) DO mm = surf_def_h(0)%start_index(j,i), & surf_def_h(0)%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_def_h(0)%us(mm) ENDDO DO mm = surf_lsm_h%start_index(j,i), & surf_lsm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_lsm_h%us(mm) ENDDO DO mm = surf_usm_h%start_index(j,i), & surf_usm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_usm_h%us(mm) ENDDO ENDDO CASE ( 'thetas' ) ! scaling parameter temperature DO m = 1, vmea(l)%ns ! !-- Surface data is only available on inner subdomains, not !-- on ghost points. Hence, limit the indices. j = MERGE( vmea(l)%j(m), nys, vmea(l)%j(m) > nys ) j = MERGE( j , nyn, j < nyn ) i = MERGE( vmea(l)%i(m), nxl, vmea(l)%i(m) > nxl ) i = MERGE( i , nxr, i < nxr ) DO mm = surf_def_h(0)%start_index(j,i), & surf_def_h(0)%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_def_h(0)%ts(mm) ENDDO DO mm = surf_lsm_h%start_index(j,i), & surf_lsm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_lsm_h%ts(mm) ENDDO DO mm = surf_usm_h%start_index(j,i), & surf_usm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_usm_h%ts(mm) ENDDO ENDDO CASE ( 'hfls' ) ! surface latent heat flux DO m = 1, vmea(l)%ns ! !-- Surface data is only available on inner subdomains, not !-- on ghost points. Hence, limit the indices. j = MERGE( vmea(l)%j(m), nys, vmea(l)%j(m) > nys ) j = MERGE( j , nyn, j < nyn ) i = MERGE( vmea(l)%i(m), nxl, vmea(l)%i(m) > nxl ) i = MERGE( i , nxr, i < nxr ) DO mm = surf_def_h(0)%start_index(j,i), & surf_def_h(0)%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_def_h(0)%qsws(mm) ENDDO DO mm = surf_lsm_h%start_index(j,i), & surf_lsm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_lsm_h%qsws(mm) ENDDO DO mm = surf_usm_h%start_index(j,i), & surf_usm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_usm_h%qsws(mm) ENDDO ENDDO CASE ( 'hfss' ) ! surface sensible heat flux DO m = 1, vmea(l)%ns ! !-- Surface data is only available on inner subdomains, not !-- on ghost points. Hence, limit the indices. j = MERGE( vmea(l)%j(m), nys, vmea(l)%j(m) > nys ) j = MERGE( j , nyn, j < nyn ) i = MERGE( vmea(l)%i(m), nxl, vmea(l)%i(m) > nxl ) i = MERGE( i , nxr, i < nxr ) DO mm = surf_def_h(0)%start_index(j,i), & surf_def_h(0)%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_def_h(0)%shf(mm) ENDDO DO mm = surf_lsm_h%start_index(j,i), & surf_lsm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_lsm_h%shf(mm) ENDDO DO mm = surf_usm_h%start_index(j,i), & surf_usm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_usm_h%shf(mm) ENDDO ENDDO CASE ( 'hfdg' ) ! ground heat flux DO m = 1, vmea(l)%ns ! !-- Surface data is only available on inner subdomains, not !-- on ghost points. Hence, limit the indices. j = MERGE( vmea(l)%j(m), nys, vmea(l)%j(m) > nys ) j = MERGE( j , nyn, j < nyn ) i = MERGE( vmea(l)%i(m), nxl, vmea(l)%i(m) > nxl ) i = MERGE( i , nxr, i < nxr ) DO mm = surf_lsm_h%start_index(j,i), & surf_lsm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_lsm_h%ghf(mm) ENDDO ENDDO CASE ( 'lwcs' ) ! liquid water of soil layer ! DO m = 1, vmea(l)%ns ! ! ! !-- Surface data is only available on inner subdomains, not ! !-- on ghost points. Hence, limit the indices. ! j = MERGE( vmea(l)%j(m), nys, vmea(l)%j(m) > nys ) ! j = MERGE( j , nyn, j < nyn ) ! i = MERGE( vmea(l)%i(m), nxl, vmea(l)%i(m) > nxl ) ! i = MERGE( i , nxr, i < nxr ) ! ! DO mm = surf_lsm_h%start_index(j,i), & ! surf_lsm_h%end_index(j,i) ! vmea(l)%measured_vars(m,n) = ? ! ENDDO ! ENDDO CASE ( 'rnds' ) ! surface net radiation IF ( radiation ) THEN DO m = 1, vmea(l)%ns ! !-- Surface data is only available on inner subdomains, not !-- on ghost points. Hence, limit the indices. j = MERGE( vmea(l)%j(m), nys, vmea(l)%j(m) > nys ) j = MERGE( j , nyn, j < nyn ) i = MERGE( vmea(l)%i(m), nxl, vmea(l)%i(m) > nxl ) i = MERGE( i , nxr, i < nxr ) DO mm = surf_lsm_h%start_index(j,i), & surf_lsm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_lsm_h%rad_net(mm) ENDDO DO mm = surf_usm_h%start_index(j,i), & surf_usm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_usm_h%rad_net(mm) ENDDO ENDDO ENDIF CASE ( 'rsus' ) ! surface shortwave out IF ( radiation ) THEN DO m = 1, vmea(l)%ns ! !-- Surface data is only available on inner subdomains, not !-- on ghost points. Hence, limit the indices. j = MERGE( vmea(l)%j(m), nys, vmea(l)%j(m) > nys ) j = MERGE( j , nyn, j < nyn ) i = MERGE( vmea(l)%i(m), nxl, vmea(l)%i(m) > nxl ) i = MERGE( i , nxr, i < nxr ) DO mm = surf_lsm_h%start_index(j,i), & surf_lsm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_lsm_h%rad_sw_out(mm) ENDDO DO mm = surf_usm_h%start_index(j,i), & surf_usm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_usm_h%rad_sw_out(mm) ENDDO ENDDO ENDIF CASE ( 'rsds' ) ! surface shortwave in IF ( radiation ) THEN DO m = 1, vmea(l)%ns ! !-- Surface data is only available on inner subdomains, not !-- on ghost points. Hence, limit the indices. j = MERGE( vmea(l)%j(m), nys, vmea(l)%j(m) > nys ) j = MERGE( j , nyn, j < nyn ) i = MERGE( vmea(l)%i(m), nxl, vmea(l)%i(m) > nxl ) i = MERGE( i , nxr, i < nxr ) DO mm = surf_lsm_h%start_index(j,i), & surf_lsm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_lsm_h%rad_sw_in(mm) ENDDO DO mm = surf_usm_h%start_index(j,i), & surf_usm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_usm_h%rad_sw_in(mm) ENDDO ENDDO ENDIF CASE ( 'rlus' ) ! surface longwave out IF ( radiation ) THEN DO m = 1, vmea(l)%ns ! !-- Surface data is only available on inner subdomains, not !-- on ghost points. Hence, limit the indices. j = MERGE( vmea(l)%j(m), nys, vmea(l)%j(m) > nys ) j = MERGE( j , nyn, j < nyn ) i = MERGE( vmea(l)%i(m), nxl, vmea(l)%i(m) > nxl ) i = MERGE( i , nxr, i < nxr ) DO mm = surf_lsm_h%start_index(j,i), & surf_lsm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_lsm_h%rad_lw_out(mm) ENDDO DO mm = surf_usm_h%start_index(j,i), & surf_usm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_usm_h%rad_lw_out(mm) ENDDO ENDDO ENDIF CASE ( 'rlds' ) ! surface longwave in IF ( radiation ) THEN DO m = 1, vmea(l)%ns ! !-- Surface data is only available on inner subdomains, not !-- on ghost points. Hence, limit the indices. j = MERGE( vmea(l)%j(m), nys, vmea(l)%j(m) > nys ) j = MERGE( j , nyn, j < nyn ) i = MERGE( vmea(l)%i(m), nxl, vmea(l)%i(m) > nxl ) i = MERGE( i , nxr, i < nxr ) DO mm = surf_lsm_h%start_index(j,i), & surf_lsm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_lsm_h%rad_lw_in(mm) ENDDO DO mm = surf_usm_h%start_index(j,i), & surf_usm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_usm_h%rad_lw_in(mm) ENDDO ENDDO ENDIF CASE ( 'rsd' ) ! shortwave in IF ( radiation ) THEN IF ( radiation_scheme /= 'rrtmg' ) THEN DO m = 1, vmea(l)%ns k = 0 j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = rad_sw_in(k,j,i) ENDDO ELSE DO m = 1, vmea(l)%ns k = vmea(l)%k(m) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = rad_sw_in(k,j,i) ENDDO ENDIF ENDIF CASE ( 'rsu' ) ! shortwave out IF ( radiation ) THEN IF ( radiation_scheme /= 'rrtmg' ) THEN DO m = 1, vmea(l)%ns k = 0 j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = rad_sw_out(k,j,i) ENDDO ELSE DO m = 1, vmea(l)%ns k = vmea(l)%k(m) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = rad_sw_out(k,j,i) ENDDO ENDIF ENDIF CASE ( 'rlu' ) ! longwave out IF ( radiation ) THEN IF ( radiation_scheme /= 'rrtmg' ) THEN DO m = 1, vmea(l)%ns k = 0 j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = rad_lw_out(k,j,i) ENDDO ELSE DO m = 1, vmea(l)%ns k = vmea(l)%k(m) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = rad_lw_out(k,j,i) ENDDO ENDIF ENDIF CASE ( 'rld' ) ! longwave in IF ( radiation ) THEN IF ( radiation_scheme /= 'rrtmg' ) THEN DO m = 1, vmea(l)%ns k = 0 ! !-- Surface data is only available on inner subdomains, !-- not on ghost points. Hence, limit the indices. j = MERGE( vmea(l)%j(m), nys, vmea(l)%j(m) > nys ) j = MERGE( j , nyn, j < nyn ) i = MERGE( vmea(l)%i(m), nxl, vmea(l)%i(m) > nxl ) i = MERGE( i , nxr, i < nxr ) vmea(l)%measured_vars(m,n) = rad_lw_in(k,j,i) ENDDO ELSE DO m = 1, vmea(l)%ns k = vmea(l)%k(m) j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = rad_lw_in(k,j,i) ENDDO ENDIF ENDIF CASE ( 'rsddif' ) ! shortwave in, diffuse part IF ( radiation ) THEN DO m = 1, vmea(l)%ns j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = rad_sw_in_diff(j,i) ENDDO ENDIF CASE ( 't_soil' ) ! soil and wall temperature DO m = 1, vmea(l)%ns_soil j = MERGE( vmea(l)%j_soil(m), nys, vmea(l)%j_soil(m) > nys ) j = MERGE( j , nyn, j < nyn ) i = MERGE( vmea(l)%i_soil(m), nxl, vmea(l)%i_soil(m) > nxl ) i = MERGE( i , nxr, i < nxr ) k = vmea(l)%k_soil(m) match_lsm = surf_lsm_h%start_index(j,i) <= & surf_lsm_h%end_index(j,i) match_usm = surf_usm_h%start_index(j,i) <= & surf_usm_h%end_index(j,i) IF ( match_lsm ) THEN mm = surf_lsm_h%start_index(j,i) vmea(l)%measured_vars_soil(m,n) = t_soil_h%var_2d(k,mm) ENDIF IF ( match_usm ) THEN mm = surf_usm_h%start_index(j,i) vmea(l)%measured_vars_soil(m,n) = t_wall_h(k,mm) ENDIF ENDDO CASE ( 'm_soil' ) ! soil moisture DO m = 1, vmea(l)%ns_soil j = MERGE( vmea(l)%j_soil(m), nys, vmea(l)%j_soil(m) > nys ) j = MERGE( j , nyn, j < nyn ) i = MERGE( vmea(l)%i_soil(m), nxl, vmea(l)%i_soil(m) > nxl ) i = MERGE( i , nxr, i < nxr ) k = vmea(l)%k_soil(m) match_lsm = surf_lsm_h%start_index(j,i) <= & surf_lsm_h%end_index(j,i) IF ( match_lsm ) THEN mm = surf_lsm_h%start_index(j,i) vmea(l)%measured_vars_soil(m,n) = m_soil_h%var_2d(k,mm) ENDIF ENDDO CASE ( 'ts' ) ! surface temperature DO m = 1, vmea(l)%ns ! !-- Surface data is only available on inner subdomains, not !-- on ghost points. Hence, limit the indices. j = MERGE( vmea(l)%j(m), nys, vmea(l)%j(m) > nys ) j = MERGE( j , nyn, j < nyn ) i = MERGE( vmea(l)%i(m), nxl, vmea(l)%i(m) > nxl ) i = MERGE( i , nxr, i < nxr ) DO mm = surf_def_h(0)%start_index(j,i), & surf_def_h(0)%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_def_h(0)%pt_surface(mm) ENDDO DO mm = surf_lsm_h%start_index(j,i), & surf_lsm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_lsm_h%pt_surface(mm) ENDDO DO mm = surf_usm_h%start_index(j,i), & surf_usm_h%end_index(j,i) vmea(l)%measured_vars(m,n) = surf_usm_h%pt_surface(mm) ENDDO ENDDO CASE ( 'lwp' ) ! liquid water path IF ( ASSOCIATED( ql ) ) THEN DO m = 1, vmea(l)%ns j = vmea(l)%j(m) i = vmea(l)%i(m) vmea(l)%measured_vars(m,n) = SUM( ql(nzb:nzt,j,i) & * dzw(1:nzt+1) ) & * rho_surface ENDDO ENDIF CASE ( 'ps' ) ! surface pressure vmea(l)%measured_vars(:,n) = surface_pressure CASE ( 'pswrtg' ) ! platform speed above ground vmea(l)%measured_vars(:,n) = 0.0_wp CASE ( 'pswrta' ) ! platform speed in air vmea(l)%measured_vars(:,n) = 0.0_wp CASE ( 't_lw' ) ! water temperature DO m = 1, vmea(l)%ns ! !-- Surface data is only available on inner subdomains, not !-- on ghost points. Hence, limit the indices. j = MERGE( vmea(l)%j(m), nys, vmea(l)%j(m) > nys ) j = MERGE( j , nyn, j < nyn ) i = MERGE( vmea(l)%i(m), nxl, vmea(l)%i(m) > nxl ) i = MERGE( i , nxr, i < nxr ) DO mm = surf_lsm_h%start_index(j,i), & surf_lsm_h%end_index(j,i) IF ( surf_lsm_h%water_surface(m) ) & vmea(l)%measured_vars(m,n) = t_soil_h%var_2d(nzt,m) ENDDO ENDDO ! !-- More will follow ... ! !-- No match found - just set a fill value CASE DEFAULT vmea(l)%measured_vars(:,n) = vmea(l)%fillout END SELECT ENDDO ENDDO END SUBROUTINE vm_sampling END MODULE virtual_measurement_mod