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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
|
*=======================================================================
*
* WCSLIB 7.4 - an implementation of the FITS WCS standard.
* Copyright (C) 1995-2021, Mark Calabretta
*
* This file is part of WCSLIB.
*
* WCSLIB is free software: you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published
* by the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* WCSLIB is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
* License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with WCSLIB. If not, see http://www.gnu.org/licenses.
*
* Author: Mark Calabretta, Australia Telescope National Facility, CSIRO.
* http://www.atnf.csiro.au/people/Mark.Calabretta
* $Id: twcstab.f,v 7.4 2021/01/31 02:24:52 mcalabre Exp $
*=======================================================================
PROGRAM TWCSTAB
*-----------------------------------------------------------------------
*
* TWCSTAB tests WCSTAB and also provides sample code for using it in
* conjunction with WCSPIH and FTWCST. Although this example and FTWCST
* are based on the CFITSIO library, WCSTAB itself is completely
* independent of it.
*
* We assume that the input file, ../C/wcstab.fits, has already been
* generated by running the C version of twcstab.
*
* WCSP and WTB, which are meant to hold addresses, are declared as
* INTEGER arrays of length 2 to accomodate 64-bit machines for which
* sizeof(void *) = 2*sizeof(int).
*=======================================================================
LOGICAL GOTEND
INTEGER BLOKSZ, I, J, K, IERR, IUNIT, NKEYRC, NREJECT, NWCS,
: NWTB, STATUS, WCSP(2), WTB(2)
CHARACTER KEYREC*80, HEADER*28801, INFILE*16
* On some systems, such as Sun Sparc, the struct MUST be aligned
* on a double precision boundary, done here using an equivalence.
* Failure to do this may result in mysterious "bus errors".
INCLUDE 'wcs.inc'
INCLUDE 'wcshdr.inc'
INCLUDE 'wcsfix.inc'
INCLUDE 'getwcstab.inc'
INTEGER STAT(WCSFIX_NWCS)
INTEGER WCS(WCSLEN)
DOUBLE PRECISION DUMMY
EQUIVALENCE (WCS,DUMMY)
DATA INFILE /'../C/wcstab.fits'/
*-----------------------------------------------------------------------
WRITE (*, 10)
10 FORMAT ('Testing WCSTAB and associated routines (twcstab.f)',/,
: '--------------------------------------------------',/)
* Open the FITS test file.
IUNIT = 1
STATUS = 0
CALL FTOPEN (IUNIT, INFILE, 0, BLOKSZ, STATUS)
IF (STATUS.NE.0) THEN
CALL FLUSH(6)
CALL FTRPRT ('STDERR', STATUS)
GO TO 999
END IF
* Read the primary header; unfortunately there is no FITSIO
* equivalent of CFITSIO's fits_hdr2str() so do it the long way.
OPEN (UNIT=1, FILE=INFILE, FORM='FORMATTED', ACCESS='DIRECT',
: RECL=80, IOSTAT=IERR)
IF (IERR.NE.0) THEN
WRITE (*, 20) IERR, INFILE
20 FORMAT ('ERROR',I3,' opening ',A)
GO TO 999
END IF
* Read in the FITS header, excluding COMMENT and HISTORY keyrecords.
K = 1
NKEYRC = 0
GOTEND = .FALSE.
DO 50 J = 0, 100
DO 40 I = 1, 36
READ (1, '(A80)', REC=36*J+I, IOSTAT=IERR) KEYREC
IF (IERR.NE.0) THEN
WRITE (*, 30) IERR
30 FORMAT ('ERROR',I3,' reading header.')
GO TO 999
END IF
IF (KEYREC(:8).EQ.' ') GO TO 40
IF (KEYREC(:8).EQ.'COMMENT ') GO TO 40
IF (KEYREC(:8).EQ.'HISTORY ') GO TO 40
HEADER(K:) = KEYREC
K = K + 80
NKEYRC = NKEYRC + 1
IF (KEYREC(:8).EQ.'END ') THEN
* An END keyrecord was read, read the rest of the block.
GOTEND = .TRUE.
END IF
40 CONTINUE
IF (GOTEND) GO TO 60
50 CONTINUE
60 CLOSE (UNIT=1)
*-----------------------------------------------------------------------
* Basic steps required to interpret a FITS WCS header, including -TAB.
*-----------------------------------------------------------------------
* Parse the primary header of the FITS file.
STATUS = WCSPIH (HEADER, NKEYRC, WCSHDR_all, 2, NREJECT, NWCS,
: WCSP)
IF (STATUS.NE.0) THEN
WRITE (*, 70) STATUS, WCSHDR_ERRMSG(STATUS)
70 FORMAT ('WCSPIH ERROR',I2,A)
GO TO 999
END IF
* Copy into our WCSPRM struct.
IERR = WCSVCOPY (WCSP, 0, WCS)
* Read coordinate arrays from the binary table extension.
STATUS = WCSGTI (WCS, WCS_NWTB, NWTB)
STATUS = WCSGTI (WCS, WCS_WTB, WTB)
STATUS = FTWCST (IUNIT, NWTB, WTB, STATUS)
IF (STATUS.NE.0) THEN
CALL FLUSH(6)
CALL FTRPRT ('STDERR', STATUS)
GO TO 999
END IF
* Fix non-standard WCS keyvalues.
STATUS = WCSFIX (7, 0, WCS, STAT)
IF (STATUS.NE.0) THEN
WRITE (*, 80) (STAT(I), I=1,WCSFIX_NWCS)
80 FORMAT ('WCSFIX ERROR, status returns: ',10(I2,:,','))
GO TO 999
END IF
*-----------------------------------------------------------------------
* The wcsprm struct is now ready for use.
*-----------------------------------------------------------------------
* Finished with the FITS file.
CALL FTCLOS (IUNIT, STATUS)
* Initialize the wcsprm struct, taking memory allocated by FTWCST.
IF (STATUS.EQ.0) STATUS = WCSSET (WCS)
IF (STATUS.NE.0) THEN
WRITE (*, 90) STATUS, WCS_ERRMSG(STATUS)
90 FORMAT ('WCSSET ERROR',I2,A)
GO TO 998
END IF
* Do something with it.
CALL FLUSH(6)
STATUS = WCSPRT (WCS)
* Clean up.
998 STATUS = WCSFREE (WCS)
STATUS = WCSVFREE (NWCS, WCSP)
999 CONTINUE
END
|
