ISIS Application Documentation
cnetadd | Standard View | TOC | Home |
Adds Level 1 or Level 2 images to an existing Isis Control Net file.
Description
Categories
Groups
History
Description
This application adds Level 1 and Level 2 images to an existing ISIS 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.
Categories
Parameter Groups
Input Files
| Name | Description |
|---|---|
| FROMLIST | List of ISIS input cubes in the Control Net. |
| CNET | ISIS existing Control Net file |
| ADDLIST | List of ISIS input cubes to be added to the Control Net. |
Output Files
| Name | Description |
|---|---|
| ONET | Isis output Control Network file |
| TOLIST | List of ISIS output images in the ONET |
| LOG | Optional Log File |
| MODIFIEDPOINTS | Creates a list of all modified Control Points |
Options
| Name | Description |
|---|---|
| POLYGON | Prune points outside image polygon in adding process |
| RETRIEVAL | Retrieve latitude and longitude from Control points in the Control Network or the reference cameras obtained from the FROMLIST |
| EXTRACT | Defines what Control Points are to be placed in ONET |
| DEFFILE | PVL file containing the description of the Validity Control Measure Keywords for new/added measures |
Input Files: FROMLIST
Description
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 |
Input Files: CNET
Description
This parameter specifies the input Control Net file to which the images are to be added.
| Type | filename |
|---|---|
| File Mode | input |
| Filter | *.net |
Input Files: ADDLIST
Description
A text file containing one column of ISIS 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 |
Output Files: ONET
Description
ISIS 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 |
Output Files: TOLIST
Description
Use this optional parameter to receive a list 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 |
Output Files: LOG
Description
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 |
Output Files: MODIFIEDPOINTS
Description
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 |
Options: POLYGON
Description
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 |
Options: RETRIEVAL
Description
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: |
|
Options: EXTRACT
Description
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: |
|
Options: DEFFILE
Description
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 |
History
| Steven Koechle | 2008-11-24 | Original version |
| Christopher Austin | 2008-01-29 | Fixed major memory leak and added memory control. Changed param NETWORK to CNET, increased developer documentation, added a Progress Object during lat/lon calculation. |
| Christopher Austin | 2008-02-23 | Fixed an error with not catching the failed ground range setting. |
| Travis Addair | 2009-08-27 | Added radio button allowing user to fill a skeleton Control Network (no Control measures) generated by the seedgrid application so long as it contains a latitude/longitude for each Control point. This list of files to add has also had its parameter name changed from FROMLIST2 to ADDLIST for clarity. |
| Travis Addair | 2009-09-02 | When adding measures to a Network generated by the seedgrid application, the Ignore keyword for a Control Point is now set to false if the Point has at least two measures. |
| Travis Addair | 2009-09-04 | A sorted list of Control points that were modified will now be put into the log file. |
| Christopher Austin | 2010-04-07 | Modified to handle duplicate Serial Numbers between the FROMLIST and ADDLIST instead of throwing an exception. |
| Christopher Austin | 2010-06-11 | Added modified Point only cNet output, added list of modified points output. |
| Christopher Austin | 2010-06-25 | Added an error message when RETREIVAL=POINT is used but lat/lon values are absent from the points. |
| Sharmila Prasad | 2010-10-13 | Modified for binary Control Net |
| Sharmila Prasad | 2010-10-22 | Reset Apriori values if Apriori source is AvgOfMeasures |
| Sharmila Prasad | 2010-10-28 | Do not add measures if the Control Point is locked and Apriori source is "AverageOfMeasures". |
| Christopher Austin | 2010-11-19 | Added the DEFFILE option and test, similar to cnetref. Logging still needs to be done. |
| Christopher Austin | 2010-12-22 | Modified documentation to better clarify the DEFFILE parameter. |
| Christopher Austin | 2011-01-18 | Altered to compile with the new Control redesign. |
| Christopher Austin | 2011-02-18 | Added the TOLIST parameter. |
| Christopher Austin | 2011-03-14 | Changed to use SurfacePoints instead of lat/lon calculations. |
| Jai Rideout | 2011-04-12 | Changed INNET to CNET and OUTNET to ONET for consistency. |
| Travis Addair | 2011-05-25 | Moved writing of TOLIST to occur after filtering for modified. |
| Travis Addair | 2011-07-07 | FROMLIST now optional even when RETRIEVAL=POINT to allow for complete TOLIST. |
| Sharmila Prasad | 2011-09-29 | Updated Documentation, moved output file MODIFIEDPOINTS to output file group, changed group name Retrieval options to options and added new test Polygon to test the parameter POLYGON. |
| Jac Shinaman, Janet Richie | 2011-09-29 | Reviewed, Edited the Documentation and the GUI display |
| Debbie A. Cook | 2012-02-17 | The extract=modified option was changed to not output edit locked points and measures, since they were not modified. |
| Jeannie Backer | 2012-10-25 | Changed call to Camera::resolution() to lower camel case. Isis3 standards improvements. References #1181. |