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-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                    NGGSOG(3NCARG)
Impressum