The modules available in this package are designed to capture and proccess satellite data from Copernicus
Project description
Satellite Weather Downloader
| 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.
Create 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.
Extract Brazil NetCDF4 file from a date range
from satellite import downloader
file = downloader.download_br_netcdf('2023-01-01', '2023-01-07')
Load the dataset
from satellite import weather as sat
br_dataset = sat.load_dataset(file)
Usage of copebr extension
rio_geocode = 3304557 # Rio de Janeiro's geocode (IBGE)
rio_dataset = br_dataset.copebr.geocode_ds(rio_geocode)
rio_dataset.to_dataframe(rio_geocode)
It is also possible to create a dataframe directly from the National-wide dataset:
br_dataset.copebr.to_dataframe(rio_geocode)
All Xarray methods are extended when using the copebr extension:
rio_dataset.precip_med.to_array()
rio_dataset.temp_med.plot()
Usage of DSEI extension
yanomami_ds = ds.DSEI['Yanomami']
yanomami_polygon = ds.DSEI.get_polygon('Yanomami')
List all DSEIs
ds.DSEI.DSEIs
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file satellite_weather_downloader-1.10.1.tar.gz.
File metadata
- Download URL: satellite_weather_downloader-1.10.1.tar.gz
- Upload date:
- Size: 8.2 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.8.3 CPython/3.11.9 Linux/6.5.0-1021-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | ab29ee79f918e5e10ac13c0dfacfc120509541db8711810cf53f7f0ada4e7a40 |
|
| MD5 | 74c20f15bf1fb0eded65031543ec7d6a |
|
| BLAKE2b-256 | 51567b877621f855497596ee77b81bca87843aa30cee2bb805443c86ff64b3bd |
File details
Details for the file satellite_weather_downloader-1.10.1-py3-none-any.whl.
File metadata
- Download URL: satellite_weather_downloader-1.10.1-py3-none-any.whl
- Upload date:
- Size: 8.3 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.8.3 CPython/3.11.9 Linux/6.5.0-1021-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 57a40eb73c01586e73e20f809b9d5f1d5289057a958b45e2e4d259e67b22e3c6 |
|
| MD5 | cb8c84fcc3c3b5bd04806fd12ee29f76 |
|
| BLAKE2b-256 | 68f17b98e67c06c09d9406b224b733ec4448ef5d1de4597d865b2f03d7ddc236 |
