pyampact.performance.estimate_perceptual_parameters

pyampact.performance.estimate_perceptual_parameters(f0_vals, pwr_vals, M, SR, hop, gt_flag)[source]

Estimates a range of performance parameters from the inputted fundamental frequency (f0_vales), power (pwr_vals), and spectrum estimates (M)

Parameters:

  • f0_vals (np.ndarray) – A vector of fundamental frequency estimates.

  • pwr_vals (np.ndarray) – A vector of power values corresponding to the fundamental frequency estimates.

  • M (np.ndarray or dict) –

    Either:

    • dict of precomputed spectral feature vectors (FAST PATH), or

    • spectrogram slice [freq x frames] (SLOW / LEGACY PATH)

  • SR (float) – The sample rate used to generate the fundamental frequency estimates.

  • hop (float) – The hop size used in the analysis, expressed in seconds.

  • gt_flag (bool) – A flag indicating whether to use ground truth information for the estimation.

Returns:

res – Dictionary of per-note vectors and summary statistics.

Return type:

dict