Command Line¶
Help:
tsgettoolbox --help
about¶
$ tsgettoolbox about --help
usage: tsgettoolbox about [-h]
Print out information about tsgettoolbox and the system.
options:
-h, --help show this help message and exit
cdec¶
$ tsgettoolbox cdec --help
usage: tsgettoolbox cdec [-h] [--dur_code DUR_CODE] [--sensor_num SENSOR_NUM]
[--start_date START_DATE] [--end_date END_DATE] station_id
The primary function of the California Data Exchange Center (CDEC) is to
facilitate the collection, storage, and exchange of hydrologic and climate
information to support real-time flood management and water supply needs in
California.
California Department of Water Resources: <[4;36mhttp://www.water.ca.gov/[0m> California
Data Exchange Center: <[4;36mhttp://cdec.water.ca.gov[0m>
Downloads data for a set of CDEC station and sensor ids. If either is not
provided, all available data will be downloaded.
positional arguments:
station_id [optional, default is None]
Each string is the CDEC station ID and consist of three capital letters.
options:
-h | --help
show this help message and exit
--dur_code DUR_CODE
[optional, default is None]
Possible values are 'E', 'H', 'D', and 'M' but not all of these time
resolutions are available at every station.
┌──────────┬─────────────┐
│ dur_code │ Description │
╞══════════╪═════════════╡
│ E │ event │
├──────────┼─────────────┤
│ H │ hourly │
├──────────┼─────────────┤
│ D │ daily │
├──────────┼─────────────┤
│ M │ monthly │
╘══════════╧═════════════╛
--sensor_num SENSOR_NUM
[optional, default is None]
If None will get all sensors at station_id.
SELECTED CDEC SENSOR NUMBERS (these are not available for all sites):
┌────────────┬───────────────────────────────────────────┐
│ sensor_num │ Description │
╞════════════╪═══════════════════════════════════════════╡
│ 1 │ river stage [ft] │
├────────────┼───────────────────────────────────────────┤
│ 2 │ precipitation accumulated [in] │
├────────────┼───────────────────────────────────────────┤
│ 3 │ SWE [in] │
├────────────┼───────────────────────────────────────────┤
│ 4 │ air temperature [F] │
├────────────┼───────────────────────────────────────────┤
│ 5 │ EC [ms/cm] │
├────────────┼───────────────────────────────────────────┤
│ 6 │ reservoir elevation [ft] │
├────────────┼───────────────────────────────────────────┤
│ 7 │ reservoir scheduled release [cfs] │
├────────────┼───────────────────────────────────────────┤
│ 8 │ full natural flow [cfs] │
├────────────┼───────────────────────────────────────────┤
│ 15 │ reservoir storage [af] │
├────────────┼───────────────────────────────────────────┤
│ 20 │ flow -- river discharge [cfs] │
├────────────┼───────────────────────────────────────────┤
│ 22 │ reservoir storage change [af] │
├────────────┼───────────────────────────────────────────┤
│ 23 │ reservoir outflow [cfs] │
├────────────┼───────────────────────────────────────────┤
│ 24 │ Evapotranspiration [in] │
├────────────┼───────────────────────────────────────────┤
│ 25 │ water temperature [F] │
├────────────┼───────────────────────────────────────────┤
│ 27 │ water turbidity [ntu] │
├────────────┼───────────────────────────────────────────┤
│ 28 │ chlorophyll [ug/l] │
├────────────┼───────────────────────────────────────────┤
│ 41 │ flow -- mean daily [cfs] │
├────────────┼───────────────────────────────────────────┤
│ 45 │ precipitation incremental [in] │
├────────────┼───────────────────────────────────────────┤
│ 46 │ runoff volume [af] │
├────────────┼───────────────────────────────────────────┤
│ 61 │ water dissolved oxygen [mg/l] │
├────────────┼───────────────────────────────────────────┤
│ 62 │ water pH value [pH] │
├────────────┼───────────────────────────────────────────┤
│ 64 │ pan evaporation (incremental) [in] │
├────────────┼───────────────────────────────────────────┤
│ 65 │ full natural flow [af] │
├────────────┼───────────────────────────────────────────┤
│ 66 │ flow -- monthly volume [af] │
├────────────┼───────────────────────────────────────────┤
│ 67 │ accretions (estimated) [af] │
├────────────┼───────────────────────────────────────────┤
│ 71 │ spillway discharge [cfs] │
├────────────┼───────────────────────────────────────────┤
│ 74 │ lake evaporation (computed) [cfs] │
├────────────┼───────────────────────────────────────────┤
│ 76 │ reservoir inflow [cfs] │
├────────────┼───────────────────────────────────────────┤
│ 85 │ control regulating discharge [cfs] │
├────────────┼───────────────────────────────────────────┤
│ 94 │ top conservation storage (reservoir) [af] │
├────────────┼───────────────────────────────────────────┤
│ 100 │ water EC [us/cm] │
╘════════════╧═══════════════════════════════════════════╛
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
coops¶
$ tsgettoolbox coops --help
usage: tsgettoolbox coops [-h] [--date DATE] [--begin_date BEGIN_DATE]
[--end_date END_DATE] [--range RANGE] [--product PRODUCT] [--datum DATUM]
[--time_zone TIME_ZONE] [--interval INTERVAL] [--bin BIN] station
CO-OPS web services is at <[4;36mhttps://tidesandcurrents.noaa.gov/api/[0m>. The time
zone of the returned data depends on the setting of the "time_zone" option. The
default is "GMT" also known as "UTC".
positional arguments:
station A 7 character station ID, or a currents station ID.
Station listings for various products can be viewed at
<[4;36mhttps://tidesandcurrents.noaa.gov[0m> or viewed on a map at Tides &
Currents Station Map
options:
-h | --help
show this help message and exit
--date DATE
[optional, default is None]
The API understands several parameters related to date ranges. Date
formats are pretty flexible, however the closer to ISO 8601, the
better.
The date related options are 'begin_date', 'end_date', 'date', and
'range'. They can be combined in the following 5 ways, but if
conflicting then follows the table in order. For example, the 'date'
option will be used if present regardless of any other option, then
'range', ...etc.:
┌───────────────────┬─────────────────────────────────────────────────┐
│ Parameter Name(s) │ Description │
╞═══════════════════╪═════════════════════════════════════════════════╡
│ date │ 'latest', 'today', or 'recent' │
├───────────────────┼─────────────────────────────────────────────────┤
│ range │ Specify a number of hours to go back from now │
│ │ and retrieve data for that date range │
├───────────────────┼─────────────────────────────────────────────────┤
│ begin_date and │ Specify a begin date and a number of hours to │
│ range │ retrieve data starting from that date │
├───────────────────┼─────────────────────────────────────────────────┤
│ begin_date and │ Specify the date/time range of retrieval │
│ end_date │ │
├───────────────────┼─────────────────────────────────────────────────┤
│ end_date and │ Specify an end date and a number of hours to │
│ range │ retrieve data ending at that date │
╘═══════════════════╧═════════════════════════════════════════════════╛
┌──────────────────────────────────────┬─────────────────┐
│ Description of "--date" option │ Option │
╞══════════════════════════════════════╪═════════════════╡
│ Today's data │ --date='today' │
├──────────────────────────────────────┼─────────────────┤
│ The last 3 days of data │ --date='recent' │
├──────────────────────────────────────┼─────────────────┤
│ The last data point available within │ --date='latest' │
│ the last 18 minutes. │ │
╘══════════════════════════════════════╧═════════════════╛
--begin_date BEGIN_DATE
[optional, default is None]
The beginning date for the data. See explanation with the 'date' option on
how to use all of the date related parameters.
--end_date END_DATE
[optional, default is None]
The end date for the data. January 1st, 2012 through January 2nd, 2012:
--begin_date='20120101' --end_date='20120102'
See explanation with the 'date' option on how to use all of the date
related parameters.
--range RANGE
[optional, default is None]
Specify the number of hours to go back from now, an 'end_date', or forward
from a 'begin_date'.
48 hours beginning on April 15, 2012:
--begin_date='20120415' --range=48
48 hours ending on March 17, 2012:
--end_date='20120307' --range=48
The last 24 hours from now:
--range=24
The last 3 hours from now:
--range=3
See explanation with the 'date' option on how to use all of the date
related parameters.
--product PRODUCT
[optional, default is 'hourly_height']
Specify the observation requested.
┌────────────────────────┬────────────────────────────────────────────┐
│ Option │ Description │
╞════════════════════════╪════════════════════════════════════════════╡
│ water_level │ Six minute preliminary or verified water │
│ │ levels, depending on availability. │
├────────────────────────┼────────────────────────────────────────────┤
│ air_temperature │ Air temperature │
├────────────────────────┼────────────────────────────────────────────┤
│ water_temperature │ Water temperature │
├────────────────────────┼────────────────────────────────────────────┤
│ wind │ Wind speed, direction, and gusts │
├────────────────────────┼────────────────────────────────────────────┤
│ air_gap │ (distance between a bridge and the water's │
│ │ surface) │
├────────────────────────┼────────────────────────────────────────────┤
│ conductivity │ The water's conductivity │
├────────────────────────┼────────────────────────────────────────────┤
│ visibility │ Visibility from the station's visibility │
│ │ sensor. A measure of atmospheric clarity. │
├────────────────────────┼────────────────────────────────────────────┤
│ humidity │ Relative humidity │
├────────────────────────┼────────────────────────────────────────────┤
│ salinity │ Salinity and specific gravity │
├────────────────────────┼────────────────────────────────────────────┤
│ hourly_height │ Verified hourly height water level data │
├────────────────────────┼────────────────────────────────────────────┤
│ high_low │ Verified high/low water level data │
├────────────────────────┼────────────────────────────────────────────┤
│ daily_mean │ Verified daily mean water level data │
├────────────────────────┼────────────────────────────────────────────┤
│ monthly_mean │ Verified monthly mean water level data │
├────────────────────────┼────────────────────────────────────────────┤
│ one_minute_water_level │ One minute water level data │
├────────────────────────┼────────────────────────────────────────────┤
│ predictions │ Six minute predictions water level data │
├────────────────────────┼────────────────────────────────────────────┤
│ datums │ datums data │
├────────────────────────┼────────────────────────────────────────────┤
│ currents │ Currents data │
╘════════════════════════╧════════════════════════════════════════════╛
The returned data for each "product" documented below is derived from
<[4;36mhttps://api.tidesandcurrents.noaa.gov/api/prod/responseHelp.html[0m>
product = "water_level"
┌─────────────────────────────┬───────────────────────────────────────┐
│ tsgettoolbox Column Name │ Description │
╞═════════════════════════════╪═══════════════════════════════════════╡
│ water_level:{units} │ Measurement │
├─────────────────────────────┼───────────────────────────────────────┤
│ water_level_sigma:{units} │ Standard deviation of 1 second │
│ │ samples used to compute the water │
├─────────────────────────────┼─level height──────────────────────────┤
│ water_level_CntSigma OR │ if preliminary Count of number of 1 │
│ water_level_Inferred │ second that falls outside a 3-sigma │
│ │ band about the mean if verified A │
│ │ flag that when set to 1 indicates │
│ │ that the water level value has been │
├─────────────────────────────┼─inferred──────────────────────────────┤
│ water_level_FlatTol │ A flag that when set to 1 indicates │
│ │ that the flat tolerance limit was │
│ │ exceeded │
├─────────────────────────────┼───────────────────────────────────────┤
│ water_level_RateTol │ A flag that when set to 1 indicates │
│ │ that the rate of change tolerance │
│ │ limit was exceeded │
├─────────────────────────────┼───────────────────────────────────────┤
│ water_level_LimitTol OR │ if preliminary A flag that when set │
│ water_level_TempRateTol │ to 1 indicates that either the │
│ │ maximum or minimum expected value was │
│ │ exceeded if verified A flag that when │
│ │ set to 1 indicates that the rate of │
│ │ change in temperature tolerance limit │
│ │ was exceeded │
├─────────────────────────────┼───────────────────────────────────────┤
│ water_level_quality:{units} │ Quality Assurance/Quality Control "p" │
│ │ = preliminary "v" = verified │
╘═════════════════════════════╧═══════════════════════════════════════╛
product = "air_pressure", "air_temperature", "humidity",
"water_temperature", or "conductivity"
┌───────────────────┬─────────────────────────────────────────────────┐
│ tsgettoolbox │ Description │
│ Column Name │ │
╞═══════════════════╪═════════════════════════════════════════════════╡
│ {product}:{units} │ Measurement │
├───────────────────┼─────────────────────────────────────────────────┤
│ {product}_MaxTol │ A flag that when set to 1 indicates that the │
│ │ maximum expected value was exceeded │
├───────────────────┼─────────────────────────────────────────────────┤
│ {product}_MinTol │ A flag that when set to 1 indicates that the │
│ │ minimum expected value was exceeded │
├───────────────────┼─────────────────────────────────────────────────┤
│ {product}_RateTol │ A flag that when set to 1 indicates that the │
│ │ rate of change tolerance limit was exceeded │
╘═══════════════════╧═════════════════════════════════════════════════╛
Hourly Height: product = "hourly_height"
┌─────────────────────────────┬───────────────────────────────────────┐
│ tsgettoolbox Column Name │ Description │
╞═════════════════════════════╪═══════════════════════════════════════╡
│ hourly_height:{units} │ Value - Measured water level height │
├─────────────────────────────┼───────────────────────────────────────┤
│ hourly_height_sigma:{units} │ Sigma - Standard deviation of 1 │
│ │ second samples used to compute the │
│ │ water level height │
├─────────────────────────────┼───────────────────────────────────────┤
│ hourly_height_Inferred │ A flag that when set to 1 indicates │
│ │ that the water level value has been │
│ │ inferred │
├─────────────────────────────┼───────────────────────────────────────┤
│ hourly_height_LimitTol │ A flag that when set to 1 indicates │
│ │ that either the maximum or minimum │
│ │ expected value was exceeded │
╘═════════════════════════════╧═══════════════════════════════════════╛
High Low: product = "high_low"
┌───────────────────┬─────────────────────────────────────────────────┐
│ tsgettoolbox │ Description │
│ Column Name │ │
╞═══════════════════╪═════════════════════════════════════════════════╡
│ high_low:{units} │ Value - Measured water level height │
├───────────────────┼─────────────────────────────────────────────────┤
│ high_low_Type │ Type - Designation of Water level height. HH = │
│ │ Higher High water H = High water L = Low water │
│ │ LL = Lower Low water │
├───────────────────┼─────────────────────────────────────────────────┤
│ high_low_Inferred │ A flag that when set to 1 indicates that the │
│ │ water level value has been inferred │
├───────────────────┼─────────────────────────────────────────────────┤
│ high_low_LimitTol │ A flag that when set to 1 indicates that either │
│ │ the maximum or minimum expected value was │
│ │ exceeded │
╘═══════════════════╧═════════════════════════════════════════════════╛
Daily Mean: product = "daily_mean"
┌─────────────────────┬───────────────────────────────────────────────┐
│ tsgettoolbox Column │ Description │
│ Name │ │
╞═════════════════════╪═══════════════════════════════════════════════╡
│ daily_mean:{units} │ Value – Mean hourly data over a 24 hour │
├─────────────────────┼─period────────────────────────────────────────┤
│ daily_mean_Inferred │ A flag that when set to 1 indicates that the │
│ │ water level value has been inferred │
├─────────────────────┼───────────────────────────────────────────────┤
│ daily_mean_LimitTol │ A flag that when set to 1 indicates that │
│ │ either the maximum or minimum expected value │
│ │ was exceeded │
╘═════════════════════╧═══════════════════════════════════════════════╛
Monthly Mean: product = "monthly_mean"
┌──────────────┬──────────────────────────────────────────────────────┐
│ tsgettoolbox │ Description │
│ Column Name │ │
╞══════════════╪══════════════════════════════════════════════════════╡
│ year │ Year │
├──────────────┼──────────────────────────────────────────────────────┤
│ month │ Month │
├──────────────┼──────────────────────────────────────────────────────┤
│ highest │ Highest Tide │
├──────────────┼──────────────────────────────────────────────────────┤
│ MHHW │ Mean Higher-High Water │
├──────────────┼──────────────────────────────────────────────────────┤
│ MHW │ Mean High Water │
├──────────────┼──────────────────────────────────────────────────────┤
│ MSL │ Mean Sea Level │
├──────────────┼──────────────────────────────────────────────────────┤
│ MTL │ Mean Tide Level │
├──────────────┼──────────────────────────────────────────────────────┤
│ MLW │ Mean Low Water │
├──────────────┼──────────────────────────────────────────────────────┤
│ MLLW │ Mean Lower-Low Water │
├──────────────┼──────────────────────────────────────────────────────┤
│ DTL │ Mean Diurnal Tide Level │
├──────────────┼──────────────────────────────────────────────────────┤
│ GT │ Great Diurnal Range │
├──────────────┼──────────────────────────────────────────────────────┤
│ MN │ Mean Range of Tide │
├──────────────┼──────────────────────────────────────────────────────┤
│ DHQ │ Mean Diurnal High Water Inequality │
├──────────────┼──────────────────────────────────────────────────────┤
│ DLQ │ Mean Diurnal Low Water Inequality │
├──────────────┼──────────────────────────────────────────────────────┤
│ HWI │ Greenwich High Water Interval (in Hours) │
├──────────────┼──────────────────────────────────────────────────────┤
│ LWI │ Greenwich Low Water Interval (in Hours) │
├──────────────┼──────────────────────────────────────────────────────┤
│ lowest │ Lowest Tide │
├──────────────┼──────────────────────────────────────────────────────┤
│ inferred │ A flag that when set to 1 indicates that the water │
│ │ level value has been inferred │
╘══════════════╧══════════════════════════════════════════════════════╛
One Minute Water Level: product = "one_minute_water_level"
┌────────────────────────────────┬────────────────────────────────────┐
│ tsgettoolbox Column Name │ Description │
╞════════════════════════════════╪════════════════════════════════════╡
│ one_minute_water_level:{units} │ Value - Measured water level │
╘════════════════════════════════╧═height═════════════════════════════╛
Tide Predictions: product = "predictions"
┌─────────────────────┬──────────────────────────────────────┐
│ tsgettoolbox Column │ Description │
│ Name │ │
╞═════════════════════╪══════════════════════════════════════╡
│ predictions:{units} │ Value - Predicted water level height │
╘═════════════════════╧══════════════════════════════════════╛
Air Gap: product = "air_gap"
┌───────────────────────┬─────────────────────────────────────────────┐
│ tsgettoolbox Column │ Description │
│ Name │ │
╞═══════════════════════╪═════════════════════════════════════════════╡
│ air_gap:{units} │ Value - Measured air gap │
├───────────────────────┼─────────────────────────────────────────────┤
│ air_gap_sigma:{units} │ Sigma - Standard deviation of 1 second │
│ │ samples used to compute the air gap │
├───────────────────────┼─────────────────────────────────────────────┤
│ air_gap_CntSigma │ Count of number of 1 second that falls │
│ │ outside a 3-sigma band about the mean │
├───────────────────────┼─────────────────────────────────────────────┤
│ air_gap_FlatTol │ A flag that when set to 1 indicates that │
│ │ the flat tolerance limit was exceeded │
├───────────────────────┼─────────────────────────────────────────────┤
│ air_gap_RateTol │ A flag that when set to 1 indicates that │
│ │ the rate of change tolerance limit was │
├───────────────────────┼─exceeded────────────────────────────────────┤
│ air_gap_MinMaxTol │ A flag that when set to 1 indicates that │
│ │ either the maximum or minimum expected air │
│ │ gap limit was exceeded │
╘═══════════════════════╧═════════════════════════════════════════════╛
Wind: product = "wind"
┌────────────────────────┬────────────────────────────────────────────┐
│ tsgettoolbox Column │ Description │
╞═Name═══════════════════╪════════════════════════════════════════════╡
│ wind_speed:{units} │ Speed - Measured wind speed │
├────────────────────────┼────────────────────────────────────────────┤
│ wind_direction:degrees │ Direction - wind direction in degrees │
├────────────────────────┼────────────────────────────────────────────┤
│ wind_direction:text │ Direction - wind direction in text │
├────────────────────────┼────────────────────────────────────────────┤
│ wind_gust:{units} │ Gust - Measured wind gust speed │
├────────────────────────┼────────────────────────────────────────────┤
│ wind{suffix} │ Data Flags - in order of listing "X,R" │
│ │ Flags described above │
╘════════════════════════╧════════════════════════════════════════════╛
Visibility: product = "visibility"
┌────────────────────┬─────────────────────────────┐
│ tsgettoolbox │ Description │
│ Column Name │ │
╞════════════════════╪═════════════════════════════╡
│ visibility:{units} │ Value - Measured visibility │
╘════════════════════╧═════════════════════════════╛
Salinity: product = "salinity"
┌──────────────────┬──────────────────┐
│ tsgettoolbox │ Description │
│ Column Name │ │
╞══════════════════╪══════════════════╡
│ salinity:{units} │ Salinity │
├──────────────────┼──────────────────┤
│ specific_gravity │ Specific Gravity │
╘══════════════════╧══════════════════╛
Currents: product = "currents"
┌────────────────────────────┬────────────────────────────────────────┐
│ tsgettoolbox Column Name │ Description │
╞════════════════════════════╪════════════════════════════════════════╡
│ currents_speed:{units} │ Speed - Measured current speed │
├────────────────────────────┼────────────────────────────────────────┤
│ currents_direction:degrees │ Direction - current direction in │
├────────────────────────────┼─degrees────────────────────────────────┤
│ currents_bin_number │ Bin number │
╘════════════════════════════╧════════════════════════════════════════╛
--datum DATUM
[optional, default is 'NAVD']
Specify the datum that all water levels will be reported against. Note!
Datum is mandatory for all water level products and defaults to
"NAVD".
┌────────┬───────────────────────────────┐
│ Option │ Description │
╞════════╪═══════════════════════════════╡
│ MHHW │ Mean Higher High Water │
├────────┼───────────────────────────────┤
│ MHW │ Mean High Water │
├────────┼───────────────────────────────┤
│ MTL │ Mean Tide Level │
├────────┼───────────────────────────────┤
│ MSL │ Mean Sea Level │
├────────┼───────────────────────────────┤
│ MLW │ Mean Low Water │
├────────┼───────────────────────────────┤
│ MLLW │ Mean Lower Low Water │
├────────┼───────────────────────────────┤
│ NAVD │ North American Vertical Datum │
├────────┼───────────────────────────────┤
│ STND │ Station Datum │
╘════════╧═══════════════════════════════╛
--time_zone TIME_ZONE
[optional, default is 'GMT']
The time zone is specified as 'gmt', 'lst' or 'lst_ldt'.
┌─────────┬───────────────────────────────────────────────────────────┐
│ Option │ Description │
╞═════════╪═══════════════════════════════════════════════════════════╡
│ gmt │ Greenwich Mean Time │
├─────────┼───────────────────────────────────────────────────────────┤
│ lst │ Local Standard Time. The time local to the requested │
│ │ station. │
├─────────┼───────────────────────────────────────────────────────────┤
│ lst_ldt │ Local Standard/Local Daylight Time. The time local to the │
│ │ requested station. │
╘═════════╧═══════════════════════════════════════════════════════════╛
--interval INTERVAL
[optional, defaults to 'h']
Deliver the meteorological and prediction data at hourly intervals. Does
not override 6 minute intervals for --product='water_level' or 1
minute intervals for --product='one_minute_water_level'.
┌────────┬───────────────────────────────────────────────┐
│ Option │ Description │
╞════════╪═══════════════════════════════════════════════╡
│ h │ Hourly meteorological data │
├────────┼───────────────────────────────────────────────┤
│ hilo │ High/low predictions for subordinate stations │
╘════════╧═══════════════════════════════════════════════╛
--bin BIN
[optional, defaults to None]
The bin number for the specified currents station Example:'--bin=4' Will
retrieve data for bin number 4. Note! If a bin is not specified for
a PORTS station, the data is returned using a predefined real-time
bin.
cpc¶
$ tsgettoolbox cpc --help
usage: tsgettoolbox cpc [-h] [--state STATE]
[--climate_division CLIMATE_DIVISION] [--start_date START_DATE] [--end_date
END_DATE]
Climate Prediction Center:
www.cpc.ncep.noaa.gov
Weekly Drought Index:
www.cpc.ncep.noaa.gov/products/analysis_monitoring/cdus/palmer_drought
The climate_division integer value identifies a portion of the desired state
divided along county boundaries. Maps of the climate divisions within each state
are at:
www.cpc.ncep.noaa.gov/products/analysis_monitoring/regional_monitoring/CLIM_DIV-
S/states_counties_climate-divisions.shtml
The only way to get a time-series is to specify both state and climate_division
keywords.
Command Line
tsgettoolbox cpc --state=FL --climate_division=1 --start_date 2017-01-01
Python API
df = tsgettoolbox.cpc(state="FL",
climate_division=1,
start_date="2017-01-01",
end_date="2017-02-01")
options:
-h | --help
show this help message and exit
--state STATE
[optional]
If specified, results will be limited to the state corresponding to the
given 2-character state code.
--climate_division CLIMATE_DIVISION
[optional]
If specified, results will be limited to the climate division.
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
daymet¶
$ tsgettoolbox daymet --help
usage: tsgettoolbox daymet [-h] [--start_date START_DATE]
[--end_date END_DATE] [--years YEARS] [--measuredParams MEASUREDPARAMS]
[--time_scale TIME_SCALE] [--snow] lat lon
Detailed documentation is at <[4;36mhttp://daymet.ornl.gov/[0m>. Since this is daily
data, it covers midnight to midnight based on local time.
positional arguments:
lat Latitude (required): Enter single geographic point by latitude, value
between 52.0N and 14.5N.:
Example: --lat=43.1
lon Longitude (required): Enter single geographic point by longitude, value
between -131.0W and -53.0W.:
Example: --lon=-85.3
options:
-h | --help
show this help message and exit
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning. For North America and Hawaii, the earliest date is
1980-01-01. For Puerto Rico, the earliest date it 1950-01-01.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end. The
latest end date is usually 12-31 of the previous calendar year,
though this is dependent on time required to process that data.
--years YEARS
Current Daymet product is available from 1980 to the latest full calendar
year.:
Example: --years=2012,2014
This overrides the start_date and end_date options.
--measuredParams MEASUREDPARAMS
[optional, defaults to "all"]
Use the abbreviations from the following table:
┌───────────────────┬─────────────────────────┬─────────┬─────────────┐
│ measuredParams │ Description │ Unit │ time_scale │
╞═══════════════════╪═════════════════════════╪═════════╪═════════════╡
│ prcp │ precipitation │ mm │ daily │
│ │ │ │ monthly │
├───────────────────┼─────────────────────────┼─────────┼─annual──────┤
│ swe │ snow-water equivalent │ kg/m2 │ daily │
│ │ │ │ monthly │
├───────────────────┼─────────────────────────┼─────────┼─annual──────┤
│ tmax │ maximum temperature │ degC │ daily │
│ │ │ │ monthly │
├───────────────────┼─────────────────────────┼─────────┼─annual──────┤
│ tmin │ minimum temperature │ degC │ daily │
│ │ │ │ monthly │
├───────────────────┼─────────────────────────┼─────────┼─annual──────┤
│ vp │ vapor pressure │ Pa │ daily │
│ │ │ │ monthly │
├───────────────────┼─────────────────────────┼─────────┼─annual──────┤
│ dayl │ daylength │ seconds │ daily │
├───────────────────┼─────────────────────────┼─────────┼─────────────┤
│ srad │ shortwave radiation │ W/m2 │ daily │
├───────────────────┼─────────────────────────┼─────────┼─────────────┤
│ penman_monteith │ PET by Penman-Montieth │ mm │ daily │
├───────────────────┼─────────────────────────┼─────────┼─────────────┤
│ hargreaves_samani │ PET by Hargreaves- │ mm │ daily │
├───────────────────┼─Samani──────────────────┼─────────┼─────────────┤
│ priestley_taylor │ PET by Priestley-Taylor │ mm │ daily │
╘═══════════════════╧═════════════════════════╧═════════╧═════════════╛
Example: --measuredParams=tmax,tmin
All variables are returned by default.
--time_scale TIME_SCALE
[optional, default is "daily"]
One of "daily", "monthly", or "annual".
--snow
[optional, defaults to False]
Separate snowfall from precipitation using Martinez and Gupta (2010)
method.
epa_wqp¶
$ tsgettoolbox epa_wqp --help
usage: tsgettoolbox epa_wqp [-h] [--bBox BBOX] [--lat LAT] [--lon LON]
[--within WITHIN] [--countrycode COUNTRYCODE] [--statecode STATECODE]
[--countycode COUNTYCODE] [--siteType SITETYPE] [--organization
ORGANIZATION] [--siteid SITEID] [--huc HUC] [--sampleMedia SAMPLEMEDIA]
[--characteristicType CHARACTERISTICTYPE] [--characteristicName
CHARACTERISTICNAME] [--pCode PCODE] [--activityId ACTIVITYID] [--startDateLo
STARTDATELO] [--startDateHi STARTDATEHI]
All of the keywords could be considered as subtractive filters of the stations.
Some of the keywords can result in very large number of stations being
downloaded.
options:
-h | --help
show this help message and exit
--bBox BBOX
[optional, default is None, major site filter]
A contiguous range of decimal latitude and longitude, starting with the
west longitude, then the south latitude, then the east longitude,
and then the north latitude with each value separated by a comma.
The product of the range of latitude and longitude cannot exceed 25
degrees. Whole or decimal degrees must be specified, up to six
digits of precision. Minutes and seconds are not allowed. Remember:
western longitude (which includes almost all of the United States)
is specified in negative degrees. Caution: many sites outside the
continental US do not have latitude and longitude referenced to
NAD83 and therefore can not be found using these arguments. Certain
sites are not associated with latitude and longitude due to homeland
security concerns and cannot be found using this filter.:
--bBox=-83,36.5,-81,38.5
--lat LAT
[optional, default is None]
Latitude for radial search, expressed in decimal degrees, WGS84
The lat, lon, and within arguments are used together to form a circle on
the Earth's surface for locating data-collection stations. Many
stations outside the continental US do not have latitude and
longitude referenced to WGS84 and therefore cannot be found using
these parameters.
--lon LON
[optional, default is None]
Longitude for radial search, expressed in decimal degrees, WGS84
The lat, lon, and within arguments are used together to form a circle on
the Earth's surface for locating data-collection stations. Many
stations outside the continental US do not have latitude and
longitude referenced to WGS84 and therefore cannot be found using
these parameters.
--within WITHIN
[optional, default is None]
Distance for radial search, expressed in decimal miles
The lat, lon, and within arguments are used together to form a circle on
the Earth's surface for locating data-collection stations. Many
stations outside the continental US do not have latitude and
longitude referenced to WGS84 and therefore cannot be found using
these parameters.
--countrycode COUNTRYCODE
[optional, default is None]
Two-character Federal Information Processing Standard (FIPS) country code.
(see domain service for available codes)
FIPS country codes were established by the National Institute of
Standards, publication 5-2.
--statecode STATECODE
[optional, default is None]
Two-character Federal Information Processing Standard (FIPS) country code,
followed bu a ":", followed by a two-digit FIPS state code. (see
domain service for available codes)
FIPS state codes were established by the National Institute of Standards,
publication 5-2.
--countycode COUNTYCODE
[optional, default is None]
Two-character Federal Information Processing Standard (FIPS) country code,
followed by a ":", followed by a two-digit FIPS state code, followed
by a ":", followed by a three-digit FIPS county code. (see domain
service for available codes)
FIPS county codes were established by the National Institute of Standards,
publication 5-2.
--siteType SITETYPE
[optional, default is None]
One or more case-sensitive site types, separated by semicolons. (see
domain service for available site types)
Restrict retrieval to stations with specified site type (location in the
hydrologic cycle). The MonitoringLocationTypeName for individual
records may provide more detailed information about the type of
individual stations.
--organization ORGANIZATION
[optional, default is None]
For USGS organization IDs, append an upper-case postal-service state
abbreviation to "USGS-" to identify the USGS office managing the
data collection station records. However, a few US states are
serviced by one USGS office.:
USGS-MA = Massachusetts and Rhode Island
USGS-MD = Maryland, Delaware, and the District of Columbia
USGS-PR = Caribbean Islands
USGS-HI = Pacific Islands
(see domain service for available organization IDs)
USGS offices sometimes provide data for stations outside the political
boundaries associated with the office's organization code. Use the
statecode or countycode arguments to search for stations located
within those political boundaries.
--siteid SITEID
[optional, default is None]
Concatenate an agency code, a hyphen ("-"), and a site-identification
number.
Each data collection station is assigned a unique site-identification
number. Other agencies often use different site identification
numbers for the same stations.
--huc HUC
[optional, default is None, major site filter]
A list of hydrologic unit codes (HUC) or watersheds. Only 1 major HUC can
be specified per request. A major HUC has two digits. Minor HUCs
must be eight digits in length. Can have 1 to 10 HUC codes. List of
HUCs is available at <[4;36mhttp://water.usgs.gov/GIS/huc_name.html[0m>:
--huc=01,02070010
--sampleMedia SAMPLEMEDIA
[optional, default is None]
One or more case-sensitive sample media, separated by semicolons. (see
domain service for available sample media)
Sample media are broad general classes, and may be subdivided in the
retrieved data. Examine the data elements ActivityMediaName,
ActivityMediaSubdivisionName, and ResultSampleFractionText for more
detailed information.
--characteristicType CHARACTERISTICTYPE
[optional, default is None]
One or more case-sensitive characteristic types (groupings) separated by
semicolons. (see domain service for available characteristic types)
These groups will be expanded as part of the ongoing collaboration between
USGS and USEPA.
--characteristicName CHARACTERISTICNAME
[optional, default is None]
One or more case-sensitive characteristic names, separated by semicolons.
(see domain service for available characteristic names)
Characteristic names identify different types of environmental
measurements. The names are derived from the USEPA Substance
Registry System (SRS). USGS uses parameter codes for the same
purpose and has associated most parameters to SRS names.
--pCode PCODE
[optional, default is None]
One or more five-digit USGS parameter codes, separated by semicolons. This
is equivalent to "parameterCd" used in other USGS web services.
--activityId ACTIVITYID
[optional, default is None]
One or more case-sensitive activity IDs, separated by semicolons.
Designator that uniquely identifies an activity within an
organization.
--startDateLo STARTDATELO
[optional, default is None]
Date of earliest desired data-collection activity. A very wide range of
date strings can be used but the closer to ISO 8601 the better.
--startDateHi STARTDATEHI
[optional, default is None]
Date of last desired data-collection activity. A very wide range of date
strings can be used but the closer to ISO 8601 the better.
fawn¶
$ tsgettoolbox fawn --help
usage: tsgettoolbox fawn [-h] [--start_date START_DATE] [--end_date END_DATE]
stations variables reportType
US/FL:station::15T,H,D,M:Florida Automated Weather Network (FAWN)
positional arguments:
stations At the command line can supply a comma separated list or codes or
names. Using the Python API needs to be a Python list.
The current complete list of FAWN stations.
• 260 Alachua
• 320 Apopka
• 490 Arcadia
• 304 Avalon
• 350 Balm
• 410 'Belle Glade'
• 230 Bronson
• 310 Brooksville
• 150 Carrabelle
• 250 Citra
• 405 Clewiston
• 311 'Dade City'
• 120 'Defuniak Springs'
• 360 Dover
• 420 'Fort Lauderdale'
• 390 Frostproof
• 430 'Fort Pierce'
• 270 Hastings
• 440 Homestead
• 450 Immokalee
• 371 'Indian River'
• 110 Jay
• 241 Joshua
• 340 Kenansville
• 330 'Lake Alfred'
• 275 Lecanto
• 170 'Live Oak'
• 180 Macclenny
• 130 Marianna
• 121 May
• 160 Monticello
• 480 'North Port'
• 280 Ocklawaha
• 303 Okahumpka
• 455 Okeechobee
• 380 Ona
• 460 Palmdale
• 290 Pierson
• 240 Putnam Hall
• 140 Quincy
• 470 Sebring
• 435 'St. Lucie West'
• 302 Umatilla
• 425 Wellington
variables At the command line can supply a comma separated list of variable
names. Using the Python API needs to be a Python list.
The current complete list of FAWN variables are:
┌─────────────┬─────────────────────────────────────┬────────┐
│ Name │ Description │ Units │
╞═════════════╪═════════════════════════════════════╪════════╡
│ AirTemp1 │ Air temperature at 60 cm │ degF │
├─────────────┼─────────────────────────────────────┼────────┤
│ AirTemp9 │ Air temperature at 2 m │ degF │
├─────────────┼─────────────────────────────────────┼────────┤
│ AirTemp15 │ Air temperature at 10 m │ degF │
├─────────────┼─────────────────────────────────────┼────────┤
│ SoilTempAvg │ Soil temperature at -10 cm │ degF │
├─────────────┼─────────────────────────────────────┼────────┤
│ DewPoint │ Dew point │ degF │
├─────────────┼─────────────────────────────────────┼────────┤
│ WetBulb │ Wet bulb temperature │ degF │
├─────────────┼─────────────────────────────────────┼────────┤
│ RelHumAvg │ Relative humidity │ │
├─────────────┼─────────────────────────────────────┼────────┤
│ Rainfall │ Rainfall │ in │
├─────────────┼─────────────────────────────────────┼────────┤
│ TotalRad │ Total solar radiation │ w/m2 │
├─────────────┼─────────────────────────────────────┼────────┤
│ WindSpeed │ Wind speed │ mph │
├─────────────┼─────────────────────────────────────┼────────┤
│ WindDir │ Wind direction │ degree │
├─────────────┼─────────────────────────────────────┼────────┤
│ ET │ Reference ET Penman-Monteith │ in │
├─────────────┼─────────────────────────────────────┼────────┤
│ BP │ Barometric pressure at 2 m │ mb │
╘═════════════╧═════════════════════════════════════╧════════╛
The 'ET' variable is only available when reportType is "daily" or "monthly".
reportType Interval of the data. Can be one of "all" for 15 minute, "hourly",
"daily", or "monthly".
options:
-h | --help
show this help message and exit
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
hydstra_catalog¶
$ tsgettoolbox hydstra_catalog --help
<string>:33: (WARNING/2) Option list ends without a blank line; unexpected unindent.
usage: tsgettoolbox hydstra_catalog [-h] [--isleep ISLEEP]
[--tablefmt TABLEFMT] server station
Creates a table of datasources and variables available for a station, including
periods of record for each.
positional arguments:
server Server name or base URL of Hydstra webserver. This can be either
a direct URL (normally up to but not including a '?') or it can be one of
the following predetermined server names.
┌─────────────┬─────────────────────────────────────────────────────┐
│ Name │ Description │
╞═════════════╪═════════════════════════════════════════════════════╡
│ sjrwmd │ St. Johns Water Management District, Florida, USA │
│ │ <[4;36mhttps://secure.sjrwmd.com/hydweb/cgi/webse- │
├─────────────┼─rvice.exe[0m>──────────────────────────────────────┤
│ orangeco_ca │ Orange County Public Works, California USA │
│ │ <[4;36mhttp://Hydstra.OCPublicWorks.com/cgi/webse- │
╘═════════════╧═rvice.exe[0m>══════════════════════════════════════╛
station This should be the short 'station identifier', not the longer 'station
name'.
options:
-h | --help
show this help message and exit
--isleep ISLEEP
Integer seconds to sleep between webservice calls to create the catalog
table. Default is zero.
If HTTP errors occur, it may be due to web calls that come too fast, if
the server is configured to interpret rapid calls as a
denial-of-service attack. If this happens, increase isleep.
Option list ends without a blank line; unexpected unindent.
--tablefmt TABLEFMT
hydstra_stations¶
$ tsgettoolbox hydstra_stations --help
usage: tsgettoolbox hydstra_stations [-h] [--activeonly] [--latlong]
[--tablefmt TABLEFMT] server
Creates a table of stations available on the server.
positional arguments:
server Server name or base URL of Hydstra webserver. This can be either
a direct URL (normally up to but not including a '?') or it can be one of
the following predetermined server names.
┌─────────────┬─────────────────────────────────────────────────────┐
│ Name │ Description │
╞═════════════╪═════════════════════════════════════════════════════╡
│ sjrwmd │ St. Johns Water Management District, Florida, USA │
│ │ <[4;36mhttps://secure.sjrwmd.com/hydweb/cgi/webse- │
├─────────────┼─rvice.exe[0m>──────────────────────────────────────┤
│ orangeco_ca │ Orange County Public Works, California USA │
│ │ <[4;36mhttp://Hydstra.OCPublicWorks.com/cgi/webse- │
╘═════════════╧═rvice.exe[0m>══════════════════════════════════════╛
options:
-h | --help
show this help message and exit
--activeonly
Boolean: False (default) returns all stations. True returns only active
stations.
--latlong
Boolean: False (default) omits latitude and longitude from station table.
True includes them.
--tablefmt TABLEFMT
Format for site or catalog table. Allowable values include plain
(default), csv, or any allowed value for the Python tabulate
package.
hydstra_ts¶
$ tsgettoolbox hydstra_ts --help
usage: tsgettoolbox hydstra_ts [-h] [--interval INTERVAL] [--provisional]
[--datasource DATASOURCE] [--aggcode AGGCODE] [--quality] [--maxqual MAXQUAL]
server station variable start_time end_time
Hydstra databases are generally organized into stations, datasources, and
variables.
positional arguments:
server Server name or base URL of Hydstra webserver. This can be either
a direct URL (normally up to but not including a '?') or it can be one of
the following predetermined server names.
┌─────────────┬─────────────────────────────────────────────────────┐
│ Name │ Description │
╞═════════════╪═════════════════════════════════════════════════════╡
│ sjrwmd │ St. Johns Water Management District, Florida, USA │
│ │ <[4;36mhttps://secure.sjrwmd.com/hydweb/cgi/webse- │
├─────────────┼─rvice.exe[0m>──────────────────────────────────────┤
│ orangeco_ca │ Orange County Public Works, California USA │
│ │ <[4;36mhttp://Hydstra.OCPublicWorks.com/cgi/webse- │
╘═════════════╧═rvice.exe[0m>══════════════════════════════════════╛
station This should be the short 'station identifier', not the longer 'station
name'.
variable Name of variable or numeric variable code. The list of available
variables varies by server. The following is a typical list of names and
their associated numeric codes:
Rainfall:in: 11.10
Water_Elev_NAVD88:ft: 227.10
Gauge Height:ft: 233.10
Discharge:cfs: 262.17
Other available variable codes for a given station can be determined using
the hydstra_catalog command.
start_time Date and time for start of requested period in ISO format. For daily
and longer intervals, use YYYY-MM-DD. For sub-daily, use YYYY-MM-DD-hh-mm or
YYYY-MM-DD-hh-mm-ss if necessary.
end_time Date and time for end of requested period in ISO format. For daily and
longer intervals, use YYYY-MM-DD. For sub-daily, use YYYY-MM-DD-hh-mm or
YYYY-MM-DD-hh-mm-ss if necessary.
options:
-h | --help
show this help message and exit
--interval INTERVAL
Time step of data to return. Valid values are: year, month, day, hour,
minute, second
--provisional
Boolean: False (default) to skip provisional data. True to include it. In
many cases, this means datasources A and AB respectively. Details
may vary by server.
--datasource DATASOURCE
Hydstra databases include an attribute called 'datasource'. A given
variable may be present as multiple timeseries with different
datasources, each with various available periods of record and
levels of quality assurance.
For some servers, certain datasources are reserved for internal workflows
and may be skipped by the hydstra_catalog command.
Default is 'A' (for 'Archive') if not including provisional data. The
default for provisional data may vary by server. For instance:
sjrwmd The default for including recent non-QA'ed
provisional data is 'AB', which returns the full
span, distinguished by different quality codes. To
get only the provisional data, the 'X' datasource
would be used. There may be overlap in the time
spans of 'A' and 'X', during which the 'A' should
be preferred.
orangeco_ca There is no 'AB' datasource. The 'TELEMETRY'
datasource contains the provisional data, which can
overlap with the 'A' datasource
Required if provisional data is requested.
--aggcode AGGCODE
Aggregation code. defaults to 'tot' for rainfall, 'mean' for elevation and
discharge. Other values vary by server. Required if variable
specified by numeric code.
--quality
Boolean: False (default) provides no quality information. True to add a
column containing a numeric quality code 0 to 255. Definitions of
codes may vary by server.
--maxqual MAXQUAL
Highest allowable numeric quality code, above which the value is
considered missing. May be specified even if a separate quality
column is not requested.
ldas¶
$ tsgettoolbox ldas --help
usage: tsgettoolbox ldas [-h] [--lat LAT] [--lon LON] [--xindex XINDEX]
[--yindex YINDEX] [--variables VARIABLES] [--startDate STARTDATE] [--endDate
ENDDATE] [--variable VARIABLE]
This will download data from a set of water cycle related variables (Table 1)
from the North American and Global Land Data Assimilation Systems (NLDAS and
GLDAS, respectively), the Land Parameter Parameter Model (LPRM), the Tropical
Rainfall Measuring Mission (TRMM), and Gravity Recovery and Climate Experiment
(GRACE) data assimilation. In addition to their access provided by the hydrology
community tools, selected data rods variables can be searched and accessed
through the GES DISC search and access user interface, and all data rods
variables can be accessed via Web services developed by the GES DISC.
The time zone is always UTC.
┌───────────────────────────────┬─────────────┬───────────────┐
│ Description/Name │ Spatial │ Time │
╞═══════════════════════════════╪═════════════╪═══════════════╡
│ GLDAS Noah Land Surface Model │ 0.25x0.25 │ 3 hour │
│ GLDAS_NOAH025_3H V2.1 │ degree │ │
├───────────────────────────────┼─────────────┼───────────────┤
│ Groundwater and Soil Moisture │ 0.125x0.125 │ 7 day │
│ Conditions from GRACE Data │ degree │ │
│ Assimilation GRACEDADM_CLSM0- │ │ │
│ 125US_7D V4.0 │ │ │
├───────────────────────────────┼─────────────┼───────────────┤
│ MERRA-2 2D, Instantaneous, │ 0.5x0.625 │ 1 hour │
│ Land Surface Forcings │ degree │ │
│ M2I1NXLFO V5.12.4 │ │ │
├───────────────────────────────┼─────────────┼───────────────┤
│ MERRA-2 2D, Time-averaged, │ 0.5x0.625 │ 1 hour │
│ Surface Flux Diagnostics │ degree │ │
│ M2T1NXFLX V5.12.4 │ │ │
├───────────────────────────────┼─────────────┼───────────────┤
│ MERRA-2 2D, Time-averaged, │ 0.5x0.625 │ 1 hour │
│ Land Surface Forcings │ degree │ │
│ M2T1NXLFO V5.12.4 │ │ │
├───────────────────────────────┼─────────────┼───────────────┤
│ MERRA 2D Incremental Analysis │ 0.5x0.667 │ 1 hour │
│ Update MST1NXMLD V5.12.4 │ degree │ │
├───────────────────────────────┼─────────────┼───────────────┤
│ NLDAS Primary Forcing Data │ 0.125x0.125 │ 1 hour │
│ NLDAS_FORA0125_H V002 │ degree │ │
├───────────────────────────────┼─────────────┼───────────────┤
│ NLDAS Noah Land Surface Model │ 0.125x0.125 │ 1 hour │
│ NLDAS_NOAH0125_H V002 │ degree │ │
├───────────────────────────────┼─────────────┼───────────────┤
│ Smerge-Noah-CCI root zone │ 0.125x0.125 │ 1 day │
│ soil moisture 0-40 cm │ degree │ │
│ SMERGE_RZSM0_40CM V2.0 │ │ │
├───────────────────────────────┼─────────────┼───────────────┤
│ TRMM (TMPA) Rainfall Estimate │ 0.25x0.25 │ 3 hour │
│ TRMM_3B42 V7 │ degree │ │
╘═══════════════════════════════╧═════════════╧═══════════════╛
options:
-h | --help
show this help message and exit
--lat LAT
Should use 'lat' and 'lon' to specify location.
Latitude (required): Enter single geographic point by latitude.:
Example: --lat=43.1
If known, 'xindex' and 'yindex' can be used for the NLDAS grid only.
--lon LON
Should use 'lat' and 'lon' to specify location.
Longitude (required): Enter single geographic point by longitude:
Example: --lon=-85.3
If known, 'xindex' and 'yindex' can be used for the NLDAS grid only.
--xindex XINDEX
It lat or lon is None, then will try xindex and yindex.
Enter the x index of the NLDAS grid.:
Example: --xindex=301
--yindex YINDEX
It lat or lon is None, then will try xindex and yindex.
Enter the y index of the NLDAS grid.:
Example: --yindex=80
--variables VARIABLES
Use the variable codes from the following table:
┌─────────────────────────────────────────────┬─────────┐
│ LDAS "variables" string Description │ Units │
╞═════════════════════════════════════════════╪═════════╡
│ NLDAS_FORA0125_H.002:APCPsfc Precipitation │ mm │
│ hourly total │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_FORA0125_H.002:DLWRFsfc Surface DW │ W/m**2 │
│ longwave radiation flux │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_FORA0125_H.002:DSWRFsfc Surface DW │ W/m**2 │
│ shortwave radiation flux │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_FORA0125_H.002:PEVAPsfc Potential │ mm │
│ evaporation │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_FORA0125_H.002:SPFH2m 2-m above │ kg/kg │
│ ground specific humidity │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_FORA0125_H.002:TMP2m 2-m above ground │ K │
│ temperature │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_FORA0125_H.002:UGRD10m 10-m above │ m/s │
│ ground zonal wind │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_FORA0125_H.002:VGRD10m 10-m above │ m/s │
│ ground meridional wind │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:EVPsfc Total │ mm │
│ evapotranspiration │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:GFLUXsfc Ground heat │ W/m**2 │
│ flux │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:LHTFLsfc Latent heat │ W/m**2 │
│ flux │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SHTFLsfc Sensible heat │ W/m**2 │
│ flux │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SSRUNsfc Surface │ mm │
│ runoff (non-infiltrating) │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:BGRUNsfc Subsurface │ mm │
│ runoff (baseflow) │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SOILM0-10cm 0-10 cm │ mm │
│ soil moisture content │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SOILM0-100cm 0-100 cm │ mm │
│ soil moisture content │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SOILM0-200cm 0-200 cm │ mm │
│ soil moisture content │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SOILM10-40cm 10-40 cm │ mm │
│ soil moisture content │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SOILM40-100cm 40-100 │ mm │
│ cm soil moisture content │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SOILM100-200cm 100-200 │ mm │
│ cm soil moisture content │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:TSOIL0-10cm 0-10 cm │ K │
│ soil temperature │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:AvgSurfT_inst Average │ K │
│ surface skin temperature │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Evap_tavg │ mm/s │
│ Evapotranspiration │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Psurf_f_inst Surface │ Pa │
│ air pressure │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Qair_f_inst Specific │ kg/kg │
│ humidity │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Qs_acc Storm surface │ mm │
│ runoff │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Qsb_acc │ mm │
│ Baseflow-groundwater runoff │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Rainf_f_tavg Total │ mm/s │
│ precipitation rate │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Rainf_tavg Rain │ mm/s │
│ precipitation rate │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Snowf_tavg Snow │ mm/s │
│ precipitation rate │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:SoilMoi0_10cm_inst │ mm │
│ Soil moisture content (0-10 cm) │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:SoilMoi10_40cm_inst │ mm │
│ Soil moisture content (10-40 cm) │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:SoilMoi40_100cm_inst │ mm │
│ Soil moisture content (40-100 cm) │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:SoilTMP0_10cm_inst │ K │
│ Soil temperature (0-10 cm) │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Tair_f_inst Near │ K │
│ surface air temperature │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Wind_f_inst Near │ m/s │
│ surface wind speed │ │
├─────────────────────────────────────────────┼─────────┤
│ TRMM_3B42.7:precipitation Precipitation │ mm/hr │
├─────────────────────────────────────────────┼─────────┤
│ SMERGE_RZSM0_40CM_2.0:CCI_ano CCI soil │ m3/m3 │
│ moisture anomalies 0-40 cm │ │
├─────────────────────────────────────────────┼─────────┤
│ SMERGE_RZSM0_40CM_2.0:RZSM Average soil │ m3/m3 │
│ moisture of 0-40 cm layer │ │
├─────────────────────────────────────────────┼─────────┤
│ GRACEDADM_CLSM0125US_7D.4:gws_inst │ percent │
│ Groundwater storage percentile │ │
├─────────────────────────────────────────────┼─────────┤
│ GRACEDADM_CLSM0125US_7D.4:rtzsm_inst Root │ percent │
│ zone soil moisture percentile │ │
├─────────────────────────────────────────────┼─────────┤
│ GRACEDADM_CLSM0125US_7D.4:sfsm_inst Surface │ percent │
│ soil moisture percentile │ │
├─────────────────────────────────────────────┼─────────┤
│ M2I1NXLFO.5124:QLML Surface specific │ 1 │
│ humidity:instant │ │
├─────────────────────────────────────────────┼─────────┤
│ M2I1NXLFO.5124:TLML Surface air temperature │ K │
│ over land:instant │ │
├─────────────────────────────────────────────┼─────────┤
│ M2I1NXLFO.5124:SPEEDLML Surface wind │ m/s │
│ speed:instant │ │
├─────────────────────────────────────────────┼─────────┤
│ M2T1NXFLX.5124:ULML Surface eastward │ m/s │
│ wind:average │ │
├─────────────────────────────────────────────┼─────────┤
│ M2T1NXFLX.5124:VLML Surface northward │ m/s │
│ wind:average │ │
├─────────────────────────────────────────────┼─────────┤
│ M2T1NXLFO.5124:LWGAB Surface absorbed │ W/m**2 │
│ longwave radiation:average │ │
├─────────────────────────────────────────────┼─────────┤
│ M2T1NXLFO.5124:SWGDN Incident shortwave │ W/m**2 │
│ radiation land:average │ │
├─────────────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:BASEFLOW Baseflow │ mm/s │
├─────────────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:LHLAND Latent heat flux from │ W/m**2 │
│ land │ │
├─────────────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:PRECSNO Surface snowfall │ mm/s │
├─────────────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:PRECTOT Total surface │ mm/s │
│ precipitation │ │
├─────────────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:RUNOFF Overland runoff │ mm/s │
├─────────────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:SFMC Top soil layer soil │ m3/m3 │
│ moisture content │ │
├─────────────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:SHLAND Sensible heat flux │ W/m**2 │
│ from land │ │
├─────────────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:TSOIL1 Soil temperature in │ K │
│ layer 1 │ │
╘═════════════════════════════════════════════╧═════════╛
--startDate STARTDATE
The start date of the time series.:
Example: --startDate=2001-01-01T05
If startDate and endDate are None, returns the entire series.
--endDate ENDDATE
The end date of the time series.:
Example: --endDate=2002-01-05T05
If startDate and endDate are None, returns the entire series.
--variable VARIABLE
DEPRECATED: use "variables" instead to be consistent across
"tsgettoolbox".
ldas_gldas_noah¶
$ tsgettoolbox ldas_gldas_noah --help
usage: tsgettoolbox ldas_gldas_noah [-h] [--lat LAT] [--lon LON]
[--xindex XINDEX] [--yindex YINDEX] [--variables VARIABLES] [--startDate
STARTDATE] [--endDate ENDDATE] [--variable VARIABLE]
This will download data from a set of water cycle related variables (Table 1)
from the North American and Global Land Data Assimilation Systems (NLDAS and
GLDAS, respectively), the Land Parameter Parameter Model (LPRM), the Tropical
Rainfall Measuring Mission (TRMM), and Gravity Recovery and Climate Experiment
(GRACE) data assimilation. In addition to their access provided by the hydrology
community tools, selected data rods variables can be searched and accessed
through the GES DISC search and access user interface, and all data rods
variables can be accessed via Web services developed by the GES DISC.
The time zone is always UTC.
┌───────────────────────────────┬─────────────┬───────────────┐
│ Description/Name │ Spatial │ Time │
╞═══════════════════════════════╪═════════════╪═══════════════╡
│ GLDAS Noah Land Surface Model │ 0.25x0.25 │ 3 hour │
│ GLDAS_NOAH025_3H V2.1 │ degree │ │
╘═══════════════════════════════╧═════════════╧═══════════════╛
options:
-h | --help
show this help message and exit
--lat LAT
Should use 'lat' and 'lon' to specify location.
Latitude (required): Enter single geographic point by latitude.:
Example: --lat=43.1
If known, 'xindex' and 'yindex' can be used for the NLDAS grid only.
--lon LON
Should use 'lat' and 'lon' to specify location.
Longitude (required): Enter single geographic point by longitude:
Example: --lon=-85.3
If known, 'xindex' and 'yindex' can be used for the NLDAS grid only.
--xindex XINDEX
It lat or lon is None, then will try xindex and yindex.
Enter the x index of the NLDAS grid.:
Example: --xindex=301
--yindex YINDEX
It lat or lon is None, then will try xindex and yindex.
Enter the y index of the NLDAS grid.:
Example: --yindex=80
--variables VARIABLES
Use the variable codes from the following table:
┌────────────────────────────────────────────┬─────────┐
│ LDAS "variables" string Description │ Units │
╞════════════════════════════════════════════╪═════════╡
│ GLDAS_NOAH025_3H_v2.1:AvgSurfT_inst │ K │
│ Average surface skin temperature │ │
├────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Evap_tavg │ mm/s │
│ Evapotranspiration │ │
├────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Psurf_f_inst Surface │ Pa │
│ air pressure │ │
├────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Qair_f_inst Specific │ kg/kg │
│ humidity │ │
├────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Qs_acc Storm surface │ mm │
│ runoff │ │
├────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Qsb_acc │ mm │
│ Baseflow-groundwater runoff │ │
├────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Rainf_f_tavg Total │ mm/s │
│ precipitation rate │ │
├────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Rainf_tavg Rain │ mm/s │
│ precipitation rate │ │
├────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Snowf_tavg Snow │ mm/s │
│ precipitation rate │ │
├────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:SoilMoi0_10cm_inst │ mm │
│ Soil moisture content (0-10 cm) │ │
├────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:SoilMoi10_40cm_inst │ mm │
│ Soil moisture content (10-40 cm) │ │
├────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:SoilMoi40_100cm_inst │ mm │
│ Soil moisture content (40-100 cm) │ │
├────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:SoilTMP0_10cm_inst │ K │
│ Soil temperature (0-10 cm) │ │
├────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Tair_f_inst Near │ K │
│ surface air temperature │ │
├────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Wind_f_inst Near │ m/s │
│ surface wind speed │ │
╘════════════════════════════════════════════╧═════════╛
--startDate STARTDATE
The start date of the time series.:
Example: --startDate=2001-01-01T05
If startDate and endDate are None, returns the entire series.
--endDate ENDDATE
The end date of the time series.:
Example: --endDate=2002-01-05T05
If startDate and endDate are None, returns the entire series.
--variable VARIABLE
DEPRECATED: use "variables" instead to be consistent across
"tsgettoolbox".
ldas_grace¶
$ tsgettoolbox ldas_grace --help
usage: tsgettoolbox ldas_grace [-h] [--lat LAT] [--lon LON] [--xindex XINDEX]
[--yindex YINDEX] [--variables VARIABLES] [--startDate STARTDATE] [--endDate
ENDDATE] [--variable VARIABLE]
This will download data from a set of water cycle related variables (Table 1)
from the North American and Global Land Data Assimilation Systems (NLDAS and
GLDAS, respectively), the Land Parameter Parameter Model (LPRM), the Tropical
Rainfall Measuring Mission (TRMM), and Gravity Recovery and Climate Experiment
(GRACE) data assimilation. In addition to their access provided by the hydrology
community tools, selected data rods variables can be searched and accessed
through the GES DISC search and access user interface, and all data rods
variables can be accessed via Web services developed by the GES DISC.
The time zone is always UTC.
┌───────────────────────────────┬─────────────┬───────────────┐
│ Description/Name │ Spatial │ Time │
╞═══════════════════════════════╪═════════════╪═══════════════╡
│ Groundwater and Soil Moisture │ 0.125x0.125 │ 7 day │
│ Conditions from GRACE Data │ degree │ │
│ Assimilation GRACEDADM_CLSM0- │ │ │
│ 125US_7D V4.0 │ │ │
╘═══════════════════════════════╧═════════════╧═══════════════╛
options:
-h | --help
show this help message and exit
--lat LAT
Should use 'lat' and 'lon' to specify location.
Latitude (required): Enter single geographic point by latitude.:
Example: --lat=43.1
If known, 'xindex' and 'yindex' can be used for the NLDAS grid only.
--lon LON
Should use 'lat' and 'lon' to specify location.
Longitude (required): Enter single geographic point by longitude:
Example: --lon=-85.3
If known, 'xindex' and 'yindex' can be used for the NLDAS grid only.
--xindex XINDEX
It lat or lon is None, then will try xindex and yindex.
Enter the x index of the NLDAS grid.:
Example: --xindex=301
--yindex YINDEX
It lat or lon is None, then will try xindex and yindex.
Enter the y index of the NLDAS grid.:
Example: --yindex=80
--variables VARIABLES
Use the variable codes from the following table:
┌───────────────────────────────────────┬─────────┐
│ LDAS "variables" string Description │ Units │
╞═══════════════════════════════════════╪═════════╡
│ GRACEDADM_CLSM0125US_7D.4:gws_inst │ percent │
│ Groundwater storage percentile │ │
├───────────────────────────────────────┼─────────┤
│ GRACEDADM_CLSM0125US_7D.4:rtzsm_inst │ percent │
│ Root zone soil moisture percentile │ │
├───────────────────────────────────────┼─────────┤
│ GRACEDADM_CLSM0125US_7D.4:sfsm_inst │ percent │
│ Surface soil moisture percentile │ │
╘═══════════════════════════════════════╧═════════╛
--startDate STARTDATE
The start date of the time series.:
Example: --startDate=2001-01-01T05
If startDate and endDate are None, returns the entire series.
--endDate ENDDATE
The end date of the time series.:
Example: --endDate=2002-01-05T05
If startDate and endDate are None, returns the entire series.
--variable VARIABLE
DEPRECATED: use "variables" instead to be consistent across
"tsgettoolbox".
ldas_merra¶
$ tsgettoolbox ldas_merra --help
usage: tsgettoolbox ldas_merra [-h] [--lat LAT] [--lon LON] [--xindex XINDEX]
[--yindex YINDEX] [--variables VARIABLES] [--startDate STARTDATE] [--endDate
ENDDATE] [--variable VARIABLE]
This will download data from a set of water cycle related variables (Table 1)
from the North American and Global Land Data Assimilation Systems (NLDAS and
GLDAS, respectively), the Land Parameter Parameter Model (LPRM), the Tropical
Rainfall Measuring Mission (TRMM), and Gravity Recovery and Climate Experiment
(GRACE) data assimilation. In addition to their access provided by the hydrology
community tools, selected data rods variables can be searched and accessed
through the GES DISC search and access user interface, and all data rods
variables can be accessed via Web services developed by the GES DISC.
The time zone is always UTC.
┌───────────────────────────────┬─────────────┬───────────────┐
│ Description/Name │ Spatial │ Time │
╞═══════════════════════════════╪═════════════╪═══════════════╡
│ MERRA-2 2D, Instantaneous, │ 0.5x0.625 │ 1 hour │
│ Land Surface Forcings │ degree │ │
│ M2I1NXLFO V5.12.4 │ │ │
├───────────────────────────────┼─────────────┼───────────────┤
│ MERRA-2 2D, Time-averaged, │ 0.5x0.625 │ 1 hour │
│ Surface Flux Diagnostics │ degree │ │
│ M2T1NXFLX V5.12.4 │ │ │
├───────────────────────────────┼─────────────┼───────────────┤
│ MERRA-2 2D, Time-averaged, │ 0.5x0.625 │ 1 hour │
│ Land Surface Forcings │ degree │ │
│ M2T1NXLFO V5.12.4 │ │ │
╘═══════════════════════════════╧═════════════╧═══════════════╛
options:
-h | --help
show this help message and exit
--lat LAT
Should use 'lat' and 'lon' to specify location.
Latitude (required): Enter single geographic point by latitude.:
Example: --lat=43.1
If known, 'xindex' and 'yindex' can be used for the NLDAS grid only.
--lon LON
Should use 'lat' and 'lon' to specify location.
Longitude (required): Enter single geographic point by longitude:
Example: --lon=-85.3
If known, 'xindex' and 'yindex' can be used for the NLDAS grid only.
--xindex XINDEX
It lat or lon is None, then will try xindex and yindex.
Enter the x index of the NLDAS grid.:
Example: --xindex=301
--yindex YINDEX
It lat or lon is None, then will try xindex and yindex.
Enter the y index of the NLDAS grid.:
Example: --yindex=80
--variables VARIABLES
Use the variable codes from the following table:
┌─────────────────────────────────────────────┬─────────┐
│ LDAS "variables" string Description │ Units │
╞═════════════════════════════════════════════╪═════════╡
│ M2I1NXLFO.5124:QLML Surface specific │ 1 │
│ humidity:instant │ │
├─────────────────────────────────────────────┼─────────┤
│ M2I1NXLFO.5124:TLML Surface air temperature │ K │
│ over land:instant │ │
├─────────────────────────────────────────────┼─────────┤
│ M2I1NXLFO.5124:SPEEDLML Surface wind │ m/s │
│ speed:instant │ │
├─────────────────────────────────────────────┼─────────┤
│ M2T1NXFLX.5124:ULML Surface eastward │ m/s │
│ wind:average │ │
├─────────────────────────────────────────────┼─────────┤
│ M2T1NXFLX.5124:VLML Surface northward │ m/s │
│ wind:average │ │
├─────────────────────────────────────────────┼─────────┤
│ M2T1NXLFO.5124:LWGAB Surface absorbed │ W/m**2 │
│ longwave radiation:average │ │
├─────────────────────────────────────────────┼─────────┤
│ M2T1NXLFO.5124:SWGDN Incident shortwave │ W/m**2 │
│ radiation land:average │ │
╘═════════════════════════════════════════════╧═════════╛
--startDate STARTDATE
The start date of the time series.:
Example: --startDate=2001-01-01T05
If startDate and endDate are None, returns the entire series.
--endDate ENDDATE
The end date of the time series.:
Example: --endDate=2002-01-05T05
If startDate and endDate are None, returns the entire series.
--variable VARIABLE
DEPRECATED: use "variables" instead to be consistent across
"tsgettoolbox".
ldas_merra_update¶
$ tsgettoolbox ldas_merra_update --help
usage: tsgettoolbox ldas_merra_update [-h] [--lat LAT] [--lon LON]
[--xindex XINDEX] [--yindex YINDEX] [--variables VARIABLES] [--startDate
STARTDATE] [--endDate ENDDATE] [--variable VARIABLE]
This will download data from a set of water cycle related variables (Table 1)
from the North American and Global Land Data Assimilation Systems (NLDAS and
GLDAS, respectively), the Land Parameter Parameter Model (LPRM), the Tropical
Rainfall Measuring Mission (TRMM), and Gravity Recovery and Climate Experiment
(GRACE) data assimilation. In addition to their access provided by the hydrology
community tools, selected data rods variables can be searched and accessed
through the GES DISC search and access user interface, and all data rods
variables can be accessed via Web services developed by the GES DISC.
The time zone is always UTC.
┌───────────────────────────────┬─────────────┬───────────────┐
│ Description/Name │ Spatial │ Time │
╞═══════════════════════════════╪═════════════╪═══════════════╡
│ MERRA 2D Incremental Analysis │ 0.5x0.667 │ 1 hour │
│ Update MST1NXMLD V5.12.4 │ degree │ │
╘═══════════════════════════════╧═════════════╧═══════════════╛
options:
-h | --help
show this help message and exit
--lat LAT
Should use 'lat' and 'lon' to specify location.
Latitude (required): Enter single geographic point by latitude.:
Example: --lat=43.1
If known, 'xindex' and 'yindex' can be used for the NLDAS grid only.
--lon LON
Should use 'lat' and 'lon' to specify location.
Longitude (required): Enter single geographic point by longitude:
Example: --lon=-85.3
If known, 'xindex' and 'yindex' can be used for the NLDAS grid only.
--xindex XINDEX
It lat or lon is None, then will try xindex and yindex.
Enter the x index of the NLDAS grid.:
Example: --xindex=301
--yindex YINDEX
It lat or lon is None, then will try xindex and yindex.
Enter the y index of the NLDAS grid.:
Example: --yindex=80
--variables VARIABLES
Use the variable codes from the following table:
┌───────────────────────────────────────┬─────────┐
│ LDAS "variables" string Description │ Units │
╞═══════════════════════════════════════╪═════════╡
│ MST1NXMLD.520:BASEFLOW Baseflow │ mm/s │
├───────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:LHLAND Latent heat flux │ W/m**2 │
│ from land │ │
├───────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:PRECSNO Surface │ mm/s │
├─snowfall──────────────────────────────┼─────────┤
│ MST1NXMLD.520:PRECTOT Total surface │ mm/s │
│ precipitation │ │
├───────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:RUNOFF Overland runoff │ mm/s │
├───────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:SFMC Top soil layer │ m3/m3 │
│ soil moisture content │ │
├───────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:SHLAND Sensible heat │ W/m**2 │
│ flux from land │ │
├───────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:TSOIL1 Soil temperature │ K │
│ in layer 1 │ │
╘═══════════════════════════════════════╧═════════╛
--startDate STARTDATE
The start date of the time series.:
Example: --startDate=2001-01-01T05
If startDate and endDate are None, returns the entire series.
--endDate ENDDATE
The end date of the time series.:
Example: --endDate=2002-01-05T05
If startDate and endDate are None, returns the entire series.
--variable VARIABLE
DEPRECATED: use "variables" instead to be consistent across
"tsgettoolbox".
ldas_nldas_fora¶
$ tsgettoolbox ldas_nldas_fora --help
usage: tsgettoolbox ldas_nldas_fora [-h] [--lat LAT] [--lon LON]
[--xindex XINDEX] [--yindex YINDEX] [--variables VARIABLES] [--startDate
STARTDATE] [--endDate ENDDATE] [--variable VARIABLE]
This will download data from a set of water cycle related variables (Table 1)
from the North American and Global Land Data Assimilation Systems (NLDAS and
GLDAS, respectively), the Land Parameter Parameter Model (LPRM), the Tropical
Rainfall Measuring Mission (TRMM), and Gravity Recovery and Climate Experiment
(GRACE) data assimilation. In addition to their access provided by the hydrology
community tools, selected data rods variables can be searched and accessed
through the GES DISC search and access user interface, and all data rods
variables can be accessed via Web services developed by the GES DISC.
The time zone is always UTC.
┌───────────────────────────────┬─────────────┬───────────────┐
│ Description/Name │ Spatial │ Time │
╞═══════════════════════════════╪═════════════╪═══════════════╡
│ NLDAS Primary Forcing Data │ 0.125x0.125 │ 1 hour │
│ NLDAS_FORA0125_H V002 │ degree │ │
╘═══════════════════════════════╧═════════════╧═══════════════╛
options:
-h | --help
show this help message and exit
--lat LAT
Should use 'lat' and 'lon' to specify location.
Latitude (required): Enter single geographic point by latitude.:
Example: --lat=43.1
If known, 'xindex' and 'yindex' can be used for the NLDAS grid only.
--lon LON
Should use 'lat' and 'lon' to specify location.
Longitude (required): Enter single geographic point by longitude:
Example: --lon=-85.3
If known, 'xindex' and 'yindex' can be used for the NLDAS grid only.
--xindex XINDEX
It lat or lon is None, then will try xindex and yindex.
Enter the x index of the NLDAS grid.:
Example: --xindex=301
--yindex YINDEX
It lat or lon is None, then will try xindex and yindex.
Enter the y index of the NLDAS grid.:
Example: --yindex=80
--variables VARIABLES
Use the variable codes from the following table:
┌─────────────────────────────────────────────┬─────────┐
│ LDAS "variables" string Description │ Units │
╞═════════════════════════════════════════════╪═════════╡
│ NLDAS_FORA0125_H.002:APCPsfc Precipitation │ mm │
│ hourly total │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_FORA0125_H.002:DLWRFsfc Surface DW │ W/m**2 │
│ longwave radiation flux │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_FORA0125_H.002:DSWRFsfc Surface DW │ W/m**2 │
│ shortwave radiation flux │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_FORA0125_H.002:PEVAPsfc Potential │ mm │
│ evaporation │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_FORA0125_H.002:SPFH2m 2-m above │ kg/kg │
│ ground specific humidity │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_FORA0125_H.002:TMP2m 2-m above ground │ K │
│ temperature │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_FORA0125_H.002:UGRD10m 10-m above │ m/s │
│ ground zonal wind │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_FORA0125_H.002:VGRD10m 10-m above │ m/s │
│ ground meridional wind │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:EVPsfc Total │ mm │
│ evapotranspiration │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:GFLUXsfc Ground heat │ W/m**2 │
│ flux │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:LHTFLsfc Latent heat │ W/m**2 │
│ flux │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SHTFLsfc Sensible heat │ W/m**2 │
│ flux │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SSRUNsfc Surface │ mm │
│ runoff (non-infiltrating) │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:BGRUNsfc Subsurface │ mm │
│ runoff (baseflow) │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SOILM0-10cm 0-10 cm │ mm │
│ soil moisture content │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SOILM0-100cm 0-100 cm │ mm │
│ soil moisture content │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SOILM0-200cm 0-200 cm │ mm │
│ soil moisture content │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SOILM10-40cm 10-40 cm │ mm │
│ soil moisture content │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SOILM40-100cm 40-100 │ mm │
│ cm soil moisture content │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SOILM100-200cm 100-200 │ mm │
│ cm soil moisture content │ │
├─────────────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:TSOIL0-10cm 0-10 cm │ K │
│ soil temperature │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:AvgSurfT_inst Average │ K │
│ surface skin temperature │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Evap_tavg │ mm/s │
│ Evapotranspiration │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Psurf_f_inst Surface │ Pa │
│ air pressure │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Qair_f_inst Specific │ kg/kg │
│ humidity │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Qs_acc Storm surface │ mm │
│ runoff │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Qsb_acc │ mm │
│ Baseflow-groundwater runoff │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Rainf_f_tavg Total │ mm/s │
│ precipitation rate │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Rainf_tavg Rain │ mm/s │
│ precipitation rate │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Snowf_tavg Snow │ mm/s │
│ precipitation rate │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:SoilMoi0_10cm_inst │ mm │
│ Soil moisture content (0-10 cm) │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:SoilMoi10_40cm_inst │ mm │
│ Soil moisture content (10-40 cm) │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:SoilMoi40_100cm_inst │ mm │
│ Soil moisture content (40-100 cm) │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:SoilTMP0_10cm_inst │ K │
│ Soil temperature (0-10 cm) │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Tair_f_inst Near │ K │
│ surface air temperature │ │
├─────────────────────────────────────────────┼─────────┤
│ GLDAS_NOAH025_3H_v2.1:Wind_f_inst Near │ m/s │
│ surface wind speed │ │
├─────────────────────────────────────────────┼─────────┤
│ TRMM_3B42.7:precipitation Precipitation │ mm/hr │
├─────────────────────────────────────────────┼─────────┤
│ SMERGE_RZSM0_40CM_2.0:CCI_ano CCI soil │ m3/m3 │
│ moisture anomalies 0-40 cm │ │
├─────────────────────────────────────────────┼─────────┤
│ SMERGE_RZSM0_40CM_2.0:RZSM Average soil │ m3/m3 │
│ moisture of 0-40 cm layer │ │
├─────────────────────────────────────────────┼─────────┤
│ GRACEDADM_CLSM0125US_7D.4:gws_inst │ percent │
│ Groundwater storage percentile │ │
├─────────────────────────────────────────────┼─────────┤
│ GRACEDADM_CLSM0125US_7D.4:rtzsm_inst Root │ percent │
│ zone soil moisture percentile │ │
├─────────────────────────────────────────────┼─────────┤
│ GRACEDADM_CLSM0125US_7D.4:sfsm_inst Surface │ percent │
│ soil moisture percentile │ │
├─────────────────────────────────────────────┼─────────┤
│ M2I1NXLFO.5124:QLML Surface specific │ 1 │
│ humidity:instant │ │
├─────────────────────────────────────────────┼─────────┤
│ M2I1NXLFO.5124:TLML Surface air temperature │ K │
│ over land:instant │ │
├─────────────────────────────────────────────┼─────────┤
│ M2I1NXLFO.5124:SPEEDLML Surface wind │ m/s │
│ speed:instant │ │
├─────────────────────────────────────────────┼─────────┤
│ M2T1NXFLX.5124:ULML Surface eastward │ m/s │
│ wind:average │ │
├─────────────────────────────────────────────┼─────────┤
│ M2T1NXFLX.5124:VLML Surface northward │ m/s │
│ wind:average │ │
├─────────────────────────────────────────────┼─────────┤
│ M2T1NXLFO.5124:LWGAB Surface absorbed │ W/m**2 │
│ longwave radiation:average │ │
├─────────────────────────────────────────────┼─────────┤
│ M2T1NXLFO.5124:SWGDN Incident shortwave │ W/m**2 │
│ radiation land:average │ │
├─────────────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:BASEFLOW Baseflow │ mm/s │
├─────────────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:LHLAND Latent heat flux from │ W/m**2 │
│ land │ │
├─────────────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:PRECSNO Surface snowfall │ mm/s │
├─────────────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:PRECTOT Total surface │ mm/s │
│ precipitation │ │
├─────────────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:RUNOFF Overland runoff │ mm/s │
├─────────────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:SFMC Top soil layer soil │ m3/m3 │
│ moisture content │ │
├─────────────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:SHLAND Sensible heat flux │ W/m**2 │
│ from land │ │
├─────────────────────────────────────────────┼─────────┤
│ MST1NXMLD.520:TSOIL1 Soil temperature in │ K │
│ layer 1 │ │
╘═════════════════════════════════════════════╧═════════╛
--startDate STARTDATE
The start date of the time series.:
Example: --startDate=2001-01-01T05
If startDate and endDate are None, returns the entire series.
--endDate ENDDATE
The end date of the time series.:
Example: --endDate=2002-01-05T05
If startDate and endDate are None, returns the entire series.
--variable VARIABLE
DEPRECATED: use "variables" instead to be consistent across
"tsgettoolbox".
ldas_nldas_noah¶
$ tsgettoolbox ldas_nldas_noah --help
usage: tsgettoolbox ldas_nldas_noah [-h] [--lat LAT] [--lon LON]
[--xindex XINDEX] [--yindex YINDEX] [--variables VARIABLES] [--startDate
STARTDATE] [--endDate ENDDATE] [--variable VARIABLE]
This will download data from a set of water cycle related variables (Table 1)
from the North American and Global Land Data Assimilation Systems (NLDAS and
GLDAS, respectively), the Land Parameter Parameter Model (LPRM), the Tropical
Rainfall Measuring Mission (TRMM), and Gravity Recovery and Climate Experiment
(GRACE) data assimilation. In addition to their access provided by the hydrology
community tools, selected data rods variables can be searched and accessed
through the GES DISC search and access user interface, and all data rods
variables can be accessed via Web services developed by the GES DISC.
The time zone is always UTC.
┌───────────────────────────────┬─────────────┬───────────────┐
│ Description/Name │ Spatial │ Time │
╞═══════════════════════════════╪═════════════╪═══════════════╡
│ NLDAS Noah Land Surface Model │ 0.125x0.125 │ 1 hour │
│ NLDAS_NOAH0125_H V002 │ degree │ │
╘═══════════════════════════════╧═════════════╧═══════════════╛
options:
-h | --help
show this help message and exit
--lat LAT
Should use 'lat' and 'lon' to specify location.
Latitude (required): Enter single geographic point by latitude.:
Example: --lat=43.1
If known, 'xindex' and 'yindex' can be used for the NLDAS grid only.
--lon LON
Should use 'lat' and 'lon' to specify location.
Longitude (required): Enter single geographic point by longitude:
Example: --lon=-85.3
If known, 'xindex' and 'yindex' can be used for the NLDAS grid only.
--xindex XINDEX
It lat or lon is None, then will try xindex and yindex.
Enter the x index of the NLDAS grid.:
Example: --xindex=301
--yindex YINDEX
It lat or lon is None, then will try xindex and yindex.
Enter the y index of the NLDAS grid.:
Example: --yindex=80
--variables VARIABLES
Use the variable codes from the following table:
┌───────────────────────────────────────┬─────────┐
│ LDAS "variables" string Description │ Units │
╞═══════════════════════════════════════╪═════════╡
│ NLDAS_NOAH0125_H.002:EVPsfc Total │ mm │
│ evapotranspiration │ │
├───────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:GFLUXsfc Ground │ W/m**2 │
│ heat flux │ │
├───────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:LHTFLsfc Latent │ W/m**2 │
│ heat flux │ │
├───────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SHTFLsfc │ W/m**2 │
│ Sensible heat flux │ │
├───────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SSRUNsfc Surface │ mm │
│ runoff (non-infiltrating) │ │
├───────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:BGRUNsfc │ mm │
│ Subsurface runoff (baseflow) │ │
├───────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SOILM0-10cm 0-10 │ mm │
│ cm soil moisture content │ │
├───────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SOILM0-100cm │ mm │
│ 0-100 cm soil moisture content │ │
├───────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SOILM0-200cm │ mm │
│ 0-200 cm soil moisture content │ │
├───────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SOILM10-40cm │ mm │
│ 10-40 cm soil moisture content │ │
├───────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SOILM40-100cm │ mm │
│ 40-100 cm soil moisture content │ │
├───────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:SOILM100-200cm │ mm │
│ 100-200 cm soil moisture content │ │
├───────────────────────────────────────┼─────────┤
│ NLDAS_NOAH0125_H.002:TSOIL0-10cm 0-10 │ K │
│ cm soil temperature │ │
╘═══════════════════════════════════════╧═════════╛
--startDate STARTDATE
The start date of the time series.:
Example: --startDate=2001-01-01T05
If startDate and endDate are None, returns the entire series.
--endDate ENDDATE
The end date of the time series.:
Example: --endDate=2002-01-05T05
If startDate and endDate are None, returns the entire series.
--variable VARIABLE
DEPRECATED: use "variables" instead to be consistent across
"tsgettoolbox".
ldas_smerge¶
$ tsgettoolbox ldas_smerge --help
usage: tsgettoolbox ldas_smerge [-h] [--lat LAT] [--lon LON] [--xindex XINDEX]
[--yindex YINDEX] [--variables VARIABLES] [--startDate STARTDATE] [--endDate
ENDDATE] [--variable VARIABLE]
This will download data from a set of water cycle related variables (Table 1)
from the North American and Global Land Data Assimilation Systems (NLDAS and
GLDAS, respectively), the Land Parameter Parameter Model (LPRM), the Tropical
Rainfall Measuring Mission (TRMM), and Gravity Recovery and Climate Experiment
(GRACE) data assimilation. In addition to their access provided by the hydrology
community tools, selected data rods variables can be searched and accessed
through the GES DISC search and access user interface, and all data rods
variables can be accessed via Web services developed by the GES DISC.
The time zone is always UTC.
┌───────────────────────────────┬─────────────┬───────────────┐
│ Description/Name │ Spatial │ Time │
╞═══════════════════════════════╪═════════════╪═══════════════╡
│ Smerge-Noah-CCI root zone │ 0.125x0.125 │ 1 day │
│ soil moisture 0-40 cm │ degree │ │
│ SMERGE_RZSM0_40CM V2.0 │ │ │
╘═══════════════════════════════╧═════════════╧═══════════════╛
options:
-h | --help
show this help message and exit
--lat LAT
Should use 'lat' and 'lon' to specify location.
Latitude (required): Enter single geographic point by latitude.:
Example: --lat=43.1
If known, 'xindex' and 'yindex' can be used for the NLDAS grid only.
--lon LON
Should use 'lat' and 'lon' to specify location.
Longitude (required): Enter single geographic point by longitude:
Example: --lon=-85.3
If known, 'xindex' and 'yindex' can be used for the NLDAS grid only.
--xindex XINDEX
It lat or lon is None, then will try xindex and yindex.
Enter the x index of the NLDAS grid.:
Example: --xindex=301
--yindex YINDEX
It lat or lon is None, then will try xindex and yindex.
Enter the y index of the NLDAS grid.:
Example: --yindex=80
--variables VARIABLES
Use the variable codes from the following table:
┌────────────────────────────────────────┬─────────┐
│ LDAS "variables" string Description │ Units │
╞════════════════════════════════════════╪═════════╡
│ SMERGE_RZSM0_40CM_2.0:CCI_ano CCI soil │ m3/m3 │
│ moisture anomalies 0-40 cm │ │
├────────────────────────────────────────┼─────────┤
│ SMERGE_RZSM0_40CM_2.0:RZSM Average │ m3/m3 │
│ soil moisture of 0-40 cm layer │ │
╘════════════════════════════════════════╧═════════╛
--startDate STARTDATE
The start date of the time series.:
Example: --startDate=2001-01-01T05
If startDate and endDate are None, returns the entire series.
--endDate ENDDATE
The end date of the time series.:
Example: --endDate=2002-01-05T05
If startDate and endDate are None, returns the entire series.
--variable VARIABLE
DEPRECATED: use "variables" instead to be consistent across
"tsgettoolbox".
ldas_trmm_tmpa¶
$ tsgettoolbox ldas_trmm_tmpa --help
usage: tsgettoolbox ldas_trmm_tmpa [-h] [--lat LAT] [--lon LON]
[--xindex XINDEX] [--yindex YINDEX] [--variables VARIABLES] [--startDate
STARTDATE] [--endDate ENDDATE] [--variable VARIABLE]
This will download data from a set of water cycle related variables (Table 1)
from the North American and Global Land Data Assimilation Systems (NLDAS and
GLDAS, respectively), the Land Parameter Parameter Model (LPRM), the Tropical
Rainfall Measuring Mission (TRMM), and Gravity Recovery and Climate Experiment
(GRACE) data assimilation. In addition to their access provided by the hydrology
community tools, selected data rods variables can be searched and accessed
through the GES DISC search and access user interface, and all data rods
variables can be accessed via Web services developed by the GES DISC.
The time zone is always UTC.
┌───────────────────────────────┬─────────────┬───────────────┐
│ Description/Name │ Spatial │ Time │
╞═══════════════════════════════╪═════════════╪═══════════════╡
│ TRMM (TMPA) Rainfall Estimate │ 0.25x0.25 │ 3 hour │
│ TRMM_3B42 V7 │ degree │ │
╘═══════════════════════════════╧═════════════╧═══════════════╛
options:
-h | --help
show this help message and exit
--lat LAT
Should use 'lat' and 'lon' to specify location.
Latitude (required): Enter single geographic point by latitude.:
Example: --lat=43.1
If known, 'xindex' and 'yindex' can be used for the NLDAS grid only.
--lon LON
Should use 'lat' and 'lon' to specify location.
Longitude (required): Enter single geographic point by longitude:
Example: --lon=-85.3
If known, 'xindex' and 'yindex' can be used for the NLDAS grid only.
--xindex XINDEX
It lat or lon is None, then will try xindex and yindex.
Enter the x index of the NLDAS grid.:
Example: --xindex=301
--yindex YINDEX
It lat or lon is None, then will try xindex and yindex.
Enter the y index of the NLDAS grid.:
Example: --yindex=80
--variables VARIABLES
Use the variable codes from the following table:
┌───────────────────────────────────────┬─────────┐
│ LDAS "variables" string Description │ Units │
╞═══════════════════════════════════════╪═════════╡
│ TRMM_3B42.7:precipitation │ mm/hr │
╘═Precipitation═════════════════════════╧═════════╛
--startDate STARTDATE
The start date of the time series.:
Example: --startDate=2001-01-01T05
If startDate and endDate are None, returns the entire series.
--endDate ENDDATE
The end date of the time series.:
Example: --endDate=2002-01-05T05
If startDate and endDate are None, returns the entire series.
--variable VARIABLE
DEPRECATED: use "variables" instead to be consistent across
"tsgettoolbox".
metdata¶
$ tsgettoolbox metdata --help
usage: tsgettoolbox metdata [-h] [--variables VARIABLES]
[--start_date START_DATE] [--end_date END_DATE] lat lon
This archive contains daily surface meteorological (METDATA) data for the
Continental United States at 4-km (1/24-deg) resolution. The meteorological
variables are maximum/minimum temperature, precipitation amount and duration,
maximum/minimum relative humidity,downward shortwave solar radiation, wind speed
and direction, and specific humidity. The method utilized here combines
desirable spatial attributes of gridded climate data from PRISM and desirable
temporal attributes of regional-scale reanalysis and daily gauge-based
precipitation from NLDAS-2 to derive a spatially and temporally complete high
resolution gridded dataset of surface meteorological variables for the
continental US for 1979-present. Validation of this data suggests that it can
serve as a suitable surrogate for landscape-scale ecological modeling across
vast unmonitored areas of the US.
Whenever you publish research based on data from this archive, please reference
this data by using the phrase "daily gridded meteorological data (METDATA) for
the continental US" and by citing the article (Abatzoglou,2012). Further,
appropriately acknowledge the National Science Foundation (NSF), Idaho EPSCoR
and the individual investigators responsible for the data set.
Citation:
Abatzoglou, J.T., 2013, Development of gridded surface meteorological data for
ecological applications and modeling, International Journal of Climatology,
DOI: 10.1002/joc.3413
geospatial_bounds_crs:
EPSG:4326
Conventions:
CF-1.0
geospatial_bounds:
POLYGON((-124.7666666333333 49.400000000000000, -124.7666666333333
25.066666666666666, -67.058333300000015 25.066666666666666,
-67.058333300000015 49.400000000000000, -124.7666666333333
49.400000000000000))
geospatial_lat_min:
25.0631
geospatial_lat_max:
49.3960
geospatial_lon_min:
-124.7722
geospatial_lon_max:
-67.0648
geospatial_lon_resolution:
0.041666666666666
geospatial_lat_resolution:
0.041666666666666
geospatial_lat_units:
decimal_degrees north
geospatial_lon_units:
decimal_degrees east
coordinate_system:
EPSG:4326
author:
John Abatzoglou - University of Idaho, jabatzoglou @ uidaho.edu
date:
02 July 2019
note1:
The projection information for this file is: GCS WGS 1984.
note3:
Data in slices after last_permanent_slice (1-based) are considered provisional
and subject to change with subsequent updates
note4:
Data in slices after last_provisional_slice (1-based) are considered early and
subject to change with subsequent updates
note5:
Days correspond approximately to calendar days ending at midnight, Mountain
Standard Time (7 UTC the next calendar day)
Metadata_Conventions:
Unidata Dataset Discovery v1.0
title:
Daily Meteorological data for continental US
keywords:
daily precipitation, daily precipitation duration, daily maximum temperature,
daily minimum temperature, daily downward shortwave solar radiation, daily
specific humidity, daily maximum relative humidity, daily minimum relative
humidity, daily wind speed, daily wind direction,
ClimatologyMeteorologyAtmosphere, Gridded Meteorological Data, EPSCoR Data
id:
UofIMETDATA
naming_authority:
cida.usgs.gov
cdm_data_type:
Grid
date_created:
2012-08-16
creator_name:
Dr. John Abatzoglou
creator_url:
<[4;36mhttp://nimbus.cos.uidaho.eud/METDATA/[0m>
creator_email:
jabatzoglou @ uidaho.edu
institution:
University of Idaho
date_issued:
2012-08-16
project:
METDATA
processing_level:
Gridded Meteorogolical Data
contributors:
Dr. John Abatzoglou
time_coverage_start:
1979-01-01T00:00
time_coverage_resolution:
P1D
license:
Freely available
positional arguments:
lat The latitude of the point. North hemisphere is positive from 0 to
90. South hemisphere is negative from 0 to -90.
lon The longitude of the point. Western hemisphere (west of Greenwich
Prime Meridian) is negative 0 to -180. The eastern hemisphere (east of the
Greenwich Prime Meridian) is positive 0 to 180.
options:
-h | --help
show this help message and exit
--variables VARIABLES
At the command line can supply a comma separated list of variable names.
Using the Python API needs to be a Python list of strings.
The current list of available METDATA variables are in the following table
and you can use either the "Short" or "Long" names.
┌──────────┬────────────────────────────────────────────────────┬───────┐
│ Short │ Long │ Units │
╞══════════╪════════════════════════════════════════════════════╪═══════╡
│ pr │ precipitation_amount │ mm │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ rmax │ daily_maximum_relative_humidity │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ rmin │ daily_minimum_relative_humidity │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ sph │ daily_mean_specific_humidity │ kg/kg │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ srad │ daily_mean_shortwave_radiation_at_surface │ W/m2 │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ tmmn │ daily_minimum_temperature │ degK │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ tmmx │ daily_maximum_temperature │ degK │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ vs │ daily_mean_wind_speed │ m/s │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ bi │ daily_mean_burning_index_g │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ fm100 │ dead_fuel_moisture_100hr │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ fm1000 │ dead_fuel_moisture_1000hr │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ erc │ daily_mean_energy_release_component-g │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ pdsi │ daily_mean_palmer_drought_severity_index │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ etr │ daily_mean_reference_evapotranspiration_alfalfa │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ pet │ daily_mean_reference_evapotranspiration_grass │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ vpd │ daily_mean_vapor_pressure_deficit │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ spi14d │ spi │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ spi30d │ spi │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ spi90d │ spi │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ spi180d │ spi │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ spi1y │ spi │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ spi2y │ spi │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ spi5y │ spi │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ spei14d │ spei │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ spei30d │ spei │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ spei90d │ spei │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ spei180d │ spei │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ spei270d │ spei │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ spei1y │ spei │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ spei2y │ spei │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ spei5y │ spei │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ eddi14d │ eddi │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ eddi30d │ eddi │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ eddi90d │ eddi │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ eddi180d │ eddi │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ eddi270d │ eddi │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ eddi1y │ eddi │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ eddi2y │ eddi │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ eddi5y │ eddi │ │
├──────────┼────────────────────────────────────────────────────┼───────┤
│ z │ daily_mean_palmer_z_index │ │
╘══════════╧════════════════════════════════════════════════════╧═══════╛
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
modis¶
$ tsgettoolbox modis --help
<string>:1594: (ERROR/3) Unknown target name: "f".
usage: tsgettoolbox modis [-h] [--start_date START_DATE] [--end_date END_DATE]
lat lon product band
This data are derived data sets from MODIS satellite photos.
The MODIS Land Cover Type product contains five classification schemes, which
describe land cover properties derived from observations spanning a year's input
of Terra- and Aqua-MODIS data. The primary land cover scheme identifies 17 land
cover classes defined by the International Geosphere Biosphere Programme (IGBP),
which includes 11 natural vegetation classes, 3 developed and mosaicked land
classes, and three non-vegetated land classes.
The MODIS Terra + Aqua Land Cover Type Yearly L3 Global 500 m SIN Grid product
incorporates five different land cover classification schemes, derived through a
supervised decision-tree classification method.
V051 Land Cover Type products are produced with revised training data and
certain algorithm refinements. For further details, please consult the following
paper:
Friedl, M. A., Sulla-Menashe, D., Tan, B., Schneider, A., Ramankutty, N.,
Sibley, A., and Huang, X. (2010). MODIS Collection 5 global land cover:
Algorithm refinements and characterization of new datasets. Remote Sensing of
Environment, 114, 168-182.
Land Cover Datasets
┌───────────────────┬──────────┬─────────────────────────────────────┐
│ Band │ Abbrev │ Description │
╞═══════════════════╪══════════╪═════════════════════════════════════╡
│ Land_Cover_Type_1 │ IGBP │ global vegetation classification │
│ │ │ scheme │
├───────────────────┼──────────┼─────────────────────────────────────┤
│ Land_Cover_Type_2 │ UMD │ University of Maryland scheme │
├───────────────────┼──────────┼─────────────────────────────────────┤
│ Land_Cover_Type_3 │ LAI/fPAR │ MODIS-derived scheme │
├───────────────────┼──────────┼─────────────────────────────────────┤
│ Land_Cover_Type_4 │ NPP │ MODIS-derived Net Primary │
│ │ │ Production (NPP) scheme │
├───────────────────┼──────────┼─────────────────────────────────────┤
│ Land_Cover_Type_5 │ PFT │ Plant Functional Type (PFT) scheme │
╘═══════════════════╧══════════╧═════════════════════════════════════╛
Land Cover Types Description
┌──────┬───────────┬───────────┬───────────┬───────────┬───────────┐
│ Code │ IGBP │ UMD │ LAI/fPAR │ NPP │ PFT │
╞══════╪═══════════╪═══════════╪═══════════╪═══════════╪═══════════╡
│ 0 │ Water │ Water │ Water │ Water │ Water │
├──────┼───────────┼───────────┼───────────┼───────────┼───────────┤
│ 1 │ Evergreen │ Evergreen │ Grasses/ │ Evergreen │ Evergreen │
│ │ Needle │ Needle │ Cereal │ Needle │ Needle │
│ │ leaf │ leaf │ crop │ leaf │ leaf │
├──────┼─forest────┼─forest────┼───────────┼───────────┼───────────┤
│ 2 │ Evergreen │ Evergreen │ Shrub │ Evergreen │ Evergreen │
│ │ Broadleaf │ Broadleaf │ │ Broadleaf │ Broadleaf │
│ │ forest │ forest │ │ │ │
├──────┼───────────┼───────────┼───────────┼───────────┼───────────┤
│ 3 │ Deciduous │ Deciduous │ Broadleaf │ Deciduous │ Deciduous │
│ │ Needle │ Needle │ crop │ Needle │ Needle │
│ │ leaf │ leaf │ │ leaf │ leaf │
├──────┼─forest────┼─forest────┼───────────┼───────────┼───────────┤
│ 4 │ Deciduous │ Deciduous │ Savanna │ Deciduous │ Deciduous │
│ │ Broadleaf │ Broadleaf │ │ Broadleaf │ Broadleaf │
│ │ forest │ forest │ │ │ │
├──────┼───────────┼───────────┼───────────┼───────────┼───────────┤
│ 5 │ Mixed │ Mixed │ Evergreen │ Annual │ Shrub │
│ │ forest │ forest │ Broadleaf │ Broadleaf │ │
│ │ │ │ forest │ │ │
├──────┼───────────┼───────────┼───────────┼───────────┼───────────┤
│ 6 │ Closed │ Closed │ Deciduous │ Annual │ Grassland │
│ │ shrubland │ shrubland │ Broadleaf │ grass │ │
│ │ │ │ forest │ │ │
├──────┼───────────┼───────────┼───────────┼───────────┼───────────┤
│ 7 │ Open │ Open │ Evergreen │ Non- │ Cereal │
│ │ shrubland │ shrubland │ Needle │ vegetated │ crops │
│ │ │ │ leaf │ land │ │
├──────┼───────────┼───────────┼─forest────┼───────────┼───────────┤
│ 8 │ Woody │ Woody │ Deciduous │ Urban │ Broad- │
│ │ savanna │ savanna │ Needle │ │ leaf │
│ │ │ │ leaf │ │ crops │
├──────┼───────────┼───────────┼─forest────┼───────────┼───────────┤
│ 9 │ Savanna │ Savanna │ Non- │ │ Urban and │
│ │ │ │ vegetated │ │ built-up │
├──────┼───────────┼───────────┼───────────┼───────────┼───────────┤
│ 10 │ Grassland │ Grassland │ Urban │ │ Snow and │
│ │ │ │ │ │ ice │
├──────┼───────────┼───────────┼───────────┼───────────┼───────────┤
│ 11 │ Permanent │ │ │ │ Barren or │
│ │ wetlands │ │ │ │ sparse │
├──────┼───────────┼───────────┼───────────┼───────────┼───────────┤
│ 12 │ Croplands │ Cropland │ │ │ │
├──────┼───────────┼───────────┼───────────┼───────────┼───────────┤
│ 13 │ Urban and │ Urban and │ │ │ │
│ │ built-up │ built-up │ │ │ │
├──────┼───────────┼───────────┼───────────┼───────────┼───────────┤
│ 14 │ Cropland │ │ │ │ │
│ │ /Natural │ │ │ │ │
│ │ mosaic │ │ │ │ │
├──────┼───────────┼───────────┼───────────┼───────────┼───────────┤
│ 15 │ Snow and │ │ │ │ │
│ │ ice │ │ │ │ │
├──────┼───────────┼───────────┼───────────┼───────────┼───────────┤
│ 16 │ Barren or │ Barren or │ │ │ │
│ │ sparsely │ sparsely │ │ │ │
│ │ vegetated │ vegetated │ │ │ │
├──────┼───────────┼───────────┼───────────┼───────────┼───────────┤
│ 254 │ Unclassi │ Unclassi │ Unclassi │ Unclassi │ Unclassi │
│ │ fied │ fied │ fied │ fied │ fies │
├──────┼───────────┼───────────┼───────────┼───────────┼───────────┤
│ 255 │ Fill │ Fill │ Fill │ Fill │ Fill │
╘══════╧═Value═════╧═Value═════╧═Value═════╧═Value═════╧═Value═════╛
positional arguments:
lat Latitude (required): Enter single geographic point by
latitude.
lon Longitude (required): Enter single geographic point by
longitude.
product One of the following values in the 'product'
column.
┌──────────────┬─────────────────────────┬───────────┬────────────┐
│ product │ Description │ Frequency │ Resolution │
│ │ │ │ (m) │
╞══════════════╪═════════════════════════╪═══════════╪════════════╡
│ ECO4ESIPTJPL │ ECOSTRESS Evaporative │ Varies │ 70 │
│ │ Stress Index PT-JPL │ │ │
├──────────────┼─(ESI)───────────────────┼───────────┼────────────┤
│ ECO4WUE │ ECOSTRESS Water Use │ Varies │ 70 │
│ │ Efficiency (WUE) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ GEDI03 │ GEDI Gridded Land │ One-time │ 1000 │
│ │ Surface Metrics (LSM) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ GEDI04_B │ GEDI Gridded │ One-time │ 1000 │
│ │ Aboveground Biomass │ │ │
├──────────────┼─Density (AGBD)──────────┼───────────┼────────────┤
│ MCD12Q1 │ MODIS/Terra+Aqua Land │ Yearly │ 500 │
│ │ Cover Type (LC) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MCD12Q2 │ MODIS/Terra+Aqua Land │ Yearly │ 500 │
│ │ Cover Dynamics (LCD) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MCD15A2H │ MODIS/Terra+Aqua Leaf │ 8-Day │ 500 │
│ │ Area Index/FPAR │ │ │
│ │ (LAI/FPAR) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MCD15A3H │ MODIS/Terra+Aqua Leaf │ 4-Day │ 500 │
│ │ Area Index/FPAR │ │ │
│ │ (LAI/FPAR) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MCD19A3 │ MODIS/Terra+Aqua BRDF │ 8-Day │ 1000 │
│ │ Model Parameters │ │ │
├──────────────┼─(MAIAC)─────────────────┼───────────┼────────────┤
│ MCD43A │ MODIS/Terra+Aqua BRDF │ Daily │ 500 │
│ │ and Calculated Albedo │ │ │
│ │ (BRDF/MCD43A) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MCD43A1 │ MODIS/Terra+Aqua │ Daily │ 500 │
│ │ BRDF/Albedo Model │ │ │
│ │ Parameters (BRDF) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MCD43A4 │ MODIS/Terra+Aqua Nadir │ Daily │ 500 │
│ │ BRDF-Adjusted │ │ │
│ │ Reflectance (NBAR) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MCD64A1 │ MODIS/Terra+Aqua Burned │ Monthly │ 500 │
│ │ Area (Burned Area) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MOD09A1 │ MODIS/Terra Surface │ 8-Day │ 500 │
│ │ Reflectance (SREF) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MOD11A2 │ MODIS/Terra Land │ 8-Day │ 1000 │
│ │ Surface Temperature and │ │ │
│ │ Emissivity (LST) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MOD13Q1 │ MODIS/Terra Vegetation │ 16-Day │ 250 │
│ │ Indices (NDVI/EVI) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MOD14A2 │ MODIS/Terra Thermal │ 8-Day │ 1000 │
│ │ Anomalies/Fire (Fire) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MOD15A2H │ MODIS/Terra Leaf Area │ 8-Day │ 500 │
│ │ Index/FPAR (LAI/FPAR) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MOD16A2 │ MODIS/Terra Net │ 8-Day │ 500 │
│ │ Evapotranspiration (ET) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MOD17A2H │ MODIS/Terra Gross │ 8-Day │ 500 │
│ │ Primary Productivity │ │ │
├──────────────┼─(GPP)───────────────────┼───────────┼────────────┤
│ MOD17A3HGF │ MODIS/Terra Net Primary │ Yearly │ 500 │
│ │ Production Gap-Filled │ │ │
│ │ (NPP) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MOD21A2 │ MODIS/Terra Land │ 8-Day │ 1000 │
│ │ Surface Temperature/3-- │ │ │
│ │ Band Emissivity (LSTE) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MOD44B │ MODIS/Terra Vegetation │ Yearly │ 250 │
│ │ Continuous Fields (VCF) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MYD09A1 │ MODIS/Aqua Surface │ 8-Day │ 500 │
│ │ Reflectance (SREF) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MYD11A2 │ MODIS/Aqua Land Surface │ 8-Day │ 1000 │
│ │ Temperature and │ │ │
│ │ Emissivity (LST) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MYD13Q1 │ MODIS/Aqua Vegetation │ 16-Day │ 250 │
│ │ Indices (NDVI/EVI) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MYD14A2 │ MODIS/Aqua Thermal │ 8-Day │ 1000 │
│ │ Anomalies/Fire (Fire) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MYD15A2H │ MODIS/Aqua Leaf Area │ 8-Day │ 500 │
│ │ Index/FPAR (LAI/FPAR) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MYD16A2 │ MODIS/Aqua Net │ 8-Day │ 500 │
│ │ Evapotranspiration (ET) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MYD17A2H │ MODIS/Aqua Gross │ 8-Day │ 500 │
│ │ Primary Productivity │ │ │
├──────────────┼─(GPP)───────────────────┼───────────┼────────────┤
│ MYD17A3HGF │ MODIS/Aqua Net Primary │ Yearly │ 500 │
│ │ Production Gap-Filled │ │ │
│ │ (NPP) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ MYD21A2 │ MODIS/Aqua Land Surface │ 8-Day │ 1000 │
│ │ Temperature/3-Band │ │ │
│ │ Emissivity (LSTE) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ SIF005 │ SIF Estimates from │ Monthly │ 5000 │
│ │ Fused SCIAMACHY and │ │ │
│ │ GOME-2 (SIF) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ SIF_ANN │ SIF Estimates from │ 16-day │ 5000 │
│ │ OCO-2 SIF and MODIS │ │ │
├──────────────┼─(SIF)───────────────────┼───────────┼────────────┤
│ VNP09A1 │ VIIRS/S-NPP Surface │ 8-Day │ 1000 │
│ │ Reflectance (SREF) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ VNP09H1 │ VIIRS/S-NPP Surface │ 8-Day │ 500 │
│ │ Reflectance (SREF) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ VNP13A1 │ VIIRS/S-NPP Vegetation │ 16-Day │ 500 │
│ │ Indices (NDVI/EVI) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ VNP15A2H │ VIIRS/S-NPP Leaf Area │ 8-Day │ 500 │
│ │ Index/FPAR (LAI/FPAR) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ VNP21A2 │ VIIRS/S-NPP Land │ 8-Day │ 1000 │
│ │ Surface Temperature and │ │ │
│ │ Emissivity (LSTE) │ │ │
├──────────────┼─────────────────────────┼───────────┼────────────┤
│ VNP22Q2 │ VIIRS/S-NPP Land Cover │ Yearly │ 500 │
│ │ Dynamics (LCD) │ │ │
╘══════════════╧═════════════════════════╧═══════════╧════════════╛
band One of the following. The 'band' selected from the first column must
match the 'product' keyword in the table title.
ECO4ESIPTJPL
┌────────┬───────────────────────────┬──────────────┬───────────┐
│ band │ Description │ Units │ Range │
╞════════╪═══════════════════════════╪══════════════╪═══════════╡
│ ESIavg │ Evaporative Stress Index │ ratio_ET/PET │ 0 to 2 │
├────────┼───────────────────────────┼──────────────┼───────────┤
│ PET │ Potential Evapotranspira- │ W/m^2 │ 0 to 2000 │
│ │ tion │ │ │
╘════════╧═══════════════════════════╧══════════════╧═══════════╛
ECO4WUE
┌────────┬──────────────────────┬──────────────┬──────────┐
│ band │ Description │ Units │ Range │
╞════════╪══════════════════════╪══════════════╪══════════╡
│ WUEavg │ Water Use Efficiency │ ratio_GPP/ET │ 0 to 20 │
╘════════╧══════════════════════╧══════════════╧══════════╛
GEDI03
┌────────────────────────┬──────────────────────────────┬────────┐
│ band │ Description │ Units │
╞════════════════════════╪══════════════════════════════╪════════╡
│ counts │ count of valid laser │ counts │
│ │ footprints │ │
├────────────────────────┼──────────────────────────────┼────────┤
│ elev_lowestmode_mean │ mean elevation of the lowest │ meters │
│ │ mode │ │
├────────────────────────┼──────────────────────────────┼────────┤
│ elev_lowestmode_stddev │ stddev elevation of the │ meters │
│ │ lowest mode │ │
├────────────────────────┼──────────────────────────────┼────────┤
│ rh100_mean │ mean 100th percentile of │ meters │
│ │ waveform energy relative to │ │
│ │ ground │ │
├────────────────────────┼──────────────────────────────┼────────┤
│ rh100_stddev │ stddev 100th percentile of │ meters │
│ │ waveform energy relative to │ │
│ │ ground │ │
╘════════════════════════╧══════════════════════════════╧════════╛
GEDI04_B
┌────────┬──────────────────────────────────┬─────────┐
│ band │ Description │ Units │
╞════════╪══════════════════════════════════╪═════════╡
│ MI │ mode of interference │ │
├────────┼──────────────────────────────────┼─────────┤
│ MU │ mean aboveground biomass density │ Mg/ha │
├────────┼──────────────────────────────────┼─────────┤
│ NC │ number of clusters │ counts │
├────────┼──────────────────────────────────┼─────────┤
│ NS │ number of samples │ counts │
├────────┼──────────────────────────────────┼─────────┤
│ PE │ standard error as a fraction of │ percent │
│ │ the estimated mean AGBD │ │
├────────┼──────────────────────────────────┼─────────┤
│ PS │ prediction stratum │ │
├────────┼──────────────────────────────────┼─────────┤
│ QF │ quality flag │ │
├────────┼──────────────────────────────────┼─────────┤
│ SE │ mean aboveground biomass density │ Mg/ha │
│ │ standard error │ │
├────────┼──────────────────────────────────┼─────────┤
│ V1 │ variance component 1 │ │
├────────┼──────────────────────────────────┼─────────┤
│ V2 │ variance component 2 │ │
╘════════╧══════════════════════════════════╧═════════╛
MCD12Q1
┌─────────────────────┬─────────────────────┬─────────┬──────────┐
│ band │ Description │ Units │ Range │
╞═════════════════════╪═════════════════════╪═════════╪══════════╡
│ LC_Prop1 │ FAO-Land Cover │ class │ 1 to 43 │
│ │ Classification │ │ │
│ │ System 1 (LCCS1) │ │ │
│ │ land cover layer │ │ │
├─────────────────────┼─────────────────────┼─────────┼──────────┤
│ LC_Prop1_Assessment │ LCCS1 land cover │ percent │ 0 to 100 │
│ │ layer confidence │ │ │
├─────────────────────┼─────────────────────┼─────────┼──────────┤
│ LC_Prop2 │ FAO-LCCS2 land use │ class │ 1 to 40 │
│ │ layer │ │ │
├─────────────────────┼─────────────────────┼─────────┼──────────┤
│ LC_Prop2_Assessment │ LCCS2 land use │ percent │ 0 to 100 │
│ │ layer confidence │ │ │
├─────────────────────┼─────────────────────┼─────────┼──────────┤
│ LC_Prop3 │ FAO-LCCS3 surface │ class │ 1 to 51 │
│ │ hydrology layer │ │ │
├─────────────────────┼─────────────────────┼─────────┼──────────┤
│ LC_Prop3_Assessment │ LCCS3 surface │ percent │ 0 to 100 │
│ │ hydrology layer │ │ │
│ │ confidence │ │ │
├─────────────────────┼─────────────────────┼─────────┼──────────┤
│ LC_Type1 │ Land Cover Type 1: │ class │ 1 to 17 │
│ │ Annual Internation- │ │ │
│ │ al Geosphere- │ │ │
│ │ Biosphere Programme │ │ │
│ │ (IGBP) classificat- │ │ │
├─────────────────────┼─ion─────────────────┼─────────┼──────────┤
│ LC_Type2 │ Land Cover Type 2: │ class │ 0 to 15 │
│ │ Annual University │ │ │
│ │ of Maryland (UMD) │ │ │
│ │ classification │ │ │
├─────────────────────┼─────────────────────┼─────────┼──────────┤
│ LC_Type3 │ Land Cover Type 3: │ class │ 0 to 10 │
│ │ Annual Leaf Area │ │ │
│ │ Index (LAI) │ │ │
│ │ classification │ │ │
├─────────────────────┼─────────────────────┼─────────┼──────────┤
│ LC_Type4 │ Land Cover Type 4: │ class │ 0 to 8 │
│ │ Annual BIOME- │ │ │
│ │ Biogeochemical │ │ │
│ │ Cycles (BGC) │ │ │
├─────────────────────┼─classification──────┼─────────┼──────────┤
│ LC_Type5 │ Land Cover Type 5: │ class │ 0 to 11 │
│ │ Annual Plant │ │ │
│ │ Functional Types │ │ │
│ │ classification │ │ │
├─────────────────────┼─────────────────────┼─────────┼──────────┤
│ LW │ Binary land (class │ class │ 1 to 2 │
│ │ 2) / water (class │ │ │
│ │ 1) mask derived │ │ │
│ │ from MOD44W │ │ │
├─────────────────────┼─────────────────────┼─────────┼──────────┤
│ QC │ Product quality │ quality │ 0 to 10 │
│ │ flags │ flag │ │
╘═════════════════════╧═════════════════════╧═════════╧══════════╛
MCD12Q2
┌────────────────────────────┬────────────────┬────────────┬──────────┐
│ band │ Description │ Units │ Range │
╞════════════════════════════╪════════════════╪════════════╪══════════╡
│ Dormancy.Num_Modes_01 │ Onset Dormancy │ days since │ 11138 to │
│ │ │ 1970-01-01 │ 32766 │
├────────────────────────────┼────────────────┼────────────┼──────────┤
│ Dormancy.Num_Modes_02 │ Onset Dormancy │ days since │ 11138 to │
│ │ │ 1970-01-01 │ 32766 │
├────────────────────────────┼────────────────┼────────────┼──────────┤
│ EVI_Amplitude.Num_Modes_01 │ EVI Amplitude │ NBAR-EVI2 │ 0 to │
├────────────────────────────┼────────────────┼────────────┼─10000────┤
│ EVI_Amplitude.Num_Modes_02 │ EVI Amplitude │ NBAR-EVI2 │ 0 to │
├────────────────────────────┼────────────────┼────────────┼─10000────┤
│ EVI_Area.Num_Modes_01 │ EVI Area │ NBAR-EVI2 │ 0 to │
├────────────────────────────┼────────────────┼────────────┼─3700─────┤
│ EVI_Area.Num_Modes_02 │ EVI Area │ NBAR-EVI2 │ 0 to │
├────────────────────────────┼────────────────┼────────────┼─3700─────┤
│ EVI_Minimum.Num_Modes_01 │ Minimum EVI │ NBAR-EVI2 │ 0 to │
├────────────────────────────┼────────────────┼────────────┼─10000────┤
│ EVI_Minimum.Num_Modes_02 │ Minimum EVI │ NBAR-EVI2 │ 0 to │
├────────────────────────────┼────────────────┼────────────┼─10000────┤
│ Greenup.Num_Modes_01 │ Onset Greenne- │ days since │ 11138 to │
│ │ ss Increase │ 1970-01-01 │ 32766 │
├────────────────────────────┼────────────────┼────────────┼──────────┤
│ Greenup.Num_Modes_02 │ Onset Greenne- │ days since │ 11138 to │
│ │ ss Increase │ 1970-01-01 │ 32766 │
├────────────────────────────┼────────────────┼────────────┼──────────┤
│ Maturity.Num_Modes_01 │ Onset Maturity │ days since │ 11138 to │
│ │ │ 1970-01-01 │ 32766 │
├────────────────────────────┼────────────────┼────────────┼──────────┤
│ Maturity.Num_Modes_02 │ Onset Maturity │ days since │ 11138 to │
│ │ │ 1970-01-01 │ 32766 │
├────────────────────────────┼────────────────┼────────────┼──────────┤
│ MidGreendown.Num_Modes_01 │ Middle Greenn- │ days since │ 11138 to │
│ │ ess Decrease │ 1970-01-01 │ 32766 │
├────────────────────────────┼────────────────┼────────────┼──────────┤
│ MidGreendown.Num_Modes_02 │ Middle Greenn- │ days since │ 11138 to │
│ │ ess Decrease │ 1970-01-01 │ 32766 │
├────────────────────────────┼────────────────┼────────────┼──────────┤
│ MidGreenup.Num_Modes_01 │ Middle Greenn- │ days sinc- │ 11138 to │
│ │ ess Increase │ e_19 70-0- │ 32766 │
│ │ │ 1-01 │ │
├────────────────────────────┼────────────────┼────────────┼──────────┤
│ MidGreenup.Num_Modes_02 │ Middle Greenn- │ days since │ 11138 to │
│ │ ess Increase │ 1970-01-01 │ 32766 │
├────────────────────────────┼────────────────┼────────────┼──────────┤
│ NumCycles │ Number of │ │ 0 to 7 │
├────────────────────────────┼─Cycles─────────┼────────────┼──────────┤
│ QA_Detailed.Num_Modes_01 │ Quality │ │ 0 to │
│ │ Assessment │ │ 16383 │
│ │ Detailed │ │ │
├────────────────────────────┼────────────────┼────────────┼──────────┤
│ QA_Detailed.Num_Modes_02 │ Quality │ │ 0 to │
│ │ Assessment │ │ 16383 │
│ │ Detailed │ │ │
├────────────────────────────┼────────────────┼────────────┼──────────┤
│ QA_Overall.Num_Modes_01 │ Quality │ │ 0 to 3 │
│ │ Assessment │ │ │
│ │ Overall │ │ │
├────────────────────────────┼────────────────┼────────────┼──────────┤
│ QA_Overall.Num_Modes_02 │ Quality │ │ 0 to 3 │
│ │ Assessment │ │ │
│ │ Overall │ │ │
╘════════════════════════════╧════════════════╧════════════╧══════════╛
MCD15A2H
┌─────────────────┬──────────────────────────┬─────────┬──────────┐
│ band │ Description │ Units │ Range │
╞═════════════════╪══════════════════════════╪═════════╪══════════╡
│ FparExtra_QC │ Extra detail Quality for │ class │ 0 to 254 │
│ │ LAI and FPAR │ flag │ │
├─────────────────┼──────────────────────────┼─────────┼──────────┤
│ FparLai_QC │ Quality for LAI and FPAR │ class │ 0 to 254 │
│ │ │ flag │ │
├─────────────────┼──────────────────────────┼─────────┼──────────┤
│ FparStdDev_500m │ Standard deviation of │ percent │ 0 to 100 │
├─────────────────┼─FPAR─────────────────────┼─────────┼──────────┤
│ Fpar_500m │ Fraction of photosynthe- │ percent │ 0 to 100 │
│ │ tically active radiation │ │ │
│ │ │ │ │
├─────────────────┼──────────────────────────┼─────────┼──────────┤
│ LaiStdDev_500m │ Standard deviation for │ m^2/m^2 │ 0 to 100 │
├─────────────────┼─LAI──────────────────────┼─────────┼──────────┤
│ Lai_500m │ Leaf area index │ m^2/m^2 │ 0 to 100 │
╘═════════════════╧══════════════════════════╧═════════╧══════════╛
MCD15A3H
┌─────────────────┬──────────────────────┬─────────┬──────────┐
│ band │ Description │ Units │ Range │
╞═════════════════╪══════════════════════╪═════════╪══════════╡
│ FparExtra_QC │ Extra detail Quality │ class │ 0 to 254 │
│ │ for LAI and FPAR │ flag │ │
├─────────────────┼──────────────────────┼─────────┼──────────┤
│ FparLai_QC │ Quality for LAI and │ class │ 0 to 254 │
│ │ FPAR │ flag │ │
├─────────────────┼──────────────────────┼─────────┼──────────┤
│ FparStdDev_500m │ Standard deviation │ percent │ 0 to 100 │
│ │ of FPAR │ │ │
├─────────────────┼──────────────────────┼─────────┼──────────┤
│ Fpar_500m │ Fraction of │ percent │ 0 to 100 │
│ │ photosynthetically │ │ │
│ │ active radiation │ │ │
├─────────────────┼──────────────────────┼─────────┼──────────┤
│ LaiStdDev_500m │ Standard deviation │ m^2/m^2 │ 0 to 100 │
│ │ for LAI │ │ │
├─────────────────┼──────────────────────┼─────────┼──────────┤
│ Lai_500m │ Leaf area index │ m^2/m^2 │ 0 to 100 │
╘═════════════════╧══════════════════════╧═════════╧══════════╛
MCD19A3
┌────────────┬──────────────────────────────┬───────────┐
│ band │ Description │ Range │
╞════════════╪══════════════════════════════╪═══════════╡
│ Kgeo │ RTLS geometric kernel │ -32766 to │
│ │ parameter for bands 1-8 │ 32767 │
├────────────┼──────────────────────────────┼───────────┤
│ Kiso │ RTLS isotropic kernel │ -32766 to │
│ │ parameter for bands 1-8 │ 32767 │
├────────────┼──────────────────────────────┼───────────┤
│ Kvol │ RTLS volumetric kernel │ -32766 to │
│ │ parameter for bands 1-8 │ 32767 │
├────────────┼──────────────────────────────┼───────────┤
│ Sur_albedo │ Surface albedo for bands 1-8 │ -100 to │
│ │ │ 16000 │
├────────────┼──────────────────────────────┼───────────┤
│ UpdateDay │ Number of days since last │ 0 to 254 │
│ │ update to the current day │ │
╘════════════╧══════════════════════════════╧═══════════╛
MCD43A
┌──────────────────┬────────────────────────────┐
│ band │ Description │
╞══════════════════╪════════════════════════════╡
│ nir_actual │ Blue-sky albedo nir │
├──────────────────┼────────────────────────────┤
│ nir_black │ Black-sky albedo nir │
├──────────────────┼────────────────────────────┤
│ nir_white │ White-sky albedo nir │
├──────────────────┼────────────────────────────┤
│ shortwave_actual │ Blue-sky albedo shortwave │
├──────────────────┼────────────────────────────┤
│ shortwave_black │ Black-sky albedo shortwave │
├──────────────────┼────────────────────────────┤
│ shortwave_white │ White-sky albedo shortwave │
├──────────────────┼────────────────────────────┤
│ vis_actual │ Blue-sky albedo vis │
├──────────────────┼────────────────────────────┤
│ vis_black │ Black-sky albedo vis │
├──────────────────┼────────────────────────────┤
│ vis_white │ White-sky albedo vis │
╘══════════════════╧════════════════════════════╛
MCD43A1
┌──────────────────────────────────────────────┬─────────────┬───────────┬─────────┐
│ band │ Description │ Units │ Range │
╞══════════════════════════════════════════════╪═════════════╪═══════════╪═════════╡
│ BDRF_Albedo_Band_Mandatory_Quality_Band1 │ Quality │ bit field │ 0 to │
├──────────────────────────────────────────────┼─Band1───────┼───────────┼─254─────┤
│ BDRF_Albedo_Band_Mandatory_Quality_Band2 │ Quality │ bit field │ 0 to │
├──────────────────────────────────────────────┼─Band2───────┼───────────┼─254─────┤
│ BDRF_Albedo_Band_Mandatory_Quality_Band3 │ Quality │ bit field │ 0 to │
├──────────────────────────────────────────────┼─Band3───────┼───────────┼─254─────┤
│ BDRF_Albedo_Band_Mandatory_Quality_Band4 │ Quality │ bit field │ 0 to │
├──────────────────────────────────────────────┼─Band4───────┼───────────┼─254─────┤
│ BDRF_Albedo_Band_Mandatory_Quality_Band5 │ Quality │ bit field │ 0 to │
├──────────────────────────────────────────────┼─Band5───────┼───────────┼─254─────┤
│ BDRF_Albedo_Band_Mandatory_Quality_Band6 │ Quality │ bit field │ 0 to │
├──────────────────────────────────────────────┼─Band6───────┼───────────┼─254─────┤
│ BDRF_Albedo_Band_Mandatory_Quality_Band7 │ Quality │ bit field │ 0 to │
├──────────────────────────────────────────────┼─Band7───────┼───────────┼─254─────┤
│ BDRF_Albedo_Band_Mandatory_Quality_nir │ Quality nir │ bit field │ 0 to │
├──────────────────────────────────────────────┼─────────────┼───────────┼─254─────┤
│ BDRF_Albedo_Band_Mandatory_Quality_shortwave │ Quality │ bit field │ 0 to │
│ │ shortwave │ │ 254 │
├──────────────────────────────────────────────┼─────────────┼───────────┼─────────┤
│ BDRF_Albedo_Band_Mandatory_Quality_vis │ Quality vis │ bit field │ 0 to │
├──────────────────────────────────────────────┼─────────────┼───────────┼─254─────┤
│ BRDF_Albedo_Parameters_Band1 │ Parameters │ │ 0 to │
│ │ Band1 │ │ 32766 │
├──────────────────────────────────────────────┼─────────────┼───────────┼─────────┤
│ BRDF_Albedo_Parameters_Band2 │ Parameters │ │ 0 to │
│ │ Band2 │ │ 32766 │
├──────────────────────────────────────────────┼─────────────┼───────────┼─────────┤
│ BRDF_Albedo_Parameters_Band3 │ Parameters │ │ 0 to │
│ │ Band3 │ │ 32766 │
├──────────────────────────────────────────────┼─────────────┼───────────┼─────────┤
│ BRDF_Albedo_Parameters_Band4 │ Parameters │ │ 0 to │
│ │ Band4 │ │ 32766 │
├──────────────────────────────────────────────┼─────────────┼───────────┼─────────┤
│ BRDF_Albedo_Parameters_Band5 │ Parameters │ │ 0 to │
│ │ Band5 │ │ 32766 │
├──────────────────────────────────────────────┼─────────────┼───────────┼─────────┤
│ BRDF_Albedo_Parameters_Band6 │ Parameters │ │ 0 to │
│ │ Band6 │ │ 32766 │
├──────────────────────────────────────────────┼─────────────┼───────────┼─────────┤
│ BRDF_Albedo_Parameters_Band7 │ Parameters │ │ 0 to │
│ │ Band7 │ │ 32766 │
├──────────────────────────────────────────────┼─────────────┼───────────┼─────────┤
│ BRDF_Albedo_Parameters_nir │ Parameters │ │ 0 to │
│ │ nir │ │ 32766 │
├──────────────────────────────────────────────┼─────────────┼───────────┼─────────┤
│ BRDF_Albedo_Parameters_shortwave │ Parameters │ │ 0 to │
│ │ shortwave │ │ 32766 │
├──────────────────────────────────────────────┼─────────────┼───────────┼─────────┤
│ BRDF_Albedo_Parameters_vis │ Parameters │ │ 0 to │
│ │ vis │ │ 32766 │
╘══════════════════════════════════════════════╧═════════════╧═══════════╧═════════╛
MCD43A4
┌──────────────────────────────────────────┬─────────────┬──────────────┬─────────┐
│ band │ Description │ Units │ Range │
╞══════════════════════════════════════════╪═════════════╪══════════════╪═════════╡
│ BRDF_Albedo_Band_Mandatory_Quality_Band1 │ Quality │ concatenated │ 0 to │
│ │ Band1 │ flags │ 254 │
├──────────────────────────────────────────┼─────────────┼──────────────┼─────────┤
│ BRDF_Albedo_Band_Mandatory_Quality_Band2 │ Quality │ concatenated │ 0 to │
│ │ Band2 │ flags │ 254 │
├──────────────────────────────────────────┼─────────────┼──────────────┼─────────┤
│ BRDF_Albedo_Band_Mandatory_Quality_Band3 │ Quality │ concatenated │ 0 to │
│ │ Band3 │ flags │ 254 │
├──────────────────────────────────────────┼─────────────┼──────────────┼─────────┤
│ BRDF_Albedo_Band_Mandatory_Quality_Band4 │ Quality │ concatenated │ 0 to │
│ │ Band4 │ flags │ 254 │
├──────────────────────────────────────────┼─────────────┼──────────────┼─────────┤
│ BRDF_Albedo_Band_Mandatory_Quality_Band5 │ Quality │ concatenated │ 0 to │
│ │ Band5 │ flags │ 254 │
├──────────────────────────────────────────┼─────────────┼──────────────┼─────────┤
│ BRDF_Albedo_Band_Mandatory_Quality_Band6 │ Quality │ concatenated │ 0 to │
│ │ Band6 │ flags │ 254 │
├──────────────────────────────────────────┼─────────────┼──────────────┼─────────┤
│ BRDF_Albedo_Band_Mandatory_Quality_Band7 │ Quality │ concatenated │ 0 to │
│ │ Band7 │ flags │ 254 │
├──────────────────────────────────────────┼─────────────┼──────────────┼─────────┤
│ Nadir_Reflectance_Band1 │ Nadir │ │ 0 to │
│ │ Reflectance │ │ 32766 │
│ │ Band1 │ │ │
├──────────────────────────────────────────┼─────────────┼──────────────┼─────────┤
│ Nadir_Reflectance_Band2 │ Nadir │ │ 0 to │
│ │ Reflectance │ │ 32766 │
│ │ Band2 │ │ │
├──────────────────────────────────────────┼─────────────┼──────────────┼─────────┤
│ Nadir_Reflectance_Band3 │ Nadir │ │ 0 to │
│ │ Reflectance │ │ 32766 │
│ │ Band3 │ │ │
├──────────────────────────────────────────┼─────────────┼──────────────┼─────────┤
│ Nadir_Reflectance_Band4 │ Nadir │ │ 0 to │
│ │ Reflectance │ │ 32766 │
│ │ Band4 │ │ │
├──────────────────────────────────────────┼─────────────┼──────────────┼─────────┤
│ Nadir_Reflectance_Band5 │ Nadir │ │ 0 to │
│ │ Reflectance │ │ 32766 │
│ │ Band5 │ │ │
├──────────────────────────────────────────┼─────────────┼──────────────┼─────────┤
│ Nadir_Reflectance_Band6 │ Nadir │ │ 0 to │
│ │ Reflectance │ │ 32766 │
│ │ Band6 │ │ │
├──────────────────────────────────────────┼─────────────┼──────────────┼─────────┤
│ Nadir_Reflectance_Band7 │ Nadir │ │ 0 to │
│ │ Reflectance │ │ 32766 │
│ │ Band7 │ │ │
╘══════════════════════════════════════════╧═════════════╧══════════════╧═════════╛
MCD64A1
┌───────────────────────┬──────────────────────┬─────────┬─────────┐
│ band │ Description │ Units │ Range │
╞═══════════════════════╪══════════════════════╪═════════╪═════════╡
│ Burn_Date │ ordinal day of burn │ day of │ 0 to │
│ │ │ year │ 366 │
├───────────────────────┼──────────────────────┼─────────┼─────────┤
│ Burn_Date_Uncertainty │ uncertainty in day │ days │ 0 to │
│ │ of burn │ │ 100 │
├───────────────────────┼──────────────────────┼─────────┼─────────┤
│ First_Day │ first day of │ day of │ 1 to │
│ │ reliable change │ year │ 366 │
├───────────────────────┼─detection────────────┼─────────┼─────────┤
│ Last_Day │ last day of reliable │ day of │ 1 to │
│ │ change detection │ year │ 366 │
├───────────────────────┼──────────────────────┼─────────┼─────────┤
│ QA │ quality assurance │ bit │ 0 to │
│ │ indicators │ field │ 255 │
╘═══════════════════════╧══════════════════════╧═════════╧═════════╛
MOD09A1
┌──────────────────────┬─────────────────────┬─────────────┬────────────┐
│ band │ Description │ Units │ Range │
╞══════════════════════╪═════════════════════╪═════════════╪════════════╡
│ sur_refl_b01 │ Surface reflectance │ reflectance │ -100 to │
│ │ for band 1 │ │ 16000 │
├──────────────────────┼─────────────────────┼─────────────┼────────────┤
│ sur_refl_b02 │ Surface reflectance │ reflectance │ -100 to │
│ │ for band 2 │ │ 16000 │
├──────────────────────┼─────────────────────┼─────────────┼────────────┤
│ sur_refl_b03 │ Surface reflectance │ reflectance │ -100 to │
│ │ for band 3 │ │ 16000 │
├──────────────────────┼─────────────────────┼─────────────┼────────────┤
│ sur_refl_b04 │ Surface reflectance │ reflectance │ -100 to │
│ │ for band 4 │ │ 16000 │
├──────────────────────┼─────────────────────┼─────────────┼────────────┤
│ sur_refl_b05 │ Surface reflectance │ reflectance │ -100 to │
│ │ for band 5 │ │ 16000 │
├──────────────────────┼─────────────────────┼─────────────┼────────────┤
│ sur_refl_b06 │ Surface reflectance │ reflectance │ -100 to │
│ │ for band 6 │ │ 16000 │
├──────────────────────┼─────────────────────┼─────────────┼────────────┤
│ sur_refl_b07 │ Surface reflectance │ reflectance │ -100 to │
│ │ for band 7 │ │ 16000 │
├──────────────────────┼─────────────────────┼─────────────┼────────────┤
│ sur_refl_day of year │ Surface reflectance │ day of year │ 0 to 366 │
│ │ day of year │ │ │
├──────────────────────┼─────────────────────┼─────────────┼────────────┤
│ sur_refl_qc_500m │ Surface reflectance │ bit field │ 0 to 4294- │
│ │ 500m quality │ │ 966531 │
│ │ control flags │ │ │
├──────────────────────┼─────────────────────┼─────────────┼────────────┤
│ sur_refl_raz │ Relative azimuth │ degree │ -18000 to │
│ │ │ │ 18000 │
├──────────────────────┼─────────────────────┼─────────────┼────────────┤
│ sur_refl_state_500m │ Surface reflectance │ bit field │ 0 to 57343 │
│ │ 500m state flags │ │ │
├──────────────────────┼─────────────────────┼─────────────┼────────────┤
│ sur_refl_szen │ Solar zenith │ degree │ 0 to 18000 │
├──────────────────────┼─────────────────────┼─────────────┼────────────┤
│ sur_refl_vzen │ View zenith │ degree │ 0 to 18000 │
╘══════════════════════╧═════════════════════╧═════════════╧════════════╛
MOD11A2
┌──────────────────┬────────────────────┬─────────┬─────────┐
│ band │ Description │ Range │ Units │
╞══════════════════╪════════════════════╪═════════╪═════════╡
│ Clear_sky_days │ Day clear-sky │ 1 to │ │
│ │ coverage │ 255 │ │
├──────────────────┼────────────────────┼─────────┼─────────┤
│ Clear_sky_nights │ Night clear-sky │ 1 to │ │
│ │ coverage │ 255 │ │
├──────────────────┼────────────────────┼─────────┼─────────┤
│ Day_view_angl │ View zenith angle │ 0 to │ degree │
│ │ of day observation │ 130 │ │
├──────────────────┼────────────────────┼─────────┼─────────┤
│ Day_view_time │ Local time of day │ 0 to │ hrs │
│ │ observation │ 240 │ │
├──────────────────┼────────────────────┼─────────┼─────────┤
│ Emis_31 │ Band 31 emissivity │ 1 to │ │
├──────────────────┼────────────────────┼─255─────┼─────────┤
│ Emis_32 │ Band 32 emissivity │ 1 to │ │
├──────────────────┼────────────────────┼─255─────┼─────────┤
│ LST_Day_1km │ Daytime Land │ 7500 to │ degK │
│ │ Surface Temperatu- │ 65535 │ │
├──────────────────┼─re─────────────────┼─────────┼─────────┤
│ LST_Night_1km │ Night Land Surface │ 7500 to │ degK │
│ │ Temperature │ 65535 │ │
├──────────────────┼────────────────────┼─────────┼─────────┤
│ Night_view_angl │ View zenith angle │ 0 to │ degree │
│ │ of night observat- │ 130 │ │
├──────────────────┼─ion────────────────┼─────────┼─────────┤
│ Night_view_time │ Local time of │ 0 to │ hrs │
│ │ night observation │ 240 │ │
├──────────────────┼────────────────────┼─────────┼─────────┤
│ QC_Day │ Daytime LST │ 0 to │ │
│ │ Quality Indicators │ 255 │ │
├──────────────────┼────────────────────┼─────────┼─────────┤
│ QC_Night │ Nighttime LST │ 0 to │ │
│ │ Quality indicators │ 255 │ │
╘══════════════════╧════════════════════╧═════════╧═════════╛
MOD13Q1
┌────────────────────────────────────────┬───────────────┬─────────────┬──────────┐
│ band │ Description │ Units │ Range │
╞════════════════════════════════════════╪═══════════════╪═════════════╪══════════╡
│ 250m_16_days_blue_reflectance │ Surface │ reflectance │ 0 to │
│ │ Reflectance │ │ 10000 │
│ │ Band 3 │ │ │
├────────────────────────────────────────┼───────────────┼─────────────┼──────────┤
│ 250m_16_days_composite_day_of_the_year │ Day of year │ day of year │ 1 to 366 │
│ │ VI pixel │ │ │
├────────────────────────────────────────┼───────────────┼─────────────┼──────────┤
│ 250m_16_days_EVI │ 16 day EVI │ │ -2000 to │
│ │ average │ │ 10000 │
├────────────────────────────────────────┼───────────────┼─────────────┼──────────┤
│ 250m_16_days_MIR_reflectance │ Surface │ reflectance │ 0 to │
│ │ Reflectance │ │ 10000 │
│ │ Band 7 │ │ │
├────────────────────────────────────────┼───────────────┼─────────────┼──────────┤
│ 250m_16_days_NDVI │ 16 day NDVI │ │ -2000 to │
│ │ average │ │ 10000 │
├────────────────────────────────────────┼───────────────┼─────────────┼──────────┤
│ 250m_16_days_NIR_reflectance │ Surface │ reflectance │ 0 to │
│ │ Reflectance │ │ 10000 │
│ │ Band 2 │ │ │
├────────────────────────────────────────┼───────────────┼─────────────┼──────────┤
│ 250m_16_days_pixel_reliability │ Quality │ rank │ 0 to 3 │
│ │ reliability │ │ │
│ │ of VI pixel │ │ │
├────────────────────────────────────────┼───────────────┼─────────────┼──────────┤
│ 250m_16_days_red_reflectance │ Surface │ reflectance │ 0 to │
│ │ Reflectance │ │ 10000 │
│ │ Band 1 │ │ │
├────────────────────────────────────────┼───────────────┼─────────────┼──────────┤
│ 250m_16_days_relative_azimuth_angle │ Relative │ degrees │ -3600 to │
│ │ azimuth angle │ │ 3600 │
│ │ of VI pixel │ │ │
├────────────────────────────────────────┼───────────────┼─────────────┼──────────┤
│ 250m_16_days_sun_zenith_angle │ Sun zenith │ degrees │ -9000 to │
│ │ angle of VI │ │ 9000 │
│ │ pixel │ │ │
├────────────────────────────────────────┼───────────────┼─────────────┼──────────┤
│ 250m_16_days_view_zenith_angle │ View zenith │ degrees │ -9000 to │
│ │ angle of VI │ │ 9000 │
│ │ Pixel │ │ │
├────────────────────────────────────────┼───────────────┼─────────────┼──────────┤
│ 250m_16_days_VI_Quality │ VI quality │ bit field │ 0 to │
│ │ indicators │ │ 65534 │
╘════════════════════════════════════════╧═══════════════╧═════════════╧══════════╛
MOD14A2
┌──────────┬───────────────┬────────────┬─────────┐
│ band │ Description │ Units │ Range │
╞══════════╪═══════════════╪════════════╪═════════╡
│ FireMask │ fire mask │ class flag │ 1 to 9 │
├──────────┼───────────────┼────────────┼─────────┤
│ QA │ pixel quality │ bit field │ 0 to 6 │
╘══════════╧═══════════════╧════════════╧═════════╛
MOD15A2H
┌─────────────────┬────────────────────────────────┬────────────┬─────────┐
│ band │ Description │ Units │ Range │
╞═════════════════╪════════════════════════════════╪════════════╪═════════╡
│ FparExtra_QC │ Extra detail Quality for LAI │ class flag │ 0 to │
│ │ and FPAR │ │ 254 │
├─────────────────┼────────────────────────────────┼────────────┼─────────┤
│ FparLai_QC │ Quality for LAI and FPAR │ class flag │ 0 to │
├─────────────────┼────────────────────────────────┼────────────┼─254─────┤
│ FparStdDev_500m │ Standard deviation for FPAR │ percent │ 0 to │
├─────────────────┼────────────────────────────────┼────────────┼─100─────┤
│ Fpar_500m │ Fraction of photosynthetically │ percent │ 0 to │
│ │ active radiation │ │ 100 │
├─────────────────┼────────────────────────────────┼────────────┼─────────┤
│ LaiStdDev_500m │ Standard deviation for LAI │ m^2/m^2 │ 0 to │
├─────────────────┼────────────────────────────────┼────────────┼─100─────┤
│ Lai_500m │ Leaf area index │ m^2/m^2 │ 0 to │
╘═════════════════╧════════════════════════════════╧════════════╧═100═════╛
MOD16A2
┌────────────┬──────────────────────────────┬─────────────┬───────────┐
│ band │ Description │ Units │ Range │
╞════════════╪══════════════════════════════╪═════════════╪═══════════╡
│ ET_500m │ Evapotranspiration │ kg/m^2/8day │ -32767 to │
│ │ │ │ 32700 │
├────────────┼──────────────────────────────┼─────────────┼───────────┤
│ ET_QC_500m │ QC for ET/LE │ │ 0 to 254 │
├────────────┼──────────────────────────────┼─────────────┼───────────┤
│ LE_500m │ Latent heat flux (LE) │ J/m^2/day │ -32767 to │
│ │ │ │ 32700 │
├────────────┼──────────────────────────────┼─────────────┼───────────┤
│ PET_500m │ Potential evapotranspiration │ kg/m^2/8day │ -32767 to │
│ │ │ │ 32700 │
├────────────┼──────────────────────────────┼─────────────┼───────────┤
│ PLE_500m │ Potential latent heat flux │ J/m^2/day │ -32767 to │
│ │ (LE) │ │ 32700 │
╘════════════╧══════════════════════════════╧═════════════╧═══════════╛
MOD17A2H
┌─────────────┬──────────────────────────┬──────────────┬───────────┐
│ band │ Description │ Units │ Range │
╞═════════════╪══════════════════════════╪══════════════╪═══════════╡
│ Gpp_500m │ Gross Primary Production │ kgC/m^2/8day │ 0 to │
├─────────────┼──────────────────────────┼──────────────┼─30000─────┤
│ PsnNet_500m │ Net Photosynthesis │ kgC/m^2/8day │ -30000 to │
│ │ │ │ 30000 │
├─────────────┼──────────────────────────┼──────────────┼───────────┤
│ Psn_QC_500m │ Quality Control bits │ │ 0 to 254 │
╘═════════════╧══════════════════════════╧══════════════╧═══════════╛
MOD17A3HGF
┌─────────────┬──────────────────────────┬────────────┬───────────┐
│ band │ Description │ Units │ Range │
╞═════════════╪══════════════════════════╪════════════╪═══════════╡
│ Npp_500m │ Net Primary Productivity │ kg_C/m^2 │ -30000 to │
│ │ │ │ 32700 │
├─────────────┼──────────────────────────┼────────────┼───────────┤
│ Npp_QC_500m │ Quality Control Bits │ percentage │ 0 to 100 │
╘═════════════╧══════════════════════════╧════════════╧═══════════╛
MOD21A2
┌──────────────────┬────────────────────────────────┬─────────┬─────────┐
│ band │ Description │ Range │ Units │
╞══════════════════╪════════════════════════════════╪═════════╪═════════╡
│ Emis_29 │ Band 29 emissivity │ 1 to │ │
├──────────────────┼────────────────────────────────┼─255─────┼─────────┤
│ Emis_31 │ Band 31 emissivity │ 1 to │ │
├──────────────────┼────────────────────────────────┼─255─────┼─────────┤
│ Emis_32 │ Band 32 emissivity │ 1 to │ │
├──────────────────┼────────────────────────────────┼─255─────┼─────────┤
│ LST_Day_1KM │ 8-day daytime 1km grid Land- │ 7500 to │ degK │
│ │ surface Temperature │ 65535 │ │
├──────────────────┼────────────────────────────────┼─────────┼─────────┤
│ LST_Night_1KM │ 8-day nighttime 1km grid Land- │ 7500 to │ degK │
│ │ surface Temperature │ 65535 │ │
├──────────────────┼────────────────────────────────┼─────────┼─────────┤
│ QC_Day │ Quality control for daytime │ 0 to │ │
│ │ LST and emissivity │ 255 │ │
├──────────────────┼────────────────────────────────┼─────────┼─────────┤
│ QC_Night │ Quality control for nighttime │ 0 to │ │
│ │ LST and emissivity │ 255 │ │
├──────────────────┼────────────────────────────────┼─────────┼─────────┤
│ View_Angle_Day │ Average view zenith angle of │ 0 to │ degree │
│ │ daytime temperature │ 130 │ │
├──────────────────┼────────────────────────────────┼─────────┼─────────┤
│ View_Angle_Night │ Average view zenith angle of │ 0 to │ degree │
│ │ nighttime temperature │ 130 │ │
├──────────────────┼────────────────────────────────┼─────────┼─────────┤
│ View_Time_Day │ Average time of daytime │ 0 to │ hrs │
│ │ observation │ 240 │ │
├──────────────────┼────────────────────────────────┼─────────┼─────────┤
│ View_Time_Night │ Average time of nighttime │ 0 to │ hrs │
│ │ observation │ 240 │ │
╘══════════════════╧════════════════════════════════╧═════════╧═════════╛
MOD44B
┌────────────────────────────┬────────────────────────────┬───────────┬─────────┐
│ band │ Description │ Units │ Range │
╞════════════════════════════╪════════════════════════════╪═══════════╪═════════╡
│ Cloud │ Cloud cover indicators │ bit field │ 0 to │
├────────────────────────────┼────────────────────────────┼───────────┼─255─────┤
│ Percent_NonTree_Vegetation │ Percent nontree vegetation │ percent │ 0 to │
├────────────────────────────┼────────────────────────────┼───────────┼─100─────┤
│ Percent_NonVegetated │ Percent non-vegetated │ percent │ 0 to │
├────────────────────────────┼────────────────────────────┼───────────┼─100─────┤
│ Percent_NonVegetated_SD │ percent non-vegetated SD │ percent │ 0 to │
│ │ │ │ 10000 │
├────────────────────────────┼────────────────────────────┼───────────┼─────────┤
│ Percent_Tree_Cover │ Percent tree cover │ percent │ 0 to │
├────────────────────────────┼────────────────────────────┼───────────┼─100─────┤
│ Percent_Tree_Cover_SD │ percent tree cover SD │ percent │ 0 to │
│ │ │ │ 10000 │
├────────────────────────────┼────────────────────────────┼───────────┼─────────┤
│ Quality │ Quality Control indicators │ bit field │ 0 to │
╘════════════════════════════╧════════════════════════════╧═══════════╧═255═════╛
MYD09A1
┌──────────────────────┬────────────────────────────────┬─────────────┬────────────┐
│ band │ Description │ Units │ Range │
╞══════════════════════╪════════════════════════════════╪═════════════╪════════════╡
│ sur_refl_b01 │ Surface reflectance for band 1 │ reflectance │ -100 to │
│ │ │ │ 16000 │
├──────────────────────┼────────────────────────────────┼─────────────┼────────────┤
│ sur_refl_b02 │ Surface reflectance for band 2 │ reflectance │ -100 to │
│ │ │ │ 16000 │
├──────────────────────┼────────────────────────────────┼─────────────┼────────────┤
│ sur_refl_b03 │ Surface reflectance for band 3 │ reflectance │ -100 to │
│ │ │ │ 16000 │
├──────────────────────┼────────────────────────────────┼─────────────┼────────────┤
│ sur_refl_b04 │ Surface reflectance for band 4 │ reflectance │ -100 to │
│ │ │ │ 16000 │
├──────────────────────┼────────────────────────────────┼─────────────┼────────────┤
│ sur_refl_b05 │ Surface reflectance for band 5 │ reflectance │ -100 to │
│ │ │ │ 16000 │
├──────────────────────┼────────────────────────────────┼─────────────┼────────────┤
│ sur_refl_b06 │ Surface reflectance for band 6 │ reflectance │ -100 to │
│ │ │ │ 16000 │
├──────────────────────┼────────────────────────────────┼─────────────┼────────────┤
│ sur_refl_b07 │ Surface reflectance for band 7 │ reflectance │ -100 to │
│ │ │ │ 16000 │
├──────────────────────┼────────────────────────────────┼─────────────┼────────────┤
│ sur_refl_day of year │ Surface reflectance day of │ day of year │ 0 to 366 │
├──────────────────────┼─year───────────────────────────┼─────────────┼────────────┤
│ sur_refl_qc_500m │ Surface reflectance 500m │ bit field │ 0 to 4294- │
│ │ quality control flags │ │ 966531 │
├──────────────────────┼────────────────────────────────┼─────────────┼────────────┤
│ sur_refl_raz │ Relative azimuth │ degree │ -18000 to │
│ │ │ │ 18000 │
├──────────────────────┼────────────────────────────────┼─────────────┼────────────┤
│ sur_refl_state_500m │ Surface reflectance 500m state │ bit field │ 0 to 57343 │
│ │ flags │ │ │
├──────────────────────┼────────────────────────────────┼─────────────┼────────────┤
│ sur_refl_szen │ Solar zenith │ degree │ 0 to 18000 │
├──────────────────────┼────────────────────────────────┼─────────────┼────────────┤
│ sur_refl_vzen │ View zenith │ degree │ 0 to 18000 │
╘══════════════════════╧════════════════════════════════╧═════════════╧════════════╛
MYD11A2
┌──────────────────┬────────────────────────────────┬─────────┬─────────┐
│ band │ Description │ Range │ Units │
╞══════════════════╪════════════════════════════════╪═════════╪═════════╡
│ Clear_sky_days │ Day clear-sky coverage │ 1 to │ │
├──────────────────┼────────────────────────────────┼─255─────┼─────────┤
│ Clear_sky_nights │ Night clear-sky coverage │ 1 to │ │
├──────────────────┼────────────────────────────────┼─255─────┼─────────┤
│ Day_view_angl │ View zenith angle of day │ 0 to │ degree │
│ │ observation │ 130 │ │
├──────────────────┼────────────────────────────────┼─────────┼─────────┤
│ Day_view_time │ Local time of day observation │ 0 to │ hrs │
├──────────────────┼────────────────────────────────┼─240─────┼─────────┤
│ Emis_31 │ Band 31 emissivity │ 1 to │ │
├──────────────────┼────────────────────────────────┼─255─────┼─────────┤
│ Emis_32 │ Band 32 emissivity │ 1 to │ │
├──────────────────┼────────────────────────────────┼─255─────┼─────────┤
│ LST_Day_1km │ Daytime Land Surface │ 7500 to │ degK │
│ │ Temperature │ 65535 │ │
├──────────────────┼────────────────────────────────┼─────────┼─────────┤
│ LST_Night_1km │ Night Land Surface Temperature │ 7500 to │ degK │
│ │ │ 65535 │ │
├──────────────────┼────────────────────────────────┼─────────┼─────────┤
│ Night_view_angl │ View zenith angle of night │ 0 to │ degree │
│ │ observation │ 130 │ │
├──────────────────┼────────────────────────────────┼─────────┼─────────┤
│ Night_view_time │ Local time of night │ 0 to │ hrs │
├──────────────────┼─observation────────────────────┼─240─────┼─────────┤
│ QC_Day │ Daytime LST Quality Indicators │ 0 to │ │
├──────────────────┼────────────────────────────────┼─255─────┼─────────┤
│ QC_Night │ Nighttime LST Quality │ 0 to │ │
╘══════════════════╧═indicators═════════════════════╧═255═════╧═════════╛
MYD13Q1
┌────────────────────────────────────────┬───────────────────────────────┬─────────────┬──────────┐
│ band │ Description │ Units │ Range │
╞════════════════════════════════════════╪═══════════════════════════════╪═════════════╪══════════╡
│ 250m_16_days_blue_reflectance │ Surface Reflectance Band 3 │ reflectance │ 0 to │
├────────────────────────────────────────┼───────────────────────────────┼─────────────┼─10000────┤
│ 250m_16_days_composite_day_of_the_year │ Day of year VI pixel │ day of year │ 1 to 366 │
├────────────────────────────────────────┼───────────────────────────────┼─────────────┼──────────┤
│ 250m_16_days_EVI │ 16 day EVI average │ │ -2000 to │
│ │ │ │ 10000 │
├────────────────────────────────────────┼───────────────────────────────┼─────────────┼──────────┤
│ 250m_16_days_MIR_reflectance │ Surface Reflectance Band 7 │ reflectance │ 0 to │
├────────────────────────────────────────┼───────────────────────────────┼─────────────┼─10000────┤
│ 250m_16_days_NDVI │ 16 day NDVI average │ │ -2000 to │
│ │ │ │ 10000 │
├────────────────────────────────────────┼───────────────────────────────┼─────────────┼──────────┤
│ 250m_16_days_NIR_reflectance │ Surface Reflectance Band 2 │ reflectance │ 0 to │
├────────────────────────────────────────┼───────────────────────────────┼─────────────┼─10000────┤
│ 250m_16_days_pixel_reliability │ Quality reliability of VI │ rank │ 0 to 3 │
├────────────────────────────────────────┼─pixel─────────────────────────┼─────────────┼──────────┤
│ 250m_16_days_red_reflectance │ Surface Reflectance Band 1 │ reflectance │ 0 to │
├────────────────────────────────────────┼───────────────────────────────┼─────────────┼─10000────┤
│ 250m_16_days_relative_azimuth_angle │ Relative azimuth angle of VI │ degrees │ -3600 to │
│ │ pixel │ │ 3600 │
├────────────────────────────────────────┼───────────────────────────────┼─────────────┼──────────┤
│ 250m_16_days_sun_zenith_angle │ Sun zenith angle of VI pixel │ degrees │ -9000 to │
│ │ │ │ 9000 │
├────────────────────────────────────────┼───────────────────────────────┼─────────────┼──────────┤
│ 250m_16_days_view_zenith_angle │ View zenith angle of VI Pixel │ degrees │ -9000 to │
│ │ │ │ 9000 │
├────────────────────────────────────────┼───────────────────────────────┼─────────────┼──────────┤
│ 250m_16_days_VI_Quality │ VI quality indicators │ bit field │ 0 to │
╘════════════════════════════════════════╧═══════════════════════════════╧═════════════╧═65534════╛
MYD14A2
┌──────────┬───────────────┬────────────┬─────────┐
│ band │ Description │ Units │ Range │
╞══════════╪═══════════════╪════════════╪═════════╡
│ FireMask │ fire mask │ class flag │ 1 to 9 │
├──────────┼───────────────┼────────────┼─────────┤
│ QA │ pixel quality │ bit field │ 0 to 6 │
╘══════════╧═══════════════╧════════════╧═════════╛
MYD15A2H
┌─────────────────┬────────────────────────────────┬────────────┬─────────┐
│ band │ Description │ Units │ Range │
╞═════════════════╪════════════════════════════════╪════════════╪═════════╡
│ FparExtra_QC │ Extra detail Quality for LAI │ class flag │ 0 to │
│ │ and FPAR │ │ 254 │
├─────────────────┼────────────────────────────────┼────────────┼─────────┤
│ FparLai_QC │ Quality for LAI and FPAR │ class flag │ 0 to │
├─────────────────┼────────────────────────────────┼────────────┼─254─────┤
│ FparStdDev_500m │ Standard deviation for FPAR │ percent │ 0 to │
├─────────────────┼────────────────────────────────┼────────────┼─100─────┤
│ Fpar_500m │ Fraction of photosynthetically │ percent │ 0 to │
│ │ active radiation │ │ 100 │
├─────────────────┼────────────────────────────────┼────────────┼─────────┤
│ LaiStdDev_500m │ Standard deviation for LAI │ m^2/m^2 │ 0 to │
├─────────────────┼────────────────────────────────┼────────────┼─100─────┤
│ Lai_500m │ Leaf area index │ m^2/m^2 │ 0 to │
╘═════════════════╧════════════════════════════════╧════════════╧═100═════╛
MYD16A2
┌────────────┬──────────────────────────────┬─────────────┬───────────┐
│ band │ Description │ Units │ Range │
╞════════════╪══════════════════════════════╪═════════════╪═══════════╡
│ ET_500m │ Evapotranspiration │ kg/m^2/8day │ -32767 to │
│ │ │ │ 32700 │
├────────────┼──────────────────────────────┼─────────────┼───────────┤
│ ET_QC_500m │ QC for ET/LE │ │ 0 to 254 │
├────────────┼──────────────────────────────┼─────────────┼───────────┤
│ LE_500m │ Latent heat flux (LE) │ J/m^2/day │ -32767 to │
│ │ │ │ 32700 │
├────────────┼──────────────────────────────┼─────────────┼───────────┤
│ PET_500m │ Potential evapotranspiration │ kg/m^2/8day │ -32767 to │
│ │ │ │ 32700 │
├────────────┼──────────────────────────────┼─────────────┼───────────┤
│ PLE_500m │ Potential latent heat flux │ J/m^2/day │ -32767 to │
│ │ (LE) │ │ 32700 │
╘════════════╧══════════════════════════════╧═════════════╧═══════════╛
MYD17A2H
┌─────────────┬──────────────────────────┬──────────────┬───────────┐
│ band │ Description │ Units │ Range │
╞═════════════╪══════════════════════════╪══════════════╪═══════════╡
│ Gpp_500m │ Gross Primary Production │ kgC/m^2/8day │ 0 to │
├─────────────┼──────────────────────────┼──────────────┼─30000─────┤
│ PsnNet_500m │ Net Photosynthesis │ kgC/m^2/8day │ -30000 to │
│ │ │ │ 30000 │
├─────────────┼──────────────────────────┼──────────────┼───────────┤
│ Psn_QC_500m │ Quality Control bits │ │ 0 to 254 │
╘═════════════╧══════════════════════════╧══════════════╧═══════════╛
MYD17A3HGF
┌─────────────┬──────────────────────────┬────────────┬───────────┐
│ band │ Description │ Units │ Range │
╞═════════════╪══════════════════════════╪════════════╪═══════════╡
│ Npp_500m │ Net Primary Productivity │ kg_C/m^2 │ -30000 to │
│ │ │ │ 32700 │
├─────────────┼──────────────────────────┼────────────┼───────────┤
│ Npp_QC_500m │ Quality Control Bits │ percentage │ 0 to 100 │
╘═════════════╧══════════════════════════╧════════════╧═══════════╛
MYD21A2
┌──────────────────┬────────────────────────────────┬─────────┬─────────┐
│ band │ Description │ Range │ Units │
╞══════════════════╪════════════════════════════════╪═════════╪═════════╡
│ Emis_29 │ Band 29 emissivity │ 1 to │ │
├──────────────────┼────────────────────────────────┼─255─────┼─────────┤
│ Emis_31 │ Band 31 emissivity │ 1 to │ │
├──────────────────┼────────────────────────────────┼─255─────┼─────────┤
│ Emis_32 │ Band 32 emissivity │ 1 to │ │
├──────────────────┼────────────────────────────────┼─255─────┼─────────┤
│ LST_Day_1KM │ 8-day daytime 1km grid Land- │ 7500 to │ degK │
│ │ surface Temperature │ 65535 │ │
├──────────────────┼────────────────────────────────┼─────────┼─────────┤
│ LST_Night_1KM │ 8-day nighttime 1km grid Land- │ 7500 to │ degK │
│ │ surface Temperature │ 65535 │ │
├──────────────────┼────────────────────────────────┼─────────┼─────────┤
│ QC_Day │ Quality control for daytime │ 0 to │ │
│ │ LST and emissivity │ 255 │ │
├──────────────────┼────────────────────────────────┼─────────┼─────────┤
│ QC_Night │ Quality control for nighttime │ 0 to │ │
│ │ LST and emissivity │ 255 │ │
├──────────────────┼────────────────────────────────┼─────────┼─────────┤
│ View_Angle_Day │ Average view zenith angle of │ 0 to │ degree │
│ │ daytime temperature │ 130 │ │
├──────────────────┼────────────────────────────────┼─────────┼─────────┤
│ View_Angle_Night │ Average view zenith angle of │ 0 to │ degree │
│ │ nighttime temperature │ 130 │ │
├──────────────────┼────────────────────────────────┼─────────┼─────────┤
│ View_Time_Day │ Average time of daytime │ 0 to │ hrs │
│ │ observation │ 240 │ │
├──────────────────┼────────────────────────────────┼─────────┼─────────┤
│ View_Time_Night │ Average time of nighttime │ 0 to │ hrs │
│ │ observation │ 240 │ │
╘══════════════════╧════════════════════════════════╧═════════╧═════════╛
SIF005
┌───────────────────────┬────────────────────────────────┬─────────────┐
│ band │ Description │ Units │
╞═══════════════════════╪════════════════════════════════╪═════════════╡
│ EVI_Quality │ MODIS enhanced vegetation │ bit field │
│ │ index quality flag │ │
├───────────────────────┼────────────────────────────────┼─────────────┤
│ SIF_740_daily_corr │ daily corrected SIF at 740nm │ mW/m2/nm/sr │
├───────────────────────┼────────────────────────────────┼─────────────┤
│ SIF_740_daily_corr_SD │ uncertainty of daily corrected │ mW/m2/nm/sr │
│ │ SIF at 740nm │ │
╘═══════════════════════╧════════════════════════════════╧═════════════╛
SIF_ANN
┌─────────┬────────────────────────────────┬─────────────┐
│ band │ Description │ Units │
╞═════════╪════════════════════════════════╪═════════════╡
│ sif_ann │ mean solar-induced chlorophyll │ mW/m2/nm/sr │
│ │ fluorescence modeled by an ANN │ │
╘═════════╧════════════════════════════════╧═════════════╛
VNP09A1
┌─────────────────────────┬──────────────────────────────┬─────────────┬────────────┐
│ band │ Description │ Units │ Range │
╞═════════════════════════╪══════════════════════════════╪═════════════╪════════════╡
│ RelativeAzimuth │ Relative azimuth │ degree │ -18000 to │
│ │ │ │ 18000 │
├─────────────────────────┼──────────────────────────────┼─────────────┼────────────┤
│ SensorZenith │ View zenith │ degree │ 0 to 18000 │
├─────────────────────────┼──────────────────────────────┼─────────────┼────────────┤
│ SolarZenith │ Solar zenith │ degree │ 0 to 18000 │
├─────────────────────────┼──────────────────────────────┼─────────────┼────────────┤
│ SurfReflect_day of year │ Surface reflectance day of │ day of year │ 1 to 366 │
│ │ year │ │ │
├─────────────────────────┼──────────────────────────────┼─────────────┼────────────┤
│ SurfReflect_M1 │ Surface reflectance for band │ reflectance │ -100 to │
│ │ M1 │ │ 16000 │
├─────────────────────────┼──────────────────────────────┼─────────────┼────────────┤
│ SurfReflect_M10 │ Surface reflectance for band │ reflectance │ -100 to │
│ │ M10 │ │ 16000 │
├─────────────────────────┼──────────────────────────────┼─────────────┼────────────┤
│ SurfReflect_M11 │ Surface reflectance for band │ reflectance │ -100 to │
│ │ M11 │ │ 16000 │
├─────────────────────────┼──────────────────────────────┼─────────────┼────────────┤
│ SurfReflect_M2 │ Surface reflectance for band │ reflectance │ -100 to │
│ │ M2 │ │ 16000 │
├─────────────────────────┼──────────────────────────────┼─────────────┼────────────┤
│ SurfReflect_M3 │ Surface reflectance for band │ reflectance │ -100 to │
│ │ M3 │ │ 16000 │
├─────────────────────────┼──────────────────────────────┼─────────────┼────────────┤
│ SurfReflect_M4 │ Surface reflectance for band │ reflectance │ -100 to │
│ │ M4 │ │ 16000 │
├─────────────────────────┼──────────────────────────────┼─────────────┼────────────┤
│ SurfReflect_M5 │ Surface reflectance for band │ reflectance │ -100 to │
│ │ M5 │ │ 16000 │
├─────────────────────────┼──────────────────────────────┼─────────────┼────────────┤
│ SurfReflect_M7 │ Surface reflectance for band │ reflectance │ -100 to │
│ │ M7 │ │ 16000 │
├─────────────────────────┼──────────────────────────────┼─────────────┼────────────┤
│ SurfReflect_M8 │ Surface reflectance for band │ reflectance │ -100 to │
│ │ M8 │ │ 16000 │
├─────────────────────────┼──────────────────────────────┼─────────────┼────────────┤
│ SurfReflect_QC │ Surface reflectance quality │ bit field │ 0 to 2147- │
│ │ control flags │ │ 483647 │
├─────────────────────────┼──────────────────────────────┼─────────────┼────────────┤
│ SurfReflect_State │ Surface reflectance state │ bit field │ 0 to 13311 │
│ │ flags │ │ │
╘═════════════════════════╧══════════════════════════════╧═════════════╧════════════╛
VNP09H1
┌────────────────────────┬────────────────────────────────┬─────────────┬─────────┐
│ band │ Description │ Units │ Range │
╞════════════════════════╪════════════════════════════════╪═════════════╪═════════╡
│ SurfReflect_I1 │ Surface reflectance for band │ reflectance │ -100 to │
│ │ I1 │ │ 16000 │
├────────────────────────┼────────────────────────────────┼─────────────┼─────────┤
│ SurfReflect_I2 │ Surface reflectance for band │ reflectance │ -100 to │
│ │ I2 │ │ 16000 │
├────────────────────────┼────────────────────────────────┼─────────────┼─────────┤
│ SurfReflect_I3 │ Surface reflectance for band │ reflectance │ -100 to │
│ │ I3 │ │ 16000 │
├────────────────────────┼────────────────────────────────┼─────────────┼─────────┤
│ SurfReflect_QC_500m │ Surface reflectance 250m │ bit field │ 0 to │
│ │ quality control flags │ │ 32767 │
├────────────────────────┼────────────────────────────────┼─────────────┼─────────┤
│ SurfReflect_State_500m │ Surface reflectance 250m state │ bit field │ 0 to │
│ │ flags │ │ 13311 │
╘════════════════════════╧════════════════════════════════╧═════════════╧═════════╛
VNP13A1
┌─────────────────────────────────────────┬───────────────────────────────┬─────────────┬───────────┐
│ band │ Description │ Units │ Range │
╞═════════════════════════════════════════╪═══════════════════════════════╪═════════════╪═══════════╡
│ 500_m_16_days_blue_reflectance │ Blue band (M3 478-498 nm) │ reflectance │ 0 to │
│ │ reflectance │ │ 10000 │
├─────────────────────────────────────────┼───────────────────────────────┼─────────────┼───────────┤
│ 500_m_16_days_composite_day_of_the_year │ Day of the year │ day of year │ 1 to 366 │
├─────────────────────────────────────────┼───────────────────────────────┼─────────────┼───────────┤
│ 500_m_16_days_EVI │ 16 day EVI average │ │ -10000 to │
│ │ │ │ 10000 │
├─────────────────────────────────────────┼───────────────────────────────┼─────────────┼───────────┤
│ 500_m_16_days_EVI2 │ 16 day EVI2 average │ │ -10000 to │
│ │ │ │ 10000 │
├─────────────────────────────────────────┼───────────────────────────────┼─────────────┼───────────┤
│ 500_m_16_days_green_reflectance │ Green band (M4 545-565 nm) │ reflectance │ 0 to │
│ │ reflectance │ │ 10000 │
├─────────────────────────────────────────┼───────────────────────────────┼─────────────┼───────────┤
│ 500_m_16_days_NDVI │ 16 day NDVI average │ │ -10000 to │
│ │ │ │ 10000 │
├─────────────────────────────────────────┼───────────────────────────────┼─────────────┼───────────┤
│ 500_m_16_days_NIR_reflectance │ NIR band (I2 846-885 nm) │ reflectance │ 0 to │
│ │ reflectance │ │ 10000 │
├─────────────────────────────────────────┼───────────────────────────────┼─────────────┼───────────┤
│ 500_m_16_days_pixel_reliability │ Quality reliability │ rank │ 0 to 11 │
├─────────────────────────────────────────┼───────────────────────────────┼─────────────┼───────────┤
│ 500_m_16_days_red_reflectance │ Red band (I1 600-680 nm) │ reflectance │ 0 to │
│ │ reflectance │ │ 10000 │
├─────────────────────────────────────────┼───────────────────────────────┼─────────────┼───────────┤
│ 500_m_16_days_relative_azimuth_angle │ Relative azimuth angle │ degrees │ -18000 to │
│ │ │ │ 18000 │
├─────────────────────────────────────────┼───────────────────────────────┼─────────────┼───────────┤
│ 500_m_16_days_sun_zenith_angle │ Sun zenith angle │ degrees │ 0 to │
├─────────────────────────────────────────┼───────────────────────────────┼─────────────┼─18000─────┤
│ 500_m_16_days_SWIR1_reflectance │ SWIR1 band (M8 1230-1250 nm) │ reflectance │ 0 to │
│ │ reflectance │ │ 10000 │
├─────────────────────────────────────────┼───────────────────────────────┼─────────────┼───────────┤
│ 500_m_16_days_SWIR2_reflectance │ SWIR2 band (M10 1580-1640 nm) │ reflectance │ 0 to │
│ │ reflectance │ │ 10000 │
├─────────────────────────────────────────┼───────────────────────────────┼─────────────┼───────────┤
│ 500_m_16_days_SWIR3_reflectance │ SWIR3 band (M11 2225-2275 nm) │ reflectance │ 0 to │
│ │ reflectance │ │ 10000 │
├─────────────────────────────────────────┼───────────────────────────────┼─────────────┼───────────┤
│ 500_m_16_days_view_zenith_angle │ View zenith angle │ degrees │ 0 to │
├─────────────────────────────────────────┼───────────────────────────────┼─────────────┼─18000─────┤
│ 500_m_16_days_VI_Quality │ VI quality indicators │ bit field │ 0 to │
╘═════════════════════════════════════════╧═══════════════════════════════╧═════════════╧═65534═════╛
VNP15A2H
┌──────────────┬────────────────────────────┬──────────┬─────────┐
│ band │ Description │ Units │ Range │
╞══════════════╪════════════════════════════╪══════════╪═════════╡
│ Fpar │ Fraction of photosyntheti- │ fraction │ 0 to │
│ │ cally active radiation │ │ 100 │
│ │ │ │ │
├──────────────┼────────────────────────────┼──────────┼─────────┤
│ FparExtra_QC │ Extra detail Quality for │ class │ 0 to │
│ │ LAI and FPAR │ flag │ 254 │
├──────────────┼────────────────────────────┼──────────┼─────────┤
│ FparLai_QC │ Quality for LAI and FPAR │ class │ 0 to │
├──────────────┼────────────────────────────┼─flag─────┼─254─────┤
│ FparStdDev │ Standard deviation for │ fraction │ 0 to │
├──────────────┼─FPAR───────────────────────┼──────────┼─100─────┤
│ Lai │ Leaf area index │ m^2/m^2 │ 0 to │
├──────────────┼────────────────────────────┼──────────┼─100─────┤
│ LaiStdDev │ Standard deviation for LAI │ m^2/m^2 │ 0 to │
╘══════════════╧════════════════════════════╧══════════╧═100═════╛
VNP21A2
┌──────────────────┬────────────────────┬─────────┬─────────┐
│ band │ Description │ Units │ Range │
╞══════════════════╪════════════════════╪═════════╪═════════╡
│ Emis_14 │ Average Band 14 │ │ 1 to │
│ │ emissivity │ │ 255 │
├──────────────────┼────────────────────┼─────────┼─────────┤
│ Emis_15 │ Average Band 15 │ │ 1 to │
│ │ emissivity │ │ 255 │
├──────────────────┼────────────────────┼─────────┼─────────┤
│ Emis_16 │ Average Band 16 │ │ 1 to │
│ │ emissivity │ │ 255 │
├──────────────────┼────────────────────┼─────────┼─────────┤
│ LST_Day_1KM │ Daytime Land- │ degK │ 7500 to │
│ │ surface Temperatu- │ │ 65535 │
├──────────────────┼─re─────────────────┼─────────┼─────────┤
│ LST_Night_1KM │ Nighttime Land- │ degK │ 7500 to │
│ │ surface Temperatu- │ │ 65535 │
├──────────────────┼─re─────────────────┼─────────┼─────────┤
│ QC_Day │ Quality control │ │ 1 to │
│ │ for daytime LST │ │ 255 │
│ │ and emissivity │ │ │
├──────────────────┼────────────────────┼─────────┼─────────┤
│ QC_Night │ Quality control │ │ 1 to │
│ │ for nighttime LST │ │ 255 │
│ │ and emissivity │ │ │
├──────────────────┼────────────────────┼─────────┼─────────┤
│ View_Angle_Day │ Average view │ degree │ 0 to │
│ │ zenith angle of │ │ 130 │
│ │ daytime temperatu- │ │ │
├──────────────────┼─re─────────────────┼─────────┼─────────┤
│ View_Angle_Night │ Average view │ degree │ 0 to │
│ │ zenith angle of │ │ 130 │
│ │ nighttime │ │ │
├──────────────────┼─temperature────────┼─────────┼─────────┤
│ View_Time_Day │ Average time of │ hrs │ 0 to │
│ │ daytime observati- │ │ 240 │
├──────────────────┼─on─────────────────┼─────────┼─────────┤
│ View_Time_Night │ Average time of │ hrs │ 0 to │
│ │ nighttime │ │ 240 │
│ │ observation │ │ │
╘══════════════════╧════════════════════╧═════════╧═════════╛
VNP22Q2
┌──────────────────────────────────────────────┬────────────────────┬──────────┬─────────┐
│ band │ Description │ Units │ Range │
╞══════════════════════════════════════════════╪════════════════════╪══════════╪═════════╡
│ Cycle_1.Date_Mid_Greenup_Phase_1 │ Date at a mid- │ day of │ 1 to │
│ │ greenup phase │ year │ 32766 │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_1.Date_Mid_Senescence_Phase_1 │ Date at a mid- │ day of │ 1 to │
│ │ senescence phase │ year │ 32766 │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_1.EVI2_Growing_Season_Area_1 │ Integrated EVI2 │ EVI2 │ 1 to │
│ │ during a growing │ │ 32766 │
│ │ season │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_1.EVI2_Onset_Greenness_Increase_1 │ EVI2 value at │ EVI2 │ 1 to │
│ │ greenup onset │ │ 10000 │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_1.EVI2_Onset_Greenness_Maximum_1 │ EVI2 value at │ EVI2 │ 1 to │
│ │ maturity onset │ │ 10000 │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_1.GLSP_QC_1 │ Global Land │ │ 0 to │
│ │ Surface Phenology │ │ 100 │
│ │ Quality Control │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_1.Greenness_Agreement_Growing_Season_1 │ EVI2 agreement │ │ 0 to │
│ │ between modeled │ │ 100 │
│ │ values and raw │ │ │
│ │ observations │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_1.Growing_Season_Length_1 │ Growing Season │ number │ 1 to │
│ │ Length │ of days │ 366 │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_1.Onset_Greenness_Decrease_1 │ Date at which │ day of │ 1 to │
│ │ canopy greenness │ year │ 32766 │
│ │ begins to decrease │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_1.Onset_Greenness_Increase_1 │ Date of onset of │ day of │ 1 to │
│ │ greenness increase │ year │ 32766 │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_1.Onset_Greenness_Maximum_1 │ Date at which │ day of │ 1 to │
│ │ canopy greenness │ year │ 32766 │
│ │ approaches its │ │ │
├──────────────────────────────────────────────┼─seasonal maximum───┼──────────┼─────────┤
│ Cycle_1.Onset_Greenness_Minimum_1 │ Date at which │ day of │ 1 to │
│ │ canopy greenness │ year │ 32766 │
│ │ reaches a minimum │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_1.PGQ_Growing_Season_1 │ Proportion of good │ │ 1 to │
│ │ quality observati- │ │ 100 │
│ │ ons during a │ │ │
│ │ growing season │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_1.PGQ_Onset_Greenness_Decrease_1 │ Proportion of good │ │ 1 to │
│ │ quality around │ │ 100 │
│ │ senescence onset │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_1.PGQ_Onset_Greenness_Increase_1 │ Proportion of good │ │ 1 to │
│ │ quality around │ │ 100 │
│ │ greenup onset │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_1.PGQ_Onset_Greenness_Maximum_1 │ Proportion of good │ │ 1 to │
│ │ quality around │ │ 100 │
│ │ maturity onset │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_1.PGQ_Onset_Greenness_Minimum_1 │ Proportion of good │ │ 1 to │
│ │ quality around │ │ 100 │
│ │ dormancy onset │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_1.Rate_Greenness_Decrease_1 │ Rates of change in │ EVI2/day │ 1 to │
│ │ EVI2 values during │ │ 32766 │
│ │ a senesce phase │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_1.Rate_Greenness_Increase_1 │ Rates of change in │ EVI2/day │ 1 to │
│ │ EVI2 values during │ │ 32766 │
│ │ a greenup phase │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_2.Date_Mid_Greenup_Phase_2 │ Date at a mid- │ day of │ 1 to │
│ │ greenup phase │ year │ 32766 │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_2.Date_Mid_Senescence_Phase_2 │ Date at a mid- │ day of │ 1 to │
│ │ senescence phase │ year │ 32766 │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_2.EVI2_Growing_Season_Area_2 │ Integrated EVI2 │ EVI2 │ 1 to │
│ │ during a growing │ │ 32766 │
│ │ season │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_2.EVI2_Onset_Greenness_Increase_2 │ EVI2 value at │ EVI2 │ 1 to │
│ │ greenup onset │ │ 10000 │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_2.EVI2_Onset_Greenness_Maximum_2 │ EVI2 value at │ EVI2 │ 1 to │
│ │ maturity onset │ │ 10000 │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_2.GLSP_QC_2 │ Global Land │ │ 0 to │
│ │ Surface Phenology │ │ 100 │
│ │ Quality Control │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_2.Greenness_Agreement_Growing_Season_2 │ EVI2 agreement │ │ 0 to │
│ │ between modeled │ │ 100 │
│ │ values and raw │ │ │
│ │ observations │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_2.Growing_Season_Length_2 │ Growing Season │ number_o │ 1 to │
│ │ Length │ f_ days │ 366 │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_2.Onset_Greenness_Decrease_2 │ Date at which │ day of │ 1 to │
│ │ canopy greenness │ year │ 32766 │
│ │ begins to decrease │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_2.Onset_Greenness_Increase_2 │ Date of onset of │ day of │ 1 to │
│ │ greenness increase │ year │ 32766 │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_2.Onset_Greenness_Maximum_2 │ Date at which │ day of │ 1 to │
│ │ canopy greenness │ year │ 32766 │
│ │ approaches its │ │ │
├──────────────────────────────────────────────┼─seasonal maximum───┼──────────┼─────────┤
│ Cycle_2.Onset_Greenness_Minimum_2 │ Date at which │ day of │ 1 to │
│ │ canopy greenness │ year │ 32766 │
│ │ reaches a minimum │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_2.PGQ_Growing_Season_2 │ Proportion of good │ │ 1 to │
│ │ quality observati- │ │ 100 │
│ │ ons during a │ │ │
│ │ growing season │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_2.PGQ_Onset_Greenness_Decrease_2 │ Proportion of good │ │ 1 to │
│ │ quality around │ │ 100 │
│ │ senescence onset │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_2.PGQ_Onset_Greenness_Increase_2 │ Proportion of good │ │ 1 to │
│ │ quality around │ │ 100 │
│ │ greenup onset │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_2.PGQ_Onset_Greenness_Maximum_2 │ Proportion of good │ │ 1 to │
│ │ quality around │ │ 100 │
│ │ maturity onset │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_2.PGQ_Onset_Greenness_Minimum_2 │ Proportion of good │ │ 1 to │
│ │ quality around │ │ 100 │
│ │ dormancy onset │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_2.Rate_Greenness_Decrease_2 │ Rates of change in │ EVI2/day │ 1 to │
│ │ EVI2 values during │ │ 32766 │
│ │ a senesce phase │ │ │
├──────────────────────────────────────────────┼────────────────────┼──────────┼─────────┤
│ Cycle_2.Rate_Greenness_Increase_2 │ Rates of change in │ EVI2/day │ 1 to │
│ │ EVI2 values during │ │ 32766 │
│ │ a greenup phase │ │ │
╘══════════════════════════════════════════════╧════════════════════╧══════════╧═════════╛
options:
-h | --help
show this help message and exit
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
[1mDocutils System Messages[0m
Unknown target name: "f".
ncei_annual¶
$ tsgettoolbox ncei_annual --help
usage: tsgettoolbox ncei_annual [-h] [--start_date START_DATE]
[--end_date END_DATE] stationid
Requires registration and free API key.
For every datatype and record there is a set of meta-data flags. For the ANNUAL
dataset, the flags are:
'Measurement','Quality','Days','Units'
The flags are described in the following tables.
More info: <[4;36mhttp://www1.ncdc.noaa.gov/pub/data/cdo/documentation/ANNUAL_-
documentation.pdf[0m>
Measurement flag
┌───────┬─────────────────────────────────────────────────────────────┐
│ Code │ Description │
╞═══════╪═════════════════════════════════════════════════════════════╡
│ A │ Accumulated amount. This value is a total that may include │
│ │ data from a previous month or months (TPCP) │
├───────┼─────────────────────────────────────────────────────────────┤
│ B │ Adjusted Total. Monthly value totals based on proportional │
│ │ available data across the entire month. (CLDD, HTDD. │
├───────┼─────────────────────────────────────────────────────────────┤
│ E │ An estimated monthly or annual total │
├───────┼─────────────────────────────────────────────────────────────┤
│ I │ Monthly means or totals based on incomplete time series. 1 │
│ │ to 9 days are missing. (MMNT,MMXP, MMXT, MNTM, TPCP, TSNW). │
├───────┼─────────────────────────────────────────────────────────────┤
│ M │ Used to indicate data element missing. │
├───────┼─────────────────────────────────────────────────────────────┤
│ S │ Precipitation for the amount is continuing to be │
│ │ accumulated. Total will be included in a subsequent value │
│ │ (TPCP). Example: Days 1-20 had 1.35 in of precipitation, │
│ │ then a period of accumulation began. The element TPCP would │
│ │ then be 00135S and the total accumulated amount value │
│ │ appears in a subsequent monthly value. If TPCP = 0 there │
│ │ was no precipitation measured during the month. flag 1 is │
│ │ set to "S" and the total accumulated amount appears in a │
├───────┼─subsequent monthly value.───────────────────────────────────┤
│ T │ Trace of precipitation, snowfall, or snow depth. The │
│ │ precipitation data value will = "00000". (EMXP, MXSD, TPCP, │
│ │ TSNW). │
├───────┼─────────────────────────────────────────────────────────────┤
│ + │ The phenomena in question occurred on several days. The │
│ │ date in the DAY field is the last day of occurrence. │
├───────┼─────────────────────────────────────────────────────────────┤
│ Blank │ No report. │
╘═══════╧═════════════════════════════════════════════════════════════╛
Quality flag
┌──────┬──────────────────────────────────────┐
│ Code │ Description │
╞══════╪══════════════════════════════════════╡
│ A │ Accumulated amount │
├──────┼──────────────────────────────────────┤
│ E │ Estimated value │
├──────┼──────────────────────────────────────┤
│ + │ Value occurred on more than one day, │
│ │ last date of occurrence is used │
╘══════╧══════════════════════════════════════╛
Number of days flag
Number of days is given as 00 when all days in the month are considered in
computing data value or otherwise the maximum number of consecutive days in the
month considered in computing the data value.
Units flag
┌──────┬──────────────────────────────────────────────────────────────┐
│ Code │ Description │
╞══════╪══════════════════════════════════════════════════════════════╡
│ C │ Whole degree C │
├──────┼──────────────────────────────────────────────────────────────┤
│ D │ Whole F Degree Day │
├──────┼──────────────────────────────────────────────────────────────┤
│ F │ Whole degree F │
├──────┼──────────────────────────────────────────────────────────────┤
│ HI │ Hundredths of in │
├──────┼──────────────────────────────────────────────────────────────┤
│ I │ Whole in │
├──────┼──────────────────────────────────────────────────────────────┤
│ M │ Whole miles │
├──────┼──────────────────────────────────────────────────────────────┤
│ MH │ Miles per hour │
├──────┼──────────────────────────────────────────────────────────────┤
│ MM │ mm │
├──────┼──────────────────────────────────────────────────────────────┤
│ NA │ No units applicable (dimensionless) │
├──────┼──────────────────────────────────────────────────────────────┤
│ TC │ Tenths of degrees C │
├──────┼──────────────────────────────────────────────────────────────┤
│ TF │ Tenths of degrees F │
├──────┼──────────────────────────────────────────────────────────────┤
│ TI │ Tenths of in │
├──────┼──────────────────────────────────────────────────────────────┤
│ TM │ Tenths of mm │
├──────┼──────────────────────────────────────────────────────────────┤
│ 1 │ Soils, degrees F, soil depths in in and hundredths │
├──────┼──────────────────────────────────────────────────────────────┤
│ 2 │ Soils, degrees C, soil depth in whole cm │
├──────┼──────────────────────────────────────────────────────────────┤
│ 3 │ Soils, degrees C, soil, soil depth in in and hundredths │
├──────┼──────────────────────────────────────────────────────────────┤
│ 4 │ Soils, degrees F, soil depth in whole cm │
├──────┼──────────────────────────────────────────────────────────────┤
│ 5 │ Soils, If the soil station closed during the current month, │
│ │ '5' indicates the station has closed. │
╘══════╧══════════════════════════════════════════════════════════════╛
positional arguments:
stationid The station id. from the first column of
<[4;36mhttps://www.ncei.noaa.gov/pub/data/ghcn/daily/ghcnd-stations.txt[0m>
options:
-h | --help
show this help message and exit
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
ncei_ghcnd¶
$ tsgettoolbox ncei_ghcnd --help
usage: tsgettoolbox ncei_ghcnd [-h] [--start_date START_DATE]
[--end_date END_DATE] stationid
Requires registration and free API key.
If you use this data, please read <[4;36mhttps://www.ncei.noaa.gov/pub/data/gh-
cn/daily/readme.txt[0m> about "How to cite".
GHCN (Global Historical Climatology Network)-Daily is an integrated database of
daily climate summaries from land surface stations across the globe. Like its
monthly counterpart (GHCN-Monthly), GHCN-Daily is comprised of daily climate
records from numerous sources that have been integrated and subjected to a
common suite of quality assurance reviews.
GHCN-Daily now contains records from over 75000 stations in 180 countries and
territories. Numerous daily variables are provided, including maximum and
minimum temperature, total daily precipitation, snowfall, and snow depth;
however, about two thirds of the stations report precipitation only. Both the
record length and period of record vary by station and cover intervals ranging
from less than year to more than 175 years.
The dataset is regularly reconstructed (usually every weekend) from its 20-plus
data source components to ensure that GHCN-Daily is generally in sync with its
growing list of constituent sources. During this process, quality assurance
checks are applied to the full dataset. On most weekdays, GHCN-Daily station
data are updated when possible from a variety of data streams, which also
undergo a suite of quality checks.
Some of the data provided here are based on data exchanged under the World
Meteorological Organization (WMO) World Weather Watch Program according to WMO
Resolution 40 (Cg-XII). This allows WMO member countries to place restrictions
on the use or re-export of their data for commercial purposes outside of the
receiving country. Those countries' data summaries and products which are
available here are intended for free and unrestricted use in research,
education, and other non-commercial activities. For non-U.S. locations' data,
the data or any derived product shall not be provided to other users or be used
for the re-export of commercial services.
The five core values are:
┌──────┬────────────────────────────┐
│ Code │ Description │
╞══════╪════════════════════════════╡
│ TMAX │ Temperature MAX (degree C) │
├──────┼────────────────────────────┤
│ TMIN │ Temperature MIN (degree C) │
├──────┼────────────────────────────┤
│ PRCP │ PReCiPitation (mm) │
├──────┼────────────────────────────┤
│ SNOW │ SNOWfall (mm) │
├──────┼────────────────────────────┤
│ SNWD │ SNoW Depth (mm) │
╘══════╧════════════════════════════╛
Other possible data collected:
┌──────┬──────────────────────────────────────────────────────────────┐
│ Code │ Description │
╞══════╪══════════════════════════════════════════════════════════════╡
│ ACMC │ Average cloudiness midnight to midnight from 30-second │
│ │ ceilometer data (percent) │
├──────┼──────────────────────────────────────────────────────────────┤
│ ACMH │ Average cloudiness midnight to midnight from manual │
│ │ observations (percent) │
├──────┼──────────────────────────────────────────────────────────────┤
│ ACSC │ Average cloudiness sunrise to sunset from 30-second │
│ │ ceilometer data (percent) │
├──────┼──────────────────────────────────────────────────────────────┤
│ ACSH │ Average cloudiness sunrise to sunset from manual │
│ │ observations (percent) │
├──────┼──────────────────────────────────────────────────────────────┤
│ AWDR │ Average daily wind direction (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ AWND │ Average daily wind speed (meters per second) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DAEV │ Number of days included in the multiday evaporation total │
│ │ (MDEV) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DAPR │ Number of days included in the multiday precipitation total │
│ │ (MDPR) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DASF │ Number of days included in the multiday snowfall total │
├──────┼─(MDSF)───────────────────────────────────────────────────────┤
│ DATN │ Number of days included in the multiday minimum temperature │
│ │ (MDTN) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DATX │ Number of days included in the multiday maximum temperature │
│ │ (MDTX) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DAWM │ Number of days included in the multiday wind movement (MDWM) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DWPR │ Number of days with non-zero precipitation included in │
│ │ multiday precipitation total (MDPR) │
├──────┼──────────────────────────────────────────────────────────────┤
│ EVAP │ Evaporation of water from evaporation pan (mm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ FMTM │ Time of fastest mile or fastest 1-minute wind (hours and │
│ │ minutes, i.e., HHMM) │
├──────┼──────────────────────────────────────────────────────────────┤
│ FRGB │ Base of frozen ground layer (cm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ FRGT │ Top of frozen ground layer (cm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ FRTH │ Thickness of frozen ground layer (cm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ GAHT │ Difference between river and gauge height (cm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDEV │ Multiday evaporation total (use with DAEV) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDPR │ Multiday precipitation total (mm; use with DAPR and DWPR, if │
│ │ available) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDSF │ Multiday snowfall total │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDTN │ Multiday minimum temperature (degrees C; use with DATN) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDTX │ Multiday maximum temperature (degrees C; use with DATX) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDWM │ Multiday wind movement (km) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MNPN │ Daily minimum temperature of water in an evaporation pan │
│ │ (degrees C) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MXPN │ Daily maximum temperature of water in an evaporation pan │
│ │ (degrees C) │
├──────┼──────────────────────────────────────────────────────────────┤
│ PGTM │ Peak gust time (hours and minutes, i.e., HHMM) │
├──────┼──────────────────────────────────────────────────────────────┤
│ PSUN │ Daily percent of possible sunshine (percent) │
├──────┼──────────────────────────────────────────────────────────────┤
│ TAVG │ Average temperature (degrees C) [Note that TAVG from source │
│ │ 'S' corresponds to an average for the period ending at 2400 │
│ │ UTC rather than local midnight] │
├──────┼──────────────────────────────────────────────────────────────┤
│ THIC │ Thickness of ice on water (mm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ TOBS │ Temperature at the time of observation (degrees C) │
├──────┼──────────────────────────────────────────────────────────────┤
│ TSUN │ Daily total sunshine (minutes) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDF1 │ Direction of fastest 1-minute wind (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDF2 │ Direction of fastest 2-minute wind (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDF5 │ Direction of fastest 5-second wind (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDFG │ Direction of peak wind gust (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDFI │ Direction of highest instantaneous wind (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDFM │ Fastest mile wind direction (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDMV │ 24-hour wind movement (km) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WESD │ Water equivalent of snow on the ground (mm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WESF │ Water equivalent of snowfall (mm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSF1 │ Fastest 1-minute wind speed (meters per second) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSF2 │ Fastest 2-minute wind speed (meters per second) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSF5 │ Fastest 5-second wind speed (meters per second) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSFG │ Peak gust wind speed (meters per second) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSFI │ Highest instantaneous wind speed (meters per second) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSFM │ Fastest mile wind speed (meters per second) │
╘══════╧══════════════════════════════════════════════════════════════╛
SNXY and SXXY Table
┌───────┬─────────────────────────────────────────────────────────────┐
│ SNXY │ Minimum soil temperature (degrees C) where 'X' corresponds │
│ │ to a code for ground cover and 'Y' corresponds to a code │
│ │ for soil depth. │
╞═══════╪═════════════════════════════════════════════════════════════╡
│ │ Ground cover codes include the following: │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 0 │ unknown │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 1 │ grass │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 2 │ fallow │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 3 │ bare ground │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 4 │ brome grass │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 5 │ sod │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 6 │ straw mulch │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 7 │ grass muck │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 8 │ bare muck │
├───────┼─────────────────────────────────────────────────────────────┤
│ │ Depth codes include the following: │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 1 │ 5 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 2 │ 10 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 3 │ 20 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 4 │ 50 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 5 │ 100 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 6 │ 150 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 7 │ 180 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ SXXY │ Maximum soil temperature (degrees C) where the second 'X' │
│ │ corresponds to a code for ground cover and 'Y' corresponds │
│ │ to a code for soil depth. See SNXY for ground cover and │
│ │ depth codes. │
╘═══════╧═════════════════════════════════════════════════════════════╛
WTXX and WVXX Table
┌──────┬──────────────────────────────────────────────────────────────┐
│ XX │ Description │
╞══════╪══════════════════════════════════════════════════════════════╡
│ 01 │ Fog, ice fog, or freezing fog (may include heavy fog) │
├──────┼──────────────────────────────────────────────────────────────┤
│ 02 │ Heavy fog or heaving freezing fog (not always distinguished │
│ │ from fog) │
├──────┼──────────────────────────────────────────────────────────────┤
│ 03 │ Thunder │
├──────┼──────────────────────────────────────────────────────────────┤
│ 04 │ Ice pellets, sleet, snow pellets, or small hail │
├──────┼──────────────────────────────────────────────────────────────┤
│ 05 │ Hail (may include small hail) │
├──────┼──────────────────────────────────────────────────────────────┤
│ 06 │ Glaze or rime │
├──────┼──────────────────────────────────────────────────────────────┤
│ 07 │ Dust, volcanic ash, blowing dust, blowing sand, or blowing │
│ │ obstruction │
├──────┼──────────────────────────────────────────────────────────────┤
│ 08 │ Smoke or haze │
├──────┼──────────────────────────────────────────────────────────────┤
│ 09 │ Blowing or drifting snow │
├──────┼──────────────────────────────────────────────────────────────┤
│ 11 │ High or damaging winds │
├──────┼──────────────────────────────────────────────────────────────┤
│ 12 │ Blowing spray │
├──────┼──────────────────────────────────────────────────────────────┤
│ 13 │ Mist │
├──────┼──────────────────────────────────────────────────────────────┤
│ 14 │ Drizzle │
├──────┼──────────────────────────────────────────────────────────────┤
│ 15 │ Freezing drizzle │
├──────┼──────────────────────────────────────────────────────────────┤
│ 16 │ Rain (may include freezing rain, drizzle, and freezing │
│ │ drizzle) │
├──────┼──────────────────────────────────────────────────────────────┤
│ 17 │ Freezing rain │
├──────┼──────────────────────────────────────────────────────────────┤
│ 18 │ Snow, snow pellets, snow grains, or ice crystals │
├──────┼──────────────────────────────────────────────────────────────┤
│ 19 │ Unknown source of precipitation │
├──────┼──────────────────────────────────────────────────────────────┤
│ 21 │ Ground fog │
├──────┼──────────────────────────────────────────────────────────────┤
│ 22 │ Ice fog or freezing fog │
├──────┼──────────────────────────────────────────────────────────────┤
│ WVXX │ Weather in the Vicinity where XX has one of the following │
│ │ values described above: 01, 03, 07, 18, and 20 │
╘══════╧══════════════════════════════════════════════════════════════╛
For every datatype and record there is a set of meta-data flags. For the GHCNDMS
dataset, the flags are:
'Total Missing','Consecutive Missing'
Total Missing:
Defined as total number of days observation/element is missing in that month.
This can be taken as a measure of quality or completeness as the higher the
number of days sampled in the month, the more representative the value is for
the entire month.
Consecutive Missing:
Defined as the maximum number of consecutive days in the month that an
observation/element is missing.
positional arguments:
stationid The station id. from the first column of
<[4;36mhttps://www.ncei.noaa.gov/pub/data/ghcn/daily/ghcnd-stations.txt[0m>
options:
-h | --help
show this help message and exit
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
ncei_ghcnd_ftp¶
$ tsgettoolbox ncei_ghcnd_ftp --help
usage: tsgettoolbox ncei_ghcnd_ftp [-h] [--start_date START_DATE]
[--end_date END_DATE] stationid
If you use this data, please read <[4;36mhttps://www.ncei.noaa.gov/pub/data/gh-
cn/daily/readme.txt[0m> about "How to cite".
GHCN (Global Historical Climatology Network)-Daily is an integrated database of
daily climate summaries from land surface stations across the globe. Like its
monthly counterpart (GHCN-Monthly), GHCN-Daily is comprised of daily climate
records from numerous sources that have been integrated and subjected to a
common suite of quality assurance reviews.
GHCN-Daily now contains records from over 75000 stations in 180 countries and
territories. Numerous daily variables are provided, including maximum and
minimum temperature, total daily precipitation, snowfall, and snow depth;
however, about two thirds of the stations report precipitation only. Both the
record length and period of record vary by station and cover intervals ranging
from less than year to more than 175 years.
The dataset is regularly reconstructed (usually every weekend) from its 20-plus
data source components to ensure that GHCN-Daily is generally in sync with its
growing list of constituent sources. During this process, quality assurance
checks are applied to the full dataset. On most weekdays, GHCN-Daily station
data are updated when possible from a variety of data streams, which also
undergo a suite of quality checks.
Some of the data provided here are based on data exchanged under the World
Meteorological Organization (WMO) World Weather Watch Program according to WMO
Resolution 40 (Cg-XII). This allows WMO member countries to place restrictions
on the use or re-export of their data for commercial purposes outside of the
receiving country. Those countries' data summaries and products which are
available here are intended for free and unrestricted use in research,
education, and other non-commercial activities. For non-U.S. locations' data,
the data or any derived product shall not be provided to other users or be used
for the re-export of commercial services.
The five core values are:
┌──────┬────────────────────────────┐
│ Code │ Description │
╞══════╪════════════════════════════╡
│ TMAX │ Temperature MAX (degree C) │
├──────┼────────────────────────────┤
│ TMIN │ Temperature MIN (degree C) │
├──────┼────────────────────────────┤
│ PRCP │ PReCiPitation (mm) │
├──────┼────────────────────────────┤
│ SNOW │ SNOWfall (mm) │
├──────┼────────────────────────────┤
│ SNWD │ SNoW Depth (mm) │
╘══════╧════════════════════════════╛
Other possible data collected:
┌──────┬──────────────────────────────────────────────────────────────┐
│ Code │ Description │
╞══════╪══════════════════════════════════════════════════════════════╡
│ ACMC │ Average cloudiness midnight to midnight from 30-second │
│ │ ceilometer data (percent) │
├──────┼──────────────────────────────────────────────────────────────┤
│ ACMH │ Average cloudiness midnight to midnight from manual │
│ │ observations (percent) │
├──────┼──────────────────────────────────────────────────────────────┤
│ ACSC │ Average cloudiness sunrise to sunset from 30-second │
│ │ ceilometer data (percent) │
├──────┼──────────────────────────────────────────────────────────────┤
│ ACSH │ Average cloudiness sunrise to sunset from manual │
│ │ observations (percent) │
├──────┼──────────────────────────────────────────────────────────────┤
│ AWDR │ Average daily wind direction (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ AWND │ Average daily wind speed (meters per second) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DAEV │ Number of days included in the multiday evaporation total │
│ │ (MDEV) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DAPR │ Number of days included in the multiday precipitation total │
│ │ (MDPR) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DASF │ Number of days included in the multiday snowfall total │
├──────┼─(MDSF)───────────────────────────────────────────────────────┤
│ DATN │ Number of days included in the multiday minimum temperature │
│ │ (MDTN) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DATX │ Number of days included in the multiday maximum temperature │
│ │ (MDTX) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DAWM │ Number of days included in the multiday wind movement (MDWM) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DWPR │ Number of days with non-zero precipitation included in │
│ │ multiday precipitation total (MDPR) │
├──────┼──────────────────────────────────────────────────────────────┤
│ EVAP │ Evaporation of water from evaporation pan (mm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ FMTM │ Time of fastest mile or fastest 1-minute wind (hours and │
│ │ minutes, i.e., HHMM) │
├──────┼──────────────────────────────────────────────────────────────┤
│ FRGB │ Base of frozen ground layer (cm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ FRGT │ Top of frozen ground layer (cm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ FRTH │ Thickness of frozen ground layer (cm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ GAHT │ Difference between river and gauge height (cm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDEV │ Multiday evaporation total (use with DAEV) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDPR │ Multiday precipitation total (mm; use with DAPR and DWPR, if │
│ │ available) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDSF │ Multiday snowfall total │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDTN │ Multiday minimum temperature (degrees C; use with DATN) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDTX │ Multiday maximum temperature (degrees C; use with DATX) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDWM │ Multiday wind movement (km) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MNPN │ Daily minimum temperature of water in an evaporation pan │
│ │ (degrees C) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MXPN │ Daily maximum temperature of water in an evaporation pan │
│ │ (degrees C) │
├──────┼──────────────────────────────────────────────────────────────┤
│ PGTM │ Peak gust time (hours and minutes, i.e., HHMM) │
├──────┼──────────────────────────────────────────────────────────────┤
│ PSUN │ Daily percent of possible sunshine (percent) │
├──────┼──────────────────────────────────────────────────────────────┤
│ TAVG │ Average temperature (degrees C) [Note that TAVG from source │
│ │ 'S' corresponds to an average for the period ending at 2400 │
│ │ UTC rather than local midnight] │
├──────┼──────────────────────────────────────────────────────────────┤
│ THIC │ Thickness of ice on water (mm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ TOBS │ Temperature at the time of observation (degrees C) │
├──────┼──────────────────────────────────────────────────────────────┤
│ TSUN │ Daily total sunshine (minutes) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDF1 │ Direction of fastest 1-minute wind (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDF2 │ Direction of fastest 2-minute wind (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDF5 │ Direction of fastest 5-second wind (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDFG │ Direction of peak wind gust (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDFI │ Direction of highest instantaneous wind (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDFM │ Fastest mile wind direction (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDMV │ 24-hour wind movement (km) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WESD │ Water equivalent of snow on the ground (mm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WESF │ Water equivalent of snowfall (mm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSF1 │ Fastest 1-minute wind speed (meters per second) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSF2 │ Fastest 2-minute wind speed (meters per second) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSF5 │ Fastest 5-second wind speed (meters per second) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSFG │ Peak gust wind speed (meters per second) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSFI │ Highest instantaneous wind speed (meters per second) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSFM │ Fastest mile wind speed (meters per second) │
╘══════╧══════════════════════════════════════════════════════════════╛
SNXY and SXXY Table
┌───────┬─────────────────────────────────────────────────────────────┐
│ SNXY │ Minimum soil temperature (degrees C) where 'X' corresponds │
│ │ to a code for ground cover and 'Y' corresponds to a code │
│ │ for soil depth. │
╞═══════╪═════════════════════════════════════════════════════════════╡
│ │ Ground cover codes include the following: │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 0 │ unknown │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 1 │ grass │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 2 │ fallow │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 3 │ bare ground │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 4 │ brome grass │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 5 │ sod │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 6 │ straw mulch │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 7 │ grass muck │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 8 │ bare muck │
├───────┼─────────────────────────────────────────────────────────────┤
│ │ Depth codes include the following: │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 1 │ 5 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 2 │ 10 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 3 │ 20 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 4 │ 50 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 5 │ 100 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 6 │ 150 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 7 │ 180 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ SXXY │ Maximum soil temperature (degrees C) where the second 'X' │
│ │ corresponds to a code for ground cover and 'Y' corresponds │
│ │ to a code for soil depth. See SNXY for ground cover and │
│ │ depth codes. │
╘═══════╧═════════════════════════════════════════════════════════════╛
WTXX and WVXX Table
┌──────┬──────────────────────────────────────────────────────────────┐
│ XX │ Description │
╞══════╪══════════════════════════════════════════════════════════════╡
│ 01 │ Fog, ice fog, or freezing fog (may include heavy fog) │
├──────┼──────────────────────────────────────────────────────────────┤
│ 02 │ Heavy fog or heaving freezing fog (not always distinguished │
│ │ from fog) │
├──────┼──────────────────────────────────────────────────────────────┤
│ 03 │ Thunder │
├──────┼──────────────────────────────────────────────────────────────┤
│ 04 │ Ice pellets, sleet, snow pellets, or small hail │
├──────┼──────────────────────────────────────────────────────────────┤
│ 05 │ Hail (may include small hail) │
├──────┼──────────────────────────────────────────────────────────────┤
│ 06 │ Glaze or rime │
├──────┼──────────────────────────────────────────────────────────────┤
│ 07 │ Dust, volcanic ash, blowing dust, blowing sand, or blowing │
│ │ obstruction │
├──────┼──────────────────────────────────────────────────────────────┤
│ 08 │ Smoke or haze │
├──────┼──────────────────────────────────────────────────────────────┤
│ 09 │ Blowing or drifting snow │
├──────┼──────────────────────────────────────────────────────────────┤
│ 11 │ High or damaging winds │
├──────┼──────────────────────────────────────────────────────────────┤
│ 12 │ Blowing spray │
├──────┼──────────────────────────────────────────────────────────────┤
│ 13 │ Mist │
├──────┼──────────────────────────────────────────────────────────────┤
│ 14 │ Drizzle │
├──────┼──────────────────────────────────────────────────────────────┤
│ 15 │ Freezing drizzle │
├──────┼──────────────────────────────────────────────────────────────┤
│ 16 │ Rain (may include freezing rain, drizzle, and freezing │
│ │ drizzle) │
├──────┼──────────────────────────────────────────────────────────────┤
│ 17 │ Freezing rain │
├──────┼──────────────────────────────────────────────────────────────┤
│ 18 │ Snow, snow pellets, snow grains, or ice crystals │
├──────┼──────────────────────────────────────────────────────────────┤
│ 19 │ Unknown source of precipitation │
├──────┼──────────────────────────────────────────────────────────────┤
│ 21 │ Ground fog │
├──────┼──────────────────────────────────────────────────────────────┤
│ 22 │ Ice fog or freezing fog │
├──────┼──────────────────────────────────────────────────────────────┤
│ WVXX │ Weather in the Vicinity where XX has one of the following │
│ │ values described above: 01, 03, 07, 18, and 20 │
╘══════╧══════════════════════════════════════════════════════════════╛
positional arguments:
stationid The station id. from the first column of
<[4;36mhttps://www.ncei.noaa.gov/pub/data/ghcn/daily/ghcnd-stations.txt[0m>
options:
-h | --help
show this help message and exit
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
ncei_ghcndms¶
$ tsgettoolbox ncei_ghcndms --help
usage: tsgettoolbox ncei_ghcndms [-h] [--start_date START_DATE]
[--end_date END_DATE] stationid
Requires registration and free API key.
For every datatype and record there is a set of meta-data flags.
GHCNDMS Meta-Data Flags
┌─────────────────────┬───────────────────────────────────────────────┐
│ Total Missing │ Defined as total number of days │
│ │ observation/element is missing in that month. │
│ │ This can be taken as a measure of quality or │
│ │ completeness as the higher the number of days │
│ │ sampled in the month, the more representative │
│ │ the value is for the entire month. │
├─────────────────────┼───────────────────────────────────────────────┤
│ Consecutive Missing │ Defined as the maximum number of consecutive │
│ │ days in the month that an observation/element │
│ │ is missing. │
╘═════════════════════╧═══════════════════════════════════════════════╛
The following table lists the datatypes available for the 'ghcndms' dataset. Not
all datatypes are available for all stations.
┌──────┬──────────────────────────────────────────────────────────────┐
│ Code │ Description │
╞══════╪══════════════════════════════════════════════════════════════╡
│ ACMC │ Average cloudiness midnight to midnight from 30-second │
│ │ ceilometer data │
├──────┼──────────────────────────────────────────────────────────────┤
│ ACMH │ Average cloudiness midnight to midnight from manual │
│ │ observations │
├──────┼──────────────────────────────────────────────────────────────┤
│ ACSC │ Average cloudiness sunrise to sunset from 30-second │
│ │ ceilometer data │
├──────┼──────────────────────────────────────────────────────────────┤
│ ACSH │ Average cloudiness sunrise to sunset from manual │
├──────┼─observations─────────────────────────────────────────────────┤
│ AWND │ Average wind speed │
├──────┼──────────────────────────────────────────────────────────────┤
│ DAEV │ Number of days included in the multiday evaporation total │
│ │ (MDEV) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DAPR │ Number of days included in the multiday precipitation total │
│ │ (MDPR) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DASF │ Number of days included in the multiday snow fall total │
├──────┼─(MDSF)───────────────────────────────────────────────────────┤
│ DATN │ Number of days included in the multiday minimum temperature │
│ │ (MDTN) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DATX │ Number of days included in the multiday maximum temperature │
│ │ (MDTX) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DAWM │ Number of days included in the multiday wind movement (MDWM) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DWPR │ Number of days with non-zero precipitation included in │
│ │ multiday precipitation total (MDPR) │
├──────┼──────────────────────────────────────────────────────────────┤
│ EVAP │ Evaporation of water from evaporation pan │
├──────┼──────────────────────────────────────────────────────────────┤
│ FMTM │ Time of fastest mile or fastest 1-minute wind │
├──────┼──────────────────────────────────────────────────────────────┤
│ FRGB │ Base of frozen ground layer │
├──────┼──────────────────────────────────────────────────────────────┤
│ FRGT │ Top of frozen ground layer │
├──────┼──────────────────────────────────────────────────────────────┤
│ FRTH │ Thickness of frozen ground layer │
├──────┼──────────────────────────────────────────────────────────────┤
│ GAHT │ Difference between river and gauge height │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDEV │ Multiday evaporation total (use with DAEV) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDPR │ Multiday precipitation total (use with DAPR and DWPR, if │
│ │ available) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDSF │ Multiday snowfall total │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDTN │ Multiday minimum temperature (use with DATN) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDTX │ Multiday maximum temperature (use with DATX) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDWM │ Multiday wind movement │
├──────┼──────────────────────────────────────────────────────────────┤
│ MNPN │ Daily minimum temperature of water in an evaporation pan │
├──────┼──────────────────────────────────────────────────────────────┤
│ MXPN │ Daily maximum temperature of water in an evaporation pan │
├──────┼──────────────────────────────────────────────────────────────┤
│ PGTM │ Peak gust time │
├──────┼──────────────────────────────────────────────────────────────┤
│ PRCP │ Precipitation │
├──────┼──────────────────────────────────────────────────────────────┤
│ PSUN │ Daily percent of possible sunshine for the period │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN01 │ Minimum soil temperature with unknown cover at 5 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN02 │ Minimum soil temperature with unknown cover at 10 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN03 │ Minimum soil temperature with unknown cover at 20 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN11 │ Minimum soil temperature with grass cover at 5 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN12 │ Minimum soil temperature with grass cover at 10 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN13 │ Minimum soil temperature with grass cover at 20 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN14 │ Minimum soil temperature with grass cover at 50 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN21 │ Minimum soil temperature with fallow cover at 5 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN22 │ Minimum soil temperature with fallow cover at 10 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN23 │ Minimum soil temperature with fallow cover at 20 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN31 │ Minimum soil temperature with bare ground cover at 5 cm │
├──────┼─depth────────────────────────────────────────────────────────┤
│ SN32 │ Minimum soil temperature with bare ground cover at 10 cm │
├──────┼─depth────────────────────────────────────────────────────────┤
│ SN33 │ Minimum soil temperature with bare ground cover at 20 cm │
├──────┼─depth────────────────────────────────────────────────────────┤
│ SN34 │ Minimum soil temperature with bare ground cover at 50 cm │
├──────┼─depth────────────────────────────────────────────────────────┤
│ SN35 │ Minimum soil temperature with bare ground cover at 100 cm │
│ │ depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN36 │ Minimum soil temperature with bare ground cover at 150 cm │
│ │ depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN51 │ Minimum soil temperature with sod cover at 5 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN52 │ Minimum soil temperature with sod cover at 10 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN53 │ Minimum soil temperature with sod cover at 20 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN54 │ Minimum soil temperature with sod cover at 50 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN55 │ Minimum soil temperature with sod cover at 100 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN56 │ Minimum soil temperature with sod cover at 150 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN57 │ Minimum soil temperature with sod cover at 180 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN61 │ Minimum soil temperature with straw multch cover at 5 cm │
├──────┼─depth────────────────────────────────────────────────────────┤
│ SN72 │ Minimum soil temperature with grass muck cover at 10 cm │
├──────┼─depth────────────────────────────────────────────────────────┤
│ SN81 │ Minimum soil temperature with bare muck cover at 5 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN82 │ Minimum soil temperature with bare muck cover at 10 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SN83 │ Minimum soil temperature with bare muck cover at 20 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SNOW │ Snowfall │
├──────┼──────────────────────────────────────────────────────────────┤
│ SNWD │ Snow depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX01 │ Maximum soil temperature with unknown cover at 5 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX02 │ Maximum soil temperature with unknown cover at 10 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX03 │ Maximum soil temperature with unknown cover at 20 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX11 │ Maximum soil temperature with grass cover at 5 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX12 │ Maximum soil temperature with grass cover at 10 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX13 │ Maximum soil temperature with grass cover at 20 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX14 │ Maximum soil temperature with grass cover at 50 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX15 │ Maximum soil temperature with grass cover at 100 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX17 │ Maximum soil temperature with grass cover at 180 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX21 │ Maximum soil temperature with fallow cover at 5 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX22 │ Maximum soil temperature with fallow cover at 10 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX23 │ Maximum soil temperature with fallow cover at 20 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX31 │ Maximum soil temperature with bare ground cover at 5 cm │
├──────┼─depth────────────────────────────────────────────────────────┤
│ SX32 │ Maximum soil temperature with bare ground cover at 10 cm │
├──────┼─depth────────────────────────────────────────────────────────┤
│ SX33 │ Maximum soil temperature with bare ground cover at 20 cm │
├──────┼─depth────────────────────────────────────────────────────────┤
│ SX34 │ Maximum soil temperature with bare ground cover at 50 cm │
├──────┼─depth────────────────────────────────────────────────────────┤
│ SX35 │ Maximum soil temperature with bare ground cover at 100 cm │
│ │ depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX36 │ Maximum soil temperature with bare ground cover at 150 cm │
│ │ depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX51 │ Maximum soil temperature with sod cover at 5 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX52 │ Maximum soil temperature with sod cover at 10 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX53 │ Maximum soil temperature with sod cover at 20 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX54 │ Maximum soil temperature with sod cover at 50 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX55 │ Maximum soil temperature with sod cover at 100 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX56 │ Maximum soil temperature with sod cover at 150 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX57 │ Maximum soil temperature with sod cover at 180 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX61 │ Maximum soil temperature with straw mulch cover at 5 cm │
├──────┼─depth────────────────────────────────────────────────────────┤
│ SX72 │ Maximum soil temperature with grass muck cover at 10 cm │
├──────┼─depth────────────────────────────────────────────────────────┤
│ SX81 │ Maximum soil temperature with bare muck cover at 5 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX82 │ Maximum soil temperature with bare muck cover at 10 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ SX83 │ Maximum soil temperature with bare muck cover at 20 cm depth │
├──────┼──────────────────────────────────────────────────────────────┤
│ TAVG │ Average Temperature. │
├──────┼──────────────────────────────────────────────────────────────┤
│ THIC │ Thickness of ice on water │
├──────┼──────────────────────────────────────────────────────────────┤
│ TMAX │ Maximum temperature │
├──────┼──────────────────────────────────────────────────────────────┤
│ TMIN │ Minimum temperature │
├──────┼──────────────────────────────────────────────────────────────┤
│ TOBS │ Temperature at the time of observation │
├──────┼──────────────────────────────────────────────────────────────┤
│ TSUN │ Total sunshine for the period │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDF1 │ Direction of fastest 1-minute wind │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDF2 │ Direction of fastest 2-minute wind │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDF5 │ Direction of fastest 5-second wind │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDFG │ Direction of peak wind gust │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDFI │ Direction of highest instantaneous wind │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDFM │ Fastest mile wind direction │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDMV │ Total wind movement │
├──────┼──────────────────────────────────────────────────────────────┤
│ WESD │ Water equivalent of snow on the ground │
├──────┼──────────────────────────────────────────────────────────────┤
│ WESF │ Water equivalent of snowfall │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSF1 │ Fastest 1-minute wind speed │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSF2 │ Fastest 2-minute wind speed │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSF5 │ Fastest 5-second wind speed │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSFG │ Peak gust wind speed │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSFI │ Highest instantaneous wind speed │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSFM │ Fastest mile wind speed │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT01 │ Fog, ice fog, or freezing fog (may include heavy fog) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT02 │ Heavy fog or heaving freezing fog (not always distinguished │
│ │ from fog) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT03 │ Thunder │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT04 │ Ice pellets, sleet, snow pellets, or small hail │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT05 │ Hail (may include small hail) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT06 │ Glaze or rime │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT07 │ Dust, volcanic ash, blowing dust, blowing sand, or blowing │
│ │ obstruction │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT08 │ Smoke or haze │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT09 │ Blowing or drifting snow │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT10 │ Tornado, waterspout, or funnel cloud │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT11 │ High or damaging winds │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT12 │ Blowing spray │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT13 │ Mist │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT14 │ Drizzle │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT15 │ Freezing drizzle │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT16 │ Rain (may include freezing rain, drizzle, and freezing │
│ │ drizzle) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT17 │ Freezing rain │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT18 │ Snow, snow pellets, snow grains, or ice crystals │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT19 │ Unknown source of precipitation │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT21 │ Ground fog │
├──────┼──────────────────────────────────────────────────────────────┤
│ WT22 │ Ice fog or freezing fog │
├──────┼──────────────────────────────────────────────────────────────┤
│ WV01 │ Fog, ice fog, or freezing fog (may include heavy fog) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WV03 │ Thunder │
├──────┼──────────────────────────────────────────────────────────────┤
│ WV07 │ Ash, dust, sand, or other blowing obstruction │
├──────┼──────────────────────────────────────────────────────────────┤
│ WV18 │ Snow or ice crystals │
├──────┼──────────────────────────────────────────────────────────────┤
│ WV20 │ Rain or snow shower │
╘══════╧══════════════════════════════════════════════════════════════╛
positional arguments:
stationid The station id. from the first column of
<[4;36mhttps://www.ncei.noaa.gov/pub/data/ghcn/daily/ghcnd-stations.txt[0m>
options:
-h | --help
show this help message and exit
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
ncei_gsod¶
$ tsgettoolbox ncei_gsod --help
usage: tsgettoolbox ncei_gsod [-h] [--start_date START_DATE]
[--end_date END_DATE] stationid
National Centers for Environmental Information (NCEI) Global Summary of the
MONTH (GSOM) <[4;36mhttps://gis.ncdc.noaa.gov/all-records/catalog/search/resou-
rce/details.page[0m> Cite this dataset when used as a source: Lawrimore, Jay (2016).
Global Summary of the Month, Version 1.0. [indicate subset used]. NOAA National
Centers for Environmental Information. DOI:10.7289/V5QV3JJ5
National Centers for Environmental Information (NCEI) Global Summary of the YEAR
(GSOY) <[4;36mhttps://gis.ncdc.noaa.gov/all-records/catalog/search/resource/de-
tails.page?id=gov.noaa.ncei:C00947[0m> Cite this dataset when used as a source: Lawrimore,
Jay (2016). Global Summary of the Year, Version 1.0. [indicate subset used].
NOAA National Centers for Environmental Information
Requires registration and free API key.
NCEI cannot assume liability for any damages caused by any errors or omissions
in the data, nor as a result of the failure of the data to function on a
particular system. NCEI makes no warranty, expressed or implied, nor does the
fact of distribution constitute such a warranty. NCEI can only certify that the
data it distributes are an authentic copy of the records that were accepted for
inclusion in the NCEI archives.
The global summaries data set contains a monthly (GSOM) resolution of
meteorological elements (max temp, snow, etc) from 1763 to present with updates
weekly. The major parameters are: monthly mean maximum, mean minimum and mean
temperatures; monthly total precipitation and snowfall; departure from normal of
the mean temperature and total precipitation; monthly heating and cooling degree
days; number of days that temperatures and precipitation are above or below
certain thresholds; and extreme daily temperature and precipitation amounts. The
primary source data set source is the Global Historical Climatology Network
(GHCN)-Daily Data set. The global summaries data set also contains a yearly
(GSOY) resolution of meteorological elements. See associated resources for more
information. This data is not to be confused with "GHCN-Monthly", "Annual
Summaries" or "ncei Summary of the Month". There are unique elements that are
produced globally within the GSOM and GSOY data files. There are also bias
corrected temperature data in GHCN-Monthly, which will not be available in GSOM
and GSOY. The GSOM and GSOY data set is going to replace the legacy DSI-3220 and
expand to include non-U.S. (a.k.a. global) stations. DSI-3220 only included
National Weather Service (NWS) COOP Published, or "Published in CD", sites. For
every datatype and record there is a set of meta-data flags.
For the GHCNDMS dataset the flags are:
'Total Missing','Consecutive Missing'
Total Missing:
Defined as total number of days observation/element is missing in that month.
This can be taken as a measure of quality or completeness as the higher the
number of days sampled in the month, the more representative the value is for
the entire month.
Consecutive Missing:
Defined as the maximum number of consecutive days in the month that an
observation/element is missing.
positional arguments:
stationid The station id. from the first column of
<[4;36mhttps://www.ncei.noaa.gov/pub/data/ghcn/daily/ghcnd-stations.txt[0m>
options:
-h | --help
show this help message and exit
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
ncei_gsom¶
$ tsgettoolbox ncei_gsom --help
usage: tsgettoolbox ncei_gsom [-h] [--start_date START_DATE]
[--end_date END_DATE] stationid
National Centers for Environmental Information (NCEI) Global Summary of the
MONTH (GSOM) <[4;36mhttps://gis.ncdc.noaa.gov/all-records/catalog/search/resou-
rce/details.page[0m> Cite this dataset when used as a source: Lawrimore, Jay (2016).
Global Summary of the Month, Version 1.0. [indicate subset used]. NOAA National
Centers for Environmental Information. DOI:10.7289/V5QV3JJ5
National Centers for Environmental Information (NCEI) Global Summary of the YEAR
(GSOY) <[4;36mhttps://gis.ncdc.noaa.gov/all-records/catalog/search/resource/de-
tails.page?id=gov.noaa.ncei:C00947[0m> Cite this dataset when used as a source: Lawrimore,
Jay (2016). Global Summary of the Year, Version 1.0. [indicate subset used].
NOAA National Centers for Environmental Information
Requires registration and free API key.
NCEI cannot assume liability for any damages caused by any errors or omissions
in the data, nor as a result of the failure of the data to function on a
particular system. NCEI makes no warranty, expressed or implied, nor does the
fact of distribution constitute such a warranty. NCEI can only certify that the
data it distributes are an authentic copy of the records that were accepted for
inclusion in the NCEI archives.
The global summaries data set contains a monthly (GSOM) resolution of
meteorological elements (max temp, snow, etc) from 1763 to present with updates
weekly. The major parameters are: monthly mean maximum, mean minimum and mean
temperatures; monthly total precipitation and snowfall; departure from normal of
the mean temperature and total precipitation; monthly heating and cooling degree
days; number of days that temperatures and precipitation are above or below
certain thresholds; and extreme daily temperature and precipitation amounts. The
primary source data set source is the Global Historical Climatology Network
(GHCN)-Daily Data set. The global summaries data set also contains a yearly
(GSOY) resolution of meteorological elements. See associated resources for more
information. This data is not to be confused with "GHCN-Monthly", "Annual
Summaries" or "ncei Summary of the Month". There are unique elements that are
produced globally within the GSOM and GSOY data files. There are also bias
corrected temperature data in GHCN-Monthly, which will not be available in GSOM
and GSOY. The GSOM and GSOY data set is going to replace the legacy DSI-3220 and
expand to include non-U.S. (a.k.a. global) stations. DSI-3220 only included
National Weather Service (NWS) COOP Published, or "Published in CD", sites. For
every datatype and record there is a set of meta-data flags.
For the GHCNDMS dataset the flags are:
'Total Missing','Consecutive Missing'
Total Missing:
Defined as total number of days observation/element is missing in that month.
This can be taken as a measure of quality or completeness as the higher the
number of days sampled in the month, the more representative the value is for
the entire month.
Consecutive Missing:
Defined as the maximum number of consecutive days in the month that an
observation/element is missing.
positional arguments:
stationid The station id. from the first column of
<[4;36mhttps://www.ncei.noaa.gov/pub/data/ghcn/daily/ghcnd-stations.txt[0m>
options:
-h | --help
show this help message and exit
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
ncei_gsoy¶
$ tsgettoolbox ncei_gsoy --help
usage: tsgettoolbox ncei_gsoy [-h] [--start_date START_DATE]
[--end_date END_DATE] stationid
National Centers for Environmental Information (NCEI) Global Summary of the YEAR
(GSOY) <[4;36mhttps://gis.ncdc.noaa.gov/all-records/catalog/search/resource/de-
tails.page?id=gov.noaa.ncei:C00947[0m> Cite this dataset when used as a source: Lawrimore,
Jay (2016). Global Summary of the Year, Version 1.0. [indicate subset used].
NOAA National Centers for Environmental Information. DOI:10.7289/V5QV3JJ5
Requires registration and free API key.
NCEI cannot assume liability for any damages caused by any errors or omissions
in the data, nor as a result of the failure of the data to function on a
particular system. NCEI makes no warranty, expressed or implied, nor does the
fact of distribution constitute such a warranty. NCEI can only certify that the
data it distributes are an authentic copy of the records that were accepted for
inclusion in the NCEI archives.
The global summaries data set contains a monthly (GSOM) resolution of
meteorological elements (max temp, snow, etc) from 1763 to present with updates
weekly. The major parameters are: monthly mean maximum, mean minimum and mean
temperatures; monthly total precipitation and snowfall; departure from normal of
the mean temperature and total precipitation; monthly heating and cooling degree
days; number of days that temperatures and precipitation are above or below
certain thresholds; and extreme daily temperature and precipitation amounts. The
primary source data set source is the Global Historical Climatology Network
(GHCN)-Daily Data set. The global summaries data set also contains a yearly
(GSOY) resolution of meteorological elements. See associated resources for more
information. This data is not to be confused with "GHCN-Monthly", "Annual
Summaries" or "ncei Summary of the Month". There are unique elements that are
produced globally within the GSOM and GSOY data files. There are also bias
corrected temperature data in GHCN-Monthly, which will not be available in GSOM
and GSOY. The GSOM and GSOY data set is going to replace the legacy DSI-3220 and
expand to include non-U.S. (a.k.a. global) stations. DSI-3220 only included
National Weather Service (NWS) COOP Published, or "Published in CD", sites. For
every datatype and record there is a set of meta-data flags.
For the GHCNDMS dataset the flags are:
'Total Missing','Consecutive Missing'
Total Missing:
Defined as total number of days observation/element is missing in that month.
This can be taken as a measure of quality or completeness as the higher the
number of days sampled in the month, the more representative the value is for
the entire month.
Consecutive Missing:
Defined as the maximum number of consecutive days in the month that an
observation/element is missing.
positional arguments:
stationid The station id. from the first column of
<[4;36mhttps://www.ncei.noaa.gov/pub/data/ghcn/daily/ghcnd-stations.txt[0m>
options:
-h | --help
show this help message and exit
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
ncei_ish¶
$ tsgettoolbox ncei_ish --help
usage: tsgettoolbox ncei_ish [-h] [--start_date START_DATE]
[--end_date END_DATE] stationid
If you use this data, please read <[4;36mhttps://www.ncei.noaa.gov/pub/data/gh-
cn/daily/readme.txt[0m> about "How to cite".
GHCN (Global Historical Climatology Network)-Daily is an integrated database of
daily climate summaries from land surface stations across the globe. Like its
monthly counterpart (GHCN-Monthly), GHCN-Daily is comprised of daily climate
records from numerous sources that have been integrated and subjected to a
common suite of quality assurance reviews.
GHCN-Daily now contains records from over 75000 stations in 180 countries and
territories. Numerous daily variables are provided, including maximum and
minimum temperature, total daily precipitation, snowfall, and snow depth;
however, about two thirds of the stations report precipitation only. Both the
record length and period of record vary by station and cover intervals ranging
from less than year to more than 175 years.
The dataset is regularly reconstructed (usually every weekend) from its 20-plus
data source components to ensure that GHCN-Daily is generally in sync with its
growing list of constituent sources. During this process, quality assurance
checks are applied to the full dataset. On most weekdays, GHCN-Daily station
data are updated when possible from a variety of data streams, which also
undergo a suite of quality checks.
Some of the data provided here are based on data exchanged under the World
Meteorological Organization (WMO) World Weather Watch Program according to WMO
Resolution 40 (Cg-XII). This allows WMO member countries to place restrictions
on the use or re-export of their data for commercial purposes outside of the
receiving country. Those countries' data summaries and products which are
available here are intended for free and unrestricted use in research,
education, and other non-commercial activities. For non-U.S. locations' data,
the data or any derived product shall not be provided to other users or be used
for the re-export of commercial services.
The five core values are:
┌──────┬────────────────────────────┐
│ Code │ Description │
╞══════╪════════════════════════════╡
│ TMAX │ Temperature MAX (degree C) │
├──────┼────────────────────────────┤
│ TMIN │ Temperature MIN (degree C) │
├──────┼────────────────────────────┤
│ PRCP │ PReCiPitation (mm) │
├──────┼────────────────────────────┤
│ SNOW │ SNOWfall (mm) │
├──────┼────────────────────────────┤
│ SNWD │ SNoW Depth (mm) │
╘══════╧════════════════════════════╛
Other possible data collected:
┌──────┬──────────────────────────────────────────────────────────────┐
│ Code │ Description │
╞══════╪══════════════════════════════════════════════════════════════╡
│ ACMC │ Average cloudiness midnight to midnight from 30-second │
│ │ ceilometer data (percent) │
├──────┼──────────────────────────────────────────────────────────────┤
│ ACMH │ Average cloudiness midnight to midnight from manual │
│ │ observations (percent) │
├──────┼──────────────────────────────────────────────────────────────┤
│ ACSC │ Average cloudiness sunrise to sunset from 30-second │
│ │ ceilometer data (percent) │
├──────┼──────────────────────────────────────────────────────────────┤
│ ACSH │ Average cloudiness sunrise to sunset from manual │
│ │ observations (percent) │
├──────┼──────────────────────────────────────────────────────────────┤
│ AWDR │ Average daily wind direction (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ AWND │ Average daily wind speed (meters per second) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DAEV │ Number of days included in the multiday evaporation total │
│ │ (MDEV) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DAPR │ Number of days included in the multiday precipitation total │
│ │ (MDPR) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DASF │ Number of days included in the multiday snowfall total │
├──────┼─(MDSF)───────────────────────────────────────────────────────┤
│ DATN │ Number of days included in the multiday minimum temperature │
│ │ (MDTN) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DATX │ Number of days included in the multiday maximum temperature │
│ │ (MDTX) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DAWM │ Number of days included in the multiday wind movement (MDWM) │
├──────┼──────────────────────────────────────────────────────────────┤
│ DWPR │ Number of days with non-zero precipitation included in │
│ │ multiday precipitation total (MDPR) │
├──────┼──────────────────────────────────────────────────────────────┤
│ EVAP │ Evaporation of water from evaporation pan (mm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ FMTM │ Time of fastest mile or fastest 1-minute wind (hours and │
│ │ minutes, i.e., HHMM) │
├──────┼──────────────────────────────────────────────────────────────┤
│ FRGB │ Base of frozen ground layer (cm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ FRGT │ Top of frozen ground layer (cm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ FRTH │ Thickness of frozen ground layer (cm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ GAHT │ Difference between river and gauge height (cm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDEV │ Multiday evaporation total (use with DAEV) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDPR │ Multiday precipitation total (mm; use with DAPR and DWPR, if │
│ │ available) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDSF │ Multiday snowfall total │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDTN │ Multiday minimum temperature (degrees C; use with DATN) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDTX │ Multiday maximum temperature (degrees C; use with DATX) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MDWM │ Multiday wind movement (km) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MNPN │ Daily minimum temperature of water in an evaporation pan │
│ │ (degrees C) │
├──────┼──────────────────────────────────────────────────────────────┤
│ MXPN │ Daily maximum temperature of water in an evaporation pan │
│ │ (degrees C) │
├──────┼──────────────────────────────────────────────────────────────┤
│ PGTM │ Peak gust time (hours and minutes, i.e., HHMM) │
├──────┼──────────────────────────────────────────────────────────────┤
│ PSUN │ Daily percent of possible sunshine (percent) │
├──────┼──────────────────────────────────────────────────────────────┤
│ TAVG │ Average temperature (degrees C) [Note that TAVG from source │
│ │ 'S' corresponds to an average for the period ending at 2400 │
│ │ UTC rather than local midnight] │
├──────┼──────────────────────────────────────────────────────────────┤
│ THIC │ Thickness of ice on water (mm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ TOBS │ Temperature at the time of observation (degrees C) │
├──────┼──────────────────────────────────────────────────────────────┤
│ TSUN │ Daily total sunshine (minutes) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDF1 │ Direction of fastest 1-minute wind (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDF2 │ Direction of fastest 2-minute wind (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDF5 │ Direction of fastest 5-second wind (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDFG │ Direction of peak wind gust (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDFI │ Direction of highest instantaneous wind (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDFM │ Fastest mile wind direction (degrees) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WDMV │ 24-hour wind movement (km) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WESD │ Water equivalent of snow on the ground (mm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WESF │ Water equivalent of snowfall (mm) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSF1 │ Fastest 1-minute wind speed (meters per second) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSF2 │ Fastest 2-minute wind speed (meters per second) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSF5 │ Fastest 5-second wind speed (meters per second) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSFG │ Peak gust wind speed (meters per second) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSFI │ Highest instantaneous wind speed (meters per second) │
├──────┼──────────────────────────────────────────────────────────────┤
│ WSFM │ Fastest mile wind speed (meters per second) │
╘══════╧══════════════════════════════════════════════════════════════╛
SNXY and SXXY Table
┌───────┬─────────────────────────────────────────────────────────────┐
│ SNXY │ Minimum soil temperature (degrees C) where 'X' corresponds │
│ │ to a code for ground cover and 'Y' corresponds to a code │
│ │ for soil depth. │
╞═══════╪═════════════════════════════════════════════════════════════╡
│ │ Ground cover codes include the following: │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 0 │ unknown │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 1 │ grass │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 2 │ fallow │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 3 │ bare ground │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 4 │ brome grass │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 5 │ sod │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 6 │ straw mulch │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 7 │ grass muck │
├───────┼─────────────────────────────────────────────────────────────┤
│ X = 8 │ bare muck │
├───────┼─────────────────────────────────────────────────────────────┤
│ │ Depth codes include the following: │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 1 │ 5 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 2 │ 10 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 3 │ 20 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 4 │ 50 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 5 │ 100 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 6 │ 150 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ Y = 7 │ 180 cm │
├───────┼─────────────────────────────────────────────────────────────┤
│ SXXY │ Maximum soil temperature (degrees C) where the second 'X' │
│ │ corresponds to a code for ground cover and 'Y' corresponds │
│ │ to a code for soil depth. See SNXY for ground cover and │
│ │ depth codes. │
╘═══════╧═════════════════════════════════════════════════════════════╛
WTXX and WVXX Table
┌──────┬──────────────────────────────────────────────────────────────┐
│ XX │ Description │
╞══════╪══════════════════════════════════════════════════════════════╡
│ 01 │ Fog, ice fog, or freezing fog (may include heavy fog) │
├──────┼──────────────────────────────────────────────────────────────┤
│ 02 │ Heavy fog or heaving freezing fog (not always distinguished │
│ │ from fog) │
├──────┼──────────────────────────────────────────────────────────────┤
│ 03 │ Thunder │
├──────┼──────────────────────────────────────────────────────────────┤
│ 04 │ Ice pellets, sleet, snow pellets, or small hail │
├──────┼──────────────────────────────────────────────────────────────┤
│ 05 │ Hail (may include small hail) │
├──────┼──────────────────────────────────────────────────────────────┤
│ 06 │ Glaze or rime │
├──────┼──────────────────────────────────────────────────────────────┤
│ 07 │ Dust, volcanic ash, blowing dust, blowing sand, or blowing │
│ │ obstruction │
├──────┼──────────────────────────────────────────────────────────────┤
│ 08 │ Smoke or haze │
├──────┼──────────────────────────────────────────────────────────────┤
│ 09 │ Blowing or drifting snow │
├──────┼──────────────────────────────────────────────────────────────┤
│ 11 │ High or damaging winds │
├──────┼──────────────────────────────────────────────────────────────┤
│ 12 │ Blowing spray │
├──────┼──────────────────────────────────────────────────────────────┤
│ 13 │ Mist │
├──────┼──────────────────────────────────────────────────────────────┤
│ 14 │ Drizzle │
├──────┼──────────────────────────────────────────────────────────────┤
│ 15 │ Freezing drizzle │
├──────┼──────────────────────────────────────────────────────────────┤
│ 16 │ Rain (may include freezing rain, drizzle, and freezing │
│ │ drizzle) │
├──────┼──────────────────────────────────────────────────────────────┤
│ 17 │ Freezing rain │
├──────┼──────────────────────────────────────────────────────────────┤
│ 18 │ Snow, snow pellets, snow grains, or ice crystals │
├──────┼──────────────────────────────────────────────────────────────┤
│ 19 │ Unknown source of precipitation │
├──────┼──────────────────────────────────────────────────────────────┤
│ 21 │ Ground fog │
├──────┼──────────────────────────────────────────────────────────────┤
│ 22 │ Ice fog or freezing fog │
├──────┼──────────────────────────────────────────────────────────────┤
│ WVXX │ Weather in the Vicinity where XX has one of the following │
│ │ values described above: 01, 03, 07, 18, and 20 │
╘══════╧══════════════════════════════════════════════════════════════╛
positional arguments:
stationid The station id. from the first column of
<[4;36mhttps://www.ncei.noaa.gov/pub/data/ghcn/daily/ghcnd-stations.txt[0m>
options:
-h | --help
show this help message and exit
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
ncei_normal_ann¶
$ tsgettoolbox ncei_normal_ann --help
usage: tsgettoolbox ncei_normal_ann [-h] stationid
Requires registration and free API key.
The 1981-2010 Normals comprise all climate normals using the thirty year period
of temperature, degree days, precipitation, snowfall, snow depth, wind, etc.
Data is organized into hourly, daily, monthly, seasonal and annual. This
document describes the elements and layout of the Seasonal and Annual Normals
which are derived from a composite of climate records from numerous sources that
were merged and then subjected to a suite of quality assurance reviews.
flags accompany every normals value and indicate the completeness of the data
record used to compute each value, accounting for methodological differences for
different product classes. There are six flag options described generally below.
Due to methodological differences, the flags are applied somewhat differently
between the temperature-based normals and the precipitation-based normals. For
the precipitation-based and hourly normals, the following flags were assigned
independently for each normals value reported based on number of years available
for that individual calculation. For temperature-based normals, strong
precedence is given to the monthly normals of maximum and minimum temperature or
derived from the flags for these two variables.
┌───────┬─────────────────────────────────────────────────────────────┐
│ Code │ Description │
╞═══════╪═════════════════════════════════════════════════════════════╡
│ C │ complete (all 30 years used) │
├───────┼─────────────────────────────────────────────────────────────┤
│ S │ standard (no more than 5 years missing and no more than 3 │
│ │ consecutive years missing among the sufficiently complete │
│ │ years) │
├───────┼─────────────────────────────────────────────────────────────┤
│ R │ representative (observed record utilized incomplete, but │
│ │ value was scaled or based on filled values to be │
│ │ representative of the full period of record) │
├───────┼─────────────────────────────────────────────────────────────┤
│ P │ provisional (at least 10 years used, but not sufficiently │
│ │ complete to be labeled as standard or representative). Also │
│ │ used for parameter values on February 29 as well as for │
│ │ interpolated daily precipitation, snowfall, and snow depth │
│ │ percentiles. │
├───────┼─────────────────────────────────────────────────────────────┤
│ Q │ quasi-normal (at least 2 years per month, but not │
│ │ sufficiently complete to be labeled as provisional or any │
│ │ other higher flag code. The associated value was computed │
│ │ using a pseudo-normals approach or derived from monthly │
│ │ pseudo-normals. │
├───────┼─────────────────────────────────────────────────────────────┤
│ Blank │ the data value is reported as a special value (see section │
│ │ B under III. Additional Information below). │
╘═══════╧═════════════════════════════════════════════════════════════╛
Note: flags Q and R aren't applicable to average number of days with different
precipitation, snowfall, and snow depth threshold exceedance;
precipitation/snowfall/snow probabilities of occurrence. Further, Q flags are
not applicable for standard deviations.
The following table lists the datatypes available for the annual dataset. Not
all of these are available at all stations.
┌─────────────────────────┬───────────────────────────────────────────┐
│ Code │ Description │
╞═════════════════════════╪═══════════════════════════════════════════╡
│ ANN-CLDD-BASExx │ Average annual cooling degree days where │
│ │ xx is the base in degree F. 'xx' can be │
│ │ one of 45, 50, 57, 60, 65, 70, 72 │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-CLDD-NORMAL │ Average annual cooling degree days with │
│ │ base 65F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-DUTR-NORMAL │ Average annual diurnal temperature range │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-GRDD-BASExx │ Average annual growing degree days where │
│ │ xx is the base in degree F. 'xx' can be │
│ │ one of 40, 45, 50, 55, 57, 60, 65, 70, │
├─────────────────────────┼─72.───────────────────────────────────────┤
│ ANN-GRDD-TB4886 │ Average annual growing degree days with │
│ │ truncated bases 48F and 86F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-GRDD-TB5086 │ Average annual growing degree days with │
│ │ truncated bases 50F and 86F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-HTDD-BASE40 │ Average annual heating degree days with │
│ │ base 40F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-HTDD-BASE45 │ Average annual heating degree days with │
│ │ base 45F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-HTDD-BASE50 │ Average annual heating degree days with │
│ │ base 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-HTDD-BASE55 │ Average annual heating degree days with │
│ │ base 55F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-HTDD-BASE57 │ Average annual heating degree days with │
│ │ base 57F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-HTDD-BASE60 │ Average annual heating degree days with │
│ │ base 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-HTDD-NORMAL │ Average annual heating degree days with │
│ │ base 65F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-PRCP-AVGNDS-GE001HI │ Average number of days during the year │
│ │ with precipitation >= 0.01 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-PRCP-AVGNDS-GE010HI │ Average number of days during the year │
│ │ with precipitation >= 0.10 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-PRCP-AVGNDS-GE050HI │ Average number of days during the year │
│ │ with precipitation >= 0.50 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-PRCP-AVGNDS-GE100HI │ Average number of days during the year │
│ │ with precipitation >= 1.00 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-PRCP-NORMAL │ Average annual precipitation totals │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-SNOW-AVGNDS-GE001TI │ Average number of days during the year │
│ │ with snowfall >= 0.1 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-SNOW-AVGNDS-GE010TI │ Average number of days during the year │
│ │ with snowfall >= 1.0 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-SNOW-AVGNDS-GE030TI │ Average number of days during the year │
│ │ with snowfall >= 3.0 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-SNOW-AVGNDS-GE050TI │ Average number of days during the year │
│ │ with snowfall >= 5.0 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-SNOW-AVGNDS-GE100TI │ Average number of days during the year │
│ │ with snowfall >= 10.0 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-SNOW-NORMAL │ Average annual snowfall totals │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-SNWD-AVGNDS-GE001WI │ Average number of days during the year │
│ │ with snow depth >= 1 inch │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-SNWD-AVGNDS-GE003WI │ Average number of days during the year │
│ │ with snow depth >= 3 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-SNWD-AVGNDS-GE005WI │ Average number of days during the year │
│ │ with snow depth >=5 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-SNWD-AVGNDS-GE010WI │ Average number of days during the year │
│ │ with snow depth >=10 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TAVG-NORMAL │ Average annual average temperature │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMAX-AVGNDS-GRTH040 │ Average number of days per year where │
│ │ tmax is greater than or equal to 40F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMAX-AVGNDS-GRTH050 │ Average number of days per year where │
│ │ tmax is greater than or equal to 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMAX-AVGNDS-GRTH060 │ Average number of days per year where │
│ │ tmax is greater than or equal to 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMAX-AVGNDS-GRTH070 │ Average number of days per year where │
│ │ tmax is greater than or equal to 70F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMAX-AVGNDS-GRTH080 │ Average number of days per year where │
│ │ tmax is greater than or equal to 80F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMAX-AVGNDS-GRTH090 │ Average number of days per year where │
│ │ tmax is greater than or equal to 90F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMAX-AVGNDS-GRTH100 │ Average number of days per year where │
│ │ tmax is greater than or equal to 100F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMAX-AVGNDS-LSTH032 │ Average number of days per year where │
│ │ tmax is less than or equal to 32F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMAX-NORMAL │ Average annual maximum temperature │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-AVGNDS-LSTH000 │ Average number of days per year where │
│ │ tmin is less than or equal to 0F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-AVGNDS-LSTH010 │ Average number of days per year where │
│ │ tmin is less than or equal to 10F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-AVGNDS-LSTH020 │ Average number of days per year where │
│ │ tmin is less than or equal to 20F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-AVGNDS-LSTH032 │ Average number of days per year where │
│ │ tmin is less than or equal to 32F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-AVGNDS-LSTH040 │ Average number of days per year where │
│ │ tmin is less than or equal to 40F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-AVGNDS-LSTH050 │ Average number of days per year where │
│ │ tmin is less than or equal to 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-AVGNDS-LSTH060 │ Average number of days per year where │
│ │ tmin is less than or equal to 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-AVGNDS-LSTH070 │ Average number of days per year where │
│ │ tmin is less than or equal to 70F │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-NORMAL │ Average annual minimum temperature │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T16FP10 │ 10 percent probability date of first 16F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T16FP20 │ 20 percent probability date of first 16F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T16FP30 │ 30 percent probability date of first 16F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T16FP40 │ 40 percent probability date of first 16F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T16FP50 │ 50 percent probability date of first 16F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T16FP60 │ 60 percent probability date of first 16F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T16FP70 │ 70 percent probability date of first 16F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T16FP80 │ 80 percent probability date of first 16F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T16FP90 │ 90 percent probability date of first 16F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T20FP10 │ 10 percent probability date of first 20F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T20FP20 │ 20 percent probability date of first 20F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T20FP30 │ 30 percent probability date of first 20F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T20FP40 │ 40 percent probability date of first 20F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T20FP50 │ 50 percent probability date of first 20F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T20FP60 │ 60 percent probability date of first 20F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T20FP70 │ 70 percent probability date of first 20F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T20FP80 │ 80 percent probability date of first 20F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T20FP90 │ 90 percent probability date of first 20F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T24FP10 │ 10 percent probability date of first 24F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T24FP20 │ 20 percent probability date of first 24F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T24FP30 │ 30 percent probability date of first 24F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T24FP40 │ 40 percent probability date of first 24F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T24FP50 │ 50 percent probability date of first 24F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T24FP60 │ 60 percent probability date of first 24F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T24FP70 │ 70 percent probability date of first 24F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T24FP80 │ 80 percent probability date of first 24F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T24FP90 │ 90 percent probability date of first 24F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T28FP10 │ 10 percent probability date of first 28F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T28FP20 │ 20 percent probability date of first 28F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T28FP30 │ 30 percent probability date of first 28F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T28FP40 │ 40 percent probability date of first 28F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T28FP50 │ 50 percent probability date of first 28F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T28FP60 │ 60 percent probability date of first 28F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T28FP70 │ 70 percent probability date of first 28F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T28FP80 │ 80 percent probability date of first 28F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T28FP90 │ 90 percent probability date of first 28F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T32FP10 │ 10 percent probability date of first 32F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T32FP20 │ 20 percent probability date of first 32F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T32FP30 │ 30 percent probability date of first 32F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T32FP40 │ 40 percent probability date of first 32F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T32FP50 │ 50 percent probability date of first 32F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T32FP60 │ 60 percent probability date of first 32F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T32FP70 │ 70 percent probability date of first 32F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T32FP80 │ 80 percent probability date of first 32F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T32FP90 │ 90 percent probability date of first 32F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T36FP10 │ 10 percent probability date of first 36F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T36FP20 │ 20 percent probability date of first 36F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T36FP30 │ 30 percent probability date of first 36F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T36FP40 │ 40 percent probability date of first 36F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T36FP50 │ 50 percent probability date of first 36F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T36FP60 │ 60 percent probability date of first 36F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T36FP70 │ 70 percent probability date of first 36F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T36FP80 │ 80 percent probability date of first 36F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBFST-T36FP90 │ 90 percent probability date of first 36F │
│ │ occurrence or earlier │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T16FP10 │ 10 percent probability of 16F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T16FP20 │ 20 percent probability of 16F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T16FP30 │ 30 percent probability of 16F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T16FP40 │ 40 percent probability of 16F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T16FP50 │ 50 percent probability of 16F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T16FP60 │ 60 percent probability of 16F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T16FP70 │ 70 percent probability of 16F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T16FP80 │ 80 percent probability of 16F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T16FP90 │ 90 percent probability of 16F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T20FP10 │ 10 percent probability of 20F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T20FP20 │ 20 percent probability of 20F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T20FP30 │ 30 percent probability of 20F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T20FP40 │ 40 percent probability of 20F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T20FP50 │ 50 percent probability of 20F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T20FP60 │ 60 percent probability of 20F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T20FP70 │ 70 percent probability of 20F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T20FP80 │ 80 percent probability of 20F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T20FP90 │ 90 percent probability of 20F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T24FP10 │ 10 percent probability of 24F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T24FP20 │ 20 percent probability of 24F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T24FP30 │ 30 percent probability of 24F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T24FP40 │ 40 percent probability of 24F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T24FP50 │ 50 percent probability of 24F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T24FP60 │ 60 percent probability of 24F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T24FP70 │ 70 percent probability of 24F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T24FP80 │ 80 percent probability of 24F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T24FP90 │ 90 percent probability of 24F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T28FP10 │ 10 percent probability of 28F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T28FP20 │ 20 percent probability of 28F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T28FP30 │ 30 percent probability of 28F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T28FP40 │ 40 percent probability of 28F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T28FP50 │ 50 percent probability of 28F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T28FP60 │ 60 percent probability of 28F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T28FP70 │ 70 percent probability of 28F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T28FP80 │ 80 percent probability of 28F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T28FP90 │ 90 percent probability of 28F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T32FP10 │ 10 percent probability of 32F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T32FP20 │ 20 percent probability of 32F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T32FP30 │ 30 percent probability of 32F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T32FP40 │ 40 percent probability of 32F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T32FP50 │ 50 percent probability of 32F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T32FP60 │ 60 percent probability of 32F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T32FP70 │ 70 percent probability of 32F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T32FP80 │ 80 percent probability of 32F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T32FP90 │ 90 percent probability of 32F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T36FP10 │ 10 percent probability of 36F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T36FP20 │ 20 percent probability of 36F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T36FP30 │ 30 percent probability of 36F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T36FP40 │ 40 percent probability of 36F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T36FP50 │ 50 percent probability of 36F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T36FP60 │ 60 percent probability of 36F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T36FP70 │ 70 percent probability of 36F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T36FP80 │ 80 percent probability of 36F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBGSL-T36FP90 │ 90 percent probability of 36F growing │
│ │ season length or longer │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T16FP10 │ 10 percent probability date of last 16F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T16FP20 │ 20 percent probability date of last 16F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T16FP30 │ 30 percent probability date of last 16F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T16FP40 │ 40 percent probability date of last 16F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T16FP50 │ 50 percent probability date of last 16F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T16FP60 │ 60 percent probability date of last 16F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T16FP70 │ 70 percent probability date of last 16F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T16FP80 │ 80 percent probability date of last 16F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T16FP90 │ 90 percent probability date of last 16F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T20FP10 │ 10 percent probability date of last 20F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T20FP20 │ 20 percent probability date of last 20F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T20FP30 │ 30 percent probability date of last 20F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T20FP40 │ 40 percent probability date of last 20F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T20FP50 │ 50 percent probability date of last 20F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T20FP60 │ 60 percent probability date of last 20F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T20FP70 │ 70 percent probability date of last 20F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T20FP80 │ 80 percent probability date of last 20F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T20FP90 │ 90 percent probability date of last 20F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T24FP10 │ 10 percent probability date of last 24F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T24FP20 │ 20 percent probability date of last 24F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T24FP30 │ 30 percent probability date of last 24F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T24FP40 │ 40 percent probability date of last 24F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T24FP50 │ 50 percent probability date of last 24F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T24FP60 │ 60 percent probability date of last 24F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T24FP70 │ 70 percent probability date of last 24F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T24FP80 │ 80 percent probability date of last 24F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T24FP90 │ 90 percent probability date of last 24F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T28FP10 │ 10 percent probability date of last 28F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T28FP20 │ 20 percent probability date of last 28F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T28FP30 │ 30 percent probability date of last 28F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T28FP40 │ 40 percent probability date of last 28F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T28FP50 │ 50 percent probability date of last 28F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T28FP60 │ 60 percent probability date of last 28F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T28FP70 │ 70 percent probability date of last 28F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T28FP80 │ 80 percent probability date of last 28F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T28FP90 │ 90 percent probability date of last 28F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T32FP10 │ 10 percent probability date of last 32F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T32FP20 │ 20 percent probability date of last 32F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T32FP30 │ 30 percent probability date of last 32F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T32FP40 │ 40 percent probability date of last 32F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T32FP50 │ 50 percent probability date of last 32F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T32FP60 │ 60 percent probability date of last 32F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T32FP70 │ 70 percent probability date of last 32F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T32FP80 │ 80 percent probability date of last 32F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T32FP90 │ 90 percent probability date of last 32F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T36FP10 │ 10 percent probability date of last 36F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T36FP20 │ 20 percent probability date of last 36F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T36FP30 │ 30 percent probability date of last 36F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T36FP40 │ 40 percent probability date of last 36F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T36FP50 │ 50 percent probability date of last 36F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T36FP60 │ 60 percent probability date of last 36F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T36FP70 │ 70 percent probability date of last 36F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T36FP80 │ 80 percent probability date of last 36F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBLST-T36FP90 │ 90 percent probability date of last 36F │
│ │ occurrence or later │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBOCC-LSTH016 │ probability of 16F or below at least once │
│ │ in the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBOCC-LSTH020 │ probability of 20F or below at least once │
│ │ in the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBOCC-LSTH024 │ probability of 24F or below at least once │
│ │ in the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBOCC-LSTH028 │ probability of 28F or below at least once │
│ │ in the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBOCC-LSTH032 │ probability of 32F or below at least once │
│ │ in the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ ANN-TMIN-PRBOCC-LSTH036 │ probability of 36F or below at least once │
│ │ in the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-CLDD-BASE45 │ Average winter cooling degree days with │
│ │ base 45F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-CLDD-BASE50 │ Average winter cooling degree days with │
│ │ base 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-CLDD-BASE55 │ Average winter cooling degree days with │
│ │ base 55F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-CLDD-BASE57 │ Average winter cooling degree days with │
│ │ base 57F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-CLDD-BASE60 │ Average winter cooling degree days with │
│ │ base 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-CLDD-BASE70 │ Average winter cooling degree days with │
│ │ base 70F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-CLDD-BASE72 │ Average winter cooling degree days with │
│ │ base 72F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-CLDD-NORMAL │ Average winter cooling degree days with │
│ │ base 65F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-DUTR-NORMAL │ Average winter diurnal temperature range │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-GRDD-BASE40 │ Average winter growing degree days with │
│ │ base 40F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-GRDD-BASE45 │ Average winter growing degree days with │
│ │ base 45F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-GRDD-BASE50 │ Average winter growing degree days with │
│ │ base 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-GRDD-BASE55 │ Average winter growing degree days with │
│ │ base 55F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-GRDD-BASE57 │ Average winter growing degree days with │
│ │ base 57F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-GRDD-BASE60 │ Average winter growing degree days with │
│ │ base 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-GRDD-BASE65 │ Average winter growing degree days with │
│ │ base 65F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-GRDD-BASE70 │ Average winter growing degree days with │
│ │ base 70F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-GRDD-BASE72 │ Average winter growing degree days with │
│ │ base 72F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-GRDD-TB4886 │ Average winter growing degree days with │
│ │ truncated bases 48F and 86F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-GRDD-TB5086 │ Average winter growing degree days with │
│ │ truncated bases 50F and 86F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-HTDD-BASE40 │ Average winter heating degree days with │
│ │ base 40F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-HTDD-BASE45 │ Average winter heating degree days with │
│ │ base 45F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-HTDD-BASE50 │ Average winter heating degree days with │
│ │ base 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-HTDD-BASE55 │ Average winter heating degree days with │
│ │ base 55F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-HTDD-BASE57 │ Average winter heating degree days with │
│ │ base 57F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-HTDD-BASE60 │ Average winter heating degree days with │
│ │ base 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-HTDD-NORMAL │ Average winter heating degree days with │
│ │ base 65F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-PRCP-AVGNDS-GE001HI │ Average number of days during December- │
│ │ February with precipitation >= 0.01 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-PRCP-AVGNDS-GE010HI │ Average number of days during December- │
│ │ February with precipitation >= 0.10 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-PRCP-AVGNDS-GE050HI │ Average number of days during December- │
│ │ February with precipitation >= 0.50 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-PRCP-AVGNDS-GE100HI │ Average number of days during December- │
│ │ February with precipitation >= 1.00 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-PRCP-NORMAL │ Average seasonal precipitation totals for │
│ │ December- February │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-SNOW-AVGNDS-GE001TI │ Average number of days during December- │
│ │ February with snowfall >= 0.1 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-SNOW-AVGNDS-GE010TI │ Average number of days during December- │
│ │ February with snowfall >= 1.0 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-SNOW-AVGNDS-GE030TI │ Average number of days during December- │
│ │ February with snowfall >= 3.0 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-SNOW-AVGNDS-GE050TI │ Average number of days during December- │
│ │ February with snowfall >= 5.0 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-SNOW-AVGNDS-GE100TI │ Average number of days during December- │
│ │ February with snowfall >= 10.0 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-SNOW-NORMAL │ Average seasonal snowfall totals for │
│ │ December- February │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-SNWD-AVGNDS-GE001WI │ Average number of days during December- │
│ │ February with snow depth >= 1 inch │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-SNWD-AVGNDS-GE003WI │ Average number of days during December- │
│ │ February with snow depth >= 3 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-SNWD-AVGNDS-GE005WI │ Average number of days during December- │
│ │ February with snow depth >= 5 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-SNWD-AVGNDS-GE010WI │ Average number of days during December- │
│ │ February with snow depth >= 10 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-TAVG-NORMAL │ Average winter average temperature │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-TMAX-AVGNDS-GRTH040 │ Average number of days per winter where │
│ │ tmax is greater than or equal to 40F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-TMAX-AVGNDS-GRTH050 │ Average number of days per winter where │
│ │ tmax is greater than or equal to 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-TMAX-AVGNDS-GRTH060 │ Average number of days per winter where │
│ │ tmax is greater than or equal to 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-TMAX-AVGNDS-GRTH070 │ Average number of days per winter where │
│ │ tmax is greater than or equal to 70F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-TMAX-AVGNDS-GRTH080 │ Average number of days per winter where │
│ │ tmax is greater than or equal to 80F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-TMAX-AVGNDS-GRTH090 │ Average number of days per winter where │
│ │ tmax is greater than or equal to 90F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-TMAX-AVGNDS-GRTH100 │ Average number of days per winter where │
│ │ tmax is greater than or equal to 100F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-TMAX-AVGNDS-LSTH032 │ Average number of days per winter where │
│ │ tmax is less than or equal to 32F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-TMAX-NORMAL │ Average winter maximum temperature │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-TMIN-AVGNDS-LSTH000 │ Average number of days per winter where │
│ │ tmin is less than or equal to 0F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-TMIN-AVGNDS-LSTH010 │ Average number of days per winter where │
│ │ tmin is less than or equal to 10F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-TMIN-AVGNDS-LSTH020 │ Average number of days per winter where │
│ │ tmin is less than or equal to 20F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-TMIN-AVGNDS-LSTH032 │ Average number of days per winter where │
│ │ tmin is less than or equal to 32F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-TMIN-AVGNDS-LSTH040 │ Average number of days per winter where │
│ │ tmin is less than or equal to 40F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-TMIN-AVGNDS-LSTH050 │ Average number of days per winter where │
│ │ tmin is less than or equal to 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-TMIN-AVGNDS-LSTH060 │ Average number of days per winter where │
│ │ tmin is less than or equal to 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-TMIN-AVGNDS-LSTH070 │ Average number of days per winter where │
│ │ tmin is less than or equal to 70F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DJF-TMIN-NORMAL │ Average winter minimum temperature │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-CLDD-BASE45 │ Average summer cooling degree days with │
│ │ base 45F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-CLDD-BASE50 │ Average summer cooling degree days with │
│ │ base 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-CLDD-BASE55 │ Average summer cooling degree days with │
│ │ base 55F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-CLDD-BASE57 │ Average summer cooling degree days with │
│ │ base 57F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-CLDD-BASE60 │ Average summer cooling degree days with │
│ │ base 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-CLDD-BASE70 │ Average summer cooling degree days with │
│ │ base 70F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-CLDD-BASE72 │ Average summer cooling degree days with │
│ │ base 72F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-CLDD-NORMAL │ Average summer cooling degree days with │
│ │ base 65F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-DUTR-NORMAL │ Average summer diurnal temperature range │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-GRDD-BASE40 │ Average summer growing degree days with │
│ │ base 40F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-GRDD-BASE45 │ Average summer growing degree days with │
│ │ base 45F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-GRDD-BASE50 │ Average summer growing degree days with │
│ │ base 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-GRDD-BASE55 │ Average summer growing degree days with │
│ │ base 55F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-GRDD-BASE57 │ Average summer growing degree days with │
│ │ base 57F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-GRDD-BASE60 │ Average summer growing degree days with │
│ │ base 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-GRDD-BASE65 │ Average summer growing degree days with │
│ │ base 65F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-GRDD-BASE70 │ Average summer growing degree days with │
│ │ base 70F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-GRDD-BASE72 │ Average summer growing degree days with │
│ │ base 72F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-GRDD-TB4886 │ Average summer growing degree days with │
│ │ truncated bases 48F and 86F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-GRDD-TB5086 │ Average summer growing degree days with │
│ │ truncated bases 50F and 86F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-HTDD-BASE40 │ Average summer heating degree days with │
│ │ base 40F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-HTDD-BASE45 │ Average summer heating degree days with │
│ │ base 45F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-HTDD-BASE50 │ Average summer heating degree days with │
│ │ base 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-HTDD-BASE55 │ Average summer heating degree days with │
│ │ base 55F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-HTDD-BASE57 │ Average summer heating degree days with │
│ │ base 57F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-HTDD-BASE60 │ Average summer heating degree days with │
│ │ base 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-HTDD-NORMAL │ Average summer heating degree days with │
│ │ base 65F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-PRCP-AVGNDS-GE001HI │ Average number of days during June-August │
│ │ with precipitation >= 0.01 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-PRCP-AVGNDS-GE010HI │ Average number of days during June-August │
│ │ with precipitation >= 0.10 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-PRCP-AVGNDS-GE050HI │ Average number of days during June-August │
│ │ with precipitation >= 0.50 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-PRCP-AVGNDS-GE100HI │ Average number of days during June-August │
│ │ with precipitation >= 1.00 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-PRCP-NORMAL │ Average seasonal precipitation totals for │
│ │ June- August │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-SNOW-AVGNDS-GE001TI │ Average number of days during June-August │
│ │ with snowfall >= 0.1 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-SNOW-AVGNDS-GE010TI │ Average number of days during June-August │
│ │ with snowfall >= 1.0 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-SNOW-AVGNDS-GE030TI │ Average number of days during June-August │
│ │ with snowfall >= 3.0 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-SNOW-AVGNDS-GE050TI │ Average number of days during June-August │
│ │ with snowfall >= 5.0 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-SNOW-AVGNDS-GE100TI │ Average number of days during June-August │
│ │ with snowfall >= 10.0 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-SNOW-NORMAL │ Average seasonal snowfall totals for │
│ │ June- August │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-SNWD-AVGNDS-GE001WI │ Average number of days during June-August │
│ │ with snow depth >= 1 inch │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-SNWD-AVGNDS-GE003WI │ Average number of days during June-August │
│ │ with snow depth >= 3 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-SNWD-AVGNDS-GE005WI │ Average number of days during June-August │
│ │ with snow depth >= 5 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-SNWD-AVGNDS-GE010WI │ Average number of days during June-August │
│ │ with snow depth >= 10 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-TAVG-NORMAL │ Average summer average temperature │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-TMAX-AVGNDS-GRTH040 │ Average number of days per summer where │
│ │ tmax is greater than or equal to 40F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-TMAX-AVGNDS-GRTH050 │ Average number of days per summer where │
│ │ tmax is greater than or equal to 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-TMAX-AVGNDS-GRTH060 │ Average number of days per summer where │
│ │ tmax is greater than or equal to 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-TMAX-AVGNDS-GRTH070 │ Average number of days per summer where │
│ │ tmax is greater than or equal to 70F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-TMAX-AVGNDS-GRTH080 │ Average number of days per summer where │
│ │ tmax is greater than or equal to 80F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-TMAX-AVGNDS-GRTH090 │ Average number of days per summer where │
│ │ tmax is greater than or equal to 90F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-TMAX-AVGNDS-GRTH100 │ Average number of days per summer where │
│ │ tmax is greater than or equal to 100F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-TMAX-AVGNDS-LSTH032 │ Average number of days per summer where │
│ │ tmax is less than or equal to 32F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-TMAX-NORMAL │ Average summer maximum temperature │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-TMIN-AVGNDS-LSTH000 │ Average number of days per summer where │
│ │ tmin is less than or equal to 0F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-TMIN-AVGNDS-LSTH010 │ Average number of days per summer where │
│ │ tmin is less than or equal to 10F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-TMIN-AVGNDS-LSTH020 │ Average number of days per summer where │
│ │ tmin is less than or equal to 20F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-TMIN-AVGNDS-LSTH032 │ Average number of days per summer where │
│ │ tmin is less than or equal to 32F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-TMIN-AVGNDS-LSTH040 │ Average number of days per summer where │
│ │ tmin is less than or equal to 40F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-TMIN-AVGNDS-LSTH050 │ Average number of days per summer where │
│ │ tmin is less than or equal to 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-TMIN-AVGNDS-LSTH060 │ Average number of days per summer where │
│ │ tmin is less than or equal to 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-TMIN-AVGNDS-LSTH070 │ Average number of days per summer where │
│ │ tmin is less than or equal to 70F │
├─────────────────────────┼───────────────────────────────────────────┤
│ JJA-TMIN-NORMAL │ Average summer minimum temperature │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-CLDD-BASE45 │ Average spring cooling degree days with │
│ │ base 45F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-CLDD-BASE50 │ Average spring cooling degree days with │
│ │ base 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-CLDD-BASE55 │ Average spring cooling degree days with │
│ │ base 55F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-CLDD-BASE57 │ Average spring cooling degree days with │
│ │ base 57F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-CLDD-BASE60 │ Average spring cooling degree days with │
│ │ base 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-CLDD-BASE70 │ Average spring cooling degree days with │
│ │ base 70F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-CLDD-BASE72 │ Average spring cooling degree days with │
│ │ base 72F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-CLDD-NORMAL │ Average spring cooling degree days with │
│ │ base 65F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-DUTR-NORMAL │ Average spring diurnal temperature range │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-GRDD-BASE40 │ Average spring growing degree days with │
│ │ base 40F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-GRDD-BASE45 │ Average spring growing degree days with │
│ │ base 45F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-GRDD-BASE50 │ Average spring growing degree days with │
│ │ base 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-GRDD-BASE55 │ Average spring growing degree days with │
│ │ base 55F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-GRDD-BASE57 │ Average spring growing degree days with │
│ │ base 57F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-GRDD-BASE60 │ Average spring growing degree days with │
│ │ base 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-GRDD-BASE65 │ Average spring growing degree days with │
│ │ base 65F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-GRDD-BASE70 │ Average spring growing degree days with │
│ │ base 70F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-GRDD-BASE72 │ Average spring growing degree days with │
│ │ base 72F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-GRDD-TB4886 │ Average summer growing degree days with │
│ │ truncated bases 48F and 86F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-GRDD-TB5086 │ Average summer growing degree days with │
│ │ truncated bases 50F and 86F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-HTDD-BASE40 │ Average spring heating degree days with │
│ │ base 40F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-HTDD-BASE45 │ Average spring heating degree days with │
│ │ base 45F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-HTDD-BASE50 │ Average spring heating degree days with │
│ │ base 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-HTDD-BASE55 │ Average spring heating degree days with │
│ │ base 55F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-HTDD-BASE57 │ Average spring heating degree days with │
│ │ base 57F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-HTDD-BASE60 │ Average spring heating degree days with │
│ │ base 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-HTDD-NORMAL │ Average spring heating degree days with │
│ │ base 65F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-PRCP-AVGNDS-GE001HI │ Average number of days during March-May │
│ │ with precipitation >= 0.01 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-PRCP-AVGNDS-GE010HI │ Average number of days during March-May │
│ │ with precipitation >= a 0.10 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-PRCP-AVGNDS-GE050HI │ Average number of days during March-May │
│ │ with precipitation >= 0.50 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-PRCP-AVGNDS-GE100HI │ Average number of days during March-May │
│ │ with precipitation >= 1.00 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-PRCP-NORMAL │ Average seasonal precipitation totals for │
│ │ March- May │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-SNOW-AVGNDS-GE001TI │ Average number of days during March-May │
│ │ with snowfall >= 0.1 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-SNOW-AVGNDS-GE010TI │ Average number of days during March-May │
│ │ with snowfall >= 1.0 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-SNOW-AVGNDS-GE030TI │ Average number of days during March-May │
│ │ with snowfall >= 3.0 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-SNOW-AVGNDS-GE050TI │ Average number of days during March-May │
│ │ with snowfall >= 5.0 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-SNOW-AVGNDS-GE100TI │ Average number of days during March-May │
│ │ with snowfall >= 10.0 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-SNOW-NORMAL │ Average seasonal snowfall totals for │
│ │ March- May │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-SNWD-AVGNDS-GE001WI │ Average number of days during March-May │
│ │ with snow depth >= 1 inch │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-SNWD-AVGNDS-GE003WI │ Average number of days during March-May │
│ │ with snow depth >= 3 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-SNWD-AVGNDS-GE005WI │ Average number of days during March-May │
│ │ with snow depth >= 5 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-SNWD-AVGNDS-GE010WI │ Average number of days during March-May │
│ │ with snow depth >= 10 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-TAVG-NORMAL │ Average spring average temperature │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-TMAX-AVGNDS-GRTH040 │ Average number of days per spring where │
│ │ tmax is greater than or equal to 40F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-TMAX-AVGNDS-GRTH050 │ Average number of days per spring where │
│ │ tmax is greater than or equal to 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-TMAX-AVGNDS-GRTH060 │ Average number of days per spring where │
│ │ tmax is greater than or equal to 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-TMAX-AVGNDS-GRTH070 │ Average number of days per spring where │
│ │ tmax is greater than or equal to 70F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-TMAX-AVGNDS-GRTH080 │ Average number of days per spring where │
│ │ tmax is greater than or equal to 80F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-TMAX-AVGNDS-GRTH090 │ Average number of days per spring where │
│ │ tmax is greater than or equal to 90F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-TMAX-AVGNDS-GRTH100 │ Average number of days per spring where │
│ │ tmax is greater than or equal to 100F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-TMAX-AVGNDS-LSTH032 │ Average number of days per spring where │
│ │ tmax is less than or equal to 32F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-TMAX-NORMAL │ Average spring maximum temperature │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-TMIN-AVGNDS-LSTH000 │ Average number of days per spring where │
│ │ tmin is less than or equal to 0F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-TMIN-AVGNDS-LSTH010 │ Average number of days per spring where │
│ │ tmin is less than or equal to 10F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-TMIN-AVGNDS-LSTH020 │ Average number of days per spring where │
│ │ tmin is less than or equal to 20F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-TMIN-AVGNDS-LSTH032 │ Average number of days per spring where │
│ │ tmin is less than or equal to 32F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-TMIN-AVGNDS-LSTH040 │ Average number of days per spring where │
│ │ tmin is less than or equal to 40F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-TMIN-AVGNDS-LSTH050 │ Average number of days per spring where │
│ │ tmin is less than or equal to 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-TMIN-AVGNDS-LSTH060 │ Average number of days per spring where │
│ │ tmin is less than or equal to 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-TMIN-AVGNDS-LSTH070 │ Average number of days per spring where │
│ │ tmin is less than or equal to 70F │
├─────────────────────────┼───────────────────────────────────────────┤
│ MAM-TMIN-NORMAL │ Average spring minimum temperature │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-CLDD-BASE45 │ Average autumn cooling degree days with │
│ │ base 45F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-CLDD-BASE50 │ Average autumn cooling degree days with │
│ │ base 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-CLDD-BASE55 │ Average autumn cooling degree days with │
│ │ base 55F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-CLDD-BASE57 │ Average autumn cooling degree days with │
│ │ base 57F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-CLDD-BASE60 │ Average autumn cooling degree days with │
│ │ base 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-CLDD-BASE70 │ Average autumn cooling degree days with │
│ │ base 70F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-CLDD-BASE72 │ Average autumn cooling degree days with │
│ │ base 72F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-CLDD-NORMAL │ Average autumn cooling degree days with │
│ │ base 65F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-DUTR-NORMAL │ Average autumn diurnal temperature range │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-GRDD-BASE40 │ Average fall growing degree days with │
│ │ base 40F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-GRDD-BASE45 │ Average fall growing degree days with │
│ │ base 45F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-GRDD-BASE50 │ Average fall growing degree days with │
│ │ base 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-GRDD-BASE55 │ Average fall growing degree days with │
│ │ base 55F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-GRDD-BASE57 │ Average fall growing degree days with │
│ │ base 57F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-GRDD-BASE60 │ Average fall growing degree days with │
│ │ base 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-GRDD-BASE65 │ Average fall growing degree days with │
│ │ base 65F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-GRDD-BASE70 │ Average fall growing degree days with │
│ │ base 70F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-GRDD-BASE72 │ Average fall growing degree days with │
│ │ base 72F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-GRDD-TB4886 │ Average summer growing degree days with │
│ │ truncated bases 48F and 86F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-GRDD-TB5086 │ Average summer growing degree days with │
│ │ truncated bases 50F and 86F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-HTDD-BASE40 │ Average autumn heating degree days with │
│ │ base 40F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-HTDD-BASE45 │ Average autumn heating degree days with │
│ │ base 45F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-HTDD-BASE50 │ Average autumn heating degree days with │
│ │ base 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-HTDD-BASE55 │ Average autumn heating degree days with │
│ │ base 55F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-HTDD-BASE57 │ Average autumn heating degree days with │
│ │ base 57F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-HTDD-BASE60 │ Average autumn heating degree days with │
│ │ base 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-HTDD-NORMAL │ Average autumn heating degree days with │
│ │ base 65F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-PRCP-AVGNDS-GE001HI │ Average number of days during September- │
│ │ November with precipitation >= 0.01 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-PRCP-AVGNDS-GE010HI │ Average number of days during September- │
│ │ November with precipitation >= 0.10 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-PRCP-AVGNDS-GE050HI │ Average number of days during September- │
│ │ November with precipitation >= 0.50 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-PRCP-AVGNDS-GE100HI │ Average number of days during September- │
│ │ November with precipitation >= 1.00 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-PRCP-NORMAL │ Average seasonal precipitation totals for │
│ │ September- November │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-SNOW-AVGNDS-GE001TI │ Average number of days during September- │
│ │ November with snowfall >= 0.1 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-SNOW-AVGNDS-GE010TI │ Average number of days during September- │
│ │ November with snowfall >= 1.0 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-SNOW-AVGNDS-GE030TI │ Average number of days during September- │
│ │ November with snowfall >= 3.0 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-SNOW-AVGNDS-GE050TI │ Average number of days during September- │
│ │ November with snowfall >= 5.0 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-SNOW-AVGNDS-GE100TI │ Average number of days during September- │
│ │ November with snowfall >= 10.0 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-SNOW-NORMAL │ Average seasonal snowfall totals for │
│ │ September- November │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-SNWD-AVGNDS-GE001WI │ Average number of days during September- │
│ │ November with snow depth >= 1 inch │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-SNWD-AVGNDS-GE003WI │ Average number of days during September- │
│ │ November with snow depth >= 3 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-SNWD-AVGNDS-GE005WI │ Average number of days during September- │
│ │ November with snow depth >= 5 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-SNWD-AVGNDS-GE010WI │ Average number of days during September- │
│ │ November with snow depth >= 10 in │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-TAVG-NORMAL │ Average autumn average temperature │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-TMAX-AVGNDS-GRTH040 │ Average number of days per autumn where │
│ │ tmax is greater than or equal to 40F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-TMAX-AVGNDS-GRTH050 │ Average number of days per autumn where │
│ │ tmax is greater than or equal to 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-TMAX-AVGNDS-GRTH060 │ Average number of days per autumn where │
│ │ tmax is greater than or equal to 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-TMAX-AVGNDS-GRTH070 │ Average number of days per autumn where │
│ │ tmax is greater than or equal to 70F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-TMAX-AVGNDS-GRTH080 │ Average number of days per autumn where │
│ │ tmax is greater than or equal to 80F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-TMAX-AVGNDS-GRTH090 │ Average number of days per autumn where │
│ │ tmax is greater than or equal to 90F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-TMAX-AVGNDS-GRTH100 │ Average number of days per autumn where │
│ │ tmax is greater than or equal to 100F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-TMAX-AVGNDS-LSTH032 │ Average number of days per autumn where │
│ │ tmax is less than or equal to 32F │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-TMAX-NORMAL │ Average autumn maximum temperature │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-TMIN-AVGNDS-LSTHxxx │ Average number of days per autumn where │
│ │ tmin is less than or equal to 'xxx' │
│ │ degree F. Where 'xxx' is one of 000, 010, │
│ │ 020, 032, 040, 050, 060, 070 │
├─────────────────────────┼───────────────────────────────────────────┤
│ SON-TMIN-NORMAL │ Average autumn minimum temperature │
╘═════════════════════════╧═══════════════════════════════════════════╛
positional arguments:
stationid The station id. from the first column of
<[4;36mhttps://www.ncei.noaa.gov/pub/data/ghcn/daily/ghcnd-stations.txt[0m>
options:
-h | --help
show this help message and exit
ncei_normal_dly¶
$ tsgettoolbox ncei_normal_dly --help
usage: tsgettoolbox ncei_normal_dly [-h] stationid
Requires registration and free API key.
For every datatype and record there is a set of meta-data flags. For the GHCNDMS
dataset, the flags are:
'Total Missing','Consecutive Missing'
Total Missing:
Defined as total number of days observation/element is missing in that month.
This can be taken as a measure of quality or completeness as the higher the
number of days sampled in the month, the more representative the value is for
the entire month.
Consecutive Missing:
Defined as the maximum number of consecutive days in the month that an
observation/element is missing.
The following table lists the datatypes available for the annual dataset. Not
all datatypes are available for all stations.
┌─────────────────────────┬───────────────────────────────────────────┐
│ Code │ Description │
╞═════════════════════════╪═══════════════════════════════════════════╡
│ DLY-CLDD-BASE45 │ Average daily cooling degree days with │
│ │ base 45F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-CLDD-BASE50 │ Average daily cooling degree days with │
│ │ base 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-CLDD-BASE55 │ Average daily cooling degree days with │
│ │ base 55F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-CLDD-BASE57 │ Average daily cooling degree days with │
│ │ base 57F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-CLDD-BASE60 │ Average daily cooling degree days with │
│ │ base 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-CLDD-BASE70 │ Average daily cooling degree days with │
│ │ base 70F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-CLDD-BASE72 │ Average daily cooling degree days with │
│ │ base 72F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-CLDD-NORMAL │ Average daily cooling degree days with │
│ │ base 65F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-DUTR-NORMAL │ Average daily diurnal temperature range │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-DUTR-STDDEV │ Long-term standard deviations of daily │
│ │ diurnal temperature range │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-GRDD-BASE40 │ Average daily growing degree days with │
│ │ base 40F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-GRDD-BASE45 │ Average daily growing degree days with │
│ │ base 45F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-GRDD-BASE50 │ Average daily growing degree days with │
│ │ base 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-GRDD-BASE55 │ Average daily growing degree days with │
│ │ base 55F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-GRDD-BASE57 │ Average daily growing degree days with │
│ │ base 57F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-GRDD-BASE60 │ Average daily growing degree days with │
│ │ base 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-GRDD-BASE65 │ Average daily growing degree days with │
│ │ base 65F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-GRDD-BASE70 │ Average daily growing degree days with │
│ │ base 70F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-GRDD-BASE72 │ Average daily growing degree days with │
│ │ base 72F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-GRDD-TB4886 │ Average daily growing degree days with │
│ │ truncated bases 48F and 86F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-GRDD-TB5086 │ Average daily growing degree days with │
│ │ truncated bases 50F and 86F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-HTDD-BASE40 │ Average daily heating degree days with │
│ │ base 40F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-HTDD-BASE45 │ Average daily heating degree days with │
│ │ base 45F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-HTDD-BASE50 │ Average daily heating degree days with │
│ │ base 50F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-HTDD-BASE55 │ Average daily heating degree days with │
│ │ base 55F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-HTDD-BASE57 │ Average daily heating degree days with │
│ │ base 57F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-HTDD-BASE60 │ Average daily heating degree days with │
│ │ base 60F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-HTDD-NORMAL │ Average daily heating degree days with │
│ │ base 65F │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-PRCP-25PCTL │ 25th percentiles of daily nonzero │
│ │ precipitation totals for 29-day windows │
│ │ centered on each day of the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-PRCP-50PCTL │ 50th percentiles of daily nonzero │
│ │ precipitation totals for 29-day windows │
│ │ centered on each day of the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-PRCP-75PCTL │ 75th percentiles of daily nonzero │
│ │ precipitation totals for 29-day windows │
│ │ centered on each day of the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-PRCP-PCTALL-GE001HI │ Probability of precipitation >= 0.01 in │
│ │ for 29-day windows centered on each day │
│ │ of the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-PRCP-PCTALL-GE010HI │ Probability of precipitation >= 0.10 in │
│ │ for 29-day windows centered on each day │
│ │ of the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-PRCP-PCTALL-GE050HI │ Probability of precipitation >= 0.50 in │
│ │ for 29-day windows centered on each day │
│ │ of the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-PRCP-PCTALL-GE100HI │ Probability of precipitation >= 1.00 in │
│ │ for 29-day windows centered on each day │
│ │ of the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-SNOW-25PCTL │ 25th percentiles of daily nonzero │
│ │ snowfall totals for 29-day windows │
│ │ centered on each day of the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-SNOW-50PCTL │ 50th percentiles of daily nonzero │
│ │ snowfall totals for 29-day windows │
│ │ centered on each day of the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-SNOW-75PCTL │ 75th percentiles of daily nonzero │
│ │ snowfall totals for 29-day windows │
│ │ centered on each day of the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-SNOW-PCTALL-GE001TI │ Probability of snowfall >= 0.1 in for │
│ │ 29-day windows centered on each day of │
│ │ the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-SNOW-PCTALL-GE010TI │ Probability of snowfall >= 1.0 in for │
│ │ 29-day windows centered on each day of │
│ │ the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-SNOW-PCTALL-GE030TI │ Probability of snowfall >= 3.0 in for │
│ │ 29-day windows centered on each day of │
│ │ the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-SNOW-PCTALL-GE050TI │ Probability of snowfall >= 5.0 in for │
│ │ 29-day windows centered on each day of │
│ │ the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-SNOW-PCTALL-GE100TI │ Probability of snowfall >= 10 in for │
│ │ 29-day windows centered on each day of │
├─────────────────────────┼─the year──────────────────────────────────┤
│ DLY-SNWD-25PCTL │ 25th percentiles of daily nonzero snow │
│ │ depth for 29-day windows centered on each │
│ │ day of the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-SNWD-50PCTL │ 50th percentiles of daily nonzero snow │
│ │ depth for 29-day windows centered on each │
│ │ day of the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-SNWD-75PCTL │ 75th percentiles of daily nonzero snow │
│ │ depth for 29-day windows centered on each │
│ │ day of the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-SNWD-PCTALL-GE001WI │ Probability of snow depth >= 1 inch for │
│ │ 29-day windows centered on each day of │
│ │ the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-SNWD-PCTALL-GE003WI │ Probability of snow depth >= 3 in for │
│ │ 29-day windows centered on each day of │
│ │ the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-SNWD-PCTALL-GE005WI │ Probability of snow depth >= 5 in for │
│ │ 29-day windows centered on each day of │
│ │ the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-SNWD-PCTALL-GE010WI │ Probability of snow depth >= 10 in for │
│ │ 29-day windows centered on each day of │
│ │ the year │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-TAVG-NORMAL │ Average daily average temperature │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-TAVG-STDDEV │ Long-term standard deviations of daily │
│ │ average temperature │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-TMAX-NORMAL │ Average daily maximum temperature │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-TMAX-STDDEV │ Long-term standard deviations of daily │
│ │ maximum temperature │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-TMIN-NORMAL │ Average daily minimum temperature │
├─────────────────────────┼───────────────────────────────────────────┤
│ DLY-TMIN-STDDEV │ Long-term standard deviations of daily │
│ │ minimum temperature │
├─────────────────────────┼───────────────────────────────────────────┤
│ MTD-PRCP-NORMAL │ Average month-to-date precipitation │
├─────────────────────────┼─totals────────────────────────────────────┤
│ MTD-SNOW-NORMAL │ Average month-to-date snowfall totals │
├─────────────────────────┼───────────────────────────────────────────┤
│ YTD-PRCP-NORMAL │ Average year-to-date precipitation totals │
├─────────────────────────┼───────────────────────────────────────────┤
│ YTD-SNOW-NORMAL │ Average year-to-date snowfall totals │
╘═════════════════════════╧═══════════════════════════════════════════╛
positional arguments:
stationid The station id. from the first column of
<[4;36mhttps://www.ncei.noaa.gov/pub/data/ghcn/daily/ghcnd-stations.txt[0m>
options:
-h | --help
show this help message and exit
ncei_normal_hly¶
$ tsgettoolbox ncei_normal_hly --help
usage: tsgettoolbox ncei_normal_hly [-h] stationid
Requires registration and free API key.
For every datatype and record there is a set of meta-data flags. For the GHCNDMS
dataset, the flags are:
'Total Missing','Consecutive Missing'
Total Missing:
Defined as total number of days observation/element is missing in that month.
This can be taken as a measure of quality or completeness as the higher the
number of days sampled in the month, the more representative the value is for
the entire month.
Consecutive Missing:
Defined as the maximum number of consecutive days in the month that an
observation/element is missing.
The following table lists the datatypes available for the annual dataset. Not
all datatypes are available for all stations.
┌─────────────────┬────────────────────────────────────────┐
│ Code │ Description │
╞═════════════════╪════════════════════════════════════════╡
│ HLY-CLDH-NORMAL │ Cooling degree hours │
├─────────────────┼────────────────────────────────────────┤
│ HLY-CLOD-PCTBKN │ Clouds broken percentage │
├─────────────────┼────────────────────────────────────────┤
│ HLY-CLOD-PCTCLR │ Clouds clear percentage │
├─────────────────┼────────────────────────────────────────┤
│ HLY-CLOD-PCTFEW │ Clouds few percentage │
├─────────────────┼────────────────────────────────────────┤
│ HLY-CLOD-PCTOVC │ Clouds overcast percentage │
├─────────────────┼────────────────────────────────────────┤
│ HLY-CLOD-PCTSCT │ Clouds scattered percentage │
├─────────────────┼────────────────────────────────────────┤
│ HLY-DEWP-10PCTL │ Dew point 10th percentile │
├─────────────────┼────────────────────────────────────────┤
│ HLY-DEWP-90PCTL │ Dew point 90th percentile │
├─────────────────┼────────────────────────────────────────┤
│ HLY-DEWP-NORMAL │ Dew point mean │
├─────────────────┼────────────────────────────────────────┤
│ HLY-HIDX-NORMAL │ Heat index mean │
├─────────────────┼────────────────────────────────────────┤
│ HLY-HTDH-NORMAL │ Heating degree hours │
├─────────────────┼────────────────────────────────────────┤
│ HLY-PRES-10PCTL │ Sea level pressure 10th percentile │
├─────────────────┼────────────────────────────────────────┤
│ HLY-PRES-90PCTL │ Sea level pressure 90th percentile │
├─────────────────┼────────────────────────────────────────┤
│ HLY-PRES-NORMAL │ Sea level pressure mean │
├─────────────────┼────────────────────────────────────────┤
│ HLY-TEMP-10PCTL │ Temperature 10th percentile │
├─────────────────┼────────────────────────────────────────┤
│ HLY-TEMP-90PCTL │ Temperature 90th percentile │
├─────────────────┼────────────────────────────────────────┤
│ HLY-TEMP-NORMAL │ Temperature mean │
├─────────────────┼────────────────────────────────────────┤
│ HLY-WCHL-NORMAL │ Wind chill mean │
├─────────────────┼────────────────────────────────────────┤
│ HLY-WIND-1STDIR │ Prevailing wind direction (1-8) │
├─────────────────┼────────────────────────────────────────┤
│ HLY-WIND-1STPCT │ Prevailing wind percentage │
├─────────────────┼────────────────────────────────────────┤
│ HLY-WIND-2NDDIR │ Secondary wind direction (1-8) │
├─────────────────┼────────────────────────────────────────┤
│ HLY-WIND-2NDPCT │ Secondary wind percentage │
├─────────────────┼────────────────────────────────────────┤
│ HLY-WIND-AVGSPD │ Average wind speed │
├─────────────────┼────────────────────────────────────────┤
│ HLY-WIND-PCTCLM │ Percentage calm │
├─────────────────┼────────────────────────────────────────┤
│ HLY-WIND-VCTDIR │ Mean wind vector direction │
├─────────────────┼────────────────────────────────────────┤
│ HLY-WIND-VCTSPD │ Mean wind vector magnitude │
╘═════════════════╧════════════════════════════════════════╛
positional arguments:
stationid The station id. from the first column of
<[4;36mhttps://www.ncei.noaa.gov/pub/data/ghcn/daily/ghcnd-stations.txt[0m>
options:
-h | --help
show this help message and exit
ncei_normal_mly¶
$ tsgettoolbox ncei_normal_mly --help
<string>:25: (ERROR/3) Malformed table.
+-------------------------+----------------------------------------+
| Code | Description |
+======================+========================================+
| MLY-CLDD-BASE45 | Average monthly cooling degree days |
| | with base 45F |
+----------------------+----------------------------------------+
| MLY-CLDD-BASE50 | Average monthly cooling degree days |
| | with base 50F |
+----------------------+----------------------------------------+
| MLY-CLDD-BASE55 | Average monthly cooling degree days |
| | with base 55F |
+----------------------+----------------------------------------+
| MLY-CLDD-BASE57 | Average monthly cooling degree days |
| | with base 57F |
+----------------------+----------------------------------------+
| MLY-CLDD-BASE60 | Average monthly cooling degree days |
| | with base 60F |
+----------------------+----------------------------------------+
| MLY-CLDD-BASE70 | Average monthly cooling degree days |
| | with base 70F |
+----------------------+----------------------------------------+
| MLY-CLDD-BASE72 | Average monthly cooling degree days |
| | with base 72F |
+----------------------+----------------------------------------+
| MLY-CLDD-NORMAL | Average monthly cooling degree days |
| | with base 65F |
+----------------------+----------------------------------------+
| MLY-DUTR-NORMAL | Average monthly diurnal temperature |
| | range |
+----------------------+----------------------------------------+
| MLY-DUTR-STDDEV | Long-term standard deviations of |
| | monthly diurnal temperature range |
+----------------------+----------------------------------------+
| MLY-GRDD-BASE40 | Average monthly growing degree days |
| | with base 40F |
+----------------------+----------------------------------------+
| MLY-GRDD-BASE45 | Average monthly growing degree days |
| | with base 45F |
+----------------------+----------------------------------------+
| MLY-GRDD-BASE50 | Average monthly growing degree days |
| | with base 50F |
+----------------------+----------------------------------------+
| MLY-GRDD-BASE55 | Average monthly growing degree days |
| | with base 55F |
+----------------------+----------------------------------------+
| MLY-GRDD-BASE57 | Average monthly growing degree days |
| | with base 57F |
+----------------------+----------------------------------------+
| MLY-GRDD-BASE60 | Average monthly growing degree days |
| | with base 60F |
+----------------------+----------------------------------------+
| MLY-GRDD-BASE65 | Average monthly growing degree days |
| | with base 65F |
+----------------------+----------------------------------------+
| MLY-GRDD-BASE70 | Average monthly growing degree days |
| | with base 70F |
+----------------------+----------------------------------------+
| MLY-GRDD-BASE72 | Average monthly growing degree days |
| | with base 72F |
+----------------------+----------------------------------------+
| MLY-GRDD-TB4886 | Average monthly growing degree days |
| | with truncated bases 48F and 86F |
+----------------------+----------------------------------------+
| MLY-GRDD-TB5086 | Average monthly growing degree days |
| | with truncated bases 50F and 86F |
+----------------------+----------------------------------------+
| MLY-HTDD-BASE40 | Average monthly heating degree days |
| | with base 40F |
+----------------------+----------------------------------------+
| MLY-HTDD-BASE45 | Average monthly heating degree days |
| | with base 45F |
+----------------------+----------------------------------------+
| MLY-HTDD-BASE50 | Average monthly heating degree days |
| | with base 50F |
+----------------------+----------------------------------------+
| MLY-HTDD-BASE55 | Average monthly heating degree days |
| | with base 55F |
+----------------------+----------------------------------------+
| MLY-HTDD-BASE57 | Average monthly heating degree days |
| | with base 57F |
+----------------------+----------------------------------------+
| MLY-HTDD-BASE60 | Average monthly heating degree days |
| | with base 60F |
+----------------------+----------------------------------------+
| MLY-HTDD-NORMAL | Average monthly heating degree days |
| | with base 65F |
+----------------------+----------------------------------------+
| MLY-PRCP-25PCTL | 25th percentiles of monthly |
| | precipitation totals |
+----------------------+----------------------------------------+
| MLY-PRCP-50PCTL | 50th percentiles of monthly |
| | precipitation totals |
+----------------------+----------------------------------------+
| MLY-PRCP-75PCTL | 75th percentiles of monthly |
| | precipitation totals |
+----------------------+----------------------------------------+
| MLY-PRCP-AVGNDS- | Average number of days per month with |
| GE001HI | precipitation >= 0.01 in |
+----------------------+----------------------------------------+
| MLY-PRCP-AVGNDS- | Average number of days per month with |
| GE010HI | precipitation >= 0.10 in |
+----------------------+----------------------------------------+
| MLY-PRCP-AVGNDS- | Average number of days per month with |
| GE050HI | precipitation >= 0.50 in |
+----------------------+----------------------------------------+
| MLY-PRCP-AVGNDS- | Average number of days per month with |
| GE100HI | precipitation >= 1.00 in |
+----------------------+----------------------------------------+
| MLY-PRCP-NORMAL | Average monthly precipitation totals |
+----------------------+----------------------------------------+
| MLY-SNOW-25PCTL | 25th percentiles of monthly snowfall |
| | totals |
+----------------------+----------------------------------------+
| MLY-SNOW-50PCTL | 50th percentiles of monthly snowfall |
| | totals |
+----------------------+----------------------------------------+
| MLY-SNOW-75PCTL | 75th percentiles of monthly snowfall |
| | totals |
+----------------------+----------------------------------------+
| MLY-SNOW-AVGNDS- | Average number of days per month with |
| GE001TI | Snowfall >= 0.1 in |
+----------------------+----------------------------------------+
| MLY-SNOW-AVGNDS- | Average number of days per month with |
| GE010TI | Snowfall >= 1.0 in |
+----------------------+----------------------------------------+
| MLY-SNOW-AVGNDS- | Average number of days per month with |
| GE030TI | Snowfall >= 3.0 in |
+----------------------+----------------------------------------+
| MLY-SNOW-AVGNDS- | Average number of days per month with |
| GE050TI | Snowfall >= 5.0 in |
+----------------------+----------------------------------------+
| MLY-SNOW-AVGNDS- | Average number of days per month with |
| GE100TI | Snowfall >= 10.0 in |
+----------------------+----------------------------------------+
| MLY-SNOW-NORMAL | Average monthly snowfall totals |
+----------------------+----------------------------------------+
| MLY-SNWD-AVGNDS- | Average number of days per month with |
| GE001WI | snow depth >= 1 inch |
+----------------------+----------------------------------------+
| MLY-SNWD-AVGNDS- | Average number of days per month with |
| GE003WI | snow depth >= 3 in |
+----------------------+----------------------------------------+
| MLY-SNWD-AVGNDS- | Average number of days per month with |
| GE005WI | snow depth >= 5 in |
+----------------------+----------------------------------------+
| MLY-SNWD-AVGNDS- | Average number of days per month with |
| GE010WI | snow depth >= 10 in |
+----------------------+----------------------------------------+
| MLY-TAVG-NORMAL | Average monthly average temperature |
+----------------------+----------------------------------------+
| MLY-TAVG-STDDEV | Long-term standard deviations of |
| | monthly average temperature |
+----------------------+----------------------------------------+
| MLY-TMAX-AVGNDS- | Average number of days per month where |
| GRTH040 | tmax is greater than or equal to 40F |
+----------------------+----------------------------------------+
| MLY-TMAX-AVGNDS- | Average number of days per month where |
| GRTH050 | tmax is greater than or equal to 50F |
+----------------------+----------------------------------------+
| MLY-TMAX-AVGNDS- | Average number of days per month where |
| GRTH060 | tmax is greater than or equal to 60F |
+----------------------+----------------------------------------+
| MLY-TMAX-AVGNDS- | Average number of days per month where |
| GRTH070 | tmax is greater than or equal to 70F |
+----------------------+----------------------------------------+
| MLY-TMAX-AVGNDS- | Average number of days per month where |
| GRTH080 | tmax is greater than or equal to 80F |
+----------------------+----------------------------------------+
| MLY-TMAX-AVGNDS- | Average number of days per month where |
| GRTH090 | tmax is greater than or equal to 90F |
+----------------------+----------------------------------------+
| MLY-TMAX-AVGNDS- | Average number of days per month where |
| GRTH100 | tmax is greater than or equal to 100F |
+----------------------+----------------------------------------+
| MLY-TMAX-AVGNDS- | Average number of days per month where |
| LSTH032 | tmax is less than or equal to 32F |
+----------------------+----------------------------------------+
| MLY-TMAX-NORMAL | Average monthly maximum temperature |
+----------------------+----------------------------------------+
| MLY-TMAX-STDDEV | Long-term standard deviations of |
| | monthly maximum temperature |
+----------------------+----------------------------------------+
| MLY-TMIN-AVGNDS- | Average number of days per month where |
| LSTH000 | tmin is less than or equal to 0F |
+----------------------+----------------------------------------+
| MLY-TMIN-AVGNDS- | Average number of days per month where |
| LSTH010 | tmin is less than or equal to 10F |
+----------------------+----------------------------------------+
| MLY-TMIN-AVGNDS- | Average number of days per month where |
| LSTH020 | tmin is less than or equal to 20F |
+----------------------+----------------------------------------+
| MLY-TMIN-AVGNDS- | Average number of days per month where |
| LSTH032 | tmin is less than or equal to 32F |
+----------------------+----------------------------------------+
| MLY-TMIN-AVGNDS- | Average number of days per month where |
| LSTH040 | tmin is less than or equal to 40F |
+----------------------+----------------------------------------+
| MLY-TMIN-AVGNDS- | Average number of days per month where |
| LSTH050 | tmin is less than or equal to 50F |
+----------------------+----------------------------------------+
| MLY-TMIN-AVGNDS- | Average number of days per month where |
| LSTH060 | tmin is less than or equal to 60F |
+----------------------+----------------------------------------+
| MLY-TMIN-AVGNDS- | Average number of days per month where |
| LSTH070 | tmin is less than or equal to 70F |
+----------------------+----------------------------------------+
| MLY-TMIN-NORMAL | Average monthly minimum temperature |
+----------------------+----------------------------------------+
| MLY-TMIN-PRBOCC- | probability of 16F or below at least |
| LSTH016 | once in the month |
+----------------------+----------------------------------------+
| MLY-TMIN-PRBOCC- | probability of 20F or below at least |
| LSTH020 | once in the month |
+----------------------+----------------------------------------+
| MLY-TMIN-PRBOCC- | probability of 24F or below at least |
| LSTH024 | once in the month |
+----------------------+----------------------------------------+
| MLY-TMIN-PRBOCC- | probability of 28F or below at least |
| LSTH028 | once in the month |
+----------------------+----------------------------------------+
| MLY-TMIN-PRBOCC- | probability of 32F or below at least |
| LSTH032 | once in the month |
+----------------------+----------------------------------------+
| MLY-TMIN-PRBOCC- | probability of 36F or below at least |
| LSTH036 | once in the month |
+----------------------+----------------------------------------+
| MLY-TMIN-STDDEV | Long-term standard deviations of |
| | monthly minimum temperature |
+----------------------+----------------------------------------+
usage: tsgettoolbox ncei_normal_mly [-h] stationid
Requires registration and free API key.
For every datatype and record there is a set of meta-data flags. For the GHCNDMS
dataset, the flags are:
'Total Missing','Consecutive Missing'
Total Missing:
Defined as total number of days observation/element is missing in that month.
This can be taken as a measure of quality or completeness as the higher the
number of days sampled in the month, the more representative the value is for
the entire month.
Consecutive Missing:
Defined as the maximum number of consecutive days in the month that an
observation/element is missing.
The following table lists the datatypes available for the annual dataset. Not
all of the datatypes are available for all stations.
Malformed table.
+-------------------------+----------------------------------------+
| Code | Description |
+======================+========================================+
| MLY-CLDD-BASE45 | Average monthly cooling degree days |
| | with base 45F |
+----------------------+----------------------------------------+
| MLY-CLDD-BASE50 | Average monthly cooling degree days |
| | with base 50F |
+----------------------+----------------------------------------+
| MLY-CLDD-BASE55 | Average monthly cooling degree days |
| | with base 55F |
+----------------------+----------------------------------------+
| MLY-CLDD-BASE57 | Average monthly cooling degree days |
| | with base 57F |
+----------------------+----------------------------------------+
| MLY-CLDD-BASE60 | Average monthly cooling degree days |
| | with base 60F |
+----------------------+----------------------------------------+
| MLY-CLDD-BASE70 | Average monthly cooling degree days |
| | with base 70F |
+----------------------+----------------------------------------+
| MLY-CLDD-BASE72 | Average monthly cooling degree days |
| | with base 72F |
+----------------------+----------------------------------------+
| MLY-CLDD-NORMAL | Average monthly cooling degree days |
| | with base 65F |
+----------------------+----------------------------------------+
| MLY-DUTR-NORMAL | Average monthly diurnal temperature |
| | range |
+----------------------+----------------------------------------+
| MLY-DUTR-STDDEV | Long-term standard deviations of |
| | monthly diurnal temperature range |
+----------------------+----------------------------------------+
| MLY-GRDD-BASE40 | Average monthly growing degree days |
| | with base 40F |
+----------------------+----------------------------------------+
| MLY-GRDD-BASE45 | Average monthly growing degree days |
| | with base 45F |
+----------------------+----------------------------------------+
| MLY-GRDD-BASE50 | Average monthly growing degree days |
| | with base 50F |
+----------------------+----------------------------------------+
| MLY-GRDD-BASE55 | Average monthly growing degree days |
| | with base 55F |
+----------------------+----------------------------------------+
| MLY-GRDD-BASE57 | Average monthly growing degree days |
| | with base 57F |
+----------------------+----------------------------------------+
| MLY-GRDD-BASE60 | Average monthly growing degree days |
| | with base 60F |
+----------------------+----------------------------------------+
| MLY-GRDD-BASE65 | Average monthly growing degree days |
| | with base 65F |
+----------------------+----------------------------------------+
| MLY-GRDD-BASE70 | Average monthly growing degree days |
| | with base 70F |
+----------------------+----------------------------------------+
| MLY-GRDD-BASE72 | Average monthly growing degree days |
| | with base 72F |
+----------------------+----------------------------------------+
| MLY-GRDD-TB4886 | Average monthly growing degree days |
| | with truncated bases 48F and 86F |
+----------------------+----------------------------------------+
| MLY-GRDD-TB5086 | Average monthly growing degree days |
| | with truncated bases 50F and 86F |
+----------------------+----------------------------------------+
| MLY-HTDD-BASE40 | Average monthly heating degree days |
| | with base 40F |
+----------------------+----------------------------------------+
| MLY-HTDD-BASE45 | Average monthly heating degree days |
| | with base 45F |
+----------------------+----------------------------------------+
| MLY-HTDD-BASE50 | Average monthly heating degree days |
| | with base 50F |
+----------------------+----------------------------------------+
| MLY-HTDD-BASE55 | Average monthly heating degree days |
| | with base 55F |
+----------------------+----------------------------------------+
| MLY-HTDD-BASE57 | Average monthly heating degree days |
| | with base 57F |
+----------------------+----------------------------------------+
| MLY-HTDD-BASE60 | Average monthly heating degree days |
| | with base 60F |
+----------------------+----------------------------------------+
| MLY-HTDD-NORMAL | Average monthly heating degree days |
| | with base 65F |
+----------------------+----------------------------------------+
| MLY-PRCP-25PCTL | 25th percentiles of monthly |
| | precipitation totals |
+----------------------+----------------------------------------+
| MLY-PRCP-50PCTL | 50th percentiles of monthly |
| | precipitation totals |
+----------------------+----------------------------------------+
| MLY-PRCP-75PCTL | 75th percentiles of monthly |
| | precipitation totals |
+----------------------+----------------------------------------+
| MLY-PRCP-AVGNDS- | Average number of days per month with |
| GE001HI | precipitation >= 0.01 in |
+----------------------+----------------------------------------+
| MLY-PRCP-AVGNDS- | Average number of days per month with |
| GE010HI | precipitation >= 0.10 in |
+----------------------+----------------------------------------+
| MLY-PRCP-AVGNDS- | Average number of days per month with |
| GE050HI | precipitation >= 0.50 in |
+----------------------+----------------------------------------+
| MLY-PRCP-AVGNDS- | Average number of days per month with |
| GE100HI | precipitation >= 1.00 in |
+----------------------+----------------------------------------+
| MLY-PRCP-NORMAL | Average monthly precipitation totals |
+----------------------+----------------------------------------+
| MLY-SNOW-25PCTL | 25th percentiles of monthly snowfall |
| | totals |
+----------------------+----------------------------------------+
| MLY-SNOW-50PCTL | 50th percentiles of monthly snowfall |
| | totals |
+----------------------+----------------------------------------+
| MLY-SNOW-75PCTL | 75th percentiles of monthly snowfall |
| | totals |
+----------------------+----------------------------------------+
| MLY-SNOW-AVGNDS- | Average number of days per month with |
| GE001TI | Snowfall >= 0.1 in |
+----------------------+----------------------------------------+
| MLY-SNOW-AVGNDS- | Average number of days per month with |
| GE010TI | Snowfall >= 1.0 in |
+----------------------+----------------------------------------+
| MLY-SNOW-AVGNDS- | Average number of days per month with |
| GE030TI | Snowfall >= 3.0 in |
+----------------------+----------------------------------------+
| MLY-SNOW-AVGNDS- | Average number of days per month with |
| GE050TI | Snowfall >= 5.0 in |
+----------------------+----------------------------------------+
| MLY-SNOW-AVGNDS- | Average number of days per month with |
| GE100TI | Snowfall >= 10.0 in |
+----------------------+----------------------------------------+
| MLY-SNOW-NORMAL | Average monthly snowfall totals |
+----------------------+----------------------------------------+
| MLY-SNWD-AVGNDS- | Average number of days per month with |
| GE001WI | snow depth >= 1 inch |
+----------------------+----------------------------------------+
| MLY-SNWD-AVGNDS- | Average number of days per month with |
| GE003WI | snow depth >= 3 in |
+----------------------+----------------------------------------+
| MLY-SNWD-AVGNDS- | Average number of days per month with |
| GE005WI | snow depth >= 5 in |
+----------------------+----------------------------------------+
| MLY-SNWD-AVGNDS- | Average number of days per month with |
| GE010WI | snow depth >= 10 in |
+----------------------+----------------------------------------+
| MLY-TAVG-NORMAL | Average monthly average temperature |
+----------------------+----------------------------------------+
| MLY-TAVG-STDDEV | Long-term standard deviations of |
| | monthly average temperature |
+----------------------+----------------------------------------+
| MLY-TMAX-AVGNDS- | Average number of days per month where |
| GRTH040 | tmax is greater than or equal to 40F |
+----------------------+----------------------------------------+
| MLY-TMAX-AVGNDS- | Average number of days per month where |
| GRTH050 | tmax is greater than or equal to 50F |
+----------------------+----------------------------------------+
| MLY-TMAX-AVGNDS- | Average number of days per month where |
| GRTH060 | tmax is greater than or equal to 60F |
+----------------------+----------------------------------------+
| MLY-TMAX-AVGNDS- | Average number of days per month where |
| GRTH070 | tmax is greater than or equal to 70F |
+----------------------+----------------------------------------+
| MLY-TMAX-AVGNDS- | Average number of days per month where |
| GRTH080 | tmax is greater than or equal to 80F |
+----------------------+----------------------------------------+
| MLY-TMAX-AVGNDS- | Average number of days per month where |
| GRTH090 | tmax is greater than or equal to 90F |
+----------------------+----------------------------------------+
| MLY-TMAX-AVGNDS- | Average number of days per month where |
| GRTH100 | tmax is greater than or equal to 100F |
+----------------------+----------------------------------------+
| MLY-TMAX-AVGNDS- | Average number of days per month where |
| LSTH032 | tmax is less than or equal to 32F |
+----------------------+----------------------------------------+
| MLY-TMAX-NORMAL | Average monthly maximum temperature |
+----------------------+----------------------------------------+
| MLY-TMAX-STDDEV | Long-term standard deviations of |
| | monthly maximum temperature |
+----------------------+----------------------------------------+
| MLY-TMIN-AVGNDS- | Average number of days per month where |
| LSTH000 | tmin is less than or equal to 0F |
+----------------------+----------------------------------------+
| MLY-TMIN-AVGNDS- | Average number of days per month where |
| LSTH010 | tmin is less than or equal to 10F |
+----------------------+----------------------------------------+
| MLY-TMIN-AVGNDS- | Average number of days per month where |
| LSTH020 | tmin is less than or equal to 20F |
+----------------------+----------------------------------------+
| MLY-TMIN-AVGNDS- | Average number of days per month where |
| LSTH032 | tmin is less than or equal to 32F |
+----------------------+----------------------------------------+
| MLY-TMIN-AVGNDS- | Average number of days per month where |
| LSTH040 | tmin is less than or equal to 40F |
+----------------------+----------------------------------------+
| MLY-TMIN-AVGNDS- | Average number of days per month where |
| LSTH050 | tmin is less than or equal to 50F |
+----------------------+----------------------------------------+
| MLY-TMIN-AVGNDS- | Average number of days per month where |
| LSTH060 | tmin is less than or equal to 60F |
+----------------------+----------------------------------------+
| MLY-TMIN-AVGNDS- | Average number of days per month where |
| LSTH070 | tmin is less than or equal to 70F |
+----------------------+----------------------------------------+
| MLY-TMIN-NORMAL | Average monthly minimum temperature |
+----------------------+----------------------------------------+
| MLY-TMIN-PRBOCC- | probability of 16F or below at least |
| LSTH016 | once in the month |
+----------------------+----------------------------------------+
| MLY-TMIN-PRBOCC- | probability of 20F or below at least |
| LSTH020 | once in the month |
+----------------------+----------------------------------------+
| MLY-TMIN-PRBOCC- | probability of 24F or below at least |
| LSTH024 | once in the month |
+----------------------+----------------------------------------+
| MLY-TMIN-PRBOCC- | probability of 28F or below at least |
| LSTH028 | once in the month |
+----------------------+----------------------------------------+
| MLY-TMIN-PRBOCC- | probability of 32F or below at least |
| LSTH032 | once in the month |
+----------------------+----------------------------------------+
| MLY-TMIN-PRBOCC- | probability of 36F or below at least |
| LSTH036 | once in the month |
+----------------------+----------------------------------------+
| MLY-TMIN-STDDEV | Long-term standard deviations of |
| | monthly minimum temperature |
+----------------------+----------------------------------------+
positional arguments:
stationid The station id. from the first column of
<[4;36mhttps://www.ncei.noaa.gov/pub/data/ghcn/daily/ghcnd-stations.txt[0m>
options:
-h | --help
show this help message and exit
ncei_precip_15¶
$ tsgettoolbox ncei_precip_15 --help
usage: tsgettoolbox ncei_precip_15 [-h] [--start_date START_DATE]
[--end_date END_DATE] stationid
Requires registration and free API key.
For every datatype and record there is a set of meta-data flags. For the GHCNDMS
dataset, the flags are:
'Total Missing','Consecutive Missing'
Total Missing:
Defined as total number of days observation/element is missing in that month.
This can be taken as a measure of quality or completeness as the higher the
number of days sampled in the month, the more representative the value is for
the entire month.
Consecutive Missing:
Defined as the maximum number of consecutive days in the month that an
observation/element is missing.
The following table lists the datatypes available for the annual dataset. Not
all datatypes are available for all stations.
┌──────┬───────────────┐
│ Code │ Description │
╞══════╪═══════════════╡
│ QGAG │ Precipitation │
├──────┼───────────────┤
│ QPCP │ Precipitation │
╘══════╧═══════════════╛
positional arguments:
stationid The station id. from the first column of
<[4;36mhttps://www.ncei.noaa.gov/pub/data/ghcn/daily/ghcnd-stations.txt[0m>
options:
-h | --help
show this help message and exit
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
ncei_precip_hly¶
$ tsgettoolbox ncei_precip_hly --help
usage: tsgettoolbox ncei_precip_hly [-h] [--start_date START_DATE]
[--end_date END_DATE] stationid
Requires registration and free API key.
For every datatype and record there is a set of meta-data flags. For the GHCNDMS
dataset, the flags are:
'Total Missing','Consecutive Missing'
Total Missing:
Defined as total number of days observation/element is missing in that month.
This can be taken as a measure of quality or completeness as the higher the
number of days sampled in the month, the more representative the value is for
the entire month.
Consecutive Missing:
Defined as the maximum number of consecutive days in the month that an
observation/element is missing.
positional arguments:
stationid The station id. from the first column of
<[4;36mhttps://www.ncei.noaa.gov/pub/data/ghcn/daily/ghcnd-stations.txt[0m>
options:
-h | --help
show this help message and exit
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
ndbc¶
$ tsgettoolbox ndbc --help
usage: tsgettoolbox ndbc [-h] [--endUTC ENDUTC] station table startUTC
Download historical data from the National Data Buoy Center.
The Active Station List is available at <[4;36mhttp://www.ndbc.noaa.gov/active-
stations.xml[0m>
When accessing Historical data files, the measurements are generally in metric
units, as described below, and cannot be changed.
Historical files show times in UTC only.
positional arguments:
station Five-digit WMO Station Identifier, used since 1976. ID's can be
reassigned to future deployments within the same 1 degree square.
table The 'table' option is one of the
following:
┌────────┬────────────────────────────────┐
│ table │ Description │
╞════════╪════════════════════════════════╡
│ adcp │ Ocean Current data │
├────────┼────────────────────────────────┤
│ cwind │ Continuous Wind Data │
├────────┼────────────────────────────────┤
│ ocean │ Oceanographic Data │
├────────┼────────────────────────────────┤
│ srad │ Solar Radiation Data │
├────────┼────────────────────────────────┤
│ stdmet │ Standard Meteorology Table │
├────────┼────────────────────────────────┤
│ supl │ Supplemental Measurements Data │
├────────┼────────────────────────────────┤
│ wlevel │ Water Level Data │
╘════════╧════════════════════════════════╛
'adcp' Ocean Current Data
┌─────────────────┬───────────────────────────────────────────────┐
│ Variable │ Description │
╞═════════════════╪═══════════════════════════════════════════════╡
│ DEP01,DEP02,... │ The distance from the sea surface to the │
│ │ middle of the depth cells, or bins, measured │
│ │ in meters. │
├─────────────────┼───────────────────────────────────────────────┤
│ DIR01,DIR02,... │ The direction the ocean current is flowing │
│ │ toward. 0-360 degrees, 360 is due north, 0 │
│ │ means no measurable current. │
├─────────────────┼───────────────────────────────────────────────┤
│ SPD01,SPD02,... │ The speed of the ocean current measured in │
│ │ cm/s. │
╘═════════════════╧═══════════════════════════════════════════════╛
'cwind' Continuous Winds
┌───────┬─────────────────────────────────────────────────────────┐
│ Code │ Description │
╞═══════╪═════════════════════════════════════════════════════════╡
│ WDIR │ Ten-minute average wind direction measurements in │
│ │ degrees clockwise from true North. (DIR in Historical │
├───────┼─files)──────────────────────────────────────────────────┤
│ WSPD │ Ten-minute average wind speed values in m/s. (SPD in │
│ │ Historical files) │
├───────┼─────────────────────────────────────────────────────────┤
│ GDR │ Direction, in degrees clockwise from true North, of the │
│ │ GST, reported at the last hourly 10-minute segment. │
├───────┼─────────────────────────────────────────────────────────┤
│ GST │ Maximum 5-second peak gust during the measurement hour, │
│ │ reported at the last hourly 10-minute segment. │
├───────┼─────────────────────────────────────────────────────────┤
│ GTIME │ The minute of the hour that the GSP occurred, reported │
│ │ at the last hourly 10-minute segment. │
╘═══════╧═════════════════════════════════════════════════════════╛
'ocean' Oceanographic Data
┌───────────┬─────────────────────────────────────────────────────┐
│ Code │ Description │
╞═══════════╪═════════════════════════════════════════════════════╡
│ DEPTH │ Depth (meters) at which measurements are taken. │
├───────────┼─────────────────────────────────────────────────────┤
│ OTMP │ The direct measurement (Celsius) of the Ocean │
│ │ Temperature (as opposed to the indirect measurement │
│ │ (see WTMP above)). │
├───────────┼─────────────────────────────────────────────────────┤
│ COND │ Conductivity is a measure of the electrical │
│ │ conductivity properties of seawater in milliSiemens │
│ │ per centimeter. │
├───────────┼─────────────────────────────────────────────────────┤
│ SAL │ Salinity is computed by a known functional │
│ │ relationship between the measured electrical │
│ │ conductivity of seawater (CON), temperature (OTMP) │
│ │ and pressure. Salinity is computed using the │
│ │ Practical Salinity Scale of 1978 (PSS78) and │
│ │ reported in Practical Salinity Units. │
├───────────┼─────────────────────────────────────────────────────┤
│ O2PERCENT │ Dissolved oxygen as a percentage. │
├───────────┼─────────────────────────────────────────────────────┤
│ O2PPM │ Dissolved oxygen in parts per million. │
├───────────┼─────────────────────────────────────────────────────┤
│ CLCON │ Chlorophyll concentration in micrograms per liter │
│ │ (ug/l). │
├───────────┼─────────────────────────────────────────────────────┤
│ TURB │ Turbidity is an expression of the optical property │
│ │ that causes light to be scattered and absorbed │
│ │ rather than transmitted in straight lines through │
│ │ the sample (APHA 1980). Units are Formazine │
│ │ Turbidity Units (FTU). │
├───────────┼─────────────────────────────────────────────────────┤
│ PH │ A measure of the acidity or alkalinity of the │
│ │ seawater. │
├───────────┼─────────────────────────────────────────────────────┤
│ EH │ Redox (oxidation and reduction) potential of │
│ │ seawater in millivolts. │
╘═══════════╧═════════════════════════════════════════════════════╛
'srad' Shortwave Radiation
┌───────┬─────────────────────────────────────────────────────────┐
│ Code │ Description │
╞═══════╪═════════════════════════════════════════════════════════╡
│ SRAD1 │ Average shortwave radiation in watts per square meter │
│ SWRAD │ for the preceding hour. Sample frequency is 2 times per │
│ │ second (2 Hz). If present, SRAD1 is from a LI-COR │
│ │ LI-200 pyranometer sensor, and SWRAD is from an Eppley │
│ │ PSP Precision Spectral Pyranometer. │
├───────┼─────────────────────────────────────────────────────────┤
│ LWRAD │ Average downwelling longwave radiation in watts per │
│ │ square meter for the preceding hour. Sample frequency │
│ │ is 2 times per second (2 Hz). If present, LWRAD is from │
│ │ an Eppley PIR Precision Infrared Radiometer. │
╘═══════╧═════════════════════════════════════════════════════════╛
'stdmet' Standard Meteorology Table
┌──────┬──────────────────────────────────────────────────────────┐
│ Code │ Description │
╞══════╪══════════════════════════════════════════════════════════╡
│ WDIR │ Wind direction (the direction the wind is coming from in │
│ │ degrees clockwise from true N) during the same period │
│ │ used for WSPD. See Wind Averaging Methods │
├──────┼──────────────────────────────────────────────────────────┤
│ WSPD │ Wind speed (m/s) averaged over an eight-minute period │
│ │ for buoys and a two-minute period for land stations. │
│ │ Reported Hourly. See Wind Averaging Methods. │
├──────┼──────────────────────────────────────────────────────────┤
│ GST │ Peak 5 or 8 second gust speed (m/s) measured during the │
│ │ eight-minute or two-minute period. The 5 or 8 second │
│ │ period can be determined by payload, See the Sensor │
│ │ Reporting, Sampling, and Accuracy section. │
├──────┼──────────────────────────────────────────────────────────┤
│ WVHT │ Significant wave height (meters) is calculated as the │
│ │ average of the highest one-third of all of the wave │
│ │ heights during the 20-minute sampling period. See the │
│ │ Wave Measurements section. │
├──────┼──────────────────────────────────────────────────────────┤
│ DPD │ Dominant wave period (seconds) is the period with the │
│ │ maximum wave energy. See the Wave Measurements section. │
├──────┼──────────────────────────────────────────────────────────┤
│ APD │ Average wave period (seconds) of all waves during the │
│ │ 20-minute period. See the Wave Measurements section. │
├──────┼──────────────────────────────────────────────────────────┤
│ MWD │ The direction from which the waves at the dominant │
│ │ period (DPD) are coming. The units are degrees from true │
│ │ North increasing clockwise, with North as 0 (zero) │
│ │ degree East as 90 degrees. See the Wave Measurements │
├──────┼─section.─────────────────────────────────────────────────┤
│ PRES │ Sea level pressure (hPa). For C-MAN sites and Great │
│ │ Lakes buoys, the recorded pressure is reduced to sea │
│ │ level using the method described in NWS Technical │
│ │ Procedure Bulletin 291 (11/14/80). ( labeled BAR in │
├──────┼─Historical files)────────────────────────────────────────┤
│ ATMP │ Air temperature (Celsius). For sensor heights on buoys, │
│ │ see Hull Descriptions. For sensor heights at C-MAN │
│ │ stations, see C-MAN Sensor Locations │
├──────┼──────────────────────────────────────────────────────────┤
│ WTMP │ Sea surface temperature (Celsius). For buoys the depth │
│ │ is referenced to the hull's waterline. For fixed │
│ │ platforms it varies with tide, but is referenced to, or │
│ │ near Mean Lower Low Water (MLLW). │
├──────┼──────────────────────────────────────────────────────────┤
│ DEWP │ Dewpoint temperature taken at the same height as the air │
│ │ temperature measurement. │
├──────┼──────────────────────────────────────────────────────────┤
│ VIS │ Station visibility (nautical miles). Note that buoy │
│ │ stations are limited to reports from 0 to 1.6 nmi. │
├──────┼──────────────────────────────────────────────────────────┤
│ PTDY │ Pressure Tendency is the direction (plus or minus) and │
│ │ the amount of pressure change (hPa)for a three hour │
│ │ period ending at the time of observation. (not in │
│ │ Historical files) │
├──────┼──────────────────────────────────────────────────────────┤
│ TIDE │ The water level in feet above or below Mean Lower Low │
│ │ Water (MLLW). │
╘══════╧══════════════════════════════════════════════════════════╛
'supl' Supplemental Measurements Data
┌───────┬─────────────────────────────────────────────────────────┐
│ Code │ Description │
╞═══════╪═════════════════════════════════════════════════════════╡
│ PRES │ Lowest recorded 1 minute atmospheric pressure for the │
│ │ hour to the nearest 0.1 hPa. │
├───────┼─────────────────────────────────────────────────────────┤
│ PTIME │ The time at which PRES occurred (hour and minute). │
├───────┼─────────────────────────────────────────────────────────┤
│ WSPD │ Highest recorded 1 minute wind speed for the hour to │
│ │ the nearest 0.1 m/s. │
├───────┼─────────────────────────────────────────────────────────┤
│ WDIR │ WSPD corresponding direction to the nearest degree. │
├───────┼─────────────────────────────────────────────────────────┤
│ WTIME │ The time at which WSPD occurred (hour and minute). │
╘═══════╧═════════════════════════════════════════════════════════╛
'wlevel' Water Level
┌────────┬────────────────────────────────────────────────────────┐
│ Code │ Description │
╞════════╪════════════════════════════════════════════════════════╡
│ WLEVEL │ Six-minute water levels representing the height, in │
│ │ feet, of the water above or below Mean Lower Low Water │
│ │ (MLLW), offset by 10 ft. to prevent negative values. │
│ │ Please subtract 10 ft. from every value to obtain the │
│ │ true water level value, in reference to MLLW. │
╘════════╧════════════════════════════════════════════════════════╛
startUTC an ISO 8601 date/time string
(only seconds are optional)
options:
-h | --help
show this help message and exit
--endUTC ENDUTC
[optional, default to None implies now]
an ISO 8601 date/time string. (only seconds are optional)
nwis¶
$ tsgettoolbox nwis --help
<string>:49: (WARNING/2) Option list ends without a blank line; unexpected unindent.
usage: tsgettoolbox nwis [-h] [--sites SITES] [--stateCd STATECD] [--huc HUC]
[--bBox BBOX] [--countyCd COUNTYCD] [--parameterCd PARAMETERCD] [--period
PERIOD] [--startDT STARTDT] [--endDT ENDDT] [--siteType SITETYPE]
[--modifiedSince MODIFIEDSINCE] [--agencyCd AGENCYCD] [--siteStatus
SITESTATUS] [--altMin ALTMIN] [--altMax ALTMAX] [--drainAreaMin
DRAINAREAMIN] [--drainAreaMax DRAINAREAMAX] [--aquiferCd AQUIFERCD]
[--localAquiferCd LOCALAQUIFERCD] [--wellDepthMin WELLDEPTHMIN]
[--wellDepthMax WELLDEPTHMAX] [--holeDepthMin HOLEDEPTHMIN] [--holeDepthMax
HOLEDEPTHMAX] [--database DATABASE] [--statReportType STATREPORTTYPE]
[--statType STATTYPE] [--missingData MISSINGDATA] [--statYearType
STATYEARTYPE]
This "nwis" function has been split up into individual functions for each source
database. This allows for keywords and output to be tailored to each specific
web service.
┌───────────────────┬───────────────────────────────┐
│ New Function │ Database Name and Description │
╞═══════════════════╪═══════════════════════════════╡
│ nwis_iv │ Instantaneous Value sub-daily │
│ │ interval data starting in │
├───────────────────┼─2007──────────────────────────┤
│ nwis_dv │ Daily Values database │
├───────────────────┼───────────────────────────────┤
│ nwis_stat │ daily/monthly/annual │
├───────────────────┼─statistics────────────────────┤
│ nwis_site │ Site metadata │
├───────────────────┼───────────────────────────────┤
│ nwis_measurements │ Field measurements │
├───────────────────┼───────────────────────────────┤
│ nwis_peak │ Peak flow and stage │
├───────────────────┼───────────────────────────────┤
│ nwis_gwlevels │ Ground water levels │
╘═══════════════════╧═══════════════════════════════╛
This function/sub-command will continue to work, however you should change all
scripts to use the split out functions.
options:
-h | --help
show this help message and exit
Option list ends without a blank line; unexpected unindent.
--sites SITES --stateCd STATECD --huc HUC --bBox BBOX --countyCd COUNTYCD
--parameterCd PARAMETERCD --period PERIOD --startDT STARTDT --endDT ENDDT
--siteType SITETYPE --modifiedSince MODIFIEDSINCE --agencyCd AGENCYCD
--siteStatus SITESTATUS --altMin ALTMIN --altMax ALTMAX --drainAreaMin
DRAINAREAMIN --drainAreaMax DRAINAREAMAX --aquiferCd AQUIFERCD
--localAquiferCd LOCALAQUIFERCD --wellDepthMin WELLDEPTHMIN --wellDepthMax
WELLDEPTHMAX --holeDepthMin HOLEDEPTHMIN --holeDepthMax HOLEDEPTHMAX
--database DATABASE --statReportType STATREPORTTYPE --statType STATTYPE
--missingData MISSINGDATA --statYearType STATYEARTYPE
nwis_dv¶
$ tsgettoolbox nwis_dv --help
usage: tsgettoolbox nwis_dv [-h] [--sites SITES] [--stateCd STATECD]
[--huc HUC] [--bBox BBOX] [--countyCd COUNTYCD] [--agencyCd AGENCYCD]
[--altMax ALTMAX] [--altMin ALTMIN] [--aquiferCd AQUIFERCD] [--drainAreaMax
DRAINAREAMAX] [--drainAreaMin DRAINAREAMIN] [--holeDepthMax HOLEDEPTHMAX]
[--holeDepthMin HOLEDEPTHMIN] [--localAquiferCd LOCALAQUIFERCD]
[--modifiedSince MODIFIEDSINCE] [--parameterCd PARAMETERCD] [--siteStatus
SITESTATUS] [--siteType SITETYPE] [--wellDepthMax WELLDEPTHMAX]
[--wellDepthMin WELLDEPTHMIN] [--startDT STARTDT] [--endDT ENDDT] [--period
PERIOD] [--include_codes] [--statisticsCd STATISTICSCD]
Detailed documentation is available at <[4;36mhttp://waterdata.usgs.gov/nwis[0m>.
Site local time is output, even if multiple sites are requested and sites are in
different time zones. Note that the measurement time zone at a site may not be
the same as the time zone actually in effect at the site.
Every query requires a major filter. Pick the major filter ('--sites',
'--stateCd', '--huc', '--bBox', '--countyCd') that best retrieves the data for
the sites that you are interested in. You can have only one major filter per
query. If you specify more than one major filter, you will get an error.
[1mMajor Filter[0m
Select ONE of:
'--sites',
'--stateCd',
'--huc',
'--bBox', or
'--countyCd'
[1mMinor Filters[0m
Additional filters can be applied after specifying a major filter. This further
reduces the set of expected results. Users are encouraged to use minor filters
because it allows more efficient use of this service.
Use as many as desired to limit number of retrieved time series:
'--agencyCd',
'--altMax',
'--altMin',
'--aquiferCd',
'--drainAreaMax',
'--drainAreaMin',
'--holeDepthMax'
'--holeDepthMin',
'--localAquiferCd',
'--modifiedSince',
'--parameterCd',
'--siteStatus',
'--siteType',
'--wellDepthMax',
'--wellDepthMin',
[1mResults[0m
The column name in the resulting table is made up of
"agencyCd_siteno_parameterCd", for example "USGS_02248380_00010". The agency and
parameter codes are described in the agencyCd and parameterCd options below.
If include_codes option is used, there will also be columns representing the
data quality codes named "agencyCd_siteno_parameterCd_cd".
┌─────────┬────────────────────────────────────────────────────────┐
│ Code │ Description │
╞═════════╪════════════════════════════════════════════════════════╡
│ e │ Value has been edited or estimated by USGS personnel │
│ │ and is write protected │
├─────────┼────────────────────────────────────────────────────────┤
│ & │ Value was computed from affected unit values │
├─────────┼────────────────────────────────────────────────────────┤
│ E │ Value was computed from estimated unit values. │
├─────────┼────────────────────────────────────────────────────────┤
│ A │ Approved for publication -- Processing and review │
│ │ completed. │
├─────────┼────────────────────────────────────────────────────────┤
│ P │ Provisional data subject to revision. │
├─────────┼────────────────────────────────────────────────────────┤
│ < │ The value is known to be less than reported value and │
│ │ is write protected. │
├─────────┼────────────────────────────────────────────────────────┤
│ > │ The value is known to be greater than reported value │
│ │ and is write protected. │
├─────────┼────────────────────────────────────────────────────────┤
│ 1 │ Value is write protected without any remark code to be │
│ │ printed │
├─────────┼────────────────────────────────────────────────────────┤
│ 2 │ Remark is write protected without any remark code to │
│ │ be printed │
├─────────┼────────────────────────────────────────────────────────┤
│ │ No remark (blank) │
├─────────┼────────────────────────────────────────────────────────┤
│ Ssn │ Parameter monitored seasonally │
├─────────┼────────────────────────────────────────────────────────┤
│ Ice │ Ice affected │
├─────────┼────────────────────────────────────────────────────────┤
│ Pr │ Partial-record site │
├─────────┼────────────────────────────────────────────────────────┤
│ Rat │ Rating being developed or revised │
├─────────┼────────────────────────────────────────────────────────┤
│ Eqp │ Equipment malfunction │
├─────────┼────────────────────────────────────────────────────────┤
│ Fld │ Flood damage │
├─────────┼────────────────────────────────────────────────────────┤
│ Dis │ Data-collection discontinued │
├─────────┼────────────────────────────────────────────────────────┤
│ Dry │ Dry │
├─────────┼────────────────────────────────────────────────────────┤
│ -- │ Parameter not determined │
├─────────┼────────────────────────────────────────────────────────┤
│ Mnt │ Maintenance in progress │
├─────────┼────────────────────────────────────────────────────────┤
│ ZFl │ Zero flow │
├─────────┼────────────────────────────────────────────────────────┤
│ *** │ Temporarily unavailable │
╘═════════╧════════════════════════════════════════════════════════╛
options:
-h | --help
show this help message and exit
--sites SITES
[optional, default is None, major site filter]
Want to only query one site? Use sites as your major filter, and put only
one site number in the list. Sites are comma separated. Sites may be
prefixed with an optional agency code followed by a colon. If you do
not know the site numbers you need, you can find relevant sites with
the NWIS Mapper (<[4;36mhttp://wdr.water.usgs.gov/nwisgmap/index.html[0m>) or
on the USGS Water Data for the Nation site.
(<[4;36mhttp://waterdata.usgs.gov/nwis/[0m>)
Can have from 1 to 100 comma separated site numbers:
--sites=USGS:01646500
--sites=01646500,06306300
--stateCd STATECD
[optional, default is None, major site filter]
U.S. postal service (2-digit) state code. Can have only 1 state code. List
is available at <[4;36mhttp://www.usps.com/ncsc/lookups/usps_abbre-
viations.html[0m>:
--stateCd=NY
--huc HUC
[optional, default is None, major site filter]
A list of hydrologic unit codes (HUC) or watersheds. Only 1 major HUC can
be specified per request. A major HUC has two digits. Minor HUCs
must be eight digits in length. Can have 1 to 10 HUC codes. List of
HUCs is available at <[4;36mhttp://water.usgs.gov/GIS/huc_name.html[0m>:
--huc=01,02070010
--bBox BBOX
[optional, default is None, major site filter]
A contiguous range of decimal latitude and longitude, starting with the
west longitude, then the south latitude, then the east longitude,
and then the north latitude with each value separated by a comma.
The product of the range of latitude and longitude cannot exceed 25
degrees. Whole or decimal degrees must be specified, up to six
digits of precision. Minutes and seconds are not allowed. Remember:
western longitude (which includes almost all of the United States)
is specified in negative degrees. Caution: many sites outside the
continental US do not have latitude and longitude referenced to
NAD83 and therefore can not be found using these arguments. Certain
sites are not associated with latitude and longitude due to homeland
security concerns and cannot be found using this filter.:
--bBox=-83,36.5,-81,38.5
--countyCd COUNTYCD
[optional, default is None, major site filter]
A list of county numbers, in a 5 digit numeric format. The first two
digits of a county's code are the FIPS State Code. Can have from 1
to 20 county codes. The first 2 digits are the FIPS State Code
(<[4;36mhttp://www.itl.nist.gov/fipspubs/fip5-2.htm[0m>) and the list of
county codes are at <[4;36mhttp://help.waterdata.usgs.gov/code/cou-
nty_query?fmt=html[0m>:
--countyCd=51059,51061
--agencyCd AGENCYCD
[optional, default is None, minor site filter]
The list of sites returned are filtered to return only those with the
provided agency code. The agency code describes the organization
that maintains the site. Only one agency code is allowed and is
optional. An authoritative list of agency codes can be found here.
Default is to return all sites regardless of agency code. List:
<[4;36mhttp://help.waterdata.usgs.gov/code/agency_cd_query?fmt=html[0m>:
--stateCd=il --agencyCd=USCE # Only US Army Corps
# of Engineers sites
# in Illinois
--altMax ALTMAX
[optional, default is None, minor site filter]
Providing a value to altMax (maximum altitude) means you want sites that
have or are less than the altMax value.:
--altMin=1000 --altMax=5000
# Return sites where the altitude is 1000 feet or
# greater and 5000 feet or less.
--altMin=12.5 --altMax=13
# Return sites where the altitude is 12.5 feet or
# greater and 13 feet or less.
--altMin ALTMIN
[optional, default is None, minor site filter]
These arguments allows you to select instantaneous values sites where the
associated sites' altitude are within a desired altitude, expressed
in feet. Altitude is based on the datum used at the site. Providing
a value to altMin (minimum altitude) means you want sites that have
or exceed the altMin value. You may specify decimal feet if
precision is critical If both the altMin and altMax are specified,
sites at or between the minimum and maximum altitude are returned.
--aquiferCd AQUIFERCD
[optional, default is None, minor site filter]
Used to filter sites to those that exist in specified national aquifers.
Note: not all sites have been associated with national aquifers.
Enter one or more national aquifer codes, separated by commas. A
national aquifer code is exactly 10 characters. You can have up to
1000 aquiferCd codes. Complete list:
<[4;36mhttp://water.usgs.gov/ogw/NatlAqCode-reflist.html[0m>:
--aquiferCd=S500EDRTRN,N100HGHPLN
# returns groundwater sites for the
# Edwards-Trinity aquifer system and
# the High Plains national
# aquifers.
--drainAreaMax DRAINAREAMAX
[optional, default is None, minor site filter]
SURFACE WATER SITE ATTRIBUTE
Providing a value to drainAreaMax (maximum drainage area) means you want
sites that have or are less than the drainAreaMax value.:
--drainAreaMin=1000 --drainAreaMax=5000
# Return sites where the drainage area
# is 1000 square miles or greater and
# is 5000 square miles or less.
--drainAreaMin=10.5 --drainAreaMax=10.7
# Return sites where the drainage area
# is 10.5 square miles or greater and
# is 10.7 square miles or less.
--drainAreaMin DRAINAREAMIN
[optional, default is None, minor site filter]
SURFACE WATER SITE ATTRIBUTE
These arguments allows you to select principally surface water sites where
the associated sites' drainage areas (watersheds) are within a
desired size, expressed in square miles or decimal fractions
thereof. Providing a value to drainAreaMin (minimum drainage area)
means you want sites that have or exceed the drainAreaMin value. The
values may be expressed in decimals. If both the drainAreaMin and
drainAreaMax are specified, sites at or between the minimum and
maximum drainage areas values specified are returned Caution: not
all sites are associated with a drainage area. Caution: drainage
area generally only applies to surface water sites. Use with other
site types, such as groundwater sites, will likely retrieve no
results.
--holeDepthMax HOLEDEPTHMAX
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
Providing a value to holeDepthMax (maximum hole depth) means you want
sites that have or are less than the holeDepthMax value.:
--holeDepthMin=100 --holeDepthMax=500
# Return daily values sites where the hole depth is
# 100 feet or greater and 500 feet or less.
--holeDepthMin=10.5 --holeDepthMax=10.7
# Return daily value sites where the hole depth is
# 10.5 feet or greater and 10.7 feet or less.
If both the holeDepthMin and holeDepthMax are specified, sites at or
between the minimum and maximum hole depth values specified are
returned holeDepthMax should be greater than or equal to
holeDepthMin.
--holeDepthMin HOLEDEPTHMIN
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
These arguments allows you to select groundwater sites serving data
recorded automatically where the associated sites' hole depth are
within a desired depth, expressed in feet from the land surface
datum. Express hole depth as a positive number. Providing a value to
holeDepthMin (minimum hole depth) means you want sites that have or
exceed the holeDepthMin value. The values may be expressed in
decimals Caution: hole depth applies to groundwater sites only.
--localAquiferCd LOCALAQUIFERCD
[optional, default is None, minor site filter]
Used to filter sites to those that exist in specified local aquifers.
Note: not all sites have been associated with local aquifers. Enter
one or more local aquifer codes, separated by commas. A local
aquifer code begins with a 2 character state abbreviation (such as
TX for Texas) followed by a colon followed by the 7 character
aquifer code. Can have 0 to 1000 comma delimited codes. Complete
list: <[4;36mhttp://help.waterdata.usgs.gov/code/aqfr_cd_query?fmt=html[0m>
To translate state codes associated with the local aquifer you may
need this reference: <[4;36mhttp://www.itl.nist.gov/fipspubs/fip5-2.htm[0m>
--localAquiferCd=AL:111RGLT,AL:111RSDM
# returns sites for the Regolith and Saprolite local
# aquifers in Alabama
--modifiedSince MODIFIEDSINCE
[optional, default is None, minor site filter]
Returns all values for sites and period of record requested only if any
values have changed over the last modifiedSince period.
modifiedSince is useful if you periodically need to poll a site but
are only interested in getting data if some of it has changed. It is
typically be used with period, or startDT/endDT but does not have to
be. In the latter case, if any values were changed during the
specified modifiedSince period, only the most recent values would be
retrieved for those sites. This is a typical usage, since users
typically are polling a site and only want data if there are new or
changed measurements. ISO-8601 duration format is always used. There
is no default. (<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Durations[0m>):
--modifiedSince=PT2H
# Retrieves all values for sites and period of record
# requested for any of the requested sites and
# parameters, but only for sites where any of the
# values changed during the last two hours.
--modifiedSince=PT2H --period=P1D
# Retrieve all values for sites and period of record
# requested for the last 24 hours from now only for
# sites and parameters that had any values that
# changed or were added during the last two hours.
--modifiedSince=PT2H --startDt=2010-11-01 --endDt=2010-11-02
# Retrieve all values for sites and period of record
# requested for sites and parameters that had values
# change between midnight site local time on Nov 1st,
# 2010 and 23:59 on Nov 2nd, 2010 site local time,
# only if values were changed or added within the
# last two hours.
--parameterCd PARAMETERCD
[optional, default is None, minor site filter]
USGS time-series parameter code. All parameter codes are numeric and 5
characters in length. Parameter codes are used to identify the
constituent measured and the units of measure. Popular codes include
stage (00065), discharge in cubic feet per second (00060) and water
temperature in degrees Celsius (00010). Can request from 1 to 100
"parameterCD"s. Default: returns all regular time-series for the
requested sites.
Complete list:
http://help.waterdata.usgs.gov/codes-and-parameters/parameters::
--parameterCd=00060 # discharge, cubic feet
# per second
--parameterCd=00060,00065 # discharge,
# cubic feet per second
# and gage height in
# feet
--siteStatus SITESTATUS
[optional, default is None, minor site filter]
Selects sites based on whether or not they are active. If a site is
active, it implies that it is being actively maintained. A site is
considered active if: it has collected time-series (automated) data
within the last 183 days (6 months), or it has collected discrete
(manually collected) data within 397 days (13 months) If it does not
meet these criteria, it is considered inactive. Some exceptions
apply. If a site is flagged by a USGS water science center as
discontinued, it will show as inactive. A USGS science center can
also flag a new site as active even if it has not collected any
data. The default is all (show both active and inactive sites).
Chose between, 'all', 'active', or 'inactive'. Default all - sites
of any activity status are returned.:
--siteStatus='active'
--siteType SITETYPE
[optional, default is None, minor site filter]
Restricts sites to those having one or more major and/or minor site types.
If you request a major site type (ex: &siteType=ST) you will get all
sub-site types of the same major type as well (in this case, ST-CA,
ST-DCH and ST-TS). Can have from 1 to an unlimited number of
siteType codes. Default is to return all types. List of valid site
types: <[4;36mhttp://help.waterdata.usgs.gov/site_tp_cd[0m>:
--siteType=ST # Streams only
--siteType=ST,LA-OU # Streams and Land Outcrops only
--wellDepthMax WELLDEPTHMAX
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
Providing a value to wellDepthMax (maximum well depth) means you want
sites that have or are less than the wellDepthMax value.:
--wellDepthMin=10.5 --wellDepthMax=10.7
# Return daily value sites where the well depth is
# 10.5 feet or greater and 10.7 feet or less.
If both the wellDepthMin and wellDepthMax are specified, sites at or
between the minimum and maximum well depth values specified are
returned wellDepthMax should be greater than or equal to
wellDepthMin.
--wellDepthMin WELLDEPTHMIN
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
These arguments allows you to select groundwater sites serving data
recorded automatically where the associated sites' well depth are
within a desired depth, expressed in feet from the land surface
datum. Express well depth as a positive number. Providing a value to
wellDepthMin (minimum well depth) means you want sites that have or
exceed the wellDepthMin value. The values may be expressed in
decimals Caution: well depth applies to groundwater sites only.:
--wellDepthMin=100 --wellDepthMax=500
# Return daily value sites where the well depth is
# 100 feet or greater and 500 feet or less.
--startDT STARTDT
[optional, default is None]
Get a range of values from an explicit begin or end date/time. Use the
startDT and endDT arguments. Site local time is output, even if
multiple sites are requested and sites are in different time zones.
Note that the measurement time zone at a site may not be the same as
the time zone actually in effect at the site.
Both startDt and endDt must be in ISO-8601 Date/Time format.
(<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Dates[0m>) You can express the
date and time in a timezone other than site local time if you want
as long as it follows the ISO standard. For example, you can express
the time in Universal time: 2014-03-20T00:00Z. If startDT is
supplied and endDT is not, endDT ends with the most recent
instantaneous value. startDT must be chronologically before endDT.
If startDt shows the date and not the time of day (ex: 2010-09-01) the
time of midnight site time is assumed (2010-09-01T00:00) If endDt
shows the date and not the time of day (ex: 2010-09-02) the last
minute before midnight site time is assumed (2010-09-02T23:59).
Remember, only data from October 1, 2007 are currently available in
the 'iv' database.
--endDT ENDDT
[optional, default is None]
If endDT is present, startDt must also be present.:
--startDT=2010-11-22 --endDT=2010-11-22 # Full day, 00:00 to 23:59
--startDT=2010-11-22T12:00 --endDT=2010-11-22T18:00
--startDT=2010-11-22 --endDT=2010-11-22
--startDT=2010-11-22T12:00 # From "startDT" to most recent
# instantaneous value
--period PERIOD
[optional, default is None]
Get a range of values from now by specifying the period argument period
must be in ISO-8601 Duration format.
(<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Durations[0m>) Negative periods
(ex: P-T2H) are not allowed. Data are always returned up to the most
recent value, which in the case of a predictive gage might be in the
future. When specifying days from now, the first value will probably
not be at midnight of the first day, but somewhat before exactly 24
hours from now.:
--period=PT2H
# Retrieve last two hours from now up to most recent
# instantaneous value)
--period=P7D
# Retrieve last seven days up from now to most recent
# instantaneous value)
--include_codes
[optional, default is False]
Whether or not to include the metadata/quality code column. Useful to
almost halve the size of the pandas DataFrame.
--statisticsCd STATISTICSCD
[optional, default is None]
The statisticsCd represents how the instantaneous values are aggregated.
The statisticsCd is from the following table:
┌───────┬────────────────────────────────────┐
│ Code │ Description │
╞═══════╪════════════════════════════════════╡
│ 00001 │ MAXIMUM VALUES │
├───────┼────────────────────────────────────┤
│ 00002 │ MINIMUM VALUES │
├───────┼────────────────────────────────────┤
│ 00003 │ MEAN VALUES │
├───────┼────────────────────────────────────┤
│ 00004 │ VALUES TAKEN BETWEEN 0001 AND 1200 │
├───────┼────────────────────────────────────┤
│ 00005 │ VALUES TAKEN BETWEEN 1201 AND 2400 │
├───────┼────────────────────────────────────┤
│ 00006 │ SUMMATION VALUES │
├───────┼────────────────────────────────────┤
│ 00007 │ MODAL VALUES │
├───────┼────────────────────────────────────┤
│ 00008 │ MEDIAN VALUES │
├───────┼────────────────────────────────────┤
│ 00009 │ STANDARD DEVIATION VALUES │
├───────┼────────────────────────────────────┤
│ 00010 │ VARIANCE VALUES │
├───────┼────────────────────────────────────┤
│ 00011 │ RANDOM INSTANTANEOUS VALUES │
├───────┼────────────────────────────────────┤
│ 00012 │ EQUIVALENT MEAN VALUES │
├───────┼────────────────────────────────────┤
│ 00013 │ SKEWNESS VALUES │
├───────┼────────────────────────────────────┤
│ 00021 │ TIDAL HIGH-HIGH VALUES │
├───────┼────────────────────────────────────┤
│ 00022 │ TIDAL LOW-HIGH VALUES │
├───────┼────────────────────────────────────┤
│ 00023 │ TIDAL HIGH-LOW VALUES │
├───────┼────────────────────────────────────┤
│ 00024 │ TIDAL LOW-LOW VALUES │
├───────┼────────────────────────────────────┤
│ 01XXY │ XX.Y PERCENTILE │
├───────┼────────────────────────────────────┤
│ 02LLL │ LLL DAY LOW MEAN │
├───────┼────────────────────────────────────┤
│ 03HHH │ HHH DAY HIGH MEAN │
├───────┼────────────────────────────────────┤
│ 3TTTT │ INSTANTANEOUS OBSERVATION AT TTTT │
╘═══════╧════════════════════════════════════╛
nwis_gwlevels¶
$ tsgettoolbox nwis_gwlevels --help
usage: tsgettoolbox nwis_gwlevels [-h] [--sites SITES] [--stateCd STATECD]
[--huc HUC] [--bBox BBOX] [--countyCd COUNTYCD] [--parameterCd PARAMETERCD]
[--period PERIOD] [--startDT STARTDT] [--endDT ENDDT] [--siteType SITETYPE]
[--modifiedSince MODIFIEDSINCE] [--agencyCd AGENCYCD] [--siteStatus
SITESTATUS] [--altMin ALTMIN] [--altMax ALTMAX] [--aquiferCd AQUIFERCD]
[--localAquiferCd LOCALAQUIFERCD] [--wellDepthMin WELLDEPTHMIN]
[--wellDepthMax WELLDEPTHMAX] [--holeDepthMin HOLEDEPTHMIN] [--holeDepthMax
HOLEDEPTHMAX]
Detailed documentation is available at <[4;36mhttp://waterdata.usgs.gov/nwis[0m>.
Site local time is output, even if multiple sites are requested and sites are in
different time zones. Note that the measurement time zone at a site may not be
the same as the time zone actually in effect at the site.
Every query requires a major filter. Pick the major filter ('--sites',
'--stateCd', '--huc', '--bBox', '--countyCd') that best retrieves the data for
the sites that you are interested in. You can have only one major filter per
query. If you specify more than one major filter, you will get an error.
[1mMajor Filter[0m
Select ONE of:
'--sites',
'--stateCd',
'--huc',
'--bBox', or
'--countyCd'
[1mMinor Filters[0m
Additional filters can be applied after specifying a major filter. This further
reduces the set of expected results. Users are encouraged to use minor filters
because it allows more efficient use of this service.
Use as many as desired to limit number of retrieved time series:
'--agencyCd',
'--altMax',
'--altMin',
'--aquiferCd',
'--drainAreaMax',
'--drainAreaMin',
'--holeDepthMax'
'--holeDepthMin',
'--localAquiferCd',
'--modifiedSince',
'--parameterCd',
'--siteStatus',
'--siteType',
'--wellDepthMax',
'--wellDepthMin',
[1mResults[0m
┌───────────────┬───────────────────────────────┐
│ Column │ Description │
╞═══════════════╪═══════════════════════════════╡
│ agency_cd │ Agency code │
├───────────────┼───────────────────────────────┤
│ site_no │ USGS site number │
├───────────────┼───────────────────────────────┤
│ site_tp_cd │ Site type code │
├───────────────┼───────────────────────────────┤
│ lev_dt │ Date level measured │
├───────────────┼───────────────────────────────┤
│ lev_tm │ Time level measured │
├───────────────┼───────────────────────────────┤
│ lev_tz_cd │ Time datum │
├───────────────┼───────────────────────────────┤
│ lev_va │ Water-level value in feet │
│ │ below land surface │
├───────────────┼───────────────────────────────┤
│ sl_lev_va │ Water-level value in feet │
│ │ above specific vertical datum │
├───────────────┼───────────────────────────────┤
│ sl_datum_cd │ Referenced vertical datum │
├───────────────┼───────────────────────────────┤
│ lev_status_cd │ Status │
├───────────────┼───────────────────────────────┤
│ lev_agency_cd │ Measuring agency │
╘═══════════════╧═══════════════════════════════╛
options:
-h | --help
show this help message and exit
--sites SITES
[optional, default is None, major site filter]
Want to only query one site? Use sites as your major filter, and put only
one site number in the list. Sites are comma separated. Sites may be
prefixed with an optional agency code followed by a colon. If you do
not know the site numbers you need, you can find relevant sites with
the NWIS Mapper (<[4;36mhttp://wdr.water.usgs.gov/nwisgmap/index.html[0m>) or
on the USGS Water Data for the Nation site.
(<[4;36mhttp://waterdata.usgs.gov/nwis/[0m>)
Can have from 1 to 100 comma separated site numbers:
--sites=USGS:01646500
--sites=01646500,06306300
--stateCd STATECD
[optional, default is None, major site filter]
U.S. postal service (2-digit) state code. Can have only 1 state code. List
is available at <[4;36mhttp://www.usps.com/ncsc/lookups/usps_abbre-
viations.html[0m>:
--stateCd=NY
--huc HUC
[optional, default is None, major site filter]
A list of hydrologic unit codes (HUC) or watersheds. Only 1 major HUC can
be specified per request. A major HUC has two digits. Minor HUCs
must be eight digits in length. Can have 1 to 10 HUC codes. List of
HUCs is available at <[4;36mhttp://water.usgs.gov/GIS/huc_name.html[0m>:
--huc=01,02070010
--bBox BBOX
[optional, default is None, major site filter]
A contiguous range of decimal latitude and longitude, starting with the
west longitude, then the south latitude, then the east longitude,
and then the north latitude with each value separated by a comma.
The product of the range of latitude and longitude cannot exceed 25
degrees. Whole or decimal degrees must be specified, up to six
digits of precision. Minutes and seconds are not allowed. Remember:
western longitude (which includes almost all of the United States)
is specified in negative degrees. Caution: many sites outside the
continental US do not have latitude and longitude referenced to
NAD83 and therefore can not be found using these arguments. Certain
sites are not associated with latitude and longitude due to homeland
security concerns and cannot be found using this filter.:
--bBox=-83,36.5,-81,38.5
--countyCd COUNTYCD
[optional, default is None, major site filter]
A list of county numbers, in a 5 digit numeric format. The first two
digits of a county's code are the FIPS State Code. Can have from 1
to 20 county codes. The first 2 digits are the FIPS State Code
(<[4;36mhttp://www.itl.nist.gov/fipspubs/fip5-2.htm[0m>) and the list of
county codes are at <[4;36mhttp://help.waterdata.usgs.gov/code/cou-
nty_query?fmt=html[0m>:
--countyCd=51059,51061
--parameterCd PARAMETERCD
[optional, default is None, minor site filter]
USGS time-series parameter code. All parameter codes are numeric and 5
characters in length. Parameter codes are used to identify the
constituent measured and the units of measure. Popular codes include
stage (00065), discharge in cubic feet per second (00060) and water
temperature in degrees Celsius (00010). Can request from 1 to 100
"parameterCD"s. Default: returns all regular time-series for the
requested sites.
Complete list:
http://help.waterdata.usgs.gov/codes-and-parameters/parameters::
--parameterCd=00060 # discharge, cubic feet
# per second
--parameterCd=00060,00065 # discharge,
# cubic feet per second
# and gage height in
# feet
--period PERIOD
[optional, default is None]
Get a range of values from now by specifying the period argument period
must be in ISO-8601 Duration format.
(<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Durations[0m>) Negative periods
(ex: P-T2H) are not allowed. Data are always returned up to the most
recent value, which in the case of a predictive gage might be in the
future. When specifying days from now, the first value will probably
not be at midnight of the first day, but somewhat before exactly 24
hours from now.:
--period=PT2H
# Retrieve last two hours from now up to most recent
# instantaneous value)
--period=P7D
# Retrieve last seven days up from now to most recent
# instantaneous value)
--startDT STARTDT
[optional, default is None]
Get a range of values from an explicit begin or end date/time. Use the
startDT and endDT arguments. Site local time is output, even if
multiple sites are requested and sites are in different time zones.
Note that the measurement time zone at a site may not be the same as
the time zone actually in effect at the site.
Both startDt and endDt must be in ISO-8601 Date/Time format.
(<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Dates[0m>) You can express the
date and time in a timezone other than site local time if you want
as long as it follows the ISO standard. For example, you can express
the time in Universal time: 2014-03-20T00:00Z. If startDT is
supplied and endDT is not, endDT ends with the most recent
instantaneous value. startDT must be chronologically before endDT.
If startDt shows the date and not the time of day (ex: 2010-09-01) the
time of midnight site time is assumed (2010-09-01T00:00) If endDt
shows the date and not the time of day (ex: 2010-09-02) the last
minute before midnight site time is assumed (2010-09-02T23:59).
Remember, only data from October 1, 2007 are currently available in
the 'iv' database.
--endDT ENDDT
[optional, default is None]
If endDT is present, startDt must also be present.:
--startDT=2010-11-22 --endDT=2010-11-22 # Full day, 00:00 to 23:59
--startDT=2010-11-22T12:00 --endDT=2010-11-22T18:00
--startDT=2010-11-22 --endDT=2010-11-22
--startDT=2010-11-22T12:00 # From "startDT" to most recent
# instantaneous value
--siteType SITETYPE
[optional, default is None, minor site filter]
Restricts sites to those having one or more major and/or minor site types.
If you request a major site type (ex: &siteType=ST) you will get all
sub-site types of the same major type as well (in this case, ST-CA,
ST-DCH and ST-TS). Can have from 1 to an unlimited number of
siteType codes. Default is to return all types. List of valid site
types: <[4;36mhttp://help.waterdata.usgs.gov/site_tp_cd[0m>:
--siteType=ST # Streams only
--siteType=ST,LA-OU # Streams and Land Outcrops only
--modifiedSince MODIFIEDSINCE
[optional, default is None, minor site filter]
Returns all values for sites and period of record requested only if any
values have changed over the last modifiedSince period.
modifiedSince is useful if you periodically need to poll a site but
are only interested in getting data if some of it has changed. It is
typically be used with period, or startDT/endDT but does not have to
be. In the latter case, if any values were changed during the
specified modifiedSince period, only the most recent values would be
retrieved for those sites. This is a typical usage, since users
typically are polling a site and only want data if there are new or
changed measurements. ISO-8601 duration format is always used. There
is no default. (<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Durations[0m>):
--modifiedSince=PT2H
# Retrieves all values for sites and period of record
# requested for any of the requested sites and
# parameters, but only for sites where any of the
# values changed during the last two hours.
--modifiedSince=PT2H --period=P1D
# Retrieve all values for sites and period of record
# requested for the last 24 hours from now only for
# sites and parameters that had any values that
# changed or were added during the last two hours.
--modifiedSince=PT2H --startDt=2010-11-01 --endDt=2010-11-02
# Retrieve all values for sites and period of record
# requested for sites and parameters that had values
# change between midnight site local time on Nov 1st,
# 2010 and 23:59 on Nov 2nd, 2010 site local time,
# only if values were changed or added within the
# last two hours.
--agencyCd AGENCYCD
[optional, default is None, minor site filter]
The list of sites returned are filtered to return only those with the
provided agency code. The agency code describes the organization
that maintains the site. Only one agency code is allowed and is
optional. An authoritative list of agency codes can be found here.
Default is to return all sites regardless of agency code. List:
<[4;36mhttp://help.waterdata.usgs.gov/code/agency_cd_query?fmt=html[0m>:
--stateCd=il --agencyCd=USCE # Only US Army Corps
# of Engineers sites
# in Illinois
--siteStatus SITESTATUS
[optional, default is None, minor site filter]
Selects sites based on whether or not they are active. If a site is
active, it implies that it is being actively maintained. A site is
considered active if: it has collected time-series (automated) data
within the last 183 days (6 months), or it has collected discrete
(manually collected) data within 397 days (13 months) If it does not
meet these criteria, it is considered inactive. Some exceptions
apply. If a site is flagged by a USGS water science center as
discontinued, it will show as inactive. A USGS science center can
also flag a new site as active even if it has not collected any
data. The default is all (show both active and inactive sites).
Chose between, 'all', 'active', or 'inactive'. Default all - sites
of any activity status are returned.:
--siteStatus='active'
--altMin ALTMIN
[optional, default is None, minor site filter]
These arguments allows you to select instantaneous values sites where the
associated sites' altitude are within a desired altitude, expressed
in feet. Altitude is based on the datum used at the site. Providing
a value to altMin (minimum altitude) means you want sites that have
or exceed the altMin value. You may specify decimal feet if
precision is critical If both the altMin and altMax are specified,
sites at or between the minimum and maximum altitude are returned.
--altMax ALTMAX
[optional, default is None, minor site filter]
Providing a value to altMax (maximum altitude) means you want sites that
have or are less than the altMax value.:
--altMin=1000 --altMax=5000
# Return sites where the altitude is 1000 feet or
# greater and 5000 feet or less.
--altMin=12.5 --altMax=13
# Return sites where the altitude is 12.5 feet or
# greater and 13 feet or less.
--aquiferCd AQUIFERCD
[optional, default is None, minor site filter]
Used to filter sites to those that exist in specified national aquifers.
Note: not all sites have been associated with national aquifers.
Enter one or more national aquifer codes, separated by commas. A
national aquifer code is exactly 10 characters. You can have up to
1000 aquiferCd codes. Complete list:
<[4;36mhttp://water.usgs.gov/ogw/NatlAqCode-reflist.html[0m>:
--aquiferCd=S500EDRTRN,N100HGHPLN
# returns groundwater sites for the
# Edwards-Trinity aquifer system and
# the High Plains national
# aquifers.
--localAquiferCd LOCALAQUIFERCD
[optional, default is None, minor site filter]
Used to filter sites to those that exist in specified local aquifers.
Note: not all sites have been associated with local aquifers. Enter
one or more local aquifer codes, separated by commas. A local
aquifer code begins with a 2 character state abbreviation (such as
TX for Texas) followed by a colon followed by the 7 character
aquifer code. Can have 0 to 1000 comma delimited codes. Complete
list: <[4;36mhttp://help.waterdata.usgs.gov/code/aqfr_cd_query?fmt=html[0m>
To translate state codes associated with the local aquifer you may
need this reference: <[4;36mhttp://www.itl.nist.gov/fipspubs/fip5-2.htm[0m>
--localAquiferCd=AL:111RGLT,AL:111RSDM
# returns sites for the Regolith and Saprolite local
# aquifers in Alabama
--wellDepthMin WELLDEPTHMIN
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
These arguments allows you to select groundwater sites serving data
recorded automatically where the associated sites' well depth are
within a desired depth, expressed in feet from the land surface
datum. Express well depth as a positive number. Providing a value to
wellDepthMin (minimum well depth) means you want sites that have or
exceed the wellDepthMin value. The values may be expressed in
decimals Caution: well depth applies to groundwater sites only.:
--wellDepthMin=100 --wellDepthMax=500
# Return daily value sites where the well depth is
# 100 feet or greater and 500 feet or less.
--wellDepthMax WELLDEPTHMAX
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
Providing a value to wellDepthMax (maximum well depth) means you want
sites that have or are less than the wellDepthMax value.:
--wellDepthMin=10.5 --wellDepthMax=10.7
# Return daily value sites where the well depth is
# 10.5 feet or greater and 10.7 feet or less.
If both the wellDepthMin and wellDepthMax are specified, sites at or
between the minimum and maximum well depth values specified are
returned wellDepthMax should be greater than or equal to
wellDepthMin.
--holeDepthMin HOLEDEPTHMIN
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
These arguments allows you to select groundwater sites serving data
recorded automatically where the associated sites' hole depth are
within a desired depth, expressed in feet from the land surface
datum. Express hole depth as a positive number. Providing a value to
holeDepthMin (minimum hole depth) means you want sites that have or
exceed the holeDepthMin value. The values may be expressed in
decimals Caution: hole depth applies to groundwater sites only.
--holeDepthMax HOLEDEPTHMAX
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
Providing a value to holeDepthMax (maximum hole depth) means you want
sites that have or are less than the holeDepthMax value.:
--holeDepthMin=100 --holeDepthMax=500
# Return daily values sites where the hole depth is
# 100 feet or greater and 500 feet or less.
--holeDepthMin=10.5 --holeDepthMax=10.7
# Return daily value sites where the hole depth is
# 10.5 feet or greater and 10.7 feet or less.
If both the holeDepthMin and holeDepthMax are specified, sites at or
between the minimum and maximum hole depth values specified are
returned holeDepthMax should be greater than or equal to
holeDepthMin.
nwis_iv¶
$ tsgettoolbox nwis_iv --help
usage: tsgettoolbox nwis_iv [-h] [--sites SITES] [--stateCd STATECD]
[--huc HUC] [--bBox BBOX] [--countyCd COUNTYCD] [--parameterCd PARAMETERCD]
[--siteType SITETYPE] [--modifiedSince MODIFIEDSINCE] [--agencyCd AGENCYCD]
[--siteStatus SITESTATUS] [--altMin ALTMIN] [--altMax ALTMAX]
[--drainAreaMin DRAINAREAMIN] [--drainAreaMax DRAINAREAMAX] [--aquiferCd
AQUIFERCD] [--localAquiferCd LOCALAQUIFERCD] [--wellDepthMin WELLDEPTHMIN]
[--wellDepthMax WELLDEPTHMAX] [--holeDepthMin HOLEDEPTHMIN] [--holeDepthMax
HOLEDEPTHMAX] [--period PERIOD] [--startDT STARTDT] [--endDT ENDDT]
[--include_codes]
Detailed documentation is available at <[4;36mhttp://waterdata.usgs.gov/nwis[0m>.
Site local time is output, even if multiple sites are requested and sites are in
different time zones. Note that the measurement time zone at a site may not be
the same as the time zone actually in effect at the site.
Every query requires a major filter. Pick the major filter ('--sites',
'--stateCd', '--huc', '--bBox', '--countyCd') that best retrieves the data for
the sites that you are interested in. You can have only one major filter per
query. If you specify more than one major filter, you will get an error.
[1mMajor Filter[0m
Select ONE of:
'--sites',
'--stateCd',
'--huc',
'--bBox', or
'--countyCd'
[1mMinor Filters[0m
Additional filters can be applied after specifying a major filter. This further
reduces the set of expected results. Users are encouraged to use minor filters
because it allows more efficient use of this service.
Use as many as desired to limit number of retrieved time series:
'--agencyCd',
'--altMax',
'--altMin',
'--aquiferCd',
'--drainAreaMax',
'--drainAreaMin',
'--holeDepthMax'
'--holeDepthMin',
'--localAquiferCd',
'--modifiedSince',
'--parameterCd',
'--siteStatus',
'--siteType',
'--wellDepthMax',
'--wellDepthMin',
[1mResults[0m
The column name in the resulting table is made up of
"agencyCd_siteno_parameterCd", for example "USGS_02248380_00010". The agency and
parameter codes are described in the agencyCd and parameterCd options below.
If include_codes option is used, there will also be columns representing the
data quality codes named "agencyCd_siteno_parameterCd_cd".
┌─────────┬────────────────────────────────────────────────────────┐
│ Code │ Description │
╞═════════╪════════════════════════════════════════════════════════╡
│ e │ Value has been edited or estimated by USGS personnel │
│ │ and is write protected │
├─────────┼────────────────────────────────────────────────────────┤
│ & │ Value was computed from affected unit values │
├─────────┼────────────────────────────────────────────────────────┤
│ E │ Value was computed from estimated unit values. │
├─────────┼────────────────────────────────────────────────────────┤
│ A │ Approved for publication -- Processing and review │
│ │ completed. │
├─────────┼────────────────────────────────────────────────────────┤
│ P │ Provisional data subject to revision. │
├─────────┼────────────────────────────────────────────────────────┤
│ < │ The value is known to be less than reported value and │
│ │ is write protected. │
├─────────┼────────────────────────────────────────────────────────┤
│ > │ The value is known to be greater than reported value │
│ │ and is write protected. │
├─────────┼────────────────────────────────────────────────────────┤
│ 1 │ Value is write protected without any remark code to be │
│ │ printed │
├─────────┼────────────────────────────────────────────────────────┤
│ 2 │ Remark is write protected without any remark code to │
│ │ be printed │
├─────────┼────────────────────────────────────────────────────────┤
│ │ No remark (blank) │
├─────────┼────────────────────────────────────────────────────────┤
│ Ssn │ Parameter monitored seasonally │
├─────────┼────────────────────────────────────────────────────────┤
│ Ice │ Ice affected │
├─────────┼────────────────────────────────────────────────────────┤
│ Pr │ Partial-record site │
├─────────┼────────────────────────────────────────────────────────┤
│ Rat │ Rating being developed or revised │
├─────────┼────────────────────────────────────────────────────────┤
│ Eqp │ Equipment malfunction │
├─────────┼────────────────────────────────────────────────────────┤
│ Fld │ Flood damage │
├─────────┼────────────────────────────────────────────────────────┤
│ Dis │ Data-collection discontinued │
├─────────┼────────────────────────────────────────────────────────┤
│ Dry │ Dry │
├─────────┼────────────────────────────────────────────────────────┤
│ -- │ Parameter not determined │
├─────────┼────────────────────────────────────────────────────────┤
│ Mnt │ Maintenance in progress │
├─────────┼────────────────────────────────────────────────────────┤
│ ZFl │ Zero flow │
├─────────┼────────────────────────────────────────────────────────┤
│ *** │ Temporarily unavailable │
╘═════════╧════════════════════════════════════════════════════════╛
options:
-h | --help
show this help message and exit
--sites SITES
[optional, default is None, major site filter]
Want to only query one site? Use sites as your major filter, and put only
one site number in the list. Sites are comma separated. Sites may be
prefixed with an optional agency code followed by a colon. If you do
not know the site numbers you need, you can find relevant sites with
the NWIS Mapper (<[4;36mhttp://wdr.water.usgs.gov/nwisgmap/index.html[0m>) or
on the USGS Water Data for the Nation site.
(<[4;36mhttp://waterdata.usgs.gov/nwis/[0m>)
Can have from 1 to 100 comma separated site numbers:
--sites=USGS:01646500
--sites=01646500,06306300
--stateCd STATECD
[optional, default is None, major site filter]
U.S. postal service (2-digit) state code. Can have only 1 state code. List
is available at <[4;36mhttp://www.usps.com/ncsc/lookups/usps_abbre-
viations.html[0m>:
--stateCd=NY
--huc HUC
[optional, default is None, major site filter]
A list of hydrologic unit codes (HUC) or watersheds. Only 1 major HUC can
be specified per request. A major HUC has two digits. Minor HUCs
must be eight digits in length. Can have 1 to 10 HUC codes. List of
HUCs is available at <[4;36mhttp://water.usgs.gov/GIS/huc_name.html[0m>:
--huc=01,02070010
--bBox BBOX
[optional, default is None, major site filter]
A contiguous range of decimal latitude and longitude, starting with the
west longitude, then the south latitude, then the east longitude,
and then the north latitude with each value separated by a comma.
The product of the range of latitude and longitude cannot exceed 25
degrees. Whole or decimal degrees must be specified, up to six
digits of precision. Minutes and seconds are not allowed. Remember:
western longitude (which includes almost all of the United States)
is specified in negative degrees. Caution: many sites outside the
continental US do not have latitude and longitude referenced to
NAD83 and therefore can not be found using these arguments. Certain
sites are not associated with latitude and longitude due to homeland
security concerns and cannot be found using this filter.:
--bBox=-83,36.5,-81,38.5
--countyCd COUNTYCD
[optional, default is None, major site filter]
A list of county numbers, in a 5 digit numeric format. The first two
digits of a county's code are the FIPS State Code. Can have from 1
to 20 county codes. The first 2 digits are the FIPS State Code
(<[4;36mhttp://www.itl.nist.gov/fipspubs/fip5-2.htm[0m>) and the list of
county codes are at <[4;36mhttp://help.waterdata.usgs.gov/code/cou-
nty_query?fmt=html[0m>:
--countyCd=51059,51061
--parameterCd PARAMETERCD
[optional, default is None, minor site filter]
USGS time-series parameter code. All parameter codes are numeric and 5
characters in length. Parameter codes are used to identify the
constituent measured and the units of measure. Popular codes include
stage (00065), discharge in cubic feet per second (00060) and water
temperature in degrees Celsius (00010). Can request from 1 to 100
"parameterCD"s. Default: returns all regular time-series for the
requested sites.
Complete list:
http://help.waterdata.usgs.gov/codes-and-parameters/parameters::
--parameterCd=00060 # discharge, cubic feet
# per second
--parameterCd=00060,00065 # discharge,
# cubic feet per second
# and gage height in
# feet
--siteType SITETYPE
[optional, default is None, minor site filter]
Restricts sites to those having one or more major and/or minor site types.
If you request a major site type (ex: &siteType=ST) you will get all
sub-site types of the same major type as well (in this case, ST-CA,
ST-DCH and ST-TS). Can have from 1 to an unlimited number of
siteType codes. Default is to return all types. List of valid site
types: <[4;36mhttp://help.waterdata.usgs.gov/site_tp_cd[0m>:
--siteType=ST # Streams only
--siteType=ST,LA-OU # Streams and Land Outcrops only
--modifiedSince MODIFIEDSINCE
[optional, default is None, minor site filter]
Returns all values for sites and period of record requested only if any
values have changed over the last modifiedSince period.
modifiedSince is useful if you periodically need to poll a site but
are only interested in getting data if some of it has changed. It is
typically be used with period, or startDT/endDT but does not have to
be. In the latter case, if any values were changed during the
specified modifiedSince period, only the most recent values would be
retrieved for those sites. This is a typical usage, since users
typically are polling a site and only want data if there are new or
changed measurements. ISO-8601 duration format is always used. There
is no default. (<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Durations[0m>):
--modifiedSince=PT2H
# Retrieves all values for sites and period of record
# requested for any of the requested sites and
# parameters, but only for sites where any of the
# values changed during the last two hours.
--modifiedSince=PT2H --period=P1D
# Retrieve all values for sites and period of record
# requested for the last 24 hours from now only for
# sites and parameters that had any values that
# changed or were added during the last two hours.
--modifiedSince=PT2H --startDt=2010-11-01 --endDt=2010-11-02
# Retrieve all values for sites and period of record
# requested for sites and parameters that had values
# change between midnight site local time on Nov 1st,
# 2010 and 23:59 on Nov 2nd, 2010 site local time,
# only if values were changed or added within the
# last two hours.
--agencyCd AGENCYCD
[optional, default is None, minor site filter]
The list of sites returned are filtered to return only those with the
provided agency code. The agency code describes the organization
that maintains the site. Only one agency code is allowed and is
optional. An authoritative list of agency codes can be found here.
Default is to return all sites regardless of agency code. List:
<[4;36mhttp://help.waterdata.usgs.gov/code/agency_cd_query?fmt=html[0m>:
--stateCd=il --agencyCd=USCE # Only US Army Corps
# of Engineers sites
# in Illinois
--siteStatus SITESTATUS
[optional, default is None, minor site filter]
Selects sites based on whether or not they are active. If a site is
active, it implies that it is being actively maintained. A site is
considered active if: it has collected time-series (automated) data
within the last 183 days (6 months), or it has collected discrete
(manually collected) data within 397 days (13 months) If it does not
meet these criteria, it is considered inactive. Some exceptions
apply. If a site is flagged by a USGS water science center as
discontinued, it will show as inactive. A USGS science center can
also flag a new site as active even if it has not collected any
data. The default is all (show both active and inactive sites).
Chose between, 'all', 'active', or 'inactive'. Default all - sites
of any activity status are returned.:
--siteStatus='active'
--altMin ALTMIN
[optional, default is None, minor site filter]
These arguments allows you to select instantaneous values sites where the
associated sites' altitude are within a desired altitude, expressed
in feet. Altitude is based on the datum used at the site. Providing
a value to altMin (minimum altitude) means you want sites that have
or exceed the altMin value. You may specify decimal feet if
precision is critical If both the altMin and altMax are specified,
sites at or between the minimum and maximum altitude are returned.
--altMax ALTMAX
[optional, default is None, minor site filter]
Providing a value to altMax (maximum altitude) means you want sites that
have or are less than the altMax value.:
--altMin=1000 --altMax=5000
# Return sites where the altitude is 1000 feet or
# greater and 5000 feet or less.
--altMin=12.5 --altMax=13
# Return sites where the altitude is 12.5 feet or
# greater and 13 feet or less.
--drainAreaMin DRAINAREAMIN
[optional, default is None, minor site filter]
SURFACE WATER SITE ATTRIBUTE
These arguments allows you to select principally surface water sites where
the associated sites' drainage areas (watersheds) are within a
desired size, expressed in square miles or decimal fractions
thereof. Providing a value to drainAreaMin (minimum drainage area)
means you want sites that have or exceed the drainAreaMin value. The
values may be expressed in decimals. If both the drainAreaMin and
drainAreaMax are specified, sites at or between the minimum and
maximum drainage areas values specified are returned Caution: not
all sites are associated with a drainage area. Caution: drainage
area generally only applies to surface water sites. Use with other
site types, such as groundwater sites, will likely retrieve no
results.
--drainAreaMax DRAINAREAMAX
[optional, default is None, minor site filter]
SURFACE WATER SITE ATTRIBUTE
Providing a value to drainAreaMax (maximum drainage area) means you want
sites that have or are less than the drainAreaMax value.:
--drainAreaMin=1000 --drainAreaMax=5000
# Return sites where the drainage area
# is 1000 square miles or greater and
# is 5000 square miles or less.
--drainAreaMin=10.5 --drainAreaMax=10.7
# Return sites where the drainage area
# is 10.5 square miles or greater and
# is 10.7 square miles or less.
--aquiferCd AQUIFERCD
[optional, default is None, minor site filter]
Used to filter sites to those that exist in specified national aquifers.
Note: not all sites have been associated with national aquifers.
Enter one or more national aquifer codes, separated by commas. A
national aquifer code is exactly 10 characters. You can have up to
1000 aquiferCd codes. Complete list:
<[4;36mhttp://water.usgs.gov/ogw/NatlAqCode-reflist.html[0m>:
--aquiferCd=S500EDRTRN,N100HGHPLN
# returns groundwater sites for the
# Edwards-Trinity aquifer system and
# the High Plains national
# aquifers.
--localAquiferCd LOCALAQUIFERCD
[optional, default is None, minor site filter]
Used to filter sites to those that exist in specified local aquifers.
Note: not all sites have been associated with local aquifers. Enter
one or more local aquifer codes, separated by commas. A local
aquifer code begins with a 2 character state abbreviation (such as
TX for Texas) followed by a colon followed by the 7 character
aquifer code. Can have 0 to 1000 comma delimited codes. Complete
list: <[4;36mhttp://help.waterdata.usgs.gov/code/aqfr_cd_query?fmt=html[0m>
To translate state codes associated with the local aquifer you may
need this reference: <[4;36mhttp://www.itl.nist.gov/fipspubs/fip5-2.htm[0m>
--localAquiferCd=AL:111RGLT,AL:111RSDM
# returns sites for the Regolith and Saprolite local
# aquifers in Alabama
--wellDepthMin WELLDEPTHMIN
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
These arguments allows you to select groundwater sites serving data
recorded automatically where the associated sites' well depth are
within a desired depth, expressed in feet from the land surface
datum. Express well depth as a positive number. Providing a value to
wellDepthMin (minimum well depth) means you want sites that have or
exceed the wellDepthMin value. The values may be expressed in
decimals Caution: well depth applies to groundwater sites only.:
--wellDepthMin=100 --wellDepthMax=500
# Return daily value sites where the well depth is
# 100 feet or greater and 500 feet or less.
--wellDepthMax WELLDEPTHMAX
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
Providing a value to wellDepthMax (maximum well depth) means you want
sites that have or are less than the wellDepthMax value.:
--wellDepthMin=10.5 --wellDepthMax=10.7
# Return daily value sites where the well depth is
# 10.5 feet or greater and 10.7 feet or less.
If both the wellDepthMin and wellDepthMax are specified, sites at or
between the minimum and maximum well depth values specified are
returned wellDepthMax should be greater than or equal to
wellDepthMin.
--holeDepthMin HOLEDEPTHMIN
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
These arguments allows you to select groundwater sites serving data
recorded automatically where the associated sites' hole depth are
within a desired depth, expressed in feet from the land surface
datum. Express hole depth as a positive number. Providing a value to
holeDepthMin (minimum hole depth) means you want sites that have or
exceed the holeDepthMin value. The values may be expressed in
decimals Caution: hole depth applies to groundwater sites only.
--holeDepthMax HOLEDEPTHMAX
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
Providing a value to holeDepthMax (maximum hole depth) means you want
sites that have or are less than the holeDepthMax value.:
--holeDepthMin=100 --holeDepthMax=500
# Return daily values sites where the hole depth is
# 100 feet or greater and 500 feet or less.
--holeDepthMin=10.5 --holeDepthMax=10.7
# Return daily value sites where the hole depth is
# 10.5 feet or greater and 10.7 feet or less.
If both the holeDepthMin and holeDepthMax are specified, sites at or
between the minimum and maximum hole depth values specified are
returned holeDepthMax should be greater than or equal to
holeDepthMin.
--period PERIOD
[optional, default is None]
Get a range of values from now by specifying the period argument period
must be in ISO-8601 Duration format.
(<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Durations[0m>) Negative periods
(ex: P-T2H) are not allowed. Data are always returned up to the most
recent value, which in the case of a predictive gage might be in the
future. When specifying days from now, the first value will probably
not be at midnight of the first day, but somewhat before exactly 24
hours from now.:
--period=PT2H
# Retrieve last two hours from now up to most recent
# instantaneous value)
--period=P7D
# Retrieve last seven days up from now to most recent
# instantaneous value)
--startDT STARTDT
[optional, default is None]
Get a range of values from an explicit begin or end date/time. Use the
startDT and endDT arguments. Site local time is output, even if
multiple sites are requested and sites are in different time zones.
Note that the measurement time zone at a site may not be the same as
the time zone actually in effect at the site.
Both startDt and endDt must be in ISO-8601 Date/Time format.
(<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Dates[0m>) You can express the
date and time in a timezone other than site local time if you want
as long as it follows the ISO standard. For example, you can express
the time in Universal time: 2014-03-20T00:00Z. If startDT is
supplied and endDT is not, endDT ends with the most recent
instantaneous value. startDT must be chronologically before endDT.
If startDt shows the date and not the time of day (ex: 2010-09-01) the
time of midnight site time is assumed (2010-09-01T00:00) If endDt
shows the date and not the time of day (ex: 2010-09-02) the last
minute before midnight site time is assumed (2010-09-02T23:59).
Remember, only data from October 1, 2007 are currently available in
the 'iv' database.
--endDT ENDDT
[optional, default is None]
If endDT is present, startDt must also be present.:
--startDT=2010-11-22 --endDT=2010-11-22 # Full day, 00:00 to 23:59
--startDT=2010-11-22T12:00 --endDT=2010-11-22T18:00
--startDT=2010-11-22 --endDT=2010-11-22
--startDT=2010-11-22T12:00 # From "startDT" to most recent
# instantaneous value
--include_codes
[optional, default is False]
Whether or not to include the metadata/quality code column. Useful to
almost halve the size of the pandas DataFrame.
nwis_measurements¶
$ tsgettoolbox nwis_measurements --help
usage: tsgettoolbox nwis_measurements [-h] [--sites SITES] [--stateCd STATECD]
[--huc HUC] [--bBox BBOX] [--countyCd COUNTYCD] [--parameterCd PARAMETERCD]
[--period PERIOD] [--startDT STARTDT] [--endDT ENDDT] [--siteType SITETYPE]
[--modifiedSince MODIFIEDSINCE] [--agencyCd AGENCYCD] [--siteStatus
SITESTATUS] [--altMin ALTMIN] [--altMax ALTMAX] [--aquiferCd AQUIFERCD]
[--localAquiferCd LOCALAQUIFERCD] [--wellDepthMin WELLDEPTHMIN]
[--wellDepthMax WELLDEPTHMAX] [--holeDepthMin HOLEDEPTHMIN] [--holeDepthMax
HOLEDEPTHMAX]
Detailed documentation is available at <[4;36mhttp://waterdata.usgs.gov/nwis[0m>.
Site local time is output, even if multiple sites are requested and sites are in
different time zones. Note that the measurement time zone at a site may not be
the same as the time zone actually in effect at the site.
Every query requires a major filter. Pick the major filter ('--sites',
'--stateCd', '--huc', '--bBox', '--countyCd') that best retrieves the data for
the sites that you are interested in. You can have only one major filter per
query. If you specify more than one major filter, you will get an error.
[1mMajor Filter[0m
Select ONE of:
'--sites',
'--stateCd',
'--huc',
'--bBox', or
'--countyCd'
[1mMinor Filters[0m
Additional filters can be applied after specifying a major filter. This further
reduces the set of expected results. Users are encouraged to use minor filters
because it allows more efficient use of this service.
Use as many as desired to limit number of retrieved time series:
'--agencyCd',
'--altMax',
'--altMin',
'--aquiferCd',
'--drainAreaMax',
'--drainAreaMin',
'--holeDepthMax'
'--holeDepthMin',
'--localAquiferCd',
'--modifiedSince',
'--parameterCd',
'--siteStatus',
'--siteType',
'--wellDepthMax',
'--wellDepthMin',
[1mResults[0m
┌───────────────────────────┬─────────────────────────────────────────┐
│ Column │ Description │
╞═══════════════════════════╪═════════════════════════════════════════╡
│ agency_cd │ Agency code │
├───────────────────────────┼─────────────────────────────────────────┤
│ site_no │ Site number │
├───────────────────────────┼─────────────────────────────────────────┤
│ measurement_nu │ Measurement number │
├───────────────────────────┼─────────────────────────────────────────┤
│ measurement_dt │ date of measurement (format = MMDDYYYY │
│ │ or Month/Day/Year. The user has options │
│ │ for the data output format) │
├───────────────────────────┼─────────────────────────────────────────┤
│ tz_cd │ Time zone offset. An ANSI SQL/92 time │
│ │ zone offset string. Some examples are │
│ │ '-07:00' (Eastern), '+02:00' (Eastern │
│ │ Europe), and '+03:30' (India). │
├───────────────────────────┼─────────────────────────────────────────┤
│ q_meas_used_fg │ Flag indicates if the discharge │
│ │ measurement is marked used. │
├───────────────────────────┼─────────────────────────────────────────┤
│ party_nm │ an indication of who made the │
│ │ measurement and is usually populated │
│ │ with a pair of initials separated with │
├───────────────────────────┼─a slash─────────────────────────────────┤
│ site_visit_coll_agency_cd │ What agency made the measurement at the │
│ │ site visit │
├───────────────────────────┼─────────────────────────────────────────┤
│ gage_height_va │ gage height as shown on the inside │
│ │ staff gage at the site or read off the │
│ │ recorder inside the gage house in feet │
├───────────────────────────┼─────────────────────────────────────────┤
│ discharge_va │ the computed discharge in cubic feet │
│ │ per second (cfs) │
├───────────────────────────┼─────────────────────────────────────────┤
│ measured_rating_diff │ measurement rating codes that denote │
│ │ the relative quality of the measurement │
├───────────────────────────┼─────────────────────────────────────────┤
│ gage_va_change │ The amount the gage height changed │
│ │ while the measurement was being made in │
├───────────────────────────┼─feet────────────────────────────────────┤
│ gage_va_time │ The amount of time elapsed while the │
│ │ measurement was being made in decimal │
│ │ hours │
├───────────────────────────┼─────────────────────────────────────────┤
│ control_type_cd │ condition of the rating control at the │
│ │ time of the measurement │
├───────────────────────────┼─────────────────────────────────────────┤
│ discharge_cd │ The adjustment code for the measured │
│ │ discharge │
├───────────────────────────┼─────────────────────────────────────────┤
│ chan_nu │ The channel number │
├───────────────────────────┼─────────────────────────────────────────┤
│ chan_name │ The channel name │
├───────────────────────────┼─────────────────────────────────────────┤
│ meas_type │ The channel measurement type │
├───────────────────────────┼─────────────────────────────────────────┤
│ streamflow_method │ The channel discharge measurement │
├───────────────────────────┼─method──────────────────────────────────┤
│ velocity_method │ The channel velocity measurement method │
├───────────────────────────┼─────────────────────────────────────────┤
│ chan_discharge │ The channel discharge in cubic feet per │
│ │ second │
├───────────────────────────┼─────────────────────────────────────────┤
│ chan_width │ The channel width in feet │
├───────────────────────────┼─────────────────────────────────────────┤
│ chan_area │ The channel area in square feet │
├───────────────────────────┼─────────────────────────────────────────┤
│ chan_velocity │ The mean velocity in feet per second │
├───────────────────────────┼─────────────────────────────────────────┤
│ chan_stability │ The stability of the channel material │
├───────────────────────────┼─────────────────────────────────────────┤
│ chan_material │ The channel material │
├───────────────────────────┼─────────────────────────────────────────┤
│ chan_evenness │ The channel evenness from bank to bank │
├───────────────────────────┼─────────────────────────────────────────┤
│ long_vel_desc │ The longitudinal velocity description │
├───────────────────────────┼─────────────────────────────────────────┤
│ horz_vel_desc │ The horizontal velocity description │
├───────────────────────────┼─────────────────────────────────────────┤
│ vert_vel_desc │ The vertical velocity description │
├───────────────────────────┼─────────────────────────────────────────┤
│ chan_loc_cd │ The channel location code │
├───────────────────────────┼─────────────────────────────────────────┤
│ chan_loc_dist │ The channel location distance │
╘═══════════════════════════╧═════════════════════════════════════════╛
<[4;36mhttps://help.waterdata.usgs.gov/output-formats#streamflow_measurement_data[0m>
options:
-h | --help
show this help message and exit
--sites SITES
[optional, default is None, major site filter]
Want to only query one site? Use sites as your major filter, and put only
one site number in the list. Sites are comma separated. Sites may be
prefixed with an optional agency code followed by a colon. If you do
not know the site numbers you need, you can find relevant sites with
the NWIS Mapper (<[4;36mhttp://wdr.water.usgs.gov/nwisgmap/index.html[0m>) or
on the USGS Water Data for the Nation site.
(<[4;36mhttp://waterdata.usgs.gov/nwis/[0m>)
Can have from 1 to 100 comma separated site numbers:
--sites=USGS:01646500
--sites=01646500,06306300
--stateCd STATECD
[optional, default is None, major site filter]
U.S. postal service (2-digit) state code. Can have only 1 state code. List
is available at <[4;36mhttp://www.usps.com/ncsc/lookups/usps_abbre-
viations.html[0m>:
--stateCd=NY
--huc HUC
[optional, default is None, major site filter]
A list of hydrologic unit codes (HUC) or watersheds. Only 1 major HUC can
be specified per request. A major HUC has two digits. Minor HUCs
must be eight digits in length. Can have 1 to 10 HUC codes. List of
HUCs is available at <[4;36mhttp://water.usgs.gov/GIS/huc_name.html[0m>:
--huc=01,02070010
--bBox BBOX
[optional, default is None, major site filter]
A contiguous range of decimal latitude and longitude, starting with the
west longitude, then the south latitude, then the east longitude,
and then the north latitude with each value separated by a comma.
The product of the range of latitude and longitude cannot exceed 25
degrees. Whole or decimal degrees must be specified, up to six
digits of precision. Minutes and seconds are not allowed. Remember:
western longitude (which includes almost all of the United States)
is specified in negative degrees. Caution: many sites outside the
continental US do not have latitude and longitude referenced to
NAD83 and therefore can not be found using these arguments. Certain
sites are not associated with latitude and longitude due to homeland
security concerns and cannot be found using this filter.:
--bBox=-83,36.5,-81,38.5
--countyCd COUNTYCD
[optional, default is None, major site filter]
A list of county numbers, in a 5 digit numeric format. The first two
digits of a county's code are the FIPS State Code. Can have from 1
to 20 county codes. The first 2 digits are the FIPS State Code
(<[4;36mhttp://www.itl.nist.gov/fipspubs/fip5-2.htm[0m>) and the list of
county codes are at <[4;36mhttp://help.waterdata.usgs.gov/code/cou-
nty_query?fmt=html[0m>:
--countyCd=51059,51061
--parameterCd PARAMETERCD
[optional, default is None, minor site filter]
USGS time-series parameter code. All parameter codes are numeric and 5
characters in length. Parameter codes are used to identify the
constituent measured and the units of measure. Popular codes include
stage (00065), discharge in cubic feet per second (00060) and water
temperature in degrees Celsius (00010). Can request from 1 to 100
"parameterCD"s. Default: returns all regular time-series for the
requested sites.
Complete list:
http://help.waterdata.usgs.gov/codes-and-parameters/parameters::
--parameterCd=00060 # discharge, cubic feet
# per second
--parameterCd=00060,00065 # discharge,
# cubic feet per second
# and gage height in
# feet
--period PERIOD
[optional, default is None]
Get a range of values from now by specifying the period argument period
must be in ISO-8601 Duration format.
(<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Durations[0m>) Negative periods
(ex: P-T2H) are not allowed. Data are always returned up to the most
recent value, which in the case of a predictive gage might be in the
future. When specifying days from now, the first value will probably
not be at midnight of the first day, but somewhat before exactly 24
hours from now.:
--period=PT2H
# Retrieve last two hours from now up to most recent
# instantaneous value)
--period=P7D
# Retrieve last seven days up from now to most recent
# instantaneous value)
--startDT STARTDT
[optional, default is None]
Get a range of values from an explicit begin or end date/time. Use the
startDT and endDT arguments. Site local time is output, even if
multiple sites are requested and sites are in different time zones.
Note that the measurement time zone at a site may not be the same as
the time zone actually in effect at the site.
Both startDt and endDt must be in ISO-8601 Date/Time format.
(<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Dates[0m>) You can express the
date and time in a timezone other than site local time if you want
as long as it follows the ISO standard. For example, you can express
the time in Universal time: 2014-03-20T00:00Z. If startDT is
supplied and endDT is not, endDT ends with the most recent
instantaneous value. startDT must be chronologically before endDT.
If startDt shows the date and not the time of day (ex: 2010-09-01) the
time of midnight site time is assumed (2010-09-01T00:00) If endDt
shows the date and not the time of day (ex: 2010-09-02) the last
minute before midnight site time is assumed (2010-09-02T23:59).
Remember, only data from October 1, 2007 are currently available in
the 'iv' database.
--endDT ENDDT
[optional, default is None]
If endDT is present, startDt must also be present.:
--startDT=2010-11-22 --endDT=2010-11-22 # Full day, 00:00 to 23:59
--startDT=2010-11-22T12:00 --endDT=2010-11-22T18:00
--startDT=2010-11-22 --endDT=2010-11-22
--startDT=2010-11-22T12:00 # From "startDT" to most recent
# instantaneous value
--siteType SITETYPE
[optional, default is None, minor site filter]
Restricts sites to those having one or more major and/or minor site types.
If you request a major site type (ex: &siteType=ST) you will get all
sub-site types of the same major type as well (in this case, ST-CA,
ST-DCH and ST-TS). Can have from 1 to an unlimited number of
siteType codes. Default is to return all types. List of valid site
types: <[4;36mhttp://help.waterdata.usgs.gov/site_tp_cd[0m>:
--siteType=ST # Streams only
--siteType=ST,LA-OU # Streams and Land Outcrops only
--modifiedSince MODIFIEDSINCE
[optional, default is None, minor site filter]
Returns all values for sites and period of record requested only if any
values have changed over the last modifiedSince period.
modifiedSince is useful if you periodically need to poll a site but
are only interested in getting data if some of it has changed. It is
typically be used with period, or startDT/endDT but does not have to
be. In the latter case, if any values were changed during the
specified modifiedSince period, only the most recent values would be
retrieved for those sites. This is a typical usage, since users
typically are polling a site and only want data if there are new or
changed measurements. ISO-8601 duration format is always used. There
is no default. (<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Durations[0m>):
--modifiedSince=PT2H
# Retrieves all values for sites and period of record
# requested for any of the requested sites and
# parameters, but only for sites where any of the
# values changed during the last two hours.
--modifiedSince=PT2H --period=P1D
# Retrieve all values for sites and period of record
# requested for the last 24 hours from now only for
# sites and parameters that had any values that
# changed or were added during the last two hours.
--modifiedSince=PT2H --startDt=2010-11-01 --endDt=2010-11-02
# Retrieve all values for sites and period of record
# requested for sites and parameters that had values
# change between midnight site local time on Nov 1st,
# 2010 and 23:59 on Nov 2nd, 2010 site local time,
# only if values were changed or added within the
# last two hours.
--agencyCd AGENCYCD
[optional, default is None, minor site filter]
The list of sites returned are filtered to return only those with the
provided agency code. The agency code describes the organization
that maintains the site. Only one agency code is allowed and is
optional. An authoritative list of agency codes can be found here.
Default is to return all sites regardless of agency code. List:
<[4;36mhttp://help.waterdata.usgs.gov/code/agency_cd_query?fmt=html[0m>:
--stateCd=il --agencyCd=USCE # Only US Army Corps
# of Engineers sites
# in Illinois
--siteStatus SITESTATUS
[optional, default is None, minor site filter]
Selects sites based on whether or not they are active. If a site is
active, it implies that it is being actively maintained. A site is
considered active if: it has collected time-series (automated) data
within the last 183 days (6 months), or it has collected discrete
(manually collected) data within 397 days (13 months) If it does not
meet these criteria, it is considered inactive. Some exceptions
apply. If a site is flagged by a USGS water science center as
discontinued, it will show as inactive. A USGS science center can
also flag a new site as active even if it has not collected any
data. The default is all (show both active and inactive sites).
Chose between, 'all', 'active', or 'inactive'. Default all - sites
of any activity status are returned.:
--siteStatus='active'
--altMin ALTMIN
[optional, default is None, minor site filter]
These arguments allows you to select instantaneous values sites where the
associated sites' altitude are within a desired altitude, expressed
in feet. Altitude is based on the datum used at the site. Providing
a value to altMin (minimum altitude) means you want sites that have
or exceed the altMin value. You may specify decimal feet if
precision is critical If both the altMin and altMax are specified,
sites at or between the minimum and maximum altitude are returned.
--altMax ALTMAX
[optional, default is None, minor site filter]
Providing a value to altMax (maximum altitude) means you want sites that
have or are less than the altMax value.:
--altMin=1000 --altMax=5000
# Return sites where the altitude is 1000 feet or
# greater and 5000 feet or less.
--altMin=12.5 --altMax=13
# Return sites where the altitude is 12.5 feet or
# greater and 13 feet or less.
--aquiferCd AQUIFERCD
[optional, default is None, minor site filter]
Used to filter sites to those that exist in specified national aquifers.
Note: not all sites have been associated with national aquifers.
Enter one or more national aquifer codes, separated by commas. A
national aquifer code is exactly 10 characters. You can have up to
1000 aquiferCd codes. Complete list:
<[4;36mhttp://water.usgs.gov/ogw/NatlAqCode-reflist.html[0m>:
--aquiferCd=S500EDRTRN,N100HGHPLN
# returns groundwater sites for the
# Edwards-Trinity aquifer system and
# the High Plains national
# aquifers.
--localAquiferCd LOCALAQUIFERCD
[optional, default is None, minor site filter]
Used to filter sites to those that exist in specified local aquifers.
Note: not all sites have been associated with local aquifers. Enter
one or more local aquifer codes, separated by commas. A local
aquifer code begins with a 2 character state abbreviation (such as
TX for Texas) followed by a colon followed by the 7 character
aquifer code. Can have 0 to 1000 comma delimited codes. Complete
list: <[4;36mhttp://help.waterdata.usgs.gov/code/aqfr_cd_query?fmt=html[0m>
To translate state codes associated with the local aquifer you may
need this reference: <[4;36mhttp://www.itl.nist.gov/fipspubs/fip5-2.htm[0m>
--localAquiferCd=AL:111RGLT,AL:111RSDM
# returns sites for the Regolith and Saprolite local
# aquifers in Alabama
--wellDepthMin WELLDEPTHMIN
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
These arguments allows you to select groundwater sites serving data
recorded automatically where the associated sites' well depth are
within a desired depth, expressed in feet from the land surface
datum. Express well depth as a positive number. Providing a value to
wellDepthMin (minimum well depth) means you want sites that have or
exceed the wellDepthMin value. The values may be expressed in
decimals Caution: well depth applies to groundwater sites only.:
--wellDepthMin=100 --wellDepthMax=500
# Return daily value sites where the well depth is
# 100 feet or greater and 500 feet or less.
--wellDepthMax WELLDEPTHMAX
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
Providing a value to wellDepthMax (maximum well depth) means you want
sites that have or are less than the wellDepthMax value.:
--wellDepthMin=10.5 --wellDepthMax=10.7
# Return daily value sites where the well depth is
# 10.5 feet or greater and 10.7 feet or less.
If both the wellDepthMin and wellDepthMax are specified, sites at or
between the minimum and maximum well depth values specified are
returned wellDepthMax should be greater than or equal to
wellDepthMin.
--holeDepthMin HOLEDEPTHMIN
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
These arguments allows you to select groundwater sites serving data
recorded automatically where the associated sites' hole depth are
within a desired depth, expressed in feet from the land surface
datum. Express hole depth as a positive number. Providing a value to
holeDepthMin (minimum hole depth) means you want sites that have or
exceed the holeDepthMin value. The values may be expressed in
decimals Caution: hole depth applies to groundwater sites only.
--holeDepthMax HOLEDEPTHMAX
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
Providing a value to holeDepthMax (maximum hole depth) means you want
sites that have or are less than the holeDepthMax value.:
--holeDepthMin=100 --holeDepthMax=500
# Return daily values sites where the hole depth is
# 100 feet or greater and 500 feet or less.
--holeDepthMin=10.5 --holeDepthMax=10.7
# Return daily value sites where the hole depth is
# 10.5 feet or greater and 10.7 feet or less.
If both the holeDepthMin and holeDepthMax are specified, sites at or
between the minimum and maximum hole depth values specified are
returned holeDepthMax should be greater than or equal to
holeDepthMin.
nwis_peak¶
$ tsgettoolbox nwis_peak --help
usage: tsgettoolbox nwis_peak [-h] [--sites SITES] [--stateCd STATECD]
[--huc HUC] [--bBox BBOX] [--countyCd COUNTYCD] [--parameterCd PARAMETERCD]
[--period PERIOD] [--startDT STARTDT] [--endDT ENDDT] [--siteType SITETYPE]
[--modifiedSince MODIFIEDSINCE] [--agencyCd AGENCYCD] [--siteStatus
SITESTATUS] [--altMin ALTMIN] [--altMax ALTMAX] [--aquiferCd AQUIFERCD]
[--localAquiferCd LOCALAQUIFERCD] [--wellDepthMin WELLDEPTHMIN]
[--wellDepthMax WELLDEPTHMAX] [--holeDepthMin HOLEDEPTHMIN] [--holeDepthMax
HOLEDEPTHMAX]
Detailed documentation is available at <[4;36mhttp://waterdata.usgs.gov/nwis[0m>.
Site local time is output, even if multiple sites are requested and sites are in
different time zones. Note that the measurement time zone at a site may not be
the same as the time zone actually in effect at the site.
Every query requires a major filter. Pick the major filter ('--sites',
'--stateCd', '--huc', '--bBox', '--countyCd') that best retrieves the data for
the sites that you are interested in. You can have only one major filter per
query. If you specify more than one major filter, you will get an error.
[1mMajor Filter[0m
Select ONE of:
'--sites',
'--stateCd',
'--huc',
'--bBox', or
'--countyCd'
[1mMinor Filters[0m
Additional filters can be applied after specifying a major filter. This further
reduces the set of expected results. Users are encouraged to use minor filters
because it allows more efficient use of this service.
Use as many as desired to limit number of retrieved time series:
'--agencyCd',
'--altMax',
'--altMin',
'--aquiferCd',
'--drainAreaMax',
'--drainAreaMin',
'--holeDepthMax'
'--holeDepthMin',
'--localAquiferCd',
'--modifiedSince',
'--parameterCd',
'--siteStatus',
'--siteType',
'--wellDepthMax',
'--wellDepthMin',
[1mResults[0m
┌───────────────┬────────────────────────────────────────────┐
│ Column │ Description │
╞═══════════════╪════════════════════════════════════════════╡
│ agency_cd │ Agency Code │
├───────────────┼────────────────────────────────────────────┤
│ site_no │ USGS station number │
├───────────────┼────────────────────────────────────────────┤
│ peak_dt │ Date of peak streamflow │
├───────────────┼─ (format YYYY-MM-DD)──────────────────────┤
│ peak_tm │ Time of peak streamflow │
├───────────────┼─ (24 hour format, 00:00 - 23:59)──────────┤
│ peak_va │ Annual peak streamflow value in cfs │
├───────────────┼────────────────────────────────────────────┤
│ peak_cd │ Peak Discharge-Qualification codes │
├───────────────┼─ (see explanation below)──────────────────┤
│ gage_ht │ Gage height for the associated peak │
├───────────────┼─ streamflow in feet───────────────────────┤
│ gage_ht_cd │ Gage height qualification codes │
├───────────────┼────────────────────────────────────────────┤
│ year_last_pk │ Peak streamflow reported is the highest │
├───────────────┼─ since this year──────────────────────────┤
│ ag_dt │ Date of maximum gage-height for water year │
├───────────────┼─ (if not concurrent with peak)────────────┤
│ ag_tm │ Time of maximum gage-height for water year │
├───────────────┼─ (if not concurrent with peak)────────────┤
│ ag_gage_ht │ maximum Gage height for water year in feet │
├───────────────┼─ (if not concurrent with peak)────────────┤
│ ag_gage_ht_cd │ maximum Gage height code │
╘═══════════════╧════════════════════════════════════════════╛
Peak Streamflow-Qualification Codes(peak_cd):
+---------+------------------------------------------------------+ | peak_cd |
Description | +=========+======================================================+
| 1 | Discharge is a Maximum Daily Average |
+---------+------------------------------------------------------+ | 2 |
Discharge is an Estimate | +---------+------------------------------------------
-------------+ | 3 | Discharge affected by Dam Failure |
+---------+------------------------------------------------------+ | 4 |
Discharge less than indicated value, | | | which is Minimum Recordable Discharge
at this site | +---------+------------------------------------------------------
-+ | 5 | Discharge affected to unknown degree by | | | Regulation or Diversion |
+---------+------------------------------------------------------+ | 6 |
Discharge affected by Regulation or Diversion |
+---------+------------------------------------------------------+ | 7 |
Discharge is an Historic Peak | +---------+-------------------------------------
------------------+ | 8 | Discharge actually greater than indicated value |
+---------+------------------------------------------------------+ | 9 |
Discharge due to Snowmelt, Hurricane, | | | Ice-Jam or Debris Dam breakup |
+---------+------------------------------------------------------+ | A | Year of
occurrence is unknown or not exact | +---------+--------------------------------
-----------------------+ | B | Month or Day of occurrence is unknown or not
exact | +---------+------------------------------------------------------+ | C |
All or part of the record affected by Urbanization, | | | Mining, Agricultural
changes, Channelization, | | | or other |
+---------+------------------------------------------------------+ | D | Base
Discharge changed during this year | +---------+--------------------------------
-----------------------+ | E | Only Annual Maximum Peak available for this year
| +---------+------------------------------------------------------+
Gage height qualification codes(gage_ht_cd,ag_gage_ht_cd):
+---------------+------------------------------------------------+ | gage_ht_cd
| Description | | ag_gage_ht_cd | | +===============+==========================-
======================+ | 1 | Gage height affected by backwater |
+---------------+------------------------------------------------+ | 2 | Gage
height not the maximum for the year | +---------------+-------------------------
------------------------+ | 3 | Gage height at different site and(or) datum |
+---------------+------------------------------------------------+ | 4 | Gage
height below minimum recordable elevation |
+---------------+------------------------------------------------+ | 5 | Gage
height is an estimate | +---------------+---------------------------------------
----------+ | 6 | Gage datum changed during this year |
+---------------+------------------------------------------------+
options:
-h | --help
show this help message and exit
--sites SITES
[optional, default is None, major site filter]
Want to only query one site? Use sites as your major filter, and put only
one site number in the list. Sites are comma separated. Sites may be
prefixed with an optional agency code followed by a colon. If you do
not know the site numbers you need, you can find relevant sites with
the NWIS Mapper (<[4;36mhttp://wdr.water.usgs.gov/nwisgmap/index.html[0m>) or
on the USGS Water Data for the Nation site.
(<[4;36mhttp://waterdata.usgs.gov/nwis/[0m>)
Can have from 1 to 100 comma separated site numbers:
--sites=USGS:01646500
--sites=01646500,06306300
--stateCd STATECD
[optional, default is None, major site filter]
U.S. postal service (2-digit) state code. Can have only 1 state code. List
is available at <[4;36mhttp://www.usps.com/ncsc/lookups/usps_abbre-
viations.html[0m>:
--stateCd=NY
--huc HUC
[optional, default is None, major site filter]
A list of hydrologic unit codes (HUC) or watersheds. Only 1 major HUC can
be specified per request. A major HUC has two digits. Minor HUCs
must be eight digits in length. Can have 1 to 10 HUC codes. List of
HUCs is available at <[4;36mhttp://water.usgs.gov/GIS/huc_name.html[0m>:
--huc=01,02070010
--bBox BBOX
[optional, default is None, major site filter]
A contiguous range of decimal latitude and longitude, starting with the
west longitude, then the south latitude, then the east longitude,
and then the north latitude with each value separated by a comma.
The product of the range of latitude and longitude cannot exceed 25
degrees. Whole or decimal degrees must be specified, up to six
digits of precision. Minutes and seconds are not allowed. Remember:
western longitude (which includes almost all of the United States)
is specified in negative degrees. Caution: many sites outside the
continental US do not have latitude and longitude referenced to
NAD83 and therefore can not be found using these arguments. Certain
sites are not associated with latitude and longitude due to homeland
security concerns and cannot be found using this filter.:
--bBox=-83,36.5,-81,38.5
--countyCd COUNTYCD
[optional, default is None, major site filter]
A list of county numbers, in a 5 digit numeric format. The first two
digits of a county's code are the FIPS State Code. Can have from 1
to 20 county codes. The first 2 digits are the FIPS State Code
(<[4;36mhttp://www.itl.nist.gov/fipspubs/fip5-2.htm[0m>) and the list of
county codes are at <[4;36mhttp://help.waterdata.usgs.gov/code/cou-
nty_query?fmt=html[0m>:
--countyCd=51059,51061
--parameterCd PARAMETERCD
[optional, default is None, minor site filter]
USGS time-series parameter code. All parameter codes are numeric and 5
characters in length. Parameter codes are used to identify the
constituent measured and the units of measure. Popular codes include
stage (00065), discharge in cubic feet per second (00060) and water
temperature in degrees Celsius (00010). Can request from 1 to 100
"parameterCD"s. Default: returns all regular time-series for the
requested sites.
Complete list:
http://help.waterdata.usgs.gov/codes-and-parameters/parameters::
--parameterCd=00060 # discharge, cubic feet
# per second
--parameterCd=00060,00065 # discharge,
# cubic feet per second
# and gage height in
# feet
--period PERIOD
[optional, default is None]
Get a range of values from now by specifying the period argument period
must be in ISO-8601 Duration format.
(<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Durations[0m>) Negative periods
(ex: P-T2H) are not allowed. Data are always returned up to the most
recent value, which in the case of a predictive gage might be in the
future. When specifying days from now, the first value will probably
not be at midnight of the first day, but somewhat before exactly 24
hours from now.:
--period=PT2H
# Retrieve last two hours from now up to most recent
# instantaneous value)
--period=P7D
# Retrieve last seven days up from now to most recent
# instantaneous value)
--startDT STARTDT
[optional, default is None]
Get a range of values from an explicit begin or end date/time. Use the
startDT and endDT arguments. Site local time is output, even if
multiple sites are requested and sites are in different time zones.
Note that the measurement time zone at a site may not be the same as
the time zone actually in effect at the site.
Both startDt and endDt must be in ISO-8601 Date/Time format.
(<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Dates[0m>) You can express the
date and time in a timezone other than site local time if you want
as long as it follows the ISO standard. For example, you can express
the time in Universal time: 2014-03-20T00:00Z. If startDT is
supplied and endDT is not, endDT ends with the most recent
instantaneous value. startDT must be chronologically before endDT.
If startDt shows the date and not the time of day (ex: 2010-09-01) the
time of midnight site time is assumed (2010-09-01T00:00) If endDt
shows the date and not the time of day (ex: 2010-09-02) the last
minute before midnight site time is assumed (2010-09-02T23:59).
Remember, only data from October 1, 2007 are currently available in
the 'iv' database.
--endDT ENDDT
[optional, default is None]
If endDT is present, startDt must also be present.:
--startDT=2010-11-22 --endDT=2010-11-22 # Full day, 00:00 to 23:59
--startDT=2010-11-22T12:00 --endDT=2010-11-22T18:00
--startDT=2010-11-22 --endDT=2010-11-22
--startDT=2010-11-22T12:00 # From "startDT" to most recent
# instantaneous value
--siteType SITETYPE
[optional, default is None, minor site filter]
Restricts sites to those having one or more major and/or minor site types.
If you request a major site type (ex: &siteType=ST) you will get all
sub-site types of the same major type as well (in this case, ST-CA,
ST-DCH and ST-TS). Can have from 1 to an unlimited number of
siteType codes. Default is to return all types. List of valid site
types: <[4;36mhttp://help.waterdata.usgs.gov/site_tp_cd[0m>:
--siteType=ST # Streams only
--siteType=ST,LA-OU # Streams and Land Outcrops only
--modifiedSince MODIFIEDSINCE
[optional, default is None, minor site filter]
Returns all values for sites and period of record requested only if any
values have changed over the last modifiedSince period.
modifiedSince is useful if you periodically need to poll a site but
are only interested in getting data if some of it has changed. It is
typically be used with period, or startDT/endDT but does not have to
be. In the latter case, if any values were changed during the
specified modifiedSince period, only the most recent values would be
retrieved for those sites. This is a typical usage, since users
typically are polling a site and only want data if there are new or
changed measurements. ISO-8601 duration format is always used. There
is no default. (<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Durations[0m>):
--modifiedSince=PT2H
# Retrieves all values for sites and period of record
# requested for any of the requested sites and
# parameters, but only for sites where any of the
# values changed during the last two hours.
--modifiedSince=PT2H --period=P1D
# Retrieve all values for sites and period of record
# requested for the last 24 hours from now only for
# sites and parameters that had any values that
# changed or were added during the last two hours.
--modifiedSince=PT2H --startDt=2010-11-01 --endDt=2010-11-02
# Retrieve all values for sites and period of record
# requested for sites and parameters that had values
# change between midnight site local time on Nov 1st,
# 2010 and 23:59 on Nov 2nd, 2010 site local time,
# only if values were changed or added within the
# last two hours.
--agencyCd AGENCYCD
[optional, default is None, minor site filter]
The list of sites returned are filtered to return only those with the
provided agency code. The agency code describes the organization
that maintains the site. Only one agency code is allowed and is
optional. An authoritative list of agency codes can be found here.
Default is to return all sites regardless of agency code. List:
<[4;36mhttp://help.waterdata.usgs.gov/code/agency_cd_query?fmt=html[0m>:
--stateCd=il --agencyCd=USCE # Only US Army Corps
# of Engineers sites
# in Illinois
--siteStatus SITESTATUS
[optional, default is None, minor site filter]
Selects sites based on whether or not they are active. If a site is
active, it implies that it is being actively maintained. A site is
considered active if: it has collected time-series (automated) data
within the last 183 days (6 months), or it has collected discrete
(manually collected) data within 397 days (13 months) If it does not
meet these criteria, it is considered inactive. Some exceptions
apply. If a site is flagged by a USGS water science center as
discontinued, it will show as inactive. A USGS science center can
also flag a new site as active even if it has not collected any
data. The default is all (show both active and inactive sites).
Chose between, 'all', 'active', or 'inactive'. Default all - sites
of any activity status are returned.:
--siteStatus='active'
--altMin ALTMIN
[optional, default is None, minor site filter]
These arguments allows you to select instantaneous values sites where the
associated sites' altitude are within a desired altitude, expressed
in feet. Altitude is based on the datum used at the site. Providing
a value to altMin (minimum altitude) means you want sites that have
or exceed the altMin value. You may specify decimal feet if
precision is critical If both the altMin and altMax are specified,
sites at or between the minimum and maximum altitude are returned.
--altMax ALTMAX
[optional, default is None, minor site filter]
Providing a value to altMax (maximum altitude) means you want sites that
have or are less than the altMax value.:
--altMin=1000 --altMax=5000
# Return sites where the altitude is 1000 feet or
# greater and 5000 feet or less.
--altMin=12.5 --altMax=13
# Return sites where the altitude is 12.5 feet or
# greater and 13 feet or less.
--aquiferCd AQUIFERCD
[optional, default is None, minor site filter]
Used to filter sites to those that exist in specified national aquifers.
Note: not all sites have been associated with national aquifers.
Enter one or more national aquifer codes, separated by commas. A
national aquifer code is exactly 10 characters. You can have up to
1000 aquiferCd codes. Complete list:
<[4;36mhttp://water.usgs.gov/ogw/NatlAqCode-reflist.html[0m>:
--aquiferCd=S500EDRTRN,N100HGHPLN
# returns groundwater sites for the
# Edwards-Trinity aquifer system and
# the High Plains national
# aquifers.
--localAquiferCd LOCALAQUIFERCD
[optional, default is None, minor site filter]
Used to filter sites to those that exist in specified local aquifers.
Note: not all sites have been associated with local aquifers. Enter
one or more local aquifer codes, separated by commas. A local
aquifer code begins with a 2 character state abbreviation (such as
TX for Texas) followed by a colon followed by the 7 character
aquifer code. Can have 0 to 1000 comma delimited codes. Complete
list: <[4;36mhttp://help.waterdata.usgs.gov/code/aqfr_cd_query?fmt=html[0m>
To translate state codes associated with the local aquifer you may
need this reference: <[4;36mhttp://www.itl.nist.gov/fipspubs/fip5-2.htm[0m>
--localAquiferCd=AL:111RGLT,AL:111RSDM
# returns sites for the Regolith and Saprolite local
# aquifers in Alabama
--wellDepthMin WELLDEPTHMIN
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
These arguments allows you to select groundwater sites serving data
recorded automatically where the associated sites' well depth are
within a desired depth, expressed in feet from the land surface
datum. Express well depth as a positive number. Providing a value to
wellDepthMin (minimum well depth) means you want sites that have or
exceed the wellDepthMin value. The values may be expressed in
decimals Caution: well depth applies to groundwater sites only.:
--wellDepthMin=100 --wellDepthMax=500
# Return daily value sites where the well depth is
# 100 feet or greater and 500 feet or less.
--wellDepthMax WELLDEPTHMAX
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
Providing a value to wellDepthMax (maximum well depth) means you want
sites that have or are less than the wellDepthMax value.:
--wellDepthMin=10.5 --wellDepthMax=10.7
# Return daily value sites where the well depth is
# 10.5 feet or greater and 10.7 feet or less.
If both the wellDepthMin and wellDepthMax are specified, sites at or
between the minimum and maximum well depth values specified are
returned wellDepthMax should be greater than or equal to
wellDepthMin.
--holeDepthMin HOLEDEPTHMIN
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
These arguments allows you to select groundwater sites serving data
recorded automatically where the associated sites' hole depth are
within a desired depth, expressed in feet from the land surface
datum. Express hole depth as a positive number. Providing a value to
holeDepthMin (minimum hole depth) means you want sites that have or
exceed the holeDepthMin value. The values may be expressed in
decimals Caution: hole depth applies to groundwater sites only.
--holeDepthMax HOLEDEPTHMAX
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
Providing a value to holeDepthMax (maximum hole depth) means you want
sites that have or are less than the holeDepthMax value.:
--holeDepthMin=100 --holeDepthMax=500
# Return daily values sites where the hole depth is
# 100 feet or greater and 500 feet or less.
--holeDepthMin=10.5 --holeDepthMax=10.7
# Return daily value sites where the hole depth is
# 10.5 feet or greater and 10.7 feet or less.
If both the holeDepthMin and holeDepthMax are specified, sites at or
between the minimum and maximum hole depth values specified are
returned holeDepthMax should be greater than or equal to
holeDepthMin.
nwis_site¶
$ tsgettoolbox nwis_site --help
usage: tsgettoolbox nwis_site [-h] [--sites SITES] [--stateCd STATECD]
[--huc HUC] [--bBox BBOX] [--countyCd COUNTYCD] [--parameterCd PARAMETERCD]
[--period PERIOD] [--startDT STARTDT] [--endDT ENDDT] [--siteType SITETYPE]
[--modifiedSince MODIFIEDSINCE] [--agencyCd AGENCYCD] [--siteStatus
SITESTATUS] [--altMin ALTMIN] [--altMax ALTMAX] [--drainAreaMin
DRAINAREAMIN] [--drainAreaMax DRAINAREAMAX] [--aquiferCd AQUIFERCD]
[--localAquiferCd LOCALAQUIFERCD] [--wellDepthMin WELLDEPTHMIN]
[--wellDepthMax WELLDEPTHMAX] [--holeDepthMin HOLEDEPTHMIN] [--holeDepthMax
HOLEDEPTHMAX] [--siteOutput SITEOUTPUT] [--seriesCatalogOutput
SERIESCATALOGOUTPUT] [--outputDataTypeCd OUTPUTDATATYPECD] [--siteName
SITENAME] [--siteNameMatchOperator SITENAMEMATCHOPERATOR] [--hasDataTypeCd
HASDATATYPECD]
This does not return a time-series, but a table of sites.
Detailed documentation is available at <[4;36mhttp://waterdata.usgs.gov/nwis[0m>.
Site local time is output, even if multiple sites are requested and sites are in
different time zones. Note that the measurement time zone at a site may not be
the same as the time zone actually in effect at the site.
Every query requires a major filter. Pick the major filter ('--sites',
'--stateCd', '--huc', '--bBox', '--countyCd') that best retrieves the data for
the sites that you are interested in. You can have only one major filter per
query. If you specify more than one major filter, you will get an error.
[1mMajor Filter[0m
Select ONE of:
'--sites',
'--stateCd',
'--huc',
'--bBox', or
'--countyCd'
[1mMinor Filters[0m
Additional filters can be applied after specifying a major filter. This further
reduces the set of expected results. Users are encouraged to use minor filters
because it allows more efficient use of this service.
Use as many as desired to limit number of retrieved time series:
'--agencyCd',
'--altMax',
'--altMin',
'--aquiferCd',
'--drainAreaMax',
'--drainAreaMin',
'--holeDepthMax'
'--holeDepthMin',
'--localAquiferCd',
'--modifiedSince',
'--parameterCd',
'--siteStatus',
'--siteType',
'--wellDepthMax',
'--wellDepthMin',
[1mResults[0m
┌─────────────────────┬──────────────────────────────────┐
│ Column │ Description │
╞═════════════════════╪══════════════════════════════════╡
│ agency_cd │ Agency │
├─────────────────────┼──────────────────────────────────┤
│ site_no │ Site identification number │
├─────────────────────┼──────────────────────────────────┤
│ station_nm │ Site name │
├─────────────────────┼──────────────────────────────────┤
│ site_tp_cd │ Site type │
├─────────────────────┼──────────────────────────────────┤
│ dec_lat_va │ Decimal latitude │
├─────────────────────┼──────────────────────────────────┤
│ dec_long_va │ Decimal longitude │
├─────────────────────┼──────────────────────────────────┤
│ coord_acy_cd │ Latitude-longitude accuracy │
├─────────────────────┼──────────────────────────────────┤
│ dec_coord_datum_cd │ Decimal Latitude-longitude datum │
├─────────────────────┼──────────────────────────────────┤
│ alt_va │ Altitude of Gage/land surface │
├─────────────────────┼──────────────────────────────────┤
│ alt_acy_va │ Altitude accuracy │
├─────────────────────┼──────────────────────────────────┤
│ alt_datum_cd │ Altitude datum │
├─────────────────────┼──────────────────────────────────┤
│ huc_cd │ Hydrologic unit code │
╘═════════════════════╧══════════════════════════════════╛
options:
-h | --help
show this help message and exit
--sites SITES
[optional, default is None, major site filter]
Want to only query one site? Use sites as your major filter, and put only
one site number in the list. Sites are comma separated. Sites may be
prefixed with an optional agency code followed by a colon. If you do
not know the site numbers you need, you can find relevant sites with
the NWIS Mapper (<[4;36mhttp://wdr.water.usgs.gov/nwisgmap/index.html[0m>) or
on the USGS Water Data for the Nation site.
(<[4;36mhttp://waterdata.usgs.gov/nwis/[0m>)
Can have from 1 to 100 comma separated site numbers:
--sites=USGS:01646500
--sites=01646500,06306300
--stateCd STATECD
[optional, default is None, major site filter]
U.S. postal service (2-digit) state code. Can have only 1 state code. List
is available at <[4;36mhttp://www.usps.com/ncsc/lookups/usps_abbre-
viations.html[0m>:
--stateCd=NY
--huc HUC
[optional, default is None, major site filter]
A list of hydrologic unit codes (HUC) or watersheds. Only 1 major HUC can
be specified per request. A major HUC has two digits. Minor HUCs
must be eight digits in length. Can have 1 to 10 HUC codes. List of
HUCs is available at <[4;36mhttp://water.usgs.gov/GIS/huc_name.html[0m>:
--huc=01,02070010
--bBox BBOX
[optional, default is None, major site filter]
A contiguous range of decimal latitude and longitude, starting with the
west longitude, then the south latitude, then the east longitude,
and then the north latitude with each value separated by a comma.
The product of the range of latitude and longitude cannot exceed 25
degrees. Whole or decimal degrees must be specified, up to six
digits of precision. Minutes and seconds are not allowed. Remember:
western longitude (which includes almost all of the United States)
is specified in negative degrees. Caution: many sites outside the
continental US do not have latitude and longitude referenced to
NAD83 and therefore can not be found using these arguments. Certain
sites are not associated with latitude and longitude due to homeland
security concerns and cannot be found using this filter.:
--bBox=-83,36.5,-81,38.5
--countyCd COUNTYCD
[optional, default is None, major site filter]
A list of county numbers, in a 5 digit numeric format. The first two
digits of a county's code are the FIPS State Code. Can have from 1
to 20 county codes. The first 2 digits are the FIPS State Code
(<[4;36mhttp://www.itl.nist.gov/fipspubs/fip5-2.htm[0m>) and the list of
county codes are at <[4;36mhttp://help.waterdata.usgs.gov/code/cou-
nty_query?fmt=html[0m>:
--countyCd=51059,51061
--parameterCd PARAMETERCD
[optional, default is None, minor site filter]
USGS time-series parameter code. All parameter codes are numeric and 5
characters in length. Parameter codes are used to identify the
constituent measured and the units of measure. Popular codes include
stage (00065), discharge in cubic feet per second (00060) and water
temperature in degrees Celsius (00010). Can request from 1 to 100
"parameterCD"s. Default: returns all regular time-series for the
requested sites.
Complete list:
http://help.waterdata.usgs.gov/codes-and-parameters/parameters::
--parameterCd=00060 # discharge, cubic feet
# per second
--parameterCd=00060,00065 # discharge,
# cubic feet per second
# and gage height in
# feet
--period PERIOD
[optional, default is None]
Get a range of values from now by specifying the period argument period
must be in ISO-8601 Duration format.
(<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Durations[0m>) Negative periods
(ex: P-T2H) are not allowed. Data are always returned up to the most
recent value, which in the case of a predictive gage might be in the
future. When specifying days from now, the first value will probably
not be at midnight of the first day, but somewhat before exactly 24
hours from now.:
--period=PT2H
# Retrieve last two hours from now up to most recent
# instantaneous value)
--period=P7D
# Retrieve last seven days up from now to most recent
# instantaneous value)
--startDT STARTDT
[optional, default is None]
Get a range of values from an explicit begin or end date/time. Use the
startDT and endDT arguments. Site local time is output, even if
multiple sites are requested and sites are in different time zones.
Note that the measurement time zone at a site may not be the same as
the time zone actually in effect at the site.
Both startDt and endDt must be in ISO-8601 Date/Time format.
(<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Dates[0m>) You can express the
date and time in a timezone other than site local time if you want
as long as it follows the ISO standard. For example, you can express
the time in Universal time: 2014-03-20T00:00Z. If startDT is
supplied and endDT is not, endDT ends with the most recent
instantaneous value. startDT must be chronologically before endDT.
If startDt shows the date and not the time of day (ex: 2010-09-01) the
time of midnight site time is assumed (2010-09-01T00:00) If endDt
shows the date and not the time of day (ex: 2010-09-02) the last
minute before midnight site time is assumed (2010-09-02T23:59).
Remember, only data from October 1, 2007 are currently available in
the 'iv' database.
--endDT ENDDT
[optional, default is None]
If endDT is present, startDt must also be present.:
--startDT=2010-11-22 --endDT=2010-11-22 # Full day, 00:00 to 23:59
--startDT=2010-11-22T12:00 --endDT=2010-11-22T18:00
--startDT=2010-11-22 --endDT=2010-11-22
--startDT=2010-11-22T12:00 # From "startDT" to most recent
# instantaneous value
--siteType SITETYPE
[optional, default is None, minor site filter]
Restricts sites to those having one or more major and/or minor site types.
If you request a major site type (ex: &siteType=ST) you will get all
sub-site types of the same major type as well (in this case, ST-CA,
ST-DCH and ST-TS). Can have from 1 to an unlimited number of
siteType codes. Default is to return all types. List of valid site
types: <[4;36mhttp://help.waterdata.usgs.gov/site_tp_cd[0m>:
--siteType=ST # Streams only
--siteType=ST,LA-OU # Streams and Land Outcrops only
--modifiedSince MODIFIEDSINCE
[optional, default is None, minor site filter]
Returns all values for sites and period of record requested only if any
values have changed over the last modifiedSince period.
modifiedSince is useful if you periodically need to poll a site but
are only interested in getting data if some of it has changed. It is
typically be used with period, or startDT/endDT but does not have to
be. In the latter case, if any values were changed during the
specified modifiedSince period, only the most recent values would be
retrieved for those sites. This is a typical usage, since users
typically are polling a site and only want data if there are new or
changed measurements. ISO-8601 duration format is always used. There
is no default. (<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Durations[0m>):
--modifiedSince=PT2H
# Retrieves all values for sites and period of record
# requested for any of the requested sites and
# parameters, but only for sites where any of the
# values changed during the last two hours.
--modifiedSince=PT2H --period=P1D
# Retrieve all values for sites and period of record
# requested for the last 24 hours from now only for
# sites and parameters that had any values that
# changed or were added during the last two hours.
--modifiedSince=PT2H --startDt=2010-11-01 --endDt=2010-11-02
# Retrieve all values for sites and period of record
# requested for sites and parameters that had values
# change between midnight site local time on Nov 1st,
# 2010 and 23:59 on Nov 2nd, 2010 site local time,
# only if values were changed or added within the
# last two hours.
--agencyCd AGENCYCD
[optional, default is None, minor site filter]
The list of sites returned are filtered to return only those with the
provided agency code. The agency code describes the organization
that maintains the site. Only one agency code is allowed and is
optional. An authoritative list of agency codes can be found here.
Default is to return all sites regardless of agency code. List:
<[4;36mhttp://help.waterdata.usgs.gov/code/agency_cd_query?fmt=html[0m>:
--stateCd=il --agencyCd=USCE # Only US Army Corps
# of Engineers sites
# in Illinois
--siteStatus SITESTATUS
[optional, default is None, minor site filter]
Selects sites based on whether or not they are active. If a site is
active, it implies that it is being actively maintained. A site is
considered active if: it has collected time-series (automated) data
within the last 183 days (6 months), or it has collected discrete
(manually collected) data within 397 days (13 months) If it does not
meet these criteria, it is considered inactive. Some exceptions
apply. If a site is flagged by a USGS water science center as
discontinued, it will show as inactive. A USGS science center can
also flag a new site as active even if it has not collected any
data. The default is all (show both active and inactive sites).
Chose between, 'all', 'active', or 'inactive'. Default all - sites
of any activity status are returned.:
--siteStatus='active'
--altMin ALTMIN
[optional, default is None, minor site filter]
These arguments allows you to select instantaneous values sites where the
associated sites' altitude are within a desired altitude, expressed
in feet. Altitude is based on the datum used at the site. Providing
a value to altMin (minimum altitude) means you want sites that have
or exceed the altMin value. You may specify decimal feet if
precision is critical If both the altMin and altMax are specified,
sites at or between the minimum and maximum altitude are returned.
--altMax ALTMAX
[optional, default is None, minor site filter]
Providing a value to altMax (maximum altitude) means you want sites that
have or are less than the altMax value.:
--altMin=1000 --altMax=5000
# Return sites where the altitude is 1000 feet or
# greater and 5000 feet or less.
--altMin=12.5 --altMax=13
# Return sites where the altitude is 12.5 feet or
# greater and 13 feet or less.
--drainAreaMin DRAINAREAMIN
[optional, default is None, minor site filter]
SURFACE WATER SITE ATTRIBUTE
These arguments allows you to select principally surface water sites where
the associated sites' drainage areas (watersheds) are within a
desired size, expressed in square miles or decimal fractions
thereof. Providing a value to drainAreaMin (minimum drainage area)
means you want sites that have or exceed the drainAreaMin value. The
values may be expressed in decimals. If both the drainAreaMin and
drainAreaMax are specified, sites at or between the minimum and
maximum drainage areas values specified are returned Caution: not
all sites are associated with a drainage area. Caution: drainage
area generally only applies to surface water sites. Use with other
site types, such as groundwater sites, will likely retrieve no
results.
--drainAreaMax DRAINAREAMAX
[optional, default is None, minor site filter]
SURFACE WATER SITE ATTRIBUTE
Providing a value to drainAreaMax (maximum drainage area) means you want
sites that have or are less than the drainAreaMax value.:
--drainAreaMin=1000 --drainAreaMax=5000
# Return sites where the drainage area
# is 1000 square miles or greater and
# is 5000 square miles or less.
--drainAreaMin=10.5 --drainAreaMax=10.7
# Return sites where the drainage area
# is 10.5 square miles or greater and
# is 10.7 square miles or less.
--aquiferCd AQUIFERCD
[optional, default is None, minor site filter]
Used to filter sites to those that exist in specified national aquifers.
Note: not all sites have been associated with national aquifers.
Enter one or more national aquifer codes, separated by commas. A
national aquifer code is exactly 10 characters. You can have up to
1000 aquiferCd codes. Complete list:
<[4;36mhttp://water.usgs.gov/ogw/NatlAqCode-reflist.html[0m>:
--aquiferCd=S500EDRTRN,N100HGHPLN
# returns groundwater sites for the
# Edwards-Trinity aquifer system and
# the High Plains national
# aquifers.
--localAquiferCd LOCALAQUIFERCD
[optional, default is None, minor site filter]
Used to filter sites to those that exist in specified local aquifers.
Note: not all sites have been associated with local aquifers. Enter
one or more local aquifer codes, separated by commas. A local
aquifer code begins with a 2 character state abbreviation (such as
TX for Texas) followed by a colon followed by the 7 character
aquifer code. Can have 0 to 1000 comma delimited codes. Complete
list: <[4;36mhttp://help.waterdata.usgs.gov/code/aqfr_cd_query?fmt=html[0m>
To translate state codes associated with the local aquifer you may
need this reference: <[4;36mhttp://www.itl.nist.gov/fipspubs/fip5-2.htm[0m>
--localAquiferCd=AL:111RGLT,AL:111RSDM
# returns sites for the Regolith and Saprolite local
# aquifers in Alabama
--wellDepthMin WELLDEPTHMIN
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
These arguments allows you to select groundwater sites serving data
recorded automatically where the associated sites' well depth are
within a desired depth, expressed in feet from the land surface
datum. Express well depth as a positive number. Providing a value to
wellDepthMin (minimum well depth) means you want sites that have or
exceed the wellDepthMin value. The values may be expressed in
decimals Caution: well depth applies to groundwater sites only.:
--wellDepthMin=100 --wellDepthMax=500
# Return daily value sites where the well depth is
# 100 feet or greater and 500 feet or less.
--wellDepthMax WELLDEPTHMAX
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
Providing a value to wellDepthMax (maximum well depth) means you want
sites that have or are less than the wellDepthMax value.:
--wellDepthMin=10.5 --wellDepthMax=10.7
# Return daily value sites where the well depth is
# 10.5 feet or greater and 10.7 feet or less.
If both the wellDepthMin and wellDepthMax are specified, sites at or
between the minimum and maximum well depth values specified are
returned wellDepthMax should be greater than or equal to
wellDepthMin.
--holeDepthMin HOLEDEPTHMIN
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
These arguments allows you to select groundwater sites serving data
recorded automatically where the associated sites' hole depth are
within a desired depth, expressed in feet from the land surface
datum. Express hole depth as a positive number. Providing a value to
holeDepthMin (minimum hole depth) means you want sites that have or
exceed the holeDepthMin value. The values may be expressed in
decimals Caution: hole depth applies to groundwater sites only.
--holeDepthMax HOLEDEPTHMAX
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
Providing a value to holeDepthMax (maximum hole depth) means you want
sites that have or are less than the holeDepthMax value.:
--holeDepthMin=100 --holeDepthMax=500
# Return daily values sites where the hole depth is
# 100 feet or greater and 500 feet or less.
--holeDepthMin=10.5 --holeDepthMax=10.7
# Return daily value sites where the hole depth is
# 10.5 feet or greater and 10.7 feet or less.
If both the holeDepthMin and holeDepthMax are specified, sites at or
between the minimum and maximum hole depth values specified are
returned holeDepthMax should be greater than or equal to
holeDepthMin.
--siteOutput SITEOUTPUT
[optional, default is None]
If you would like to see expanded site information, check this box. This
argument is ignored for visually oriented output formats like
Mapper, Google Earth and Google Maps. The default is basic. Use
expanded to get expanded site information. Example:
&siteOutput=expanded. Note: for performance reasons,
&siteOutput=expanded cannot be used if seriesCatalogOutput=true or
with any values for outputDataTypeCd.
--seriesCatalogOutput SERIESCATALOGOUTPUT
[optional, default is None]
This argument is ignored for visually oriented output formats like Mapper,
Google Earth and Google Maps. If you would like to see all the
period of record information for the sites selected, check this box.
You will see detailed information, such as a continuous range of
dates served by a site for one or more data types, for example, the
begin and end dates that streamflow (parameter 00060) was recorded
at a site. Note: if you select any data types for output (see below)
the period of record data will also appear. In that case specifying
this argument is unnecessary. The default is false. The only legal
values for this argument are true and false. Example:
&seriesCatalogOutput=true. &seriesCatalogOutput=true is equivalent
to &outputDataTypeCd=all. Note: for performance reasons,
&siteOutput=expanded cannot be used if seriesCatalogOutput=true.
--outputDataTypeCd OUTPUTDATATYPECD
[optional, default is None]
This will add period of record information to certain output formats (GML,
RDB and JSON) that summarize information about the data types
requested. The default is all data types. Some output formats are
designed for visual use (Google Earth, Google Maps and Mapper).
Consequently with these formats you will not see data type code
information.
Default information: If seriesCatalogOutput is true, all period of record
information is shown by default. If seriesCatalogOutput is false,
unless you override it using one of the values below, no period of
record information is shown.
Note: for performance reasons, &siteOutput=expanded cannot be used if with
any values for outputDataTypeCd.
Here are the various output data type codes available. These can be
selected individually or can be added as comma separated values if
desired. Example: &outputDataTypeCd=iv,dv
┌─────┬───────────────────────────────────────────────────────────────┐
│ all │ default (see above for qualifications). This is equivalent to │
│ │ &seriesCatalogOutput=true. │
├─────┼───────────────────────────────────────────────────────────────┤
│ iv │ Instantaneous values (time-series measurements typically │
│ │ recorded by automated equipment at frequent intervals (e.g., │
│ │ hourly) │
├─────┼───────────────────────────────────────────────────────────────┤
│ uv │ Unit values (alias for iv) │
├─────┼───────────────────────────────────────────────────────────────┤
│ rt │ Real-time data (alias for iv) │
├─────┼───────────────────────────────────────────────────────────────┤
│ dv │ Daily values (once daily measurements or summarized │
│ │ information for a particular day, such as daily maximum, │
├─────┼─minimum and mean)─────────────────────────────────────────────┤
│ pk │ Peaks measurements of water levels and streamflow for surface │
│ │ water sites (such as during floods, may be either an │
│ │ automated or a manual measurement) │
├─────┼───────────────────────────────────────────────────────────────┤
│ sv │ Site visits (irregular manual surface water measurements, │
│ │ excluding peak measurements) │
├─────┼───────────────────────────────────────────────────────────────┤
│ gw │ Groundwater levels measured at irregular, discrete intervals. │
│ │ For recorded, time series groundwater levels, use iv or id. │
├─────┼───────────────────────────────────────────────────────────────┤
│ qw │ Water-quality data from discrete sampling events and analyzed │
│ │ in the field or in a laboratory. For recorded time series │
│ │ water-quality data, use iv or id. │
├─────┼───────────────────────────────────────────────────────────────┤
│ id │ Historical instantaneous values (sites in the USGS │
│ │ Instantaneous Data Archive External Link) │
├─────┼───────────────────────────────────────────────────────────────┤
│ aw │ Sites monitored by the USGS Active Groundwater Level Network │
│ │ External Link │
├─────┼───────────────────────────────────────────────────────────────┤
│ ad │ Sites included in USGS Annual Water Data Reports External │
╘═════╧═Link}═════════════════════════════════════════════════════════╛
--siteName SITENAME
[optional, default is None, minor site filter]
This filter allows you to find a site by its name, using either the exact
site name or a partial site name. Note that a major filter is still
required. String matches are case insensitive, so if you specify
"Boulder" you will retrieve site names with "Boulder", "boulder",
"BOULDER" as well as many other variants. To embed a space, you can
use single quotes. Examaple: --siteName='Boulder Creek'
--siteNameMatchOperator SITENAMEMATCHOPERATOR
[optional, default is None, minor site filter]
If used, this must be used with siteName. It determines how the pattern
matching for the site name behaves. Matches are case insensitive.
The options are:
start = The string must be at the start of the site name (default)
any = The string must be contained somewhere in the site name
exact = The site name must exactly match the string supplied, with
the exception that the match is not case sensitive
Example: &siteNameMatchOperator=any
--hasDataTypeCd HASDATATYPECD
[optional, default is None, minor site filter]
Default is all. Restricts results to those sites that collect certain
kinds of data. Separate values with commas. Allowed values are:
┌─────┬───────────────────────────────────────────────────────────────┐
│ all │ default (see above for qualifications). This is equivalent to │
│ │ &seriesCatalogOutput=true. │
├─────┼───────────────────────────────────────────────────────────────┤
│ iv │ Instantaneous values (time-series measurements typically │
│ │ recorded by automated equipment at frequent intervals (e.g., │
│ │ hourly) │
├─────┼───────────────────────────────────────────────────────────────┤
│ uv │ Unit values (alias for iv) │
├─────┼───────────────────────────────────────────────────────────────┤
│ rt │ Real-time data (alias for iv) │
├─────┼───────────────────────────────────────────────────────────────┤
│ dv │ Daily values (once daily measurements or summarized │
│ │ information for a particular day, such as daily maximum, │
├─────┼─minimum and mean)─────────────────────────────────────────────┤
│ pk │ Peaks measurements of water levels and streamflow for surface │
│ │ water sites (such as during floods, may be either an │
│ │ automated or a manual measurement) │
├─────┼───────────────────────────────────────────────────────────────┤
│ sv │ Site visits (irregular manual surface water measurements, │
│ │ excluding peak measurements) │
├─────┼───────────────────────────────────────────────────────────────┤
│ gw │ Groundwater levels measured at irregular, discrete intervals. │
│ │ For recorded, time series groundwater levels, use iv or id. │
├─────┼───────────────────────────────────────────────────────────────┤
│ qw │ Water-quality data from discrete sampling events and analyzed │
│ │ in the field or in a laboratory. For recorded time series │
│ │ water-quality data, use iv or id. │
├─────┼───────────────────────────────────────────────────────────────┤
│ id │ Historical instantaneous values (sites in the USGS │
│ │ Instantaneous Data Archive External Link) │
├─────┼───────────────────────────────────────────────────────────────┤
│ aw │ Sites monitored by the USGS Active Groundwater Level Network │
│ │ External Link │
├─────┼───────────────────────────────────────────────────────────────┤
│ ad │ Sites included in USGS Annual Water Data Reports External │
╘═════╧═Link══════════════════════════════════════════════════════════╛
nwis_stat¶
$ tsgettoolbox nwis_stat --help
usage: tsgettoolbox nwis_stat [-h] [--sites SITES] [--parameterCd PARAMETERCD]
[--period PERIOD] [--startDT STARTDT] [--endDT ENDDT] [--siteType SITETYPE]
[--modifiedSince MODIFIEDSINCE] [--agencyCd AGENCYCD] [--siteStatus
SITESTATUS] [--altMin ALTMIN] [--altMax ALTMAX] [--drainAreaMin
DRAINAREAMIN] [--drainAreaMax DRAINAREAMAX] [--aquiferCd AQUIFERCD]
[--localAquiferCd LOCALAQUIFERCD] [--wellDepthMin WELLDEPTHMIN]
[--wellDepthMax WELLDEPTHMAX] [--holeDepthMin HOLEDEPTHMIN] [--holeDepthMax
HOLEDEPTHMAX] [--statReportType STATREPORTTYPE] [--statType STATTYPE]
[--missingData MISSINGDATA] [--statYearType STATYEARTYPE]
Detailed documentation is available at <[4;36mhttp://waterdata.usgs.gov/nwis[0m>.
Site local time is output, even if multiple sites are requested and sites are in
different time zones. Note that the measurement time zone at a site may not be
the same as the time zone actually in effect at the site.
Every query requires a major filter. Pick the major filter ('--sites',
'--stateCd', '--huc', '--bBox', '--countyCd') that best retrieves the data for
the sites that you are interested in. You can have only one major filter per
query. If you specify more than one major filter, you will get an error.
[1mMajor Filter[0m
Select ONE of:
'--sites',
'--stateCd',
'--huc',
'--bBox', or
'--countyCd'
[1mMinor Filters[0m
Additional filters can be applied after specifying a major filter. This further
reduces the set of expected results. Users are encouraged to use minor filters
because it allows more efficient use of this service.
Use as many as desired to limit number of retrieved time series:
'--agencyCd',
'--altMax',
'--altMin',
'--aquiferCd',
'--drainAreaMax',
'--drainAreaMin',
'--holeDepthMax'
'--holeDepthMin',
'--localAquiferCd',
'--modifiedSince',
'--parameterCd',
'--siteStatus',
'--siteType',
'--wellDepthMax',
'--wellDepthMin',
[1mReturns[0m
This returns a pandas DataFrame if using the Python API, or a text table to
standard out if using the command line interface. Both will have columns named
according to the following table.
┌──────────────┬────────────────┬─────────────────────────────────────────┐
│ Column Name │ statReportType │ Description │
╞══════════════╪════════════════╪═════════════════════════════════════════╡
│ agency_cd │ all │ Agency code │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ site_no │ all │ Site identification number │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ parameter_cd │ all │ Parameter code │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ station_nm │ all │ Site name │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ loc_web_ds │ all │ Additional measurement description │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ year_nu │ monthly annual │ The year for which the statistics │
├──────────────┼────────────────┼─apply.──────────────────────────────────┤
│ month_nu │ monthly daily │ The month for which the statistics │
├──────────────┼────────────────┼─apply.──────────────────────────────────┤
│ day_nu │ daily │ The day for which the statistics apply. │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ begin_yr │ daily │ First water year of data of daily mean │
│ │ │ values for this day. │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ end_yr │ daily │ Last water year of data of daily mean │
│ │ │ values for this day. │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ count_nu │ all │ Number of values used in the │
├──────────────┼────────────────┼─calculation.────────────────────────────┤
│ max_va_yr │ daily │ Water year in which the maximum value │
│ │ │ occurred. │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ max_va │ daily │ Maximum of daily mean values for this │
│ │ │ day. │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ min_va_yr │ daily │ Water year in which the minimum value │
│ │ │ occurred. │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ min_va │ daily │ Minimum of daily mean values for this │
│ │ │ day. │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ mean_va │ all │ Mean of daily mean values for this day. │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ p05_va │ daily │ 05 percentile of daily mean values for │
│ │ │ this day. │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ p10_va │ daily │ 10 percentile of daily mean values for │
│ │ │ this day. │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ p20_va │ daily │ 20 percentile of daily mean values for │
│ │ │ this day. │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ p25_va │ daily │ 25 percentile of daily mean values for │
│ │ │ this day. │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ p50_va │ daily │ 50 percentile (median) of daily mean │
│ │ │ values for this day. │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ p75_va │ daily │ 75 percentile of daily mean values for │
│ │ │ this day. │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ p80_va │ daily │ 80 percentile of daily mean values for │
│ │ │ this day. │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ p90_va │ daily │ 90 percentile of daily mean values for │
│ │ │ this day. │
├──────────────┼────────────────┼─────────────────────────────────────────┤
│ p95_va │ daily │ 95 percentile of daily mean values for │
│ │ │ this day. │
╘══════════════╧════════════════╧═════════════════════════════════════════╛
options:
-h | --help
show this help message and exit
--sites SITES
[optional, default is None, major site filter]
Want to only query one site? Use sites as your major filter, and put only
one site number in the list. Sites are comma separated. Sites may be
prefixed with an optional agency code followed by a colon. If you do
not know the site numbers you need, you can find relevant sites with
the NWIS Mapper (<[4;36mhttp://wdr.water.usgs.gov/nwisgmap/index.html[0m>) or
on the USGS Water Data for the Nation site.
(<[4;36mhttp://waterdata.usgs.gov/nwis/[0m>)
Can have from 1 to 100 comma separated site numbers:
--sites=USGS:01646500
--sites=01646500,06306300
--parameterCd PARAMETERCD
[optional, default is None, minor site filter]
USGS time-series parameter code. All parameter codes are numeric and 5
characters in length. Parameter codes are used to identify the
constituent measured and the units of measure. Popular codes include
stage (00065), discharge in cubic feet per second (00060) and water
temperature in degrees Celsius (00010). Can request from 1 to 100
"parameterCD"s. Default: returns all regular time-series for the
requested sites.
Complete list:
http://help.waterdata.usgs.gov/codes-and-parameters/parameters::
--parameterCd=00060 # discharge, cubic feet
# per second
--parameterCd=00060,00065 # discharge,
# cubic feet per second
# and gage height in
# feet
--period PERIOD
[optional, default is None]
Get a range of values from now by specifying the period argument period
must be in ISO-8601 Duration format.
(<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Durations[0m>) Negative periods
(ex: P-T2H) are not allowed. Data are always returned up to the most
recent value, which in the case of a predictive gage might be in the
future. When specifying days from now, the first value will probably
not be at midnight of the first day, but somewhat before exactly 24
hours from now.:
--period=PT2H
# Retrieve last two hours from now up to most recent
# instantaneous value)
--period=P7D
# Retrieve last seven days up from now to most recent
# instantaneous value)
--startDT STARTDT
[optional, default is None]
Get a range of values from an explicit begin or end date/time. Use the
startDT and endDT arguments. Site local time is output, even if
multiple sites are requested and sites are in different time zones.
Note that the measurement time zone at a site may not be the same as
the time zone actually in effect at the site.
Both startDt and endDt must be in ISO-8601 Date/Time format.
(<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Dates[0m>) You can express the
date and time in a timezone other than site local time if you want
as long as it follows the ISO standard. For example, you can express
the time in Universal time: 2014-03-20T00:00Z. If startDT is
supplied and endDT is not, endDT ends with the most recent
instantaneous value. startDT must be chronologically before endDT.
If startDt shows the date and not the time of day (ex: 2010-09-01) the
time of midnight site time is assumed (2010-09-01T00:00) If endDt
shows the date and not the time of day (ex: 2010-09-02) the last
minute before midnight site time is assumed (2010-09-02T23:59).
Remember, only data from October 1, 2007 are currently available in
the 'iv' database.
--endDT ENDDT
[optional, default is None]
If endDT is present, startDt must also be present.:
--startDT=2010-11-22 --endDT=2010-11-22 # Full day, 00:00 to 23:59
--startDT=2010-11-22T12:00 --endDT=2010-11-22T18:00
--startDT=2010-11-22 --endDT=2010-11-22
--startDT=2010-11-22T12:00 # From "startDT" to most recent
# instantaneous value
--siteType SITETYPE
[optional, default is None, minor site filter]
Restricts sites to those having one or more major and/or minor site types.
If you request a major site type (ex: &siteType=ST) you will get all
sub-site types of the same major type as well (in this case, ST-CA,
ST-DCH and ST-TS). Can have from 1 to an unlimited number of
siteType codes. Default is to return all types. List of valid site
types: <[4;36mhttp://help.waterdata.usgs.gov/site_tp_cd[0m>:
--siteType=ST # Streams only
--siteType=ST,LA-OU # Streams and Land Outcrops only
--modifiedSince MODIFIEDSINCE
[optional, default is None, minor site filter]
Returns all values for sites and period of record requested only if any
values have changed over the last modifiedSince period.
modifiedSince is useful if you periodically need to poll a site but
are only interested in getting data if some of it has changed. It is
typically be used with period, or startDT/endDT but does not have to
be. In the latter case, if any values were changed during the
specified modifiedSince period, only the most recent values would be
retrieved for those sites. This is a typical usage, since users
typically are polling a site and only want data if there are new or
changed measurements. ISO-8601 duration format is always used. There
is no default. (<[4;36mhttp://en.wikipedia.org/wiki/ISO_8601#Durations[0m>):
--modifiedSince=PT2H
# Retrieves all values for sites and period of record
# requested for any of the requested sites and
# parameters, but only for sites where any of the
# values changed during the last two hours.
--modifiedSince=PT2H --period=P1D
# Retrieve all values for sites and period of record
# requested for the last 24 hours from now only for
# sites and parameters that had any values that
# changed or were added during the last two hours.
--modifiedSince=PT2H --startDt=2010-11-01 --endDt=2010-11-02
# Retrieve all values for sites and period of record
# requested for sites and parameters that had values
# change between midnight site local time on Nov 1st,
# 2010 and 23:59 on Nov 2nd, 2010 site local time,
# only if values were changed or added within the
# last two hours.
--agencyCd AGENCYCD
[optional, default is None, minor site filter]
The list of sites returned are filtered to return only those with the
provided agency code. The agency code describes the organization
that maintains the site. Only one agency code is allowed and is
optional. An authoritative list of agency codes can be found here.
Default is to return all sites regardless of agency code. List:
<[4;36mhttp://help.waterdata.usgs.gov/code/agency_cd_query?fmt=html[0m>:
--stateCd=il --agencyCd=USCE # Only US Army Corps
# of Engineers sites
# in Illinois
--siteStatus SITESTATUS
[optional, default is None, minor site filter]
Selects sites based on whether or not they are active. If a site is
active, it implies that it is being actively maintained. A site is
considered active if: it has collected time-series (automated) data
within the last 183 days (6 months), or it has collected discrete
(manually collected) data within 397 days (13 months) If it does not
meet these criteria, it is considered inactive. Some exceptions
apply. If a site is flagged by a USGS water science center as
discontinued, it will show as inactive. A USGS science center can
also flag a new site as active even if it has not collected any
data. The default is all (show both active and inactive sites).
Chose between, 'all', 'active', or 'inactive'. Default all - sites
of any activity status are returned.:
--siteStatus='active'
--altMin ALTMIN
[optional, default is None, minor site filter]
These arguments allows you to select instantaneous values sites where the
associated sites' altitude are within a desired altitude, expressed
in feet. Altitude is based on the datum used at the site. Providing
a value to altMin (minimum altitude) means you want sites that have
or exceed the altMin value. You may specify decimal feet if
precision is critical If both the altMin and altMax are specified,
sites at or between the minimum and maximum altitude are returned.
--altMax ALTMAX
[optional, default is None, minor site filter]
Providing a value to altMax (maximum altitude) means you want sites that
have or are less than the altMax value.:
--altMin=1000 --altMax=5000
# Return sites where the altitude is 1000 feet or
# greater and 5000 feet or less.
--altMin=12.5 --altMax=13
# Return sites where the altitude is 12.5 feet or
# greater and 13 feet or less.
--drainAreaMin DRAINAREAMIN
[optional, default is None, minor site filter]
SURFACE WATER SITE ATTRIBUTE
These arguments allows you to select principally surface water sites where
the associated sites' drainage areas (watersheds) are within a
desired size, expressed in square miles or decimal fractions
thereof. Providing a value to drainAreaMin (minimum drainage area)
means you want sites that have or exceed the drainAreaMin value. The
values may be expressed in decimals. If both the drainAreaMin and
drainAreaMax are specified, sites at or between the minimum and
maximum drainage areas values specified are returned Caution: not
all sites are associated with a drainage area. Caution: drainage
area generally only applies to surface water sites. Use with other
site types, such as groundwater sites, will likely retrieve no
results.
--drainAreaMax DRAINAREAMAX
[optional, default is None, minor site filter]
SURFACE WATER SITE ATTRIBUTE
Providing a value to drainAreaMax (maximum drainage area) means you want
sites that have or are less than the drainAreaMax value.:
--drainAreaMin=1000 --drainAreaMax=5000
# Return sites where the drainage area
# is 1000 square miles or greater and
# is 5000 square miles or less.
--drainAreaMin=10.5 --drainAreaMax=10.7
# Return sites where the drainage area
# is 10.5 square miles or greater and
# is 10.7 square miles or less.
--aquiferCd AQUIFERCD
[optional, default is None, minor site filter]
Used to filter sites to those that exist in specified national aquifers.
Note: not all sites have been associated with national aquifers.
Enter one or more national aquifer codes, separated by commas. A
national aquifer code is exactly 10 characters. You can have up to
1000 aquiferCd codes. Complete list:
<[4;36mhttp://water.usgs.gov/ogw/NatlAqCode-reflist.html[0m>:
--aquiferCd=S500EDRTRN,N100HGHPLN
# returns groundwater sites for the
# Edwards-Trinity aquifer system and
# the High Plains national
# aquifers.
--localAquiferCd LOCALAQUIFERCD
[optional, default is None, minor site filter]
Used to filter sites to those that exist in specified local aquifers.
Note: not all sites have been associated with local aquifers. Enter
one or more local aquifer codes, separated by commas. A local
aquifer code begins with a 2 character state abbreviation (such as
TX for Texas) followed by a colon followed by the 7 character
aquifer code. Can have 0 to 1000 comma delimited codes. Complete
list: <[4;36mhttp://help.waterdata.usgs.gov/code/aqfr_cd_query?fmt=html[0m>
To translate state codes associated with the local aquifer you may
need this reference: <[4;36mhttp://www.itl.nist.gov/fipspubs/fip5-2.htm[0m>
--localAquiferCd=AL:111RGLT,AL:111RSDM
# returns sites for the Regolith and Saprolite local
# aquifers in Alabama
--wellDepthMin WELLDEPTHMIN
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
These arguments allows you to select groundwater sites serving data
recorded automatically where the associated sites' well depth are
within a desired depth, expressed in feet from the land surface
datum. Express well depth as a positive number. Providing a value to
wellDepthMin (minimum well depth) means you want sites that have or
exceed the wellDepthMin value. The values may be expressed in
decimals Caution: well depth applies to groundwater sites only.:
--wellDepthMin=100 --wellDepthMax=500
# Return daily value sites where the well depth is
# 100 feet or greater and 500 feet or less.
--wellDepthMax WELLDEPTHMAX
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
Providing a value to wellDepthMax (maximum well depth) means you want
sites that have or are less than the wellDepthMax value.:
--wellDepthMin=10.5 --wellDepthMax=10.7
# Return daily value sites where the well depth is
# 10.5 feet or greater and 10.7 feet or less.
If both the wellDepthMin and wellDepthMax are specified, sites at or
between the minimum and maximum well depth values specified are
returned wellDepthMax should be greater than or equal to
wellDepthMin.
--holeDepthMin HOLEDEPTHMIN
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
These arguments allows you to select groundwater sites serving data
recorded automatically where the associated sites' hole depth are
within a desired depth, expressed in feet from the land surface
datum. Express hole depth as a positive number. Providing a value to
holeDepthMin (minimum hole depth) means you want sites that have or
exceed the holeDepthMin value. The values may be expressed in
decimals Caution: hole depth applies to groundwater sites only.
--holeDepthMax HOLEDEPTHMAX
[optional, default is None, minor site filter]
GROUNDWATER SITE ATTRIBUTE
Providing a value to holeDepthMax (maximum hole depth) means you want
sites that have or are less than the holeDepthMax value.:
--holeDepthMin=100 --holeDepthMax=500
# Return daily values sites where the hole depth is
# 100 feet or greater and 500 feet or less.
--holeDepthMin=10.5 --holeDepthMax=10.7
# Return daily value sites where the hole depth is
# 10.5 feet or greater and 10.7 feet or less.
If both the holeDepthMin and holeDepthMax are specified, sites at or
between the minimum and maximum hole depth values specified are
returned holeDepthMax should be greater than or equal to
holeDepthMin.
--statReportType STATREPORTTYPE
[optional, default is 'daily']
The type of statistics desired. Valid statistic report types include:
┌────────────────┬──────────────────────────────────────────┐
│ statReportType │ Description │
├────────────────┼──────────────────────────────────────────┤
│ daily │ daily statistics (default) statistic │
│ │ across years │
├────────────────┼──────────────────────────────────────────┤
│ monthly │ monthly statistics (monthly time-series) │
├────────────────┼──────────────────────────────────────────┤
│ annual │ annual statistics, based on either │
│ │ calendar year or water year, as defined │
│ │ by statYearType. If statYearType is not │
│ │ provided, calendar year statistics are │
│ │ assumed. (annual time-series) │
╘════════════════╧══════════════════════════════════════════╛
--statType STATTYPE
[optional, default is None, minor site filter]
Selects sites based on the statistics type(s) desired, such as minimum,
maximum or mean
For all statReportType types include:
mean - arithmetic mean or average
all - selects all available statistics
For daily statistics you can also specify:
min - minimum, or smallest value found for the
daily statistics
max - maximum, or largest value found for the
daily statistics
median - the numerical value separating the higher
half of a the data from the lower half,
same as specifying P50. If used median
will be represented by the column name
p50_va.
P05, P10, P20, P25, P50, P75, P80, P90, P95
with the number indicating percentile. Note:
the service can calculate only these
percentiles.
--missingData MISSINGDATA
[optional, default is None]
Used to indicate the rules to follow to generate statistics if there are
gaps in the period of record during the requested statistics period.
By default if there are any missing data for the report type, the
statistic is left blank or null.
This option does not apply to daily statistics, but optionally can be used
with monthly and yearly statistics. If used with daily statistics,
an error will occur.
Missing data can happen for various reasons including there was a
technical problem with the gage for part of the time period.
Enabling this switch will attempt to provide a statistic if there is
enough data to create one.
Choice is 'off' or 'on'.
--statYearType STATYEARTYPE
[optional, default is None]
Indicates which kind of year statistics should be created against. This
only applies when requesting annual statistics, i.e.
statReportType=annual. Valid year types codes include:
┌──────────┬──────────────────────────────────────────────────────────┐
│ calendar │ calendar year, i.e. January 1 through December 31 │
├──────────┼──────────────────────────────────────────────────────────┤
│ water │ water year, i.e. a year begins October 1 of the previous │
│ │ year and ends September 30 of the current year. This is │
│ │ the same as a federal fiscal year. │
╘══════════╧══════════════════════════════════════════════════════════╛
rivergages¶
$ tsgettoolbox rivergages --help
usage: tsgettoolbox rivergages [-h] [--start_date START_DATE]
[--end_date END_DATE] station_code parameter
Stage and flow from systems managed by the U.S. Army Corps of Engineers.
positional arguments:
station_code The station code for the station. parameter Parameter code.
options:
-h | --help
show this help message and exit
--start_date START_DATE
The start date of the desired time-series.
--end_date END_DATE
The end data of the desired time-series.
swtwc¶
$ tsgettoolbox swtwc --help
usage: tsgettoolbox swtwc [-h] [--date DATE] station_code
US/region:station:::USACE Southwest Division, Tulsa Water Control
positional arguments:
station_code The station code.
options:
-h | --help
show this help message and exit
--date DATE
The date for the downloaded data.
terraclimate¶
$ tsgettoolbox terraclimate --help
usage: tsgettoolbox terraclimate [-h] [--variables VARIABLES]
[--start_date START_DATE] [--end_date END_DATE] lat lon
method: These layers from TerraClimate were derived from the essential climate
variables of TerraClimate. Water balance variables, actual evapotranspiration,
climatic water deficit, runoff, soil moisture, and snow water equivalent were
calculated using a water balance model and plant extractable soil water capacity
derived from Wang-Erlandsson et al (2016).
title: TerraClimate: monthly climate and climatic water balance for global land
surfaces
summary: This archive contains a dataset of high-spatial resolution (1/24deg,
~4-km) monthly climate and climatic water balance for global terrestrial
surfaces from 1958-2015. These data were created by using climatically aided
interpolation, combining high-spatial resolution climatological normals from the
WorldClim version 1.4 and version 2 datasets, with coarser resolution time
varying (i.e. monthly) data from CRU Ts4.0 and JRA-55 to produce a monthly
dataset of precipitation, maximum and minimum temperature, wind speed, vapor
pressure, and solar radiation. TerraClimate additionally produces monthly
surface water balance datasets using a water balance model that incorporates
reference evapotranspiration, precipitation, temperature, and interpolated plant
extractable soil water capacity.
keywords: WORLDCLIM,global,monthly, temperature,precipitation,wind,radiation,va-
por pressure,evapotranspiration,water balance,soil water capacity,snow water
equivalent,runoff
naming_authority: edu.uidaho.nkn
history: Created by John Abatzoglou, University of California Merced
creator_url: climate.nkn.uidaho.edu/TerraClimate
creator_email: jabatzoglou at ucmerced.edu
institution: University of California Merced
project: Global Dataset of Monthly Climate and Climatic Water Balance
(1958-2015)
acknowledgment: Please cite the references included herein. We also acknowledge
the WorldClim datasets (Fick and Hijmans, 2017; Hijmans et al., 2005) and the
CRU Ts4.0 (Harris et al., 2014) and JRA-55 (Kobayashi et al., 2015) datasets.
geospatial_lat_min: -89.979164
geospatial_lat_max: 89.979164
geospatial_lon_min: -179.97917
geospatial_lon_max: 179.97917
time_coverage_start: 1958-01-01T00:0
time_coverage_end: present
time_coverage_resolution: P1M
standard_nam_vocabulary: CF-1.0
license: No restrictions
geospatial_lat_units: decimal degrees north
geospatial_lat_resolution: -0.041666668
geospatial_lon_units: decimal degrees east
geospatial_lon_resolution: 0.041666668
references: Abatzoglou, J.T., S.Z. Dobrowski, S.A. Parks, and K.C. Hegewisch,
2017, High-resolution global dataset of monthly climate and climatic water
balance from 1958-2015, submitted to Scientific Data.
source: WorldClim v2.0 (2.5m), CRU Ts4.0, JRA-55
version: v1.0
Conventions: CF-1.6
positional arguments:
lat The latitude of the point. North hemisphere is positive from 0 to
90. South hemisphere is negative from 0 to -90.
lon The longitude of the point. Western hemisphere (west of Greenwich
Prime Meridian) is negative 0 to -180. The eastern hemisphere (east of the
Greenwich Prime Meridian) is positive 0 to 180.
options:
-h | --help
show this help message and exit
--variables VARIABLES
At the command line can supply a comma separated list of variable names.
Using the Python API needs to be a Python list of strings.
The current list of available variables are in the following table.
┌────────┬──────────────────────────────────┬───────────┐
│ Short │ Long │ Units │
╞════════╪══════════════════════════════════╪═══════════╡
│ aet │ Actual ET │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ def │ Climate water deficit │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ PDSI │ Palmer Drought Severity Index │ │
├────────┼──────────────────────────────────┼───────────┤
│ pet │ Reference ET │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ q │ Runoff │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ soil │ Soil moisture │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ srad │ Downwelling solar shortwave │ W/m^2 │
├────────┼──────────────────────────────────┼───────────┤
│ swe │ Snow water equivalence │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ tmax │ maximum temperature │ degC │
├────────┼──────────────────────────────────┼───────────┤
│ tmin │ minimum temperature │ degC │
├────────┼──────────────────────────────────┼───────────┤
│ vap │ Vapor pressure │ kPa │
├────────┼──────────────────────────────────┼───────────┤
│ vpd │ Vapor pressure deficit │ kPa │
├────────┼──────────────────────────────────┼───────────┤
│ ws │ wind_speed │ m/s │
╘════════╧══════════════════════════════════╧═══════════╛
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
terraclimate19611990¶
$ tsgettoolbox terraclimate19611990 --help
usage: tsgettoolbox terraclimate19611990 [-h] [--variables VARIABLES]
[--start_date START_DATE] [--end_date END_DATE] lat lon
method: These layers from TerraClimate were derived from the essential climate
variables of TerraClimate. Water balance variables, actual evapotranspiration,
climatic water deficit, runoff, soil moisture, and snow water equivalent were
calculated using a water balance model and plant extractable soil water capacity
derived from Wang-Erlandsson et al (2016).
title: TerraClimate: monthly climate and climatic water balance for global land
surfaces
summary: This archive contains a dataset of high-spatial resolution (1/24deg,
~4-km) monthly climate and climatic water balance for global terrestrial
surfaces from 1958-2015. These data were created by using climatically aided
interpolation, combining high-spatial resolution climatological normals from the
WorldClim version 1.4 and version 2 datasets, with coarser resolution time
varying (i.e. monthly) data from CRU Ts4.0 and JRA-55 to produce a monthly
dataset of precipitation, maximum and minimum temperature, wind speed, vapor
pressure, and solar radiation. TerraClimate additionally produces monthly
surface water balance datasets using a water balance model that incorporates
reference evapotranspiration, precipitation, temperature, and interpolated plant
extractable soil water capacity.
method: These layers from TerraClimate were creating using climatically aided
interpolation of monthly anomalies from the CRU Ts4.0 and Japanese 55-year
Reanalysis (JRA-55) datasets with WorldClim v2.0 climatologies.
keywords: WORLDCLIM,global,monthly, temperature,precipitation,wind,radiation,va-
por pressure,evapotranspiration,water balance,soil water capacity,snow water
equivalent,runoff
history: Created by John Abatzoglou, University of California Merced
creator_url: climate.nkn.uidaho.edu/TerraClimate
creator_email: jabatzoglou at ucmerced.edu
institution: University of California Merced
project: Global Dataset of Monthly Climate and Climatic Water Balance
(1958-2015)
acknowledgment: Please cite the references included herein. We also acknowledge
the WorldClim datasets (Fick and Hijmans, 2017; Hijmans et al., 2005) and the
CRU Ts4.0 (Harris et al., 2014) and JRA-55 (Kobayashi et al., 2015) datasets.
geospatial_lat_min: -89.979164
geospatial_lat_max: 89.979164
geospatial_lon_min: -179.97917
geospatial_lon_max: 179.97917
time_coverage_start: 1958-01-01T00:0
time_coverage_end: present
time_coverage_resolution: P1M
standard_nam_vocabulary: CF-1.0
license: No restrictions
geospatial_lat_units: decimal degrees north
geospatial_lat_resolution: -0.041666668
geospatial_lon_units: decimal degrees east
geospatial_lon_resolution: 0.041666668
references: Abatzoglou, J.T., S.Z. Dobrowski, S.A. Parks, and K.C. Hegewisch,
2017, High-resolution global dataset of monthly climate and climatic water
balance from 1958-2015, submitted to Scientific Data.
source: WorldClim v2.0 (2.5m), CRU Ts4.0, JRA-55
version: v1.0
Conventions: CF-1.6
positional arguments:
lat The latitude of the point. North hemisphere is positive from 0 to
90. South hemisphere is negative from 0 to -90.
lon The longitude of the point. Western hemisphere (west of Greenwich
Prime Meridian) is negative 0 to -180. The eastern hemisphere (east of the
Greenwich Prime Meridian) is positive 0 to 180.
options:
-h | --help
show this help message and exit
--variables VARIABLES
At the command line can supply a comma separated list of variable names.
Using the Python API needs to be a Python list of strings.
The current list of available variables are in the following table.
┌────────┬──────────────────────────────────┬───────────┐
│ Short │ Long │ Units │
╞════════╪══════════════════════════════════╪═══════════╡
│ aet │ Actual ET │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ def │ Climate water deficit │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ pet │ Reference ET │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ q │ Runoff │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ soil │ Soil moisture │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ swe │ Snow water equivalence │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ tmax │ maximum temperature │ degC │
├────────┼──────────────────────────────────┼───────────┤
│ tmin │ minimum temperature │ degC │
├────────┼──────────────────────────────────┼───────────┤
│ vap │ Vapor pressure │ kPa │
├────────┼──────────────────────────────────┼───────────┤
│ vpd │ Vapor pressure deficit │ kPa │
├────────┼──────────────────────────────────┼───────────┤
│ ws │ wind_speed │ m/s │
╘════════╧══════════════════════════════════╧═══════════╛
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
terraclimate19812010¶
$ tsgettoolbox terraclimate19812010 --help
usage: tsgettoolbox terraclimate19812010 [-h] [--variables VARIABLES]
[--start_date START_DATE] [--end_date END_DATE] lat lon
method: These layers from TerraClimate were derived from the essential climate
variables of TerraClimate. Water balance variables, actual evapotranspiration,
climatic water deficit, runoff, soil moisture, and snow water equivalent were
calculated using a water balance model and plant extractable soil water capacity
derived from Wang-Erlandsson et al (2016).
title: TerraClimate: monthly climate and climatic water balance for global land
surfaces
summary: This archive contains a dataset of high-spatial resolution (1/24deg,
~4-km) monthly climate and climatic water balance for global terrestrial
surfaces from 1958-2015. These data were created by using climatically aided
interpolation, combining high-spatial resolution climatological normals from the
WorldClim version 1.4 and version 2 datasets, with coarser resolution time
varying (i.e. monthly) data from CRU Ts4.0 and JRA-55 to produce a monthly
dataset of precipitation, maximum and minimum temperature, wind speed, vapor
pressure, and solar radiation. TerraClimate additionally produces monthly
surface water balance datasets using a water balance model that incorporates
reference evapotranspiration, precipitation, temperature, and interpolated plant
extractable soil water capacity.
method: These layers from TerraClimate were creating using climatically aided
interpolation of monthly anomalies from the CRU Ts4.0 and Japanese 55-year
Reanalysis (JRA-55) datasets with WorldClim v2.0 climatologies.
keywords: WORLDCLIM,global,monthly, temperature,precipitation,wind,radiation,va-
por pressure,evapotranspiration,water balance,soil water capacity,snow water
equivalent,runoff
history: Created by John Abatzoglou, University of California Merced
creator_url: climate.nkn.uidaho.edu/TerraClimate
creator_email: jabatzoglou at ucmerced.edu
institution: University of California Merced
project: Global Dataset of Monthly Climate and Climatic Water Balance
(1958-2015)
acknowledgment: Please cite the references included herein. We also acknowledge
the WorldClim datasets (Fick and Hijmans, 2017; Hijmans et al., 2005) and the
CRU Ts4.0 (Harris et al., 2014) and JRA-55 (Kobayashi et al., 2015) datasets.
geospatial_lat_min: -89.979164
geospatial_lat_max: 89.979164
geospatial_lon_min: -179.97917
geospatial_lon_max: 179.97917
time_coverage_start: 1958-01-01T00:0
time_coverage_end: present
time_coverage_resolution: P1M
standard_nam_vocabulary: CF-1.0
license: No restrictions
geospatial_lat_units: decimal degrees north
geospatial_lat_resolution: -0.041666668
geospatial_lon_units: decimal degrees east
geospatial_lon_resolution: 0.041666668
references: Abatzoglou, J.T., S.Z. Dobrowski, S.A. Parks, and K.C. Hegewisch,
2017, High-resolution global dataset of monthly climate and climatic water
balance from 1958-2015, submitted to Scientific Data.
source: WorldClim v2.0 (2.5m), CRU Ts4.0, JRA-55
version: v1.0
Conventions: CF-1.6
positional arguments:
lat The latitude of the point. North hemisphere is positive from 0 to
90. South hemisphere is negative from 0 to -90.
lon The longitude of the point. Western hemisphere (west of Greenwich
Prime Meridian) is negative 0 to -180. The eastern hemisphere (east of the
Greenwich Prime Meridian) is positive 0 to 180.
options:
-h | --help
show this help message and exit
--variables VARIABLES
At the command line can supply a comma separated list of variable names.
Using the Python API needs to be a Python list of strings.
The current list of available variables are in the following table.
┌────────┬──────────────────────────────────┬───────────┐
│ Short │ Long │ Units │
╞════════╪══════════════════════════════════╪═══════════╡
│ aet │ Actual ET │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ def │ Climate water deficit │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ pet │ Reference ET │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ q │ Runoff │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ soil │ Soil moisture │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ swe │ Snow water equivalence │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ tmax │ maximum temperature │ degC │
├────────┼──────────────────────────────────┼───────────┤
│ tmin │ minimum temperature │ degC │
├────────┼──────────────────────────────────┼───────────┤
│ vap │ Vapor pressure │ kPa │
├────────┼──────────────────────────────────┼───────────┤
│ vpd │ Vapor pressure deficit │ kPa │
├────────┼──────────────────────────────────┼───────────┤
│ ws │ wind_speed │ m/s │
╘════════╧══════════════════════════════════╧═══════════╛
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
terraclimate2C¶
$ tsgettoolbox terraclimate2C --help
usage: tsgettoolbox terraclimate2C [-h] [--variables VARIABLES]
[--start_date START_DATE] [--end_date END_DATE] lat lon
method: These layers from TerraClimate were derived from the essential climate
variables of TerraClimate. Water balance variables, actual evapotranspiration,
climatic water deficit, runoff, soil moisture, and snow water equivalent were
calculated using a water balance model and plant extractable soil water capacity
derived from Wang-Erlandsson et al (2016).
title: TerraClimate: monthly climate and climatic water balance for global land
surfaces
summary: This archive contains a dataset of high-spatial resolution (1/24deg,
~4-km) monthly climate and climatic water balance for global terrestrial
surfaces from 1958-2015. These data were created by using climatically aided
interpolation, combining high-spatial resolution climatological normals from the
WorldClim version 1.4 and version 2 datasets, with coarser resolution time
varying (i.e. monthly) data from CRU Ts4.0 and JRA-55 to produce a monthly
dataset of precipitation, maximum and minimum temperature, wind speed, vapor
pressure, and solar radiation. TerraClimate additionally produces monthly
surface water balance datasets using a water balance model that incorporates
reference evapotranspiration, precipitation, temperature, and interpolated plant
extractable soil water capacity.
method: These layers from TerraClimate were creating using climatically aided
interpolation of monthly anomalies from the CRU Ts4.0 and Japanese 55-year
Reanalysis (JRA-55) datasets with WorldClim v2.0 climatologies.
keywords: WORLDCLIM,global,monthly, temperature,precipitation,wind,radiation,va-
por pressure,evapotranspiration,water balance,soil water capacity,snow water
equivalent,runoff
history: Created by John Abatzoglou, University of California Merced
creator_url: climate.nkn.uidaho.edu/TerraClimate
creator_email: jabatzoglou at ucmerced.edu
institution: University of California Merced
project: Global Dataset of Monthly Climate and Climatic Water Balance
(1958-2015)
acknowledgment: Please cite the references included herein. We also acknowledge
the WorldClim datasets (Fick and Hijmans, 2017; Hijmans et al., 2005) and the
CRU Ts4.0 (Harris et al., 2014) and JRA-55 (Kobayashi et al., 2015) datasets.
geospatial_lat_min: -89.979164
geospatial_lat_max: 89.979164
geospatial_lon_min: -179.97917
geospatial_lon_max: 179.97917
time_coverage_start: 1958-01-01T00:0
time_coverage_end: present
time_coverage_resolution: P1M
standard_nam_vocabulary: CF-1.0
license: No restrictions
geospatial_lat_units: decimal degrees north
geospatial_lat_resolution: -0.041666668
geospatial_lon_units: decimal degrees east
geospatial_lon_resolution: 0.041666668
references: Abatzoglou, J.T., S.Z. Dobrowski, S.A. Parks, and K.C. Hegewisch,
2017, High-resolution global dataset of monthly climate and climatic water
balance from 1958-2015, submitted to Scientific Data.
source: WorldClim v2.0 (2.5m), CRU Ts4.0, JRA-55
version: v1.0
Conventions: CF-1.6
positional arguments:
lat The latitude of the point. North hemisphere is positive from 0 to
90. South hemisphere is negative from 0 to -90.
lon The longitude of the point. Western hemisphere (west of Greenwich
Prime Meridian) is negative 0 to -180. The eastern hemisphere (east of the
Greenwich Prime Meridian) is positive 0 to 180.
options:
-h | --help
show this help message and exit
--variables VARIABLES
At the command line can supply a comma separated list of variable names.
Using the Python API needs to be a Python list of strings.
The current list of available variables are in the following table.
┌────────┬──────────────────────────────────┬───────────┐
│ Short │ Long │ Units │
╞════════╪══════════════════════════════════╪═══════════╡
│ aet │ Actual ET │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ def │ Climate water deficit │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ pet │ Reference ET │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ q │ Runoff │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ soil │ Soil moisture │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ swe │ Snow water equivalence │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ tmax │ maximum temperature │ degC │
├────────┼──────────────────────────────────┼───────────┤
│ tmin │ minimum temperature │ degC │
├────────┼──────────────────────────────────┼───────────┤
│ vap │ Vapor pressure │ kPa │
├────────┼──────────────────────────────────┼───────────┤
│ vpd │ Vapor pressure deficit │ kPa │
├────────┼──────────────────────────────────┼───────────┤
│ ws │ wind_speed │ m/s │
╘════════╧══════════════════════════════════╧═══════════╛
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
terraclimate4C¶
$ tsgettoolbox terraclimate4C --help
usage: tsgettoolbox terraclimate4C [-h] [--variables VARIABLES]
[--start_date START_DATE] [--end_date END_DATE] lat lon
method: These layers from TerraClimate were derived from the essential climate
variables of TerraClimate. Water balance variables, actual evapotranspiration,
climatic water deficit, runoff, soil moisture, and snow water equivalent were
calculated using a water balance model and plant extractable soil water capacity
derived from Wang-Erlandsson et al (2016).
title: TerraClimate: monthly climate and climatic water balance for global land
surfaces
summary: This archive contains a dataset of high-spatial resolution (1/24deg,
~4-km) monthly climate and climatic water balance for global terrestrial
surfaces from 1958-2015. These data were created by using climatically aided
interpolation, combining high-spatial resolution climatological normals from the
WorldClim version 1.4 and version 2 datasets, with coarser resolution time
varying (i.e. monthly) data from CRU Ts4.0 and JRA-55 to produce a monthly
dataset of precipitation, maximum and minimum temperature, wind speed, vapor
pressure, and solar radiation. TerraClimate additionally produces monthly
surface water balance datasets using a water balance model that incorporates
reference evapotranspiration, precipitation, temperature, and interpolated plant
extractable soil water capacity.
method: These layers from TerraClimate were creating using climatically aided
interpolation of monthly anomalies from the CRU Ts4.0 and Japanese 55-year
Reanalysis (JRA-55) datasets with WorldClim v2.0 climatologies.
keywords: WORLDCLIM,global,monthly, temperature,precipitation,wind,radiation,va-
por pressure,evapotranspiration,water balance,soil water capacity,snow water
equivalent,runoff
history: Created by John Abatzoglou, University of California Merced
creator_url: climate.nkn.uidaho.edu/TerraClimate
creator_email: jabatzoglou at ucmerced.edu
institution: University of California Merced
project: Global Dataset of Monthly Climate and Climatic Water Balance
(1958-2015)
acknowledgment: Please cite the references included herein. We also acknowledge
the WorldClim datasets (Fick and Hijmans, 2017; Hijmans et al., 2005) and the
CRU Ts4.0 (Harris et al., 2014) and JRA-55 (Kobayashi et al., 2015) datasets.
geospatial_lat_min: -89.979164
geospatial_lat_max: 89.979164
geospatial_lon_min: -179.97917
geospatial_lon_max: 179.97917
time_coverage_start: 1958-01-01T00:0
time_coverage_end: present
time_coverage_resolution: P1M
standard_nam_vocabulary: CF-1.0
license: No restrictions
geospatial_lat_units: decimal degrees north
geospatial_lat_resolution: -0.041666668
geospatial_lon_units: decimal degrees east
geospatial_lon_resolution: 0.041666668
references: Abatzoglou, J.T., S.Z. Dobrowski, S.A. Parks, and K.C. Hegewisch,
2017, High-resolution global dataset of monthly climate and climatic water
balance from 1958-2015, submitted to Scientific Data.
source: WorldClim v2.0 (2.5m), CRU Ts4.0, JRA-55
version: v1.0
Conventions: CF-1.6
positional arguments:
lat The latitude of the point. North hemisphere is positive from 0 to
90. South hemisphere is negative from 0 to -90.
lon The longitude of the point. Western hemisphere (west of Greenwich
Prime Meridian) is negative 0 to -180. The eastern hemisphere (east of the
Greenwich Prime Meridian) is positive 0 to 180.
options:
-h | --help
show this help message and exit
--variables VARIABLES
At the command line can supply a comma separated list of variable names.
Using the Python API needs to be a Python list of strings.
The current list of available variables are in the following table.
┌────────┬──────────────────────────────────┬───────────┐
│ Short │ Long │ Units │
╞════════╪══════════════════════════════════╪═══════════╡
│ aet │ Actual ET │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ def │ Climate water deficit │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ pet │ Reference ET │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ q │ Runoff │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ soil │ Soil moisture │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ swe │ Snow water equivalence │ mm │
├────────┼──────────────────────────────────┼───────────┤
│ tmax │ maximum temperature │ degC │
├────────┼──────────────────────────────────┼───────────┤
│ tmin │ minimum temperature │ degC │
├────────┼──────────────────────────────────┼───────────┤
│ vap │ Vapor pressure │ kPa │
├────────┼──────────────────────────────────┼───────────┤
│ vpd │ Vapor pressure deficit │ kPa │
├────────┼──────────────────────────────────┼───────────┤
│ ws │ wind_speed │ m/s │
╘════════╧══════════════════════════════════╧═══════════╛
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
topowx¶
$ tsgettoolbox topowx --help
usage: tsgettoolbox topowx [-h] [--variables VARIABLES]
[--start_date START_DATE] [--end_date END_DATE] lat lon
institution: USGS
history: Created on: 2017-07-06, dataset version 2016.1
references: <[4;36mhttp://dx.doi.org/10.1002/joc.4127[0m> ,
<[4;36mhttp://dx.doi.org/10.1002/2014GL062803[0m> ,
<[4;36mhttp://dx.doi.org/10.1175/JAMC-D-15-0276.1[0m>
comment: The TopoWx ('Topography Weather') gridded dataset contains daily
30-arcsec resolution (~800-m resolution; WGS84) interpolations of minimum and
maximum topoclimatic air temperature for the conterminous U.S. Using both
DEM-based variables and MODIS land skin temperature as predictors of air
temperature, interpolation procedures include moving window regression kriging
and geographically weighted regression. To avoid artificial climate trends, all
input station data are homogenized using the GHCN/USHCN Pairwise Homogenization
Algorithm (<[4;36mhttp://www.ncdc.noaa.gov/oa/climate/research/ushcn/#phas[0m>).
Conventions: CF-1.6
source: TopoWx software version 1.3.0 (<[4;36mhttps://github.com/jaredwo/topowx[0m>)
license: This work is licensed under a Creative Commons Attribution-ShareAlike
4.0 International License (<[4;36mhttps://creativecommons.org/licenses/by-sa/4.0/[0m>).
Metadata_Conventions: Unidata Dataset Discovery v1.0
summary: The TopoWx ('Topography Weather') dataset contains historical 30-arcsec
resolution (~800-m) interpolations of daily minimum and maximum topoclimatic air
temperature for the conterminous U.S. Using both DEM-based variables and MODIS
land skin temperature as predictors of air temperature, interpolation procedures
include moving window regression kriging and geographically weighted regression.
To avoid artificial climate trends, all input station data are homogenized using
the GHCN/USHCN Pairwise Homogenization Algorithm
(<[4;36mhttp://www.ncdc.noaa.gov/oa/climate/research/ushcn/#phas[0m>). The following data
are available in this archive: 1948-2016 daily and monthly minimum and maximum
temperature, and 1981-2010 monthly normals for minimum and maximum temperature
with corresponding uncertainty (kriging prediction error). Ongoing annual
updates will regenerate the entire dataset incorporating both new observations
and model enhancements. This will result in a continuously improved dataset.
However, different versions of TopoWx will be incompatible. For instance, data
from the original 1948-2012 version should not be mixed with data from the new
1948-2016 version.
keywords: maximum temperature, minimum temperature, land skin temperature,
MODIS, kriging, homogenization, gridded meteorological data
id: topowx
naming_authority: cida.usgs.gov
cdm_data_type: Grid
date_created: 2017-07-06
creator_name: Jared Oyler
creator_url: <[4;36mhttp://www.scrimhub.org[0m>
creator_email: [4;36mjared.oyler@psu.edu[0m [0]
publisher_name: Office of Water Information
publisher_url: <[4;36mhttps://owi.usgs.gov/[0m>
publisher_email: [4;36mwwatkins@usgs.gov[0m [1]
date_issued: 2017-08-18
project: TopoWx: Topoclimatic Daily Air Temperature Dataset for the Conterminous
United States
processing_level: Historical Gridded Meteorological Data
acknowledgement: Please cite this data as: Oyler JW, Ballantyne A, Jencso K,
Sweet M, Running S. Creating a Topoclimatic Daily Air Temperature Dataset for
the Conterminous United States using Homogenized Station Data and Remotely
Sensed Land Skin Temperature. International Journal of Climatology.
<[4;36mhttp://dx.doi.org/10.1002/joc.4127[0m>
geospatial_lat_min: 24.1
geospatial_lat_max: 51.2
geospatial_lon_min: -125
geospatial_lon_max: -99.7
time_coverage_start: 1948-01-01T00:00:00
time_coverage_end: 2016-12-31T00:00:00
time_coverage_resolution: P1D
positional arguments:
lat The latitude of the point. North hemisphere is positive from 0 to
90. South hemisphere is negative from 0 to -90.
lon The longitude of the point. Western hemisphere (west of Greenwich
Prime Meridian) is negative 0 to -180. The eastern hemisphere (east of the
Greenwich Prime Meridian) is positive 0 to 180.
options:
-h | --help
show this help message and exit
--variables VARIABLES
At the command line can supply a comma separated list of variable names.
Using the Python API needs to be a Python list of strings.
The current list of available topowx variables are daily minimum
temperature (tmin) and daily maximum temperature (tmax).
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
[1mReferences:[0m
[0]: <[4;36mmailto:jared.oyler@psu.edu[0m>
[1]: <[4;36mmailto:wwatkins@usgs.gov[0m>
topowx_daily¶
$ tsgettoolbox topowx_daily --help
usage: tsgettoolbox topowx_daily [-h] [--variables VARIABLES]
[--start_date START_DATE] [--end_date END_DATE] lat lon
institution: USGS
history: Created on: 2017-07-06, dataset version 2016.1
references: <[4;36mhttp://dx.doi.org/10.1002/joc.4127[0m> ,
<[4;36mhttp://dx.doi.org/10.1002/2014GL062803[0m> ,
<[4;36mhttp://dx.doi.org/10.1175/JAMC-D-15-0276.1[0m>
comment: The TopoWx ('Topography Weather') gridded dataset contains daily
30-arcsec resolution (~800-m resolution; WGS84) interpolations of minimum and
maximum topoclimatic air temperature for the conterminous U.S. Using both
DEM-based variables and MODIS land skin temperature as predictors of air
temperature, interpolation procedures include moving window regression kriging
and geographically weighted regression. To avoid artificial climate trends, all
input station data are homogenized using the GHCN/USHCN Pairwise Homogenization
Algorithm (<[4;36mhttp://www.ncdc.noaa.gov/oa/climate/research/ushcn/#phas[0m>).
Conventions: CF-1.6
source: TopoWx software version 1.3.0 (<[4;36mhttps://github.com/jaredwo/topowx[0m>)
license: This work is licensed under a Creative Commons Attribution-ShareAlike
4.0 International License (<[4;36mhttps://creativecommons.org/licenses/by-sa/4.0/[0m>).
Metadata_Conventions: Unidata Dataset Discovery v1.0
summary: The TopoWx ('Topography Weather') dataset contains historical 30-arcsec
resolution (~800-m) interpolations of daily minimum and maximum topoclimatic air
temperature for the conterminous U.S. Using both DEM-based variables and MODIS
land skin temperature as predictors of air temperature, interpolation procedures
include moving window regression kriging and geographically weighted regression.
To avoid artificial climate trends, all input station data are homogenized using
the GHCN/USHCN Pairwise Homogenization Algorithm
(<[4;36mhttp://www.ncdc.noaa.gov/oa/climate/research/ushcn/#phas[0m>). The following data
are available in this archive: 1948-2016 daily and monthly minimum and maximum
temperature, and 1981-2010 monthly normals for minimum and maximum temperature
with corresponding uncertainty (kriging prediction error). Ongoing annual
updates will regenerate the entire dataset incorporating both new observations
and model enhancements. This will result in a continuously improved dataset.
However, different versions of TopoWx will be incompatible. For instance, data
from the original 1948-2012 version should not be mixed with data from the new
1948-2016 version.
keywords: maximum temperature, minimum temperature, land skin temperature,
MODIS, kriging, homogenization, gridded meteorological data
id: topowx
naming_authority: cida.usgs.gov
cdm_data_type: Grid
date_created: 2017-07-06
creator_name: Jared Oyler
creator_url: <[4;36mhttp://www.scrimhub.org[0m>
creator_email: [4;36mjared.oyler@psu.edu[0m [0]
publisher_name: Office of Water Information
publisher_url: <[4;36mhttps://owi.usgs.gov/[0m>
publisher_email: [4;36mwwatkins@usgs.gov[0m [1]
date_issued: 2017-08-18
project: TopoWx: Topoclimatic Daily Air Temperature Dataset for the Conterminous
United States
processing_level: Historical Gridded Meteorological Data
acknowledgement: Please cite this data as: Oyler JW, Ballantyne A, Jencso K,
Sweet M, Running S. Creating a Topoclimatic Daily Air Temperature Dataset for
the Conterminous United States using Homogenized Station Data and Remotely
Sensed Land Skin Temperature. International Journal of Climatology.
<[4;36mhttp://dx.doi.org/10.1002/joc.4127[0m>
geospatial_lat_min: 24.1
geospatial_lat_max: 51.2
geospatial_lon_min: -125
geospatial_lon_max: -99.7
time_coverage_start: 1948-01-01T00:00:00
time_coverage_end: 2016-12-31T00:00:00
time_coverage_resolution: P1D
positional arguments:
lat The latitude of the point. North hemisphere is positive from 0 to
90. South hemisphere is negative from 0 to -90.
lon The longitude of the point. Western hemisphere (west of Greenwich
Prime Meridian) is negative 0 to -180. The eastern hemisphere (east of the
Greenwich Prime Meridian) is positive 0 to 180.
options:
-h | --help
show this help message and exit
--variables VARIABLES
At the command line can supply a comma separated list of variable names.
Using the Python API needs to be a Python list of strings.
The current list of available topowx variables are daily minimum
temperature (tmin) and daily maximum temperature (tmax).
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
[1mReferences:[0m
[0]: <[4;36mmailto:jared.oyler@psu.edu[0m>
[1]: <[4;36mmailto:wwatkins@usgs.gov[0m>
twc¶
$ tsgettoolbox twc --help
usage: tsgettoolbox twc [-h] [--start_date START_DATE] [--end_date END_DATE]
county
This module provides direct access to [4;36mTexas Weather Connection[0m [0] [4;36mDaily
Keetch-Byram Drought Index (KBDI)[0m [1] dataset.
positional arguments:
county If specified, results will be limited to the county corresponding to
the given 5-character Texas county fips code i.e. 48.
options:
-h | --help
show this help message and exit
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
[1mReferences:[0m
[0]: <[4;36mhttp://twc.tamu.edu/[0m>
[1]: <[4;36mhttp://twc.tamu.edu/drought/kbdi[0m>
usgs_flet_narr¶
$ tsgettoolbox usgs_flet_narr --help
usage: tsgettoolbox usgs_flet_narr [-h] [--variables VARIABLES]
[--start_date START_DATE] [--end_date END_DATE] lat lon
Daily reference and potential evapotranspiration, and supporting meteorological,
solar insolation, and blue-sky albedo data, Florida, 2019 (ver. 1.1)
version: 1.1
acknowledgement: U.S. Geological Survey, Caribbean-Florida Water Science Center,
www.usgs.gov/centers/car-fl-water
Metadata_Conventions: Unidata Dataset Discovery v1.0
keywords: Evapotranspiration, Atmospheric Temperature, Humidity, Surface Winds,
Albedo, Incoming Solar Radiation
keywords_vocabulary: GCMD Science Keywords
id: flet/thredds/cida.usgs.gov
naming_authority: cida.usgs.gov
cdm_data_type: Grid
creator_name: Jason Bellino
creator_email: jbellino at usgs.gov
publisher_name: U.S. Geological Survey
publisher_url: www.usgs.gov
time_coverage_resolution: Daily
license: These data are freely available and public domain.
authors: Bellino, Jason C.; Shoemaker, W.B.; and Mecikalski, J.R.
institution: U.S. Geological Survey
positional arguments:
lat The latitude of the point. North hemisphere is positive from 0 to
90. South hemisphere is negative from 0 to -90.
lon The longitude of the point. Western hemisphere (west of Greenwich
Prime Meridian) is negative 0 to -180. The eastern hemisphere (east of the
Greenwich Prime Meridian) is positive 0 to 180.
options:
-h | --help
show this help message and exit
--variables VARIABLES
At the command line can supply a comma separated list of variable names.
Using the Python API needs to be a Python list of strings.
The current list of available variables are in the following table.
┌───────────┬──────────────────────────────────┬───────────┐
│ Short │ Long │ Units │
╞═══════════╪══════════════════════════════════╪═══════════╡
│ ETo │ reference ET │ mm │
├───────────┼──────────────────────────────────┼───────────┤
│ PET │ potential ET │ mm │
├───────────┼──────────────────────────────────┼───────────┤
│ Solar │ solar radiation │ MJ/m2/day │
├───────────┼──────────────────────────────────┼───────────┤
│ Albedo │ albedo │ │
├───────────┼──────────────────────────────────┼───────────┤
│ Tmin │ minimum temperature │ degC │
├───────────┼──────────────────────────────────┼───────────┤
│ Tmax │ maximum temperature │ degC │
├───────────┼──────────────────────────────────┼───────────┤
│ RHmin │ minimum relative humidity │ percent │
├───────────┼──────────────────────────────────┼───────────┤
│ RHmax │ maximum relative humidity │ percent │
├───────────┼──────────────────────────────────┼───────────┤
│ ws2m │ wind_speed │ m/s │
├───────────┼──────────────────────────────────┼───────────┤
│ SolarCode │ solar radiation quality code │ │
╘═══════════╧══════════════════════════════════╧═══════════╛
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
usgs_flet_stns¶
$ tsgettoolbox usgs_flet_stns --help
usage: tsgettoolbox usgs_flet_stns [-h] [--variables VARIABLES]
[--start_date START_DATE] [--end_date END_DATE] lat lon
Daily reference and potential evapotranspiration, and supporting meteorological,
solar insolation, and blue-sky albedo data, Florida, 2019 (ver. 1.1)
version: 1.1
acknowledgement: U.S. Geological Survey, Caribbean-Florida Water Science Center,
www.usgs.gov/centers/car-fl-water
Metadata_Conventions: Unidata Dataset Discovery v1.0
keywords: Evapotranspiration, Atmospheric Temperature, Humidity, Surface Winds,
Albedo, Incoming Solar Radiation
keywords_vocabulary: GCMD Science Keywords
id: flet/thredds/cida.usgs.gov
naming_authority: cida.usgs.gov
cdm_data_type: Grid
creator_name: Jason Bellino
creator_email: jbellino at usgs.gov
publisher_name: U.S. Geological Survey
publisher_url: www.usgs.gov
time_coverage_resolution: Daily
license: These data are freely available and public domain.
authors: Bellino, Jason C.; Shoemaker, W.B.; and Mecikalski, J.R.
institution: U.S. Geological Survey
positional arguments:
lat The latitude of the point. North hemisphere is positive from 0 to
90. South hemisphere is negative from 0 to -90.
lon The longitude of the point. Western hemisphere (west of Greenwich
Prime Meridian) is negative 0 to -180. The eastern hemisphere (east of the
Greenwich Prime Meridian) is positive 0 to 180.
options:
-h | --help
show this help message and exit
--variables VARIABLES
At the command line can supply a comma separated list of variable names.
Using the Python API needs to be a Python list of strings.
The current list of available variables are in the following table.
┌───────────┬──────────────────────────────────┬───────────┐
│ Short │ Long │ Units │
╞═══════════╪══════════════════════════════════╪═══════════╡
│ ETo │ reference ET │ mm │
├───────────┼──────────────────────────────────┼───────────┤
│ PET │ potential ET │ mm │
├───────────┼──────────────────────────────────┼───────────┤
│ Solar │ solar radiation │ MJ/m2/day │
├───────────┼──────────────────────────────────┼───────────┤
│ Albedo │ albedo │ │
├───────────┼──────────────────────────────────┼───────────┤
│ Tmin │ minimum temperature │ degC │
├───────────┼──────────────────────────────────┼───────────┤
│ Tmax │ maximum temperature │ degC │
├───────────┼──────────────────────────────────┼───────────┤
│ RHmin │ minimum relative humidity │ percent │
├───────────┼──────────────────────────────────┼───────────┤
│ RHmax │ maximum relative humidity │ percent │
├───────────┼──────────────────────────────────┼───────────┤
│ ws2m │ wind_speed │ m/s │
├───────────┼──────────────────────────────────┼───────────┤
│ SolarCode │ solar radiation quality code │ │
╘═══════════╧══════════════════════════════════╧═══════════╛
--start_date START_DATE
[optional, defaults to first date in time-series, input filter]
The start_date of the series in ISOdatetime format, or 'None' for
beginning.
--end_date END_DATE
[optional, defaults to last date in time-series, input filter]
The end_date of the series in ISOdatetime format, or 'None' for end.
