Metadata-Version: 1.1
Name: samplerate
Version: 0.1.0
Summary: Python bindings for libsamplerate based on CFFI and NumPy
Home-page: https://github.com/tuxu/python-samplerate
Author: Tino Wagner
Author-email: ich@tinowagner.com
License: MIT
Description: python-samplerate
        =================
        
        This is a wrapper around Erik de Castro Lopo's `libsamplerate`_ (aka Secret
        Rabbit Code) for high-quality sample rate conversion.
        
        It implements all three `APIs
        <http://www.mega-nerd.com/libsamplerate/api.html>`_ available in
        `libsamplerate`_:
        
        * **Simple API**: for resampling a large chunk of data with a single library
          call
        * **Full API**: for obtaining the resampled signal from successive chunks of
          data
        * **Callback API**: like Full API, but input samples are provided by a callback
          function
        
        Library calls to `libsamplerate`_ are performed using `CFFI
        <http://cffi.readthedocs.io/en/latest/>`_.
        
        
        Installation
        ------------
        
            $ pip install samplerate
        
        Binaries of `libsamplerate`_ for macOS and Windows (32 and 64 bit) are included
        and used if not present on the system.
        
        
        Usage
        -----
        
        .. code-block:: python
        
           import numpy as np
           import samplerate
        
           # Synthesize data
           fs = 1000.
           t = np.arange(fs * 2) / fs
           input_data = np.sin(2 * np.pi * 5 * t)
        
           # Simple API
           ratio = 1.5
           converter = 'sinc_best'  # or 'sinc_fastest', ...
           output_data_simple = samplerate.resample(input_data, ratio, converter)
        
           # Full API
           resampler = samplerate.Resampler(converter, channels=1)
           output_data_full = resampler.process(input_data, ratio, end_of_input=True)
        
           # The result is the same for both APIs.
           assert np.allclose(output_data_simple, output_data_full)
        
           # See `samplerate.CallbackResampler` for the Callback API, or
           # `examples/play_modulation.py` for an example.
        
        See ``samplerate.resample``, ``samplerate.Resampler``, and
        ``samplerate.CallbackResampler`` in the API documentation for details.
        
        
        See also
        --------
        
        * `scikits.samplerate <https://pypi.python.org/pypi/scikits.samplerate>`_
          implements only the Simple API and uses `Cython <http://cython.org/>`_ for
          extern calls. The `resample` function of `scikits.samplerate` and this package
          share the same function signature for compatiblity.
        
        * `resampy <https://github.com/bmcfee/resampy>`_: sample rate conversion in
          Python + Cython.
        
        
        License
        -------
        
        This project is licensed under the `MIT license
        <https://opensource.org/licenses/MIT>`_.
        
        As of version 0.1.9, `libsamplerate`_ is licensed under the `2-clause BSD
        license <https://opensource.org/licenses/BSD-2-Clause>`_.
        
        
        .. _libsamplerate: http://www.mega-nerd.com/libsamplerate/
        
Keywords: samplerate converter signal processing audio
Platform: any
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Multimedia :: Sound/Audio
