##################################################
Generating boundary condition files from raw data
##################################################

The :bash:`inicond`, :bash:`latcond` and :bash:`topcond` components are characterized by their
:bash:`comp_type`; otherwise, their specifications follow the same principles as :bash:`flux`, as described :doc:`previously<emissions>`.

Good practices
===============

If your are a new user of the CIF or if you use a raw type of data for the fist time, it is safer to follow the steps:

  1. Prepare a yaml for only generating the boundary conditions (as shown above).
  2. Run the system with this yaml.
  3. Check the generated inputs, as explained in :ref:`chimere_check_inputs_readymade`.

Principles
==========

The supported raw inputs are the ones supported by the various available plugins
for the boundary conditions, which are found in :doc:`datastreams of type Field</documentation/plugins/index>`
(see also :doc:`cheat-sheet</documentation/dependencies>`).

To specify different input sources for the various species at the boundaries,
these species must be listed as parameters of :bash:`inicond`, :bash:`latcond` and :bash:`topcond`
(three independent datatreams) and their names must match the names in
:doc:`ACTIVE_SPECIES</documentation/doc-models/chimere/chemistry>`.
For each parameter, the specifications of the component plugin are inherited by default
but it is possible to individualize everything, including the plugin to use, as shown in the following examples.

.. include:: datavect_infos.rst


Examples
========

Only one species, taken from various raw fields
................................................

   .. code-block:: yaml

      datavect:
        plugin:
          name: standard
          version: std
        components:
          inicond:
            parameters:
             CH4:
              plugin:
                name: ECMWF
                version: grib2
                type: field
              dir: /home/comdata1/Meteo/1280franceArgonaut/%Y/%m/
              file: macc.1280franceArgonaut.%Y%m%d0000%H.grb2
              file_2d: 2dmacc.1280franceArgonaut.%Y%m%d0000%H.grb2
              file_freq: 3H
              varname: ch4
              unit_conversion: # Conversion from kg/kg to ppb
                scale: 1810375000.0

          latcond:
            parameters:
              CH4:
               plugin:
                 name: CAMS
                 version: netcdf
                 type: field
               is_lbc: True
               dir: /home/chimereicos/ipison/grib_CAMS_N2O_chimere_cif/
               file: z_cams_l_nilu_%Y%m_v17r1_ra_ml_3h_n2o.nc
               file_freq: 3H
               varname: CH4
               time_interpolation:
                 methode: linear

          topcond:
            parameters:
              CH4:
                plugin:
                  name: ECMWF
                  version: grib2
                  type: field
                is_top: True
                dir: /home/comdata1/Meteo/1280franceArgonaut/%Y/%m/
                file: macc.1280franceArgonaut.%Y%m%d0000%H.grb2
                file_2d: 2dmacc.1280franceArgonaut.%Y%m%d0000%H.grb2
                file_freq: 3H
                varname: ch4
                unit_conversion: # Conversion from kg/kg to ppb
                  scale: 1810375000.0
                time_interpolation:
                  methode: linear