tsgettoolbox.tsgettoolbox.ncei_annual

tsgettoolbox.tsgettoolbox.ncei_annual(stationid, start_date=None, end_date=None)

global:station::A:NCEI annual data summaries

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: http://www1.ncdc.noaa.gov/pub/data/cdo/documentation/ANNUAL_documentation.pdf

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.

Parameters:

• stationid – The station id. from the first column of https://www.ncei.noaa.gov/pub/data/ghcn/daily/ghcnd-stations.txt

• start_date (str) –

  [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 (str) –

  [optional, defaults to last date in time-series, input filter]

  The end_date of the series in ISOdatetime format, or ‘None’ for end.