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.