Usage: sporchq [OPTION]... DATA Data choices: totamp-by-dyn totamp-by-pitch list-insts maxamp-by-dyn maxamp-by-pitch peaks General Options: -h [ --help ] print help message -v [ --version ] print version -r [ --db-dir ] arg database directory Parameters: -f [ --format ] arg (=text) output format (text|plot) -u [ --tuning ] arg tuning system id -i [ --inst ] arg instrument id -t [ --tech ] arg technique id -p [ --pitch ] arg pitch -m [ --mic ] arg microtone -d [ --dyn ] arg dynamic level -b [ --nodb ] don't show amplitude values in decibels -n [ --nohz ] use pitch numbers instead of hertz for some plots -c [ --coll ] arg collection preference (option may be specified more than once) -l [ --model ] arg instrument model preference (option may be specified more than once) -o [ --cons ] arg (=none) collection/model consistency type (global|inst|no ne)
Once the database has been compiled, use the sporchq command to inspect the data. Specifying ‘plot’ after the -f option tells sporchq to use gnuplot. By default, gnuplot prints an ASCII graph—there are several options in the .sporch file to change this.
A few sample usages are:
‘sporchq -fplot peaks -iflute -p70 -d3 -u24tet’
‘sporchq -fplot maxamp-by-pitch -iviolin -d4’
Simply select a data type and enough arguments to give sporchq the information it needs for the plot. -b and -n can be used to enable or disable logarithmic scaling.
The strangest option is probably -o. If multiple collections and instrument models have been specified in the conf files used to compile the database, use the -c, -l and -o options to choose among them. sporchdb automatically calculates its own default selection preferences—it picks the collections and models that provide the “smoothest” connection between spectral peaks from pitch to pitch and dynamic level to dynamic level. Specifying -c and -l overrides these default preferences. Supplying ‘global’ to -o tells sporchq to use only one sample collection and instrument model if possible (analyses from other collections or models are used if data is missing). Supplying ‘inst’ tells sporchq to be consistent with respect to each instrument (ie. different instruments can be from different collections, but data for each instrument is from a single collection and model if possible). ‘none’ means that all available collections and models may be mixed together.