Skip to content

Latest commit

 

History

History
139 lines (111 loc) · 6.55 KB

README.md

File metadata and controls

139 lines (111 loc) · 6.55 KB

DSAT-cli

A command-line implementation of the DSAT/INPE tool in Python. This tool downloads images and products taken by the GOES-16 satellite, processed by National Institute for Space Research (INPE) and creates animations/GIFs from those images. See an example below.

DSAT is the INPE's GOES-16 satellite image viewer application. Visit www.cptec.inpe.br/dsat 🌎🛰️

Note: DSAT-cli implementation is inspired by https://github.com/colinmcintosh/SLIDER-cli and @colinmcintosh.

Motivation

This tool is meant to replicate most of the features of DSAT and includes some additional flexibility in configuration options. The goal of this utility is to resolve some common issues with the DSAT web interface, specifically:

  • Missing tiles / tiles not being rendered on animation export
  • Slow to generate animations
  • Web browser may crash for complex animations
  • Limited options for features like time-step and speed

Products

Ch01 Ch02 Ch03 Ch04
Ch05 Ch06 Ch07 Ch08
Ch09 Ch10 Ch11 Ch12
Ch13 Ch14 Ch15 Ch16
Ch08 (WVCOLOR35) Ch09 (WVCOLOR35) Ch10 (WVCOLOR35)
Ch13 (IR4AVHRR6) Ch13 (DSA)
Airmass Ash Cloud Phase (Eumetsat) Cloud Phase (JMA)
Convective Storm Day Snow Fog Differential WV Dust
Fire Temperature Natural Color Night Microphysics Simple WV
SO2 True-color + Ch13 (DSA)

Install

Clone the DSAT-Cli Repository:

git clone https://github.com/uba/DSAT-cli.git

Go to the source code folder:

cd DSAT-cli

Install:

pip3 install -r requirements.txt

Usage

dsat-cli.py --help
usage: dsat-cli [-h]
                [--product {ch01,ch02,ch03,ch04,ch05,ch06,ch07,ch08,ch09,ch10,ch11,ch12,ch13,ch14,ch15,ch16,ch08_cpt_WVCOLOR35,ch09_cpt_WVCOLOR35,ch10_cpt_WVCOLOR35,ch13_cpt_IR4AVHRR6,ch13_cpt_DSA,airmass,ash,cloud_phase_eumetsat,day_cloud_phase_jma,convective_storm,day_snow_fog,differential_wv,dust,fire_temperature,natural_color,night_microphysics,simple_wv,so2,true_color_ch13_dsa}]
                [--date DATE] [-i I] [--time-step TIME] [--level {2,3,4,5,6,7}] [--tiles-extent xmin ymin xmax ymax]      
                [--speed SPEED] [--processes PROCESSES] --output OUTPUT [--verbose] [--version]

DSAT-Cli. Copyright (C) 2021-2022 INPE.

optional arguments:
  -h, --help            show this help message and exit
  --product, -p         Product that will be retrieved
  --date DATE, -d DATE  Desired image datetime. Format: YYYYMMDDhhmm
  -i I                  Number of images that will be requested from the given date as start.
  --time-step TIME, -t TIME
                        Interval of image capture times in minutes. (default 10)
  --level {2,3,4,5,6,7}, -l {2,3,4,5,6,7}
                        Level (zoom) that will be retrieved
  --tiles-extent xmin ymin xmax ymax
                        Optional tiles extent
  --speed SPEED         Frame rate, i.e. time between two consecutive frames. Default: 0.5 (in seconds)
  --processes PROCESSES
                        Number of processes to use for image requests. Default: Number of CPUs
  --output OUTPUT, -o OUTPUT
                        Output filename to save resut
  --verbose             Increase output verbosity
  --version, -v         show program's version number and exit

Tip: You can search tile-extent numbers here Tiles.

Example Usage

# Download single image (2021/11/12 - 12:00 UTC) Full-disk at level 2
dsat-cli.py -p true_color_ch13_dsa -d 202111121200 -i 1 -l 2 -o full-disk.png

# Download animation (Start 2021/11/12 - 12:00 UTC + 17 images, step 10 min) Brazil at level 4
dsat-cli.py -p true_color_ch13_dsa -d 202111121200 -i 18 -l 4 --tiles-extent 5 4 9 8 -o brazil-l4-anim.gif

# Download animation (Start 2021/11/12 - 12:00 UTC + 17 images, step 10 min) Fortaleza - CE at level 6
dsat-cli.py -p true_color_ch13_dsa -d 202111121200 -i 18 -l 6 --tiles-extent 34 22 35 23 -o fortaleza-l4-anim.gif

# Download animation (Start 2021/11/12 - 12:00 UTC + 17 images, step 10 min) Brasília - DF at level 7
dsat-cli.py -p ch02 -d 202111091200 -i 18 -l 7 --tiles-extent 63 55 63 55 -o brasilia-l7-anim.gif

License

Copyright (C) 2020-2021 INPE.

DSAT-Cli is free software; you can redistribute it and/or modify it under the terms of the MIT License; see LICENSE file for more details.