Next: , Previous: sporchdb, Up: Command-Line Interface


5.2 sporchq


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:

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.