語言

ValueMappingEstimator 類別

定義

估計器:利用 ValueMappingTransformer 輸入資料中的值對建立鍵值映射 PrimitiveDataViewType

public class ValueMappingEstimator : Microsoft.ML.Data.TrivialEstimator<Microsoft.ML.Transforms.ValueMappingTransformer>
type ValueMappingEstimator = class
    inherit TrivialEstimator<ValueMappingTransformer>
Public Class ValueMappingEstimator
Inherits TrivialEstimator(Of ValueMappingTransformer)
繼承
衍生

備註

估算器特性

這個估計器需要查看資料來訓練參數嗎? No
輸入欄位資料型別 向量或原始數值、布林值、文字、 System.DateTime 和 鍵 型。
輸出欄位資料型態 向量或原始數值、布林值、文字、 System.DateTime 和 鍵 型。
可匯出至 ONNX No

給定兩組值,一組作為鍵值,另一組作為字典的值,ValueMappingEstimator 會建立這個字典,使得當給定特定鍵時,會回傳特定的值。ValueMappingEstimator 支援不同 System.Type 的鍵與值,以支援不同的資料型態。 使用價值映射估計器的範例包括:

  • 將字串值轉換為字串值,這對於分組非常有用(例如「貓」、「狗」、「馬」對應到「哺乳動物」)。
  • 將字串值轉換成整數值(例如將文字描述如品質轉換成數字,其中「良好」對應為1,「差」對應為0)。
  • 將整數值轉換為字串值,並將字串值以 鍵 型別表示。 (也就是將郵遞區號轉換成狀態字串值,產生一個可用作標籤的唯一整數值。

值可以重複,讓多個鍵對應到相同的值,但鍵數不能重複。 鍵與值之間的映射可以透過清單指定,其中鍵列表與值清單必須大小相同,或透過 System.IDataView 來完成。

請參考「參見」區塊,裡面有使用範例的連結。

方法

名稱 Description
Fit(IDataView)

估計器:利用 ValueMappingTransformer 輸入資料中的值對建立鍵值映射 PrimitiveDataViewType

(繼承來源 TrivialEstimator<TTransformer>)
GetOutputSchema(SchemaShape)

回傳 SchemaShape 由變壓器產生的結構結構。 用於結構傳播與管線驗證。

擴充方法

名稱 Description
AppendCacheCheckpoint<TTrans>(IEstimator<TTrans>, IHostEnvironment)

在估計鏈中附加一個「快取檢查點」。 這將確保下游估計器能針對快取資料進行訓練。 在訓練師接受多次資料通行前設置快取檢查點會很有幫助。

WithOnFitDelegate<TTransformer>(IEstimator<TTransformer>, Action<TTransformer>)

給定一個估計器,回傳一個包裹物件,該物件會呼叫一次 Fit(IDataView) 代理。 估計器通常回傳擬合的資訊很重要,因此該 Fit(IDataView) 方法回傳一個特定型別的物件,而非一般 ITransformer的 。 然而,同時, IEstimator<TTransformer> 通常會被組成包含許多物件的管線,因此我們可能需要建立一條估計鏈,將 EstimatorChain<TLastTransformer> 我們想要取得變壓器的估計器埋藏在這條鏈的某處。 在這種情況下,我們可以透過此方法附加一個代理,當 fit 被呼叫時會被呼叫。

適用於

另請參閱