Skip to main content

The modules available in this package are designed to capture and proccess satellite data from Copernicus

Project description

Satellite Weather Downloader

Xarray Copernicus
Xarray Copernicus

SWD is a system for downloading, transforming and analysing Copernicus weather data using Xarray. It consists in two major apps, satellite_downloader and satellite_weather. downloader is responsible for extracting NetCDF4 files from Copernicus API, and the weather implements Xarray extensions for transforming and visualizing the files.

Installation

The app is available on PYPI, you can use the package without deploying the containers with the command in your shell:

$ pip install satellite-weather-downloader

Requirements

For downloading data from Copernicus API, it is required an account. The credentials for your account can be found in Copernicus' User Page, in the API key section. User UID and API Key will be needed in order to request data. Paste them when asked in satellite_downloader connection methods.

Notes

Python Versions = [3.10, 3.11]

Version 1.X includes only methods for Brazil's data format and cities.

Creating requests via Interactive shell

Since SWT version 1.5, it is possible to create dynamic requests using the interactive python shell or via method call:

from satellite_downloader import request

file = request.ERA5_reanalysis(
    filename = 'my_dataset_file'
    # Any ERA5 Reanalysis option can be passed in the method
)
NOTE: This feature is still in experimental versions, please submit an issue if you find any bug.

Usage of copebr extension

import satellite_downloader
import satellite_weather

file = satellite_downloader.download_br_netcdf('2023-01-01', '2023-01-07')
br_dataset = satellite_weather.load_dataset(file)
rio_dataset = br_dataset.copebr.ds_from_geocode(3304557) # Rio de Janeiro's geocode
rio_dataframe = rio_dataset.to_dataframe()

It is also possible to create a dataframe directly from the National-wide dataset:

br_dataset.copebr.to_dataframe(3304557)

All Xarray methods are extended when using the copebr extension:

rio_dataset.precip_med.to_array()
rio_dataset.temp_med.plot()

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

satellite_weather_downloader-1.5.3.tar.gz (155.4 kB view details)

Uploaded Source

Built Distribution

File details

Details for the file satellite_weather_downloader-1.5.3.tar.gz.

File metadata

  • Download URL: satellite_weather_downloader-1.5.3.tar.gz
  • Upload date:
  • Size: 155.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.3.2 CPython/3.11.0 Linux/5.15.0-1031-azure

File hashes

Hashes for satellite_weather_downloader-1.5.3.tar.gz
Algorithm Hash digest
SHA256 4ac23427da0931816c1f4b0b9f3cf0aabab0432370d261d2a210a456c6e2ec32
MD5 1ddca39efa54aed7dbd063a2ac556e82
BLAKE2b-256 93cf590af4e406c163326edabd05451bbbf7b8be09c06c07eac36987e5a51b80

See more details on using hashes here.

File details

Details for the file satellite_weather_downloader-1.5.3-py3-none-any.whl.

File metadata

File hashes

Hashes for satellite_weather_downloader-1.5.3-py3-none-any.whl
Algorithm Hash digest
SHA256 0e1ea2fe68e30f3a4a3e0cd75f33c5d691f5b02a8f949a142abe01fb9ca334d3
MD5 234ac6bbd357e48589c325ac9fa71bd5
BLAKE2b-256 8abac50915a893e5e0e5f74f91f70787b7ff63dfbab5455ea2d81e3523bed54f

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page