Overview Clamps Packages CM Dictionary Clamps Dictionary Fomus
Next: transform , Previous: toggle-slot , Up: T , Home: Overview

Clamps Dictionary

track-ats

Function 

(track-ats file &rest args &key (start 0.0) (duration nil) (lowest-frequency 20) (highest-frequency 20000.0) (frequency-deviation 0.1) (window-cycles 4) (window-type 'blackman-harris-4-1) (hop-size 1/4) (fft-size nil) (lowest-magnitude (db-amp -60)) (track-length 3) (min-segment-length 3) (last-peak-contribution 0.0) (smr-continuity 0.0) (amp-threshold nil) (residual nil) (par-energy t) (optimize t) (debug nil) (verbose nil) (force-m nil) (force-window nil))

Analyze a soundfile file and return its ats-sound structure. The soundfile will be searched in all paths contained in *​​sfile-path​​* and its subdirectories.

Arguments

file String denoting filename of the soundfile within *​​ats-snd-dir​​* to analyze.
:start Number indicating time offset into the soundfile in seconds.
:duration Number indicating the duration to analyze or nil for end of soundfile.
:lowest-frequency Number indicating the lowest frequency to capture (determines Fourier Window width)
:highest-frequency Number indicating the highest frequency to capture. :frequency deviation - Number indicating the maximum frequency deviation of successive frames to be considered for the same track.
:window-cycles Positive Integer denoting the overlap factor of successive analysis windows.
:window-type The amplitude envelope type to use for each analysis window.
:hop-size Positive Integer denoting the hop-size of successive analysis windows.
:fft-size Positive Integer denoting the FFT size or nil, denoting to calculate the FFT size based on the lowest frequency.
:lowest-magnitude Positive Integer in the range [0..1] setting the threshold for analysis peaks to be considered.
:track-length Positive Integer.
:min-segment-length Positive Integer indicating the minimum number of successive segments within the frequency deviation to qualify for a track.
:last-peak-contribution Number.
:SMR-continuity Number.
:amp-threshold Boolean.
:residual String denoting the filename for the residual noise soundfile or nil if residual noise shouldn't get calculated.
:par-energy Boolean indicating whether to distribute the residual noise to the partials.
:optimize Boolean indicating whether to optimize the results.
:debug Boolean flag to show debug info in the REPL.
:verbose Boolean flag for verbose output.
:force-M Boolean.
:force-window Boolean.

Author: Orm Finnendahl

Created: 2025-02-18 Di 12:58

Validate