NAME

       ambix-interleave - AMBIsonics eXchange utility

SYNOPSIS

       ambix-interleave -o outfile [options] infile1...

DESCRIPTION

       Merges several audio files into an ambix file

OPTIONS

       -h, --help
              print this help

       -o, --output
              output filename

       -O, --order
              force ambisonics order (default: autodetect)

       -X, --matrix
              specify adaptor matrix file or a predefined matrix ('FuMa', 'n3d|sid', 'n3d' or 'sid')

       -b, --blocksize
              blocksize for copying (default: 1024)

       In it's simplest form, you pass it a number of input files, the accumulated channels of which form a full
       3d ambisonics set (channel #0 becomes the W-channel,...).  The ambisonics order is  calculated  from  the
       number of channels using N=(O+1)^2.

       If you specify the 'order', then all extranous channels will be stored as 'extra' channels.

       You  can  also write extended ambix files, by specifying an adaptor matrix (either a soundfile, where the
       channels are read as rows and the frames as columns, or by specifying one of the standard  matrices),  in
       which  case  the  columns  of the matrix define the number of (reduced) ambisonics channels read from the
       input and the rows of the matrix must form a full 3d ambisonics set.  Input channels exceeding the number
       of matrix columns are stored as 'extra' channels.

AUTHOR

       Written by IOhannes m zmoelnig <zmoelnig@iem.at>

REPORTING BUGS

       Report bugs to: zmoelnig@iem.at

       Home page: http://ambisonics.iem.at/xchange/format

COPYRIGHT

       Copyright © 2012 Institute of Electronic Music and Acoustics (IEM), University of Music and Dramatic Arts
       (KUG), Graz, Austria.

       License LGPLv2.1: GNU Lesser GPL version 2.1 or later <http://gnu.org/licenses/lgpl.html>
       This is free software: you are free to change and redistribute it.  There is NO WARRANTY, to  the  extent
       permitted by law.