{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "**Developed by:** [Georgii Bocharov](https://github.com/georgebv)\n", "\n", "**E-Mail:** bocharovgeorgii@gmail.com\n", "\n", "**coastlib:** https://github.com/georgebv/coastlib\n", "\n", "**License:** GNU General Public License v3.0\n", "\n", "\n", "# Introduction\n", "This notebook provides examples for the `noaa_ncei` module of the [coastlib](https://github.com/georgebv/coastlib) library. Source code for this module [can be found here](https://github.com/georgebv/coastlib/blob/master/coastlib/data/noaa_ncei.py).\n", "\n", "The `noaa_ncei` module is a part of the `coastlib.data` package. This module provides interface to the [NOAA NCEI](https://www.ncei.noaa.gov/) data portal via the [NCEI Data Service API](https://www.ncei.noaa.gov/support/access-data-service-api-user-documentation). It allows retrieval of environmental data collected by NOAA NCEI sensors such as wind, precipitation, air pressure, etc. in the form of [pandas](https://pandas.pydata.org/) [DataFrame](https://pandas.pydata.org/pandas-docs/stable/reference/api/pandas.DataFrame.html). With the help of this tool one can automate extraction of large amounts of data from NOAA NCEI stations for further processing and storing.\n", "\n", "# Basic Usage\n", "Let's start by extracting hourly wind speed data for the La Guardia and Bethel Airport stations for the October 2012 time period:" ] }, { "cell_type": "code", "execution_count": 1, "metadata": {}, "outputs": [ { "data": { "text/html": [ "
\n", " | \n", " | REPORT_TYPE | \n", "HourlyWindDirection | \n", "LONGITUDE | \n", "ELEVATION | \n", "SOURCE | \n", "HourlyWindSpeed | \n", "LATITUDE | \n", "
---|---|---|---|---|---|---|---|---|
STATION | \n", "DATE | \n", "\n", " | \n", " | \n", " | \n", " | \n", " | \n", " | \n", " |
72503014732 : LA GUARDIA AIRPORT, NY US | \n", "2012-10-01 00:51:00 | \n", "FM-15 | \n", "270 | \n", "-73.88 | \n", "3.4 | \n", "7 | \n", "8 | \n", "40.7792 | \n", "
2012-10-01 01:00:00 | \n", "FM-12 | \n", "270 | \n", "-73.88 | \n", "3.4 | \n", "4 | \n", "8 | \n", "40.7792 | \n", "|
2012-10-01 01:51:00 | \n", "FM-15 | \n", "290 | \n", "-73.88 | \n", "3.4 | \n", "7 | \n", "13 | \n", "40.7792 | \n", "|
2012-10-01 02:51:00 | \n", "FM-15 | \n", "260 | \n", "-73.88 | \n", "3.4 | \n", "7 | \n", "11 | \n", "40.7792 | \n", "|
2012-10-01 03:51:00 | \n", "FM-15 | \n", "250 | \n", "-73.88 | \n", "3.4 | \n", "7 | \n", "10 | \n", "40.7792 | \n", "|
... | \n", "... | \n", "... | \n", "... | \n", "... | \n", "... | \n", "... | \n", "... | \n", "... | \n", "
70219026615 : BETHEL AIRPORT, AK US | \n", "2012-11-01 21:00:00 | \n", "FM-12 | \n", "010 | \n", "-161.8293 | \n", "31.1 | \n", "4 | \n", "19 | \n", "60.785 | \n", "
2012-11-01 21:53:00 | \n", "FM-15 | \n", "010 | \n", "-161.8293 | \n", "31.1 | \n", "7 | \n", "21 | \n", "60.785 | \n", "|
2012-11-01 22:53:00 | \n", "FM-15 | \n", "010 | \n", "-161.8293 | \n", "31.1 | \n", "7 | \n", "25 | \n", "60.785 | \n", "|
2012-11-01 23:53:00 | \n", "FM-15 | \n", "010 | \n", "-161.8293 | \n", "31.1 | \n", "7 | \n", "24 | \n", "60.785 | \n", "|
2012-11-01 23:59:00 | \n", "SOD | \n", "NaN | \n", "-161.8293 | \n", "31.1 | \n", "6 | \n", "NaN | \n", "60.785 | \n", "
2427 rows × 7 columns
\n", "\n", " | \n", " | HourlyWindSpeed | \n", "HourlyWindDirection | \n", "
---|---|---|---|
STATION | \n", "DATE | \n", "\n", " | \n", " |
72503014732 : LA GUARDIA AIRPORT, NY US | \n", "2012-10-01 00:51:00 | \n", "8.0 | \n", "270.0 | \n", "
2012-10-01 01:00:00 | \n", "8.0 | \n", "270.0 | \n", "|
2012-10-01 01:51:00 | \n", "13.0 | \n", "290.0 | \n", "|
2012-10-01 02:51:00 | \n", "11.0 | \n", "260.0 | \n", "|
2012-10-01 03:51:00 | \n", "10.0 | \n", "250.0 | \n", "|
... | \n", "... | \n", "... | \n", "... | \n", "
70219026615 : BETHEL AIRPORT, AK US | \n", "2012-11-01 20:53:00 | \n", "20.0 | \n", "10.0 | \n", "
2012-11-01 21:00:00 | \n", "19.0 | \n", "10.0 | \n", "|
2012-11-01 21:53:00 | \n", "21.0 | \n", "10.0 | \n", "|
2012-11-01 22:53:00 | \n", "25.0 | \n", "10.0 | \n", "|
2012-11-01 23:53:00 | \n", "24.0 | \n", "10.0 | \n", "
2329 rows × 2 columns
\n", "\n", " | \n", " | REPORT_TYPE | \n", "HourlyWindDirection | \n", "LONGITUDE | \n", "ELEVATION | \n", "SOURCE | \n", "HourlyWindSpeed | \n", "LATITUDE | \n", "
---|---|---|---|---|---|---|---|---|
STATION | \n", "DATE | \n", "\n", " | \n", " | \n", " | \n", " | \n", " | \n", " | \n", " |
72503014732 : LA GUARDIA AIRPORT, NY US | \n", "2010-01-01 00:51:00 | \n", "FM-15 | \n", "060 | \n", "-73.88 | \n", "3.4 | \n", "7 | \n", "3 | \n", "40.7792 | \n", "
2010-01-01 01:00:00 | \n", "FM-12 | \n", "060 | \n", "-73.88 | \n", "3.4 | \n", "4 | \n", "3 | \n", "40.7792 | \n", "|
2010-01-01 01:04:00 | \n", "FM-16 | \n", "000 | \n", "-73.88 | \n", "3.4 | \n", "7 | \n", "0 | \n", "40.7792 | \n", "|
2010-01-01 01:37:00 | \n", "FM-16 | \n", "000 | \n", "-73.88 | \n", "3.4 | \n", "7 | \n", "0 | \n", "40.7792 | \n", "|
2010-01-01 01:47:00 | \n", "FM-16 | \n", "000 | \n", "-73.88 | \n", "3.4 | \n", "7 | \n", "0 | \n", "40.7792 | \n", "|
... | \n", "... | \n", "... | \n", "... | \n", "... | \n", "... | \n", "... | \n", "... | \n", "|
2011-01-01 01:51:00 | \n", "FM-15 | \n", "200 | \n", "-73.88 | \n", "3.4 | \n", "7 | \n", "8 | \n", "40.7792 | \n", "|
2011-01-01 02:51:00 | \n", "FM-15 | \n", "200 | \n", "-73.88 | \n", "3.4 | \n", "7 | \n", "6 | \n", "40.7792 | \n", "|
2011-01-01 03:51:00 | \n", "FM-15 | \n", "200 | \n", "-73.88 | \n", "3.4 | \n", "7 | \n", "5 | \n", "40.7792 | \n", "|
2011-01-01 04:00:00 | \n", "FM-12 | \n", "200 | \n", "-73.88 | \n", "3.4 | \n", "4 | \n", "5 | \n", "40.7792 | \n", "|
2011-01-01 04:51:00 | \n", "FM-15 | \n", "180 | \n", "-73.88 | \n", "3.4 | \n", "7 | \n", "3 | \n", "40.7792 | \n", "
13482 rows × 7 columns
\n", "\n", " | \n", " | HourlyWindSpeed | \n", "HourlyWindDirection | \n", "
---|---|---|---|
STATION | \n", "DATE | \n", "\n", " | \n", " |
72503014732 : LA GUARDIA AIRPORT, NY US | \n", "2010-01-01 00:51:00 | \n", "3.0 | \n", "60.0 | \n", "
2010-01-01 01:00:00 | \n", "3.0 | \n", "60.0 | \n", "|
2010-01-01 01:04:00 | \n", "0.0 | \n", "0.0 | \n", "|
2010-01-01 01:37:00 | \n", "0.0 | \n", "0.0 | \n", "|
2010-01-01 01:47:00 | \n", "0.0 | \n", "0.0 | \n", "|
... | \n", "... | \n", "... | \n", "|
2011-01-01 01:51:00 | \n", "8.0 | \n", "200.0 | \n", "|
2011-01-01 02:51:00 | \n", "6.0 | \n", "200.0 | \n", "|
2011-01-01 03:51:00 | \n", "5.0 | \n", "200.0 | \n", "|
2011-01-01 04:00:00 | \n", "5.0 | \n", "200.0 | \n", "|
2011-01-01 04:51:00 | \n", "3.0 | \n", "180.0 | \n", "
12846 rows × 2 columns
\n", "