header_tag.html

Skip to contents

Imports data from USGS site file site. This function gets data from here: https://waterservices.usgs.gov/

Usage

readNWISsite(siteNumbers, override_error = FALSE)

Arguments

siteNumbers

character USGS site number (or multiple sites). This is usually an 8 digit number

override_error

Logical parameter that allows users to run this function during the final stages of NWIS decommission. NWIS servers will be taken offline February 22nd, 2027. Setting this parameter to TRUE should only be used as a tool to convert readNWIS to read_waterdata functions.

Value

A data frame with at least the following columns:

NameTypeDescription
agency_cdcharacterThe NWIS code for the agency reporting the data
site_nocharacterThe USGS site number
station_nmcharacterSite name
site_tp_cdcharacterSite type
lat_vanumericDMS latitude
long_vanumericDMS longitude
dec_lat_vanumericDecimal latitude
dec_long_vanumericDecimal longitude
coord_meth_cdcharacterLatitude-longitude method
coord_acy_cdcharacterLatitude-longitude accuracy
coord_datum_cdcharacterLatitude-longitude datum
dec_coord_datum_cdcharacterDecimal Latitude-longitude datum
district_cdcharacterDistrict code
state_cdcharacterState code
county_cdcharacterCounty code
country_cdcharacterCountry code
land_net_dscharacterLand net location description
map_nmcharacterName of location map
map_scale_fccharacterScale of location map
alt_vanumericAltitude of Gage/land surface
alt_meth_cdcharacterMethod altitude determined
alt_acy_vanumericAltitude accuracy
alt_datum_cdcharacterAltitude datum
huc_cdcharacterHydrologic unit code
basin_cdcharacterDrainage basin code
topo_cdcharacterTopographic setting code
instruments_cdcharacterFlags for instruments at site
construction_dtcharacterDate of first construction
inventory_dtcharacterDate site established or inventoried
drain_area_vanumericDrainage area
contrib_drain_area_vanumericContributing drainage area
tz_cdcharacterTime Zone abbreviation
local_time_fgcharacterSite honors Daylight Savings Time
reliability_cdcharacterData reliability code
gw_file_cdcharacterData-other GW files
nat_aqfr_cdcharacterNational aquifer code
aqfr_cdcharacterLocal aquifer code
aqfr_type_cdcharacterLocal aquifer type code
well_depth_vanumericWell depth
hole_depth_vanumericHole depth
depth_src_cdcharacterSource of depth data
project_nocharacterProject number

There are also several useful attributes attached to the data frame:

NameTypeDescription
urlcharacterThe url used to generate the data
queryTimePOSIXctThe time the data was returned
commentcharacterHeader comments from the RDB file

Examples


# see ?read_waterdata_monitoring_location
# siteINFOMulti <- readNWISsite(c("05114000", "09423350"))