{
 "cells": [
  {
   "cell_type": "markdown",
   "id": "efdd065e-e9fc-494d-9f73-9cb3d525dc4a",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "source": [
    "## Retrieving fields with polytope"
   ]
  },
  {
   "cell_type": "raw",
   "id": "9a779849-2eb3-4076-ac20-20a6fef63aed",
   "metadata": {
    "editable": true,
    "raw_mimetype": "text/restructuredtext",
    "slideshow": {
     "slide_type": ""
    },
    "tags": [],
    "vscode": {
     "languageId": "raw"
    }
   },
   "source": [
    "The :ref:`polytope <data-sources-polytope>` source provides access to the `Polytope web services <https://polytope.readthedocs.io/en/latest/>`_."
   ]
  },
  {
   "cell_type": "markdown",
   "id": "621c0aa7-db93-441a-ab55-743fa6fbcd51",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "source": [
    "The following example retrieves data from the ECMWF MARS archive using polytope. The dataset was prepared for the OGC GeoDataCubes working group, see details [here](https://github.com/ecmwf/ogc-gdc-usecase/tree/main)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "id": "7910ac60-a503-4392-a719-0b780625346f",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>centre</th>\n",
       "      <th>shortName</th>\n",
       "      <th>typeOfLevel</th>\n",
       "      <th>level</th>\n",
       "      <th>dataDate</th>\n",
       "      <th>dataTime</th>\n",
       "      <th>stepRange</th>\n",
       "      <th>dataType</th>\n",
       "      <th>number</th>\n",
       "      <th>gridType</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>ecmf</td>\n",
       "      <td>z</td>\n",
       "      <td>isobaricInhPa</td>\n",
       "      <td>500</td>\n",
       "      <td>20200915</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>fc</td>\n",
       "      <td>0</td>\n",
       "      <td>sh</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>ecmf</td>\n",
       "      <td>z</td>\n",
       "      <td>isobaricInhPa</td>\n",
       "      <td>500</td>\n",
       "      <td>20200915</td>\n",
       "      <td>0</td>\n",
       "      <td>12</td>\n",
       "      <td>fc</td>\n",
       "      <td>0</td>\n",
       "      <td>sh</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "  centre shortName    typeOfLevel  level  dataDate  dataTime stepRange  \\\n",
       "0   ecmf         z  isobaricInhPa    500  20200915         0         0   \n",
       "1   ecmf         z  isobaricInhPa    500  20200915         0        12   \n",
       "\n",
       "  dataType  number gridType  \n",
       "0       fc       0       sh  \n",
       "1       fc       0       sh  "
      ]
     },
     "execution_count": 1,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "import earthkit.data as ekd\n",
    "\n",
    "request = {\n",
    "    'stream': 'oper',\n",
    "    'levtype': 'pl',\n",
    "    'levellist': '500',\n",
    "    'param': '129.128',\n",
    "    'step': '0/12',\n",
    "    'time': '00',\n",
    "    'date': '20200915',\n",
    "    'type': 'fc',\n",
    "    'class': 'rd',\n",
    "    'expver': 'hsvs',\n",
    "    'domain': 'g'\n",
    "}\n",
    "\n",
    "ds = ekd.from_source(\"polytope\", \"ecmwf-mars\", request, stream=False)\n",
    "ds.ls()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "46115487-af1f-448e-b4fa-fc52dbbf9fb3",
   "metadata": {},
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "dev",
   "language": "python",
   "name": "dev"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.13.1"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}