Home
About Isis
Support
Download

Isis 3

Documentation
Tutorials
Technical Documents

Isis 2

Documentation
Tutorials
Technical Documents

Search
USGS

Isis 3 Application Documentation

cnetmerge

Standard View | TOC | Home

Merges 2 ControlNets into one.

Description
Categories
Groups
History

Description

Merges 2 Control Nets into a single Control Net. Each Control Net must share the same target, and be of the same type (i .e. Singleton, ImageToImage, ImageToGround ).

Categories

Parameter Groups

Input

Name Description
INPUTTYPEFile I/O options
FROMLIST Input list file
FROM1 Input ControlNet
FROM2 Input ControlNet

Output

Name Description
TO Merged ControlNet
REPORT Reports Control Points that were renamed or replaced

Output Control

Name Description
ID The NetworkId for the merged ControlNet
DESCRIPTION The Description for the merged ControlNet
DUPLICATEPOINTSDefines how duplicate Control Points are handled

Input: INPUTTYPE

Description

There is a choice to simply specify input cubes directly, use a list of input cubes in a text file, or to create output data only.

Type string
Default LIST
Option List:
Option Brief Description
LISTSelect input Control Net list Select a list of Control Nets, all to be merged.

Exclusions

  • FROM1
  • FROM2
CNETSSelect input Control Nets directly Select the 2 Control Nets to be merged directly.

Exclusions

  • FROMLIST

Input: FROMLIST

Description

This file contains a list of all the Control Nets to be merged

Type filename
File Mode input
Filter *.lis, *.list, *.txt

Input: FROM1

Description

The first ControlNet to be merged.

Type filename
File Mode input
Filter *.ctl *.pvl *.net

Input: FROM2

Description

The second ControlNet to be merged.

Type filename
File Mode input
Filter *.ctl *.pvl *.net

Output: TO

Description

The output ControlNet, which is the merged result of the two input ControlNets.

Type filename
File Mode output
Filter *.ctl *.pvl *.net

Output: REPORT

Description

This file will contain a report that reveals all Control Points that were renamed or replaced. If no Control Points were renamed or replaced, than this file will be empty.

Type filename
File Mode output
Internal Default No Report Output

Output Control: ID

Description

The NetworkId keyword for the new merged ControlNet will be set to the given value.

Type string

Output Control: DESCRIPTION

Description

The Descrition keyword for the new merged ControlNet will be set to the given value.

Type string

Output Control: DUPLICATEPOINTS

Description

This parameter is used to specify how duplicate Control Points of the given Control Networks are handled when merging.

Type string
Default ERROR
Option List:
Option Brief Description
ERRORDoes not merge duplicate Control Points This option will check for duplicate Control Points in the Control Nets and throw an error when a duplication occurs. If no duplication occurs, all Control Points will be transfered to the new Control Net as is.

Exclusions

  • REPORT
RENAMERenames duplicate Control Points This option will add the name of Id of the Control Net to each duplicate Control Point while merging. The other Control Points will be identically transferred.
REPLACEReplaces duplicate Control Points This option will replace all duplicate Control Points in the following Control Net over the first Control Net. When INPUTTYPE=CNETS, the FROM2 Control Net will override the duplicate Control Points in FROM1. When INPUTTYPE=LIST, a listed Control Net will override any and all duplicate Control Points from any and all previously listed Control Nets.

History

Christpher Austin2008-04-04 Original version
Christopher Austin2008-06-24 Clarified error messages and added documentation. (Removed netmerge from the system, because it did the same thing, just not quite as clean)
Christopher Austin2008-08-05 Fix xml app name error
Christopher Austin2008-11-13 Rebuilt for more Control Point Id control, including a REPLACE option. Only FORCE prefixes the original Control Network Id to the new Control Point Ids, then logs the number of duplicate Control Points. NORMAL and REPLACE leave the Control Point Ids alone.
Christopher Austin2009-01-09 Added the FROMLIST input option.
Christopher Austin2009-01-13 Changed MERGETYPE param name and options to be more clear. Changed MODE to INPUTTYPE. Added the REPORT param which reveals any Control Points that have been renamed or replaced durring the merge.
Christopher Austin2009-01-15 Added Filename expansion to the listed nets and a few other minor readability changes.