.TH wxGUI.image2target 1grass "" "GRASS 7.8.5" "GRASS GIS User's Manual"
.SH wxGUI GCP Manager
.SH DESCRIPTION
The \fBGCP Manager\fR is a \fIwxGUI\fR
extension which allows the user to create, edit, and manage
Ground Control Points. It is available from the menu
\(dqFile | Manage Ground Control Points\(dq.
.PP
The \fBGCP Manager\fR provides an interactive graphical interface to
manage and analyze Ground Control Points. A backup copy of the initial
POINTS file is always maintained and updated only on request (Save GCPs
to POINTS file). This guarantees that accidental changes are not
permanent and can be undone by reloading the Ground Control Points.
.PP
The GCP Manager must be started in the target location, not in the
source location.
.PP
The GCP Manager is structured into three panels:
.RS 4n
.IP \(bu 4n
The topmost panel shows a list of Ground Control Points. Tools to
manipulate and analyze GCPs are provided in the toolbar. This panel can
be moved out of the GCP manager window by either dragging with the
caption or by clicking on the pin button on the right in the caption.
This panel can also be placed below the map displays by dragging.
.IP \(bu 4n
The two panels in the lower part are used for map and GCP display,
the left pane showing a map from the source location and the right
pane showing a reference map from the target location. Numbered Ground
Control Points are shown on both map displays.
.RE
.SS Components of the GCP Manager
.br
.br
.br
.PP
\fIToolbars\fR
.PP
Two toolbars are provided with the GCP Manager, one for managing the map
displays and one for managing the GCP list.
.PP
\fIList of ground control points\fR
.PP
The list of Ground Control Points can be sorted by clicking on a column
header. Clicking on a cloumn header will sort the GCPs ascending, a
second click on the same column will sort the GCPs descending. Overall
RMS error and individual RMS errors of all points are often improved if
the GCP with the highest RMS error is adjusted. Individual coordinates
can be edited by double\-clicking on a row.
.PP
The first column holds a checkbox and displays the point number. A GCP
is only used for RMS error calculation and georectification if its
checkbox on the left is checked. Uncheck to deactivate a GCP (mark as
unused GCP).
.PP
\fITwo panels for map display\fR
.PP
The left panel is used to display a map from the source location, the
right panel to display a map from the target loaction. Zooming in and
out is always possible with the mouse wheel and done for each map canvas
separately.
.PP
GCPs are displayed in different colors, depending on whether a GCP has
a high RMS error, is currently unused or is currently selected. Optionally,
currently unused GCPs are not shown on the map display.
.PP
\fIStatusbar\fR
.PP
At the bottom of the GCP Manager is a statusbar providing several
functions. The default is set to \fIGo to GCP No.\fR (see also below).
Typing a number or using the up/down arrows will center the maps on the
given GCP, useful with a high zoom.
.SS GCP Map Display Toolbar
.IP "    \fIDisplay map\fR" 4m
.br
Displays maps for source and target canvas and re\-renders any layers
that have changed since the last time the display was updated.
.IP "    \fIRe\-render map\fR" 4m
.br
Re\-renders both source and target canvas regardless of whether they
have changed or not.
.IP "    \fIErase display\fR" 4m
.br
Erases both source and target canvas to a white background.
.IP "    \fIDefine GCP (Ground Control Points)\fR" 4m
.br
On left mouse click, coordinates are defined for the currently
selected GCP.
.IP "    \fIPan\fR" 4m
.br
Interactive selection of a new center of view in the active
display monitor. Drag the pan cursor while pressing the left mouse
button to pan. Alternatively left\-click on the new center. Panning
changes the location of the region displayed but not the size of the
area displayed or the resolution.
.IP "    \fIZoom in\fR" 4m
.br
Interactive zooming with the mouse in the active map canvas (source
or target). Drawing a box or just a left click with the mouse and zoom\-in
cursor causes the display to zoom in so that the area defined by the box
fills the display. The map resolution is not changed. Clicking with the
zoom\-in cursor causes the display to zoom in by 30%, centered on the
point where the mouse is clicked. Zooming changes the display region
extents (both size and location of area displayed).
.IP "    \fIZoom out\fR" 4m
.br
Interactive zooming with the mouse in the active map canvas (source
or target). Drawing a box or just a left click with the mouse and zoom\-out
cursor causes the display to zoom out so that the area displayed
shrinks to fill the area defined by the box. The map resolution is not
changed. Clicking with the zoom\-out cursor causes the display to zoom
out by 30%, centered on the point where the mouse is clicked. Zooming
changes the display region extents (both size and location of area
displayed).
.IP "    \fIAdjust display zoom\fR" 4m
.br
Source and target display are adjusted by using the current GCPs for
coordinate transformation:
.br
.br
.IP "\fIAdjust source display to target display\fR     " 4m
.br
The extents of the source display are adjusted to the current
extents of the target display.
.IP "\fIAdjust target display to source display\fR     " 4m
.br
The extents of the source display are adjusted to the current
extents of the target display.
.IP "\fISet active map canvas\fR" 4m
.br
Sets the currently active map canvas (source or target). Click
to set active map canvas for \fIReturn to previous zoom\fR or
\fIZoom to extent of currently displayed map\fR. Alternatively, move
the mouse over the map canvas to be used as active canvas.
.IP "    \fIReturn to previous zoom\fR" 4m
.br
Returns to the previous zoom extent. Up to 10 levels of zoom back are
maintained.
.IP "  \fIZoom to extent of currently displayed map\fR" 4m
.br
Zoom to the extent of the currently displayed map in the active map
canvas (source or target).
.IP "  \fISettings\fR" 4m
.br
Shows a settings dialog for GCP management and display:
.br
.br
.IP "\fISymbology\fR" 4m
.br
Settings for map and GCP display:
.br
.br
.IP "\fIHighlight highest RMS error only\fR" 4m
.br
Only the GCP with the highest RMS error will be displayed in
a different colour, both in the list of GCPs and the GCP Map Display.
.IP "\fIFactor for RMS error threshold = M + SD * factor:\fR" 4m
.br
All GCPs with an RMS error larger than mean RMS + RMS standard
deviation * this factor will be displayed in a different colour,
both in the list of GCPs and the GCP Map Display. As a rule of
thumb, GCPs with an RMS error larger than \fIM + SD * 2\fR are
most probably wrong. GCPs with an RMS error larger than
\fIM + SD * 1\fR are worth closer inspection. This option is
only available if \fIHighlight highest RMS error only\fR is
unchecked.
.IP "\fIColor\fR" 4m
.br
Set the color for GCPs on the GCP Map Display.
.IP "\fIColor for high RMS error\fR" 4m
.br
Set the color for GCPs with a high RMS error on the GCP Map
Display.
.IP "\fIColor for selected GCP\fR" 4m
.br
Set the color for the currently selected GCP on the GCP Map
Display.
.IP "\fIShow unused GCPs\fR" 4m
.br
If unchecked, unused GCPs will not be shown on the GCP Map
Display.
.IP "\fIColor for unused GCPs\fR" 4m
.br
Set the color for unused GCPs on the GCP Map Display.
.IP "\fISymbol size\fR" 4m
.br
Set the symbol size for GCPs on the GCP Map Display.
.IP "\fILine width\fR" 4m
.br
Set the line width for GCPs on the GCP Map Display.
.IP "\fISelect source map to display\fR" 4m
.br
Select a source map for the left pane of the GCP Map Display.
.IP "\fISelect target map to display\fR" 4m
.br
Select a target map for the right pane of the GCP Map Display.
.IP "\fIRectification\fR" 4m
.br
Settings for georectification:
.br
.br
.IP "\fISelect rectification method\fR" 4m
.br
Set the polynomial order for georectification. This order will
also be used for RMS error calculation.
.IP "\fIClip to computational region in target location\fR" 4m
.br
Clip raster maps to the current computational region in the
target location when georectifying.
.IP "\fIExtension for output maps\fR" 4m
.br
Change the extension for output map names when doing the actual
georectification.
.br
.IP "  \fIShow Help\fR" 4m
.br
Show help page for the GCP Manager.
.IP "  \fIQuit\fR" 4m
.br
Quit the GCP Manager.
.SS Toolbar for the GCP list
.IP "  \fISave GCPs to POINTS file\fR" 4m
.br
The current list of GCPs is saved to the imagery group\(cqs POINTS file
and to a backup copy.
.IP "  \fIAdd new GCP\fR" 4m
.br
Adds a new Ground Control Point to the list and selects it for editing.
.IP "  \fIDelete selected GCP\fR" 4m
.br
Deletes the currently selected GCP from the list.
.IP "  \fIClear selected GCP\fR" 4m
.br
Resets all coordinates of the currently selected GCP to 0 (zero).
.IP "  \fIReload GCPs from POINTS file\fR" 4m
.br
Reloads GCPs from the imagery group\(cqs POINTS file.
.IP "  \fIRecalculate RMS error\fR" 4m
.br
Recalculates forward and backward RMS error for all GCP marked for
use (activated checkbox in first row).
.IP "  \fIGeorectify\fR" 4m
.br
Uses \fIi.rectify\fR to georectify
all images in the source imagery group.
.SS GCP Map Display Statusbar
The GCP map display statusbar is similar to the statusbar in the regular
GRASS GIS map display with two differences, \fIGo to\fR has been
replaced with \fIGo to GCP No.\fR and \fIProjection\fR has been
replaced with \fIRMS error\fR.
.PP
If \fIGo to GCP No.\fR is selected, a GCP number can be given in the
left side of the statusbar and the source and target map canvas will be
centered on the given GCP. Clicking on the map canvas will update
coordinates for this GCP.
.PP
If \fIRMS error\fR is selected, the overall forward and backward RMS
error is displayed.
.SH SEE ALSO
\fI
wxGUI
.br
wxGUI components
\fR
.PP
\fI
i.rectify,
m.transform,
v.rectify
\fR
.PP
See also video
tutorials on GRASS Wiki.
.SH AUTHORS
Markus Metz
.br
.br
\fIBased on the Georectifier (GRASS 6.4.0)\fR by Michael Barton
.br
Martin Landa, Czech Technical University in Prague, Czech Republic
.SH SOURCE CODE
.PP
Available at: wxGUI GCP Manager source code (history)
.PP
Main index |
GUI index |
Topics index |
Keywords index |
Graphical index |
Full index
.PP
© 2003\-2020
GRASS Development Team,
GRASS GIS 7.8.5 Reference Manual