1m.cogo(1) Grass User's Manual m.cogo(1)
2
6 m.cogo - A simple utility for converting bearing and distance measure‐
7 ments to coordinates and vice versa.
8 It assumes a cartesian coordinate system
9
11 miscellaneous
12
14 m.cogo
15 m.cogo help
16 m.cogo [-lqr] [input=name] [output=name] [coord=x,y] [--verbose]
17 [--quiet]
18 Flags:
20 -l
21 Lines are labelled
22 -q
24 Suppress warnings
25 -r
27 Convert from coordinates to bearing and distance
28 --verbose
30 Verbose module output
31 --quiet
33 Quiet module output
34 Parameters:
36 input=name
37 Name of input file
38 Default: -
39 output=name
41 Name for output file
42 Default: -
43 coord=x,y
45 Starting coordinate pair
46 Default: 0.0,0.0
47
49 m.cogo converts data points between bearing and distance and X,Y coor‐
50 dinates. Only simple bearing/distance or coordinate pairs are handled.
51 It assumes a cartesian coordinate system.
52 Input can be entered via standard input (default) or from the file
54 input=name. Specifying the input as "-" also specifies standard input,
55 and is useful for using the program in a pipeline. Output will be to
56 standard output unless a file name other than "-" is specified. The
57 input file must closely adhere to the following format, where up to a
58 10 character label is allowed but not required (see -l flag).
59 Example COGO input:
61 P23 N 23:14:12 W 340
63 P24 S 04:18:56 E 230
64 The first column may contain a label and you must use the -l flag so
66 the program knows. This is followed by a space, and then either the
67 character 'N' or 'S' to indicate whether the bearing is relative to the
68 north or south directions. After another space, the angle begins.
69 Generally, the angle can be of the form digits + separator + digits +
70 separator + digits [+ '.' + digits]. A space follows the angle, and is
71 then followed by either the 'E' or 'W' characters. A space separates
72 the bearing from the distance (which should be in appropriate linear
73 units).
74 Output of the above input:
76 -134.140211 312.420236 P23
78 -116.832837 83.072345 P24
79 Unless specified with the coord option, calculations begin from (0,0).
81 For those unfamiliar with the notation for bearings: Picture yourself
83 in the center of a circle. The first hemispere notation tell you
84 whether you should face north or south. Then you read the angle and
85 either turn that many degrees to the east or west, depending on the
86 second hemisphere notation. Finally, you move units in that direction
87 to get to the next station. m.cogo can be run either non-interactively
88 or interactively. The program will be run non-interactively if the
89 user specifies any parameter or flag. Use "m.cogo -", to run the pro‐
90 gram in a pipeline. Without any flags or parameters, m.cogo will
91 prompt for each value using the familiar GRASS parser interface.
92
94 This program is very simplistic, and will not handle deviations from
95 the input format explained above. Currently, the program doesn't do
96 anything particularly useful with the output. However, it is envi‐
97 sioned that this program will be extended to provide the capability to
98 generate vector and/or sites layers.
99
101 Eric G. Miller
102 Last changed: $Date: 2005-06-21 06:18:52 +0200 (Tue, 21 Jun 2005) $
104 Full index
106 © 2003-2008 GRASS Development Team
108GRASS 6.3.0 m.cogo(1)