2
fitsTcl 2.1.1 Installation Guide
2
fitsTcl Installation Guide
5
5
fitsTcl is a TCL interface to the CFITSIO astronomical library
6
6
which provides access to FITS data files. It can be used either by
7
itself within the standard tcl/tk applications tclsh and wish, or
7
itself within the standard Tcl/Tk applications tclsh and wish, or
8
8
within the fv software package also distributed by the HEASARC at
11
11
The fitsTcl User's Guide is located in the fitsTcl.html file
12
distributed with fitsTcl2.1.1 and located on the web at:
14
http://heasarc.gsfc.nasa.gov/ftools/fv/fitsTcl.html
16
Send any bug reports to ftoolshelp@athena.gsfc.nasa.gov.
18
fitsTcl can be built under Unix/Linux (PowerPC or Intel), MacOS,
19
and Windows. You will need a version of Tcl8.x, available either
20
from Scriptics (www.scriptics.com) or HEASARC as part of the fv
21
distribution (heasarc.gsfc.nasa.gov/ftools/fv). Read the following
22
for instructions for building on each platform.
26
********************************************************************************
27
UNIX (including Mac OS X)
28
********************************************************************************
31
To build the fitsTcl shared library do the following:
33
1. Unpack the compressed fitsTcl tar file and enter the fitsTcl2.1.1
36
2. Download the latest version of the cfitsio source code (for UNIX)
39
http://heasarc.gsfc.nasa.gov/docs/software/lheasoft/fitsio/fitsio.html
41
and unpack the source tar file.
43
3. Configure fitsTcl for your system with the command
45
./configure [optional arguments]
47
where the optional arguments are:
49
--prefix=DIR1 --with-cfitsio=DIR2 --with-tcl-includes=DIR3
51
DIR1 is the installation path (default is /usr/local)
53
DIR2 is the path to the cfitsio source directory
54
(default is ./cfitsio)
56
DIR3 is the path to the location of the tcl.h header file
57
(default is $prefix/include or /usr/include).
59
These may be considered optional only if the defaults are valid
60
for your system/setup.
62
The final library will be installed in the directory DIR1/lib
63
which must exist. Note that the library itself does not depend
64
on the value of DIR1, only the installation step in the Makefile.
66
4. Build fitsTcl with the command
70
5. Install fitsTcl either with the command
74
which will place it in the DIR1/lib directory, or move the
75
library (libfitstcl.so, or libfitstcl.dylib under Mac OS X)
76
manually to where you want it.
78
To use fitsTcl, startup tclsh or wish and type the command
80
load libfitstcl.so (libfitstcl.dylib on Mac OS X)
82
You may need to specify an explicit path to the library or set
83
the LD_LIBRARY_PATH (DYLD_LIBRARY_PATH on Mac OS X) to its location.
86
********************************************************************************
88
********************************************************************************
91
To build fitsTcl extension do the following:
93
1. Download and build the Mac TCL software available from
94
Scriptics (www.scriptics.com).
96
2. Download and expand the fitsTcl distribution, which will
97
create a fitsTcl2.1.1 subdirectory.
99
3. Download the latest version of the cfitsio source code from:
101
http://heasarc.gsfc.nasa.gov/docs/software/lheasoft/fitsio/fitsio.html
103
and untar it under the fitsTcl2.1.1 directory (i.e. such that
104
you have a fitsTcl2.1.1/cfitsio directory).
106
4. Debinhex and expand the file fitsTcl.sit.hqx, creating
107
a fitsTcl folder containing a Codewarrior 5 project file,
110
5. Open the new project file and update the Access Paths to
111
point to your TCL source tree.
113
6. Build the 'fitsTcl DLL' target. This will create a file
114
fitsTcl.dll in the fitsTcl directory. Move it to where ever
115
is convenient and use 'load fitsTcl.dll' to load it into
118
(Note: We do not distribute a binary version of the plugin since it
119
is dependent on the major TCL version -- 8.0, 8.1, etc -- used in
120
building it. We may distribute one, though, if there is sufficient
121
demand for use with a particular TCL release.)
125
********************************************************************************
127
********************************************************************************
130
Building fitsTcl requires Microsoft Visual C++. A Borland C v5
131
makefile is also included, although it has not been updated since
134
To build fitsTcl DLL do the following:
136
1. Download and build the Windows TCL software available from
137
Scriptics (www.scriptics.com).
139
2. Download and expand the fitsTcl distribution, which will
140
create a fitsTcl2.1.1 subdirectory.
142
3. Download the latest version of the cfitsio source code from:
144
http://heasarc.gsfc.nasa.gov/docs/software/lheasoft/fitsio/fitsio.html
146
and untar it under the fitsTcl2.1.1 directory (i.e. such that
147
you have a fitsTcl2.1.1/cfitsio directory).
149
4. Edit the file makefile.vc (or makefile.bc5) and update the
150
paths for your specific setup. We have our source tree at
151
D:\FV_SRC. Replace this and the TCL8.2.2 references as
154
5. Type the command 'nmake -f makefile.vc'. This will build
155
a fitstcl.dll file. Move it to where ever is convenient and
156
use 'load fitstcl.dll' to load it into tclsh or wish.
12
distributed with fitsTcl and located on the web at:
14
http://heasarc.gsfc.nasa.gov/ftools/fv/fitsTcl.html
16
fitsTcl can be built under PC Linux or Mac OS X, and requires the
17
CFITSIO and Tcl packages. Instructions for building the software
20
Please send any questions or problem reports to the FTOOLS help desk:
22
ftoolshelp@bigbang.gsfc.nasa.gov.
24
Before building fitsTcl, make sure you have Tcl installed on your
25
machine and can locate the tcl.h header file. To build the fitsTcl
28
1. Download the latest version of the cfitsio source code from:
30
http://heasarc.gsfc.nasa.gov/docs/software/fitsio/fitsio.html
32
and unpack the tar file.
34
2. Unpack the compressed fitsTcl tar file and enter the fitsTcl-2.4
37
3. Configure fitsTcl for your system with the command
39
./configure [optional arguments]
41
where the optional arguments are:
43
--prefix=DIR1 --with-cfitsio=DIR2 --with-tcl-includes=DIR3
45
DIR1 is the installation path (default is /usr/local)
47
DIR2 is the path to the cfitsio source directory
48
(default is ./cfitsio)
50
DIR3 is the path to the location of the tcl.h header file
51
(default is $prefix/include or /usr/include).
53
These may be considered optional only if the defaults are valid
54
for your system/setup.
56
Under the Cygwin environment, an additional argument is required:
60
DIR4 is the path to the location of the Tcl library (libtcl8.x.dll).
62
The final library will be installed in the directory DIR1/lib
63
which must exist. Note that the library itself does not depend
64
on the value of DIR1, only the installation step in the Makefile.
66
4. Build fitsTcl with the command
70
5. Install fitsTcl either with the command
74
which will place it in the DIR1/lib directory, or move the
75
library (libfitstcl.so, or libfitstcl.dylib under Mac OS X)
76
manually to where you want it.
78
To use fitsTcl, startup tclsh or wish and type the command
80
load libfitstcl.so (libfitstcl.dylib on Mac OS X)
82
You may need to specify an explicit path to the library or set the
83
LD_LIBRARY_PATH (DYLD_LIBRARY_PATH on Mac OS X) to its location.