可以建立简单基线的分类器。
警告:不建议将估算器用于新代码。估算器运行tf.compat.v1.Session-style 代码更难正确编写,并且可能出现意外行为,尤其是与 TF 2 代码结合使用时。估算器确实属于我们的兼容性保证,但不会收到除安全漏洞以外的任何修复。见迁移指南详情。
用法
tf.estimator.BaselineClassifier(
model_dir=None, n_classes=2, weight_column=None, label_vocabulary=None,
optimizer='Ftrl', config=None,
loss_reduction=tf.losses.Reduction.SUM_OVER_BATCH_SIZE
)
参数
-
model_dir
保存模型参数、图形等的目录。这也可用于将检查点从目录加载到估计器中,以继续训练先前保存的模型。 -
n_classes
标签类别的数量。默认为二分类。它必须大于 1。 注意:类标签是表示类索引的整数(即从 0 到 n_classes-1 的值)。对于任意标签值(例如字符串标签),首先转换为类索引。 -
weight_column
由tf.feature_column.numeric_column
创建的字符串或NumericColumn
定义表示权重的特征列。它将乘以示例的损失。 -
label_vocabulary
可选的字符串列表,大小为[n_classes]
,定义标签词汇。仅支持n_classes
> 2。 -
optimizer
字符串、tf.keras.optimizers.*
对象或可调用,用于创建用于训练的优化器。如果未指定,将使用Ftrl
作为默认优化器。 -
config
RunConfig
对象来配置运行时设置。 -
loss_reduction
tf.losses.Reduction
之一,除了NONE
。说明如何减少批量训练损失。默认为SUM_OVER_BATCH_SIZE
。
抛出
-
ValueError
如果n_classes
属性
-
config
-
export_savedmodel
-
model_dir
-
model_fn
返回绑定到self.params
的model_fn
。 -
params
该分类器忽略特征值,将学习预测每个标签的平均值。对于single-label 问题,这将预测标签中看到的类的概率分布。对于多标签问题,这将预测每个类别中正面示例的比例。
例子:
# Build BaselineClassifier
classifier = tf.estimator.BaselineClassifier(n_classes=3)
# Input builders
def input_fn_train:
# Returns tf.data.Dataset of (x, y) tuple where y represents label's class
# index.
pass
def input_fn_eval:
# Returns tf.data.Dataset of (x, y) tuple where y represents label's class
# index.
pass
# Fit model.
classifier.train(input_fn=input_fn_train)
# Evaluate cross entropy between the test and train labels.
loss = classifier.evaluate(input_fn=input_fn_eval)["loss"]
# predict outputs the probability distribution of the classes as seen in
# training.
predictions = classifier.predict(new_samples)
train
和 evaluate
的输入应具有以下特征,否则会出现 KeyError
:
- 如果
weight_column
不是None
,则具有key=weight_column
的特征,其值为Tensor
。
相关用法
- Python tf.estimator.BaselineEstimator用法及代码示例
- Python tf.estimator.BaselineRegressor用法及代码示例
- Python tf.estimator.BinaryClassHead用法及代码示例
- Python tf.estimator.TrainSpec用法及代码示例
- Python tf.estimator.LogisticRegressionHead用法及代码示例
- Python tf.estimator.MultiHead用法及代码示例
- Python tf.estimator.PoissonRegressionHead用法及代码示例
- Python tf.estimator.WarmStartSettings用法及代码示例
- Python tf.estimator.experimental.stop_if_lower_hook用法及代码示例
- Python tf.estimator.RunConfig用法及代码示例
- Python tf.estimator.MultiLabelHead用法及代码示例
- Python tf.estimator.experimental.stop_if_no_increase_hook用法及代码示例
- Python tf.estimator.DNNLinearCombinedEstimator用法及代码示例
- Python tf.estimator.Estimator用法及代码示例
- Python tf.estimator.experimental.LinearSDCA用法及代码示例
- Python tf.estimator.experimental.RNNClassifier用法及代码示例
- Python tf.estimator.experimental.make_early_stopping_hook用法及代码示例
- Python tf.estimator.LinearRegressor用法及代码示例
- Python tf.estimator.LinearEstimator用法及代码示例
- Python tf.estimator.DNNClassifier用法及代码示例
注:本文由纯净天空筛选整理自tensorflow.org大神的英文原创作品 tf.estimator.BaselineClassifier。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。