tidy

docs/using/code/combine_example.py

@@ -0,0 +1,3 @@
+from anemoi.datasets import open_dataset
+
+ds = open_dataset("path/to/dataset1.zarr", "path/to/dataset2.zarr")

docs/using/code/end_.py

@@ -0,0 +1 @@
+open_dataset(dataset, end="2020-12-31")

docs/using/code/frequency_.py

@@ -0,0 +1 @@
+ds = open_dataset(dataset, frequency="6h")

docs/using/code/some_attributes_.py

@@ -0,0 +1,7 @@
+print(ds.shape)
+
+print(len(ds))
+
+print(ds[0])
+
+print(ds[10:20])

docs/using/code/start_.py

@@ -0,0 +1 @@
+open_dataset(dataset, start=1980)

docs/using/code/subset_example.py

@@ -0,0 +1,3 @@
+from anemoi.datasets import open_dataset
+
+ds = open_dataset("path/to/dataset.zarr", start=2000, end=2020)

docs/using/introduction.rst

@@ -13,43 +13,24 @@ organised in such a way that I/O operations are minimised (see
 
 To open a dataset, you can use the `open_dataset` function.
 
-.. code:: python
-
-   from anemoi.datasets import open_dataset
-
-   ds = open_dataset("path/to/dataset.zarr")
+.. literalinclude:: code/open_path.py
 
 You can then access the data in the dataset using the `ds` object as if
 it was a NumPy array.
 
-.. code:: python
-
-   print(ds.shape)
-
-   print(len(ds))
-
-   print(ds[0])
-
-   print(ds[10:20])
+.. literalinclude:: code/some_attributes_.py
 
 One of the main feature of the *anemoi-datasets* package is the ability
 to subset or combine datasets.
 
-.. code:: python
-
-   from anemoi.datasets import open_dataset
-
-   ds = open_dataset("path/to/dataset.zarr", start=2000, end=2020)
+.. literalinclude:: code/subset_example.py
 
 In that case, a dataset is created that only contains the data between
 the years 2000 and 2020. Combining is done by passing multiple paths to
 the `open_dataset` function:
 
-.. code:: python
-
-   from anemoi.datasets import open_dataset
-
-   ds = open_dataset("path/to/dataset1.zarr", "path/to/dataset2.zarr")
+.. literalinclude:: code/combine_example.py
+   :language: python
 
 In the latter case, the datasets are combined along the time dimension
 or the variable dimension depending on the datasets structure.

docs/using/subsetting.rst

@@ -12,9 +12,7 @@
 
 This option let you subset the dataset by time. You can pass a date or a
 
-.. code:: python
-
-   open_dataset(dataset, start=1980)
+.. literalinclude:: code/start_.py
 
 .. _end:
 
@@ -24,9 +22,8 @@ This option let you subset the dataset by time. You can pass a date or a
 
 As for the start option, you can pass a date or a string:
 
-.. code:: python
-
-   open_dataset(dataset, end="2020-12-31")
+.. literalinclude:: code/end_.py
+   :language: python
 
 The following are equivalent way of describing ``start`` or ``end``:
 
@@ -42,6 +39,5 @@ The following are equivalent way of describing ``start`` or ``end``:
 
 You can change the frequency of the dataset by passing a string with the
 
-.. code:: python
-
-   ds = open_dataset(dataset, frequency="6h")
+.. literalinclude:: code/frequency_.py
+   :language: python