Changes between Version 9 and Version 10 of doc/app/salsa_parameters

Timestamp:

Aug 13, 2019 1:54:17 PM (5 years ago)

Author:

monakurppa

Comment:

Updates mainly on the emission modes.

doc/app/salsa_parameters

@@ -38 +38 @@
 }}}
 {{{#!td
-The number geometric mean diameter per aerosol mode (in m) for the aerosol emission. A total of 7 different aerosol modes can be applied.  Example modes: nucleation, Aitken, accumulation and coarse mode. 
-
-If [#salsa_emission_mode salsa_emission_mode]= 'uniform', the aerosol number emission is described by input parameters '''aerosol_flux_dpg''', [#aerosol_flux_sigmag aerosol_flux_sigmag], [#aerosol_flux_mass_fracs_a aerosol_flux_mass_fracs_a] and [#surface_aerosol_flux surface_aerosol_flux].
+The number geometric mean diameter per aerosol mode (in m) for the aerosol emission. A total of 7 different aerosol modes can be applied. Example aerosol modes: nucleation, Aitken, accumulation and coarse mode. 
+
+Used to construct the aerosol emissions if horizontally uniform ([#salsa_emission_mode salsa_emission_mode] = '' 'uniform' '') or parameterized ([#salsa_emission_mode salsa_emission_mode] = '' 'parameterized' '') aerosol emissions are applied.
+
+Then the aerosol number emission is described by input parameters '''aerosol_flux_dpg''', [#aerosol_flux_sigmag aerosol_flux_sigmag], [#aerosol_flux_mass_fracs_a aerosol_flux_mass_fracs_a] and [#surface_aerosol_flux surface_aerosol_flux].
 }}}
 |----------------
@@ -53 +55 @@
 }}}
 {{{#!td
-Mass fractions of soluble chemical components (subrange 2a) for the horizontally homogeneous aerosol emission. 
-
-Given in the same order as the list of activated aerosol chemical components [#listspec listspec].
-
-If [#salsa_emission_mode salsa_emission_mode]= 'uniform', the aerosol number emission is described by input parameters '''aerosol_flux_dpg''', [#aerosol_flux_sigmag aerosol_flux_sigmag], [#aerosol_flux_mass_fracs_a aerosol_flux_mass_fracs_a] and [#surface_aerosol_flux surface_aerosol_flux].
+Mass fractions of soluble chemical components (subrange 2a) for the horizontally homogeneous aerosol emission ([#salsa_emission_mode salsa_emission_mode] = '' 'uniform' ''). 
+
+Given in the same order as the list of activated aerosol chemical components [#listspec listspec]. E.g. 
+
+  ''listspec'' = 'OC','NH','BC',' ',' ',' ',' ', 
+
+  ''aerosol_flux_mass_fracs_a'' = 0.3, 0.1, 0.6, 0., 0., 0., 0.,
+
+implies that the mass composition of the aerosol emission is 30% organic carbon, 10% ammonia and 60% black carbon.
+
+Used to construct the aerosol emissions if horizontally uniform ([#salsa_emission_mode salsa_emission_mode] = '' 'uniform' '') or parameterized ([#salsa_emission_mode salsa_emission_mode] = '' 'parameterized' '') aerosol emissions are applied.
+
+Then the aerosol number emission is described by input parameters [#aerosol_flux_dpg aerosol_flux_dpg],  [#aerosol_flux_sigmag aerosol_flux_sigmag], '''aerosol_flux_mass_fracs_a''' and [#surface_aerosol_flux surface_aerosol_flux].
 }}}
 |----------------
@@ -70 +80 @@
 }}}
 {{{#!td
-The standard deviation of the log-normal aerosol number size distribution per aerosol mode for the aerosol emission. A total of 7 different aerosol modes can be applied.  Example modes: nucleation, Aitken, accumulation and coarse mode. 
-
-If [#salsa_emission_mode salsa_emission_mode]= 'uniform', the aerosol number emission is described by input parameters '''aerosol_flux_dpg''', [#aerosol_flux_sigmag aerosol_flux_sigmag], [#aerosol_flux_mass_fracs_a aerosol_flux_mass_fracs_a] and [#surface_aerosol_flux surface_aerosol_flux].
+The standard deviation of the log-normal aerosol number size distribution per aerosol mode for the aerosol emission. A total of 7 different aerosol modes can be applied.  Example aerosol modes: nucleation, Aitken, accumulation and coarse mode. 
+
+Used to construct the aerosol emissions if horizontally uniform ([#salsa_emission_mode salsa_emission_mode] = '' 'uniform' '') or parameterized ([#salsa_emission_mode salsa_emission_mode] = '' 'parameterized' '') aerosol emissions are applied.
+
+Then the aerosol number emission is described by input parameters [#aerosol_flux_dpg aerosol_flux_dpg],  '''aerosol_flux_sigmag''', [#aerosol_flux_mass_fracs_a aerosol_flux_mass_fracs_a] and [#surface_aerosol_flux surface_aerosol_flux].
 }}}
 |----------------
@@ -85 +97 @@
 }}}
 {{{#!td
-The bottom boundary condition of the aerosol (and gas) concentrations. 
+The bottom boundary condition of the aerosol concentrations. The same condition applies also for gases if the [wiki:doc/tec/chem chemistry module] is not applied. 
 
 Allowed are the values '' 'dirichlet' '' (constant surface concentration over the entire simulation) and 'neumann' (zero concentration gradient).
 
-If the aerosol (ans gaseous) emissions are defined as surface fluxes, '''bc_salsa_b''' = '' 'neumann' '' is required.
+If any surface emissions of aerosols and gases are applied (see [#salsa_emission_mode salsa_emission_mode]), '''bc_salsa_b''' = '' 'neumann' '' is required.
 }}}
 |----------------
@@ -117 +129 @@
 }}}
 {{{#!td
-Parameter to the switch on the decycling of aerosol particles along x. The switch applies also for gaseous compounds (H2SO4, HNO3, NH3, OCNV and OCSV) if the chemistry model is not applied. 
+Parameter to the switch on the decycling of aerosol particles along ''x''-axis. The switch applies also for gaseous compounds (H2SO4, HNO3, NH3, OCNV and OCSV) if the [wiki:doc/tec/chem chemistry module] is not applied. 
 
 The decycling method per each lateral boundary is set by [#decycle_method_salsa decycle_method_salsa].
@@ -134 +146 @@
 The decycling method at lateral boundaries, in the following order: left, right, south, north.
 
-If '''decycle_method_salsa''' = 'dirichlet', the initial aerosol (and gas) concentrations are used as fixed boundary conditions. 
-
-If '''decycle_method_salsa''' = 'neumann', a zero concentration gradient is set at the boundary.
+Decycling of aerosol and gas concentrations is useful, for example, if cyclic boundary conditions are applied and there are some pollutant emissions in the simulation domain. Without decycling, pollutants would keep accumulating into the simulation domain. 
+
+If '''decycle_method_salsa''' = '' 'dirichlet' '', the initial aerosol (and gas) concentrations are used as fixed boundary conditions. 
+
+If '''decycle_method_salsa''' = '' 'neumann' '', a zero concentration gradient is set at the boundary.
 
 Decycling is enabled by setting [#decycle_salsa_ns decycle_salsa_ns] = .T. and [#decycle_salsa_lr decycle_salsa_lr] = .T..
@@ -151 +165 @@
 }}}
 {{{#!td
-Parameter to the switch on the decycling of aerosol particles along y. The switch applies also for gaseous compounds (H2SO4, HNO3, NH3, OCNV and OCSV) if the chemistry model is not applied. 
+Parameter to the switch on the decycling of aerosol particles along ''y''-axis. The switch applies also for gaseous compounds (H2SO4, HNO3, NH3, OCNV and OCSV) if the [wiki:doc/tec/chem chemistry module] is not applied. 
 
 The decycling method per each lateral boundary is set by [#decycle_method_salsa decycle_method_salsa].
@@ -157 +171 @@
 |----------------
 {{{#!td style="vertical-align:top"
+[=#depo_pcm_par '''depo_pcm_par''']
+}}}
+{{{#!td style="vertical-align:top"
+C(20)
+}}}
+{{{#!td style="vertical-align:top"
+'zhang2001'
+}}}
+{{{#!td
+The method to solve the aerosol size specific dry deposition velocity (in m s-1). 
+
+Available options:
+
+'' 'zhang2001' '' ([wiki:doc/app/salsaref/ Zhang et al. 2001])
+'' 'petroff2010' '' ([wiki:doc/app/salsaref/ Petroff & Zhang, 2010])
+
+The surface material is specified with [#depo_pcm_type depo_pcm_type].
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
+[=#depo_pcm_type '''depo_pcm_type''']
+}}}
+{{{#!td style="vertical-align:top"
+C(20)
+}}}
+{{{#!td style="vertical-align:top"
+'zhang2001'
+}}}
+{{{#!td
+Leaf type applied in the dry deposition model.
+  
+Available options:
+'' 'evergreen_needleleaf' '', '' 'evergreen_broadleaf' '', '' 'deciduous_needleleaf' '' and '' 'deciduous_broadleaf' ''.
+}}}
+|----------------
+{{{#!td style="vertical-align:top"
 [=#depo_surf_par '''depo_surf_par''']
 }}}
@@ -166 +216 @@
 }}}
 {{{#!td
-The method to solve the aerosol size specific dry deposition velocity (in m s-1) over an urban surface. 
+The method to solve the dry deposition velocity (in m s-1) for aerosols over both horizontal and vertical surfaces.
+
 Available options:
-'zhang2001' ([wiki:doc/app/salsaref/ Zhang et al. 2001])
-'petroff2010' ([wiki:doc/app/salsaref/ Petroff & Zhang, 2010]).
-
-Note that the surface material is not specified in the included parametrisations.
-}}}
-|----------------
-{{{#!td style="vertical-align:top"
-[=#depo_pcm_par '''depo_pcm_par''']
-}}}
-{{{#!td style="vertical-align:top"
-C(20)
-}}}
-{{{#!td style="vertical-align:top"
-'zhang2001'
-}}}
-{{{#!td
-The method to solve the aerosol size specific dry deposition velocity (in m s-1). 
-Available options:
-'zhang2001' ([wiki:doc/app/salsaref/Zhang et al. 2001])
-'petroff2010' ([wiki:doc/app/salsaref/Petroff & Zhang, 2010])
-
-Note that currently the deposition velocity is calculated by default for deciduous broadleaf trees.
-}}}
-|----------------
-{{{#!td style="vertical-align:top"
-[=#depo_pcm_type '''depo_pcm_type''']
-}}}
-{{{#!td style="vertical-align:top"
-C(20)
-}}}
-{{{#!td style="vertical-align:top"
-'zhang2001'
-}}}
-{{{#!td
-Leaf type applied in the dry deposition model.  
-Available options:
-'evergreen_needleleaf', 'evergreen_broadleaf', 'deciduous_needleleaf' and 'deciduous_broadleaf'.
-}}}
-|----------------
-{{{#!td style="vertical-align:top"
-[=#depo_surf_par '''depo_surf_par''']
-}}}
-{{{#!td style="vertical-align:top"
-C(20)
-}}}
-{{{#!td style="vertical-align:top"
-'zhang2001'
-}}}
-{{{#!td
-The method to solve the aerosol size specific dry deposition velocity (in m s-1) over an urban surface. 
-Available options:
-'zhang2001' ([wiki:doc/app/salsaref/ Zhang et al. 2001])
-'petroff2010' ([wiki:doc/app/salsaref/ Petroff & Zhang, 2010]).
-
-Note that the surface material is not specified in the included parametrisations.
+'' 'zhang2001' '' ([wiki:doc/app/salsaref/ Zhang et al. 2001])
+'' 'petroff2010' '' ([wiki:doc/app/salsaref/ Petroff & Zhang, 2010]).
+
+The land use type applied in the parametrisations are imported from the land and urban surface modules. If the surfaces are not specified using the urban surface or land surface module, the land use type '' urban '' is applied for all surfaces. 
 }}}
 |----------------
@@ -237 +237 @@
 The number geometric mean diameter per aerosol mode (in µm). A total of 7 different aerosol modes can be applied.  Example modes: nucleation, Aitken, accumulation and coarse mode. 
 
-If [#init_aerosol_type init_aerosol_type]= 1, the initial aerosol size distribution is described by input parameters '''dpg''', [#sigmag sigmag] and [#n_lognorm n_lognorm].
+If [#init_aerosol_type init_aerosol_type]= 0, the initial aerosol size distribution is described by input parameters '''dpg''', [#sigmag sigmag] and [#n_lognorm n_lognorm].
 }}}
 |----------------
@@ -250 +250 @@
 }}}
 {{{#!td
-Time step for calling aerosol dynamic processes of SALSA. For switching on individual processes, see [#nlcnd nlcnd], [#nlcndgas nlcndgas], [#nlcndh2oae nlcndh2oae], [#nlcoag nlcoag], [#nldepo nldepo], [#nldepo_pcm nldepo_pcm], [#nldepo_surf nldepo_surf], [#nldistupdate nldistupdate] and [#nsnucl nsnucl].
+The time step for calling aerosol dynamic processes of SALSA. For switching on individual processes, see [#nlcnd nlcnd], [#nlcndgas nlcndgas], [#nlcndh2oae nlcndh2oae], [#nlcoag nlcoag], [#nldepo nldepo], [#nldepo_pcm nldepo_pcm], [#nldepo_surf nldepo_surf], [#nldistupdate nldistupdate] and [#nsnucl nsnucl].
+}}}
+|----------------
+{{{#!td style="vertical-align:top; width: 150px"
+[=#emiss_factor_main '''emiss_factor_main''']
+}}}
+{{{#!td style="vertical-align:top; width: 50px"
+R
+}}}
+{{{#!td style="vertical-align:top; width: 75px"
+0.0
+}}}
+{{{#!td
+Constant emission scaling factor for main street types, used if [#salsa_emission_mode salsa_emission_mode] = '' 'parameterized' ''. 
+}}}
+|----------------
+{{{#!td style="vertical-align:top; width: 150px"
+[=#emiss_factor_side '''emiss_factor_side''']
+}}}
+{{{#!td style="vertical-align:top; width: 50px"
+R
+}}}
+{{{#!td style="vertical-align:top; width: 75px"
+0.0
+}}}
+{{{#!td
+Constant emission scaling factor for side street types, used if [#salsa_emission_mode salsa_emission_mode] = '' 'parameterized' ''. 
 }}}
 |----------------
@@ -353 +379 @@
 }}}
 |----------------
+{{{#!td style="vertical-align:top; width: 150px"
+[=#main_street_id '''main_street_id''']
+}}}
+{{{#!td style="vertical-align:top; width: 50px"
+I(99)
+}}}
+{{{#!td style="vertical-align:top; width: 75px"
+0
+}}}
+{{{#!td
+Index for identifying main streets following street type classes from 'OpenStreetMap'. Used if [#salsa_emission_mode salsa_emission_mode] = '' 'parameterized' ''.
+}}}
+|----------------
 {{{#!td style="vertical-align:top"
 [=#mass_fracs_a '''mass_fracs_a''']
@@ -387 +426 @@
 }}}
 |----------------
+{{{#!td style="vertical-align:top; width: 150px"
+[=#max_street_id '''max_street_id''']
+}}}
+{{{#!td style="vertical-align:top; width: 50px"
+I(99)
+}}}
+{{{#!td style="vertical-align:top; width: 75px"
+0
+}}}
+{{{#!td
+Maximum index value for identifying all (main and side) streets following street type classes from `OpenStreetMap`. Used if [#salsa_emission_mode salsa_emission_mode] = '' 'parameterized' ''.
+}}}
+|----------------
 {{{#!td style="vertical-align:top"
 [=#n_lognorm '''n_lognorm''']
@@ -399 +451 @@
 The total aerosol number concentration per aerosol mode (in cm^-3^). A total of 7 different aerosol modes can be applied.  Example modes: nucleation, Aitken, accumulation and coarse mode. 
 
-If [#isdtyp isdtyp] = 1, the initial aerosol size distribution is described by input parameters [#dpg dpg], [#sigmag sigmag] and '''n_lognorm'''.
+If [#init_aerosol_type init_aerosol_type] = 0, the initial aerosol size distribution is described by input parameters [#dpg dpg], [#sigmag sigmag] and '''n_lognorm'''.
 }}}
 |----------------
@@ -600 +652 @@
 Requires [#nlcnd nlcnd] = .T..
 
-Note that the nucleation schemes were not evaluated in[wiki:doc/app/salsaref/ Kurppa et al. (2018)]. 
+Note that the nucleation schemes were not evaluated in [wiki:doc/app/salsaref/ Kurppa et al. (2019)]. 
 }}}
 |----------------
@@ -667 +719 @@
 Emission mode for aerosol and gaseous emissions. 
 
-Setting '''salsa_emission_mode''' = 'uniform' sets a horizontally homogeneous surface flux of aerosols based on [#surface_aerosol_flux surface_aerosol_flux], [#aerosol_flux_dpg aerosol_flux_dpg], [#aerosol_flux_sigmag aerosol_flux_sigmag] and [#aerosol_flux_mass_fracs_a aerosol_mass_fracs_a]. 
-
-Setting '''salsa_emission_mode''' = 'parameterized' sets the emission based on the street type. The size distribution and mass composition is given similar to is given similar to '''salsa_emission_mode''' = 'uniform'. The flux is then normalised for streets using [#emission_factor_main emission_factor_main], [#emission_factor_side emission_factor_side] [#main_street_id main_street_id], [#side_street_id side_street_id], [#max_street_id max_street_id].
-
-Setting '''salsa_emission_mode''' = 'read_from_file' reads the source information from the NetCDF aero -information file. 
+'''salsa_emission_mode''' = '' 'uniform' '' sets a horizontally homogeneous surface flux of aerosols based on [#surface_aerosol_flux surface_aerosol_flux], [#aerosol_flux_dpg aerosol_flux_dpg], [#aerosol_flux_sigmag aerosol_flux_sigmag] and [#aerosol_flux_mass_fracs_a aerosol_mass_fracs_a]. 
+
+'''salsa_emission_mode''' = '' 'parameterized' '' sets surface fluxes based on the street type. The aerosol size distribution and mass composition of the emission is given similar to '''salsa_emission_mode''' = '' 'uniform' ''. The flux is then normalised based on the street type in the static input file (see [wiki:doc/app/iofiles/pids/static static input file]) and using [#emission_factor_main emission_factor_main], [#emission_factor_side emission_factor_side] [#main_street_id main_street_id], [#side_street_id side_street_id], [#max_street_id max_street_id].
+
+'''salsa_emission_mode''' = '' 'read_from_file' '' reads the emission information from the NetCDF aero -information file (see [wiki:doc/app/iofiles/pids/aerosol aerosol input file]). 
 
 Note that all chemical components included in the simulation must be activated in [#listspec listspec].  Also '''bc_salsa_b''' = '' 'neumann' '' is required.
 }}}
 |----------------
+{{{#!td style="vertical-align:top; width: 150px"
+[=#side_street_id '''side_street_id''']
+}}}
+{{{#!td style="vertical-align:top; width: 50px"
+I(99)
+}}}
+{{{#!td style="vertical-align:top; width: 75px"
+0
+}}}
+{{{#!td
+Index for identifying side streets following street type classes from 'OpenStreetMap'. Used if [#salsa_emission_mode salsa_emission_mode] = '' 'parameterized' ''.
+}}}
+|----------------
 {{{#!td style="vertical-align:top"
 [=#sigmag '''sigmag''']