= Imager_MG =

||Category D||Version 3.0||

== Description ==

'''Imager_MG''' makes images from a set of maplets. You provide it with a 12 character image name (standard SPC name).  Imager_MG will read the solar position and spacecraft pointing, position, focal length and number of samples/lines to generate model derived image that matches the observing parameters from the source image.  


== Setup ==

 To make images you'll first need the following directories/files in your working directory:

'''Directories:'''
 * TEMPLATES/    - Empty (this is where the .RAW files will be placed)
 * IMAGEFILES/   - Empty
 * SUMFILES/     - Filled (you'll need to copy these files or generate new ones)
 * MAPFILES/     - Filled (these .MAP files will be used to generate the images)
 * SHAPEFILES/   - Filled

'''Files:'''
 * MAPLIST.TXT   - Contains a list of all of the .MAP files. (Can be built from the .MAP file list, but need to remove the ".MAP" from each line. Needs an "END" at the end of the file.

''NOTE!''
 * If REFLECT in INIT_LITHOS.TXT is not "MCEWEN", "VESTA", "NOPHASE", or commented out, the resulting TEMPFILE.pgm will be blank.

== Execution ==

{{{
$ Imager_MG
 input 12-character picture name
P607165886A4
 Save image as template? (y/n)
y

}}}

This will make a .RAW file and place it in TEMPLATES. The format for the .RAW file is the same as a DAT file.

== Output == 

Two options exist.  Either a TEMPLATE file, <imagename>.RAW will be created in the TEMPLATES directory or it will simply make a display image, TEMPFILE.pgm.

Output is an 8-bit image (DN range 0 to 255)

----------
----------
----------
----------

== Other Support ==
A batch script exists to support creating a large number of these files, makeImages.  The source is in the GitHub repository, OREXSupport.

== Execution ==

{{{
sh makeImages.sh
}}}

This will make a .RAW file and place it in TEMPLATES. makeImages.sh should have an "exit" at the end of the loop which will make it generate one .RAW file and then stop. Once you have confirmation that the script is working you can comment out the "exit" so the rest of the script will run.

{{{
sh viewImages.sh
}}}

This will read the .RAW files and make thumbnails for viewing in IMAGEFILES. This shell script can be used even before makeImages.sh is finished, although it will generate some errors. 
 . /!\ Be sure to comment out the "exit" in viewImages.sh to generate all the images. Thumbnails of the images will show up in ~/send/

 * img-list      - Contains a list of all the image names. (Can be built from the .SUM file list, but need to remove the ".SUM" from each line. ''No'' need for an "END." Also ''no'' need for spaces before the image name.)
 * makeImages.sh and viewImages.sh - need to get these from EEP

 . /!\ Be sure to comment out the "exit" in viewImages.sh to generate all the images. Thumbnails of the images will show up in ~/send/