################################################################## Combining various ready-made inputs for CHIMERE ################################################################## .. toctree:: :hidden: preproc_plugins Here we combine emissions and boundary conditions from multiple ready-made files for :doc:`CHIMERE`. These instructions assume that you already have a YAML for a :doc:`first simulation with ready-made files`, and focus on the :bash:`datavect` components that provide CHIMERE with its standard inputs. How to test the choices made ============================= 1. Have a YAML for a first forward simulation. 2. Modify the YAML for the targeted inputs, as shown below. 3. Run the system with the modified YAML (see :ref:`chimere_run_readymade`). 4. Check the generated inputs, as explained in :ref:`chimere_check_inputs_readymade`. Combining ready-made files for emissions =========================================== Different input sources can be specified for the various emitted species that do not require sub-hourly interpolation. These species must be listed as :bash:`parameters` of :bash:`flux`, with names matching those in :doc:`ANTHROPIC`. Each parameter inherits the component plugin settings by default, but all settings, including the plugin itself, can be overridden individually, as shown in the examples below. Combining a general file with particular files for a few species ---------------------------------------------------------------- A common pattern is to use a general set of files for all species in the chemical scheme, except for a few that use a different source. In the following example, all species come from the AEMISSIONS files in :bash:`directory_containing_AEMISSIONS.YYYYMMDDHH.*.nc_files`, except S1 which comes from :bash:`directory_containing_AEMISSIONS.YYYYMMDDHH.*.nc_files_for_S1`: .. code-block:: yaml datavect: plugin: name: standard version: std components: meteo: dir: directory_containing_METEO.YYYYMMDDHH.*.nc_files file: METEO.%Y%m%d%H.X.nc plugin: name: CHIMERE version: std type: meteo file_freq: XH flux: dir: directory_containing_AEMISSIONS.YYYYMMDDHH.*.nc_files file: AEMISSIONS.%Y%m%d%H.X.nc plugin: name: CHIMERE version: AEMISSIONS type: flux file_freq: XH parameters: S1: plugin: name: CHIMERE version: AEMISSIONS type: flux dir: directory_containing_AEMISSIONS.YYYYMMDDHH.*.nc_files_for_S1 Specifying a file for each species ----------------------------------- When there are only a few emitted species, each one can be specified individually with no general fallback file. If any species from the :doc:`ANTHROPIC` list is missing from :bash:`parameters`, the CIF will raise an error when attempting to create a symlink to a non-existent inventory file. .. code-block:: yaml datavect: plugin: name: standard version: std components: meteo: dir: directory_containing_METEO.YYYYMMDDHH.*.nc_files file: METEO.%Y%m%d%H.X.nc plugin: name: CHIMERE version: std type: meteo file_freq: XH flux: parameters: S1: dir: directory_containing_AEMISSIONS.YYYYMMDDHH.*.nc_files_for_S1 file: AEMISSIONS.%Y%m%d%H.X.nc file_freq: XH plugin: name: CHIMERE version: AEMISSIONS type: flux S2: dir: directory_containing_AEMISSIONS.YYYYMMDDHH.*.nc_files_for_S2 file: AEMISSIONS.%Y%m%d%H.Y.nc file_freq: YH plugin: name: CHIMERE version: AEMISSIONS type: flux Interpolate one AEMISSIONS from another domain into the chosen one ------------------------------------------------------------------- When AEMISSIONS files are available for a different domain, you can instruct the CIF to interpolate them onto the current domain by specifying the original domain's characteristics in the relevant parameter(s). The CIF does not infer this information automatically. .. code-block:: yaml domain: plugin: name: CHIMERE version: std type: domain domid: THISSTUDY emissublayer: 0 nlev: NL p1: P1 pmax: PMAX repgrid: directory_containing_domains_definitions/domains datavect: plugin: name: standard version: std components: meteo: dir: directory_containing_METEO.YYYYMMDDHH.*.nc_files file: METEO.%Y%m%d%H.X.nc plugin: name: CHIMERE version: std type: meteo file_freq: XH flux: parameters: S1: dir: directory_containing_AEMISSIONS.YYYYMMDDHH.*.nc_files_for_S1 file: AEMISSIONS.%Y%m%d%H.X.nc file_freq: XH plugin: name: CHIMERE version: AEMISSIONS type: flux S2: dir: directory_containing_AEMISSIONS.YYYYMMDDHH.*.nc_files_for_S2_on_domain_ORIGIN domain: domid: ORIGIN emissublayer: 0 nlev: NLORIG p1: P1ORIG pmax: PMAXORIG file: AEMISSIONS.%Y%m%d%H.Y.nc file_freq: YH plugin: name: CHIMERE version: AEMISSIONS type: flux Both the horizontal and vertical grids can differ. If the original domain covers a smaller area than the target domain, emissions outside the original domain are set to zero. BEMISSIONS ---------- The :bash:`bioflux` specifications follow the same principles as :bash:`flux`. All the examples provided for AEMISSIONS apply to BEMISSIONS, with the addition of :bash:`emis_type`. Combining ready-made files for boundary conditions =================================================== The :bash:`inicond`, :bash:`latcond`, and :bash:`topcond` components are distinguished by their :bash:`comp_type`; otherwise their specifications follow the same principles as :bash:`flux`. To use different pre-computed files for different species, specify parameters whose names match those in :doc:`ACTIVE_SPECIES`. The example below shows a case where a general file is used for initial and lateral conditions except for one species in each case, and a general file is used for all top conditions. .. code-block:: yaml datavect: plugin: name: standard version: std components: meteo: dir: directory_containing_METEO.YYYYMMDDHH.*.nc_files file: METEO.%Y%m%d%H.X.nc plugin: name: CHIMERE version: std type: meteo file_freq: XH flux: dir: directory_containing_AEMISSIONS.YYYYMMDDHH.*.nc_files file: AEMISSIONS.%Y%m%d%H.X.nc plugin: name: CHIMERE version: AEMISSIONS type: flux file_freq: XH inicond: dir: directory_containing_IC.YYYYMMDDHH.*.nc_files file: INI_CONCS.0.nc plugin: name: CHIMERE version: icbc type: field comp_type: inicond parameters: S1: dir: directory_containing_IC.YYYYMMDDHH.*.nc_files_forS1 file: INI_CONCS.0.nc plugin: name: CHIMERE version: icbc type: field latcond: dir: directory_containing_BC.YYYYMMDDHH.*.nc_files file: BOUN_CONCS.%Y%m%d%H.X.nc plugin: name: CHIMERE version: icbc type: field comp_type: latcond file_freq: XH parameters: S3: dir: directory_containing_BC.YYYYMMDDHH.*.nc_files_forS3 file: BOUN_CONCS.%Y%m%d%H.Y.nc file_freq: YH plugin: name: CHIMERE version: icbc type: field topcond: dir: directory_containing_BC.YYYYMMDDHH.*.nc_files file: BOUN_CONCS.%Y%m%d%H.X.nc plugin: name: CHIMERE version: icbc type: field comp_type: topcond file_freq: XH