FFT_tools: Catch RuntimeErrors when importing matplotlib

For example, if your default backend is GTKAgg, but you don't have
$DISPLAY set, you can get:

  RuntimeError: could not create GdkCursor object

doc:source:conf.py: move module mockups before FFT_tools import

Otherwise there's not much point ;).

README: link to HTML documentation on Read the Docs

doc:source:conf.py: import FFT-tools version number (vs. hardcoding it)

doc:source:conf.py: mock numpy module for read-the-docs

They don't have NumPy installed on their build server.

doc:source:conf.py: add base directory to system path for FFT_tools import

Bump to version 0.5.

Major changes since v0.4:

* TestCase-based testing (works with Nose)
* Better docstrings and Sphinx framework for building HTML docs

README: document nosetests invocation

README: document Sphinx build invocation

doc: add Sphinx framework for building docs

I can't get numpydoc working.  Enabling the module raises lots of
warnings:

  $ PYTHONPATH=.. make SPHINXBUILD=sphinx-build-2.7 dirhtml
  ...
  Traceback (most recent call last):tools
    File "/usr/lib/python2.7/site-packages/sphinx/ext/autodoc.py", line 321, in import_object
      __import__(self.modname)
  ImportError: No module named TestRFFT
  Traceback (most recent call last):
    File "/usr/lib/python2.7/site-packages/sphinx/ext/autodoc.py", line 321, in import_object
      __import__(self.modname)
  ImportError: No module named TestUnitaryRFFT

  /.../FFT-tools/doc/source/mod/FFT_tools.rst:64: WARNING: autodoc can't import/find exception 'FFT_tools.TestRFFT.failureException', it reported error: "No module named TestRFFT", please check your spelling and sys.path
  /.../FFT-tools/doc/source/mod/FFT_tools.rst:64: WARNING: failed to import object FFT_tools.TestRFFT.failureException
  /.../FFT-tools/doc/source/mod/FFT_tools.rst:64: WARNING: toctree references unknown document u'mod/FFT_tools.TestRFFT.addCleanup'
  ...
  None:None: WARNING: toctree contains reference to nonexisting document 'mod/FFT_tools.TestRFFT.addCleanup'
  ...
  <autosummary>:None: WARNING: toctree contains reference to nonexisting document 'mod/FFT_tools.TestRFFT.addCleanup'
  ...

FFT_tools: update docstrings for Sphinx 1.3

.gitignore: add setup.py build products MANIFEST and dist

FFT_tools: try to import pyplot up front

But if the import fails, don't raise the exception unless we actually
try to use pyplot.

FFT_tools: add docstring to TestRFFT.test_rfft

FFT_tools: add LOG and rework tests to use self.assert...().

Now you don't need to compare expected-vs-actual by hand.  The
troublesome

  self.run_sin(sin_freq=1, samp_freq=1024, samples=2048)

case is handled by explicitly making a very fuzzy comparison.

This gets rid of all the print() statements.

FFT_tools: remove redundant class names from TestCase methods

Merge changes from hooke.util.fft

I'd bundled FFT_tools into Hooke back in 2010, when I was optimistic
about getting my Hooke branch accepted upstream.  Now that that seems
less likely, I'm went to tear the module back out of Hooke, and I
noticed some useful restructuring.  Here it is, merged back into the
FFT-tools.

Changes:

* Fancy Sphinx/numpydoc-style docstrings
* unittest-based test suite.

Conflicts:
  FFT_tools.py

The bulk of the conflics were due to parallel style cleanups, and had
trivial fixes.  I also copied the test code relatively unchanged from
the FFT-tools branch into the Hooke unittest framework.  Here is the
mapping:

Old FFT-tools function                       New unittest method
-------------------------------------------  ---------------------------------------------------------------
_test_rfft                                   TestRFFT.run_rfft
_test_rfft_suite                             TestRFFT.test_rfft
_test_unitary_rfft_parsevals                 TestUnitaryRFFT.run_unitary_rfft_parsevals
_test_unitary_rfft_parsevals_suite           TestUnitaryRFFT.test_unitary_rfft_parsevals
_rect                                        TestUnitaryRFFT.rect
_test_unitary_rfft_rect                      TestUnitaryRFFT.run_unitary_rfft_rect
_test_unitary_rfft_rect_suite                TestUnitaryRFFT.test_unitary_rfft_rect
_gaussian                                    TestUnitaryRFFT.gaussian
_test_unitary_rfft_gaussian                  TestUnitaryRFFT.run_unitary_rfft_gaussian
_test_unitary_power_spectrum_sin             TestUnitaryPowerSpectrum.run_unitary_power_spectrum_sin
_test_unitary_power_spectrum_sin_suite       TestUnitaryPowerSpectrum.test_unitary_power_spectrum_sin
_test_unitary_power_spectrum_delta           TestUnitaryPowerSpectrum.run_unitary_power_spectrum_delta
_test_unitary_power_spectrum_delta_suite     TestUnitaryPowerSpectrum.test_unitary_power_spectrum_delta
_gaussian2                                   TestUnitaryPowerSpectrum.gaussian
_test_unitary_power_spectrum_gaussian        TestUnitaryPowerSpectrum.run_unitary_power_spectrum_gaussian
_test_unitary_power_spectrum_gaussian_suite  TestUnitaryPowerSpectrum.test_unitary_power_spectrum_gaussian
_test_unitary_avg_power_spectrum_sin         TestUnitaryAvgPowerSpectrum.run_unitary_avg_power_spectrum_sin
_test_unitary_avg_power_spectrum_sin_suite   TestUnitaryAvgPowerSpectrum.test_unitary_avg_power_spectrum_sin

Create extra block holding PowerSpectrumCommand output data

Add Numpy crossreferences to hooke.util.fft

Converted hooke.util.fft to Hooke coding style.

* Add numpydoc docstrings (to most functions)
* Converted hackish test suites to hackish `unittest.TestCase`s.
  Still ugly, but now `nosetests` finds them.
  They should really use .assertAlmostEqual and company...
* Added neccessary function definitions to doc/conf.py for the
  'math' sections of fft's docstrings.

README: use double backticks for filename markup (ReST)

Bump to version 0.4

Major changes since v0.3:

* Explicit floor division (PEP238)
* Python 3 compatible string formatting
* Cleaner module namespace
* Better PEP8 compliance

FFT_tools: add docstrings to separate function args and body

FFT_tools: add spaces after commas (PEP8) except tuple assignment

FFT_tools: add spaces around operators (PEP8) except **

FFT_tools: use // for explicit integer (floor) division (PEP238)

// has been supported since Python 2.2.  / changed to float division
in Python 3.

FFT_tools: two spaces before inline comments (PEP8)

FFT_tools: separate function defs with 2 blank lines (PEP8)

FFT_tools: wrap long function calls for PEP8 compliance

FFT_tools: wrap long comments for PEP8 compliance

FFT_tools: wrap long function definition lines for PEP 8 compliance

setup.py: update classifiers (Python and GPL versions, etc.)

README: remove author info (it's in setup.py)

setup.py: replace " = " with "=" for PEP 8 compliance

FFT_tools: replace " :" with ":" for PEP 8 compliance

FFT_tools: cleanup namespace by using _pyplot

FFT_tools: clean up namespace by using _numpy

FFT_tools: modernize module docstring

FFT_tools: bump copyright year

FFT-tools: modernize string formatting and exception handling

Changes:
* "print ..." -> "print(...)" (required for Python 3+)
* "'%s' % (...)" -> "'{}'.format(...)" for Python 2.7+
* prefer "raise ValueError(...)" to "assert ..."
* a few minor docstring cleanups for PEP 257 compliance

Bump to version 0.3.

Change email address to tremily and cleanup setup.py classifiers.

Update URLs from einstein to tremily.

Explicitly convert powers to reals (they should have no imaginary portion.)

Add .gitigore ignoring *.pyc files.

Fix doclines -> __doc__ in setup.py description.

Convert setup.py to plain distutils and general cleanups.

Moved from Python Software Foundation License to BSD License.

I didn't know what header to include in the code for the PSFL.

Added `dist' target to Makefile

Setup package for setuptools distribution.

Added some more Parseval's checks, but they failed.

TODO, figure out why and fix it, so I can uncomment the checks.

Got Parseval's checks working.

Began versioning