ValueMappingEstimator<TKey,TValue> 类

定义

命名空间:

Microsoft.ML.Transforms

程序集:

Microsoft.ML.Data.dll

包:

Microsoft.ML v2.0.0

使用输入数据中的值对创建键值映射的估算器ValueMappingTransformerPrimitiveDataViewType

public sealed class ValueMappingEstimator<TKey,TValue> : Microsoft.ML.Transforms.ValueMappingEstimator

type ValueMappingEstimator<'Key, 'Value> = class
    inherit ValueMappingEstimator

Public NotInheritable Class ValueMappingEstimator(Of TKey, TValue)
Inherits ValueMappingEstimator

类型参数

TKey

指定键类型。

TValue

指定值类型。

继承

Object

TrivialEstimator<ValueMappingTransformer>

ValueMappingEstimator

ValueMappingEstimator<TKey,TValue>

注解

估算器特征

此估算器是否需要查看数据来训练其参数？	否
输入列数据类型	矢量或基元数值、布尔值、文本、 System.DateTime 和 键 类型。
输出列数据类型	矢量或基元数值、布尔值、文本、 System.DateTime 和 键 类型。
可导出到 ONNX	否

给定两组值，一组用作键，另一组用作字典的值，ValueMappingEstimator 将生成此字典，以便在给定特定键时返回特定值。ValueMappingEstimator 支持不同 System.Type 的键和值以支持不同的数据类型。 使用 ValueMappingEstimator 的示例包括：

• 将字符串值转换为字符串值，这可用于对 (（即“cat”、“dog”、“horse”映射到“哺乳动物”) ）进行分组。
• 将字符串值转换为整数值 (，即将文本说明（如质量）转换为数字，其中“good”映射到 1，“poor”映射到 0。
• 将整数值转换为字符串值，并将字符串值表示为 键 类型。 (，即将邮政编码转换为状态字符串值，这将生成可用作标签的唯一整数值。

可以重复值以允许多个键映射到同一值，但不能重复键。 可以通过列表指定键和值之间的映射，其中键列表和值列表的大小必须相同，也可以通过 System.IDataView 完成。

有关使用示例的链接，请查看“另请参阅”部分。

方法

Fit(IDataView)	使用输入数据中的值对创建键值映射的估算器ValueMappingTransformerPrimitiveDataViewType (继承自 TrivialEstimator<TTransformer>)
GetOutputSchema(SchemaShape)	返回 SchemaShape 由转换器生成的架构。 用于管道中的架构传播和验证。 (继承自 ValueMappingEstimator)

扩展方法

AppendCacheCheckpoint<TTrans>(IEstimator<TTrans>, IHostEnvironment)	将“缓存检查点”追加到估算器链。 这将确保根据缓存的数据训练下游估算器。 在执行多个数据传递的训练器之前，拥有缓存检查点会很有帮助。
WithOnFitDelegate<TTransformer>(IEstimator<TTransformer>, Action<TTransformer>)	给定估算器后，返回一个包装对象，该对象将调用委托一次 Fit(IDataView) 。 估算器通常必须返回有关适合的内容的信息，这就是为什么 Fit(IDataView) 该方法返回特定类型化对象的原因，而不仅仅是常规 ITransformer对象。 但是，同时， IEstimator<TTransformer> 通常形成为包含许多对象的管道，因此，我们可能需要通过 EstimatorChain<TLastTransformer> 估算器链生成一个估算器链，以便将转换器埋在此链中的某个位置。 对于该方案，我们可以通过此方法附加一个委托，该委托将在调用拟合后调用。

另请参阅

• MapValue<TInputType,TOutputType>(TransformsCatalog+ConversionTransforms, String, IEnumerable<KeyValuePair<TInputType,TOutputType>>, String, Boolean)