DateTimeFeatures#
- class DateTimeFeatures(ts_freq=None, feature_scope='minimal', manual_selection=None, keep_original_columns=False)[源代码][源代码]#
日期时间特征提取,例如,用于作为预测中的外生数据。
DateTimeFeatures 使用一个日期索引列,并生成识别例如年份、一年中的第几周、一周中的第几天等日期特征。
- 参数:
- ts_freqstr, 可选 (默认值为“day”)
限制选择的项目为那些频率低于由 ts_freq 给定的时间序列频率的项目。例如,如果提供了月度数据且 ts_freq = (“M”),则没有意义去推导出频率更高的虚拟变量,如周虚拟变量。由于 Pandas 支持的频率种类繁多(例如,Pandas 允许每4天的频率),因此必须由用户提供。与其他参数的交互:用于缩小 feature_scope 的特征选择范围,因为只考虑频率低于 ts_freq 的特征。对于手动指定的特征计算将被忽略,但如果提供了 ts_freq,当手动特征的频率高于 ts_freq 时将引发警告。仅支持以下频率:* Y - 年 * Q - 季度 * M - 月 * W - 周 * D - 日 * H - 小时 * T - 分钟 * S - 秒 * L - 毫秒
- feature_scope: str, 可选 (默认值=”minimal”)
指定您希望返回多少日历特征。例如,像季度周这样的很少使用的特征只有在 feature_scope = “comprehensive” 时才会被返回。* “minimal” * “efficient” * “comprehensive”
- manual_selection: str, 可选 (默认=None)
手动选择虚拟变量。表示法是父级的子级,用于精确表示。将忽略指定的 feature_scope,但仍会以警告形式检查指定的 ts_freq。返回的所有列均为整数类型。日期以下列格式呈现:DD-MM-YYYY。支持的值:* 无 * 年份季度
基于1的索引 1-(1月至3月), 2-(4月至6月), 3-(7月至9月), 4-(10月至12月)
- month_of_year
1-一月 1-一月, 2-二月, …, 12-十二月
week_of_year
ISO 年的第一周的基于 1 的偏移量
- day_of_year
1 月 1 日的基于 1 的偏移量是 01-01-YYYY,2 是 02-01-YYYY,依此类推。
- 季度月份
基于1的索引到每个季度的第一个月(1月、4月、7月、10月)。对于第一季度:1-1月,2-2月,3-3月
- 周季度
基于1的偏移量到季度的第一周。季度的第一/最后一周可能包含也可能不包含7天。所有其他周有7天。一周从周一开始计算。如果一个月从周一开始,那么从第一个周一到下一个周一的前七天是第一周。否则,第一周从该月的第一天到第一个周一。示例:
如果 01-01-YYYY 是星期一,第1周:星期一、星期二、星期三、星期四、星期五、星期六、星期日(07-01-YYYY)第2周:星期一(08-01-YYYY)、星期二、…、星期日 如果 01-01-YYYY 是星期四,第1周:星期四、星期五、星期六、星期日(04-01-YYYY)第2周:星期一(05-01-YYYY)、星期二、…、星期日
- 季度中的天数
基于1的索引
week_of_month
基于1的索引 1 表示该月的第一周。第一周包括该月的前7天(01-MM-YYYY 到 07-MM-YYYY)2 表示该月的第二周。第二周包括接下来的7天(08-MM-YYYY 到 14-MM-YYYY)以此类推。
day_of_month
基于1的偏移量到每个月的第一天 1是01-MM-YYYY,2是02-MM-YYYY,以此类推。
- day_of_week
0-based offset to Monday 0-星期一,1-星期二,…,6-星期日
- hour_of_week
从星期一(00:00:00+00:00)开始的0基偏移量
- 一天中的小时
从0开始的偏移量到00:00:00+00:00
- 每小时的分钟
从0开始的偏移量到00:00:00
- second_of_minute
从0开始的偏移量到00:00:00
- 秒的毫秒
从0开始的偏移量到00:00:00.0000
- is_weekend
1 表示周末,0 表示不是周末
年(无更低频率的特殊情况)。
- keep_original_columns布尔值, 可选, 默认=False
在传递给
.transform()
的 X 中保留原始列。
- 属性:
is_fitted
是否已调用
fit
。
示例
>>> from sktime.transformations.series.date import DateTimeFeatures >>> from sktime.datasets import load_airline >>> y = load_airline()
返回列
y
,year
,month_of_year
>>> transformer = DateTimeFeatures(ts_freq="M") >>> y_hat = transformer.fit_transform(y)
返回列
y
,month_of_year
>>> transformer = DateTimeFeatures(ts_freq="M", manual_selection=["month_of_year"]) >>> y_hat = transformer.fit_transform(y)
返回列 ‘y’, ‘year’, ‘quarter_of_year’, ‘month_of_year’, ‘month_of_quarter’
>>> transformer = DateTimeFeatures(ts_freq="M", feature_scope="comprehensive") >>> y_hat = transformer.fit_transform(y)
返回列 ‘y’, ‘year’, ‘quarter_of_year’, ‘month_of_year’
>>> transformer = DateTimeFeatures(ts_freq="M", feature_scope="efficient") >>> y_hat = transformer.fit_transform(y)
返回列 ‘y’, ‘year’, ‘month_of_year’
>>> transformer = DateTimeFeatures(ts_freq="M", feature_scope="minimal") >>> y_hat = transformer.fit_transform(y)
方法
检查估计器是否已被拟合。
clone
()获取具有相同超参数的对象克隆。
clone_tags
(estimator[, tag_names])从另一个估计器克隆标签作为动态覆盖。
create_test_instance
([parameter_set])如果可能,构造估计器实例。
create_test_instances_and_names
([parameter_set])创建所有测试实例的列表及其名称的列表。
fit
(X[, y])将转换器拟合到 X,可选地拟合到 y。
fit_transform
(X[, y])拟合数据,然后进行转换。
get_class_tag
(tag_name[, tag_value_default])获取类标签的值。
从类及其所有父类中获取类标签。
获取 self 的配置标志
get_fitted_params
([deep])获取拟合参数。
获取对象的参数默认值。
get_param_names
([sort])获取对象的参数名称。
get_params
([deep])获取此对象的参数值字典。
get_tag
(tag_name[, tag_value_default, ...])从估计器类获取标签值和动态标签覆盖。
get_tags
()从估计器类获取标签和动态标签覆盖。
返回估计器的测试参数设置。
inverse_transform
(X[, y])对 X 进行逆变换并返回逆变换后的版本。
检查对象是否由其他 BaseObjects 组成。
load_from_path
(serial)从文件位置加载对象。
load_from_serial
(serial)从序列化的内存容器中加载对象。
reset
()将对象重置为初始化后的干净状态。
save
([path, serialization_format])将序列化的自身保存到类字节对象或 (.zip) 文件中。
set_config
(**config_dict)将配置标志设置为给定值。
set_params
(**params)设置此对象的参数。
set_random_state
([random_state, deep, ...])为 self 设置 random_state 伪随机种子参数
set_tags
(**tag_dict)将动态标签设置为给定值。
transform
(X[, y])转换 X 并返回转换后的版本。
update
(X[, y, update_params])使用 X 更新转换器,可选地使用 y。
- classmethod get_test_params()[源代码][源代码]#
返回估计器的测试参数设置。
- 返回:
- 参数字典或字典列表,默认 = {}
创建类的测试实例的参数 每个字典都是用于构造一个“有趣的”测试实例的参数,即
MyClass(**params)
或MyClass(**params[i])
创建一个有效的测试实例。create_test_instance
使用params
中的第一个(或唯一一个)字典
- clone()[源代码]#
获取具有相同超参数的对象克隆。
克隆是一个在初始化后状态下的不同对象,没有共享引用。此函数等同于返回 self 的 sklearn.clone。
- 引发:
- 如果克隆不符合规范,由于
__init__
存在错误,将引发 RuntimeError。
- 如果克隆不符合规范,由于
注释
如果成功,值等于
type(self)(**self.get_params(deep=False))
。
- clone_tags(estimator, tag_names=None)[源代码]#
从另一个估计器克隆标签作为动态覆盖。
- 参数:
- 估计器继承自
BaseEstimator
的估计器 - 标签名称str 或 str 列表, 默认 = None
要克隆的标签名称。如果为 None,则使用估计器中的所有标签作为 tag_names。
- 估计器继承自
- 返回:
- 自我
自我引用。
注释
通过在 tag_set 中设置估计器的标签值,将对象状态更改为 self 中的动态标签。
- classmethod create_test_instance(parameter_set='default')[源代码]#
如果可能,构造估计器实例。
- 参数:
- 参数集str, 默认值为”default”
要返回的测试参数集的名称,用于测试。如果没有为某个值定义特殊参数,将返回 “default” 集。
- 返回:
- 实例使用默认参数的类实例
注释
get_test_params 可以返回字典或字典列表。此函数获取 get_test_params 返回的第一个或单个字典,并使用该字典构建对象。
- classmethod create_test_instances_and_names(parameter_set='default')[源代码]#
创建所有测试实例的列表及其名称的列表。
- 参数:
- 参数集str, 默认值为”default”
要返回的测试参数集的名称,用于测试。如果没有为某个值定义特殊参数,将返回 “default” 集。
- 返回:
- objscls 的实例列表
第 i 个实例是 cls(**cls.get_test_params()[i])
- 名称list of str, 与 objs 长度相同
第 i 个元素是测试中第 i 个 obj 实例的名称,约定为 {cls.__name__}-{i},如果存在多个实例,否则为 {cls.__name__}
- fit(X, y=None)[源代码]#
将转换器拟合到 X,可选地拟合到 y。
- 状态变化:
将状态更改为“已拟合”。
写给自己:
设置以“_”结尾的拟合模型属性,拟合属性可以通过
get_fitted_params
进行检查。将
self.is_fitted
标志设置为True
。如果
self.get_tag("remember_data")
是True
,则将 X 记忆为self._X
,并强制转换为self.get_tag("X_inner_mtype")
。
- 参数:
- X : 以
sktime
兼容数据容器格式表示的时间序列时间序列 要拟合转换的数据。
sktime
中的单个数据格式被称为 mtype 规范,每个 mtype 实现了一个抽象的 scitype。Series
类型 = 单个时间序列。pd.DataFrame
、pd.Series
或 ``np.ndarray``(1D 或 2D)Panel
类型 = 时间序列集合。pd.DataFrame
具有 2 级行MultiIndex
(实例, 时间)
,3D np.ndarray
(实例, 变量, 时间)
,list
类型的Series
pd.DataFrame
Hierarchical
类型 = 时间序列的分层集合。pd.DataFrame
带有3个或更多级别的行MultiIndex
(hierarchy_1, ..., hierarchy_n, time)
关于数据格式的更多细节,请参阅关于 mtype 的术语表。关于使用方法,请参阅转换器教程
examples/03_transformers.ipynb
- y可选,数据为 sktime 兼容的数据格式,默认=None
附加数据,例如,转换所需的标签 如果
self.get_tag("requires_y")
为True
,则必须在fit
中传递,不可选。所需格式详见类文档字符串。
- X : 以
- 返回:
- 自我估计器的拟合实例
- fit_transform(X, y=None)[源代码]#
拟合数据,然后进行转换。
将转换器拟合到 X 和 y,并返回 X 的转换版本。
- 状态变化:
将状态更改为“已拟合”。
写入自身: _is_fitted : 标志设置为 True。 _X : X, 如果 remember_data 标签为 True,则为 X 的强制复制。
在可能的情况下,可能通过引用强制转换为内部类型或与 update_data 兼容的类型。
模型属性(以“_”结尾):依赖于估计器
- 参数:
- X : 以
sktime
兼容数据容器格式表示的时间序列时间序列 要拟合转换的数据,以及要转换的数据。
sktime
中的单个数据格式被称为 mtype 规范,每个 mtype 实现了一个抽象的 scitype。Series
类型 = 单个时间序列。pd.DataFrame
、pd.Series
或 ``np.ndarray``(1D 或 2D)Panel
类型 = 时间序列集合。pd.DataFrame
具有 2 级行MultiIndex
(实例, 时间)
,3D np.ndarray
(实例, 变量, 时间)
,list
类型的Series
pd.DataFrame
Hierarchical
类型 = 时间序列的分层集合。pd.DataFrame
带有3个或更多级别的行MultiIndex
(hierarchy_1, ..., hierarchy_n, time)
关于数据格式的更多细节,请参阅关于 mtype 的术语表。关于使用方法,请参阅转换器教程
examples/03_transformers.ipynb
- y可选,数据为 sktime 兼容的数据格式,默认=None
附加数据,例如,转换所需的标签 如果
self.get_tag("requires_y")
为True
,则必须在fit
中传递,不可选。所需格式详见类文档字符串。
- X : 以
- 返回:
- X 的转换版本
- 类型取决于 X 的类型和 scitype:transform-output 标签:
- X | tf-output | 返回类型 |
|----------|————–|------------------------| | Series | Primitives | pd.DataFrame (1-row) | | Panel | Primitives | pd.DataFrame | | Series | Series | Series | | Panel | Series | Panel | | Series | Panel | Panel |
- 返回的实例对应于 X 中的实例
- 表格中未列出的组合目前不支持
- 明确地,带有示例:
- 如果 X 是 Series (例如,pd.DataFrame) 并且 transform-output 是 Series
然后返回的是一个相同m类型的单个 Series 示例:去趋势化一个单个序列
- 如果 X 是 Panel`(例如,`pd-multiindex)并且 transform-output 是 Series
- 然后返回的是与 X 具有相同实例数量的 Panel
(转换器应用于每个输入的 Series 实例)
示例:面板中的所有序列都分别进行了去趋势处理
- 如果 X 是 Series 或 Panel 并且 transform-output 是 Primitives
然后返回的是 pd.DataFrame,其行数与 X 中的实例数相同。示例:返回的第 i 行包含第 i 个序列的均值和方差。
- 如果 X 是 Series 且 transform-output 是 Panel
那么返回的是一个类型为 pd-multiindex 的 Panel 对象。示例:输出的第 i 个实例是第 i 个窗口在 X 上运行。
- classmethod get_class_tag(tag_name, tag_value_default=None)[源代码]#
获取类标签的值。
不返回在实例上定义的动态标签(通过 set_tags 或 clone_tags 设置)的信息。
- 参数:
- 标签名称str
标签值的名称。
- tag_value_default任何
如果未找到标签,则使用默认/回退值。
- 返回:
- 标签值
self 中 tag_name 标签的值。如果未找到,则返回 tag_value_default。
- classmethod get_class_tags()[源代码]#
从类及其所有父类中获取类标签。
从 _tags 类属性中检索标签:值对。不返回在实例上通过 set_tags 或 clone_tags 设置的动态标签信息。
- 返回:
- collected_tagsdict
类标签名称字典:标签值对。通过嵌套继承从 _tags 类属性中收集。
- get_config()[源代码]#
获取 self 的配置标志
- 返回:
- config_dictdict
配置名称 : 配置值对的字典。从 _config 类属性通过嵌套继承收集,然后是 _config_dynamic 对象属性的任何覆盖和新标签。
- get_fitted_params(deep=True)[源代码]#
获取拟合参数。
- 状态要求:
需要状态为“已拟合”。
- 参数:
- 深bool, 默认=True
是否返回组件的拟合参数。
如果为真,将返回此对象的参数名称 : 值的字典,包括可拟合组件的拟合参数(= BaseEstimator 值的参数)。
如果为 False,将返回一个包含参数名称 : 值的字典,但不会包含组件的拟合参数。
- 返回:
- fitted_params带有字符串键的字典
拟合参数的字典,paramname : paramvalue 键值对包括:
总是:此对象的所有拟合参数,通过 get_param_names 获取的值是该键对应的拟合参数值,属于此对象。
如果 deep=True,还包含组件参数的键/值对,组件的参数被索引为 [componentname]__[paramname],componentname 的所有参数以 paramname 及其值的形式出现。
如果 deep=True,还包含任意级别的组件递归,例如,[componentname]__[componentcomponentname]__[paramname] 等。
- classmethod get_param_defaults()[源代码]#
获取对象的参数默认值。
- 返回:
- default_dict: dict[str, Any]
键是 cls 中所有在 __init__ 中定义了默认值的参数,值是 __init__ 中定义的默认值。
- classmethod get_param_names(sort=True)[源代码]#
获取对象的参数名称。
- 参数:
- 排序bool, 默认=True
是否按字母顺序返回参数名称(True),或者按它们在类
__init__
中出现的顺序返回(False)。
- 返回:
- param_names: list[str]
cls 的参数名称列表。如果
sort=False
,则按它们在类__init__
中出现的顺序排列。如果sort=True
,则按字母顺序排列。
- get_params(deep=True)[源代码]#
获取此对象的参数值字典。
- 参数:
- 深bool, 默认=True
是否返回组件的参数。
如果为真,将返回此对象的参数名称 : 值的字典,包括组件的参数(= BaseObject 值的参数)。
如果为 False,将返回此对象的参数名称 : 值的字典,但不包括组件的参数。
- 返回:
- 参数带有字符串键的字典
参数的字典,paramname : paramvalue 键值对包括:
总是:此对象的所有参数,通过 get_param_names 获取的值是该键的参数值,此对象的值始终与构造时传递的值相同。
如果 deep=True,还包含组件参数的键/值对,组件的参数被索引为 [componentname]__[paramname],componentname 的所有参数以 paramname 及其值的形式出现。
如果 deep=True,还包含任意级别的组件递归,例如,[componentname]__[componentcomponentname]__[paramname] 等。
- get_tag(tag_name, tag_value_default=None, raise_error=True)[源代码]#
从估计器类获取标签值和动态标签覆盖。
- 参数:
- 标签名称str
要检索的标签名称
- tag_value_default任何类型,可选;默认=None
如果未找到标签,则使用默认/回退值
- raise_error布尔
当未找到标签时是否引发 ValueError
- 返回:
- 标签值任何
在 self 中 tag_name 标签的值。如果未找到,如果 raise_error 为 True,则返回错误,否则返回 tag_value_default。
- 引发:
- 如果 raise_error 为 True,即如果 tag_name 不在其中,则引发 ValueError。
- self.get_tags().keys()
- get_tags()[源代码]#
从估计器类获取标签和动态标签覆盖。
- 返回:
- collected_tagsdict
标签名称 : 标签值对的字典。通过嵌套继承从 _tags 类属性中收集,然后从 _tags_dynamic 对象属性中覆盖和新标签。
- inverse_transform(X, y=None)[源代码]#
对 X 进行逆变换并返回逆变换后的版本。
- 目前假设只有带有标签的变压器
“scitype:transform-input”=”Series”, “scitype:transform-output”=”Series”,
具有一个 inverse_transform。
- 状态要求:
需要状态为“已拟合”。
自我访问:
以“_”结尾的拟合模型属性
self.is_fitted
,必须为 True
- 参数:
- X : 以
sktime
兼容数据容器格式表示的时间序列时间序列 要拟合转换的数据。
sktime
中的单个数据格式被称为 mtype 规范,每个 mtype 实现了一个抽象的 scitype。Series
类型 = 单个时间序列。pd.DataFrame
、pd.Series
或 ``np.ndarray``(1D 或 2D)Panel
类型 = 时间序列集合。pd.DataFrame
具有 2 级行MultiIndex
(实例, 时间)
,3D np.ndarray
(实例, 变量, 时间)
,list
类型的Series
pd.DataFrame
Hierarchical
类型 = 时间序列的分层集合。pd.DataFrame
带有3个或更多级别的行MultiIndex
(hierarchy_1, ..., hierarchy_n, time)
关于数据格式的更多细节,请参阅关于 mtype 的术语表。关于使用方法,请参阅转换器教程
examples/03_transformers.ipynb
- y可选,数据为 sktime 兼容的数据格式,默认=None
附加数据,例如,转换的标签。某些转换器需要这些数据,详情请参见类文档字符串。
- X : 以
- 返回:
- X 的逆变换版本
与 X 类型相同,并符合 mtype 格式规范
- is_composite()[源代码]#
检查对象是否由其他 BaseObjects 组成。
复合对象是一个包含对象的对象,作为参数。在实例上调用,因为这可能因实例而异。
- 返回:
- composite: bool
一个对象是否有任何参数的值是 BaseObjects。
- classmethod load_from_path(serial)[源代码]#
从文件位置加载对象。
- 参数:
- 串行ZipFile(path).open(“object”) 的结果
- 返回:
- 反序列化自身,结果输出到
path
,通过cls.save(path)
- 反序列化自身,结果输出到
- classmethod load_from_serial(serial)[源代码]#
从序列化的内存容器中加载对象。
- 参数:
- serial :
cls.save(None)
输出的第一个元素输出结果的第1个元素
- serial :
- 返回:
- 反序列化自身,结果输出为
serial
,来自cls.save(None)
- 反序列化自身,结果输出为
- reset()[源代码]#
将对象重置为初始化后的干净状态。
使用 reset,使用当前的超参数值(get_params 的结果)运行 __init__。这将移除任何对象属性,除了:
超参数 = __init__ 的参数
包含双下划线的对象属性,即字符串”__”
类和对象方法,以及类属性也不受影响。
- 返回:
- 自身
将类的实例重置为干净的初始化后状态,但保留当前的超参数值。
注释
等同于 sklearn.clone,但覆盖了 self。在调用 self.reset() 之后,self 的值等于 type(self)(**self.get_params(deep=False))
- save(path=None, serialization_format='pickle')[源代码]#
将序列化的自身保存到类字节对象或 (.zip) 文件中。
行为:如果
path
为 None,则返回内存中的序列化自身;如果path
是一个文件位置,则将自身存储在该位置作为一个 zip 文件。保存的文件是包含以下内容的zip文件:_metadata - 包含自身的类,即 type(self) _obj - 序列化的自身。此类使用默认的序列化(pickle)。
- 参数:
- 路径无或文件位置(字符串或路径)
如果为 None,则将 self 保存到内存对象中;如果为文件位置,则将 self 保存到该文件位置。如果:
path=”estimator” 则会在当前工作目录(cwd)生成一个名为
estimator.zip
的压缩文件。path=”/home/stored/estimator” 则会在/home/stored/
目录下存储一个名为estimator.zip
的压缩文件。- serialization_format: str, default = “pickle”
用于序列化的模块。可用的选项是 “pickle” 和 “cloudpickle”。请注意,非默认格式可能需要安装其他软依赖项。
- 返回:
- 如果
path
为 None - 内存中序列化的 self - 如果
path
是文件位置 - 带有文件引用的 ZipFile
- 如果
- set_config(**config_dict)[源代码]#
将配置标志设置为给定值。
- 参数:
- config_dictdict
配置名称 : 配置值对的字典。有效的配置、值及其含义如下所示:
- 显示str, “diagram” (默认), 或 “text”
jupyter 内核如何显示 self 的实例
“diagram” = html 盒子图表示
“text” = 字符串打印输出
- print_changed_onlybool, 默认=True
是否仅打印与默认值不同的自身参数(False),或打印所有参数名称和值(False)。不嵌套,即仅影响自身,不影响组件估计器。
- 警告str, “on” (默认), 或 “off”
是否引发警告,仅影响来自 sktime 的警告
“on” = 将引发来自 sktime 的警告
“off” = 不会从 sktime 引发警告
- 后端:并行str, 可选, 默认=”None”
在广播/矢量化时用于并行化的后端,可以是以下之一
“None”: 按顺序执行循环,简单的列表推导
“loky”, “multiprocessing” 和 “threading”: 使用
joblib.Parallel
joblib
:自定义和第三方joblib
后端,例如spark
“dask”: 使用
dask
,需要在环境中安装dask
包
- 后端:并行:参数dict, 可选, 默认={} (未传递参数)
传递给并行化后端的附加参数作为配置。有效键取决于
backend:parallel
的值:“None”: 没有额外参数,
backend_params
被忽略“loky”, “multiprocessing” 和 “threading”: 默认的
joblib
后端 任何有效的joblib.Parallel
键都可以在这里传递,例如n_jobs
,除了backend
直接由backend
控制。如果未传递n_jobs
,它将默认为-1
,其他参数将默认为joblib
的默认值。“joblib”:自定义和第三方
joblib
后端,例如spark
。任何joblib.Parallel
的有效键都可以在这里传递,例如,n_jobs
、backend
在这种情况下必须作为backend_params
的键传递。如果未传递n_jobs
,它将默认为-1
,其他参数将默认为joblib
的默认值。dask
: 任何dask.compute
的有效键都可以传递,例如scheduler
- 输入转换str, 可以是 “on” (默认), “off”, 或有效的 mtype 字符串
控制输入检查和转换,用于
_fit
、_transform
、_inverse_transform
、_update
"on"
- 进行输入检查和转换"off"
- 在将数据传递给内部方法之前,不进行输入检查和转换有效的 mtype 字符串 - 假设输入指定了 mtype,进行转换但不做检查
- 输出转换str, 可以是 “on”, “off”, 有效的 mtype 字符串
控制
_transform
,_inverse_transform
的输出转换"on"
- 如果 input_conversion 是 “on”,则执行输出转换"off"
-_transform
和_inverse_transform
的输出直接返回有效的 mtype 字符串 - 输出被转换为指定的 mtype
- 返回:
- 自我对自身的引用。
注释
更改对象状态,将 config_dict 中的配置复制到 self._config_dynamic。
- set_params(**params)[源代码]#
设置此对象的参数。
该方法适用于简单的估计器以及复合对象。对于复合对象,即包含其他对象的对象,可以使用参数键字符串
<component>__<parameter>
来访问组件<component>
中的<parameter>
。如果这使得引用明确,例如没有两个组件的参数名称相同,也可以使用不带<component>__
的字符串<parameter>
。- 参数:
- **参数dict
BaseObject 参数,键必须是
<component>__<parameter>
字符串。如果 get_params 键中唯一,__ 后缀可以别名为完整字符串。
- 返回:
- 自我引用自身(在参数设置之后)
- set_random_state(random_state=None, deep=True, self_policy='copy')[源代码]#
为 self 设置 random_state 伪随机种子参数
通过
estimator.get_params
查找名为random_state
的参数,并通过set_params
将其设置为由random_state
派生的整数。这些整数通过sample_dependent_seed
的链哈希采样得到,并保证种子随机生成器的伪随机独立性。根据
self_policy
应用于estimator
中的random_state
参数,并且仅当deep=True
时应用于剩余的组件估计器。注意:即使
self
没有random_state
,或者没有任何组件有random_state
参数,也会调用set_params
。因此,set_random_state
将重置任何scikit-base
估计器,即使那些没有random_state
参数的估计器。- 参数:
- random_stateint, RandomState 实例或 None, 默认=None
伪随机数生成器,用于控制随机整数的生成。传递 int 以在多次函数调用中获得可重复的输出。
- 深bool, 默认=True
是否在子估计器中设置随机状态。如果为 False,则仅设置
self
的random_state
参数(如果存在)。如果为 True,则还会设置子估计器中的random_state
参数。- self_policystr, 可以是 {“copy”, “keep”, “new”} 之一, 默认值为 “copy”
“复制” :
estimator.random_state
被设置为输入的random_state
“保持” :
estimator.random_state
保持不变“new” :
estimator.random_state
被设置为一个新的随机状态,
源自输入
random_state
,并且通常与它不同
- 返回:
- 自我自我引用
- set_tags(**tag_dict)[源代码]#
将动态标签设置为给定值。
- 参数:
- **标签字典dict
标签名称:标签值对的字典。
- 返回:
- 自我
自我引用。
注释
通过在 tag_dict 中设置标签值,将对象状态更改为 self 中的动态标签。
- transform(X, y=None)[源代码]#
转换 X 并返回转换后的版本。
- 状态要求:
需要状态为“已拟合”。
自我访问:
以“_”结尾的拟合模型属性
self.is_fitted
,必须为 True
- 参数:
- X : 以
sktime
兼容数据容器格式表示的时间序列时间序列 要转换的数据。
sktime
中的单个数据格式被称为 mtype 规范,每个 mtype 实现了一个抽象的 scitype。Series
类型 = 单个时间序列。pd.DataFrame
、pd.Series
或 ``np.ndarray``(1D 或 2D)Panel
类型 = 时间序列集合。pd.DataFrame
具有 2 级行MultiIndex
(实例, 时间)
,3D np.ndarray
(实例, 变量, 时间)
,list
类型的Series
pd.DataFrame
Hierarchical
类型 = 时间序列的分层集合。pd.DataFrame
带有3个或更多级别的行MultiIndex
(hierarchy_1, ..., hierarchy_n, time)
关于数据格式的更多细节,请参阅关于 mtype 的术语表。关于使用方法,请参阅转换器教程
examples/03_transformers.ipynb
- y可选,数据为 sktime 兼容的数据格式,默认=None
附加数据,例如,转换的标签。某些转换器需要这些数据,详情请参见类文档字符串。
- X : 以
- 返回:
- X 的转换版本
- 类型取决于 X 的类型和 scitype:transform-output 标签:
transform
X
-output
返回类型
系列
基本元素
pd.DataFrame (1行)
Panel
基本元素
pd.DataFrame
系列
系列
系列
Panel
系列
Panel
系列
Panel
Panel
- 返回的实例对应于 X 中的实例
- 表格中未列出的组合目前不支持
- 明确地,带有示例:
- 如果 X 是 Series (例如,pd.DataFrame) 并且 transform-output 是 Series
然后返回的是一个相同m类型的单个 Series 示例:去趋势化一个单个序列
- 如果 X 是 Panel`(例如,`pd-multiindex)并且 transform-output 是 Series
- 然后返回的是与 X 具有相同实例数量的 Panel
(转换器应用于每个输入的 Series 实例)
示例:面板中的所有序列都分别进行了去趋势处理
- 如果 X 是 Series 或 Panel 并且 transform-output 是 Primitives
然后返回的是 pd.DataFrame,其行数与 X 中的实例数相同。示例:返回的第 i 行包含第 i 个序列的均值和方差。
- 如果 X 是 Series 且 transform-output 是 Panel
那么返回的是一个类型为 pd-multiindex 的 Panel 对象。示例:输出的第 i 个实例是第 i 个窗口在 X 上运行。
- update(X, y=None, update_params=True)[源代码]#
使用 X 更新转换器,可选地使用 y。
- 状态要求:
需要状态为“已拟合”。
自我访问:
以“_”结尾的拟合模型属性
self.is_fitted
,必须为 True
写给自己:
以“_”结尾的拟合模型属性
如果
remember_data
标签为 True,则通过update_data
将X
中的值写入self._X
。
- 参数:
- X : 以
sktime
兼容数据容器格式表示的时间序列时间序列 数据更新转换
sktime
中的单个数据格式被称为 mtype 规范,每个 mtype 实现了一个抽象的 scitype。Series
类型 = 单个时间序列。pd.DataFrame
、pd.Series
或 ``np.ndarray``(1D 或 2D)Panel
类型 = 时间序列集合。pd.DataFrame
具有 2 级行MultiIndex
(实例, 时间)
,3D np.ndarray
(实例, 变量, 时间)
,list
类型的Series
pd.DataFrame
Hierarchical
类型 = 时间序列的分层集合。pd.DataFrame
带有3个或更多级别的行MultiIndex
(hierarchy_1, ..., hierarchy_n, time)
关于数据格式的更多细节,请参阅关于 mtype 的术语表。关于使用方法,请参阅转换器教程
examples/03_transformers.ipynb
- y可选,数据为 sktime 兼容的数据格式,默认=None
附加数据,例如,转换的标签。某些转换器需要这些数据,详情请参见类文档字符串。
- X : 以
- 返回:
- 自我估计器的拟合实例