1NGGCOG(3NCARG)                   NCAR GRAPHICS                  NGGCOG(3NCARG)
2
3
4

NAME

6       NGGCOG - Returns the latitudes and longitudes of a set of points
7       approximating a circle at a given point on the surface of the globe.
8

SYNOPSIS

10       CALL NGGCOG (CLAT,CLON,CRAD,ALAT,ALON,NPTS)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_nggcog(float clat, float clon, float crad, float *alat,
16       float *alon, int npts)
17

DESCRIPTION

19       CLAT        (an input expression of type REAL) is the latitude, in
20                   degrees, of a point on the globe defining the center of the
21                   circle.
22
23       CLON        (an input expression of type REAL) is the longitude, in
24                   degrees, of a point on the globe defining the center of the
25                   circle.
26
27       CRAD        (an input expression of type REAL) specifies the radius of
28                   the circle.  This is given as a great-circle distance, in
29                   degrees.
30
31       ALAT        (an output array, of type REAL, dimensioned NPTS) is an
32                   array in which the latitudes of points on the circle are to
33                   be returned.
34
35       ALON        (an output array, of type REAL, dimensioned NPTS) is an
36                   array in which the longitudes of points on the circle are
37                   to be returned.
38
39       NPTS        (an input expression, of type INTEGER) is the desired
40                   number of points to be used to represent the circle.  Its
41                   value determines how accurately the circle will be
42                   represented.
43

C-BINDING DESCRIPTION

45       The C binding argument descriptions are the same as the FORTRAN
46       argument descriptions.
47

USAGE

49       Let C represent (CLAT,CLON) and let O represent the center of the
50       globe.  The circle is the set of all points P on the globe such that
51       the angle POC is of the size specified by CRAD.
52
53       SIN and COS are used to generate points representing a circle having
54       the desired radius and centered at the North Pole.  These points are
55       then subjected to two rotations - one that brings the circle down to
56       the desired latitude, and another that carries it to the desired
57       longitude.
58

EXAMPLES

60       Use the ncargex command to see the following relevant example: cpex10.
61

ACCESS

63       To use NGGCOG or c_nggcog, load the NCAR Graphics libraries ncarg,
64       ncarg_gks, and ncarg_c, preferably in that order.
65

MESSAGES

67       None.
68

SEE ALSO

70       Online: nggsog(3NCARG), ngritd(3NCARG).
71

73       Copyright (C) 1987-2007
74       University Corporation for Atmospheric Research
75
76       This documentation is free software; you can redistribute it and/or
77       modify it under the terms of the GNU General Public License as
78       published by the Free Software Foundation; either version 2 of the
79       License, or (at your option) any later version.
80
81       This software is distributed in the hope that it will be useful, but
82       WITHOUT ANY WARRANTY; without even the implied warranty of
83       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
84       General Public License for more details.
85
86       You should have received a copy of the GNU General Public License along
87       with this software; if not, write to the Free Software Foundation,
88       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
89
90
91
92UNIX                              March 1993                    NGGCOG(3NCARG)
Impressum