Skip to content

Commit 7731d60

Browse files
Small improvements to documentation on obtaining input data (#4462)
Co-authored-by: Valeriu Predoi <valeriu.predoi@gmail.com>
1 parent fc54708 commit 7731d60

1 file changed

Lines changed: 7 additions & 17 deletions

File tree

doc/sphinx/source/input.rst

Lines changed: 7 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ but many more exist around the world.
4444

4545
If you do not have access to such a facility through your institute or the
4646
project you are working on, you can request access by applying for the
47-
`ENES Climate Analytics Service <https://is.enes.org/sdm-climate-analytics-data/>`.
47+
`ENES Climate Analytics Service <https://is.enes.org/sdm-climate-analytics-data/>`__.
4848

4949
If the options above are not available to you, ESMValTool also offers a feature
5050
to make it easy to download CMIP6, CMIP5, CMIP3, CORDEX, and obs4MIPs from ESGF.
@@ -66,18 +66,9 @@ ESMValTool can automatically download any required data that is available on
6666
ESGF.
6767
This is the recommended approach for first-time users to obtain some data for
6868
running ESMValTool.
69-
For example, run
70-
71-
.. code-block:: bash
72-
73-
esmvaltool run --search_esgf=when_missing examples/recipe_python.yml
74-
75-
to run the default example recipe and automatically download the required data
76-
to the directory ``~/climate_data``.
77-
The data only needs to be downloaded once, every following run will reuse
78-
previously downloaded data stored in this directory.
79-
See :ref:`esmvalcore:config-esgf` for a more in depth explanation and the
80-
available configuration options.
69+
See the section on configuring :ref:`esmvalcore:config-data-sources` for
70+
details on how to configure ESMValTool to download data from ESGF using
71+
`intake-esgf <https://intake-esgf.readthedocs.io>`__.
8172

8273
Alternatively, you can use an external tool called
8374
`esgpull <https://github.com/ESGF/esgf-download>`__
@@ -91,7 +82,7 @@ Observations
9182

9283
Observational and reanalysis products in the standard CF/CMOR format used in
9384
CMIP and required by ESMValTool are available via the obs4MIPs and ana4mips
94-
projects at the ESGF (e.g., https://esgf-data.dkrz.de/projects/esgf-dkrz/).
85+
projects hosted by ESGF (e.g., https://pcmdi.github.io/obs4MIPs/).
9586
Their use is strongly recommended, when possible.
9687

9788
Other datasets not available in these archives can be obtained by the user from
@@ -119,9 +110,8 @@ All observational datasets are grouped into in three tiers:
119110
* **Tier 2** other freely available datasets that are not obs4mips. There are no license restrictions. These datasets need to be reformatted to be used with ESMValTool ('CMORization', see above).
120111
* **Tier 3** restricted datasets. Datasets which require registration to be downloaded or that can only be obtained upon request from the respective authors. License restrictions do not allow us to redistribute Tier 3 datasets. The data have to be obtained and reformatted by the user ('CMORization', see above).
121112

122-
[!NOTE]
123-
.. _tier3_note:
124-
For some of the Tier 3 datasets, we obtained permission from the dataset providers to share the data among ESMValTool users on HPC systems. These Tier 3 datasets are marked with an asterisk in the table in section :ref:`supported datasets below<supported_datasets>`.
113+
.. note::
114+
For some of the Tier 3 datasets, we obtained permission from the dataset providers to share the data among ESMValTool users on HPC systems. These Tier 3 datasets are marked with an asterisk in the table in section :ref:`supported datasets below<supported_datasets>`.
125115

126116
An overview of the Tier 2 and Tier 3 datasets for which a CMORizing script is available in ESMValTool v2.0 is given in section :ref:`supported datasets below<supported_datasets>`.
127117

0 commit comments

Comments
 (0)