view INSTALL.txt @ 264:1cec738101a8 0.8.9.anteindex

Fixed trackSequenceQueryNNReporter and trackSequenceQueryRadNNReporter so that order of point reporting is
what you would expect: i.e. closest to farthest.

pointNN is set to allow a maximum (MAX_POINTNN) of 1000000 points. This allows computation of an S-Matrix
using -Q nsequence. It also enables using the new -Q onetoonensequence query type for concatenative
synthesis by finding the closest match in the entire database to each query point. Restrict lists (-K
rList.txt) are useful for limiting the search to specific items in the database in these two cases.

-This line, and those below, will be ignored--

M    trunk/reporter.h

Dependencies
------------

gsoap: audioDB uses libgsoap++ for SOAP Web Services support.  This
       can be installed on most linux distributions using the package
       manager; the binary distribution will suffice.  Other systems
       will need to install the library.

gengetopt: audioDB uses gengetopt (as of 2007-10-23, version 2.18
           exactly) for command-line parsing.

help2man: a spartan manual page is automatically generated from the
          usage text using help2man.

bash: audioDB's test suite depends on /bin/sh being bash, version 3.0
      or greater.

Compiling
---------

Use the following make commands to compile audioDB on your system:

Linux:         make
(Debian-derived systems, with the right versions of gengetopt, gsoap
and help2man installed)

OS X or Win32: make \
  GENGETOPT=/path/to/bin/gengetopt \
  SOAPCPP2=/path/to/bin/soapcpp2 \
  GSOAP_CPP=/path/to/gsoap/stdsoap2.cpp \
  GSOAP_INCLUDE="-I /path/to/gsoap"
(where the path in GSOAP_INCLUDE should name the directory in which
stdsoap2.h resides)

Testing
-------

audioDB comes with a suite of test scripts that verify that particular
pieces of functionality are behaving acceptably.  They depend on
/bin/sh being GNU bash, version 3 or greater.  The test suite can be
run with the command "make test".

When running on systems without sparse file support (notably those
using the default filesystem in Mac OS X), running the test suite
requires approximately 70GB of free hard disk space.  On other
systems, disk usage from running the test suite is negligible.

Installation
------------

The audioDB executable is command-line database client, SOAP server
and SOAP client all in one: to install for system-wide use, simply
copy it to a place in the system-wide path.

The build process also generates a Web Service Description file,
adb.wsdl; to publish a description of an audioDB web service, you will
need to edit that file to point to the network address and port of
your audioDB server before publishing it on an ordinary HTTP server.