Repository files navigation

Reading and writing image, sound and npz file formats to and from xtensor data structures.
Try it live in the browser!

xtensor-io offers an API to read and write various file formats intoxtensor data structures:

• images,
• audio files,
• NumPy's compressed storage format (NPZ),
• HDF5 files,
• Blosc.

xtensor-io wraps theOpenImageIO,libsndfile,zlib,HighFive, andblosc libraries.

xtensor-io is a header-only library. We provide a package for the mamba (or conda) package manager.

mamba install xtensor-io -c conda-forge

• xtensor-io depends onxtensor^0.25.0.

• OpenImageIO,libsndfile,zlib,HighFive, andblosc are optional dependencies toxtensor-io

  • OpenImageIO is required to read and write image files.
  • libsndfile is required to read and write sound files.
  • zlib is required to load NPZ files.
  • HighFive (and theHDF5 library) is required to read and write HDF5 files.
  • blosc is required to read and write Blosc files.

All five libraries are available for the conda package manager.

You can also installxtensor-io from source:

mkdir buildcd buildcmake ..makesudo make install

To try out xtensor-io interactively in your web browser, just click on the binderlink:

To get started with usingxtensor-io, check out the full documentation

http://xtensor-io.readthedocs.io/

// loads png image into xarray with shape HEIGHT x WIDTH x CHANNELSauto img_arr = xt::load_image("test.png");// write xarray out to JPEG imagext::dump_image("dumptest.jpg", img_arr +5);// load npz file containing multiple arraysauto npy_map = xt::load_npz("test.npz");auto arr_0 = npy_map["arr_0"].cast<double>();auto arr_1 = npy_map["arr_1"].cast<unsignedlong>();// open a wav fileauto audio = xt::load_audio("files/xtensor.wav");auto& audio_arr = std::get<1>(audio);// audio contents (like scipy.io.wavfile results)// save a sine wave soundint freq =2000;int sampling_freq =44100;double duration =1.0;auto t = xt::arange(0.0, duration,1.0 / sampling_freq);auto y = xt::sin(2.0 * xt::numeric_constants<double>::PI * freq * t);xt::dump_audio("files/sine.wav", y, sampling_freq);

We use a shared copyright model that enables all contributors to maintain thecopyright on their contributions.

This software is licensed under the BSD-3-Clause license. See theLICENSE file for details.