weather_stations
¶
weather_stations - Imports weather station data files.
-
class
upoints.weather_stations.
Station
(alt_id, name, state, country, wmo, latitude, longitude, ua_latitude, ua_longitude, altitude, ua_altitude, rbsn)[source]¶ Bases:
upoints.trigpoints.Trigpoint
Class for representing a weather station from a NOAA data file.
New in version 0.2.0.
Initialise a new
Station
object.Parameters: - alt_id (str) – Alternate location identifier
- name (str) – Station’s name
- state (str) – State name, if station is in the US
- country (str) – Country name
- wmo (int) – WMO region code
- latitude (float) – Station’s latitude
- longitude (float) – Station’s longitude
- ua_latitude (float) – Station’s upper air latitude
- ua_longitude (float) – Station’s upper air longitude
- altitude (int) – Station’s elevation
- ua_altitude (int) – Station’s upper air elevation
- rbsn (bool) – True if station belongs to RSBN
-
class
upoints.weather_stations.
Stations
(data=None, index='WMO')[source]¶ Bases:
upoints.point.KeyedPoints
Class for representing a group of Station objects.
New in version 0.5.1.
Initialise a new Stations object.
-
import_locations
(data, index='WMO')[source]¶ Parse NOAA weather station data files.
import_locations()
returns a dictionary with keys containing either the WMO or ICAO identifier, and values that areStation
objects that describes the large variety of data exported by NOAA.It expects data files in one of the following formats:
00;000;PABL;Buckland, Buckland Airport;AK;United States;4;65-58-56N;161-09-07W;;;7;; 01;001;ENJA;Jan Mayen;;Norway;6;70-56N;008-40W;70-56N;008-40W;10;9;P 01;002;----;Grahuken;;Norway;6;79-47N;014-28E;;;;15;
or:
AYMD;94;014;Madang;;Papua New Guinea;5;05-13S;145-47E;05-13S;145-47E;3;5;P AYMO;--;---;Manus Island/Momote;;Papua New Guinea;5;02-03-43S;147-25-27E;;;4;; AYPY;94;035;Moresby;;Papua New Guinea;5;09-26S;147-13E;09-26S;147-13E;38;49;P
Files containing the data in this format can be downloaded from the NOAA’s site in their station location page.
WMO indexed files downloaded from the NOAA site when processed by
import_locations()
will returndict
object of the following style:{'00000': Station('PABL', 'Buckland, Buckland Airport', 'AK', 'United States', 4, 65.982222. -160.848055, None, None, 7, False), '01001'; Station('ENJA', Jan Mayen, None, 'Norway', 6, 70.933333, -7.333333, 70.933333, -7.333333, 10, 9, True), '01002': Station(None, 'Grahuken', None, 'Norway', 6, 79.783333, 13.533333, None, None, 15, False)}
And
dict
objects such as the following will be created when ICAO indexed data files are processed:{'AYMD': Station("94", "014", "Madang", None, "Papua New Guinea", 5, -5.216666, 145.783333, -5.216666, 145.78333333333333, 3, 5, True, 'AYMO': Station(None, None, "Manus Island/Momote", None, "Papua New Guinea", 5, -2.061944, 147.424166, None, None, 4, False, 'AYPY': Station("94", "035", "Moresby", None, "Papua New Guinea", 5, -9.433333, 147.216667, -9.433333, 147.216667, 38, 49, True}
Parameters: - data (iter) – NOAA station data to read
- index (str) – The identifier type used in the file
Returns: WMO locations with Station objects
Return type: Raises: FileFormatError
– Unknown file format
-