.. _model-configuration-config-files: Config Files ======================== .. contents:: :local: Overview -------- The ``config_files.xml`` file is the main entrypoint for CIME to load a models configuration. The contents define ``entry`` elements that describe various variables used to configure the model. These varaibles defines supported compsets, components, grids, machines, batch queue, and compiler macros. These ``config_files.xml`` are stored in ``$CIMEROOT/CIME/data/config//``. .. note:: The preferred method of adding a new model to CIME is to add a ``config_files.xml`` with a single entry; ``MODEL_CONFIG_FILES`` to the CIME repository. Using ``MODEL_CONFIG_FILES`` allows the models configuration to live outside the CIME repository. Usage ----- The entries in ``config_files.xml`` will describe the following variables. .. toctree:: :maxdepth: 1 variables/archive.rst variables/batch.rst variables/build-lib.rst variables/casefile-headers.rst variables/cmake-macros-dir.rst variables/compsets.rst variables/comp-root-dir.rst variables/component.rst variables/component_model_specific.rst variables/tests.rst variables/grids.rst variables/inputdata.rst variables/machine.rst variables/model.rst variables/namelist-definition.rst variables/pes.rst variables/pio.rst variables/system-tests.rst variables/tests-mods.rst variables/tests-spec.rst variables/user-mods.rst variables/workflow.rst Schema Definition ----------------- Version 3.0 ::::::::::: This version will reference another ``config_files.xml`` file that can be stored in the models repository. .. code-block:: xml char $SRCROOT/cime_config/config_files.xml case_last env_case.xml file containing paths