d.geodesic(1grass)

1d.geodesic(1)                 Grass User's Manual                d.geodesic(1)
2
3
4

NAME

6       d.geodesic   -  Displays a geodesic line, tracing the shortest distance
7       between two geographic points along a great circle, in a longitude/lat‐
8       itude data set.
9

KEYWORDS

11       display, distance, great circle, shortest path
12

SYNOPSIS

14       d.geodesic
15       d.geodesic --help
16       d.geodesic      coordinates=lon1,lat1,lon2,lat2       [line_color=name]
17       [text_color=name]   [units=string]   [--help]   [--verbose]   [--quiet]
18       [--ui]
19
20   Flags:
21       --help
22           Print usage summary
23
24       --verbose
25           Verbose module output
26
27       --quiet
28           Quiet module output
29
30       --ui
31           Force launching GUI dialog
32
33   Parameters:
34       coordinates=lon1,lat1,lon2,lat2 [required]
35           Starting and ending coordinates
36
37       line_color=name
38           Line color
39           Either a standard color name or R:G:B triplet
40           Default: black
41
42       text_color=name
43           Text color
44           Either a standard color name or R:G:B triplet
45
46       units=string
47           Units
48           Units
49           Options: meters, kilometers, feet, miles
50           Default: meters
51

DESCRIPTION

53       d.geodesic  displays  a geodesic line in the active frame on the user’s
54       graphics monitor. This is also known  as  the  great  circle  line  and
55       traces  the  shortest distance between two user-specified points on the
56       curved surface of a longitude/latitude data  set.  The  two  coordinate
57       locations  named  must fall within the boundaries of the user’s current
58       geographic region.
59

OPTIONS

61       By default black line color and red text color will be used.
62
63       By indicating the starting and ending coordinates of the geodesic,  the
64       line and its length (by default in meters) are displayed to the graphi‐
65       cal output. If the text color is set to none, the great circle distance
66       is not displayed.
67

EXAMPLE

69       A geodesic line if shown over the political map of the world (demoloca‐
70       tion dataset):
71       g.region vector=country_boundaries -p
72       d.mon wx0
73       d.vect country_boundaries type=area
74       # show additionally a 20 degree grid
75       d.grid 20
76       d.geodesic coordinates=55:58W,33:18S,26:43E,60:37N \
77         line_color=yellow text_color=red units=kilometers
78
79       Geodesic line (great circle line)
80

NOTES

82       This program works only  in  GRASS  locations  with  longitude/latitude
83       coordinate system.
84

AUTHOR

89       Michael Shapiro, U.S. Army Construction Engineering Research Laboratory
90
91       Last changed: $Date: 2016-12-17 13:21:05 +0100 (Sat, 17 Dec 2016) $
92

SOURCE CODE

94       Available at: d.geodesic source code (history)
95
96       Main  index | Display index | Topics index | Keywords index | Graphical
97       index | Full index
98
99       © 2003-2019 GRASS Development Team, GRASS GIS 7.6.0 Reference Manual
100
101
102
103GRASS 7.6.0                                                      d.geodesic(1)