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.
- Select a Point Id from those listed in the Control Network Navigator window,
then single-click "View Cube(s)".
- 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.
Jeff Anderson, Elizabeth Miller, Stuart Sides, Tracie Sucharski | 2006-11-01 |
Original version
|
Steven Lambright | 2007-07-23 |
Added to Control Networks category
|
Tracie Sucharski | 2008-10-06 |
Refactor of underlying classes
|
Jeannie Walldren | 2008-11-24 |
Changed the name of the "Tie Point Tool" window to "Qnet Tool".
Added "Close" command to the drop down File menu on the "Qnet Tool"
window's menu bar.
Added Qt's wait cursor (i.e. clock or hourglass) to indicate that there is
background activity when the "Filter" or "View Cube(s)" buttons have been
clicked on the "Control Network Navigator" window.
Added message box when the user creates a new point and tries to give it a
Point ID that already exists in the Control network. Previously this
resulted in a PROGRAMMER ERROR from ControlPoint. Now, the user will be
alerted in a message box and prompted to enter a new value for the Point
ID.
Replaced references to PointEdit class with ControlPointEdit.
Added "Goodness of Fit" to "Qnet Tool" right and left measure info.
|
Jeannie Walldren | 2008-11-26 |
Added "Goodness of Fit" filter to the tabs for the "Points" section of the
"Control Network Navigator" window. This filter returns all points that
have at least one measure that falls inside the user specified range.
Added "Number of Measures" to "Qnet Tool" window below "Point ID".
Modified code to pre-set the Point ID value in the "New Point Dialog"
window to the last Point ID entered in the dialog box. This value is
highlighted so the user may begin typing over the name without needing to
backspace.
Changed the "Qnet Tool" title bar to display the name of the ControlNet
file open.
Added message box when saving an "Ignore" point in the "Qnet Tool" to ask
if user wants to set Ignore=false.
Modified the "Distance" filter in the "Points" section of the "Control
Network Navigator" window to improve efficiency and accuracy.
|
Tracie Sucharski | 2008-11-26 |
Removed plot tool and all polygon references-this funtionality will be in
qmos.
|
Jeannie Walldren | 2008-12-03 |
Modified the "Distance" filter in the "Cubes" section of the "Control
Network Navigator" window to improve efficiency and accuracy, and to allow
the user to select a distance in meters or pixels.
|
Jeannie Walldren | 2008-12-08 |
Added connection from "x" in upper right corner to "Exit" command under
the "File" menu of the main window.
|
Jeannie Walldren | 2008-12-10 |
Added functionality to "Qnet Tool" can set, view, edit and save changes
for a template file. This is located in the "Options" menu under
"Registration" as the "Set registration template" and "View/edit
registration template" actions. Added "What's this?" descriptions to
"Qnet Tool" window actions.
|
Tracie Sucharski | 2008-12-19 |
Added "Ignore Points" and "Delete Points" to the Control Navigator tool.
|
Jeannie Walldren | 2008-12-29 |
Added question boxes when the "Delete Points" or "Ignore Points" buttons
are clicked in the Control Navigator to verify that the user wants to
delete or ignore the selected points. Disabled "Ground Point" checkbox
in Qnet Tool window and added dialog window for determining
lat/lon/radius if user chooses to toggle the "Hold Point" checkbox to
true.
|
Jeannie Walldren | 2008-12-30 |
Modified Qnet Tool "Save Point" button to set the left and right measures
to Ignore=False if the user chooses to set the point's Ignore=False.
Also, "Save Point" button will now update ChooserName and DateTime
keywords for altered measures. Modified Control Network Navigator points
list to set most recently edited point to the current item so that it may
be easily deleted.
|
Jeannie Walldren | 2008-12-31 |
Added keyboard shortcuts to buttons in Control Network Navigator window.
Added question box to Qnet Tool "Save Point" button to ask user whether
the reference measure should be replaced with the measure in the left
viewport.
|
Jeannie Walldren | 2009-01-08 |
Updated user documentation. Modified Control Network Navigator window to
filter on existing filtered list until user selects the "Show All" button,
which will bring up all points in the control net or images in the serial
number list.
|
Jeannie Walldren | 2009-01-26 |
Added "Cube Name" filter to "Points" tab of Control Network Navigator
window.
|
Eric Hyer | 2010-03-22 |
Discontinued forcing of gui style to windows
|
Eric Hyer | 2010-05-20 |
Connected FindTool's recordPoint signal to AdvancedTrackTool's record slot
|
Jeannie Walldren | 2010-06-14 |
Modified to uncheck "Held" in the QnetTool window if the "Cancel" button
is clicked in the Hold Point Dialog. Added a filter of Measure Properties
by Ignore Status to the Navigation Tool's Point Filters. Modified
Navigation Tool's Point Type filter to treat points as ignored if all
measures are ignored. Fixed bug that did not show proper colors of points
unless the QnetTool was open. Updated documentation.
|
Jeannie Walldren | 2010-07-01 |
Modified to reopen the Navigation Tool whenever the Tie Tool on the tool
pad is activated. Modified to draw points selected in the QnetTool last
so they are always visible on top of the other points. Added some
documentation.
|
Tracie Sucharski | 2010-11-09 |
Fixed a bug in the Navigator when using the double-click option on the
Cube list.
|
Eric Hyer | 2010-11-19 |
Implement drawing control measures in the edit window displays.
|
Eric Hyer | 2010-11-22 |
Added functionality to stretch the control point editor displays.
|
Eric Hyer | 2010-12-03 |
In the new point and measure dialogs, put selected items at top of the list.
|
Eric Hyer | 2010-12-08 |
Organize the look of the control point editor and add icons. Display the
sub-pixel registration template filename.
|
Eric Hyer | 2010-12-14 |
Added an editor for the sub-pixel registration template file.
|
Tracie Sucharski | 2010-12-17 |
Converted from the Pvl control network keywords to the binary version.
|
Tracie Sucharski | 2011-03-08 |
Implemented ground point selection.
|
Tracie Sucharski | 2011-04-04 |
Implement the SetApriori dialog. Use the reference measure's lat/lon
when adding new measures. Print progress when reading control network
and initialize the cameras on the images.
|
Tracie Sucharski | 2011-04-13 |
Allow the SetApriori dialog to stay open and fill values from the
current edit point.
|
Tracie Sucharski | 2011-04-20 |
When saving measure, if the left measure equals the right measure,
copy right into left.
|
Tracie Sucharski | 2011-04-28 |
In the Maximum residual filter, sort points by residual in descending order.
Fix bug in SetApriori dialog with edit locked points.
|
Tracie Sucharski | 2011-05-05 |
Update values in point editor in response to input to the SetApriori dialog.
|
Tracie Sucharski | 2011-05-20 |
Fixed bugs in the measure type filter and reference measures.
|
Tracie Sucharski | 2011-06-08 |
Changed Control Point types Ground to Fixed and Tie to Free.
|
Tracie Sucharski | 2011-06-15 |
When changes are made to a measure or point, change the text
color in the Save buttons to red.
|
Tracie Sucharski | 2011-06-27 |
Forgot to turn Save buttons to red after auto-registration or using
the Find button.
|
Tracie Sucharski | 2011-06-28 |
Create a table showing the control measures with their corresponding data for
the current edit control point.
|
Tracie Sucharski | 2011-07-05 |
Added control point type to editor as a combo box. Added error checking for
edit locked points and refresh measure table.
|
Tracie Sucharski | 2011-07-07 |
Grey out the Open Ground and Open Dem in the File menu until the cube list
and control network have been opened.
|
Tracie Sucharski | 2011-07-12 |
Added point registration error filter to the Navigator.
|
Tracie Sucharski | 2011-07-18 |
Allow ground file to be loaded on the left of the point editor.
|
Tracie Sucharski | 2011-07-25 |
Fixed a bug when deleting points from the Navigator. Add option to the
SetApriori dialog for calculating the surface point.
|
Tracie Sucharski | 2011-07-27 |
Fixed bug reading the radius from the Dem.
|
Tracie Sucharski | 2011-08-03 |
Highlight thte reference measure in the file selection combo boxes.
Implement bilinear interpolation when reading radius from the Dem.
|
Tracie Sucharski | 2011-08-08 |
Fixed bug when creating a new control network, forgot to set the
Target which caused program to crash when creating a new ground point.
|
Tracie Sucharski | 2011-09-15 |
Speed up the blinking and drawing of control points on the cube
viewports for large control networks. Add an option for displaying
other points besides the current edit point in the editor displays.
If a control point has sigmas, do not erase when the point has been
re-located. Fixed the blinking problem with the measure table.
|
Tracie Sucharski | 2011-09-16 |
Fixed bug when adding measures to a point when a ground source file
is opened. Draw fixed and constrained points on the ground source
display. If creating a ground point and no images intersect the
point, print an error. In the new point dialog display the
intersecting images at the stop of the file selection list.
|
Tracie Sucharski | 2011-09-22 |
Fixed the problem with duplicate warnings when saving Ignored measures.
|
Tracie Sucharski | 2011-09-29 |
Updated documentation. Implemented the "What's This" functionality
to the control point editor.
|
Tracie Sucharski | 2011-10-21 |
Fixed bug that caused qnet to crash when creating a new control network.
|
Tracie Sucharski | 2011-10-31 |
Changed the Save button on the qnet tool to save to current network,
rather than a "Save As".
|
Tracie Sucharski | 2011-11-09 |
Fixed problem caused by an image in the list which did not have any
measure associated with it.
|
Tracie Sucharski | 2011-12-05 |
Fixed bug with measure table not displaying all information when
table has been sorted.
|
Tracie Sucharski | 2012-01-11 |
Add error checking for creating point with invalid latitude, longitude.
|
Tracie Sucharski | 2012-05-07 |
Fixed following bugs: error when attempting to geom when using a ground
source as the reference measure, problem un-locking a measure even
if the point is un-locked and when changing between geom and rotate options,
chips were not resettting correctly.
|
Tracie Sucharski | 2012-05-08 |
Fixed bug that resulted in seg fault when deleting a point by middle clicking
on a cubeviewport after creating a ground point.
|
Tracie Sucharski | 2012-06-12 |
Fix made on 2012-05-07 caused a bug which would not allow a new measure
to be set as the reference measure.
|
Tracie Sucharski | 2012-07-30 |
Fixed bug which caused program to crash when left clicking on a cube when
there are no control points.
|
Tracie Sucharski | 2012-09-28 |
Fixed bug that resulted in a qt assert error when loading or creating a new
ground point if the ground source file had the Instrument group in the labels.
|
Tracie Sucharski | 2012-10-05 |
Improved error checking for opening a ground source file with the same serial
number as a cube in the cube list. This is not allowed, so an error with suggested
solution is printed.
|
Tracie Sucharski | 2013-05-16 |
Fixed bugs when attempting to delete a point in an empty network, deleting all
measures in a point. Fixed repetitive warnings when the current edit point does
not fall on the ground source. Fixes #1491, #1493, #1655.
|
Tracie Sucharski | 2013-12-06 |
Fixed following bugs: seg fault when selecting a new reference measure and moving
the point, seg fault when moving edit locked points without un-locking.
Also, improved error checking on ignored reference measures on constrained and
fixed points. Fixes #1603, #1624.
|
Ian Humphrey | 2015-10-07 |
Updated icons. Fixes #1041.
|
Ian Humphrey | 2015-11-19 |
Added shortcuts to Qnet Tool window for selecting right measures, registration, saving
measures, saving a point, adding a new measure, find, and saving the control network. Fixes
#2324.
|
Makayla Shepherd | 2017-01-04 |
Fixed an issue that caused the Control Network Navigator to go behind the qnet main window
when using Gnome or Cinnamon. Fixes #4541.
|