7.1.11 Command Format

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

Following features are available.

  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