ISIS 3 Application Documentation
cnetadd | Printer Friendly View | TOC | Home |
Adds Level 1 or Level 2 images to an existing Isis3 Control Net file.
Overview | Parameters |
DescriptionThis application adds Level 1 and Level 2 images to an existing ISIS3 Control Net file. It takes in an input Control Net CNET and a list file ADDLIST which contains filenames of all the images to be added to the Control Net. The application adds the images to the network depending on the Retrieval options. The resulting output Control Net is placed in the user specified output file ONET. All other Control Net configurations remain unchanged. FROMLIST contains the list of all the images that are part of the input Control Net. This input parameter is optional with Control Nets generated by applications such as "seedgrid" which will contain only lat/lon but no other Control Measures. However, FROMLIST is required if the RETRIEVAL option is REFERENCE (described herein) where the lat/lon's are obtained from the FROMLIST cubes. The application checks each image in the ADDLIST for all the Control Points in the input Control Network as to whether it can be added to any given Control Point. If the image already exists for the Control Point, it is skipped. Otherwise, it is checked to see if the Control Point's location is within the latitude/longitude (lat/lon) boundaries of the image, and adds the image measures if it is. TOLIST is an optional output list which contains the list of all images in the output Control Net. If TOLIST is defined then FROMLIST is required to make the output list complete. Otherwise the TOLIST will contain only the new images from ADDLIST added to the Control Net. The images in the FROMLIST and ADDLIST must be available for the program to open. All the PVL log information such as duplicate serial numbers common to FROMLIST and ADDLIST, images added, images omitted and Points modified are placed in LOG file if specified. MODIFIEDPOINTS is an optional output parameter that allows the user to create a list of the modified points in the final Control Net. The program has four additional Options or parameters: POLYGON, RETRIEVAL, EXTRACT, and DEFILE. If the POLYGON option is enabled, this optimization will prune points that fall outside the latitude/longitude bounding box of the polygon for the image being added. By performing this check up front, no expensive camera calculations to find a Point's location on an image will be performed for points that fail this test. In most cases, the vast majority of points fall outside of any given image during the adding process, so performance gains can be orders of magnitude. IMPORTANT NOTE: this optimization requires that all images have had "footprintinit" run beforehand in order to find the image polygons. The Control Point's location (lat/lon) is retrieved from either the REFERENCE (default) or POINT preference of the RETRIEVAL parameter. If REFERENCE is chosen, the lat/lon is calculated from the reference camera information of the corresponding images in FROMLIST. If POINT is chosen, the lat/lon is taken directly from the information attached to the Control Point. The lat/lon is then used to get the Line and Sample of the point on the image. IMPORTANT NOTE: the POINT option is meant for Control Networks built using "seedgrid" because this program attaches the lat/lon information to the points. If you use this option on networks with Control Points that do not have this information, those points will be ignored. The EXTRACT parameter allows the user to define what goes into the ONET. If ALL (default)is specified, then the entire input Control Net with the modified points will be written out to the output Control Net. If MODIFIED is specified, then only the modified Points(points which has the images from the ADDLIST added to it) will be extracted to the output. DEFFILE could be specified to validate measures (images). If the image being added to a particular point fails the validation test then the Measure is set to be Ignored. Following are the different options which could be specified in the DEFFILE.The application will validate the measure for specified properties. These properties are optional and the DEFFILE can have different combinations of these properties. The DEFFILE should be in the format shown below:
Measures are added if a Point is locked. But if the Point is locked and Apriori source is "AverageOfMeasures" then the measures are not added to the Control Point. This is because the Point being locked, it cannot be be updated for lat/lon values, so newly added measures did not contribute to the average that had been previously computed for at the point level. CategoriesHistory
|
Parameter GroupsInput Files
Output Files
Options
|
FROMLIST is a text file that contains the list of all the images that are part of the input Control Net. Every file used in the Control Net file should be represented in this list. This input parameter is optional as Control Net from applications such as seedgrid will have only Control points but no Control Measures. FROMLIST is required if the Retrieval option is REFERENCE which is the default and also if TOLIST is specified. The cubes must be available for the program to open.
Type | filename |
---|---|
File Mode | input |
Internal Default | None |
Filter | *.lis |
This parameter specifies the input Control Net file to which the images are to be added.
Type | filename |
---|---|
File Mode | input |
Filter | *.net |
A text file containing one column of ISIS3 cube file names. The cubes must be available for the program to open. If cubes in this list are also in the FROMLIST, process time will be increased.
Type | filename |
---|---|
File Mode | input |
Filter | *.lis |
Isis3 output Control Network file. The resulting output Control Net with the added images is placed in the specified output file in ONET.
Type | filename |
---|---|
File Mode | output |
Filter | *.net |
Use this optional parameter to receive a ist of all images in the ONET that are also in the FROMLIST or ADDLIST. To have a complete list, it is important to have the FROMLIST.
Type | filename |
---|---|
File Mode | input |
Internal Default | None |
Filter | *.lis |
This optional log file contains information about which files were added to the Control Net, which ones were not, and which images were common in both the FROMLIST and ADDLIST.
Type | filename |
---|---|
File Mode | output |
Internal Default | None |
This optional output file will create a list of the Control points that were modified by the addition of measures.
Type | filename |
---|---|
File Mode | input |
Internal Default | Do not list |
Filter | *.lis *.txt |
When enabled, this optimization will prune points that fall outside the latitude/longitude bounding box of the polygon for the image being added. By performing this check up front, no expensive camera calculations to find a Point's location on an image will be performed for points that fail this test. In most cases, the vast majority of points fall outside of any given image during the adding process, so performance gains can be orders of magnitude.
This optimization requires that all images have had "footprintinit" run beforehand in order to find the image polygons.
Type | boolean |
---|---|
Default | False |
This option allows the user to specify whether the latitude and longitude used for calculating Control measures' sample/line information should be retrieved from the reference cameras generated with the FROMLIST or the Control points contained within the input Control Network itself. If the POINT option is selected, then there is no need to specify a FROMLIST, otherwise one must be specified.
Type | string | |||||||||
---|---|---|---|---|---|---|---|---|---|---|
Default | REFERENCE | |||||||||
Option List: |
|
Use this parameter to determine whether to place all Control Points in the ONET, or just the Control Points with new Control Measures and reference image measures in the ONET. In this case, only reference measures and new measures are placed in the Control Points of the ONET.
Type | string | |||||||||
---|---|---|---|---|---|---|---|---|---|---|
Default | ALL | |||||||||
Option List: |
|
This optional PVL file containing the description of the Validity Control Measure Keywords. Newly added Control Measures which are not valid based on these keywords will be set to Ignored. Control Measures that are originally in the CNET will not be evaluated/Ignored by the DEFFILE.
Type | filename |
---|---|
File Mode | input |
Internal Default | None |
Filter | *.def *.pvl |