This is a Python software library that facilitates the geolocation of photographs and video frames from the International Space Station (ISS). The library provides functions that take camera and pointing information, along with publicly available ISS position information, and then will geolocate every pixel of the photograph in latitude and longitude. This enables geospatial analysis of astronaut photography from Earth, including pictures of clouds, lightning, coastlines, city lights, etc. Many images available from https://eol.jsc.nasa.gov/ can be fully geolocated using this software.
The code now also enables geolocation of the ISS Lightning Imaging Sensor (LIS) background imagery datasets. These data are available from http://dx.doi.org/10.5067/LIS/ISSLIS/DATA206 and http://dx.doi.org/10.5067/LIS/ISSLIS/DATA207.
ISS Camera Geolocate works under Python 3.6+ on most Mac/Linux setups. Windows installation and other Python versions are currently untested.
In the main source directory:
python setup.py install
The following dependencies need to be installed first:
- A robust version of Python w/ most standard scientific packages (e.g.,
numpy,datetime,astropy, etc.) - Get one for free here. - SGP4 -Cartopy -Cython -Xarray
To access everything:
import iss_camera_geolocate as icg
Demonstration notebooks are in the notebooks directory.
Latest release info:
