Refactor Dataset Module

.devcontainer/Dockerfile

@@ -0,0 +1,9 @@
+FROM mcr.microsoft.com/devcontainers/base:bookworm
+
+USER root
+RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
+    && apt-get -y install --no-install-recommends libgdal-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+USER vscode
+RUN curl -LsSf https://astral.sh/uv/install.sh | sh

.devcontainer/devcontainer.json

@@ -0,0 +1,30 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/debian
+{
+	"name": "Debian",
+	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+	"build": {
+		// Path is relative to the devcontainer.json file.
+		"dockerfile": "Dockerfile"
+	},
+	"postCreateCommand": "uv sync",
+	"customizations": {
+		"vscode": {
+			"extensions": [
+				"ms-python.python",
+				"charliermarsh.ruff"
+			]
+		}
+	},
+	"mounts": [
+		"source=${localEnv:HOME}${localEnv:USERPROFILE}/.local/geodata,target=/home/vscode/.local/geodata,type=bind"
+	]
+	// Features to add to the dev container. More info: https://containers.dev/features.
+	// "features": {},
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	// "forwardPorts": [],
+	// Configure tool-specific properties.
+	// "customizations": {},
+	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+	// "remoteUser": "root"
+}

.github/workflows/dev_test.yml

@@ -22,7 +22,7 @@ jobs:
       max-parallel: 10
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
+        os: [ubuntu-latest, macos-latest]
         python-version: [3.10.11, 3.12.6] # These versions are compatibale with all three OS on GitHub Actions
     steps:
       - uses: actions/checkout@v3

.github/workflows/pr_test.yml

@@ -22,7 +22,7 @@ jobs:
       max-parallel: 10
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
+        os: [ubuntu-latest, macos-latest]
         python-version: [3.10.11, 3.12.6] # These versions are compatibale with all three OS on GitHub Actions
     steps:
       - uses: actions/checkout@v3

docs/source/conf.py

@@ -9,7 +9,7 @@
 from geodata import __version__
 
 project = "Geodata"
-copyright = "2023, Geodata Contributors"
+copyright = "2025, Geodata Contributors"
 author = "Geodata Contributors"
 release = __version__
 

docs/source/datasets/era5.rst

@@ -0,0 +1,81 @@
+ERA5 Specific Instructions
+==========================
+
+This page explains how you can set up access to ERA5 data from the `Copernicus Data Store <https://cds.climate.copernicus.eu/cdsapp#!/dataset/reanalysis-era5-single-levels?tab=overview>`_.
+
+Creating a CDS account
+----------------------
+
+To download ERA5 data from the CDS, you'll need to create a free `CDS account here <https://cds.climate.copernicus.eu/>`_.
+
+Download data through CDS API
+-----------------------------
+
+Once your account has been created, set up access to the API by following these steps:
+
+1. Log into your CDS account and visit your `profile page <https://cds.climate.copernicus.eu/profile>`_.
+2. Install the API key. There will be a section called **Personal Access Token**.
+   Copy these two lines into a file called ``.cdsapirc`` in your user root folder.
+
+- **macOS/Linux**: Open a terminal and run:
+
+  .. code-block:: bash
+
+      touch ~/.cdsapirc
+
+  Then add the lines using:
+
+  .. code-block:: bash
+
+      echo [line 1 of the code] >> ~/.cdsapirc
+      echo [line 2 of the code] >> ~/.cdsapirc
+
+
+  - **Windows**: The process is slightly more complicated. Please refer to the in-depth guide at the Copernicus Knowledge Base `here <https://confluence.ecmwf.int/display/CKB/How+to+install+and+use+CDS+API+on+Windows>`_.
+
+3. Install the CDS API client by opening a terminal/shell and running
+
+.. code-block:: bash
+
+     pip install ".[download]"
+
+(Assuming you are in Geodata's *root directory*.)
+
+1. Once you've installed the API key and the API client, confirm access by running an
+   example in a Python script or a Jupyter notebook:
+
+.. code-block:: python
+
+     import cdsapi
+
+     c = cdsapi.Client()
+
+     c.retrieve(
+          "reanalysis-era5-single-levels",
+          {
+               "product_type": "reanalysis",
+               "format": "netcdf",
+               "variable": [
+                    "2m_dewpoint_temperature",
+                    "2m_temperature",
+               ],
+               "year": "2011",
+               "month": [
+                    "01",
+               ],
+               "day": ["01", "02", "03"],
+               "time": [
+                    "00:00",
+                    "12:00",
+               ],
+          },
+          "download.nc",
+     )
+
+The above example downloads 2m temperature and 2m dewpoint temperature with data points
+at 00:00 and 12:00 for each day, from January 1-3, 2011, in NetCDF format.
+
+If this works, you have successfully set up access to the ERA5 data through the CDS API.
+Please subsequently refer to the `general documentation on datasets <../overview.rst>`_
+for more information on how to download ERA5-based datasets using the ``geodata``
+package.