Skip to main content

Common API for reading and writing soundfiles. * Uses installed packages if found (scikits.audiolab) * Implements reading uncompressed formats correctly in any format. * The data is independent of the encoding. All data is presented as float64 * Bitdepth is handled automatically depending on the the actual data

Project description

SNDFILE.IO

A simple module providing a unified API to read and write sound-files to and from numpy arrays. If no extra modules are installed, it uses only standard modules and numpy to read and write uncompressed formats (WAV, AIFF).

If other modules are installed (scikits.audiolab, for example), then they are used.

Even without third-party packages, it has certain advantages over the built-in modules wave and aifc

  • support for PCM16, PCM24, PCM32 and FLOAT32
  • unified output format, independent of encoding (always float64)
  • unified API for all backends

API

sndread

  • it will read ALL the samples and return a Sample (a tuplet data, samplerate)
  • Data will always be as a numpy.float64, between -1 and 1, independently of bit-rate

sndread_chunked

  • will read chunks of frames, avoiding the allocation of all the samples in memory

sndinfo

  • return SndInfo, a namedtuple with all the information of the sound-file

sndwrite

  • write the samples.
  • samples need to be a numpy.float64 array with data between -1 and 1

sndwrite_chunked

  • allows you to write to the file as samples become available

Dependencies

Mandatory:
  • numpy
Optional:
  • scikits.audiolab

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for sndfileio, version 0.7
Filename, size File type Python version Upload date Hashes
Filename, size sndfileio-0.7.macosx-10.6-intel.exe (74.3 kB) File type Windows Installer Python version any Upload date Hashes View
Filename, size sndfileio-0.7.tar.gz (10.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page