Annotation of researchv10no/cmd/map/export/route.1, revision 1.1.1.1

1.1       root        1: .TH ROUTE 1
                      2: .SH NAME
                      3: route \- map orientations and great circle paths
                      4: .SH SYNOPSIS
                      5: .B route
                      6: [ 
                      7: .B -t
                      8: ]
                      9: .SH DESCRIPTION
                     10: .I Route
                     11: without an option
                     12: reads from the standard input a sequence of points, expressed 
                     13: as latitude-longitude pairs.
                     14: For each pair of points, say A and B,
                     15: .I route
                     16: prints on the standard output
                     17: .IP \-
                     18: A
                     19: .IR map (7)
                     20: orientation, expressed as a
                     21: .B -o
                     22: option, that transforms the great circle from A to B into the equator.
                     23: The transformed locations of A and B are located on the equator
                     24: at equal distances west and east of the Prime Meridian.
                     25: .IP \-
                     26: The transformed coordinates of the two points.
                     27: .IP \-
                     28: The same information for a map orientation in which point A
                     29: appears to the east and B to the west of the Prime Meridian.
                     30: .PP
                     31: Under option
                     32: .B -t
                     33: .I route
                     34: produces coordinates along the great circle from A to B
                     35: in the form of a track for use with 
                     36: .I map
                     37: option
                     38: .BR -t .
                     39: .PP
                     40: Coordinates are expressed in degrees, with latitude
                     41: positive north of the equator and longitude positive
                     42: west of Greenwich.
                     43: .SH EXAMPLES
                     44: .HP
                     45: .B "echo 40.75 74 52 0 | route -t | map mercator -l 30 70 -10 80 -t - | plot
                     46: .br
                     47: Produce a map of the North Atlantic with a great circle plotted
                     48: from New York to London.
                     49: .TP
                     50: .B route
                     51: .br
                     52: .ns
                     53: .TP
                     54: .B 40.75 74 52 0
                     55: Produces the output
                     56: .RS
                     57: .IP
                     58: .nf
                     59: .ft L
                     60: -o 35.8283 -157.5308 -168.6148
                     61: A -0.0000 24.9943
                     62: B -0.0000 -24.9943
                     63: -o -35.8283 22.4692 168.6149
                     64: A -0.0000 -24.9943
                     65: B 0.0000 24.9943
                     66: .ft
                     67: .fi
                     68: .RE
                     69: .IP
                     70: From this we derive the following command to draw a strip map 
                     71: 20 degrees wide along the great circle from New York to London.
                     72: The
                     73: .B -w
                     74: option windows the map in the new coordinate system, where
                     75: the equator runs along the great circle and the two cities
                     76: sit at 25W and 25E on that `equator'.
                     77: The
                     78: .B -l
                     79: option avoids surveying the whole rest of the world for
                     80: plottable points.
                     81: .IP
                     82: .B
                     83: map mercator -o 35.83 -157.53 -168.61 -w -10 10 -30 30 -l 30 75 -10 80
                     84: .SH SEE ALSO
                     85: .IR map (7)

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.