.. _site_config:

Creating a Site
===============

Site Creation
-------------

Every site has a predefined set of parameters that need to be included that define the soil dynamics. See the table 
below for information on these parameters. For the blank template to make a site, see :ref:`site_template`.

Site Parameters
---------------

NPK Soil Parameters
^^^^^^^^^^^^^^^^^^^

+----------------------+--------------------------------------------------------+--------+-----------------------------+
| Name                 | Description                                            | Type   | Unit                        |
+======================+========================================================+========+=============================+
| NSOILBASE            | Base soil supply of N available through mineralisation | SSi    |  kg ha-1                    |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| NSOILBASE_FR         | Fraction of base soil N that comes available every day | SSi    | -                           |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| PSOILBASE            | Base soil supply of P available through mineralisation | SSi    |  kg ha-1                    |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| PSOILBASE_FR         | Fraction of base soil P that comes available every day | SSi    | -                           |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| KSOILBASE            | Base soil supply of K available through mineralisation | SSi    |  kg ha-1                    |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| KSOILBASE_FR         | Fraction of base soil K that comes available every day| SSi     | -                           |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| NAVAILI              | Initial N available in the N pool                      | SSi    |  kg ha-1                    |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| PAVAILI              | Initial P available in the P pool                      | SSi    |  kg ha-1                    |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| KAVAILI              | Initial K available in the K pool                      | SSi    |  kg ha-1                    |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| NMAX                 | Maximum N available in the N pool                      | SSi    |  kg ha-1                    |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| PMAX                 | Maximum P available in the N pool                      | SSi    |  kg ha-1                    |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| KMAX                 | Maximum K available in the N pool                      | SSi    |  kg ha-1                    |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| BG_N_SUPPLY          | Background supply of N through atmospheric deposition  | SSi    |  kg ha-1 d-1                |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| BG_P_SUPPLY          | Background supply of P through atmospheric deposition  | SSi    |  kg ha-1 d-1                |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| BG_K_SUPPLY          | Background supply of K through atmospheric deposition  | SSi    |  kg ha-1 d-1                |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| RNSOILMAX            | Maximum rate of surface N to subsoil                   | SSi    |  kg ha-1 d-1                |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| RPSOILMAX            | Maximum rate of surface P to subsoil                   | SSi    |  kg ha-1 d-1                |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| RKSOILMAX            | Maximum rate of surface K to subsoil                   | SSi    |  kg ha-1 d-1                |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| RNABSORPTION         | Relative rate of N absorption from surface to subsoil  | SSi    |  kg ha-1 d-1                |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| RPABSORPTION         | Relative rate of P absorption from surface to subsoil  | SSi    |  kg ha-1 d-1                |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| RKABSORPTION         | Relative rate of K absorption from surface to subsoil  | SSi    |  kg ha-1 d-1                |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| RNPKRUNOFF           | Relative rate of NPK runoff as a function of surface   | SSi    | -                           | 
|                      | water runoff                                           |        |                             |
+----------------------+--------------------------------------------------------+--------+-----------------------------+

Soil Dynamics Parameters
^^^^^^^^^^^^^^^^^^^^^^^^
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| Name                 | Description                                            | Type   | Unit                        |
+======================+========================================================+========+=============================+
| SMFCF                | Field capacity of the soil                             | SSo    | -                           |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| SM0                  | Porosity of the soil                                   | SSo    | -                           |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| SMW                  | Wilting point of the soil                              | SSo    | -                           |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| CRAIRC               | Soil critical air content (waterlogging)               | SSo    | -                           |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| SOPE                 | Maximum percolation rate root zone                     | SSo    |  cm day-1                   |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| KSUB                 | Maximum percolation rate subsoil                       | SSo    |  cm day-1                   |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| RDMSOL               | Soil rootable depth                                    | SSo    |  cm                         |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| IFUNRN               | Indicates whether non-infiltrating fraction of rain is | SSi    | -                           |
|                      | a function of storm size (1) or not (0)                |        |                             |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| SSMAX                | Maximum surface storage                                | SSi    |  cm                         |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| SSI                  | Initial surface storage                                | SSi    |  cm                         |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| WAV                  | Initial amount of water in total soil profile          | SSi    |  cm                         |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| NOTINF               | Maximum fraction of rain not-infiltrating into the soil| SSi    | -                           |
+----------------------+--------------------------------------------------------+--------+-----------------------------+
| SMLIM                | Initial maximum moisture content in initial rooting    | SSi    | -                           |
|                      | depth zone                                             |        |                             |
+----------------------+--------------------------------------------------------+--------+-----------------------------+


.. _site_template:

Site Template
^^^^^^^^^^^^^

Download the site template YAML file here: :download:`site_template.yaml </_static/site_template.yaml>`