~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~ [ freetext search ] ~ [ file search ] ~

Linux Cross Reference
Tina4/README

Version: ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

  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> 

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~ [ freetext search ] ~ [ file search ] ~

This page was automatically generated by the LXR engine.
Visit the LXR main site for more information.