mas01cr@0: # POSIX-COMPLIANT COMMAND LINE ARGUMENTS: mas01cr@0: # mas01cr@0: # -v --verbosity mas01cr@0: # mas01cr@0: # -d --database dbName mas01cr@0: # -N --NEW mas01cr@0: # -S --STATUS mas01cr@0: # -D --DUMP mas01cr@0: # -L --L2NORM mas01cr@0: # mas01cr@0: # -f --features features.bin mas01cr@0: # -k --key key mas01cr@0: # -t --timePoints.txt mas01cr@0: # -I --INSERT mas01cr@0: # -U --UPDATE mas01cr@0: # mas01cr@0: # -F --featureList featureList.txt mas01cr@0: # -K --keyList keyList.txt mas01cr@0: # -T --timePointsList.txt mas01cr@0: # -B --BATCHINSERT dbName mas01cr@0: # mas01cr@0: # -Q --QUERY {point|segment|sequence} mas01cr@0: # -p --qpoint - ordinal position of query vector in feature input file mas01cr@0: # -n --pointnn n - number of nearest neigbour points per segment mas01cr@0: # -r --resultlength n - number of segments (nearest neighbours) to return mas01cr@0: # -l --seqlen len - length of sequence mas01cr@0: # -h --seqhop hop - hop size of sequence mas01cr@0: # -R --radius - radius-based search, return all points/segments/sequences < radius (0...Inf) mas01cr@0: # -x --x - time expand (compress) factor (ratio of result length to query length (and visa-versa)) [1..Inf] mas01cr@0: # -o --rotate - rotate the query feature vectors on search mas01cr@0: # mas01cr@0: # -s --SERVER port mas01cr@0: # -c --client host:port mas01cr@0: mas01cr@0: package "audioDB" mas01cr@0: version "version 1.0" mas01cr@0: purpose "A feature vector database management system for content-based retrieval." mas01cr@0: option "help" H "print help on audioDB usage and exit." optional mas01cr@0: option "verbosity" v "level of detail of operational information." int typestr="detail" default="1" optional mas01cr@0: text "\nDatabase commands are UPPER CASE. Command options are lower case.\n" mas01cr@0: text "" mas01cr@0: section "Database Setup" sectiondesc="All database operations require a database argument." mas01cr@0: mas01cr@0: option "database" d "database file required by Database commands." string typestr="filename" optional mas01cr@0: option "NEW" N "make a new (initially empty) database." dependon="database" optional mas01cr@0: option "STATUS" S "output database information to stdout." dependon="database" optional mas01cr@0: option "DUMP" D "output all entries: index key size." dependon="database" optional mas01cr@0: option "L2NORM" L "unit norm vectors and norm all future inserts." dependon="database" optional mas01cr@0: section "Database Insertion" sectiondesc="The following commands insert feature files, with optional keys and timestamps.\n" mas01cr@0: option "INSERT" I "add feature vectors to an existing database." dependon="features" dependon="database" optional mas01cr@0: option "UPDATE" U "replace inserted vectors associated with key with new input vectors." dependon="features" dependon="key" dependon="database" optional hidden mas01cr@0: option "features" f "binary series of vectors file {int sz:ieee double[][sz]:eof}." string typestr="filename" dependon="database" optional mas01cr@0: option "times" t "list of time points (ascii) for feature vectors." string typestr="filename" dependon="features" optional mas01cr@0: option "key" k "unique identifier associated with features." string typestr="identifier" dependon="features" optional mas01cr@0: text "" mas01cr@0: option "BATCHINSERT" B "add feature vectors named in a --featureList file (with optional keys in a --keyList file) to the named database." dependon="featureList" optional mas01cr@0: option "featureList" F "text file containing list of binary feature vector files to process" string typestr="filename" dependon="database" optional mas01cr@0: option "timesList" T "text file containing list of ascii --times for each --features file in --featureList." string typestr="filename" dependon="featureList" optional mas01cr@0: option "keyList" K "text file containing list of unique identifiers associated with --features." string typestr="filename" optional mas01cr@0: mas01cr@0: mas01cr@0: section "Database Search" sectiondesc="Thse commands control the retrieval behaviour.\n" mas01cr@0: mas01cr@0: option "QUERY" Q "content-based search on --database using --features as a query. Optionally restrict the search to those segments identified in a --keyList." values="point","segment","sequence" typestr="searchtype" dependon="database" dependon="features" optional mas01cr@0: option "qpoint" p "ordinal position of query start point in --features file." int typestr="position" default="0" optional mas01cr@0: option "exhaustive" e "exhaustive search: iterate through all query vectors in search. Overrides --qpoint." flag off optional hidden mas01cr@0: option "pointnn" n "number of point nearest neighbours to use in retrieval." int typestr="numpoints" default="10" optional mas01cr@0: option "radius" R "radius search, returns all points/segments/sequences inside given radius." double default="1.0" optional hidden mas01cr@0: option "expandfactor" x "time compress/expand factor of result length to query length [1.0 .. 100.0]." double default="1.1" optional hidden mas01cr@0: option "rotate" o "rotate query vectors for rotationally invariant search." flag off optional hidden mas01cr@0: option "resultlength" r "maximum length of the result list." int typestr="length" default="10" optional mas01cr@0: option "sequencelength" l "length of sequences for sequence search." int typestr="length" default="16" dependon="QUERY" optional mas01cr@0: option "sequencehop" h "hop size of sequence window for sequence search." int typestr="hop" default="1" dependon="QUERY" optional mas01cr@0: mas01cr@0: section "Web Services" sectiondesc="These commands enable the database process to establish a connection via the internet and operate as separate client and server processes.\n" mas01cr@0: option "SERVER" s "run as standalone web service on named port." int typestr="port" default="80011" optional mas01cr@0: option "client" c "run as a client using named host service." string typestr="hostname:port" optional mas01cr@0: mas01cr@0: mas01cr@0: text "\nCopyright (C) 2007 Michael Casey, Goldsmiths, University of London\n" mas01cr@0: mas01cr@0: