Skip to main content

Work with declassified keyhole satellite images.

Project description

A library and command-line tools for manipulating declassified imagery.

The primary use for this right now is mosaicking the separate “panel” scans of declassified imagery from EarthExplorer.

Usage

There are two steps to mosaick the panel images:

  1. Use the register subcommand to measure the panels’ overlap. This will typically look something like:

    keyhole register -j coreg.json name_*.tif

    This will create coreg.json with the overlap information.

  2. Then use the mosaick subcommand with the information generated in the previous step to combine the images:

    keyhole mosaick -o output.tif -j coreg.json name_*.tif

The shrink argument is useful for creating smaller preview images:

keyhole mosaick -o out.jpg --shrink 10 -j coreg.json name_*.tif

To create tiled pyramidal images:

keyhole mosaick -o out.tif \
    --tile --pyramid --tile_width 256 --tile_height 256 \
    -j coreg.json name_*.tif

For more information, see keyhole -h.

Installation

Before installation, you must have libvips installed. The procedure for that varies by platform; see the libvips documentation for more info. After that, simply:

pip install keyhole

This installs both the package and the command-line tool keyhole.

You can also run the code as a python module with python -m keyhole.

If you’ve cloned the keyhole repo and you have the dependencies described in pyproject.toml, you can simply run the script at the root of the repo:

python keyhole.py -h

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

keyhole-0.2.1.tar.gz (17.7 kB view details)

Uploaded Source

Built Distribution

keyhole-0.2.1-py3-none-any.whl (19.9 kB view details)

Uploaded Python 3

File details

Details for the file keyhole-0.2.1.tar.gz.

File metadata

  • Download URL: keyhole-0.2.1.tar.gz
  • Upload date:
  • Size: 17.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.12 CPython/3.9.7 Linux/3.10.0-1160.6.1.el7.x86_64

File hashes

Hashes for keyhole-0.2.1.tar.gz
Algorithm Hash digest
SHA256 cd090b1e6131d318ee29e89216ccb6fac0c9d8cc9eac377be2da0b91cbd1da92
MD5 05b6a40a873a9f34987d155d2e018565
BLAKE2b-256 2bb18b0e84e9657a294045f03cf90043cb0beb0fe0b64149deb42db2bd86cc1c

See more details on using hashes here.

File details

Details for the file keyhole-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: keyhole-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 19.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.12 CPython/3.9.7 Linux/3.10.0-1160.6.1.el7.x86_64

File hashes

Hashes for keyhole-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 cd590772e45bb7f7627d2635fd4c8c834e0b71395f2be6a7ee36fb06c7ae154f
MD5 d0a88b51a1f9739c61ac41e6ebec710b
BLAKE2b-256 83dcf38a6075d6f42239c12d9b4c52a8a72389d60d498d96b586ede447e0d830

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page