This user manual includes overviews, procedures and reference for executables, directories and files associated with the SPC (Stereophotoclinometry) software. This users manual was developed in part to fulfill the requirements defined in NASA Procedure Requirement 7150.2A and specifically Software CDRL SW10 explicitly called out in the OSIRIS-REx Project Software Management Plan 0007.

Tools and Installation

The SPC is FORTRAN toolkit to support optical navigation and scientific study of small bodies. The primary purposes of these executable programs are to:

  1. Ingest OSIRIS-REx camera images and characterize any errors in the camera pointing, spacecraft and asteroid position, asteroid control point location and/or rotational kinematics that may lead to navigation errors. These residuals or errors will be reformatted and written out to a file (REGRES file), which will be used as one of the inputs into the MIRAGE navigation program.
  2. Generate numerous data products that will be used for scientific research and analysis, such as the Bennu shape model and high-resolution terrain maps. These products will be used to aide in the sample site selection.

Building and installation of the software is described in UA-HBK-9.4.4-206_SPOC SPC Toolkit Build Instructions. That document describes the operating system, compiler and libraries needed to install SPC from source code. SPC executables can be used to process data without the install, but it is recommended that the directory structure laid out in the Toolkit Build Instructions be followed.


This manual applies to all SPC software versions up through 3.0, including the development versions 2.1A7, 3.0A0 and 3.0A2. The version 3.0A2 release is based on the 2.1A7 module versions with the exception of PROCESS_FITS, GEOMETRY, and REGRES which are at module release level of 3.0A0, 3.0A0, and 3.0A2 respectively. Future builds will bring all modules to a consistent release version to eliminate any confusion.

The SPC Users Manual is intended for trained users who have some supervised training and experience using the programs described here. This manual cannot take the place of experience and time with an instructor who has a deep knowledge of the program and its use. Capable users must develop intuition and insight into the process of building shape models with SPC through practice, and this manual alone cannot provide that insight.

This manual requires that the user have gone through the initial SPC training and have demonstrated Level 1 and Level 2 of the SPC User Skill Levels as described below.

SPC User Skill Levels

Level 1 - Introduction to SPC and the most basic tasks with landmarks.

Level 2 - Basic user - Basic ability to do SPC's most key functions. Can support operations under direct supervision of a fully-trained SPC user. Can run most key SPC functions, but requires help bridging gaps.

Level 3 - Experienced User - Capable of doing all essential functions of SPC to process data and build shape model. Can run most of a project, but would need support for initial setup and trouble shooting.

Level 4 - Expert User - Capable of executing all functions needed to run a SPC project, to include configuration, kernel management and navigation.

Level 5 - Expert Developer. Understands the internal structure of SPC's code and file format in order to make software changes.

This manual does not provide detailed trouble shooting assistance.

What This Manual Includes

Each procedure or reference entry

Some entries include additional references and more detailed information.

How This Manual Is Organized

Part I: Overview

This section provides an overview of SPC and the purpose of the software.

Part II: How Tos

This section organizes the common activities the software is used to achieve into blocks of specific procedures.

Part III: Reference

This part includes reference entries for executables, directories and files. It is arranged alphabetically and subdivided into these sections:

How Standard Items Are Identified

Throughout this manual, we have used these systems for marking the items we discuss:

Scope (last edited 2016-07-26 09:05:30 by BMittan)