-
Notifications
You must be signed in to change notification settings - Fork 104
/
makecirclecoord.3
69 lines (69 loc) · 2.16 KB
/
makecirclecoord.3
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "makecirclecoord" "1" "2021-02-15" "Fortran 95" "SHTOOLS 4.11"
.hy
.SH MakeCircleCoord
.PP
Compute the coordinates of a circle placed at a given latitude and
longitude.
.SH Usage
.PP
call MakeCircleCoord (\f[V]coord\f[R], \f[V]lat\f[R], \f[V]lon\f[R],
\f[V]theta0\f[R], \f[V]cinterval\f[R], \f[V]cnum\f[R],
\f[V]exitstatus\f[R])
.SH Parameters
.TP
\f[V]coord\f[R] : output, real(dp), dimension(360/\f[V]cinterval\f[R], 2)
The latitude (:,1) and longitude (:,2) coordinates of the circle in
degrees.
If not specified, \f[V]cintervaL\f[R] is assumed to 1.
.TP
\f[V]lat\f[R] : input, real(dp)
The latitude of the center of the circle in degrees.
.TP
\f[V]lon\f[R] : input, real(dp)
The longitude of the center of the circle in degrees.
.TP
\f[V]theta0\f[R] : input, real(dp)
The angular radius of the circle in degrees.
.TP
\f[V]cinterval\f[R] : optional, input, real(dp), default = 1
Angular spacing in degrees of the output latitude and longitude points.
If not present, the default is 1.
.TP
\f[V]cnum\f[R] : optional, output, integer(int32)
Number of elements in the output arrays.
.TP
\f[V]exitstatus\f[R] : output, optional, integer(int32)
If present, instead of executing a STOP when an error is encountered,
the variable exitstatus will be returned describing the error.
0 = No errors; 1 = Improper dimensions of input array; 2 = Improper
bounds for input variable; 3 = Error allocating memory; 4 = File IO
error.
.SH Description
.PP
\f[V]MakeCircleCoord\f[R] will calculate the latitude and longitude
coordinates of a circle of angular radius \f[V]theta0\f[R] placed on a
sphere at position (\f[V]lat\f[R], \f[V]lon\f[R]).
This is useful for plotting circles on geographic maps.
The first index in the output vectors corresponds to the point directly
north of the cirlce origin, and subsequent points are arranged in a
clockwise manner.
Input and output units are in degrees.
.SH See also
.PP
makeellipsecoord