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

NAME

6       NGGSOG - Returns the latitudes and longitudes of six points defining a
7       five-pointed star at a given point on the surface of the globe.
8

SYNOPSIS

10       CALL NGGSOG (SLAT,SLON,SRAD,ALAT,ALON)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_nggsog(float slat, float slon, float srad, float *alat,
16       float *alon)
17

DESCRIPTION

19       SLAT        (an input expression of type REAL) is the latitude, in
20                   degrees, of a point on the globe defining the center of the
21                   star.
22
23       SLON        (an input expression of type REAL) is the longitude, in
24                   degrees, of a point on the globe defining the center of the
25                   star.
26
27       SRAD        (an input expression of type REAL) specifies the great-
28                   circle distance, in degrees, from the center of the star to
29                   the end of one of its points.
30
31       ALAT        (an output array, of type REAL, dimensioned 6) is an array
32                   in which the latitudes of points on the star are to be
33                   returned.
34
35       ALON        (an output array, of type REAL, dimensioned 6) is an array
36                   in which the longitudes of points on the star are to be
37                   returned.
38

C-BINDING DESCRIPTION

40       The C binding argument descriptions are the same as the FORTRAN
41       argument descriptions.
42

USAGE

44       Let C represent (CLAT,CLON), let O represent the center of the globe,
45       and let P represent the end of one point of the star.  Then, the angle
46       POC has the magnitude specified by SRAD.
47
48       SIN, COS, and TAN are used to generate points representing a star
49       having the desired radius and centered at the the point with latitude 0
50       and longitude 0.  These points are then subjected to two rotations -
51       one that brings the star up to the desired latitude, and another that
52       carries it to the desired longitude.
53
54       NGGSOG is intended to be used for relatively small stars marking points
55       of interest on the surface of the globe; using SRAD = 90 degrees is
56       guaranteed to get you into trouble and SRAD < 10 degrees is
57       recommended.
58

EXAMPLES

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

ACCESS

63       To use NGGSOG or c_nggsog, 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: nggcog(3NCARG), ngritd(3NCARG).
71
73       Copyright (C) 1987-2009
74       University Corporation for Atmospheric Research
75       The use of this Software is governed by a License Agreement.
76
77
78
79UNIX                              March 1993                    NGGSOG(3NCARG)
Impressum