-
Notifications
You must be signed in to change notification settings - Fork 8
/
CoreLib.dox
83 lines (76 loc) · 4.23 KB
/
CoreLib.dox
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
/*!
* \mainpage Woolz Core Libraries
* \section intro Introduction
The core woolz image processing library, \ref libwlzpage "libWlz",
was developed for
the purpose of microscope slide scanning. libWlz holds the basic image processing
functionality, supplementary libraries provide functionality for memory allocation
and management, numerical algorithms, external format conversion and other
commonly used programmatic tools. These are:
\li \ref libalcpage "libAlc" - memory allocation and management
\li \ref libalgpage "libAlg" - numerical algorithms
\li \ref libwlzextpage "libWlzExt" - image format conversion and meta-data IO
\li \ref libbibfilepage "libbibfile" - IO if "bibtex" format data - standard
plain-text meta-data
\li \ref libdlplistpage "libDlpList"- linked-list structures and
procedures for management, sorting and query.
The original woolz software set included libraries for classification and
chromosome analysis, these are not included in this package. All libraries
are developed in ANSI Standard C and have been successfully used on any
Unix system tried so far including Solaris, Linux, IRIX, HPUX, MacOSX.
It is also availbale under Windows either using Cygwin or directly using
the Microsoft C++ compiler. In addition there is a Java mapping available
for the woolz library to allow image process from Java code.
\section Structure Overview
Woolz has been generated over many years at the Medical Research Council
Human Genetics Unit in Edinburgh. The basic image processing library
originally developed has been extended to include a range of numerical
algorithms and libraries for standard programming tasks. The code has been
converted to ANSI standard C and standardised with respect to nameing
conventions and error reporting. Finally the code has been checked for
memory errors such array bound exceptions and leaked bytes. The code is
maintained by a number of developers at the MRC and version control is
under CVS. The code is open-source and freely available for academic
non-profit use. For commercial use of the software please contact
matech@hgu.mrc.ac.uk.
The libraries are organised to hierarchically and need to be linked
accordingly. The dependencies are:
\li libAlc - none, system library libc
\li libAlg - libAlc, system library libm
\li libbibfile - libAlc
\li libhguDlpList - libAlc
\li libWlz - libAlg
\li libWlzExtFF - libWlz, libbibfile, external libraries libtiff and libjpeg
\section install Usage
\section install Installation
The source code and/or compiled versions of the libraries can be
downloaded from the Mouse Atlas Web site
(http://www.emouseatlas.org/emap/analysis_tools_resources/software.html).
The installation instructions
are provided as a "readme.txt" which requires the selection of a path
(e.g. /opt/MouseAtlas) as the root of all Mouse Atlas software. The code
is then installed in standard Unix fashion in src, share, lib, bin and
so on. If the default path for the woolz root directory is used then the
software should build and run without modification.
\section history Software Development History
The woolz software libraries have grown over many years for many image
processing purposes since the 1970s. The initial development by
Dr Denis Rutovitz was in Fortran and defined a number of the key
woolz structures, primarily the interval coding of the spatial domains
and grey-level values. The current C-coding was initiated in the 1980s,
primarily by Dr Jim Piper. The coding has been transformed to its present
form in a number of stteps as part of early Alvey and Eu funded projects
and more recently as part of the Mouse Atlas porject at the HGU. This
has include a large expansion in some of the grey-level image extgensions
to the library.
The current software is primarily maintained by Richard Baldock and
Bill Hill at the MRC Human Genetics Unit. The sofware is now maintained
and extended by a group of programmers at the MRC and is managed using
the Concurrent Versioning System (CVS). A full development history of each
module is available from the archive. The preceding development is either
in the source comments or held in a History file generated during the
transition form the original C to ANSI standard with standardisation
of naming and error reporting.
\section pubs Publications
*
*/