CASSINI Procedures

To ingest images, you first need to setup the directory. The programs are (to JRW's knowledge) unique to CASSINI.

Directory Structure

Saturn

CASSINI
- DATA
- UTILITIES
Dione
Mimas
Etc

Contents of the CASSINI Directory

DATA has all the kernels in it, with no subdirectories. Will also need cumindex.tab (Cumulative Image Index provided by the PDS) in this directory, as well as TABLE.TXT (used to convert images to 12 bit).
UTILITIES has three files.
- list.e - User inputs object name (i.e. DIONE, TETHYS, etc. all caps!!!) and the minimum size of the object in pixels. Use this to flush out low resolution images (list.e scales the size of the body) and make a list of images to download and an input file for the next utility. Source is here list.f
- convert.e - Enter the object name as "OBJ.TXT" where OBJ is the object name you entered previously. Puts the DAT image files into IMAGEFILES and makes make_sumfiles.in. Source is here convert.f
- make_sumfiles.e - Makes the SUMFILES. When it asks if you want to "Include Pole (y/n)" SAY NO!!! Bob toyed with the idea of putting the pole into the SUMFILE, but never implemented that.

# Below is from Bob's email 29 July 2020
../CASSINI/UTILITIES/list.e
DIONE
100   <- minimum size in pixels
  [makes DIONE.TXT and b/w coverage plot]
  [makes ./NEW_IMAGES/download.b]

cd NEW_IMAGES
chmod +x download.b
./download.b

cd ..

../CASSINI/UTILITIES/convert.e     <- this is equivalent to PROCESS_IMG
DIONE.TXT

  [makes images and puts into IMAGEFILES]
  [makes make_sumfiles.in]

../CASSINI/UTILITIES/make_sumfiles.e
 0.  Create new SUMFILES & NOMINALS and ..
 1.  Update old NOMINALS and ..
 2.  Update old SUMFILES 
0
 Include Pole? (y/n)
n                                  <- ALWAYS SAY NO!

Potential Errors

When you run the output from list.e (i.e. NEW_IMAGES/download.b) you get an <Name>.IMG file for each image, even if there was an error in the download. If you don't notice there was an error and run convert.e, you get an error that looks like this ...

<rand> Iapetus$ ../CASSINI/UTILITIES/convert.e 
 INPUT LIST
IAPETUS.TXT
At line 118 of file convert.f (unit = 10, file = 'NEW_IMAGES/N1483150865_1.IMG')
Fortran runtime error: Non-existing record number

This happened to JRW because the directory structure on the PDS server is different from that in cumindex.tab. You'll have to re-download the files.

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

Directory Structure

Contents of the CASSINI Directory

Potential Errors

Encryption		Check to number all of the headings in the document.
Permissions	Print Modify Copy Annotate	Specifies the document permissions.
User password		Specifies the user password to restrict viewing permissions on this PDF document. Empty for no encryption.
Owner password		Specifies the owner password to control who can change document permissions etc. If this field is left blank, a random 32-character password is generated so that no one can change the document.

Language translation		Specify language to use for date and time format.
Dynamic code block		Shrink code blocks on page.
Lines in code block		Show line numbers for code blocks.
Use dots instead of spaces in code blocks		Make spaces visable by dots (·) instead of white spaces.
Use a para character for line breaks		Make line breaks visable by a extra character (¶) at the end.
Enable debugging information		Enable this feature if you searching for problems or intent to report a bug report