Struct light_curve_feature::features::Periodogram

pub struct Periodogram<T, F> where
    T: Float,  { /* fields omitted */ }

A number of features based on Lomb–Scargle periodogram

Periodogram $P(\omega)$ is an estimate of spectral density of unevenly time series. Periodogram::new’s peaks argument corresponds to a number of the most significant spectral density peaks to return. For each peak its period and “signal to noise” ratio is returned.

$$ \mathrm{signal~to~noise~of~peak} \equiv \frac{P(\omega_\mathrm{peak}) - \langle P(\omega) \rangle}{\sigma_{P(\omega)}}. $$

Periodogram can accept another dyn FeatureEvaluator for feature extraction from periodogram as it was time series without observation errors. You can even pass one Periodogram to another one if you are crazy enough

• Depends on: time, magnitude
• Minimum number of observations: 2 (or as required by sub-features)
• Number of features: $2 \times \mathrm{peaks}~+…$

Implementations

impl<T, F> Periodogram<T, F> where
    T: Float,
    F: FeatureEvaluator<T>, 

pub fn default_peaks() -> usize

pub fn default_resolution() -> f32

pub fn default_max_freq_factor() -> f32

pub fn set_freq_resolution(&mut self, resolution: f32) -> &mut Self

Set frequency resolution

The larger frequency resolution allows to find peak period with better precision

pub fn set_max_freq_factor(&mut self, max_freq_factor: f32) -> &mut Self

Multiply maximum (Nyquist) frequency

Maximum frequency is Nyquist frequncy multiplied by this factor. The larger factor allows to find larger frequency and makes PeriodogramPowerFft more precise. However large frequencies can show false peaks

pub fn set_nyquist(&mut self, nyquist: NyquistFreq) -> &mut Self

Define Nyquist frequency

pub fn add_feature(&mut self, feature: F) -> &mut Self

Extend a feature to extract from periodogram

pub fn set_periodogram_algorithm(
    &mut self,
    periodogram_power: PeriodogramPower<T>
) -> &mut Self

pub fn power(&self, ts: &mut TimeSeries<'_, T>) -> Vec<T>

pub fn freq_power(&self, ts: &mut TimeSeries<'_, T>) -> (Vec<T>, Vec<T>)

impl<T, F> Periodogram<T, F> where
    T: Float,
    F: FeatureEvaluator<T> + From<PeriodogramPeaks>, 

pub fn new(peaks: usize) -> Self

New Periodogram that finds given number of peaks

impl<T, F> Periodogram<T, F> where
    T: Float, 

pub fn doc() -> &'static str

Trait Implementations

impl<T: Clone, F: Clone> Clone for Periodogram<T, F> where
    T: Float, 

fn clone(&self) -> Periodogram<T, F>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug, F: Debug> Debug for Periodogram<T, F> where
    T: Float, 

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T, F> Default for Periodogram<T, F> where
    T: Float,
    F: FeatureEvaluator<T> + From<PeriodogramPeaks>, 

fn default() -> Self

Returns the “default value” for a type.

impl<'de, T, F> Deserialize<'de> for Periodogram<T, F> where
    T: Float,
    T: Float,
    F: FeatureEvaluator<T> + From<PeriodogramPeaks> + TryInto<PeriodogramPeaks>,
    <F as TryInto<PeriodogramPeaks>>::Error: Debug, 

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl<T, F> FeatureEvaluator<T> for Periodogram<T, F> where
    T: Float,
    F: FeatureEvaluator<T> + From<PeriodogramPeaks> + TryInto<PeriodogramPeaks>,
    <F as TryInto<PeriodogramPeaks>>::Error: Debug, 

fn eval(&self, ts: &mut TimeSeries<'_, T>) -> Result<Vec<T>, EvaluatorError>

Should return the vector of feature values or EvaluatorError

fn eval_or_fill(&self, ts: &mut TimeSeries<'_, T>, fill_value: T) -> Vec<T>

Should return the vector of feature values and fill invalid components with given value

fn get_info(&self) -> &EvaluatorInfo

Get feature evaluator meta-information

fn get_names(&self) -> Vec<&str>

Should return the vector of feature names. The length and feature order should correspond to eval() output

fn get_descriptions(&self) -> Vec<&str>

Should return the vector of feature descriptions. The length and feature order should correspond to eval() output

fn size_hint(&self) -> usize

Should return the size of vectors returned by eval() and get_names()

fn min_ts_length(&self) -> usize

Should return minimum time series length to successfully find feature value

fn is_t_required(&self) -> bool

fn is_m_required(&self) -> bool

fn is_w_required(&self) -> bool

fn is_sorting_required(&self) -> bool

fn check_ts_length(
    &self,
    ts: &TimeSeries<'_, T>
) -> Result<usize, EvaluatorError>

impl<T> From<Periodogram<T, Feature<T>>> for Feature<T> where
    T: Float, 

fn from(v: Periodogram<T, Self>) -> Feature<T>

Performs the conversion.

impl<T, F> JsonSchema for Periodogram<T, F> where
    T: Float,
    F: FeatureEvaluator<T>, 

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

fn schema_name() -> String

The name of the generated JSON Schema.

fn json_schema(gen: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

impl<T, F> Serialize for Periodogram<T, F> where
    T: Float,
    T: Float,
    F: FeatureEvaluator<T> + From<PeriodogramPeaks> + TryInto<PeriodogramPeaks>,
    <F as TryInto<PeriodogramPeaks>>::Error: Debug, 

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl<T> TryInto<Periodogram<T, Feature<T>>> for Feature<T> where
    T: Float, 

type Error = &'static str

The type returned in the event of a conversion error.

fn try_into(
    self
) -> Result<Periodogram<T, Self>, <Self as TryInto<Periodogram<T, Self>>>::Error>

Performs the conversion.