1 ####################################################
2 README
3
4 TINA : Algorithm Development Libraries Version 4.0
5
6 NiAC,
7 Division of Imaging Science & Bio-medical Engineering,
8 Medical School, Stopford Building,
9 University of Manchester,
10 Oxford Rd., Manchester. MP13 9PT UK.
11
12 http://www.niac.man.ac.uk/Tina
13
14 ############################
15 1. TINA LIBRARY INSTALLATION
16 ############################
17
18 It is advised that you install TINA in its own directory such as /usr/local/Tina
19 once you unpack the tarfile you will have;
20
21 README : This file
22 GLPL.TXT : (old) The Gnu Library Public License
23 lesser.txt : The GNU Lesser General Public License
24 REGISTRATION.TXT : Registration form
25 src.tar : Library source
26 tinatool.tar : Example tool source
27 user.make : A prototype user.make file
28 sh.tina : Environment setup file for sh shell
29 csh.tina : Environment setup file for csh shell
30 utils.tar : Some (probably outdated) source viewing utilities
31
32 Now do the following;
33
34 1. untar the src.tar file with
35
36 'tar -xvf src.tar'
37
38 This will unpack all the source files into a directory called src.
39
40 2. in the src/ directory you will find a file called makeincludes.sh.
41 edit this file and ensure that the first line points to your sh or bash
42 shell.
43
44 execute this script with
45
46 './makeincludes.sh'
47
48 this will build an include/ directory at the same level as the src/ directory
49 3. edit the sh.tina (or csh.tina) to ensure that the variable TINA_BASE_DIR
50 points to the directory in which src/ and include/ are. i.e.
51
52 'export TINA_BASE_DIR=/usr/local/Tina' (sh)
53
54 'setenv TINA_BASE_DIR /usr/local/Tina' (csh)
55
56 4. ensure the following variables are set
57
58 XLIBS_LIBDIR /usr/X11R6/lib [or where X11 libs are]
59 XLIBS_INCLUDEDIR /usr/X11R6/include [or where X11 includes are]
60 TINA_X_GUI set to 0 (xview) or 1 (motif)
61
62 for xview you need to set
63
64 XVIEW_INCLUDEDIR location of xview includes
65 XVIEW_LIBDIR location of xview libs
66
67 or for Motif/Lesstif
68
69 MOTIF_INCLUDEDIR location of motif/lesstif includes
70 MOTIF_LIBDIR location of motif/lesstif libs
71
72 these may be set using 'export' (sh) or 'setenv' (csh) as before.
73 these should be set in your login files as they needed each time
74 you compile the libraries.
75
76 5. source or . the csh.tina or sh.tina file with
77
78 '. sh.tina' (sh)
79 'source csh.tina' (csh)
80
81 again this should happen everytime you compile TINA. Note that when you
82 run the sh.tina script you must be running bash version 2 or greater.
83 You will know if this is a problem by the errors!
84
85 6. alongside src/ and include/ create a new directory for the libraries. this
86 should be named as either
87
88 lib-linux : for libc.5 linux
89 lib-linux-glibc : for libc.6 (glibc) linux
90 lib-solaris : for solaris
91 lib-irix32 : for irix32
92
93 this is done thus for solaris
94
95 'mkdir lib-solaris'
96
97 NOTE: for other systems it is necessary to edit the sh.tina (or csh.tina)
98 file so as to set the correct environment variables.
99
100 7. move into the src/ area and commence the build with
101
102 './Build.sh'
103
104 this will compile the libraries into the appropriate lib-<arch>/ directory.
105
106 NOTE: if you need to change any of the compile options such as the compiler
107 name, these can be set in the user.make file which is read by all makefiles.
108
109 8. stand back and marvel at your work.
110
111 #########################
112 2. TINATOOL COMPILATION
113 #########################
114
115 1. with all the settings from the library compilation the example tinatool can
116 be build simply using;
117
118 'tar -xvf tinatool.tar'
119 'cd tinatool'
120 'make'
121
122 #########################
123 3. CONTACT / REGISTRATION
124 #########################
125
126 If you find TINA useful please let us know you are using it by completing the
127 registration information in the file TINA_REGISTRATION.TXT and emailing it to
128 a.lacey@server1.smb.man.ac.uk (include TINA_REGISTRATION in the mail subject
129 heading.)
130
131 That way you may be kept up to date with any bug fixes/improvements to TINA
132 which may happen in the future.
133
134
135 ###########
136 4. PROBLEMS
137 ###########
138
139 If you have a problem down-loading/compiling TINA contact:
140
141 email : a.lacey@man.ac.uk (including TINA_PROBLEM in the mail subject heading.)
142 We will attempt to deal with your problem, however no guarantees can be given!
143
144
145 #########
146 5. NOTICE
147 #########
148
149 The TINA Algorithm Development Libraries remain the intellectual property of the
150 University of Sheffield & University of Manchester, England.
151
152 This library is free software; you can redistribute it and/or modify it under
153 the terms of the GNU Library General Public License as published by the Free
154 Software Foundation version 2.
155
156 This library is distributed in the hope that it will be useful, but WITHOUT ANY
157 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
158 A PARTICULAR PURPOSE. See the GNU Library General Public License for more
159 details (see file GLPL.txt).
160
161 You should have received a copy of the GNU Library General Public License
162 along with this library; if not, write to the Free Software Foundation, Inc.,
163 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
164
165 _/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/
166
167 Dr. Tony Lacey (PhD) - Imaging Science & Bio-medical Engineering, University of
168 Manchester Stopford Building, Oxford Rd., Manchester. UK. M13 9PT
169 [+44 (0)161 275 7669] a.lacey@man.ac.uk <www.niac.man.ac.uk>
This page was automatically generated by the
LXR engine.
Visit the LXR main site for more
information.
