ValueMappingEstimator 類別

定義

命名空間:

Microsoft.ML.Transforms

組件:

Microsoft.ML.Data.dll

套件:

Microsoft.ML v4.0.0-preview.24522.7

來源:

ValueMapping.cs

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

C#

public class ValueMappingEstimator : Microsoft.ML.Data.TrivialEstimator<Microsoft.ML.Transforms.ValueMappingTransformer>

繼承

Object

TrivialEstimator<ValueMappingTransformer>

ValueMappingEstimator

衍生

Microsoft.ML.Transforms.ValueMappingEstimator<TKey,TValue>

備註

估算器特性

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

假設有兩組值，一組做為索引鍵，另一組做為 Dictionary 的值，ValueMappingEstimator 會建置此字典，以便在指定特定索引鍵時傳回特定值。ValueMappingEstimator 支援不同 System.Type 的索引鍵和值，以支援不同的資料類型。 使用 ValueMappingEstimator 的範例包括：

• 將字串值轉換成字串值，這很適合用於將 (分組，也就是 'cat'、'dog'、'horse' 對應至 'cats') 。
• 將字串值轉換成整數值 (也就是將品質等文字描述轉換成數值，其中 'good' 會對應至 1，'poor' 會對應至 0。
• 將整數值轉換成字串值，並將字串值表示為 索引鍵 類型。 (亦即，將郵遞區號轉換成狀態字串值，這會產生可做為標籤的唯一整數值。

可以重複值，讓多個索引鍵對應至相同的值，但是索引鍵無法重複。 索引鍵和值之間的對應可以透過清單指定，其中索引鍵清單和值清單的大小必須相同，也可以透過 System.IDataView來完成。

如需使用範例的連結，請參閱另請參閱一節。

方法

Fit(IDataView)	使用輸入資料中的值組建立索引鍵/值對應估算器 ValueMappingTransformerPrimitiveDataViewType (繼承來源 TrivialEstimator<TTransformer>)
GetOutputSchema(SchemaShape)	傳 SchemaShape 回架構的 ，該架構將由轉換器產生。 用於管線中的架構傳播和驗證。

擴充方法

AppendCacheCheckpoint<TTrans>(IEstimator<TTrans>, IHostEnvironment)	將「快取檢查點」附加至估算器鏈結。 這可確保下游估算器會針對快取的資料定型。 在接受多個資料通過的定型器之前，先有快取檢查點會很有説明。
WithOnFitDelegate<TTransformer>(IEstimator<TTransformer>, Action<TTransformer>)	指定估算器時，傳回包裝物件，一旦 Fit(IDataView) 呼叫委派即可。 估算器通常務必傳回符合專案的相關資訊，這就是 Fit(IDataView) 方法傳回特定型別物件的原因，而不是只傳回一般 ITransformer 。 不過，同時， IEstimator<TTransformer> 通常會形成具有許多物件的管線，因此我們可能需要透過建置估算器的鏈結，而我們想要取得轉換器的估算器 EstimatorChain<TLastTransformer> 會在此鏈結的某處放置。 在該案例中，我們可以透過這個方法附加呼叫一次會呼叫的委派。

適用於

另請參閱

• MapValue(TransformsCatalog+ConversionTransforms, String, IDataView, DataViewSchema+Column, DataViewSchema+Column, String)