1d.where(1)                  GRASS GIS User's Manual                 d.where(1)
2
3
4

NAME

6       d.where   - Identifies the geographic coordinates associated with point
7       locations given in display coordinates.
8

KEYWORDS

10       display, sampling, position, querying
11

SYNOPSIS

13       d.where
14       d.where --help
15       d.where [-dlwf]  [at=x,y[,x,y,...]]   [input=name]   [--help]   [--ver‐
16       bose]  [--quiet]  [--ui]
17
18   Flags:
19       -d
20           Output lat/long in decimal degree
21
22       -l
23           Output lat/long referenced to current ellipsoid
24
25       -w
26           Output lat/long referenced to WGS84 ellipsoid using datum transfor‐
27           mation parameters defined in current location (if available)
28
29       -f
30           Output frame coordinates of current display monitor (percentage)
31
32       --help
33           Print usage summary
34
35       --verbose
36           Verbose module output
37
38       --quiet
39           Quiet module output
40
41       --ui
42           Force launching GUI dialog
43
44   Parameters:
45       at=x,y[,x,y,...]
46           Display coordinates to convert
47
48       input=name
49           File from which to read coordinates ("-" to read from stdin)
50

DESCRIPTION

52       d.where is an interactive program  that  allows  the  user,  using  the
53       pointing device (mouse), to identify the geographic coordinates associ‐
54       ated with point locations within the current geographic region  in  the
55       active display frame on the graphics monitor.
56
57       Each mouse click will output the easting and northing of the point cur‐
58       rently located beneath the mouse pointer.  A mouse-button menu is  pre‐
59       sented  so  the  user  knows  which mouse buttons to use. The output is
60       always printed to the terminal screen; if the output is redirected into
61       a file, it will be written to the file as well.
62
63       Mouse buttons:
64            Left:   where am i
65            Middle: draw to/from here
66            Right:  quit this
67       The left mouse button prints the coordinates at the selected point, the
68       middle mouse button allows you to query two points (they are  connected
69       by a line for convenience). Use the right mouse button to exit the mod‐
70       ule.
71

NOTES

73       This program uses the current  geographic  region  setting  and  active
74       frame.   It  is not necessary, although useful, to have displayed a map
75       in the current frame before running d.where. The  -d  flag  allows  the
76       user  to  optionally  output  latitude/longitude coordinates pair(s) in
77       decimal degree rather than DD:MM:SS format. The -w flag is  only  valid
78       if  a  datum  is  defined  for the current location.  If the -f flag is
79       given the x,y frame coordinates of the active display monitor  will  be
80       returned (as a percentage, 0,0 is bottom left).
81

EXAMPLE

83       Query position in map (North Carolina sample dataset):
84       d.rast elevation
85       d.where
86

SEE ALSO

88        d.what.rast, d.what.vect, g.region, v.what.rast, v.what.vect
89

AUTHORS

91       James Westervelt,
92       Michael Shapiro,
93       U.S. Army Construction Engineering Research Laboratory
94

SOURCE CODE

96       Available at: d.where source code (history)
97
98       Main  index | Display index | Topics index | Keywords index | Graphical
99       index | Full index
100
101       © 2003-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual
102
103
104
105GRASS 7.8.5                                                         d.where(1)