Home

User Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Contributor Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Quick Links

Software Manual
AstroDiscuss
GitHub
API Reference

Documentation Versions


ISIS 2

Documentation
Tutorials
Technical Documents
USGS

ISIS Application Documentation


noseam

Standard View | TOC | Home

Create a mosaic with little to no seams using a list of map projected cubes

Description
Categories
Groups
Examples
History


Description

This program, noseam, creates a mosaic using an algorithm that minimizes seams. The user will enter a text-based list of cubes that must be 1) in the same map projection and 2) contain equivalent projection parameters such as PixelResolution, CenterLongitude, and LatitudeSystem. More help is given in the Parameter Groups and with examples at the end of this document. To generate the mosaic, noseam uses the automos application. The FROMLIST and MATCHBANDBIN parameters are taken from noseam and forwarded to automos as well as the remainder of the parameters except with their default values. To learn more about automos parameters, see the automos application documentation.

Categories


Parameter Groups

Files

Name Description
FROMLIST List of cubes to mosaic
TO Mosaic output cube

Filter Sizes

Name Description
SAMPLES Number of samples for the boxcar filters
LINES Number of lines for the boxcar filters

BandBin Option

Name Description
MATCHBANDBINEnforce BandBin Group Match

Intermediate Data

Name Description
REMOVETEMP Destroy intermediate data

Files: FROMLIST

Description

A list of map projected cubes to mosaic seamlessly. The Mapping groups must match in order to mosaic the cubes.

Type filename
File Mode input
Filter *.txt *.lis *.lst

Files: TO

Description

The resulting mosaic, which will be created from the listed cubes.

Type cube
File Mode output
Filter *.cub

Filter Sizes: SAMPLES

Description

This is the total number of samples in the boxcar dimension applied using the highpass and lowpass filters. The number must be odd and cannot exceed twice the number of samples in the input cubes. The smaller the boxcar dimension, the more confined the filtered results are near the image seams, which will remain similar to the original mosaic. The larger the boxcar dimension, the greater the extent of the filter effects are beyond the seams.

Type integer
Minimum 1 (inclusive)
Odd This value must be an odd number

Filter Sizes: LINES

Description

This is the total number of lines in the boxcar dimension applied using the highpass and lowpass filters. The number must be odd and cannot exceed twice the number of lines in the input cubes. The smaller the boxcar dimension, the more confined the filtered results are near the image seams, which will remain similar to the original mosaic. The larger the boxcar dimension, the greater the extent of the filter effects are beyond the seams.

Type integer
Minimum 1 (inclusive)
Odd This value must be an odd number

BandBin Option: MATCHBANDBIN

Description

This option causes the application to fail if the input bandbin group does not match the mosaic bandbin group.

Type boolean
Default TRUE

Intermediate Data: REMOVETEMP

Description

Multiple cube images as well as lists are created during the production of the final seamless mosaic. If this parameter is changed to false, those temporary cubes and lists will not be destroyed.

If REMOVETEMP=NO:

Type boolean
Default TRUE

Examples


Example 1

No Seam Result

Description

This example shows how noseam works upon a small mosaic and compares that result to an automos output.

Command Line

noseam FROMLIST=cubes.lis TO=final.cub SAMPLES=73 LINES=73
Runs noseam with a 73x73 highpass filter and a 73x73 lowpass filter.

Input Images

cube1.cub

First listed cube

This is the first cube listed in cubes.lis.

cube2.cub

Second listed cube

This is the second cube listed in cubes.lis.

cube3.cub

Third listed cube

This is the third cube listed in cubes.lis.

Data File

cubes.lis This is a text-based file that lists all of the cubes to mosaic. This list as well as the cubes to be mosaicked must be within the current directory when noseam is executed.

Output Images

final.cub

The resulting mosaic

Parameter Name: TO

This is the resulting mosaic final.cub.

automos.cub

Automos result (NOT AN OUTPUT OF NOSEAM)

This is the same mosaic created using automos. Notice the difference between automos.cub and final.cub. The seams that existed between the original images in automos are nearly invisible in final.cub.


History

Christopher Austin2008-1-03 Original version
Steven Lambright2008-10-24 This program was using the input folder as a temporary folder, instead of looking up the user's preferences to find the correct temporary folder. This program will now use the correct temporary folder.
Kelvin Rodriguez2016-6-29 Added a short description of how noseam utilizes automos in the documentation.
Makayla Shepherd2016-8-18 The noseam parameters HNS HNL LNS and LNL, which correspond to the size of the boxcar for the highpass and lowpass filters, have been condensed down to two parameters, SAMPLES and LINES as the size of the boxcars must be the same. Fixes #258.