pynrrd
===========

pynrrd is a pure-Python module for reading and writing [nrrd][1] files into and 
from numpy arrays.

[1]: http://teem.sourceforge.net/nrrd/

Dependencies
------------

The module's only dependency is [numpy][2].

[2]: http://numpy.scipy.org/

Installation
------------

    python setup.py install

Example usage
-------------

    import numpy as np
	import nrrd

	# some sample numpy data
	data = np.zeros((5,4,3,2))
	filename = 'testdata.nrrd'

	# write to a nrrd file
	nrrd.write(filename, data)

	# read the data back from file
	readdata, options = nrrd.read(filename)
	print readdata.shape
	print options

Bugs and shortcomings
---------------------

Most of the [nrrd format specification][3] is implemented. Exceptions
are: 

-  files where encoding is 'txt', 'text', or 'ascii'
-  files where "data file" is "LIST"

Other shortcomings:

- More documentation is desirable, in particular for the options that
  can be passed to the write function.
- pynrrd is currently probably fairly forgiving in what it accepts for as
  nrrd files and could be made stricter.

[3]: http://teem.sourceforge.net/nrrd/format.html


License
-------

See LICENSE.