| 1 |
<h2>DESCRIPTION</h2> |
| 2 |
|
| 3 |
<em>d.geodesic</em> displays a geodesic line in the active frame on the user's |
| 4 |
graphics monitor. This is also known as the great circle line and traces the |
| 5 |
shortest distance between two user-specified points on the curved surface of |
| 6 |
a longitude/latitude data set. The two coordinate locations named must fall |
| 7 |
within the boundaries of the user's current geographic region. |
| 8 |
|
| 9 |
<h2>OPTIONS</h2> |
| 10 |
|
| 11 |
By default black line color and red text color will be used. |
| 12 |
|
| 13 |
<p> |
| 14 |
By indicating the starting and ending coordinates |
| 15 |
of the geodesic, the line and its length (by default in meters) are displayed to |
| 16 |
the graphical output. If the text color is set to <em>none</em>, |
| 17 |
the great circle distance is not displayed. |
| 18 |
|
| 19 |
<h2>EXAMPLE</h2> |
| 20 |
|
| 21 |
A geodesic line if shown over the political map of the world |
| 22 |
(demolocation dataset): |
| 23 |
|
| 24 |
<div class="code"><pre> |
| 25 |
g.region vector=country_boundaries -p |
| 26 |
d.mon wx0 |
| 27 |
d.vect country_boundaries type=area |
| 28 |
# show additionally a 20 degree grid |
| 29 |
d.grid 20 |
| 30 |
|
| 31 |
d.geodesic coordinates=55:58W,33:18S,26:43E,60:37N \ |
| 32 |
line_color=yellow text_color=red units=kilometers |
| 33 |
</pre></div> |
| 34 |
|
| 35 |
<p><center> |
| 36 |
<img src="d_geodesic.png" border="1" alt="Geodesic line (great circle line)"><br> |
| 37 |
<i>Geodesic line (great circle line)</i> |
| 38 |
</center> |
| 39 |
|
| 40 |
<h2>NOTES</h2> |
| 41 |
|
| 42 |
This program works only with longitude/latitude |
| 43 |
coordinate system. |
| 44 |
|
| 45 |
<h2>SEE ALSO</h2> |
| 46 |
|
| 47 |
<em> |
| 48 |
<a href="d.rhumbline.html">d.rhumbline</a>, |
| 49 |
<a href="d.grid.html">d.grid</a>, |
| 50 |
<a href="m.measure.html">m.measure</a> |
| 51 |
</em> |
| 52 |
|
| 53 |
<h2>AUTHOR</h2> |
| 54 |
|
| 55 |
Michael Shapiro, U.S. Army Construction Engineering Research Laboratory |