https://github.com/liamtoney/planet_thumbs

A tool for downloading Planet Labs imagery thumbnails for Alaskan volcanoes
https://github.com/liamtoney/planet_thumbs

satellite-imagery volcanoes

Last synced: about 1 month ago
JSON representation

A tool for downloading Planet Labs imagery thumbnails for Alaskan volcanoes

• Host: GitHub
• URL: https://github.com/liamtoney/planet_thumbs
• Owner: liamtoney
• License: mit
• Created: 2020-02-14T09:40:31.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2020-07-03T05:17:02.000Z (over 4 years ago)
• Last Synced: 2024-01-29T17:55:01.083Z (11 months ago)
• Topics: satellite-imagery, volcanoes
• Language: Python
• Homepage:
• Size: 302 KB
• Stars: 5
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# planet_thumbs

A tool for downloading Planet Labs imagery thumbnails, like the one below, for

Alaska volcanoes. (Also provides a shell script for downloading full-resolution

images.)

![](example_thumbnail.jpg)



  Augustine Volcano on 10 February 2020. Imagery © 2020 Planet Labs.



## Quickstart

**NOTE:** Both scripts require a valid Planet Labs API key. Set the environment

variable `PL_API_KEY` to your key's value prior to running either script. To

sign up for the Planet Labs Education and Research Program, go

[here](https://www.planet.com/markets/education-and-research/).

1. Prepare

   ```

   conda create -n planet_thumbs -c conda-forge jq planet

   conda activate planet_thumbs

   ```

2. Obtain

   ```

   git clone https://github.com/liamtoney/planet_thumbs.git

   cd planet_thumbs

   ```

3. Run

   ```

   python planet_thumbs.py 

   ```

   or

   ```

   ./download_planet_asset   

   ```

## Examples

1. To grab the most recent thumbnails for Korovin Volcano, run

   ```

   python planet_thumbs.py korovin

   ```

   which produces the following thumbnails (when run on 17 March 2020).

   ```

   korovin_20200217_215658_99_106c_PSScene3Band.png

   korovin_20200203_220225_16_106a_PSScene3Band.png

   korovin_20200129_215846_15_106e_PSScene3Band.png

   korovin_20200116_221649_101e_PSScene3Band.png

   korovin_20191220_220344_71_1067_PSScene3Band.png

   ```

   Output files have the format

   ```

   __.png

   ```

2. To grab the full-resolution visual image corresponding to the first thumbnail

   listed above, run

   ```

   ./download_planet_asset 20200217_215658_99_106c PSScene3Band visual

   ```

   which downloads the full-resolution product as

   ```

   20200217_215658_99_106c_PSScene3Band_visual.tif

   ```

## Notes

1. The first time `download_planet_asset` is run for a given item, the item

   is "activated" (queued for downloading). Repeated calls to the script will

   print `activating` until the item is queued; then a call to the script will

   download the file.

2. The downloading script is only designed to work with `` values

   of `analytic` (usually requires processing to be viewable, contains all image

   data) and `visual` (immediately openable and viewable, less information).