DOC: add tutorial on affines

Fairly in-depth tutorial about affine matrices and reference spaces.
DOC: expand and revise affine tutorial

Make explicit the components of the affine transform using the EPI
affine example.
BF: update matplotlib plot_directive with fixes

Add fixes from refactor of plot_directive
BF: fix coordinate_systems build with plot options

Missing plot_directive options in conf.py
increase sanity threshold for n_items per csa tag
DOC: add discussion of radiological / neurological

Also: clarify relationship of scanner-centric and subject-centric axis
arrangement.

Link to localizer image when mentioning same.
DOC: move neuro/radio discussion into own document

Maybe the discussion is a little specialized, so put it into a more
optional separate document.
adds tests for csareader.read nitems assertion
RF: slightly refactor csa tests; add test

Make error more explicit for too many items in the csa structure.

Add module global for max items and test
Merge pull request #1 from matthew-brett/refactor-csa-test

MRG: A little refactoring
Merge pull request #242 from kevlarkevin/increase_csa_nitems_assertion

MRG: increase sanity threshold for n_items per csa tag

Allow more items in csa tags.
DOC: remove refactoring old ideas, add to TODO
RF: replace get_affine() with affine property

We will soon deprecate the 'get_affine()' method on images; prepare for
that by removing all uses (but legacy testing) for 'get_affine()' on
images.
RF: change uses of get_header() to .header

We are going to deprecate the .get_header() method for images in favor
of the '.header' property.  Remove any uses of get_header() for
neatness.
BF(TST): Skip test_rst_table on python3.2 and numpy 1.6.1

Closes #246
BF(TST): test_arraywriters -- compare complex elements array element-by-element on a buggy system

Closes #244
Merge pull request #247 from yarikoptic/bf/test_arraywriters

BF(TST): test_arraywriters -- compare complex elements array element-by-element on a buggy system

also spotted some not-use of defined NP_VERSION so tuned up for that too ;)

Closes #244
Merge pull request #250 from yarikoptic/bf/test_rst_table

MRG: skip rst_tables test on Python 3.2

Edge cases when passing integers for formatting as floats.
Merge pull request #245 from matthew-brett/refactor-to-new-api

MRG: refactor to affine, header properties

Use .affine, .header properties instead of .get_affine(), .get_header()
methods.
Merge branch 'fixing-parrec' into main-master

* fixing-parrec: (21 commits)
  RF: rewrite parrec affine routine after testing
  NF: dot_reduce utility function
  RF: remove unused inport in funcs
  RF: refactor parrec affine, possibly breaks stuff
  DOC: fix tiny typo in docstring
  DOC: fix errors in top-level docstring
  TST: add regression tests for affine
  RF: remove use of deprecated read_img_data
  RF: error if trying to set par data offset !=0
  RF: avoid setting data offset of 0 if already set
  DOC: pep8 + expand / format docstrings for parrec
  BF: parrec2nii ignored FH image offset
  TST: Verify PARREC affines differ in the right places
  RF: python 3 fixes for openers test
  RF: some python 3 fixes for par / rec stuff
  RF: change slice orientation names for par/rec
  TST: add test of parrec2nii script
  RF+BF: refactor parrec to use latest nibabel
  NF: add skeleton for tests for PAR/REC conversion
  NF: add PAR / REC data for testing
  ...

Conflicts:
	COPYING