qnet

This program will create and edit control networks. Before running qnet, you will need to create a text file containing a list of all cubes in the control network, 1 cube per line. These cubes must be un-projected, level1 cubes. Optionally, you can also input an existing control network or when prompted for the control network, select the "Cancel" button, and a new control network will be created.

In addition to selecting control points between level 1 un-projected images, qnet may also be used to select ground control points, both Fixed and Constrained points. To select ground control points, you must select a ground source image. This could be a Dem or shaded relief version of a Dem, a projected basemap or a level 1 image with updated camera pointing. Optionally, a radius source file, Dem may also be entered which would provide radii for the ground control point. These files are entered from the File Menu on the main Qnet window. The ground source image is immediately displayed in the main Qnet window and new ground control points may be created by right-clicking on the ground source cube display.

This program is an ISIS GUI application. To run it, type its name in a terminal, with no arguments. This will start a blank session, having the main Qnet window and the control network navigator window. There are 3 core windows used in this application.

Qnet window

The main qnet window is similar to the qview application. You will see many of the same tools, such as "Band Selection", "Zoom", "Pan", "Stretch" and "Find" along the right border. The "Tie" tool is the last button along the right toolbar. It will be the default tool selected when "qnet" is launched.

In this window, select the "Open network" button or the open action (from File menu), and open the file containing the list of cubes in the network. You will then be prompted for the control network file. If you are editing an existing one, choose that file. If you are creating a new control network, choose the "Cancel" button.

Cubes may be displayed in the main qnet window throught two methods.

1. Select a Point Id from those listed in the Control Network Navigator window, then single-click "View Cube(s)".
2. In the Control Network Navigator window, change the combo-box selection from Points to Cubes, then double-click a cube filename, or single-click the cube filename, then single-click the "View Cube(s)" button.

Control Points will be drawn on the displayed cubes with the following colors:

• green "+" control point
• magenta "+" ground point
• yellow "+" ignore point
• red "+" point currently being edited (i.e. in Qnet Tool window)

When the "Tie" tool is activated, the mouse buttons have the following function in the cube viewports of the main qnet window:

• Left Button: Modify the closest control point
• Middle Button: Delete the closest control point
• Right Button: Create new control point

Control Network Navigator window

The Control Network Navigator displays a list of cubes or points in the control network. The user may choose to open cube(s) in the qnet window, edit a control point or filter the point or cube lists on different attributes. By default, double-clicking on a Point Id in the point list will display that control point in the Qnet Tool window. Double-clicking on a filename in the Cube list will display the chosen cube in the qnet main window.

Points This is the default list for the Control Network Navigator. When this is selected, the user may click any of the following buttons:

• "View Cube(s)" to open all cubes containing the selected point(s)
• "Modify Point" (or double click list item) to edit the point using the Qnet Tool
• "Ignore Point(s)" to set selected points to "Ignore"
• "Delete Point(s)" to remove selected points from the control network
• "Filter" to list all points from the currently displayed list that meet the new filtering criteria selected. **Note** If the currently displayed list is already filtered, the new list will only display points that meet the criteria of all filters previously chosen until the user resets the list.
• "Show All" to reset the displayed list to all points in the network

There are 9 filters for the points list which display the following:

• Jigsaw Errors: points with bundle adjustment errors within the user specified range
• Registration Errors: points with sub-pixel registration errors within the user specified range
• Point ID: points whose Point Id contains the user specified string
• Number of Measures: points that are contained in (at least or no more than) the user specified number of images. The control point will contain at least the given number of control measures.
• Point Properties: points that have the user specified property. There are 3 options and any combination may be chosen.
• Filter by Point Type(s)
• Filter by Ignore Status Note: If all of the measures in a point are ignored, then this point will be returned in the ignored point filter.
• Filter by Edit Lock Status
• Range: points that lie within the user specified latitudinal and longitudinal ranges
• Distance: points that are within the user specified distance of some other point in the control network
• Measure Properties: points that contain at least one control measure that matches the selected criteria
• Filter by Measure Type(s)
• Filter by Ignore Status
• Filter by Edit Lock Status
• Goodness of Fit: points that contain at least one measure whose Goodness of Fit is within the user specified range
• Cube Name(s): points that contain at a measure whose serial number matches that of the user chosen cube filename

Cubes When this is selected, the user may click any of the following buttons:

• "View Cube(s)" to open all selected cubes
• "Filter" to list all cubes from the currently displayed list that meet the new filtering criteria selected.
  **Note** If the currently displayed list is already filtered, the new list will only display cubes that meet the criteria of all filters previously chosen until the user resets the list.
• "Show All" to reset the list to all images in the network

There are 3 filters for the cubes list which display the following:

• Cube Name: cubes whose file name contains the user specified string
• Number of Points: cubes containing (at least or no more than) the user specified number of points
• Distance: cubes that contain at least one pair of points that are within the user specified distance from each other

Qnet Tool window

This is the point editor window of qnet for modifying or creating a control point. This window will display information about the control point and two control measures are displayed. Initially the measures displayed will be the "Reference" cube on the left and the next cube in the control point on the right. The measures displayed in the left and right side can be chosen from the combo-boxes under the labels "Left Measure" and "Right Measure". Only the control measure in the right view can be moved, so if you want to move the reference measure, you must display it in the right view. You can select the previous or next right measure with the shortcuts PageUp and PageDown, respectively.

Changing Measure Locations

The measure location can be adjusted by:

• Move the cursor location under the crosshair by clicking the left mouse button
• Move 1 pixel at a time by using arrow keys on the keyboard
• Move 1 pixel at a time by using arrow buttons above the right view

Other Point Editor Functions

Along the right border of the window:

• Geom: Geometrically match the right view to the left view
• Rotate: Rotate the right view using either the dial or entering degrees
• Show control points: Draw crosshairs at all control point locations visible within the view
• Show crosshair: Show a red crosshair across the entire view
• Circle: Draw circle which may help center measure on a crater

Below the left view:

• Blink controls: Blink the left and right view in the left view window using the "Blink Start" button (with play icon) and "Blink Stop" button (with stop icon). Both arrow keys above the right view and the keyboard arrow keys may be used to move the right view while blinking.
• Find: Center the right view so that the same latitude / longitude is under the crosshair as the left view. Shortcut: F

Below the right view:

• Register: Sub-pixel register the the right view to the left view. Shortcut: R
• Undo Registration: Undo the sub-pixel registration. Shortcut: U
• Save Measure: Save the control measure under the right view to the edit control point. Shortcut: M

Along the bottom:

• Add Measure(s) to Point: Add control measure(s) to the current control point. A dialog will show all cubes in the network with those that fall at this control point's latitude and longitude highlighted. All cubes chosen will be added as control measures to this control point. Shortcut: A
• Save Point: Save the edit control point to the control network. Shortcut: P

Measure Table window

This window will show all control measure data for the current edit control point. The table can be sorted by clicking on any of the headers.