Namespace AudioAnalysisTools.Tracks
Classes
ForwardTrackAlgorithm
OnebinTrackAlgorithm
This class searches a spectrogram for whistles, that is, for tones or spectral peaks that persist in one frequency bin. In practice, the whistles of birds and other natural sources do not occupy a single frequency bin, although this statement is confounded by the choice of recording sample rate and frame size. But typically, a bird whistle spreads itself across three or more frequency bins using typical values for SR etc. In this class, we make an assumption about the spectral profile of a whistle and the user is expected to find the appropriate sample rate, frame size and frame step such that the target whistle is detected using the profile. We define a whistle profile that is 11 bins wide. The actual whistle occupies the centre three bins, ie bins -1, 0 , +1. Bins -2 and +2 are ignored to allow for some flexibility in getting he right combination of sample rate, frame size and frame step. To establish that the centre three bins contain a spectral peak (i.e. are part of a potential whistle), we define top and bottom sidebands, each of width three bins. These are used to establish a baseline intensity which must be less than that of the centre three bins. The bottom sideband = bins -3, -4, -5. The top sideband = bins +3, +4, +5. Defining a whistle this way introduces edge effects at the top and bottom of the spectrogram. In case of the low frequency edge, in order to get as close as possible to the frequency bin zero, we do not incorporate a bottom sidebound into the calculations. Also note that a typical bird whistle is not exactly a pure tone. It typically fluctuates slightly from one frequency bin to an adjacent bin and back. Consequently a final step in this whistle detection algorithm is to merge adjacent whistle tracks. The algorithm is not perfect but it does detect constant tone sounds. Theis algorithm is designed so as not to pick up chirps, i.e. gradually rising and falling tones. However, here again the right choice of SR, frame size and frame step are important.
OneframeTrackAlgorithm
UpwardTrackAlgorithm
EXPANATION: A vertical track is a near click or rapidly frequency-modulated tone. A good example is the whip component of the whip-bird call. They would typically be only a few time-frames duration.