Isis 3 Application Documentation
handmos | Standard View | TOC | Home |
Hand place a cube into a mosaic
Description
Categories
Groups
History
This application allows the user to specify a (sample,line,band) position in a mosaic and places an input cube at that position. If a portion of the input cube falls outside of the dimension of the mosaic, it will be clipped. The line, sample, band size of the mosaic can be set at the time of creation. This application regardless of any priority and flags set, will always place an input on a newly created mosaic. This application also has the ability to track the pixel origin.
There are four different ways/priorities (input, mosaic, band, average) for how the input image has to be placed on the mosaic.
Priority Input will place the input image on top of the mosaic.
Priority Mosaic will place the input image beneath the mosaic.
Priority Band will place the input image on the mosaic based on the "Lessser" or "Greater" criteria between user defined band in the input and the mosaic images.
Priority Average will average the valid pixels in the input and mosaic images. For each mosaic band, a count band is maintained. The count band keeps track of the number of images involved in the averaging of the dn value for each pixel in the mosaic. Choosing this priority will cause the mosaic to have twice the number of bands of the input image, with a count band for each band. Hence the file size of the mosaic is doubled due to the count band.
In case of special pixels and the special pixel flags being enabled, the details for each priority is described below.
Tracking can be set at the time of Mosaic creation only and cannot be turned on after the mosaic is created. But the tracking will be turned off for multiband ONTOP and BENEATH priority even though it was turned on while creating the mosaic. Tracking for multiband input with ONTOP priority is possible only if all the Special Pixel Flags are set to True else the Tracking will be turned off. ONTOP priority basically places all the valid input pixels onto the mosaic unless the special pixel flags are turned on or if mosaic has a NULL pixel. In a multi band scenario, a pixel origin in particular line and sample will not be the same in all the different bands, which means we have to keep track of every pixel in every band. i.e. the size of the tracking bands will be the same as the number of bands in the mosaic.i.e the number of bands will be doubled.
WARNING: If Tracking is turned on in a mosaic, any subsequent applications that modify "dn" values will corrupt the Tracking band. It may be necessary to remove the Tracking band from the mosaic and then add it back after all the processing is complete. See "crop" and "cubeit".
Priority BAND can track origin for multi band input image based on a specified band using LESSER or GREATER than criteria. Each pixel in the specified band is compared to the corresponding pixel in the chosen band in the mosaic based on the chosen criteria. This comparison true or false is used for all the other bands whether the input pixel is copied onto the mosaic and hence the origin for that pixel is stored. Band can be chosen by choosing the TYPE, BANDNUMBER or KEYWORD. If BANDNUMBER is chosen then the band number can be entered in the NUMBER field. If KEYWORD is chosen then PVL key name and value from the BANDBIN group can be entered in the KEYNAME and KEYVALUE fields.
For example, for a multi band input with BAND priority, if the BAND chosen is Emission Angle band(EMA), if input pixels are (30,30,30) in EMA Band for some sample, line and the corresponding pixels in the EMA band in the mosaic has (75, 75, 75) and the criteria is GREATER than, then since input pixels are not GREATER than corresponding mosaic pixels, then the input pixels are not copied to the mosaic, so also the corresponding pixels in all the other bands in the input. Hence the origin for those pixels remains unchanged. If LESSER than was the criteria, then all the corresponding pixels in all the input bands will be copied to the mosaic and the origin for those pixels is the current input image.
There are options like MATCHBANDIN, if set requires the specfied input bands to match the mosaic bands and the bands can be anywhere in the mosaic but must be contiguous for multi-band. If MATCHBANDIN is not set then any input image can be placed on the mosaic within it's boundaries.
Options HIGHSATURATION, LOWSATURATION and NULL if set will cause the the input pixels with these values to be copied to the mosaic for ONTOP and BAND priorities regardless of the CRITERIA for the BAND priority. These options are not supported for BENEATH priority.
Currently Tracking can be viewed in the Advanced Tool Tracking option of the qview application. Following are the Tracking info:
Index : Zero based and is in the order in which the image was placed on the mosaic. No origin is represented as -1.
FileName: File name of input image
Serial Number:Serial Number of the input image
Following are the values for the origin band depending on the pixel type
Pixel Type (bits) | Default (No Origin) | Start Value | Max Value | Total Images Supported |
---|---|---|---|---|
32 | -16777216 | -16777215 | 16777216 | 33549932 |
16 | -32768 | -32767 | 32767 | 65535 |
8 | 0 | 1 | 255 | 255 |
Following is the table for Special Pixel options, input, mosaic
pixels and the resulting output for different priorities.
Tags: F(FALSE), T(TRUE), V(VALID), HS(HIGH SATURATION), LS(LOW SATURATION),
S(SPECIAL PIXEL HS, LS, NULL), N(NULL), I(INPUT), M(MOSAIC), HL(HS,LS)
Priority Beneath | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Priority OnTop | ||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Priority Band | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Priority Average | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Name | Description |
---|---|
FROM | Cube to be placed in the mosaic |
MOSAIC | Mosaic output cube |
PRIORITY | The priority of pixel placement |
Name | Description |
---|---|
TYPE | Indicate the Band name or number to be used for comparison |
NUMBER | Enter the Band Number |
KEYNAME | Enter the Key name as it appears in the PVL |
KEYVALUE | Enter the value associated with the "KEYNAME" |
CRITERIA | The criteria (Lesser or Greater) of pixel placement in a chosen band |
Name | Description |
---|---|
INSAMPLE | This sample in the input cube will be placed at OUTSAMPLE in the mosaic. |
INLINE | This line in the input cube will be placed at OUTLINE in the mosaic. |
INBAND | This band in the input cube will be placed at OUTBAND in the mosaic. |
OUTSAMPLE | The INSAMPLE sample will be placed at this sample in the mosaic |
OUTLINE | The INLINE line will be placed at this line in the mosaic |
OUTBAND | The INBAND band will be placed at this band in the mosaic |
Name | Description |
---|---|
MATCHBANDBIN | Enforce BandBin Group Match |
MATCHDEM | Enforce DEM Match |
HIGHSATURATION | Copy Input HS (Instrument and Representation) values |
LOWSATURATION | Copy Input LS (Instrument and Representation) values |
NULL | Copy Input NULL values |
Name | Description |
---|---|
CREATE | Create the output mosaic |
TRACK | Track the mosaic origin |
PROPAGATE | Propagate the labels, tables, and BLOBs from the input cube. |
NSAMPLES | The number of samples to allocate in the mosaic |
NLINES | The number of lines to allocate in the mosaic |
NBANDS | The number of bands to allocate in the mosaic |
This is the cube which will be placed into the mosaic
Type | cube |
---|---|
File Mode | input |
Filter | *.cub |
The mosaic cube which will have the input cube placed into it. This cube must exist. If you are creating a new mosaic, you can utilize the "makecube" program to generate the base mosaic.
Type | cube |
---|---|
File Mode | output |
Filter | *.cub |
This parameter is used to select one of three ways to mosaic the pixels in areas of overlap.
Type | string | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Default | ONTOP | |||||||||||||||
Option List: |
|
The pixels in this band will be used for comparison between input image and the mosaic for a decision to be made in copying image into the mosaic.
Type | string | |||||||||
---|---|---|---|---|---|---|---|---|---|---|
Default | BANDNUM | |||||||||
Option List: |
|
The band number should match that in the "OriginalBand" of "BandBin" Group
Type | integer |
---|---|
Default | 1 |
The entered key name must match the key name in the "BandBin"
Type | string |
---|---|
Default | OriginalBand |
This value must match the value associated with the key name entered in the KEYNAME
Type | string |
---|---|
Default | 1 |
This parameter is used to select one of two ways to mosaic the pixels in areas of overlap when doing by band comparison.
Type | string | |||||||||
---|---|---|---|---|---|---|---|---|---|---|
Default | LESSER | |||||||||
Option List: |
|
This is a sample in the input image. This sample in the input cube will be placed at OUTSAMPLE in the mosaic.
Type | integer |
---|---|
Default | 1 |
This is a line in the input image. This line in the input cube will be placed at OUTLINE in the mosaic.
Type | integer |
---|---|
Default | 1 |
This is a band in the input image. This band in the input cube will be placed at OUTBAND in the mosaic.
Type | integer |
---|---|
Default | 1 |
This parameter is used to select the starting sample where the input cube will be placed. The sample INSAMPLE will be placed at this sample in the output mosaic.
Type | integer |
---|---|
Default | 1 |
This parameter is used to select the starting line where the input cube will be placed. The line INLINE will be placed at this line in the output mosaic.
Type | integer |
---|---|
Default | 1 |
This parameter is used to select the starting band where the input cube will be placed. The band INBAND will be placed at this band in the output mosaic.
Type | integer |
---|---|
Default | 1 |
This option causes the application to fail if the input bandbin group does not match the mosaic bandbin group.
Type | boolean |
---|---|
Default | TRUE |
This option causes the application to fail if the input DEM shapemodel does not match the mosaic's' shapemodel.
Type | boolean |
---|---|
Default | FALSE |
This option causes High Saturation values (both Instrument and Representation) in the input image to be automatically copied to the mosaic irrespective of the priority
Type | boolean |
---|---|
Default | FALSE |
This option causes Low Saturation values (both Instrument and Representation) in the input image to be automatically copied to the mosaic irrespective of the priority
Type | boolean |
---|---|
Default | FALSE |
This option causes NULL values in the input image to be automatically copied to the mosaic irrespective of the priority
Type | boolean |
---|---|
Default | FALSE |
This parameter is used to specify if the mosaic needs to be created.
Type | string | |||||||||
---|---|---|---|---|---|---|---|---|---|---|
Default | NO | |||||||||
Option List: |
|
If selected the application will track the mosaic origin. Once origin is tracked, the tracker cannot be turned off.
Type | boolean |
---|---|
Default | FALSE |
If selected the application will transfere the lablels, tables, and BLOBs from the input cube to the output mosaic. If not selected only the Band Bin information will be transfered. This option can only be used when the mosaic is being created (i.e., CREATE=YES).
Type | boolean |
---|---|
Default | TRUE |
This parameter is used to select the number of samples in the output mosaic.
Type | integer |
---|---|
Minimum | 1 (inclusive) |
This parameter is used to select the number of lines in the output mosaic.
Type | integer |
---|---|
Minimum | 1 (inclusive) |
This parameter is used to select the number of bands in the output mosaic.
Type | integer |
---|---|
Minimum | 1 (inclusive) |
Jeff Anderson | 2003-07-14 | Original version |
Stuart Sides | 2003-07-29 | Modified filename parameters to be cube parameters where necessary |
Jeff Anderson | 2003-09-19 | Added option to intialize the base mosaic |
Jeff Anderson | 2004-02-17 | Updated progress text and made output create use input cube attributes |
Elizabeth Miller | 2006-09-01 | Added the MATCHBANDBIN option that checks to make sure the input cube bandbin group matches the mosaic bandbin group. The default is true. |
Elizabeth Miller | 2006-09-28 | Added history entry to the output cube |
Steven Lambright | 2008-05-06 | Expanded upon position parameters |
Eric Hyer | 2009-06-11 | Parameter "INPUT" now called "PRIORITY" to be consistent with the mapmos app |
Sharmila Prasad | 2009-09-04 | Added option "TRACK" to track pixel origin. Also added new priority called BAND where specified input and mosaic band is compared for moving input to mosaic and to track the pixel origin. Added parameter "TYPE" to choose Band "NUMBER" or PVL "KEYWORD" from the BandBin group. If "BANDNUMBER" is chosen, then "NUMBER" is activated to enter band number. If "KEYWORD" is chosen then parameter "KEYNAME" and "KEYVALUE" are activated to enter key name and value from the BandBin group for band comparison. Band comparison "CRITERIA" are "LESSER" or "GREATER" than. Also there are options "HIGHSATURATION", "LOWSATURATION" and "NULL", set to true will cause HS, LS and NULL input pixels to be copied to the mosaic regardless of the priorities and criteria. These options are not supported for "BENEATH" priority. |
Sharmila Prasad | 2009-12-16 | Always place an input pixel over a NULL mosaic pixel. Track the origin for multiband ONTOP priority if all the Special Pixel flags are set. Store the Serial numbers of the input mosaic in the mosaic along with the file name. |
Sharmila Prasad | 2010-10-27 | Process Input Image's Attributes |
Sharmila Prasad | 2011-01-19 | Added "AVERAGE" priority where the mosaic will be average of valid input and mosaic pixels. |
Sharmila Prasad | 2011-01-24 | Option to match DEM and also added new group "mosaic" to hold ShapeModel attributes for the mosaic |
Steven Lambright | 2011-10-19 | Output cube when CREATE=yes no longer propagates labels other than the band bin information. |
Sharmila Prasad | 2011-11-07 | Updated documentation for Average priority. Fixes #553 |
Stuart Sides | 2012-01-19 | Added option to have the BLOBs and labels transfered from the input cube transfered to the output mosaic from the input cube. |