WxData

Alt text

(C) Eric J. Drewitz 2025-2026

Conda Recipe Conda Version PyPI

Conda Platforms Anaconda-Server Badge Anaconda-Server Badge

DOI

Anaconda Downloads

Conda Downloads

PIP Downloads

PyPI Downloads

Table of Contents

1) About WxData

2) Installation Instructions

3) WxData Documentation

  1. Real-Time Data Clients

  2. Archived Data Clients

  3. Command Line Interface & Shell Scripting

  4. Raw Data Clients

  5. Post-Processors

  6. Data Querying Tools

  7. Data Transformation & Gap Filling Tools

  8. Automated Python Workflow Tools

  9. Open-Meteo API

4) WxData Tutorials

5) Server List

6) Citations

7) Data Sources

About WxData

WxData is a Python package that has many clients for retrieving and processing various types of meteorological datasets (both real-time and archived) with a focus on automation. These datasets include 20+ Weather Forecast Models, Observational Data, Radar Data, Fuels Data (Fire Weather), Observed Upper-Air Sounding Data, Real-Time Mesoscale Analysis, Gridded NOAA National Weather Service Forecasts and Gridded NOAA Storm Prediction Center Outlooks, NOAA Climate Prediction Center Outlooks, as well as interfaces with the Open-Meteo and AirNow APIs.

Return To Table Of Contents

Installation Instructions

How To Install

Copy and paste either command into your terminal or anaconda prompt:

Install via Anaconda

conda install wxdata

OR

mamba install wxdata

Install via pip

pip install wxdata

How To Update To The Latest Version

Copy and paste either command into your terminal or anaconda prompt:

Update via Anaconda

This is for users who initially installed WxData through Anaconda

conda update wxdata

OR

mamba update wxdata

Update via pip

This is for users who initially installed WxData through pip

pip install --upgrade wxdata

Important Compatibility Information

When a new version of Python comes out, it might not be compatible with the C++ eccodes library immediately (especially on pip/pypi versions).

This issue arises when the user is post-processing GRIB data.

There are two options to resolve this issue:

i) Install wxdata via Anaconda/Miniconda3 –> conda install wxdata

ii) Set up a new environment with an earlier version of Python (must be Python >= 3.10) and then pip install wxdata

Return To Table Of Contents


WxData Documentation

Real-Time Data Clients

Global Forecast System (GFS)

  1. GFS0P25
  2. GFS0P25 SECONDARY PARAMETERS
  3. GFS0P50

AI Global Forecast System (AIGFS)

  1. AIGFS

Climate Forecast System (CFS)

  1. CFS Pressure
  2. CFS Flux

Hybrid Global Ensemble Forecast System (HGEFS)

  1. HGEFS

Global Ensemble Forecast System (GEFS)

  1. GEFS0P50
  2. GEFS0P50 SECONDARY PARAMETERS
  3. GEFS0P25

AI Global Ensemble Forecast System (AIGEFS)

  1. AIGEFS Members (Pressure Parameters)
  2. AIGEFS Members (Surface Parameters)
  3. AIGEFS Ensemble Mean & Ensemble Spread

Canadian Meteorological Centre

  1. GDPS
  2. RDPS
  3. HRDPS
  4. GEPS
  5. CanSIPS

ECMWF Open Data

  1. ECMWF IFS
  2. ECMWF IFS Ensemble
  3. ECMWF AIFS
  4. ECMWF AIFS Ensemble
  5. ECMWF IFS Wave
  6. ECMWF IFS Wave Ensemble
  7. ECMWF High Resolution IFS
  8. ECMWF High Resolution IFS Ensemble
  9. ECMWF High Resolution IFS Wave
  10. ECMWF High Resolution IFS Wave Ensemble
  11. ECMWF AIFS Wave
  12. ECMWF AIFS Wave Ensemble

Real-Time Mesoscale Analysis (RTMA)

  1. RTMA
  2. RTMA Comparison

NOAA Storm Prediction Center Outlooks/Climate Prediction Center Outlooks/National Weather Service Forecasts

  1. Get NDFD Grids
  2. Climate Prediction Center Outlooks

METAR Observations

  1. METAR Observations

FEMS RAWS Network

  1. Get Single Station Weather Observations
  2. Get Single Station Fuels Observations
  3. Get Multi Station Weather Observations
  4. Get Multi Station Fuels Observations
  5. Get Current Multi Station Weather Observations
  6. Get Current Multi Station Fuels Observations
  7. Get Current Multi Station Weather Observations By State
  8. Get Current Multi Station Fuels Observations By State
  9. Get Single Station Weather Forecast
  10. Get Single Station NFDRS (Fuels) Forecast
  11. Get Multi Station Weather Forecast
  12. Get Multi Station NFDRS (Fuels) Forecast
  13. Get Single Station Meta-Data
  14. Get Multi Station Meta-Data

Observed Atmospheric Soundings

  1. University Of Wyoming Soundings

NEXRAD II Radar Data

  1. Single Site
  2. Multi-Site

Return To Table Of Contents


Archived Data Clients

Global Forecast System (GFS)

  1. Archived GFS0P25
  2. Archived GFS0P25 Secondary Parameters & Levels
  3. Archived GFS0P50

Global Ensemble Forecast System (GEFS)

  1. Archived GEFS0P50
  2. Archived GEFS0P50 Secondary Parameters & Levels
  3. Archived GEFS0P25

Climate Forecast System (CFS)

  1. Archived CFS Pressure
  2. Archived CFS Flux

Real-Time Mesoscale Analysis (RTMA)

  1. Archived RTMA

NEXRAD II Radar Data

  1. Archived NEXRAD II Radar Data

Observed Atmospheric Soundings

  1. University Of Wyoming Soundings

Return To Table Of Contents


Command Line Interface & Shell Scripting

Global Forecast System (GFS)

  1. GFS0P25
  2. GFS0P50

AI Global Forecast System (AIGFS)

  1. AIGFS

Climate Forecast System (CFS)

  1. CFS Pressure
  2. CFS Flux

Hybrid Global Ensemble Forecast System (HGEFS)

  1. HGEFS

Global Ensemble Forecast System (GEFS)

  1. GEFS0P50
  2. GEFS0P25

AI Global Ensemble Forecast System (AIGEFS)

  1. AIGEFS

Canadian Meteorological Centre

  1. GDPS
  2. RDPS
  3. HRDPS
  4. GEPS
  5. CanSIPS

ECMWF Open Data

  1. ECMWF IFS
  2. ECMWF AIFS

Real-Time Mesoscale Analysis (RTMA)

  1. RTMA

NOAA Storm Prediction Center Outlooks/National Weather Service Forecasts

  1. Get NDFD Grids

NEXRAD II Radar Data

  1. NEXRAD II Radar Data

Observed Atmospheric Soundings

  1. University Of Wyoming Soundings

METAR Observations

  1. METAR Observations

Return To Table Of Contents


Post-Processors

GFS Post-Processing

  1. Primary GFS
  2. Secondary GFS

AIGFS Post-Processing

  1. AIGFS

CFS Post-Processing

  1. CFS Pressure
  2. CFS Flux

GEFS Post-Processing

  1. Primary GEFS
  2. Secondary GEFS

AIGEFS Post-Processing

  1. AIGEFS Members
  2. AIGEFS Single

HGEFS Post-Processing

  1. HGEFS

ECMWF Post-Processing

  1. ECMWF IFS and IFS Ensemble
  2. ECMWF AIFS and AIFS Ensemble
  3. ECMWF IFS Wave and IFS Wave Ensemble

Real-Time Mesoscale Analysis Post-Processing

  1. RTMA

CMC Post Processing

  1. GDPS
  2. RDPS
  3. HRDPS
  4. GEPS
  5. CanSIPS

Return To Table Of Contents


Raw Data Clients

Custom Gridded Data

  1. Gridded Data Client

Custom CSV Data

  1. CSV Data Client

Custom Excel Data

  1. Excel Data Client

Return To Table Of Contents


Data Querying Tools

Pixel Query

  1. pixel_query

Line Query

  1. line_query

Return To Table Of Contents


Data Transformation & Gap Filling Tools

Cyclic Points For Hemispheric Plots

  1. Cyclic Points

Shifting Longitude From 0 to 360 –> -180 to 180

  1. shift_longitude

Linear Anti-Aliasing Between Two Points

  1. linear_anti_aliasing

GRIB2 to NETCDF

  1. GRIB2 to NETCDF

Return To Table Of Contents


Automated Python Workflow Tools

Running External Python Scripts In Your Workflow

1 run_external_scripts

Return To Table Of Contents


Open-Meteo API

Weather Forecasts
Current Weather
  1. Current Weather

National Oceanic and Atmospheric Administrationn (NOAA)

  1. GFS
  2. GEFS
  3. AIGFS
  4. AIGEFS
  5. HGEFS
  6. NBM

European Centre for Medium-Range Weather Forecasts (ECMWF)

  1. IFS
  2. AIFS
  3. IFS HRES
  4. IFS Ensemble
  5. AIFS Ensemble

Canadian Meteorological Centre (CMC)

  1. GEM
  2. GEM Ensemble

Deutscher Wetterdienst (DWD)

  1. ICON
  2. ICON EPS

Meteo-France

  1. ARPEGE

Japan Meteorological Agency (JMA)

  1. JMA

UK Met Office (UKMO)

  1. UKMO Global Ensemble

Google

  1. Weather Next 2 All Ensemble Members
  2. Weather Next 2 Ensemble Mean
Marine Forecasts

National Oceanic and Atmospheric Administrationn (NOAA)

  1. GFS0P25 Wave Forecasts
  2. GFS0P16 Wave Forecasts

European Centre for Medium-Range Weather Forecasts (ECMWF)

  1. ECMWF Wave Model
  2. ECMWF Wave Model 0.25 Degree

Meteo-France

  1. Meteo-France Wave Model
  2. Meteo-France Ocean Currents Model

Deutscher Wetterdienst (DWD)

  1. European Domain Wave Model
  2. Global Domian Wave Model
Seasonal Forecasts

Daily Forecasts

  1. ECMWF EC46 + SEAS5 Ensemble Members
  2. ECMWF EC46 Ensemble Members
  3. ECMWF SEAS5 Ensemble Members
  4. ECMWF EC46 + SEAS5 Ensemble Mean
  5. ECMWF EC46 Ensemble Mean
  6. ECMWF SEAS5 Ensemble Mean

Weekly Forecasts

  1. ECMWF EC46 Mean & Anomaly

Monthly Forecasts

  1. ECMWF SEAS5 Mean & Anomaly
Climate Reanalysis & Forecasts
  1. CMCC-CM2-VHR4
  2. FGOALS_f3_H
  3. HiRAM_SIT_HR
  4. MRI_AGCM3_2_S
  5. EC_Earth3P_HR
  6. MPI_ESM1_2_XR
  7. NICAM16_8S
Air Quality Forecasts
  1. CAMS
Solar Radiation Forecasts
  1. Solar Radiation Forecast

Return To Table Of Contents


Air Now API

Observations

  1. Get Current Data Bounding Box
  2. Get Historical Data Bounding Box

Return To Table Of Contents


WxData Tutorials

Alt text

Jupyter Lab

Command Line Interface

Return To Table Of Contents


Server List

Alt text

Real-Time Data Server List

Client NOAA/NCEP/NOMADS ECMWF Open-Data Amazon Web Services Google Cloud NOAA/NWS/FTP MSC Open Data University of Wyoming NOAA/AWC USDA/FEMS
GFS0P25 Y N Y Y N N N N N
GFS0P25 Secondary Levels & Parameters Y N Y Y N N N N N
GFS0P50 Y N Y Y N N N N N
GEFS0P50 Y N Y Y N N N N N
GEFS0P50 Secondary Levels & Parameters Y N Y Y N N N N N
GEFS0P25 Y N Y Y N N N N N
ECMWF IFS N Y Y Y N N N N N
ECMWF High Resolution IFS N Y Y Y N N N N N
ECMWF IFS Ensemble N Y Y Y N N N N N
ECMWF High Resolution IFS Ensemble N Y Y Y N N N N N
ECMWF IFS Wave N Y Y Y N N N N N
ECMWF High Resolution IFS Wave N Y Y Y N N N N N
ECMWF IFS Wave Ensemble N Y Y Y N N N N N
ECMWF High Resolution IFS Wave Ensemble N Y Y Y N N N N N
ECMWF AIFS N Y Y Y N N N N N
ECMWF AIFS Ensemble N Y Y Y N N N N N
ECMWF AIFS Wave N Y Y Y N N N N N
ECMWF AIFS Wave Ensemble N Y Y Y N N N N N
NOAA/NWS NDFD Grids N N Y N Y N N N N
RTMA Y N Y N N N N N N
AIGFS Y N Y N N N N N N
AIGEFS Pressure Members Y N Y N N N N N N
AIGEFS Surface Members Y N Y N N N N N N
AIGEFS Single (Ensemble Statistics) Y N N N N N N N N
HGEFS Y N N N N N N N N
CFS Y N Y N N N N N N
GDPS N N N N N Y N N N
RDPS N N N N N Y N N N
HRDPS N N N N N Y N N N
GEPS N N N N N Y N N N
CanSIPS N N N N N Y N N N
NEXRAD II Radar N N Y N N N N N N
Observed Soundings N N N N N N Y N N
METAR Observations N N N N N N N Y N
RAWS Observations & Forecasts N N N N N N N N Y
NFDRS Data N N N N N N N N Y

Archived Data Server List

Client Amazon Web Services Google Cloud University of Wyoming USDA/FEMS
GFS0P25 Y Y N N
GFS0P25 Secondary Levels & Parameters Y Y N N
GFS0P50 Y Y N N
GEFS0P50 Y Y N N
GEFS0P50 Secondary Levels & Parameters Y Y N N
GEFS0P25 Y Y N N
RTMA Y N N N
CFS Y N N N
NEXRAD II Radar Y N N N
Observed Soundings N N Y N
RAWS Observations N N N Y

Return To Table Of Contents


Importing Functions from WxData

"""

***********************************************************************************************


************  This section hosts the Archived Model Data Clients ******************************


***********************************************************************************************
"""

# Global Forecast System (GFS)
# - GFS 0.25x0.25 Degree Primary Parameters
# - GFS 0.25x0.25 Degree Secondary Parameters
# - GFS 0.5x0.5 Degree
from wxdata.archived_data.model_data.noaa.gfs.gfs import(
    get_archived_gfs_0p25,
    get_archived_gfs_0p25_secondary_parameters,
    get_archived_gfs_0p50
)

# Global Ensemble Forecast System (GEFS)
# - GEFS 0.5x0.5 Degree Primary Parameters
# - GEFS 0.5x0.5 Degree Secondary Parameters
# - GEFS 0.25x0.25 Degree
from wxdata.archived_data.model_data.noaa.gefs.gefs import(
    get_archived_gefs_0p50,
    get_archived_gefs_0p50_secondary_parameters,
    get_archived_gefs_0p25
)

# Climate Forecast System (CFS)
# - CFS Flux Products
# - CFS Pressure Products
from wxdata.archived_data.model_data.noaa.cfs.cfs import(
    get_archived_cfs_flux,
    get_archived_cfs_pressure
)

# Real-Time Mesoscale Analysis (RTMA)
from wxdata.archived_data.model_data.noaa.rtma.rtma import get_archived_rtma

"""

***********************************************************************************************


************  This section hosts the Archived Radar Data Clients ******************************


***********************************************************************************************
"""


from wxdata.archived_data.radar_data.nexrad2 import(
    download_archived_single_station_nexrad2_radar_data,
    download_archived_multi_station_nexrad2_radar_data
)

"""

***********************************************************************************************


************  This section hosts the Model Data Clients (Latest Data). ************************


***********************************************************************************************
"""

##############
#### NOAA ####
##############
# Global Forecast System (GFS)
# - GFS 0.25x0.25 Degree Primary Parameters
# - GFS 0.25x0.25 Degree Secondary Parameters
# - GFS 0.5x0.5 Degree
from wxdata.model_data.noaa.gfs.gfs import(
    gfs_0p25,
    gfs_0p25_secondary_parameters,
    gfs_0p50
)

# AI Global Forecast System (AIGFS)
from wxdata.model_data.noaa.aigfs.aigfs import aigfs

# Hybrid Global Ensemble Forecast System (HGEFS)
from wxdata.model_data.noaa.hgefs.hgefs import hgefs_mean_spread

# Global Ensemble Forecast System (GEFS)
# - GEFS 0.5x0.5 Degree Primary Parameters
# - GEFS 0.5x0.5 Degree Secondary Parameters
# - GEFS 0.25x0.25 Degree
from wxdata.model_data.noaa.gefs.gefs import(
    gefs_0p50,
    gefs_0p50_secondary_parameters,
    gefs_0p25
)

# Climate Forecast System (CFS)
# - CFS Flux Products
# - CFS Pressure Products
from wxdata.model_data.noaa.cfs.cfs import(
    cfs_flux,
    cfs_pressure
)

# AI Global Ensemble Forecast System (AIGEFS)
# - AIGEFS Pressure Members (Pressure Level Variables)
# - AIGEFS Surface Members (Surface Level Variables)
# - AIGEFS Single (AIGEFS Ensemble Mean & AIGEFS Ensemble Spread)
from wxdata.model_data.noaa.aigefs.aigefs import(
    aigefs_pressure_members,
    aigefs_surface_members,
    aigefs_single
)

# Real-Time Mesoscale Analysis (RTMA)
# - RTMA Latest 
# - RTMA Comparison Between Two Times 
from wxdata.model_data.noaa.rtma.rtma import(
    rtma, 
    rtma_comparison
)

##############################################################
# European Centre for Medium-Range Weather Forecasts (ECMWF) #
##############################################################
# - ECMWF IFS (0.25x0.25 Degree)
# - ECMWF IFS Ensemble (0.25x0.25 Degree)
# - ECMWF AIFS (0.25x0.25 Degree)
# - ECMWF AIFS Ensemble (0.25x0.25 Degree)
# - ECMWF IFS Wave (0.25x0.25 Degree)
# - ECMWF IFS Wave Ensemble (0.25x0.25 Degree)
# - ECMWF AIFS Wave (0.25x0.25 Degree)
# - ECMWF AIFS Wave Ensemble (0.25x0.25 Degree)
# - ECMWF High Resolution IFS (0.10x0.10 Degree)
# - ECMWF High Resolution IFS Ensemble (0.10x0.10 Degree)
# - ECMWF High Resolution IFS Wave (0.10x0.10 Degree)
# - ECMWF High Resolution IFS Wave Ensemble (0.10x0.10 Degree)
from wxdata.model_data.ecmwf.ecmwf import(
    ecmwf_ifs,
    ecmwf_ifs_ens,
    ecmwf_aifs,
    ecmwf_aifs_ens,
    ecmwf_ifs_wave,
    ecmwf_ifs_wave_ens,
    ecmwf_aifs_wave,
    ecmwf_aifs_wave_ens,
    ecmwf_high_res_ifs,
    ecmwf_high_res_ifs_ens,
    ecmwf_high_res_ifs_wave,
    ecmwf_high_res_ifs_wave_ens
)

##################################
# Canadian Meteorological Center #
##################################
# - Canadian Global Deterministic Prediction System (GDPS)
# - Canadian Regional Deterministic Prediction System (RDPS)
# - Canadian High Resolution Deterministic Prediction System (HRDPS)
# - Canadian Global Ensemble Prediction System (GEPS)
# - Canadian Seasonal to Inter-annual Prediction System (CanSIPS) Forecasts
# - Canadian Seasonal to Inter-annual Prediction System (CanSIPS) Hindcasts
from wxdata.model_data.cmc.gdps.gdps import gdps
from wxdata.model_data.cmc.rdps.rdps import rdps
from wxdata.model_data.cmc.hrdps.hrdps import hrdps
from wxdata.model_data.cmc.geps.geps import geps
from wxdata.model_data.cmc.cansips.forecast.cansips_forecast import cansips_forecast
from wxdata.model_data.cmc.cansips.hindcast.cansips_hindcast import cansips_hindcast



"""
********************************************************************************


************  This section hosts the Fuels Data Clients.  **********************


********************************************************************************
"""

# FEMS RAWS Network
# - Single Station Weather Observations
# - Single Station Fuels Observations
# - Multi Station Weather Observations
# - Multi Station Fuels Observations
# - Current Weather Observations - Multi Station
# - Current Fuels Observations - Multi Station
# - Current Weather Observations - All Stations By State
# - Current Fuels Observations - All Stations By State
# - Single Station NFDRS Forecast
# - Multi Station NFDRS Forecast
# - Single Station Weather Forecast
# - Multi Station Weather Forecast
from wxdata.fuels_data.fems.observations import(
    get_single_raws_station_weather_observations,
    get_single_raws_station_fuels_observations,
    get_multi_raws_station_weather_observations,
    get_multi_raws_station_fuels_observations,
    get_current_multi_raws_station_weather_observations,
    get_current_multi_raws_station_fuels_observations,
    get_current_all_raws_station_weather_observations,
    get_current_all_raws_station_fuels_observations,
    get_single_raws_station_nfdrs_forecast,
    get_multi_raws_station_nfdrs_forecast,
    get_single_raws_station_weather_forecast,
    get_multi_raws_station_weather_forecast
)

# FEMS RAWS Network
# - Single Station Meta Data
# - Multi Station Meta Data
from wxdata.fuels_data.fems.meta_data import(
    get_single_raws_station_meta_data,
    get_multi_raws_station_meta_data
)


"""
********************************************************************************


************  This section hosts the Gridded Forecast Data Clients.  ***********


********************************************************************************
"""

# NOAA 
# - Storm Prediction Center Outlooks
# - Climate Prediction Center Outlooks
# - National Weather Service Forecasts
from wxdata.gridded_forecasts.noaa.nws.nws import(
    get_ndfd_grids,
    get_cpc_outlook
)

"""
*****************************************************************************


************  This section hosts the Observational Data Clients. ************


*****************************************************************************
"""

# Observed Upper-Air Soundings
# (University of Wyoming Database)
from wxdata.observational_data.soundings.wyoming_soundings import get_observed_sounding_data

# METAR Observational Data (From NOAA)
from wxdata.observational_data.metars.metar_obs import download_metar_data

# NEXRAD2 Radar Data
# - NEXRAD2 Radar Single Station
# - NEXRAD2 Radar Multi Station
from wxdata.observational_data.radar.nexrad2 import(
    download_current_single_station_nexrad2_radar_data,
    download_current_multi_station_nexrad2_radar_data
)

"""
*********************************************************************************


************  This section hosts the Model Data Processors. *********************


*********************************************************************************
"""


# Global Forecast System (GFS)
import wxdata.post_processors.gfs_post_processing as gfs_post_processing

# AI Global Forecast System (AIGFS)
import wxdata.post_processors.aigfs_post_processing as aigfs_post_processing

# Hybrid Global Ensemble Forecast System (HGEFS)
import wxdata.post_processors.hgefs_post_processing as hgefs_post_processing

# Global Ensemble Forecast System (GEFS)
import wxdata.post_processors.gefs_post_processing as gefs_post_processing

# AI Global Ensemble Forecast System (AIGEFS)
import wxdata.post_processors.aigefs_post_processing as aigefs_post_processing

# European Centre for Medium-Range Weather Forecasts (ECMWF)
import wxdata.post_processors.ecmwf_post_processing as ecmwf_post_processing

# Climate Forecast System (CFS)
import wxdata.post_processors.cfs_post_processing as cfs_post_processing

# Canadian Meteorological Center Gridded Models
# - Canadian Global Deterministic Prediction System (GDPS)
# - Canadian Regional Deterministic Prediction System (RDPS)
# - Canadian High Resolution Deterministic Prediction System (HRDPS)
# - Canadian Global Ensemble Prediction System (GEPS)
# - Canadian Seasonal to Inter-annual Prediction System (CanSIPS) Forecast
# - Canadian Seasonal to Inter-annual Prediction System (CanSIPS) Hindcast
import wxdata.post_processors.cmc_post_processing as cmc_post_processing

# Real-Time Mesoscale Analysis (RTMA)
from wxdata.post_processors.rtma_post_processing import process_rtma_data


"""
****************************************************************************************************************


************  This section hosts the Data Querying/Transforming Tools & Automation Tools. **********************


****************************************************************************************************************
"""

# WxData function using cartopy to make cyclic points
# This is for users who wish to make graphics that cross the -180/180 degree longitude line
# This is commonly used for Hemispheric graphics
# Function that converts the longitude dimension in an xarray.array 
# From 0 to 360 to -180 to 180
from wxdata.utils.coords import(
    cyclic_point,
    shift_longitude
)

# Functions to pixel query and query pixels along a line between points A and B
# Function to interpolate to n amount of points in between x and y values respectively
from wxdata.utils.tools import(
    pixel_query,
    line_query,
    linear_anti_aliasing
)

# This function executes a list of Python scripts in the order the user lists them
from wxdata.utils.scripts import run_external_scripts

# This function transforms an xarray.array in GRIB2 format to netCDF4 format and writes a netCDF (.nc) file to a user-specified file path. 
from wxdata.utils.transforms import grib_to_netcdf

"""
***************************************************************************


************  This section hosts the Raw Data Clients. ********************


***************************************************************************
"""

# These are the wxdata HTTPS Clients with full VPN/PROXY Support
# Client List:
#  - get_gridded_data()
#  - get_csv_data()
#  - get_excel_data()
#  - get_aws_open_data()
#  - byte_range_request()
import wxdata.client.client as client

"""
***********************************************************************************


************  This section hosts the API Interface Clients. ***********************


***********************************************************************************
"""
#######################
### Open-Meteo API ###
#######################

# Open-Meteo API: https://open-meteo.com/

### Weather Forecasts ###

# - NOAA/NCEP Models
# - ECMWF Models
# - Deutscher Wetterdienst (DWD) Models
# - Meteo-France Models
# - CMC Models
# - Japan Meteorological Agency (JMA) Models
# - UK Met Office (UKMO)
# - Current Weather (Model Mosaic)
# - Google (Weather Next 2 Ensemble)
import wxdata.api.open_meteo_api.weather_forecasts.noaa as open_meteo_api_noaa
import wxdata.api.open_meteo_api.weather_forecasts.ecmwf as open_meteo_api_ecmwf
import wxdata.api.open_meteo_api.weather_forecasts.dwd as open_meteo_api_dwd
import wxdata.api.open_meteo_api.weather_forecasts.meteo_france as open_meteo_api_meteo_france
import wxdata.api.open_meteo_api.weather_forecasts.cmc as open_meteo_api_cmc
import wxdata.api.open_meteo_api.weather_forecasts.jma as open_meteo_api_jma
import wxdata.api.open_meteo_api.weather_forecasts.ukmo as open_meteo_api_ukmo
import wxdata.api.open_meteo_api.weather_forecasts.current_weather as open_meteo_api_current_weather
import wxdata.api.open_meteo_api.weather_forecasts.google as open_meteo_api_google

### Seasonal Forecasts (ECMWF EC46 & SEAS5) ###

# - Daily Data (EC46 & SEAS5)
# - Weekly Data (EC46)
# - Monthly Data (SEAS5)
import wxdata.api.open_meteo_api.seasonal_forecasts.ecmwf_daily as open_meteo_api_ecmwf_seasonal_forecasts_daily
import wxdata.api.open_meteo_api.seasonal_forecasts.ecmwf_weekly as open_meteo_api_ecmwf_seasonal_forecasts_weekly
import wxdata.api.open_meteo_api.seasonal_forecasts.ecmwf_monthly as open_meteo_api_ecmwf_seasonal_forecasts_monthly

### Climate Data ###
import wxdata.api.open_meteo_api.climate.climate_data as open_meteo_api_climate_data

### Air Quality Information ###
import wxdata.api.open_meteo_api.air_quality.cams as open_meteo_api_air_quality

### Marine Forecasts ###
# - Meteo-France
# - Deutscher Wetterdienst (DWD)
# - ECMWF
# - NOAA
import wxdata.api.open_meteo_api.marine_forecasts.meteo_france as open_meteo_api_meteo_france_marine
import wxdata.api.open_meteo_api.marine_forecasts.dwd as open_meteo_api_dwd_marine
import wxdata.api.open_meteo_api.marine_forecasts.ecmwf as open_meteo_api_ecmwf_marine
import wxdata.api.open_meteo_api.marine_forecasts.noaa as open_meteo_api_noaa_marine

### Solar Radiation Forecasts ### 
import wxdata.api.open_meteo_api.solar_radiation.solar_radiation as open_meteo_api_solar_radiation

###################
### Air-Now API ###
###################

# Air-Now API: https://docs.airnowapi.org/

# - Observations
import wxdata.api.airnow_api.observations as air_now_observations


Citations

MetPy: May, R. M., Goebbert, K. H., Thielen, J. E., Leeman, J. R., Camron, M. D., Bruick, Z., Bruning, E. C., Manser, R. P., Arms, S. C., and Marsh, P. T., 2022: MetPy: A Meteorological Python Library for Data Analysis and Visualization. Bull. Amer. Meteor. Soc., 103, E2273-E2284, https://doi.org/10.1175/BAMS-D-21-0125.1.

xarray: Hoyer, S., Hamman, J. (In revision). Xarray: N-D labeled arrays and datasets in Python. Journal of Open Research Software.

cartopy: Phil Elson, Elliott Sales de Andrade, Greg Lucas, Ryan May, Richard Hattersley, Ed Campbell, Andrew Dawson, Bill Little, Stephane Raynaud, scmc72, Alan D. Snow, Ruth Comer, Kevin Donkers, Byron Blay, Peter Killick, Nat Wilson, Patrick Peglar, lgolston, lbdreyer, … Chris Havlin. (2023). SciTools/cartopy: v0.22.0 (v0.22.0). Zenodo. https://doi.org/10.5281/zenodo.8216315

NumPy: Harris, C.R., Millman, K.J., van der Walt, S.J. et al. Array programming with NumPy. Nature 585, 357–362 (2020). DOI: 10.1038/s41586-020-2649-2. (Publisher link).

Pandas: Pandas: McKinney, W., & others. (2010). Data structures for statistical computing in python. In Proceedings of the 9th Python in Science Conference (Vol. 445, pp. 51–56).

dask: Dask Development Team (2016). Dask: Library for dynamic task scheduling. URL http://dask.pydata.org

cfgrib: Author: ECMWF, Year: (2025), Title: cfgrib: A Python interface to map GRIB files to xarray, Source: https://github.com/ecmwf/cfgrib

requests: K. Reitz, “Requests: HTTP for Humans”. Available: https://requests.readthedocs.io/.

Beautiful Soup: Richardson, L. (2025). Beautiful Soup (Version 4.14.3) [Computer software]. https://www.crummy.com/software/BeautifulSoup/

shapeography: Eric J. Drewitz. (2026). edrewitz/shapeography: shapeography 1.0 Released (shapeography1.0). Zenodo. https://doi.org/10.5281/zenodo.18676845

geopandas: Kelsey Jordahl, Joris Van den Bossche, Martin Fleischmann, Jacob Wasserman, James McBride, Jeffrey Gerard, … François Leblanc. (2020, July 15). geopandas/geopandas: v0.8.1 (Version v0.8.1). Zenodo. http://doi.org/10.5281/zenodo.3946761

tqdm: da Costa-Luis, (2019). tqdm: A Fast, Extensible Progress Meter for Python and CLI. Journal of Open Source Software, 4(37), 1277, https://doi.org/10.21105/joss.01277

ecmwf-opendata: European Centre for Medium-Range Weather Forecasts (2026). ecmwf-opendata[Computer software]. GitHub. https://github.com/ecmwf/ecmwf-opendata

openpyxl: Gazoni, E., & Clark, C. (2024). openpyxl: A Python library to read/write Excel 2010 xlsx/xlsm/xltx/xltm files (Version 3.1.5) [Computer software]. https://openpyxl.readthedocs.io/

pyart: Helmus, J.J. & Collis, S.M., (2016). The Python ARM Radar Toolkit (Py-ART), a Library for Working with Weather Radar Data in the Python Programming Language. Journal of Open Research Software. 4(1), p.e25. DOI: 10.5334/jors.119.


Data Sources

1) National Oceanic and Atmospheric Administration/National Center for Environmental Prediction

2) European Centre for Medium-Range Weather Forecasts

3) University of Wyoming

4) National Oceanic and Atmospheric Administration/National Weather Service

5) National Oceanic and Atmospheric Administration/Aviation Weather Center

6) National Oceanic and Atmospheric Administration/Climate Prediction Center

7) Applied Climate Information System (ACIS)

8) USDA Fire Environment Mapping System

9) Open-Meteo API

10) Air Now API

11) Canadian Meteorological Centre

12) Amazon Web Services

13) Google Cloud

Return To Table Of Contents