Examples from the Readme file on retrieving NWIS data

Note

NWIS stands for the National Water Information System

>>> # first import the functions for downloading data from NWIS
>>> import dataretrieval.nwis as nwis

>>> # specify the USGS site code for which we want data.
>>> site = '03339000'

>>> # get instantaneous values (iv)
>>> df = nwis.get_record(sites=site, service='iv', start='2017-12-31', end='2018-01-01')

>>> df.head()
                           00010 00010_cd   site_no  00060 00060_cd  ...  63680_ysi), [discontinued 10/5/21_cd 63680_hach  63680_hach_cd 99133  99133_cd
datetime                                                             ...
2017-12-31 06:00:00+00:00    1.0        A  03339000  140.0        A  ...                                     A        3.6              A  4.61         A
2017-12-31 06:15:00+00:00    1.0        A  03339000  138.0        A  ...                                     A        3.6              A  4.61         A
2017-12-31 06:30:00+00:00    1.0        A  03339000  139.0        A  ...                                     A        3.4              A  4.61         A
2017-12-31 06:45:00+00:00    1.0        A  03339000  139.0        A  ...                                     A        3.4              A  4.61         A
2017-12-31 07:00:00+00:00    1.0        A  03339000  139.0        A  ...                                     A        3.5              A  4.61         A

[5 rows x 21 columns]


>>> # get basic info about the site
>>> df3 = nwis.get_record(sites=site, service='site')

>>> print(df3)
  agency_cd   site_no                         station_nm site_tp_cd  lat_va  long_va  ...  aqfr_cd  aqfr_type_cd well_depth_va hole_depth_va depth_src_cd project_no
0      USGS  03339000  VERMILION RIVER NEAR DANVILLE, IL         ST  400603   873550  ...      NaN           NaN           NaN           NaN          NaN        100

[1 rows x 42 columns]