.. _model_config_comp_root_dir:

COMP_ROOT_DIR_*
========================

.. contents::
    :local:

Entry
-----
The following is an example entry for ``COMP_ROOT_DIR_<component>`` in ``config_files.xml``.
The ``<component>`` is replaced by the name of the component.
Each ``value`` provides the path to the root directory of the component for a specific component denoted by the ``component`` attribute.
There will be multiple ``entry`` elements, one for each component supported by the model.

.. code-block:: xml

    <entry id="COMP_ROOT_DIR_ATM">
        <type>char</type>
        <values>
            <value component="datm">$SRCROOT/components/data_comps/datm</value>
            <value component="satm">$SRCROOT/components/stub_comps/satm</value>
            <value component="xatm">$SRCROOT/components/xcpl_comps/xatm</value>
            <value component="eam">$SRCROOT/components/eam/</value>
            <value component="eamxx">$SRCROOT/components/eamxx/</value>
            <value component="scream">$SRCROOT/components/eamxx/</value>
        </values>
        <group>case_comps</group>
        <file>env_case.xml</file>
        <desc>Root directory of the case atmospheric component  </desc>
        <schema>$CIMEROOT/CIME/data/config/xml_schemas/config_compsets.xsd</schema>
    </entry>

For each component a model supports, CIME expects to find a variable entry in the form of ``COMP_ROOT_DIR_<component>``.

Where ``<component>`` is replaced by one of the following.

* CPL
* ATM
* LND
* ROF
* ICE
* OCN
* WAV
* GLC
* IAC
* ESP