## NAME

m.gc2ll - Converts geocentric to geographic coordinates.
(GRASS Data Import/Processing Program)

## SYNOPSIS

m.gc2ll x=# y=# z=# s=spheroid

## DESCRIPTION

m.gc2ll returns geographic coordinates for geocentric ones supplied by the user. It performs the reverse operation of the GRASS program m.ll2gc. The x, y and z values are the three dimensions needed to locate a point in three-dimensional space. The values that are printed include the latitude, the longitude and the height above (or distance below) the spheroid.

The list of spheroids available is somewhat dynamic. It may not contain exactly the ones listed below. To determine the current list of possible spheroids, simply type in:

  m.gc2ll x=0 y=0 z=0 s=help

A list of available spheroids will be printed on the screen. If the spheroid desired is not on the list, the values for the semi-major axis and the eccentricity squared for the spheroid may be entered in place of a spheroid name in the following format:

  s=a=semi-major_axis,e=eccentricity_squared

### SOME POSSIBLE SPHEROIDS

(The on-line listing includes only the spheroid names)

    Spheroid	Commonly used for:	Semi-major axis	Eccentricity sqrd
    australian	Australia		6378160.0	0.0066945419
    bessel		Japan			6377739.155	0.0066743722
    clark66		N. America		6378206.4	0.006768658
    clark80		France, Africa		6378249.145	0.0068035113
    everest		India, Burma		6377276.345	0.0066378466
    international	Europe			6378388.0	0.00672267
    wgs72		worldwide coverage	6378135.0	0.006694317778

## EXAMPLE

The command:
  m.gc2ll x=0.0 y=0.0 z=6356750.520017 s=wgs72
Results:
  lat=90N
  lon=90W
  h=0.0000

## NOTES

For a brief discussion of spheroids see m.ll2u.

For a brief discussion of geocentric coordinates see m.ll2gc.

This is an experimental program. It is part of an initial effort to incorporate geographic coordinates into GRASS.

## SEE ALSO

m.datum.shift
m.ll2gc
m.ll2u
m.u2ll

## AUTHOR

Michael Shapiro, U.S.Army Construction Engineering Research Laboratory

Last changed: $Date: 2002/01/25 05:45:33 $