Input/Output routines for reading images, audio, and NumPy npz files for the xtensor C++ multi-dimensional array library.

Introduction

xtensor-io offers bindings to popular open source libraries for reading and writing

• Images with OpenImageIO (many supported formats, among others: jpg, png, gif, tiff, bmp …)

• Sound files with libsndfile (supports wav, ogg files)

• NumPy compressed file format (npz). Note: support for uncompressed NumPy files (npy) is available in core xtensor.

• Geospatial rasters with GDAL (many supported formats)

Enabling xtensor-io in your C++ libraries

xtensor and xtensor-io require a modern C++ compiler supporting C++14. The following C++ compilers are supported:

• On Windows platforms, Visual C++ 2015 Update 2, or more recent

• On Unix platforms, gcc 4.9 or a recent version of Clang

Licensing

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

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

INSTALLATION

• Installation
  • Using the conda package
  • From source with cmake

USAGE

• Basic Usage
  • Example : Reading images, audio and NPZ files
  • Example : Reading and writing HDF5 files
  • Example : Reading and writing a file with GDAL
• HDF5 interface
  • Basic interface
  • Advanced interface
  • Compiling & dependencies
• Stored Arrays
  • File arrays
  • Chunked File Arrays

API REFERENCE

• API Reference
  • NPZ files
  • Images
  • Audio files
  • HDF5 files
  • GDAL files
  • xfile_array
  • xchunk_store_manager
  • chunked_file_array

DEVELOPER ZONE

• Releasing xtensor-io
  • Releasing a new version
  • Updating the conda-forge recipe
  • Updating the stable branch