{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Quick introduction\n",
    "\n",
    "gliderpy can be installed with conda\n",
    "\n",
    "```\n",
    "conda install --channel conda-forge gliderpy\n",
    "```\n",
    "\n",
    "or pip\n",
    "\n",
    "```\n",
    "pip install gliderpy\n",
    "```\n",
    "\n",
    "gliderpy aims to make querying and downloading glider data easier.\n",
    "Here is how one would build a query using erddapy:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-23T19:45:03.903090Z",
     "iopub.status.busy": "2025-05-23T19:45:03.902922Z",
     "iopub.status.idle": "2025-05-23T19:45:07.209298Z",
     "shell.execute_reply": "2025-05-23T19:45:07.208812Z"
    }
   },
   "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>depth (m)</th>\n",
       "      <th>latitude (degrees_north)</th>\n",
       "      <th>longitude (degrees_east)</th>\n",
       "      <th>salinity (1)</th>\n",
       "      <th>temperature (Celsius)</th>\n",
       "      <th>profile_id</th>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>time (UTC)</th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>2016-09-02 17:05:38+00:00</th>\n",
       "      <td>6.43</td>\n",
       "      <td>41.120018</td>\n",
       "      <td>-71.017118</td>\n",
       "      <td>32.079258</td>\n",
       "      <td>20.5407</td>\n",
       "      <td>1</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2016-09-02 17:05:38+00:00</th>\n",
       "      <td>7.82</td>\n",
       "      <td>41.120018</td>\n",
       "      <td>-71.017118</td>\n",
       "      <td>32.095406</td>\n",
       "      <td>20.5071</td>\n",
       "      <td>1</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2016-09-02 17:05:38+00:00</th>\n",
       "      <td>8.69</td>\n",
       "      <td>41.120018</td>\n",
       "      <td>-71.017118</td>\n",
       "      <td>32.111920</td>\n",
       "      <td>20.4904</td>\n",
       "      <td>1</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2016-09-02 17:05:38+00:00</th>\n",
       "      <td>9.54</td>\n",
       "      <td>41.120018</td>\n",
       "      <td>-71.017118</td>\n",
       "      <td>32.126587</td>\n",
       "      <td>20.4897</td>\n",
       "      <td>1</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2016-09-02 17:05:38+00:00</th>\n",
       "      <td>10.32</td>\n",
       "      <td>41.120018</td>\n",
       "      <td>-71.017118</td>\n",
       "      <td>32.140717</td>\n",
       "      <td>20.4909</td>\n",
       "      <td>1</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "                           depth (m)  latitude (degrees_north)  \\\n",
       "time (UTC)                                                       \n",
       "2016-09-02 17:05:38+00:00       6.43                 41.120018   \n",
       "2016-09-02 17:05:38+00:00       7.82                 41.120018   \n",
       "2016-09-02 17:05:38+00:00       8.69                 41.120018   \n",
       "2016-09-02 17:05:38+00:00       9.54                 41.120018   \n",
       "2016-09-02 17:05:38+00:00      10.32                 41.120018   \n",
       "\n",
       "                           longitude (degrees_east)  salinity (1)  \\\n",
       "time (UTC)                                                          \n",
       "2016-09-02 17:05:38+00:00                -71.017118     32.079258   \n",
       "2016-09-02 17:05:38+00:00                -71.017118     32.095406   \n",
       "2016-09-02 17:05:38+00:00                -71.017118     32.111920   \n",
       "2016-09-02 17:05:38+00:00                -71.017118     32.126587   \n",
       "2016-09-02 17:05:38+00:00                -71.017118     32.140717   \n",
       "\n",
       "                           temperature (Celsius)  profile_id  \n",
       "time (UTC)                                                    \n",
       "2016-09-02 17:05:38+00:00                20.5407           1  \n",
       "2016-09-02 17:05:38+00:00                20.5071           1  \n",
       "2016-09-02 17:05:38+00:00                20.4904           1  \n",
       "2016-09-02 17:05:38+00:00                20.4897           1  \n",
       "2016-09-02 17:05:38+00:00                20.4909           1  "
      ]
     },
     "execution_count": 1,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from erddapy import ERDDAP\n",
    "\n",
    "e = ERDDAP(\n",
    "    server=\"https://gliders.ioos.us/erddap\",\n",
    "    protocol=\"tabledap\",\n",
    "    response=\"csv\",\n",
    ")\n",
    "e.dataset_id = \"whoi_406-20160902T1700\"\n",
    "\n",
    "e.variables = [\n",
    "    \"depth\",\n",
    "    \"latitude\",\n",
    "    \"longitude\",\n",
    "    \"salinity\",\n",
    "    \"temperature\",\n",
    "    \"profile_id\",\n",
    "    \"time\",\n",
    "]\n",
    "\n",
    "df = e.to_pandas(\n",
    "    index_col=\"time (UTC)\",\n",
    "    parse_dates=True,\n",
    ")\n",
    "df.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "And here is how to use gliderpy to obtain the same results but with fewer lines and a cleaner code:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-23T19:45:07.237428Z",
     "iopub.status.busy": "2025-05-23T19:45:07.237022Z",
     "iopub.status.idle": "2025-05-23T19:45:12.135732Z",
     "shell.execute_reply": "2025-05-23T19:45:12.135278Z"
    }
   },
   "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>latitude</th>\n",
       "      <th>longitude</th>\n",
       "      <th>pressure</th>\n",
       "      <th>profile_id</th>\n",
       "      <th>salinity</th>\n",
       "      <th>temperature</th>\n",
       "      <th>dataset_url</th>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>time (utc)</th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>2016-09-02 17:05:38</th>\n",
       "      <td>41.120018</td>\n",
       "      <td>-71.017118</td>\n",
       "      <td>6.43</td>\n",
       "      <td>1</td>\n",
       "      <td>32.079258</td>\n",
       "      <td>20.5407</td>\n",
       "      <td>https://gliders.ioos.us/erddap/tabledap/whoi_4...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2016-09-02 17:05:38</th>\n",
       "      <td>41.120018</td>\n",
       "      <td>-71.017118</td>\n",
       "      <td>7.82</td>\n",
       "      <td>1</td>\n",
       "      <td>32.095406</td>\n",
       "      <td>20.5071</td>\n",
       "      <td>https://gliders.ioos.us/erddap/tabledap/whoi_4...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2016-09-02 17:05:38</th>\n",
       "      <td>41.120018</td>\n",
       "      <td>-71.017118</td>\n",
       "      <td>8.69</td>\n",
       "      <td>1</td>\n",
       "      <td>32.111920</td>\n",
       "      <td>20.4904</td>\n",
       "      <td>https://gliders.ioos.us/erddap/tabledap/whoi_4...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2016-09-02 17:05:38</th>\n",
       "      <td>41.120018</td>\n",
       "      <td>-71.017118</td>\n",
       "      <td>9.54</td>\n",
       "      <td>1</td>\n",
       "      <td>32.126587</td>\n",
       "      <td>20.4897</td>\n",
       "      <td>https://gliders.ioos.us/erddap/tabledap/whoi_4...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2016-09-02 17:05:38</th>\n",
       "      <td>41.120018</td>\n",
       "      <td>-71.017118</td>\n",
       "      <td>10.32</td>\n",
       "      <td>1</td>\n",
       "      <td>32.140717</td>\n",
       "      <td>20.4909</td>\n",
       "      <td>https://gliders.ioos.us/erddap/tabledap/whoi_4...</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "                      latitude  longitude  pressure  profile_id   salinity  \\\n",
       "time (utc)                                                                   \n",
       "2016-09-02 17:05:38  41.120018 -71.017118      6.43           1  32.079258   \n",
       "2016-09-02 17:05:38  41.120018 -71.017118      7.82           1  32.095406   \n",
       "2016-09-02 17:05:38  41.120018 -71.017118      8.69           1  32.111920   \n",
       "2016-09-02 17:05:38  41.120018 -71.017118      9.54           1  32.126587   \n",
       "2016-09-02 17:05:38  41.120018 -71.017118     10.32           1  32.140717   \n",
       "\n",
       "                     temperature  \\\n",
       "time (utc)                         \n",
       "2016-09-02 17:05:38      20.5407   \n",
       "2016-09-02 17:05:38      20.5071   \n",
       "2016-09-02 17:05:38      20.4904   \n",
       "2016-09-02 17:05:38      20.4897   \n",
       "2016-09-02 17:05:38      20.4909   \n",
       "\n",
       "                                                           dataset_url  \n",
       "time (utc)                                                              \n",
       "2016-09-02 17:05:38  https://gliders.ioos.us/erddap/tabledap/whoi_4...  \n",
       "2016-09-02 17:05:38  https://gliders.ioos.us/erddap/tabledap/whoi_4...  \n",
       "2016-09-02 17:05:38  https://gliders.ioos.us/erddap/tabledap/whoi_4...  \n",
       "2016-09-02 17:05:38  https://gliders.ioos.us/erddap/tabledap/whoi_4...  \n",
       "2016-09-02 17:05:38  https://gliders.ioos.us/erddap/tabledap/whoi_4...  "
      ]
     },
     "execution_count": 2,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from gliderpy.fetchers import GliderDataFetcher\n",
    "\n",
    "glider_grab = GliderDataFetcher()\n",
    "\n",
    "glider_grab.dataset_ids = [\"whoi_406-20160902T1700\"]\n",
    "dfs = glider_grab.to_pandas()\n",
    "df = dfs[\"whoi_406-20160902T1700\"]\n",
    "df.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Much easier, right?\n",
    "The variable names are standardized by gliderpy,\n",
    "making it easier to fetch from different data sources and comparing the results.\n",
    "\n",
    "The gliderpy library can subset the data on the server side by passing a geographic bounding box and time interval.\n",
    "\n",
    "We can heck the glider metrics with the `.summary()` method."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-23T19:45:12.137669Z",
     "iopub.status.busy": "2025-05-23T19:45:12.137298Z",
     "iopub.status.idle": "2025-05-23T19:45:12.148310Z",
     "shell.execute_reply": "2025-05-23T19:45:12.147899Z"
    }
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "num_profiles                   545\n",
       "days              19 days 00:00:00\n",
       "deployment_lat           41.120018\n",
       "deployment_lon          -71.017118\n",
       "dtype: object"
      ]
     },
     "execution_count": 3,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "df.summary()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Querying multiple datasets\n",
    "\n",
    "The most common use is to search all datasets for data that falls within the certain space-time bounds."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-23T19:45:12.150132Z",
     "iopub.status.busy": "2025-05-23T19:45:12.149745Z",
     "iopub.status.idle": "2025-05-23T19:45:12.408299Z",
     "shell.execute_reply": "2025-05-23T19:45:12.407844Z"
    }
   },
   "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>Title</th>\n",
       "      <th>Institution</th>\n",
       "      <th>Dataset ID</th>\n",
       "      <th>info_url</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>silbo-20110413T1600</td>\n",
       "      <td>Teledyne Webb Research Corporation,Rutgers Uni...</td>\n",
       "      <td>silbo-20110413T1600</td>\n",
       "      <td>https://gliders.ioos.us/erddap/info/silbo-2011...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>6</th>\n",
       "      <td>ru23-20130305T2004</td>\n",
       "      <td>Rutgers University</td>\n",
       "      <td>ru23-20130305T2004</td>\n",
       "      <td>https://gliders.ioos.us/erddap/info/ru23-20130...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>7</th>\n",
       "      <td>ru23-20121025T1944</td>\n",
       "      <td>Rutgers University</td>\n",
       "      <td>ru23-20121025T1944</td>\n",
       "      <td>https://gliders.ioos.us/erddap/info/ru23-20121...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>8</th>\n",
       "      <td>silbo-20110623T1215</td>\n",
       "      <td>Teledyne Webb Research Corporation,Rutgers Uni...</td>\n",
       "      <td>silbo-20110623T1215</td>\n",
       "      <td>https://gliders.ioos.us/erddap/info/silbo-2011...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>9</th>\n",
       "      <td>silbo-20120724T1247</td>\n",
       "      <td>Teledyne Webb Research Corporation,Rutgers Uni...</td>\n",
       "      <td>silbo-20120724T1247</td>\n",
       "      <td>https://gliders.ioos.us/erddap/info/silbo-2012...</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "                 Title                                        Institution  \\\n",
       "0  silbo-20110413T1600  Teledyne Webb Research Corporation,Rutgers Uni...   \n",
       "6   ru23-20130305T2004                                 Rutgers University   \n",
       "7   ru23-20121025T1944                                 Rutgers University   \n",
       "8  silbo-20110623T1215  Teledyne Webb Research Corporation,Rutgers Uni...   \n",
       "9  silbo-20120724T1247  Teledyne Webb Research Corporation,Rutgers Uni...   \n",
       "\n",
       "            Dataset ID                                           info_url  \n",
       "0  silbo-20110413T1600  https://gliders.ioos.us/erddap/info/silbo-2011...  \n",
       "6   ru23-20130305T2004  https://gliders.ioos.us/erddap/info/ru23-20130...  \n",
       "7   ru23-20121025T1944  https://gliders.ioos.us/erddap/info/ru23-20121...  \n",
       "8  silbo-20110623T1215  https://gliders.ioos.us/erddap/info/silbo-2011...  \n",
       "9  silbo-20120724T1247  https://gliders.ioos.us/erddap/info/silbo-2012...  "
      ]
     },
     "execution_count": 4,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "glider_grab = GliderDataFetcher()\n",
    "\n",
    "df = glider_grab.query(\n",
    "    min_lat=10,\n",
    "    max_lat=40,\n",
    "    min_lon=-90,\n",
    "    max_lon=8,\n",
    "    min_time=\"2010-01-01\",\n",
    "    max_time=\"2013-06-02\",\n",
    ")\n",
    "df"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-23T19:45:12.409880Z",
     "iopub.status.busy": "2025-05-23T19:45:12.409714Z",
     "iopub.status.idle": "2025-05-23T19:46:06.824002Z",
     "shell.execute_reply": "2025-05-23T19:46:06.823509Z"
    }
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "dict_keys(['silbo-20110413T1600', 'ru23-20130305T2004', 'ru23-20121025T1944', 'silbo-20110623T1215', 'silbo-20120724T1247'])"
      ]
     },
     "execution_count": 5,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "datasets = glider_grab.to_pandas()\n",
    "datasets.keys()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-23T19:46:06.825592Z",
     "iopub.status.busy": "2025-05-23T19:46:06.825426Z",
     "iopub.status.idle": "2025-05-23T19:46:06.832563Z",
     "shell.execute_reply": "2025-05-23T19:46:06.832173Z"
    }
   },
   "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>latitude</th>\n",
       "      <th>longitude</th>\n",
       "      <th>pressure</th>\n",
       "      <th>profile_id</th>\n",
       "      <th>salinity (1e-3)</th>\n",
       "      <th>temperature</th>\n",
       "      <th>dataset_url</th>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>time (utc)</th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>2012-10-27 18:20:25</th>\n",
       "      <td>39.999821</td>\n",
       "      <td>-73.510566</td>\n",
       "      <td>1.67</td>\n",
       "      <td>289</td>\n",
       "      <td>31.973030</td>\n",
       "      <td>16.9787</td>\n",
       "      <td>https://gliders.ioos.us/erddap/tabledap/ru23-2...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2012-10-27 18:20:25</th>\n",
       "      <td>39.999821</td>\n",
       "      <td>-73.510566</td>\n",
       "      <td>1.68</td>\n",
       "      <td>289</td>\n",
       "      <td>31.973806</td>\n",
       "      <td>16.9775</td>\n",
       "      <td>https://gliders.ioos.us/erddap/tabledap/ru23-2...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2012-10-27 18:20:25</th>\n",
       "      <td>39.999821</td>\n",
       "      <td>-73.510566</td>\n",
       "      <td>NaN</td>\n",
       "      <td>289</td>\n",
       "      <td>NaN</td>\n",
       "      <td>NaN</td>\n",
       "      <td>https://gliders.ioos.us/erddap/tabledap/ru23-2...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2012-10-27 18:20:25</th>\n",
       "      <td>39.999821</td>\n",
       "      <td>-73.510566</td>\n",
       "      <td>1.82</td>\n",
       "      <td>289</td>\n",
       "      <td>31.973087</td>\n",
       "      <td>16.9778</td>\n",
       "      <td>https://gliders.ioos.us/erddap/tabledap/ru23-2...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2012-10-27 18:20:25</th>\n",
       "      <td>39.999821</td>\n",
       "      <td>-73.510566</td>\n",
       "      <td>NaN</td>\n",
       "      <td>289</td>\n",
       "      <td>NaN</td>\n",
       "      <td>NaN</td>\n",
       "      <td>https://gliders.ioos.us/erddap/tabledap/ru23-2...</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "                      latitude  longitude  pressure  profile_id  \\\n",
       "time (utc)                                                        \n",
       "2012-10-27 18:20:25  39.999821 -73.510566      1.67         289   \n",
       "2012-10-27 18:20:25  39.999821 -73.510566      1.68         289   \n",
       "2012-10-27 18:20:25  39.999821 -73.510566       NaN         289   \n",
       "2012-10-27 18:20:25  39.999821 -73.510566      1.82         289   \n",
       "2012-10-27 18:20:25  39.999821 -73.510566       NaN         289   \n",
       "\n",
       "                     salinity (1e-3)  temperature  \\\n",
       "time (utc)                                          \n",
       "2012-10-27 18:20:25        31.973030      16.9787   \n",
       "2012-10-27 18:20:25        31.973806      16.9775   \n",
       "2012-10-27 18:20:25              NaN          NaN   \n",
       "2012-10-27 18:20:25        31.973087      16.9778   \n",
       "2012-10-27 18:20:25              NaN          NaN   \n",
       "\n",
       "                                                           dataset_url  \n",
       "time (utc)                                                              \n",
       "2012-10-27 18:20:25  https://gliders.ioos.us/erddap/tabledap/ru23-2...  \n",
       "2012-10-27 18:20:25  https://gliders.ioos.us/erddap/tabledap/ru23-2...  \n",
       "2012-10-27 18:20:25  https://gliders.ioos.us/erddap/tabledap/ru23-2...  \n",
       "2012-10-27 18:20:25  https://gliders.ioos.us/erddap/tabledap/ru23-2...  \n",
       "2012-10-27 18:20:25  https://gliders.ioos.us/erddap/tabledap/ru23-2...  "
      ]
     },
     "execution_count": 6,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "datasets[\"ru23-20121025T1944\"].head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Dataset search\n",
    "\n",
    "One can query all dataset_ids available in the server."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-23T19:46:06.834097Z",
     "iopub.status.busy": "2025-05-23T19:46:06.833937Z",
     "iopub.status.idle": "2025-05-23T19:46:07.406796Z",
     "shell.execute_reply": "2025-05-23T19:46:07.406385Z"
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "found 1451 glider datasets on https://gliders.ioos.us/erddap.\n"
     ]
    }
   ],
   "source": [
    "from gliderpy.fetchers import DatasetList\n",
    "\n",
    "datasets = DatasetList()\n",
    "ds_ids = datasets.get_ids()\n",
    "\n",
    "print(f\"found {len(ds_ids)} glider datasets on {datasets.e.server}.\")"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3 (ipykernel)",
   "language": "python",
   "name": "python3"
  },
  "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.3"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 4
}