shape_descriptors.hpp

Go to the documentation of this file.

// toolboxes/audio/include/nk/audio/spectral/shape_descriptors.hpp
//
// Audio spectral shape descriptors.
 
#pragma once
 
#include <memory_resource>
#include <nk/value/value.hpp>
 
namespace nk::audio {

 


Value spectralCentroid(const Value &x, const Value &f,
                       std::pmr::memory_resource *mr = nullptr);

Value spectralSpread(const Value &x, const Value &f,
                     std::pmr::memory_resource *mr = nullptr);

Value spectralRolloffPoint(const Value &x, const Value &f,
                           double percentile = 0.95,
                           std::pmr::memory_resource *mr = nullptr);

Value spectralDecrease(const Value &x, const Value &f,
                       std::pmr::memory_resource *mr = nullptr);

Value spectralSlope(const Value &x, const Value &f,
                    std::pmr::memory_resource *mr = nullptr);

Value spectralFlux(const Value &x, const Value &f, double p = 2.0,
                   std::pmr::memory_resource *mr = nullptr);
 
// ─────────────────────────────────────────────────────────────────────
// Shape statistics. Frequency moments (kurtosis / skewness) use the
// standard X-weighted central-moment definition.
// ─────────────────────────────────────────────────────────────────────

Value spectralCrest(const Value &x, const Value &f,
                    std::pmr::memory_resource *mr = nullptr);

Value spectralEntropy(const Value &x, const Value &f,
                      std::pmr::memory_resource *mr = nullptr);

Value spectralFlatness(const Value &x, const Value &f,
                       std::pmr::memory_resource *mr = nullptr);

Value spectralKurtosis(const Value &x, const Value &f,
                       std::pmr::memory_resource *mr = nullptr);

Value spectralSkewness(const Value &x, const Value &f,
                       std::pmr::memory_resource *mr = nullptr);
 

} // namespace nk::audio