Skip to main content

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)

Source distribution for goes2repro 1.0.1
File Size Uploaded
goes2repro-1.0.1.tar.gz 6.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for goes2repro 1.0.1
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page