##################################################
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 you are a new CIF user or are using a raw data type for the first time, follow these steps:

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

Principles
==========

Supported raw inputs are those handled by the available plugins
for boundary conditions, found under :doc:`datastreams of type Field</documentation/plugins/index>`
(see also the :doc:`cheat-sheet</documentation/dependencies>`).

To specify different input sources for different boundary species,
list these species as parameters of :bash:`inicond`, :bash:`latcond`, and :bash:`topcond`
(three independent datastreams), with names matching those in
:doc:`ACTIVE_SPECIES</documentation/doc-models/chimere/chemistry>`.
Each parameter inherits the component plugin settings by default,
but all settings, including the plugin, can be overridden individually, as shown in the examples below.

.. 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