X-Files - SPC Wiki

Note: This page has been updated to include information on unofficial versions of the SPC software. This information is current as of the unofficial 20 May 2019 version of SPC.

Introduction

Bob created a suite of programs that handles linescan (push broom) images.

Here are notes about how it works and what we've learned.

displayX

displayX serves the same purpose as display. Users can view images, which can be helpful for adjusting thresholds, treating blemishes, seeing landmark locations, and so forth. The options in display and displayX are similar, except that in displayX the user is not given the option to "show limb? (y/n)". The outputs of displayX and display are also similar. Users can look at TEMPFILE.pgm to see the image. Terminal will report the size of the image, as well as T1, KS, etc. and give the option to copy TEMPFILE.pgm to ./Display/imagenameR.pgm.

registerX

registerX serves the same purpose as register. Users can register images to another image, to a map, or to a shape. registerX has fewer options than register. Specifically, registerX has the following options:

Quit
Change scale
Global shift
Shift unknown (LEFT/RED) image
Change reference
Change RANGE of (LEFT/RED) image
Revert to nominal
Change substrate (f)
Turn on bkg b. Turn on image for Vlm c. Change correlation limit = 0.25 d. Unfix scobj (this is NOT the same as option d in register!)

The following options exist in register, but not registerX.

b. Set a big correlation
Rotate unknown (LEFT/RED) image
Update nominal and quit P. Pole search N. New pole and nominal relative phase R. Rotate body F. Features to body rotation S. Change image stretch
Update illumination G. Get approach range from images O. Find OMEGA W. Write log l. Turn on log d. Fix scobj e. Fix pointing v. Fix center t. Tuck picture

RegisterX also does not list the current picture, current reference, or current scale at the bottom of the menu, but register does.

The outputs of register and registerX are the same: TEMPFILE.pgm and TEMPFILE.ppm that can be used to assess how well the image is registered. See the documentation for register for more details on these files.

lithosX (lithospX does not work, so landmarks with linescan images must be processed serially, which means iterations can take a while).
autoregisterX
residualsX
geometryX
mosaic -- While not an X-file-only tool, is heavily used to support data processing

In addition to Bob's software, Terik and Carolyn modified some other programs so that they work with the X versions of the software:

Specific Object (includes PROCESS_<whatever>)

LRO_setup -- What is needed to make LRO work
PROCESS_HIRISE
PROCESS_HRSC

Specific Projects

Tsiolkovsky -- First project
Ingiini - Evaluation of topography of the lunar swirls

Building Photometic Cubes

A Photometric cube is a abstraction of a physical location on a surface in which every image is registered to an SPC bigmap with backplanes.

Detailed Description -- More info about what a cube is and how to use it.

Channels
- if.cub
- phase.cub
- i.cub
- e.cub
Steps to build -- The details of how to build them

Choose style		book: Create a structured PDF document with headings, chapters, etc. webpage: Specifies that the HTML sources are unstructured (plain web pages.) A page break is inserted between each file or URL in the output. continuous: Specifies that the HTML sources are unstructured (plain web pages.) No page breaks are inserted between each file or URL in the output.
Title		Title of the document for the front page.
Heading 1 as title		Extract the first heading of the document and use it as title. If checked the title field has no effect.
Title file/image		The title image or HTML page. These file has to be an attachments!
Version		Specify document version to be displayed on the title page.
Author		Intellectual property owner of this document.
Copyright		Copyright notice for this document.
Apply page information		Information about who and when modified the document are applied at the end.

Output format		Specifies the output format.
Output options	Grayscale document Title page Compression : JPEG big images

Body color		Enter the HTML color for the body (background).
Body image		Enter the image file for the body (background). These file has to be an attachments!
Text color		Enter the HTML color for the text.
HTTP links color		Sets the color of links.
Style of HTTP links
Create HTTP links		Enables generation of links in PDF files.

Base font size		Set the default size of text.
Line spacing		Set the spacing between lines of text.
Body typeface		Choose the default typeface (font) of text.
Heading typeface		Choose the default typeface (font) of headings.
Header/Footer size		Set the size of header and footer text.
Header/Footer font		Choose the font for header and footer text.
Charset set		Change the encoding of the text in document.
Embed fonts		Check to embed font in the output file.

Page mode		Controls the initial viewing mode for the document. Document: Displays only the docuemnt pages. Outline: Display the table-of-contents outline as well as the document pages. Full-screen: Displays pages on the whole screen; this mode is used primarily for presentations.
Page layout		Controls the initial layout of document pages on the screen. Single: Displays a single page at a time. One column: Displays a single column of pages at a time. Two column left/right: Display two columns of pages at a time; the first page is displayed in the left or right column as selected.
First page		Choose the initial page that will be shown.

Input

Output

Page

Contents

Colors

Fonts

PDF

Security

Expert

About