aboutsummaryrefslogtreecommitdiff
path: root/pkg/xtools/skywcs/doc/skultran.hlp
blob: ca02385efdfb927dad162ddd305573bae246584c (plain) (blame)
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
.help skultran Mar00 Skywcs
.ih
NAME
skultran -- transform between coordinate systems
.ih
SYNOPSIS
call sk_ultran (incoo, outcoo, ilng, ilat, olng, olat, npts)

.nf
pointer	incoo		# the input sky coordinate descriptor
pointer	outcoo		# the output sky coordinate descriptor
double ilng, ilat	# the input celestial coordinates in expected units
double olng, olat	# the output celestial coordinates in expected units
int	npts		# the number of input and output coordinate pairs
.fi
.ih
ARGUMENTS
.ls  incoo    
The input sky coordinate descriptor.
.le
.ls  outcoo    
The output sky coordinate descriptor.
.le
.ls ilng, ilat
The input sky coordinates in the units defined by the integer parameters
S_NLNGUNITS and S_NLATUNITS.
.le
.ls olng, olat
The output sky coordinates in the units defined by the integer parameters
S_NLNGUNITS and S_NLATUNITS.
.le
.ls npts
The number of input and output coordinate pairs.
.le
.ih
DESCRIPTION
The coordinates in the input coordinate system are converted to 
coordinates in the output coordinates system.

If the calling program has not set the S_NLNGUNITS and S_NLATUNITS parameters
in either system the expected coordinates are hours and degrees for
equatorial sky coordinate systems and degrees and degrees for other sky
coordinate systems. The calling program must either perform the necessary
coordinate conversions or set the units parameters in the input and output
sky coordinate descriptors appropriately.

.ih
SEE ALSO
sk_lltran, sk_equatorial
.endhelp