Language

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

2 つの値セット (1 つはキーとして機能し、もう 1 つはディクショナリの値) を指定すると、ValueMappingEstimator はこのディクショナリを構築し、特定のキーを指定すると特定の値が返されるようにします。ValueMappingEstimator では、さまざまなデータ型をサポートするために、さまざまな System.Type のキーと値がサポートされています。 ValueMappingEstimator の使用例を次に示します。

  • 文字列値を文字列値に変換すると、グループ化に役立ちます (つまり、'cat'、'dog'、'horse' は '哺乳類' にマップされます)。
  • 文字列値を整数値に変換する (つまり、品質などのテキストの説明を、"good" が 1 にマップされる数値に変換し、"poor" は 0 にマップします。
  • 整数値を文字列値に変換し、文字列値を キー 型として表します。 (つまり、郵便番号を状態文字列値に変換すると、ラベルとして使用できる一意の整数値が生成されます。

複数のキーを同じ値にマップできるように値を繰り返すことができますが、キーを繰り返す必要はありません。 キーと値の間のマッピングは、リストを使用して指定できます。ここで、キー リストと値リストは同じサイズである必要があります。または 、System.IDataView を使用して行うことができます。

使用例へのリンクについては、「関連項目」セクションを参照してください。

メソッド

名前 説明
Fit(IDataView)

入力データ内の値のペアを使用してキーと値のマップを作成する ValueMappingTransformer の推定器 PrimitiveDataViewType

(継承元 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> を使用して、推定器のチェーンを構築する必要がある場合があります。 このシナリオでは、このメソッドを使用して、fit が呼び出されると呼び出されるデリゲートをアタッチできます。

適用対象

こちらもご覧ください