GOES2REPRO
GOES2REPRO is a utility script that leverages functions from the goes2go library, but focuses on downloading, cropping, and reprojecting GOES satellite data. Allowing users to download data, crop it to a specific geographic area, and reproject it into the EPSG:4326 coordinate reference system. The script provides flexibility for selecting different products, channels, and satellites, with easy integration for parallel processing.
Features
- Download and process GOES-16 satellite data from S3 using the goes2go library.
- Crop and reproject the data to EPSG:4326 CRS.
- Filter the data by specific time ranges, hours, and minutes.
- Enable parallel processing for faster data handling.
- Output processed data as NetCDF files.
- Log failed downloads to
fail.log.
Available Products
The script supports various GOES-16 products, which include different channels and satellites. A full list of available products, channels, and satellites can be found in the product_table.txt.
Installation
Prerequisites
You can install the necessary dependencies using pip:
pip install goes2repro
Usage
Command-Line Arguments
The script uses the argparse module for handling command-line arguments. Below are the available options:
goes2repro [OPTIONS]
| Option | Description |
|---|---|
--satellite |
Name of the satellite (e.g., goes16). |
--product |
Name of the satellite product (e.g., ABI-L2-CMIPF). For a list of available products, see product_table.txt. |
--var_name |
Variable name to extract (e.g., CMI). |
--channel |
Channel to use (e.g., 13). |
--start_date |
Start date in YYYY-MM-DD HH:MM:SS format (default: 2022-12-15 00:00:00). |
--end_date |
End date in YYYY-MM-DD HH:MM:SS format (default: 2022-12-15 01:00:00). |
--period |
Frequency for the time range (default: "10 min"). |
--between_hours |
Filter data between these hours (default: [0, 23]). |
--between_minutes |
Filter data between these minutes (default: [0, 60]). |
--output_path |
Path for saving output files (default: output/). |
--parallel |
Enable parallel processing (default: True). |
--processes |
Number of processes for parallel execution (default: 4). |
--lat_min |
Minimum latitude of the bounding box (default: -56). |
--lat_max |
Maximum latitude of the bounding box (default: 35). |
--lon_min |
Minimum longitude of the bounding box (default: -116). |
--lon_max |
Maximum longitude of the bounding box (default: -25). |
--max_attempts |
Number of attempts to download a file before logging a failure (default: 3). |
Examples
To use the script to download and process data for the GOES-16 satellite, ABI-L2-CMIPF product, variable CMI, and channel 13, with a time range of 2022-12-15 from 00:00:00 to 01:00:00, run the following command:
goes2repro --satellite goes16 --product ABI-L2-CMIPF --var_name CMI --channel 13 --start_date "2022-12-15 00:00:00" --end_date "2022-12-15 01:00:00"
To download and process recent 30-minute data for the GOES-16 satellite, ABI-L2-CMIPF product, variable CMI, and channel 13, run the following command:
goes2repro --satellite goes16 --product ABI-L2-CMIPF --var_name CMI --channel 13 --recent 30 --output_path "output/"
Credits
All the credit goes to the original author of the goes2go library. And this is a otimization by Helvecio Neto - 2025
Metadata
Release files for goes2repro 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| goes2repro-1.0.1.tar.gz | 6.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| goes2repro-1.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 13.5 kB
Release files / goes2repro-1.0.1.tar.gz
| Download URL | goes2repro-1.0.1.tar.gz |
|---|---|
| Size | 6.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b2023431814042c29f498c5cb47f28bfe2e9a79f81255dc10a36ce355ecf7260
|
|
BLAKE2b-256 checksum How to use checksums |
3eaabb9d99f549e35de1a3607a36178d33b4dc4ac68281cd6b243e337a29a394
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.0.1 CPython/3.12.7
|
Release files / goes2repro-1.0.1-py3-none-any.whl
| Download URL | goes2repro-1.0.1-py3-none-any.whl |
|---|---|
| Size | 7.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
634a105f11ba8dd7ea13e1f938464959c238eef0de66835c025765adef33de29
|
|
BLAKE2b-256 checksum How to use checksums |
4f6eac4680ee4d28d7a217def52147e23d8f547830922b6c137f9dd7bc69b2a9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.0.1 CPython/3.12.7
|