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
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
|
#
# Note: Before downloading CalFUSE, please send a blank e-mail to
# fuse_support@pha.jhu.edu with the subject line "GOT CALFUSE".
# We'll save your address and send you information about future
# software updates or bug reports. Thanks!
#
-------------------------------------------------------------------------------
INSTALLING CalFUSE v3.2.3
-------------------------------------------------------------------------------
These instructions cover Solaris, Linux, Linux 64, and Mac OS X
installations.
You will need at least 1.6 GB of disk space to install the pipeline and
its associated calibration files.
The software is in the tar file cfv3.2.3.sw.tar.gz
The calibration files are divided among three tar files:
cfv3.2.3.cala.tar.gz <-- Cal files that start with letter a
cfv3.2.3.calg.tar.gz <-- Cal files that start with letter g
cfv3.2.3.calz.tar.gz <-- All other cal files
A. DOWNLOADING THE CALFUSE SOFTWARE AND ASSOCIATED CALIBRATION FILES:
---------------------------------------------------------------------
Obtain the compressed tar files:
prompt> ftp fuse.pha.jhu.edu
login: anonymous
password: <your_email_address>
cd fuseftp/calfuse
binary
get cfv3.2.3.sw.tar.gz
get cfv3.2.3.cala.tar.gz
get cfv3.2.3.calg.tar.gz
get cfv3.2.3.calz.tar.gz
bye
Uncompress and extract all tarfiles in your calfuse directory.
B. INSTALLATION INSTRUCTIONS:
-----------------------------
0) Note for all systems:
You need to type "make -e install" only once, not in each
subdirectory.
1) SOLARIS
First check whether '/opt/SUNWspro/lib' is in your
'LD_LIBRARY_PATH' environment variable. If it is not, be
sure to add it.
In [calfuse_directory]/v3.2/src, type:
make distclean
chmod +x configure.solaris
./configure.solaris
make clean
make -e install
The Solaris operating system should come with a Fortran
compiler; however, if the configure routine returns an error
message about Fortran, it is probably missing, and you will
have to install it. To do so, follow the instructions for
Solaris in the file INSTALLING_A_FORTRAN_COMPILER.
2) LINUX and LINUX 64
If you are running Linux on a 64-bit machine, you must also
install a 64-bit version of the CFITSIO library. You
can skip this step if your machine is running in 32-bit
mode. The operation may require root access to your system,
so you may have to ask for help from your system manager.
First use your 'Applications/Add-Remove Software'
tool to see whether CFITSIO is available by default on
your system (as it is for Scientific Linux version 5.0).
If so, install it; if not, you can download the release
corresponding to your operating system from the Internet.
Search for 'cfitsio' on the web page http://rpm.pbone.net/.
If this page is not available, search the FITSIO webpage
(http://heasarc.gsfc.nasa.gov/docs/software/fitsio/fitsio.html)
for RPM format distributions.
Once the necessary libraries are installed, move to the
directory [calfuse_directory]/v3.2/src and type
make distclean
chmod +x configure.linux or chmod +x configure.linux64
./configure.linux or ./configure.linux64
make clean
make -e install
Notes:
a) GCC should come with a Fortran compiler; however, if the
configure routine returns an error message about Fortran,
it is probably missing, and you will have to install it.
To do so, follow the instructions for Linux in the file
INSTALLING_A_FORTRAN_COMPILER.
b) If the compilation fails with an error such as:
"undefined reference to '_gfortran_pow_i4_i4'" or similar,
it probably means you have both g77 and gfortran installed.
In this case we recommand that you try to remove the gfortran
package from your Linux distribution (using synaptic, apt-get
or aptitude, for example).
c) Linux64 users: If you installed cfitsio in a directory
other than the usual '/usr/include/cfitsio', determine the
path you used, for example '/usr/local/cfitsio64' and, in
[calfuse_directory]/v3.2/src, type the following commands,
where <new_path> is the path identified above:
cp configure.linux64 configure.linux64.sv
sed -e "s#/usr/include/cfitsio#<new_path>#g#" \
configure.linux64.sv > configure.linux64.sv2
sed -e "s/#cfit/ /g" \
configure.linux64.sv2 > configure.linux64
Then restart the installation procedure.
d) If you encounter trouble with SELinux while installing
CalFUSE, you should read the informations from Michael Van
Steenberg in the file FIXING_SELINUX_ISSUES.
3) MAC OS X
In [calfuse_directory]/v3.2/src type
make distclean
chmod +x configure.macosx
./configure.macosx
make clean
make -e install
Notes:
a) CalFUSE requires Mac OS X 10.2 or higher.
b) CalFUSE uses both the C and Fortran compilers. If you
are running OS X 10.3 or above, you probably have a C
compiler. If not, retrieve the Xcode suite of developer
tools from the Apple Developer Connection website
(developer.apple.com). To obtain the Fortran compiler,
follow the instructions for MacOS in the file
INSTALLING_A_FORTRAN_COMPILER.
c) If the linker complains about missing library routines,
you may need to modify the definition of LIBS in the various
Makefiles. For example, you may need to replace "-L/usr/local/lib"
with "-L/sw/lib".
d) For best results, run CalFUSE in an X11 window; otherwise,
your trailer files will be full of warning messages from IDL.
e) FYI: the environment variable called 'LD_LIBRARY_PATH'
on other systems is called 'DYLD_LIBRARY_PATH' by Mac OS.
C. SETTING THE ENVIRONMENT VARIABLES:
-------------------------------------
The directory '[calfuse_directory]/v3.2/bin' contains the
scripts 'cfsetup.sh' and 'cfsetup.csh', which define the
environment variables needed by CalFUSE. You will run one
of these two depending on the shell you are using.
Usually, if you are on a Solaris machine or on a Mac running
OS X 10.2, you will use the '.csh' script. On Linux and
more recent versions of MAC OS X, you should probably use
the '.sh' script. If one gives you an error message, try
the other.
The scripts assume that you have installed the pipeline in
your home directory. If you have installed it elsewhere,
you must edit the script, changing the root CalFUSE directory
('CF_DIR') defined at the beginning.
If you are using the '.csh' script, do the following:
source cfsetup.csh
rehash
If you are using the '.sh' script, do the following:
source cfsetup.sh
hash -r
You can also insert the whole script into your '.login'
file, in which case the environment variables will be set
each time you log in.
D. RUNNING THE PIPELINE:
------------------------
To run the pipeline on either timetag or histogram
data, just type 'calfuse' followed by the name of the raw
data file. For example:
calfuse P99901010011attagfraw.fit
calfuse P99901010011ahistfraw.fit
Address questions or concerns to fuse_support@pha.jhu.edu.
- Van Dixon, Bernard Godard, and Benjamin Ooghe-Tabanou
|
