Skip to content

NASA-AMMOS/AFIDS-POMM

Repository files navigation


AFIDS-POMM

Planetary Orbital Mosaicking and Mapping (POMM) is a set of workstation tools supporting the
automation of planetary orbital mosaicking and mapping requirements.

POMM is designed to provide the planetary scientist, student, and enthusiast with easy-to-use tools that perform basic functions necessary for most satellite mapping and analysis studies.

image

POMM was funded by the Advanced Multi-Mission Operations System (AMMOS) which supports NASA robotic missions with tools for planetary exploration, including Earth and space science. Available AMMOS tools are described in the online AMMOS catalog. AMMOS is managed by the Multi-Mission Ground Systems (MGSS), a division of the NASA Interplanetary Network Directorate.

NASA Ammos

Features

  • The ability to co-register (stack) multiple images over the same location for time series analysis
  • Mosaic multiple adjacent images to create large-area base map coverages and regional overviews
  • Create map-projected orbital satellite images from selected sensors and bands provided in raw PDS format

image image image

POMM is a set of workstation tools supporting the automation of planetary orbital mosaicking and mapping requirements. POMM is designed to enable the planetary scientist, student, and enthusiast with easy-to-use tools that perform the basic functions needed for most satellite mapping and analysis studies. These capabilities include: 1) The ability to co-register (stack) multiple images over the same location for time series analysis; 2) Mosaic multiple adjacent images to create large-area base map coverages and regional overviews; and 3) Create map-projected orbital satellite images from selected sensors and bands provided in raw PDS format.

POMM (v1) supports the co-registration and mosaicking of (existing) single-band map-projected orbital images of Mars, Earth, and the Earth’s Moon (excluding polar areas). However, if mapprojected images are not available, POMM can create them from their raw/EDR PDS format for the following mission sensors:

  • Mars Reconnaissance Orbiter (MRO) Context Camera (CTX);
  • MRO High Resolution Imaging Science Experiment (HiRISE) Red-band;
  • Mars Express (MEX) High Resolution Stereo Camera (HRSC) “level-2” format;
  • Lunar Reconnaissance Orbiter (LRO) Narrow Angle Camera (NAC “LE/RE” format); and
  • LRO Wide Angle Camera (WAC “CC” format) COLOR VIS bands

POMM was funded by the Advanced Multi-Mission Operations System (AMMOS) which supports NASA robotic missions with tools for planetary exploration, including earth and space science. All available AMMOS tools (and how to obtain them, including POMM) are described in the online AMMOS catalog . AMMOS is managed by the Multi-Mission Ground Systems (MGSS), a division of the NASA Interplanetary Network Directorate.

Contents

Quick Start

This guide below provides a quick way to get started with AFIDS-POMM. Please see the AFIDS-POMM User Guide for a more comprehensive guide.

Setup Instructions

POMM is distributed as a Docker image, which can be used to run the POMM software. The docker image is available at the releases page.

POMM Ancillary Data Download

The POMM mosaicking and co-registration tools have all their required ancillary data built-in to the docker. However, the map projection tools require a planetary DEM (elevation/height) model and Sensor-base SPICE Kernel information, which must be obtained from external sources.

DEM Data

Global Mars and Lunar/Moon elevation models can be downloaded from the following locations. Because these are large files, be sure to include available restart options, for example, use “—continue” with wget, or “-C” with curl.

The files are downloaded in “bigtiff” format, which should be converted to VICAR format for ease of use:

gdal_translate -of VICAR <input>.tif <output>.vic

ISIS data

POMM makes use of the ISIS software. The software is included in the POMM Docker image, but because of its size the support data for ISIS needs to be downloaded separately.

There are two sets of ISIS data. One set is the specific data needed to process an image (e.g., the specific NAIF kernels to support the time range of the data), POMM automatically downloads this as needed. There is also a set of "core" data needed for all ISIS processing, this needs to be downloaded and then provided to the Docker image for its use (e.g., as a Docker volume).

The ISIS data is downloaded using Rclone, this should be installed on your system (e.g. install the yum package "rclone" on a Red Hat system).

The directions for downloading can be found on the ISIS download directions. In addition the file "rclone.conf" should be copied to this directory. As a convenience, there is a isis_data_download.sh script that can be run to download this data.

./isis_data_download.sh <directory to place data>

Run Instructions

Please see Docker Quick Start for directions on using the docker image. Also see Docker GUI Appendum for information on using the GUI app.

Changelog

See our releases page for our versioned releases.

Frequently Asked Questions (FAQ)

Q: When will AFIDS-POMM be available?

A: The first AFIDS-POMM downloadable docker release has been posted in April 2023 and is available now.

Q: Where can I find the AFIDS POMM source code?

A: We're currently in the process of merging portions of AFIDS into VICAR. When the merging is complete, the AFIDS-POMM source code will be posted in the VICAR open source repo and will be maintained there going forward.

Support

Key points of contact are:

Tom Logan

Mike Smyth