Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock ( ) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

ISIS Documentation

noseam

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

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

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.
Ken Edmundson2024-8-25 Converted noseam to callable app. Also converted Makefile test to gtest format.

Parameters

Files

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

The resulting mosaic, which will be created from the listed cubes.
Type cube
File Mode output
Filter *.cub

Filter Sizes

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

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

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

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:

  • OriginalMosaic.cub - This file is the mosaic result (automos) of the input cubes listed in FROMLIST.
  • LowpassMosaic.cub - This file is the low pass filter (samples x lines) applied to the OriginalMosaic.cub.
  • HighpassMosaic.cub - This file is the mosaic result (automos) of the high pass filtered input cubes listed in FROMLIST.
  • HighPassList.lis - This single column list contains the individual highpass filter image results and filenames.
  • _highpass.cub - Every image in the fromlist will have a high pass filter (samples x lines) output result. This is the suffix filename appended the original input filenames.
  • LowpassMosaic.cub + HighpassMosaic.cub = TO (noseam output filename)

Type boolean
Default TRUE

Example 1

No Seam Result

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

Command Line

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

Input Images

cube1.cub

First listed cube

cube1.cub

This is the first cube listed in cubes.lis.

cube2.cub

Second listed cube

cube2.cub

This is the second cube listed in cubes.lis.

cube3.cub

Third listed cube

cube3.cub

This is the third cube listed in cubes.lis.

Data File

Links open in a new window.
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

final.cub

Parameter Name: TO

This is the resulting mosaic final.cub.

automos.cub

Automos result (NOT AN OUTPUT OF NOSEAM)

automos.cub

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.