m.geo(1)		      Grass User's Manual		      m.geo(1)



NNAAMMEE
       mm..ggeeoo  - Calculates conversion coordinates for geographic positions.
       _"_(_S_C_S _G_R_A_S_S _M_a_p _D_e_v_e_l_o_p_m_e_n_t _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       mm..ggeeoo
       mm..ggeeoo hheellpp

DDEESSCCRRIIPPTTIIOONN
       This program allows a user to interactively: convert projection coordi-
       nates Northings and Eastings to Latitude and Longitude values,  or


       allows a user to interactively: convert Latitude and  Longitude	values
       to projection coordinate Northings and Eastings.


       It  allows  a user to do all of the above: reading from a file, writing
       to the screen,  or reading from the keyboard, writing  to  a  file,  or
       reading from a file, writing to a file,


       Note:   The  program  does not transform GRASS files, it is designed to
       determine coordinate values on an individual position.


       Several map projections are currently supported:
       stp - State Plane,

	     for all CONUS, Alaska, Hawaii, Puerto Rico, Guam, Virgin Islands,
	     American Samoa, Northern Mariana Islands, Palau, and
	     U.S. Minor Outlying Islands

       airy   - Airy-F
       aea    - Albers Egual Area-FI
       apian  - Apian Globular I-F
       aeqd   - Azimuthal equidistant-FI
       aitoff - Aitoff-F
       august - August Epicycloidal-F

       bacon  - Bacon Globular-F
       bipc   - Bipolar Conic-FI
       boggs  - Boggs Eumorphic-F
       bonne  - Bonne-FI

       cass   - Cassini-FI
       cc     - Central Cylindrical-FI
       cea    - Cylindrical Equal Area-FI
       collg  - Collignon-FI

       dense  - Denoyer Semi-Elliptical-F

       eck1   - Eckert I-FI	       eck2 - Eckert II-FI
       eck3   - Eckert III-FI	       eck4 - Eckert IV-FI
       eck5   - Eckert V-FI	       eck6 - Eckert VI-FI
       eisen  - Eisenlohr-F
       eqc    - Equidistant Cylindrical-FI
       eqdc   - Equidistant Conic-FI

       fourn  - Fournier Globular-F

       gall   - Gall (Stereographic)-FI
       goode  - Goode Homolosine-F
       gnom   - Gnomonic-FI

       hammer - Hammer (Elliptical)-F
       hataea - Hatano Asymmetrical Equal Area-FI

       lagrng - Lagrange-F
       laea   - Lambert Azimuthal Equal Area-FI
       leac   - Lambert Equal Area Conic-FI
       lcc    - Lambert Conformal Conic-FI
       loxim  - Loximuthal-FI

       mbtfpp - McBryde-Thomas Flat-Polar Parabolic-FI
       mbtfps - McBryde-Thomas Flat-Polar Sinusoidal-FI
       mbtfpq - McBryde-Thomas Flat-Polar Quartic-FI
       merc   - Mercator-FI
       mill   - Miller-FI
       moll   - Mollweides-FI

       nicol  - Nicolosi Globular-F
       nsper  - General Vertical Persepective-FI

       ocea   - Oblique Cylindrical Equal Area-FI
       omerc  - Oblique Mercator-FI
       ortel  - Ortelius-F
       ortho  - Orthographic-FI

       parab  - Caster Parabolic-FI
       pconic - Perspective Conic-F
       poly   - Polyconic (American)-FI
       putp2  - Putnins P2'-FI
       putp5  - Putnins P5-FI

       quau   - Quartic Authalic-FI

       rpoly  - Rectangular Polyconic-F
       robin  - Robinson-FI

       sinu   - Sinusoidal-FI
       stere  - Stereographic-FI

       tcc    - Transverse Central Cylindrical-FI
       tcea   - Transverse Cylindrical Equal Area-FI
       tmerc  - Transverse Mercator-FI
       tpers  - Tilted perspective-FI

       ups    - Universal Polar Stereographic-FI
       utm    - Universal Transverse Mercator-FI

       vandg  - Van der Grinten-FI
       vandg2 - Van der Grinten II-F
       vandg3 - Van der Grinten III-F
       vandg4 - Van der Grinten IV-F

       wag7   - Wagner VII-F
       wink1  - Winkel I-FI
       wintri - Winkel Tripel-F
	 Each of the above projections (with the exception of State Plane) can
       be computed with the following spheroids:
       MERIT	 - MERIT 1983
       GRS80	 - GRS 1980(IUGG, 1980)
       IAU76	 - IAU 1976
       airy	 - Airy 1830
       aust_ntl  - Australian Natl, S. Amer., IAU 64
       GRS67	 - GRS 67(IUGG 1967)
       bessel	 - Bessel 1841
       clrk66	 - Clarke 1866
       clrk80	 - Clarke 1880 mod.
       everest	 - Everest 1830
       hough	 - Hough
       intl	 - International 1909 (Hayford)
       krass	 - Krassovsky, 1942
       mercury	 - Mercury 1960
       mod_airy  - Modified Airy
       mod_ever  - Modified Everest
       mod_merc  - Modified Merc 1968
       new_intl  - New International 1967
       SEasia	 - Southeast Asia
       walbeck	 - Walbeck
       WGS66	 - WGS 66
       WGS72	 - WGS 72
       sphere	 - Sphere of 6370997 m


IINNPPUUTT FFIILLEE FFOORRMMAATT
       When reading from a file of LATITUDE/LONGITUDE data the file will  con-
       tain three (3) columns of information:
       the first column - latitude   - in degrees minutes seconds,
       the second column - longitude - in degrees minutes seconds,
       the third column - zone	     - zero(0) if not required.


       For example:
		  +40 36 31.4563     -87 2 7.8193   16
		  40n 36 31.4563     87w 2 7.8193   16



       When  reading  from a file of PROJECTION COORDINATES data the file will
       contain three (3) columns of information:
       the first column - easting - ground coordinates
       the second column - northing - ground coordinates
       the third column - zone	     - zero(0) if not required.



       For example:
	      500000.00    4496918.64	  16   <- utm
	     -424489.11    1908736.13	  0    <- lambert




       Note: NO column headings are required, just the numbers.

SSEEEE AALLSSOO
       _M_a_p_g_e_n, _p_r_o_j

AAUUTTHHOORR
       R.L. Glenn, USDA, SCS, NHQ-CGIS



       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_3 _$



GRASS 5.0							      m.geo(1)
