autoseed
Creates a control network for a list of images
This program creates a control network for a set of cubes. The program uses the footprint overlap information from findimageoverlaps to decide where multiple images overlap.
The figure above shows the outline footprint of three images. They overlap in such a way so image #1 and #2 cover some of the same area on the ground, image #2 and #3 also cover some of the same area, and all three images, #1, #2 and #3, cover the same small area down the middle.
The program will create a set of control points for each overlap and will create a control measures for each image the control point falls on. The seeding method defined in the DEFFILE, controls the location and density of the control points.
Group = PolygonSeederAlgorithm
Name = Grid
MinimumThickness = 0.3
MinimumArea = 100000000
XSpacing = 10000
YSpacing = 10000
End_Group
The seeding definision file above tells autoseed to use an algorithum called "Grid", not to seed points in overlaps with a thickness ratio of less than "0.3", not to seed overlaps with an area of less than "100000000 square meters", and to space the pattern of points at "10000 meters" spacing in both the X and Y directions. For seeding algorithum templates see the "$ISISROOT/appdata/templates/autoseed" directory.
The figure above shows the position of the control poinsts generated by autoseed as blue "+" using the seeding definision file above.
autoseed also has the ability to use an existing control network, CNET, to ignore overlaps that contain at least one control point. This allows the user to run autoseed multiple times with different seeding parameters and algorithms. This can be useful when one run fails to seed all the overlaps or overlaps of different size and shape need to be seeded differently.
ISIS programs that must be run prior to running autoseed:
- spiceinit
- footprintint
- findimageoverlaps
Categories
Related Objects and Documents
Applications
History
| Stuart Sides | 2005-08-20 | Original version |
| Steven Lambright | 2007-07-27 | Changed category from Geometry to Control Networks |
| Stuart Sides | 2008-11-11 | Removed terminal output code |
| Steven Lambright | 2008-11-24 | Added the "OVERLAPLIST" parameter. |
| Christopher Austin | 2008-12-18 | Added the optional CNET parameter and fixed memory leaks. |
| Christopher Austin | 2008-12-22 | Removed beta status, fixed a bug, and added test. |
| Christopher Austin | 2009-01-26 | Replaced the cerr output with the ERRORS option. |
| Christopher Austin | 2009-02-09 | Added the seed definition parameters to the results group of the print.prt file |
| Christopher Austin | 2009-03-16 | Fixed the progress objects. |
| Travis Addair | 2009-08-05 | Moved seed definition parameters to unique group, and encapsulated the group creation within the seeding objects. |
| Travis Addair | 2009-08-11 | Added .def filter to the SEEDDEF parameter. |
| Christopher Austin | 2009-10-23 | Added keywords to the SEEDDEF file which tell autoseed which Control Measures to mark as ignored under the keyword's conditions. These new keywords include "PixelsFromEdge", "MinEmission", "MaxEmission", "MinIncidence", "MaxIncidence", "MinResolution", and "MaxResolution". Any Control Point with less than 2 valid measures as a result of these keywords will be marked as ignored. |
| Christopher Austin | 2009-11-25 | Added the keywords "MinDN" and "MaxDN" to the SEEDDEF possibilities. Using these keywords will increase runtime. |
| Eric Hyer | 2010-01-29 | Added Results group to print.prt |
| Christopher Austin | 2010-03-26 | Now throws an error if the output Control Net is empty. |
| Eric Hyer | 2010-04-16 | Added optional parameters to results group. Also now report invalid or unrecognized keywords found in the def file to the user. |
| Sharmila Prasad | 2010-04-28 | Fixed error while checking for max and min dn values restriction for a valid control point. Ignore control points with special pixel dn values. |
| Christopher Austin | 2010-05-05 | Adapted to handle seeding in both XY and SampleLine units using the optional Seeddef keywork SeedDomain. |
| Christopher Austin | 2010-06-09 | Added the ControlPointsIgnored and ControlMeasuresIgnored keywords to the results group. |
| Sharmila Prasad | 2010-06-30 | Throw exception, when SetUniversalGround Fails |
| Christopher Austin | 2010-09-27 | Removed the SetUniversalGround fail exception, and added an exception when serial numbers in the overlaps list are not included in the FROMLIST. |
| Christopher Austin | 2011-01-18 | Altered to compile with the new Control redesign. |
| Steven Lambright | 2011-04-11 | Changed SEEDDEF to DEFFILE and TO to ONET as per the control network standard application parameter names. |
| Debbie A. Cook and Tracie Sucharski | 2011-06-07 | Changed point type "tie" to "free" |
| Travis Addair | 2011-07-18 | AprioriSample and AprioriLine are now set to the same values as Sample and Line when creating a new Control Measure. |
| Stuart Sides | 2011-09-30 | Reworked the documentation with Laszlo Kestay and Jac Shinaman |
| Debbie A. Cook | 2012-11-23 | Changed to use TProjection instead of Projection. References #775. |
| Jeannie Backer | 2016-04-22 | Modified code to get TargetRadii using the cube label and mapping group if these values can not be found using the TargetName alone. Sets control net using these radii values rather than attempting to find them again. References #3892 |