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:
|
| Group=ValidMeasure |
| MinDN
|
= Default is Min DN value (depends on the pixel size of the
image)
|
| MaxDN |
= Default is Max DN value (depends on the pixel size of the
image)
|
| MinEmission |
= 0 (Default) |
| MaxEmission |
= 135 (Default) |
| MinIncidence |
= 0 (Default) |
| MaxIncidence |
= 135 (Default) |
| MinResolution |
= 0 (Default) |
| MaxResolution |
= Maximum integer value |
| PixelsFromEdge |
= 0 (Default) OR |
| MetersFromEdge |
= 0 (Default) |
| EndGroup | |
|
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.
| 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.
|
