7.1.11 Command Format

The way of executing harktool4 using only the commands is as follows:

Following features are available.

• Generating impulse response list files

• Generating TSP response list files

• Generating microphone position files

• Generating noise position files

• Generating localization transfer function files

• Generating separation transfer function files

1. Installation

   If the tool’s distribution is supported by HARK, it can be installed using apt-get

   sudo apt-get install harktool4_cui
   

   
   

2. Usage

   Enter the following command from the terminal.

    harktool4_cui [options] input-files
   
   Example: Generating the template file of the ImpulseResponseListFile
   
   Range of azimuth: -180〜180 at 1 interval
   Height: 16.7 deg
   Radius from the center to the sound source: 1m
   
   
   harktool4_cui 
   --mode template 　　　　　# template mode
   --output-file ImpulseResponseListFile.xml # output file format
   --output-format xml 　   # XML format
   --output-type ir         # ImpulseResponse type
   --azifrom -180.000000   # start of the azimuth range: -180 deg
   --aziint 5.000000       # interval of the azimuth: 1 deg
   --numazi 72             # number of azimuth  72
   --elvfrom 16.700000     # start of the height range 16.7 deg
   --elvint 0.000000       # no interval
   --numelv 1              # number of intervals: 1
   --radius 1.000000       # radius: 1m
   --cut-start 1           # start index: from 1
   --cut-end 0             # end index: to the last
   --filepath /home/username/D{AZIMUTH:%03d}_E{ELEVATION:%03d}_R100_ch{CHANNEL:%02d}.flt 
   
   
   
   

   [Common Option:]
   –help                       help output
   -m [ –mode ] arg            mode [template / tf]
   -o [ –output-file ] arg     output (default is STDOUT)
   -f [ –output-format ] arg   output format [xml / binary]
   -t [ –output-type ] arg     output type
                                  (1)template mode [mic / noise / ir / tsp]
                                  (2)transfer functino mode [m2pg / gtf]
   

   [Option:]
   Values in parentheses are initial values.

   • –nummic arg (=8)                        Number of microphones

   • –azifrom arg (=0)                       Start of the azimuth range

   • –aziint arg (=5)                        Interval of the azimuth　　　

   • –numazi arg (=72)                       Number of the azimuths

   • –elvfrom arg (=0)                       Start of the height range (vertical angle of the sound source; -90 to 90 deg)

   • –elvint arg (=5)                        Interval of height

   • –numelv arg (=1)                        Number of intervals

   • –heightfrom arg (=0)                    Start of the height range (m)

   • –heightint arg (=0.01)                  Interval of the height (m)

   • –numheight arg (=1)                     Number of heights

   • –radius arg (=1)                        Radius from the center to the microphone or sound source

   • –synchronous-average arg (=16)          Number of synchronous averages

   • –original-impulse-file arg(=original-impulse-file.tsp) Original impulse file

   • –tsp-offset arg (=16384)                Impulse file in the sample

   • –tsp-length arg (=16384)                Length of a TSP in the sample

   • –signal-max arg (=32768)                Maximum width of the TSP signal

   • –cut-start arg (=1)                     Cut-start index of the floating point vector

   • –cut-end arg (=0)                       Cut-end index of the floating point vector

   • –mic-channels arg                       Comma-separated list of the microphone channels.

   • –filepath arg                           Template string of file path

   • –nfft arg (=512)                        Number of FFT points

   • –normalize-src                          Normalization of the sound source axis

   • –normalize-mic                          Normalization of the microphone channel axis

   • –normalize-freq                         Normalization of the frequency axis

   • –geometry-calculus arg (=0)             Geometry calculation flag (0: Geometry calculation is not appliedm 1: applied)

   • –sampling-freq arg (=16000)             Sampling frequency

   • –direct-length arg (=32)                Length of the direct sound