评分器基类

class darts.ad.scorers.scorers.AnomalyScorer(is_univariate, window)[源代码]

基类:ABC

所有异常评分器的基类

属性

is_probabilistic

评分器是否期望将概率预测作为第一个输入。

is_trainable

评分器是否可训练。

is_univariate

Scorer 是否为单变量评分器。

方法

eval_metric_from_prediction(anomalies, ...)

计算 seriespred_series 之间的异常分数,并返回一个不可知阈值度量的分数。

score_from_prediction(series, pred_series)

计算两个(序列)序列的异常分数。

show_anomalies_from_prediction(series, ...)

绘制评分器的结果。

参数
  • is_univariate (bool) – 评分器是否为单变量评分器。

  • window (int) – 整数值,表示评分器用于将序列转换为异常分数的窗口 W 的大小。评分器会将给定的序列分割成大小为 W 的子序列,并返回一个值,指示这些 W 值子集的异常程度。后处理步骤将把这个异常分数转换为点对点的异常分数(参见 window_transform 的定义)。窗口大小应与所寻找的异常预期持续时间相称。

属性

is_probabilistic

评分器是否期望将概率预测作为第一个输入。

is_trainable

评分器是否可训练。

is_univariate

Scorer 是否为单变量评分器。

方法

eval_metric_from_prediction(anomalies, ...)

计算 seriespred_series 之间的异常分数,并返回一个不可知阈值度量的分数。

score_from_prediction(series, pred_series)

计算两个(序列)序列的异常分数。

show_anomalies_from_prediction(series, ...)

绘制评分器的结果。

eval_metric_from_prediction(anomalies, series, pred_series, metric='AUC_ROC')[源代码]

计算 seriespred_series 之间的异常分数,并返回一个不可知阈值度量的分数。

参数
  • anomalies (Union[TimeSeries, Sequence[TimeSeries]]) – 地面真值二进制异常序列(1 表示异常,0 表示正常)。

  • series (Union[TimeSeries, Sequence[TimeSeries]]) – 实际系列(的序列)。

  • pred_series (Union[TimeSeries, Sequence[TimeSeries]]) – 预测序列(的序列)。

  • metric (Literal[‘AUC_ROC’, ‘AUC_PR’]) – 要使用的度量函数名称。必须是以下之一:“AUC_ROC”(接收者操作特征曲线下面积)和“AUC_PR”(从分数计算的平均精度)。默认值:“AUC_ROC”。

返回类型

Union[float, Sequence[float], Sequence[Sequence[float]]]

返回

  • float – 单个单变量 序列 的单个度量值。

  • Sequence[float] – 一个包含以下指标值的序列:

    • 一个多变量的 序列

    • 一系列单变量 序列

  • Sequence[Sequence[float]] – 一个序列的序列,表示多变量 序列 的度量值。外层序列遍历序列,内层序列遍历序列的组件/列。

property is_probabilistic: bool

评分器是否期望将概率预测作为第一个输入。

返回类型

bool

property is_trainable: bool

评分器是否可训练。

返回类型

bool

property is_univariate: bool

Scorer 是否为单变量评分器。

返回类型

bool

score_from_prediction(series, pred_series)[源代码]

计算两个(序列)序列的异常分数。

如果给定一对序列,它们必须包含相同数量的序列。评分器将对每一对序列独立评分,并返回每一对的异常分数。

参数
返回

(序列的)异常分数时间序列

返回类型

Union[TimeSeries, Sequence[TimeSeries]]

show_anomalies_from_prediction(series, pred_series, scorer_name=None, anomalies=None, title=None, metric=None)[源代码]

绘制评分器的结果。

计算两个序列的异常分数,并绘制结果。

图表将由以下部分组成:
  • 序列和预测序列。

  • 评分器的异常分数。

  • 实际的异常,如果有的话。

可以做到:
  • 使用 title 参数为图片添加标题

  • 使用 scorer_name 为评分器指定个性化名称

  • 如果提供了实际的异常值,显示异常评分(AUC_ROC 或 AUC_PR)的指标结果。

参数
  • series (TimeSeries) – 要从中可视化异常的实际序列。

  • pred_series (TimeSeries) – 预测的 series 系列。

  • anomalies (TimeSeries) – 异常的地面真实值(如果是异常则为1,否则为0)

  • scorer_name (str) – 评分者的名字。

  • title (str) – 图的标题

  • metric (Optional[Literal[‘AUC_ROC’, ‘AUC_PR’], None]) – 可选地,指定要使用的度量函数名称。必须是 “AUC_ROC”(接收者操作特征曲线下面积)或 “AUC_PR”(从分数计算的平均精度)之一。默认值:”AUC_ROC”。

class darts.ad.scorers.scorers.FittableAnomalyScorer(is_univariate, window, window_agg, diff_fn=<function ae>, n_jobs=1)[源代码]

基类:AnomalyScorer

需要训练的评分器的基类。

属性

is_probabilistic

评分器是否期望将概率预测作为第一个输入。

is_trainable

评分器是否可训练。

is_univariate

Scorer 是否为单变量评分器。

方法

eval_metric(anomalies, series[, metric])

计算给定时间序列的异常分数,并返回一个不可知阈值度量的分数。

eval_metric_from_prediction(anomalies, ...)

计算 seriespred_series 之间的异常分数,并返回一个不可知阈值度量的分数。

fit(series)

在给定的时间序列上拟合评分器。

fit_from_prediction(series, pred_series)

在两个(序列的)系列上拟合评分器。

score(series)

计算给定序列的异常分数。

score_from_prediction(series, pred_series)

计算两个(序列)序列的异常分数。

show_anomalies(series[, anomalies, ...])

绘制评分器的结果。

show_anomalies_from_prediction(series, ...)

绘制评分器的结果。

参数
  • is_univariate (bool) – 评分器是否为单变量评分器。

  • window (int) – 整数值,表示评分器用于将序列转换为异常分数的窗口 W 的大小。评分器会将给定的序列分割成大小为 W 的子序列,并返回一个值,指示这些 W 值子集的异常程度。后处理步骤将把这个异常分数转换为点对点的异常分数(参见 window_transform 的定义)。窗口大小应与所寻找的异常预期持续时间相称。

  • window_agg (bool) – 是否将窗口异常分数转换/聚合为点异常分数。

  • diff_fn (Callable[…, Union[float, List[float], ndarray, List[ndarray]]]) – 用于将预测和实际序列转换为一个序列的差异函数。然后对该序列应用评分器。必须是Darts的每时间步长指标之一(例如,ae() 表示绝对差异,err() 表示差异,se() 表示平方差异,…)。默认使用绝对差异(ae())。

  • n_jobs (int) – 要并行运行的作业数量。仅当输入为 Sequence[TimeSeries] 时才会创建并行作业,并行化处理不同的 TimeSeries。默认为 1`(顺序执行)。将参数设置为 `-1 表示使用所有可用处理器。

属性

is_probabilistic

评分器是否期望将概率预测作为第一个输入。

is_trainable

评分器是否可训练。

is_univariate

Scorer 是否为单变量评分器。

方法

eval_metric(anomalies, series[, metric])

计算给定时间序列的异常分数,并返回一个不可知阈值度量的分数。

eval_metric_from_prediction(anomalies, ...)

计算 seriespred_series 之间的异常分数,并返回一个不可知阈值度量的分数。

fit(series)

在给定的时间序列上拟合评分器。

fit_from_prediction(series, pred_series)

在两个(序列的)系列上拟合评分器。

score(series)

计算给定序列的异常分数。

score_from_prediction(series, pred_series)

计算两个(序列)序列的异常分数。

show_anomalies(series[, anomalies, ...])

绘制评分器的结果。

show_anomalies_from_prediction(series, ...)

绘制评分器的结果。

eval_metric(anomalies, series, metric='AUC_ROC')[源代码]

计算给定时间序列的异常分数,并返回一个不可知阈值度量的分数。

参数
  • anomalies (Union[TimeSeries, Sequence[TimeSeries]]) – 地面真值二进制异常序列(1 表示异常,0 表示正常)。

  • series (Union[TimeSeries, Sequence[TimeSeries]]) – 要从中检测异常的(序列)系列。

  • metric (Literal[‘AUC_ROC’, ‘AUC_PR’]) – 要使用的度量函数名称。必须是以下之一:“AUC_ROC”(接收者操作特征曲线下面积)和“AUC_PR”(从分数计算的平均精度)。默认值:“AUC_ROC”。

返回类型

Union[float, Sequence[float], Sequence[Sequence[float]]]

返回

  • float – 单变量 series 系列(只有一个组件/列)的单个分数/指标。

  • Sequence[float] – 一个分数序列(列表),用于:

    • 多变量 系列 系列(多个组成部分)。为每个组成部分给出一个分数。

    • 一系列(列表)的单变量 series 序列。为每个序列提供一个分数。

  • Sequence[Sequence[float]] – 一个多元 序列 序列的分数序列。为每个序列(外部序列)和组件(内部序列)提供一个分数。

eval_metric_from_prediction(anomalies, series, pred_series, metric='AUC_ROC')

计算 seriespred_series 之间的异常分数,并返回一个不可知阈值度量的分数。

参数
  • anomalies (Union[TimeSeries, Sequence[TimeSeries]]) – 地面真值二进制异常序列(1 表示异常,0 表示正常)。

  • series (Union[TimeSeries, Sequence[TimeSeries]]) – 实际系列(的序列)。

  • pred_series (Union[TimeSeries, Sequence[TimeSeries]]) – 预测序列(的序列)。

  • metric (Literal[‘AUC_ROC’, ‘AUC_PR’]) – 要使用的度量函数名称。必须是以下之一:“AUC_ROC”(接收者操作特征曲线下面积)和“AUC_PR”(从分数计算的平均精度)。默认值:“AUC_ROC”。

返回类型

Union[float, Sequence[float], Sequence[Sequence[float]]]

返回

  • float – 单个单变量 序列 的单个度量值。

  • Sequence[float] – 一个包含以下指标值的序列:

    • 一个多变量的 序列

    • 一系列单变量 序列

  • Sequence[Sequence[float]] – 一个序列的序列,表示多变量 序列 的度量值。外层序列遍历序列,内层序列遍历序列的组件/列。

fit(series)[源代码]

在给定的时间序列上拟合评分器。

如果是一系列序列,评分器将基于序列的连接进行拟合。

假设 series 通常是无异常的。

参数

series (Union[TimeSeries, Sequence[TimeSeries]]) – 没有异常的(序列)系列。

返回

Fitted Scorer.

返回类型

self

fit_from_prediction(series, pred_series)[源代码]

在两个(序列的)系列上拟合评分器。

传递给评分器的函数 diff_fn 会将 pred_seriesseries 转换为一个序列。默认情况下,diff_fn 将计算绝对差值(默认:ae())。如果 pred_seriesseries 是序列,diff_fn 将应用于序列中所有成对的元素。

评分器将在此(序列)系列上进行拟合。如果给定的是一个系列序列,评分器将在序列的连接上进行拟合。

评分器假设(序列的)序列是无异常的。

如果系列中的任何一个具有随机性(n_samples>1),则在分位数 0.5 上计算 diff_fn

参数
返回

Fitted Scorer.

返回类型

self

property is_probabilistic: bool

评分器是否期望将概率预测作为第一个输入。

返回类型

bool

property is_trainable: bool

评分器是否可训练。

返回类型

bool

property is_univariate: bool

Scorer 是否为单变量评分器。

返回类型

bool

score(series)[源代码]

计算给定序列的异常分数。

如果给定了一系列序列,评分器将对每个序列独立评分,并返回序列中每个序列的异常分数。

参数

series (Union[TimeSeries, Sequence[TimeSeries]]) – 要从中检测异常的(序列)系列。

返回

(序列的)异常分数时间序列

返回类型

Union[TimeSeries, Sequence[TimeSeries]]

score_from_prediction(series, pred_series)[源代码]

计算两个(序列)序列的异常分数。

作为评分器参数传递的函数 diff_fn ,会将 pred_seriesseries 转换为一个“差异”序列。默认情况下,diff_fn 将计算绝对差异(默认值:ae())。如果 series 和 pred_series 是序列,diff_fn 将应用于序列中所有成对元素。

评分器随后会将这一系列数据转换为异常分数。如果给定了一系列数据序列,评分器将对每个序列独立评分,并返回序列中每个数据的异常分数。

参数
返回

(序列的)异常分数时间序列

返回类型

Union[TimeSeries, Sequence[TimeSeries]]

show_anomalies(series, anomalies=None, scorer_name=None, title=None, metric=None)[源代码]

绘制评分器的结果。

计算给定序列输入的分数。并绘制结果。

图表将由以下部分组成:
  • 系列本身。

  • 异常分数的分数。

  • 实际的异常,如果有的话。

可以做到:
  • 使用 title 参数为图片添加标题

  • 使用 scorer_name 为评分器指定个性化名称

  • 显示异常分数的指标结果(AUC_ROC 或 AUC_PR),

如果提供了实际的异常。

参数
  • series (TimeSeries) – 要从中可视化异常的系列。

  • anomalies (TimeSeries) – 地面真值二进制异常序列(1 表示异常,0 表示正常)。

  • scorer_name (str) – 评分者的名字。

  • title (str) – 图的标题

  • metric (Optional[Literal[‘AUC_ROC’, ‘AUC_PR’], None]) – 可选地,指定要使用的度量函数名称。必须是 “AUC_ROC”(接收者操作特征曲线下面积)或 “AUC_PR”(从分数计算的平均精度)之一。默认值:”AUC_ROC”。

show_anomalies_from_prediction(series, pred_series, scorer_name=None, anomalies=None, title=None, metric=None)

绘制评分器的结果。

计算两个序列的异常分数,并绘制结果。

图表将由以下部分组成:
  • 序列和预测序列。

  • 评分器的异常分数。

  • 实际的异常,如果有的话。

可以做到:
  • 使用 title 参数为图片添加标题

  • 使用 scorer_name 为评分器指定个性化名称

  • 如果提供了实际的异常值,显示异常评分(AUC_ROC 或 AUC_PR)的指标结果。

参数
  • series (TimeSeries) – 要从中可视化异常的实际序列。

  • pred_series (TimeSeries) – 预测的 series 系列。

  • anomalies (TimeSeries) – 异常的地面真实值(如果是异常则为1,否则为0)

  • scorer_name (str) – 评分者的名字。

  • title (str) – 图的标题

  • metric (Optional[Literal[‘AUC_ROC’, ‘AUC_PR’], None]) – 可选地,指定要使用的度量函数名称。必须是 “AUC_ROC”(接收者操作特征曲线下面积)或 “AUC_PR”(从分数计算的平均精度)之一。默认值:”AUC_ROC”。

class darts.ad.scorers.scorers.NLLScorer(window)[源代码]

基类:AnomalyScorer

所有 LikelihoodScorer 的父类

属性

is_probabilistic

评分器是否期望将概率预测作为第一个输入。

is_trainable

评分器是否可训练。

is_univariate

Scorer 是否为单变量评分器。

方法

eval_metric_from_prediction(anomalies, ...)

计算 seriespred_series 之间的异常分数,并返回一个不可知阈值度量的分数。

score_from_prediction(series, pred_series)

计算两个(序列)序列的异常分数。

show_anomalies_from_prediction(series, ...)

绘制评分器的结果。

参数

window – 整数值,表示评分器用于将序列转换为异常分数的窗口 W 的大小。评分器会将给定的序列分割成大小为 W 的子序列,并返回一个值,指示这些 W 值子集的异常程度。后处理步骤将把这个异常分数转换为点对点的异常分数(参见 window_transform 的定义)。窗口大小应与所寻找的异常预期持续时间相称。

属性

is_probabilistic

评分器是否期望将概率预测作为第一个输入。

is_trainable

评分器是否可训练。

is_univariate

Scorer 是否为单变量评分器。

方法

eval_metric_from_prediction(anomalies, ...)

计算 seriespred_series 之间的异常分数,并返回一个不可知阈值度量的分数。

score_from_prediction(series, pred_series)

计算两个(序列)序列的异常分数。

show_anomalies_from_prediction(series, ...)

绘制评分器的结果。

eval_metric_from_prediction(anomalies, series, pred_series, metric='AUC_ROC')

计算 seriespred_series 之间的异常分数,并返回一个不可知阈值度量的分数。

参数
  • anomalies (Union[TimeSeries, Sequence[TimeSeries]]) – 地面真值二进制异常序列(1 表示异常,0 表示正常)。

  • series (Union[TimeSeries, Sequence[TimeSeries]]) – 实际系列(的序列)。

  • pred_series (Union[TimeSeries, Sequence[TimeSeries]]) – 预测序列(的序列)。

  • metric (Literal[‘AUC_ROC’, ‘AUC_PR’]) – 要使用的度量函数名称。必须是以下之一:“AUC_ROC”(接收者操作特征曲线下面积)和“AUC_PR”(从分数计算的平均精度)。默认值:“AUC_ROC”。

返回类型

Union[float, Sequence[float], Sequence[Sequence[float]]]

返回

  • float – 单个单变量 序列 的单个度量值。

  • Sequence[float] – 一个包含以下指标值的序列:

    • 一个多变量的 序列

    • 一系列单变量 序列

  • Sequence[Sequence[float]] – 一个序列的序列,表示多变量 序列 的度量值。外层序列遍历序列,内层序列遍历序列的组件/列。

property is_probabilistic: bool

评分器是否期望将概率预测作为第一个输入。

返回类型

bool

property is_trainable: bool

评分器是否可训练。

返回类型

bool

property is_univariate: bool

Scorer 是否为单变量评分器。

返回类型

bool

score_from_prediction(series, pred_series)

计算两个(序列)序列的异常分数。

如果给定一对序列,它们必须包含相同数量的序列。评分器将对每一对序列独立评分,并返回每一对的异常分数。

参数
返回

(序列的)异常分数时间序列

返回类型

Union[TimeSeries, Sequence[TimeSeries]]

show_anomalies_from_prediction(series, pred_series, scorer_name=None, anomalies=None, title=None, metric=None)

绘制评分器的结果。

计算两个序列的异常分数,并绘制结果。

图表将由以下部分组成:
  • 序列和预测序列。

  • 评分器的异常分数。

  • 实际的异常,如果有的话。

可以做到:
  • 使用 title 参数为图片添加标题

  • 使用 scorer_name 为评分器指定个性化名称

  • 如果提供了实际的异常值,显示异常评分(AUC_ROC 或 AUC_PR)的指标结果。

参数
  • series (TimeSeries) – 要从中可视化异常的实际序列。

  • pred_series (TimeSeries) – 预测的 series 系列。

  • anomalies (TimeSeries) – 异常的地面真实值(如果是异常则为1,否则为0)

  • scorer_name (str) – 评分者的名字。

  • title (str) – 图的标题

  • metric (Optional[Literal[‘AUC_ROC’, ‘AUC_PR’], None]) – 可选地,指定要使用的度量函数名称。必须是 “AUC_ROC”(接收者操作特征曲线下面积)或 “AUC_PR”(从分数计算的平均精度)之一。默认值:”AUC_ROC”。

class darts.ad.scorers.scorers.WindowedAnomalyScorer(is_univariate, window, window_agg, diff_fn)[源代码]

基类:FittableAnomalyScorer

依赖窗口检测异常的异常评分器的基类

属性

is_probabilistic

评分器是否期望将概率预测作为第一个输入。

is_trainable

评分器是否可训练。

is_univariate

Scorer 是否为单变量评分器。

方法

eval_metric(anomalies, series[, metric])

计算给定时间序列的异常分数,并返回一个不可知阈值度量的分数。

eval_metric_from_prediction(anomalies, ...)

计算 seriespred_series 之间的异常分数,并返回一个不可知阈值度量的分数。

fit(series)

在给定的时间序列上拟合评分器。

fit_from_prediction(series, pred_series)

在两个(序列的)系列上拟合评分器。

score(series)

计算给定序列的异常分数。

score_from_prediction(series, pred_series)

计算两个(序列)序列的异常分数。

show_anomalies(series[, anomalies, ...])

绘制评分器的结果。

show_anomalies_from_prediction(series, ...)

绘制评分器的结果。

参数
  • is_univariate (bool) – 评分器是否为单变量评分器。如果为 True 并且在使用多变量序列时,评分是在考虑的窗口中连接的组件/列上计算的,以计算一个评分。

  • window (int) – 整数值,表示评分器用于将序列转换为异常分数的窗口 W 的大小。评分器将给定的序列分割成大小为 W 的子序列,并返回一个值,指示这些 W 值子集的异常程度。后处理步骤将把异常分数转换为点对点的异常分数(参见 window_transform 的定义)。窗口大小应与所寻找的异常预期持续时间相称。

  • window_agg (bool) – 是否将窗口异常分数转换/聚合为点异常分数。

  • diff_fn (Callable[…, Union[float, List[float], ndarray, List[ndarray]]]) – 用于将预测和实际序列转换为一个序列的差异函数。然后对该序列应用评分器。必须是Darts的每时间步长指标之一(例如,ae() 表示绝对差异,err() 表示差异,se() 表示平方差异,…)。默认使用绝对差异(ae())。

属性

is_probabilistic

评分器是否期望将概率预测作为第一个输入。

is_trainable

评分器是否可训练。

is_univariate

Scorer 是否为单变量评分器。

方法

eval_metric(anomalies, series[, metric])

计算给定时间序列的异常分数,并返回一个不可知阈值度量的分数。

eval_metric_from_prediction(anomalies, ...)

计算 seriespred_series 之间的异常分数,并返回一个不可知阈值度量的分数。

fit(series)

在给定的时间序列上拟合评分器。

fit_from_prediction(series, pred_series)

在两个(序列的)系列上拟合评分器。

score(series)

计算给定序列的异常分数。

score_from_prediction(series, pred_series)

计算两个(序列)序列的异常分数。

show_anomalies(series[, anomalies, ...])

绘制评分器的结果。

show_anomalies_from_prediction(series, ...)

绘制评分器的结果。

eval_metric(anomalies, series, metric='AUC_ROC')

计算给定时间序列的异常分数,并返回一个不可知阈值度量的分数。

参数
  • anomalies (Union[TimeSeries, Sequence[TimeSeries]]) – 地面真值二进制异常序列(1 表示异常,0 表示正常)。

  • series (Union[TimeSeries, Sequence[TimeSeries]]) – 要从中检测异常的(序列)系列。

  • metric (Literal[‘AUC_ROC’, ‘AUC_PR’]) – 要使用的度量函数名称。必须是以下之一:“AUC_ROC”(接收者操作特征曲线下面积)和“AUC_PR”(从分数计算的平均精度)。默认值:“AUC_ROC”。

返回类型

Union[float, Sequence[float], Sequence[Sequence[float]]]

返回

  • float – 单变量 series 系列(只有一个组件/列)的单个分数/指标。

  • Sequence[float] – 一个分数序列(列表),用于:

    • 多变量 系列 系列(多个组成部分)。为每个组成部分给出一个分数。

    • 一系列(列表)的单变量 series 序列。为每个序列提供一个分数。

  • Sequence[Sequence[float]] – 一个多元 序列 序列的分数序列。为每个序列(外部序列)和组件(内部序列)提供一个分数。

eval_metric_from_prediction(anomalies, series, pred_series, metric='AUC_ROC')

计算 seriespred_series 之间的异常分数,并返回一个不可知阈值度量的分数。

参数
  • anomalies (Union[TimeSeries, Sequence[TimeSeries]]) – 地面真值二进制异常序列(1 表示异常,0 表示正常)。

  • series (Union[TimeSeries, Sequence[TimeSeries]]) – 实际系列(的序列)。

  • pred_series (Union[TimeSeries, Sequence[TimeSeries]]) – 预测序列(的序列)。

  • metric (Literal[‘AUC_ROC’, ‘AUC_PR’]) – 要使用的度量函数名称。必须是以下之一:“AUC_ROC”(接收者操作特征曲线下面积)和“AUC_PR”(从分数计算的平均精度)。默认值:“AUC_ROC”。

返回类型

Union[float, Sequence[float], Sequence[Sequence[float]]]

返回

  • float – 单个单变量 序列 的单个度量值。

  • Sequence[float] – 一个包含以下指标值的序列:

    • 一个多变量的 序列

    • 一系列单变量 序列

  • Sequence[Sequence[float]] – 一个序列的序列,表示多变量 序列 的度量值。外层序列遍历序列,内层序列遍历序列的组件/列。

fit(series)

在给定的时间序列上拟合评分器。

如果是一系列序列,评分器将基于序列的连接进行拟合。

假设 series 通常是无异常的。

参数

series (Union[TimeSeries, Sequence[TimeSeries]]) – 没有异常的(序列)系列。

返回

Fitted Scorer.

返回类型

self

fit_from_prediction(series, pred_series)

在两个(序列的)系列上拟合评分器。

传递给评分器的函数 diff_fn 会将 pred_seriesseries 转换为一个序列。默认情况下,diff_fn 将计算绝对差值(默认:ae())。如果 pred_seriesseries 是序列,diff_fn 将应用于序列中所有成对的元素。

评分器将在此(序列)系列上进行拟合。如果给定的是一个系列序列,评分器将在序列的连接上进行拟合。

评分器假设(序列的)序列是无异常的。

如果系列中的任何一个具有随机性(n_samples>1),则在分位数 0.5 上计算 diff_fn

参数
返回

Fitted Scorer.

返回类型

self

property is_probabilistic: bool

评分器是否期望将概率预测作为第一个输入。

返回类型

bool

property is_trainable: bool

评分器是否可训练。

返回类型

bool

property is_univariate: bool

Scorer 是否为单变量评分器。

返回类型

bool

score(series)

计算给定序列的异常分数。

如果给定了一系列序列,评分器将对每个序列独立评分,并返回序列中每个序列的异常分数。

参数

series (Union[TimeSeries, Sequence[TimeSeries]]) – 要从中检测异常的(序列)系列。

返回

(序列的)异常分数时间序列

返回类型

Union[TimeSeries, Sequence[TimeSeries]]

score_from_prediction(series, pred_series)

计算两个(序列)序列的异常分数。

作为评分器参数传递的函数 diff_fn ,会将 pred_seriesseries 转换为一个“差异”序列。默认情况下,diff_fn 将计算绝对差异(默认值:ae())。如果 series 和 pred_series 是序列,diff_fn 将应用于序列中所有成对元素。

评分器随后会将这一系列数据转换为异常分数。如果给定了一系列数据序列,评分器将对每个序列独立评分,并返回序列中每个数据的异常分数。

参数
返回

(序列的)异常分数时间序列

返回类型

Union[TimeSeries, Sequence[TimeSeries]]

show_anomalies(series, anomalies=None, scorer_name=None, title=None, metric=None)

绘制评分器的结果。

计算给定序列输入的分数。并绘制结果。

图表将由以下部分组成:
  • 系列本身。

  • 异常分数的分数。

  • 实际的异常,如果有的话。

可以做到:
  • 使用 title 参数为图片添加标题

  • 使用 scorer_name 为评分器指定个性化名称

  • 显示异常分数的指标结果(AUC_ROC 或 AUC_PR),

如果提供了实际的异常。

参数
  • series (TimeSeries) – 要从中可视化异常的系列。

  • anomalies (TimeSeries) – 地面真值二进制异常序列(1 表示异常,0 表示正常)。

  • scorer_name (str) – 评分者的名字。

  • title (str) – 图的标题

  • metric (Optional[Literal[‘AUC_ROC’, ‘AUC_PR’], None]) – 可选地,指定要使用的度量函数名称。必须是 “AUC_ROC”(接收者操作特征曲线下面积)或 “AUC_PR”(从分数计算的平均精度)之一。默认值:”AUC_ROC”。

show_anomalies_from_prediction(series, pred_series, scorer_name=None, anomalies=None, title=None, metric=None)

绘制评分器的结果。

计算两个序列的异常分数,并绘制结果。

图表将由以下部分组成:
  • 序列和预测序列。

  • 评分器的异常分数。

  • 实际的异常,如果有的话。

可以做到:
  • 使用 title 参数为图片添加标题

  • 使用 scorer_name 为评分器指定个性化名称

  • 如果提供了实际的异常值,显示异常评分(AUC_ROC 或 AUC_PR)的指标结果。

参数
  • series (TimeSeries) – 要从中可视化异常的实际序列。

  • pred_series (TimeSeries) – 预测的 series 系列。

  • anomalies (TimeSeries) – 异常的地面真实值(如果是异常则为1,否则为0)

  • scorer_name (str) – 评分者的名字。

  • title (str) – 图的标题

  • metric (Optional[Literal[‘AUC_ROC’, ‘AUC_PR’], None]) – 可选地,指定要使用的度量函数名称。必须是 “AUC_ROC”(接收者操作特征曲线下面积)或 “AUC_PR”(从分数计算的平均精度)之一。默认值:”AUC_ROC”。