Quick Start¶

Installation¶

pip install get-weather-data

Setup¶

The first time you use the package, run setup to download station data:

from get_weather_data import Weather

weather = Weather()
weather.setup()  # Downloads ~50MB, takes a few minutes

This creates a local SQLite database with:

~20K GHCN weather stations
~3K USAF/WBAN stations
~40K US ZIP code coordinates

Get Weather for a Single Location¶

from get_weather_data import Weather

weather = Weather()

result = weather.get("10001", "2024-01-15")

print(f"Station: {result.station_name}")
print(f"Distance: {result.station_distance_meters:,} m")
print(f"Max temp: {result.tmax / 10:.1f} °C")
print(f"Min temp: {result.tmin / 10:.1f} °C")

Get Weather for a Date Range¶

from datetime import date
from get_weather_data import Weather

weather = Weather()

results = weather.get_range(
    zipcode="90210",
    start_date=date(2024, 7, 1),
    end_date=date(2024, 7, 7),
)

for r in results:
    tmax = f"{r.tmax / 10:.0f}°C" if r.tmax else "N/A"
    print(f"{r.date}: {tmax}")

Process a CSV File¶

If you have a CSV with ZIP codes and dates:

from get_weather_data import Weather

weather = Weather()

weather.process_csv(
    input_path="input.csv",
    output_path="output.csv",
    zipcode_column="zip",
    year_column="year",
    month_column="month",
    day_column="day",
)

The output CSV will have additional columns for weather data.

Weather Variables¶

Variable	Description	Unit
`tmax`	Maximum temperature	tenths of °C
`tmin`	Minimum temperature	tenths of °C
`tavg`	Average temperature	tenths of °C
`prcp`	Precipitation	tenths of mm
`snow`	Snowfall	mm
`snwd`	Snow depth	mm
`awnd`	Average wind speed	tenths of m/s

Values are in tenths (divide by 10 to get standard units).