Metadata-Version: 2.1
Name: wavio
Version: 0.0.4
Summary: A Python module for reading and writing WAV files using numpy arrays.
Home-page: https://github.com/WarrenWeckesser/wavio
Author: Warren Weckesser
License: BSD
Keywords: wav numpy
Platform: UNKNOWN
Classifier: License :: OSI Approved :: BSD License
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6

wavio
=====

``wavio`` is a Python module that defines two functions:

* ``wavio.read`` reads a WAV file and returns an object that holds the sampling
  rate, sample width (in bytes), and a numpy array containing the data.
* ``wavio.write`` writes a numpy array to a WAV file, optionally using a
  specified sample width.

The module uses the ``wave`` module in Python's standard library, so it has the
same limitations as that module.  In particular, it does not support compressed
WAV files, and it does not handle floating point WAV files.  (When floating
point data is passed to ``wavio.write`` it is converted to integers before
being written to the WAV file.)  The functions can read and write 8-, 16-, 24-
and 32-bit integer WAV files.

``wavio`` has been tested with Python versions 2.7, 3.4, 3.5, 3.6 and 3.7.

``wavio`` depends on numpy (http://www.numpy.org).

The package has a suite of unit tests, but it should still be considered
prototype-quality software.  There may be backwards-incompatible API changes
between releases.

Example
~~~~~~~

The following code (also found in the docstring of ``wavio.write``) writes
a three second 440 Hz sine wave to a 24-bit WAV file::

    import numpy as np
    import wavio

    rate = 22050  # samples per second
    T = 3         # sample duration (seconds)
    f = 440.0     # sound frequency (Hz)
    t = np.linspace(0, T, T*rate, endpoint=False)
    x = np.sin(2*np.pi * f * t)
    wavio.write("sine24.wav", x, rate, sampwidth=3)


-----

:Author:     Warren Weckesser
:Repository: https://github.com/WarrenWeckesser/wavio
:License:    BSD 2-clause (http://opensource.org/licenses/BSD-2-Clause)


