-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathREADME.txt
127 lines (104 loc) · 6.49 KB
/
README.txt
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
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
___ ____ __ __
/ __)( _ \( \/ )
\__ \ )___/ ) ( Statistical Parametric Mapping
(___/(__) (_/\/\_) SPM - http://www.fil.ion.ucl.ac.uk/spm
R E A D M E
________________________________________________________________________
This README gives a brief introduction to the installation and use of
the SPM package. Full details can be found on the SPMweb site:
http://www.fil.ion.ucl.ac.uk/spm
A manifest for this release is contained in the file Contents.m
The release is described in the file spm.man
________________________________________________________________________
SPM
Statistical Parametric Mapping refers to the construction and
assessment of spatially extended statistical process used to test
hypotheses about [neuro]imaging data from SPECT/PET & fMRI. These
ideas have been instantiated in software that is called SPM.
________________________________________________________________________
Installation
The SPM software is a suite of MATLAB functions, scripts and data
files, with some externally compiled C routines, implementing
Statistical Parametric Mapping. MATLAB, a commercial engineering
mathematics package, is required to use SPM. MATLAB is produced by The
MathWorks, Inc. Natick, MA, USA. http://www.mathworks.com/
eMail:[email protected]. SPM requires only core MATLAB to run (no
special toolboxes are required).
SPM99 is written for Matlab 5.2 under UNIX. (SPM will not work with
versions of Matlab 5 prior to 5.2, including Matlab 4.) Binaries of the
external C-mex routines are provided for Solaris, Linux and Windows
only, users of other UNIX platforms need an ANSI C compiler to compile
the supplied C source (Makefile provided: spm_MAKE). See
http://www.fil.ion.ucl.ac.uk/spm/distrib.html for details.
( Whilst the majority of the code is implemented as MatLab functions )
( & scripts containing standard MatLab commands, a number of features )
( specific to the UNIX version have been used. SPM also uses external )
( C programs, linked to MatLab as C-mex files, to perform some of the )
( more computationally intensive operations. Some of these latter C )
( programs use UNIX system calls to implement SPMs "memory mapping", )
( mapping disk resident image volumes into memory. (Specifically, the )
( calls are mmap (mman.h) in spm_map_vol.c; munmap (mman.h) in )
( spm_unmap_vol.c; & readdir (dirent.h) in spm_list_files.c. Not all )
( UNIX flavours support mman.h. )
With the compiled c-mex files in place, simply prepend the SPM
directory to your MatLab path to complete the installation. (Type `help
path` in matlab for information on the MatLab path.)
________________________________________________________________________
Getting started
SPM is invoked with the command `spm` at the MatLab prompt. We
recommend you start by reviewing the help system, by selecting "About
SPM" from the splash screen. This initially displays the "spm.man"
topic, detailing this release. Press the "Menu" button to display a
representation of the SPM menu window, with buttons linked to
appropriate help pages.
Before attempting to analyze data using SPM, we recommend you spend
some time reading. It is essential to understand the concepts of
Statistical Parametric Mapping in order to effectively use the software
as a research tool. You should begin with the SPMweb pages,
particularly the "Documentation" page. Of the resources listed there
perhaps the most useful starting point are the SPM course notes, which
explain the concepts and theories implemented in SPM at a lower level
than the articles in the peer reviewed literature. There is no manual.
Note that SPM uses Analyze format images as standard, although it can
also read MINC & ECAT-7 images. You will either need to convert your
image files to one of these formats (preferably Analyze), or construct
an additional module for the SPM memory mapping subsystem to read your
file format. Image conversion utilities for your image file format may
be available in other packages, or may have been specially written by
other SPM users. (Consult the SPM email discussion list, described
below, by first searching the archives, and posting a query if
necessary.) Unfortunately we have no resources to provide image
conversion software, although we will collaborate in developing SPM
memory mapping read-modules for popular image formats for inclusion in
SPM.
________________________________________________________________________
Resources
The SPMweb site is the central repository for SPM resources:
http://www.fil.ion.ucl.ac.uk/spm
Introductory material, installation details, documentation, course
details and patches are published on the site.
There is an SPM eMail discussion list, hosted at <[email protected]>.
The list is monitored by the authors, and discusses theoretical,
methodological and practical issues of Statistical Parametric Mapping
and SPM. Subscribe by sending the one line message: "join spm firstname
lastname" to <[email protected]>. (Users at NIH or UC-Davis
should join their local SPM feeds.) The SPMweb site has further
details:
http://www.fil.ion.ucl.ac.uk/spm/help
Please report bugs to the authors at <[email protected]>.
Peculiarities may actually be features, and should be raised on the SPM
eMail discussion list, <[email protected]>.
________________________________________________________________________
Disclaimer, copyright & licencing
SPM (being the collection of files given in the manifest in the
Contents.m file) is free but copyright software, distributed under the
terms of the GNU General Public Licence as published by the Free
Software Foundation (either version 2, as given in file spm_LICENCE.man, or
at your option, any later version). Further details on "copyleft" can
be found at http://www.gnu.org/copyleft/. In particular, SPM is
supplied as is. No formal support or maintenance is provided or
implied.
________________________________________________________________________
SPM is developed by members and collaborators of the
Wellcome Department of Cognitive Neurology
@(#)README.txt 2.5 00/01/25