Home

User Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Contributor Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Quick Links

Software Manual
AstroDiscuss
GitHub
API Reference

Documentation Versions

ISIS 2

Documentation
Tutorials
Technical Documents
USGS

ISIS Application Documentation

cnetnewradii

Standard View | TOC | Home

Generate new radii from DEM for a ControlNet

Description
Categories
Groups
Examples
History

Description

This application will go through an existing control network and copy it to a new control network updating either apriori or adjusted radii values using the given shape file. When it encounters a point type of Fixed or Constrained it will use the control point latitude and longitude to update the radius from the shape model file. The radius will be calculated based on a bilinear interpolation of the closest pixels in the shape file. The AprioriRadius, AprioriRadiusSource and AprioriRadiusSourceFile will be updated if GETLATLON=APRIORI. The AdjustedRadius will be updated if GETLATLON=ADJUSTED. There are not keywords for AdjustedRadiusSource or AdjustedRadiusSourceFile.

If, for a particular point, the application fails to calculate a radius using the shape file, then the input radius value is kept and the point is set to Ignore=true. The number of these failures are recorded in the application's log. The Point IDs for the corresponding control points will be listed in the ERRORS log output file. If the user did not enter a filename for this log and there are any points that failed, one will be created with the name "failures.log". Note:If a significant number of points in the control network fail to find a new radius value, the user should make sure that they have input the correct shape model for the input control network.

Categories

Parameter Groups

Files

Name Description
CNET Input ControlNet
MODEL User defined ISIS cube shape model.
ONET Output ControlNet file
ERRORS Optional log file containing failures.

Parameters

Name Description
GETLATLONSource of the latitude, longitude used to set new radii

Files: CNET

Description

Use this parameter to select the input control network.

Type filename
File Mode input
Filter *.net

Files: MODEL

Description

A map projected ISIS cube which contains the radii of the target. The file can cover a larger area than the control points in the network, but must minimally include all of the control point locations.

Type cube
File Mode input
Default Path $base/dems/
Filter *.cub

Files: ONET

Description

Use this parameter to specify the name of the output control network.

Type filename
File Mode output
Filter *.net

Files: ERRORS

Description

This file will contain the Point IDs of all control points whose radius could not be calculated from the shape model. This happens when the radius value is a special pixel or when the program fails to set universal ground given the lat/lon values of the control point.

Type filename
File Mode output
Internal Default No Error Output
Filter *.log *.pvl *.txt

Parameters: GETLATLON

Description

Specify which Surface Point to use when setting the new radii.

Type string
Default APRIORI
Option List:
Option Brief Description
APRIORIUse the Apriori Surface Point Use the lat/lon values provided by the Apriori Surface Point when setting the new radii.
ADJUSTEDUse the Adjusted Surface Point Use the lat/lon values provided by the Adjusted Surface Point when setting the new radii. The lat/lon value of the Adjusted Surface Point is generated by bundle adjust.

Examples

Example 1

All fixed points successfully updated

Description

Example of the use of cnetnewradii on a control network whose constrained and fixed points lat/lon values are all contained within the given shape model.

Command Line

cnetnewradii cnet=../IN/inputcnet.net model=../IN/inputDEM1.cub onet=../OUT/ouputcnet1.net getlatlon=APRIORI
In this example, cnetnewradii will take the input control network and copy it to the output network with new radii values calculated for all constrained and fixed points using an interpolated DN value from the shape cube. The apriori values will be updated. No error log will be generated.

GUI Screenshot

Example GUI

Screen shot of GUI with parameters filled in to create control network with new radii values.

Input Image

SHAPE

Input shape file for cnetnewradii

Parameter Name: SHAPE

Example of an input shape cube used by cnetnewradii to update the radii values of contrained and fixed points in the control network.

Data Files

Input ControlNet for cnetnewradii Example of an input control network whose radii values will be updated.
Output control network for cnetnewradii Example of an output control network corresponding to the input example with updated radii values. Notice that radii values have been updated for all contrained and fixed points.

Example 2

Some fixed points fail to be updated

Description

Example of the use of cnetnewradii on a control network` that contains some fixed points whose radius can not be calculated.

Command Line

cnetnewradii cnet=../IN/inputcnet.pvl model=../IN/inputDEM2.cub onet=../OUT/ouputcnet2.pvl errors=../OUT/failures.pvl
In this example, cnetnewradii will take the input control network and copy it to the output network with new radii values calculated for fixed points using the DN value recieved from the shape cube. The PointIDs of fixed points that fail to calculate a new radius value will be listed in the error log.

GUI Screenshot

Example GUI

Screen shot of GUI with parameters filled in to create control network with new radii values.

Input Image

SHAPE

Input shape cube for cnetnewradii

Parameter Name: DEM

Example of an input shape cube used by cnetnewradii to update the radii values of fixed points in the control network.

Data Files

Input control network for cnetnewradii Example of an input control network whose radii values will be updated.
Output error log for cnetnewradii Example of an output error log containing the PointIDs of all points that failed to calculate a new radius value.
Output control network for cnetnewradii Example of an output control network corresponding to the input example with updated radii values. Notice that the fixed points that failed are set to Ignore=True and their original radii values are retained.

History

Steven Koechle2008-08-05 Original Version
Jeannie Walldren2010-05-25 Modified to handle control points that fail to calculate a new radius as explained in the description. Added ERRORS parameter to list PointIDs of the control points that failed to calculate a new radius. Added filters for input and output parameters.
Jeannie Walldren2010-05-27 Created examples.
Christopher Austin2011-01-19 Altered to compile with the new Control redesign.
Steven Lambright2011-02-09 Updated to not try to project null lat,lon values
Christopher Austin2011-03-14 Updated for Control Point's removal of Set/GetSurfacePoint() and added the GetLatLon parameter.
Steven Lambright2011-04-11 Changed the DEM parameter name to MODEL
Debbie A. Cook and Tracie Sucharski2011-06-07 Changed the point type "Ground" to "Fixed"
Tracie Sucharski2011-07-28 Change radii values for both Fixed and Constrained points. Use bilinear interpolation to get the correct radius from the shape file. This uses the same interpolation as the camera. Print error if there are no Fixed or Constrained points in the network. Change input parameter names to be consistent with those suggested on the Astrogeology wiki page. Removed NETWORKID as user parameter since it should carry the ID from the input control net. Set Apriori as the default for the GETLATLON parameter. Update examples documentation.
Tracie Sucharski2011-10-04 Skip edit locked points, keep count for summary. Added appTest for edit locked points.
David L Miller2015-06-29 Updated Makefile to be closer to new Isis coding standards and fixed bug where test data coming from directories that don't start with "/usgs/" would not be found.