diff options
Diffstat (limited to 'docs/INSTALLING_CalFUSEv3.2.3')
| -rw-r--r-- | docs/INSTALLING_CalFUSEv3.2.3 | 215 |
1 files changed, 0 insertions, 215 deletions
diff --git a/docs/INSTALLING_CalFUSEv3.2.3 b/docs/INSTALLING_CalFUSEv3.2.3 deleted file mode 100644 index 9579254..0000000 --- a/docs/INSTALLING_CalFUSEv3.2.3 +++ /dev/null @@ -1,215 +0,0 @@ -# -# 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 |