Report No. 91 XITE System Administrator`s Manual
Contents
1. 3 Customizing the installation 5 31 1 Setup of ser accounts on uca RC A RS Ee a a 4 5 3 11 O UNIK platforms sc aaa ee sa 5 3 1 2 On Windows NT 95 i vare ia de a 5 3 2 Building a manual page database o rv ren ra 5 3 21 On UNIX platforms 0 2 0 0 0 kran 5 3 22 On Windows NT 95 2 o 6 3 3 X app defaults resource filles o rn rak 6 3 4 WWW browser as xshow help program on UNIX platforms 6 3 5 Customization of the xshow menu tree arr rv rekken ra 6 3 6 Compilation of XITE dependent software rn rn ra 7 4 Miscellaneous 8 4 1 Bug Peports o oo he GE Lu FE ee en 8 42 Registration ss d ser gs ar eaten Aah ye pa de ae Ae Oe dee Pe BN hey dei de frasi coto 8 4 3 Copyright 5 Lo Lo A gidd kue SPRENGE ee Pk re SG Sr die 8 did Marling list Ar sara le At ha Gel eder Ak TTS TESS e A 8 4 5 WWW home page for XITE o o a 8 4 6 How to contribute to XITE e 8 A Details on the installation procedure 10 A 1 XITE home directory 10 A 2 Unpacking building and installing 10 A 2 1 What you need before unpacking e e 10 A 2 2 Unpacking ed 44 4 ee ie a AA ith ln ee he E 4 11 A233 Checking for erroris e uA e aao a ee me e Reals le eA 12 A 2 4 Rebuilding of parts which failed oo o 12 A 3 Building XITE on a different platform 2 2 0 0 0 0 00002. grab the files with ftp from ftp ifi uio no in the directory pub blab xite Move the above files into XITE_HOME and change to that directory cd XITE_HOME Do not unpack the tar file manually A 2 2 Unpacking The script install_xite will unpack build and install XITE To get a list of the various options supported by this script give the command 8 sh install_xite h Note in particular the options d f and o You may be using these options if you choose to install XITE for multiple computer architectures The easiest way to unpack build and install XITE is to simply issue the command 8 sh install_xite and give the information requested by the script as it runs Be prepared to supply the following e Directory for storage of XITE C header files e Directory for storage of XITE object libraries Directory for storage of XITE executables Directory for storage of XITE manual pages Directory for storage of XITE hypertext documentation The default values suggested by the installation script for the above are all below the XITE home directory For the sake of the display programs in XITE the following information is also needed e Location of header files for the X Window System e Location of object libraries for the X Window System Depending on whether you have MATLAB the libtiff TIFF object library or the Netpbm con version utilities installed on your system you may also want to supply the location of e libtif
3. nnestad and Otto Milvang XITE X based Image Processing Tools and Environment User s Manual for version 3 41 Report 56 Image Processing Laboratory Department of Informatics University of Oslo P O Box 1080 Blindern 0316 Oslo Norway September 1998 http www ifi uio no blab Software Xite UsersManual 3 Tor L nnestad and Otto Milvang XITE X based Image Processing Tools and Environment pages 63 88 World Scientific Singapore 1994 ISBN 981 02 1510 X 4 Otto Milvang and Tor L nnestad An image widget for image processing The X Journal 1 2 November December 1991 5 Otto Milvang and Tor L nnestad An object oriented image display system In Proceed ings 11th International Conference on Pattern Recognition pages D218 221 The Hague The Netherlands August September 1992 78 79 80 81 82 83 84 85 86 87 88 89 90 REPORTS FROM THE IMAGE PROCESSING LABORATORY Maurycy Szmurlo A comparative study of statistically classifiable features used within the area of Optical Character Recognition Cand Scient Master thesis May 1995 Ingvil Hovig Verkt y og metoder for komprimering av MR bilder Dr Scient Ph D thesis August 1995 yvind Akerhaugen Automatisk plassering av navn p kart ved hjelp av simulated annealing Cand Scient Master thesis February 1996 Marius Midtvik Reversibel komprimering av MR bilder basert p statisk kildemodell
4. on a different platform 13 1 Edit the script XITE HOME etc install testPlatform to allow this extra platform 2 Among the platforms mentioned in the testPlatform script decide which one is closer to the new platform Check to see whether there is a corresponding Makefile or Makefile template extension tmpl in XITE_HOME etc If you can t find one generate it with the command XITE_HOME etc install makeMakefile p lt platform name gt Make a copy with filename extension equal to the new platform name 3 Incorporate any necessary changes in the Makefile particularly to CFLAGS possibly also to LFLAGS and CC 4 Check the files includes h and xite_ h in the XITE header file directory to see that the appropriate header files will be included with the particular platform You may need to add extra ifdef directives to treat your platform appropriately 5 Use the command sh install_xite d or 8 sh install_xite d p 6 Send an email to blab ifi uio no describing this new platform and any changes or additions you made to XITE in order to make it run 14 References References 1 Svein B e XITE X based Image Processing Tools and Environment Programmer s Manual for version 3 4 Report 92 Image Processing Laboratory Department of Infor matics University of Oslo P O Box 1080 Blindern 0316 Oslo Norway June 1998 http www ifi uio no blab Software Xite ProgrammersManual 2 Svein B e Tor L
5. to check out the p and loc options If you need more information on this please refer to appendix A 3 2 2 On Windows NT 95 There are two possible ways to install XITE on a Windows NT 95 host If your NT 95 system has access to a UNIX file system where XITE is installed e g via Samba you can start from this UNIX installation and leave the libraries and executables on the UNIX file system The other possibility is to start from the special prebuilt XITE distribution for Windows NT 95 2 2 1 Starting from a UNIX distribution On a UNIX host run the command 8 sh install xite d p NT4 This will create makefiles for NT 95 and the necessary folders for libraries and executables On your Windows NT 95 host if Microsoft Visual C is installed on your system open a Command Prompt window go to the XITE source directory and issue the commands 4 Installing XITE 8 set XITE_HOME full_path_of_XITE_folder 8 nmake r f Makefile NT4 XITE HOME XITE HOME 2 2 2 Using the prebuilt distribution for NT 95 Go through the following steps 1 Create a folder for XITE 2 Move the file xite zip into the XITE folder 3 Unzip the file xite zip 4 If the Microsoft Visual C dynamic link runtime library msvert d11 is not already installed on your system get the file from the XITE ftp directory and copy it to the bin directory which was created when xite zip was unzipped 3 Customizing the installation After having installed XITE successful
6. using dynamic link libraries DLLs 1 2 Root administrator privileges Depending on how you choose to install XITE you may need root administrator privileges for the following e Creation of XITE home directory e Creation of directories for XITE C header files libraries executables man pages hypertext reference manual and other documentation 2 Introduction 1 3 What you need besides XITE If you want to be able to convert images between the XITE file format BIFF Blab Image File Format and other popular formats such as TIFF pnm pbm pgm ppm and MATLAB s MAT files you will need the libtiff TIFF library Netpbm or Pbmplus and MATLAB To build the TIFF to BIFF converters you need an ANSI C compiler such as gcc The XITE display programs need the X Window System Version 11 release 5 or 6 a Pseudo Color 8 plane preferrably or 24 plane DirectColor display It should also work with a TrueColor 24 plane display although the colortables can not be manipulated on such a display Modern workstations often offer all these color modes in a single display 1 4 About this report This report describes how to e build the object libraries and executables e build hypertext and man page documentation e hook a WWW browser to the Help button in the main display program e prepare user accounts for access to XITE Refer your XITE users to the User s Manual 2 for information on how to use XITE The Pro grammer s Manual 1 de
7. 0 even 12 References 14 ill 1 Introduction XITE pronounced excite is an acronym for X based Image processing Tools and Environment The non display programs run under UNIX System V as well as BSD versions Windows NT and Windows 95 The display programs are based on the X Window System Version 11 currently using release 5 or 6 operating in a UNIX environment XITE is at least being used on the following platforms e Windows NT 4 0 and Windows 95 e Sun spare SunOS 4 1 3 Ul and Solaris 2 5 Silicon Graphics IRIX 5 3 e DEC alpha OSF1 V4 0 e Linux e IBM RS 6000 AIX e DECstation ULTRIX 4 4 The XITE distribution consists of C source code documentation some images and colortables and installation scripts During the installation procedure the XITE administrator may choose where to locate object libraries executables manual pages and other documentation 1 1 Required disk space Estimated disk space requirements Source code 16 Mb Manual pages 3 5 Mb Hypertext doc 2 Mb Scripts images etc 4 Mb Libraries and executables 4 76 Mb The space required for the libraries and executables is strongly dependent on computer architec ture For Linux with dynamic shared libraries only 6 Mb is needed whereas for ULTRIX with static libraries 76 Mb is needed For Windows NT 95 without the display programs about 17 Mb is needed when using static libraries and only about 2 5 Mb is needed when
8. 4 1 on how to send a bug report A 2 4 Rebuilding of parts which failed If the building of XITE libraries or executables failed you may try to rebuild the system using a different compiler different compiler options or change other information which was acquired during the unpacking phase Rebuilding of XITE can be done without unpacking the distribution once again Go through the following steps e From the log file try to locate what part of the build process failed In which source directory did it occur Did the compilation of library functions fail or compilation of executables Or perhaps there was an error during the linking phase e Do you think that it would help making changes to the Makefile for the particular archi tecture you are installing on You will find the corresponding makefile in XITE_HOME etc with an appropriate filename extension Perhaps you need to change the CFLAGS variable options given to the compiler or perhaps you want to use a different compiler the CC variable e Rebuild the parts of the system which failed by using the script XITE_HOME etc makexite Give the option h to get help on how to use this script A 3 Building XITE on a different platform If you ran into problems when following the instructions in section 2 1 1 read this section If the new platform is unknown to XITE install xite does not accept the name of your desired platform go through the following steps A 3 Building XITE
9. Image Processing Laboratory Department of Informatics University of Oslo Report No 91 XITE X based Image Processing Tools and Environment System Administrator s Manual For version 3 41 Svein B e September 1998 Bildebehandlingslaboratoriet Institutt for informatikk Universitetet i Oslo Image oe Laboratory Department of Informatics University of Oslo Tittel Title XITE System Administrator s Manual Forfatter e Author s Svein B e Rapport nr Report no 91 ISBN 82 7476 061 1 Dato Date June 1998 Resym Abstract XITE consists of display programs with image widget and graphical user interface as well as more than 200 command line programs and 600 sub routines for image processing all documented on line The command line programs and subroutine library are written in C and run under UNIX Windows NT and Windows 95 The display programs run under UNIX They work with images of arbitrary size and pixel type on 8 bit PseudoColor and 24 bit DirectColor and TrueColor X11 displays Images can be zoomed and panned and colortables can be selected from a menu The main display program xshow gives access to most of the other command line programs via a menu interface which the user can customize and extend to include local programs Input images for the menu entries can be selected with the mouse and output images appear on the display This report describes how to install XITE and how to prep
10. andard location You should remove those files See documentation on the X Window System for more information about the above environment variables 3 4 WWW browser as xshow help program on UNIX platforms xshow tries to load an external helper application when the Help button in the Control window is pushed The default behaviour is to start the WWW browser netscape pointing to the XITE Reference Manual which was built during the installation procedure If netscape is not available xshow will usually try to launch another program The exact behaviour is determined by the X ap plication resources xiteHelper and xiteHelperOption or the environment variables XITE HELPER and XITE_HELPER_OPTION If you want to customize the behaviour refer to XITE User s Manual 2 or the manual page for xshow 3 5 Customization of the xshow menu tree The main display program xshow can launch most of the other programs supplied with XITE This is done via a menu hierarchy which is defined in an ascii menu file One of the entries in the main menu is Site specific programs If you want all your users to get access to locally developed programs which operate on images in the XITE file format BIFF these programs may appear in a submenu tree below this entry 5 possibly also XUSERFILESEARCHPATH 6 usr lib X11 app defaults or usr openwin lib app defaults under the Sun Solaris operating system 3 6 Compilation of XITE dependent software 7 For informa
11. are a user account for the software Norske emneord Indexing terms Norwegian Engelske emneord Indexing terms English Bildebehandling Image Processing Bildebegrep Image Concept Bildeprogram Display Program Vindussystemet X X Window System Farger Colors UNIX UNIX C C Windows NT Windows NT Adresse Address Bildebehandlingslaboratoriet Institutt for informatikk Universitetet i Oslo Boks 1080 Blindern 0316 Oslo epost blabQifi uio no tlf 22 85 24 10 Image Processing Laboratory Department of Informatics University of Oslo P O Box 1080 Blindern N 0316 Oslo NORWAY email blab ifi uio no phone 47 22 85 24 10 XITE X based Image processing Tools and Environment System Administrator s Manual For version 3 41 Image Processing Laboratory Department of Informatics University of Oslo Svein B e September 1998 Contents 1 Introduction 1 1 1 Required disk space 0 ee 1 1 2 Root administrator privileges 2 verv ee 1 1 3 What you need besides XITE 0 0 000 0000 ee eee 2 14 About this report x usar oo ears Ae Ee eee OE Ad Bee 5 2 2 Installing XITE 3 2 1 On UNIX platforms 44 va h bie SE SE Ge ek ERS gd HERS 3 2 1 1 Installing XITE for multiple architectures o 3 2 2 On Windows NT 95 krrra 3 2 2 1 Starting from a UNIX distribution o o 3 2 2 2 Using the prebuilt distribution for NT 95 o o o ooo 4
12. e is required for the XITE program option whatis to work 3 2 1 On UNIX platforms On a UNIX system the whatis program and man with certain options also need the manual page database The XITE manual pages have been installed in a directory which you chose during the unpacking procedure On a UNIX system you should probably go to this directory and build a whatis or windex database for the man pages This will enable keyword search with man to work On my local systems I use one of the two commands for YXITE HOME man in Windows NT 95 notation 6 Customizing the installation makewhatis XITE_HOME man catman M XITE_HOME man This may be different on your system 3 2 2 On Windows NT 95 A windex database and preformatted man pages are supplied with the prebuilt NT 95 distribution 3 3 X app defaults resource files This section applies only to platforms with the X Window System installed The XITE display programs will not work properly without the app defaults files which are found in the directory XITE_HOME etc app defaults A warning will be printed if the display programs can t find these files Each display program sets the environment variable XAPPLRESDIR so that the app defaults files can be found by the X Window System The files are not installed into the standard location If you already have a previous version of XITE it may be that the resource files for the previous version were installed in the st
13. ering Cand Scient Master thesis May 1996 Tor yvind Didriksen Linjefinning og klassifikasjon med Random Hough transform en eksperimentell studie Cand Scient Master thesis June 1996 Edward Allen Smith Image Processing Techniques on DNA Fingerprint Images and its Application to Genetic Similarity Analysis Cand Scient Master thesis August 1996 Parviz Heydari Line Following in Digitized Map Cand Scient Master thesis November 1996 Ramin Gordjianfar Vectorization of the Cartographic Data Cand Scient Master thesis November 1996 Luren Yang and Torfinn Taxt Robust Methods for Sonar Bottom Detection February 1997 Christian Wladimir Hansson Strukturgrammatikk en h yeredimensjonal grammatikk for syntaktisk m nstergjenkjenning av 3D objekter i bilder Cand Scient Master thesis December 1996 Sverre H Huseby Video on the World Wide Web Accessing Video from WWW Browsers Cand Scient Master thesis February 1997 Havard Lauritzen Raster til vektor konvertering ved simulert st rkning Cand Scient Master thesis May 1997 Irene R dsten Texture Segmnetation using Moment based Features obtained by Locally Adaptive Thresholding Cand Scient Master thesis May 1997
14. f TIFF header files e libtiff TIFF object library e pnm header files e pnm object libraries MATLAB header files 12 Details on the installation procedure e MATLAB object libraries e MATLAB mex files for storage At some point during the installation procedure you will be asked whether you want to continue building the library executables and documentation This means that unpacking of the XITE dis tribution has been completed What remains is the actual compilation linking and documentation production This is handled by a separate script makexite which is located in XITE_HOME etc If the installation so far has gone by without problems just type y in response to this question and makexite will be started automatically A 2 3 Checking for errors All of the compilation errors and warnings found while the makexite script is run will be stored in a file with filename starting with the string xite_log and with filename extension given by the computer architecture you are installing XITE on You should check this file when the installation is finished looking especially for error messages A quick way of doing this is with a command such as grep i error xite_log IRIX grep v ignored if you are installing XITE on a computer running the IRIX operating system This will tell you whether any errors were found Search through the file to see what the errors were before sending a bug report to the XITE developers see section
15. home directory This can be chosen during the installation procedure Set the environment variable XITE_HOME equal to the chosen XITE home directory On a UNIX system if you are using the csh or tcsh shell this can be done with the command setenv XITE_HOME usr local xite if you chose usr local xite as the XITE home directory If you are using an sh compatible shell e g bash use the command XITE_HOME usr local xite export XITE_HOME Throughout this document the string XITE_HOME represents the chosen XITE home directory Before unpacking building and installing XITE the home directory must be created If you have chosen usr local xite as the XITE home directory issue the commands cd usr local mkdir xite You will probably need root privileges to be allowed to create the directory You could of course alternatively have chosen to install XITE below your own home directory in which case you would not need any special privileges at this stage A 2 Unpacking building and installing A 2 1 What you need before unpacking Before you start to build and install XITE make sure that you have everything you need You should have the following files e install xite e One of xite tar gz xite tar Z xite tar If you lack any of these files you will find them with a WWW browser pointed to XITE s home page at http www ifi uio no blab Software Xite A 2 Unpacking building and installing 11 You can also
16. ly there are a few remaining steps which you need to go through manually in order to make XITE operate at its best 3 1 Setup of user accounts 3 1 1 On UNIX platforms The installation procedure also produced setup files for XITE users The easiest way for a UNIX user to get access to XITE is to invoke XITE setup files from the initialization files of the login shell If the login shell is csh compatible include the following line in the user s cshrc file source XITE HOME etc xite cshrc where XITE HOME is replaced by the actual XITE home directory If the login shell is sh compatible e g bash include the following line in the user s profile file XITE HOME etc xite profile As the XITE administrator you should check that the files xite cshrc and xite profile reflect the choices made during installation 3 1 2 On Windows NT 95 The PATH environment variable must be modified so that XITE programs can be started from the NT 95 command window Add the name of the folder in which the XITE executable programs reside to this environment variable The folder name is probably bin or bin NT4 below the XITE home directory The environment variable XITE MAN should be set to refer to the folder in which the program manual files reside On a default installation this will be XITE_HOME man The environment variable is required for the man and whatis program options to work 3 2 Building a manual page database manual page databas
17. scribes how to write XITE dependent functions and programs including the use of the X based toolkit ximage ximage is a part of XITE XITE has also been described in 3 4 5 lftp sgi com graphics tiff http wuarchive wustl edu graphics graphics packages NetPBM Shttp www mathworks com 2 Installing XITE 2 1 On UNIX platforms Go through the following three steps in order to install XITE 1 Create an XITE home directory and set the environment variable XITE_HOME to reflect your choice If you need more information about this please refer to appendix A 1 2 Move the script install_xite and the file xite tar gz or xite tar Z or xite tar into the XITE home directory 3 From the XITE home directory issue the command where represents the shell prompt 8 sh install_xite If you need more information about the install script and how to check for installation errors please refer to appendix A 2 2 1 1 Installing XITE for multiple architectures If you decide to make a complete XITE installation on a different platform then rerun the script install_xite as explained in section 2 If you simply want to install binary executables object libraries and possibly include files manual pages and hypertext documentation for a different platform in the same networked file system while not duplicating the source files and scripts there is no need to unpack XITE again Instead use the command 8 sh install_xite d You may want
18. t notice You ll find a copy of this in the file XITE HOME etc install COPYRIGHT 4 4 Mailing list An international mailing list exists for discussions about XITE If you would like to subscribe to this list send a mail to xite request ifi uio no The list name is xite ifi uio no 4 5 WWW home page for XITE If you have a World Wide Web browser such as Mosaic netscape or lynx you may find more information about XITE in its home page with URL http www ifi uio no blab Software Xite 4 6 How to contribute to XITE If any of your users writes software which she would like to contribute to XITE refer her to the Programmer s manual 1 supplied with the XITE distribution Please email blabGifi uio no if further instructions are needed 4 6 How to contribute to XITE 9 If anyone at your site makes changes or fixes bugs please let us know Refer to section 4 1 for details on sending a bugreport 10 Details on the installation procedure A Details on the installation procedure If you ran into problems during the UNIX platform installation procedure which was briefly outlined in section 2 you may find help here A 1 XITE home directory All the C source code and installation scripts will be placed below the XITE home directory Typical locations on a UNIX platform are usr local xite usr lib xite or the user xite The object library executables manual pages and other documentation do not need to reside below the XITE
19. tion on how to add local programs to the menu hierarchy refer to the manual page for xshow 3 6 Compilation of XITE dependent software A script cxite is supplied for compilation and linking of new programs which use XITE routines It was installed in the XITE executable directory you chose during installation On UNIX platforms the script was automatically edited by the install script It should be able to supply the necessary options to find XITE header files the XITE library as well as other required header files and libraries The command 8 cxite help will give more information about this script cxite is not available under Windows NT 95 8 Miscellaneous 4 Miscellaneous 4 1 Bug reports If or when you encounter bugs whether during installation or execution please send bug reports to the XITE developers You ll find a bug report template in the file XITE_HOME etc install bugReport Mail the bug report to xite bugsGifi uio no 4 2 Registration If you install and use XITE please let us know by filling in the registration form in the file XITE HOME etc install REGISTER Mail it to xite register ifi uio no This will help us get a general idea of what people find useful what platforms XITE is most widely used on and whether the users are in universities research institutions etc The use of XITE is free but we would be happy to know that you find it useful 4 3 Copyright XITE comes with a mild copyrigh
Download Pdf Manuals
Related Search