From 17f72269b496eee98592a8a6cb39a3eb21171e06 Mon Sep 17 00:00:00 2001
From: Baudouin Raoult <baudouin.raoult@ecmwf.int>
Date: Mon, 1 Apr 2024 09:49:34 +0100
Subject: [PATCH] work on doc

---
 docs/overview.rst            |  3 +++
 docs/using/code/drop_.py     |  5 +----
 docs/using/code/rename_.py   |  5 +----
 docs/using/code/reorder1_.py |  2 +-
 docs/using/code/reorder2_.py | 10 ++++++++--
 docs/using/code/select1_.py  |  2 +-
 docs/using/code/select2_.py  |  2 +-
 7 files changed, 16 insertions(+), 13 deletions(-)

diff --git a/docs/overview.rst b/docs/overview.rst
index b0ada82bd..1fd0f76cc 100644
--- a/docs/overview.rst
+++ b/docs/overview.rst
@@ -24,6 +24,9 @@ ensemble, and fourth dimension are the grid points values.
  Chunking
 **********
 
+"Chunks" are the basic unit of data storage in Zarr_. This means that it
+is the granularity at which data is read from disk.
+
 By default, the array is chunked along the time dimensions so the whole
 state of the atmosphere at a given time is loaded in one go:
 
diff --git a/docs/using/code/drop_.py b/docs/using/code/drop_.py
index 62948aa5b..015a1ada9 100644
--- a/docs/using/code/drop_.py
+++ b/docs/using/code/drop_.py
@@ -1,4 +1 @@
-ds = open_dataset(
-    "aifs-ea-an-oper-0001-mars-o96-1979-2022-1h-v2",
-    drop=["10u", "10v"],
-)
+ds = open_dataset(dataset, drop=["10u", "10v"])
diff --git a/docs/using/code/rename_.py b/docs/using/code/rename_.py
index 3441392a1..516130dde 100644
--- a/docs/using/code/rename_.py
+++ b/docs/using/code/rename_.py
@@ -1,4 +1 @@
-ds = open_dataset(
-    "aifs-ea-an-oper-0001-mars-o96-1979-2022-1h-v2",
-    rename={"2t": "t2m"},
-)
+ds = open_dataset(dataset, rename={"2t": "t2m"})
diff --git a/docs/using/code/reorder1_.py b/docs/using/code/reorder1_.py
index 43ef0c2fe..0e9ba5de4 100644
--- a/docs/using/code/reorder1_.py
+++ b/docs/using/code/reorder1_.py
@@ -1,4 +1,4 @@
 ds = open_dataset(
-    "aifs-ea-an-oper-0001-mars-o96-1979-2022-1h-v2",
+    dataset,
     reorder=["2t", "msl", "sp", "10u", "10v"],
 )
diff --git a/docs/using/code/reorder2_.py b/docs/using/code/reorder2_.py
index b6b88e8e4..90153ea21 100644
--- a/docs/using/code/reorder2_.py
+++ b/docs/using/code/reorder2_.py
@@ -1,4 +1,10 @@
 ds = open_dataset(
-    "aifs-ea-an-oper-0001-mars-o96-1979-2022-1h-v2",
-    reorder={"2t": 0, "msl": 1, "sp": 2, "10u": 3, "10v": 4},
+    dataset,
+    reorder={
+        "2t": 0,
+        "msl": 1,
+        "sp": 2,
+        "10u": 3,
+        "10v": 4,
+    },
 )
diff --git a/docs/using/code/select1_.py b/docs/using/code/select1_.py
index 83c4e9841..1f0ad735f 100644
--- a/docs/using/code/select1_.py
+++ b/docs/using/code/select1_.py
@@ -1,4 +1,4 @@
 ds = open_dataset(
-    "aifs-ea-an-oper-0001-mars-o96-1979-2022-1h-v2",
+    dataset,
     select=["2t", "tp"],
 )
diff --git a/docs/using/code/select2_.py b/docs/using/code/select2_.py
index 56ced12d7..b2007f311 100644
--- a/docs/using/code/select2_.py
+++ b/docs/using/code/select2_.py
@@ -1,4 +1,4 @@
 ds = open_dataset(
-    "aifs-ea-an-oper-0001-mars-o96-1979-2022-1h-v2",
+    dataset,
     select={"2t", "tp"},
 )