___  ____  __  __
 / __)(  _ \(  \/  )  
 \__ \ )___/ )    (   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 functional imaging data. These ideas have
   been instantiated in software that is called SPM.
   The SPM software package has been designed for the analysis of 
   brain imaging data sequences. The sequences can be a series of 
   images from different cohorts, or time-series from the same 
   subject. The current release is designed for the analysis of
   fMRI, PET, SPECT, EEG and MEG.

________________________________________________________________________
                                                            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).
 
SPM8 is written for MATLAB version 7.1 onwards under Windows and UNIX.
(SPM8 will not work with versions of MATLAB prior to 7.1 (R14SP3)).
Binaries of the external C-mex routines are provided for Windows, Linux 
and Mac. Users of other UNIX platforms need an ANSI C compiler to 
compile the supplied C source (Makefile provided). 
See http://www.fil.ion.ucl.ac.uk/spm/software/spm8/ for details.

Later versions of MATLAB (released after SPM8), will probably
need additional patches in order to run.  Once developed, these will 
be made available from:
     ftp://ftp.fil.ion.ucl.ac.uk/spm/spm8_updates/ 

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.

Note that SPM uses NIFTI-1 format images as standard.  See
http://nifti.nimh.nih.gov/dfwg/ for more information on this.

________________________________________________________________________
                                                               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. The SPMweb site has further details:
                 http://www.fil.ion.ucl.ac.uk/spm/support/

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 Trust Centre for Neuroimaging

$Id: README.txt 3028 2009-04-01 12:02:59Z guillaume $