ValueMappingEstimator<TKey,TValue> 類別

定義

命名空間:

Microsoft.ML.Transforms

組件:

Microsoft.ML.Data.dll

套件:

Microsoft.ML v4.0.0-preview.24522.7

來源:

ValueMapping.cs

使用輸入資料中的值組建立索引鍵/值對應的估算器 ValueMappingTransformerPrimitiveDataViewType

C#

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

類型參數

TKey

指定金鑰類型。

TValue

指定值類型。

繼承

Object

TrivialEstimator<ValueMappingTransformer>

ValueMappingEstimator

ValueMappingEstimator<TKey,TValue>

備註

估算器特性

此估算器是否需要查看資料來定型其參數？	否
輸入資料行資料類型	向量或基本數值、布林值、文字、 System.DateTime 和 索引鍵 類型。
輸出資料行資料類型	向量或基本數值、布林值、文字、 System.DateTime 和 索引鍵 類型。
可匯出至 ONNX	否

假設有兩組值，一組做為索引鍵，另一組做為 Dictionary 的值，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)