FeatureContributionCalculatingEstimator クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
FeatureContributionCalculatingTransformerのエスティメーター。 各入力ベクターのスコアに対するモデル固有の特徴ごとの貢献度を計算します。
public sealed class FeatureContributionCalculatingEstimator : Microsoft.ML.Data.TrivialEstimator<Microsoft.ML.Transforms.FeatureContributionCalculatingTransformer>
type FeatureContributionCalculatingEstimator = class
inherit TrivialEstimator<FeatureContributionCalculatingTransformer>
Public NotInheritable Class FeatureContributionCalculatingEstimator
Inherits TrivialEstimator(Of FeatureContributionCalculatingTransformer)
- 継承
-
FeatureContributionCalculatingEstimator
注釈
エスティメーターの特性
| この推定器は、パラメーターをトレーニングするためにデータを確認する必要がありますか? | No |
| 入力列のデータ型 | 既知のサイズのベクトル Single |
| 出力列のデータ型 | 既知のサイズのベクトル Single |
| ONNX にエクスポート可能 | No |
トレーニング済みのモデルを使用してデータセットをスコア付けすると、各例のスコアまたは予測が生成されます。 これらの予測を理解して説明するには、最も大きな影響を受けた特徴を調べると便利です。 このトランスフォーマーは、各例のスコアに対する特徴ごとの貢献度のモデル固有のリストを計算します。 これらのコントリビューションは、正の値 (スコアを高くする) または負の値 (スコアを低くする) にすることができます。
機能コントリビューション計算は、現在、次のモデルでサポートされています。
- 回帰:
- 二項分類:
- AveragedPerceptronTrainer
- LinearSvmTrainer
- LbfgsLogisticRegressionBinaryTrainer
- SdcaNonCalibratedBinaryTrainer
- SdcaLogisticRegressionBinaryTrainer
- SgdCalibratedTrainer
- SgdNonCalibratedTrainer
- SymbolicSgdLogisticRegressionBinaryTrainer
- GamBinaryTrainer
- FastForestBinaryTrainer
- FastTreeBinaryTrainer
- LightGbmBinaryTrainer
- ランキング:
線形モデルの場合、特定の特徴量の寄与は、特徴値の積と対応する重みの積と等しくなります。 同様に、一般化加法モデル (GAM) の場合、特徴の寄与度は、特徴値で評価された特定の特徴の図形関数と等しくなります。
ツリー ベースのモデルの場合、特徴量の貢献度の計算は、基本的に、ツリー内のどの分割が最終的なスコアに最も影響を与えているかを判断し、その影響の値を分割を決定する特徴に割り当てることで構成されます。 より正確には、特徴の寄与は、特定の特徴の決定ノードが検出されるたびに反対のサブツリーを探索することによって生成されるスコアの変化と同じです。 バイナリ機能 F1 のデシジョン ノードを持つ単一のデシジョン ツリーを使用する単純なケースを考えてみましょう。 特徴 F1 が true に等しい例を考えると、他の特徴を一定に保ちながら、特徴 F1 に対応するサブツリーを false に対応するサブツリーを選択した場合に取得したスコアを計算できます。 特定の例の特徴 F1 の寄与は、元のスコアと、特徴 F1 に対応するノードで反対の決定を行うことによって得られたスコアの差です。 このアルゴリズムは、多くのデシジョン ツリーを持つモデルに自然に拡張されます。
使用例へのリンクについては、「関連項目」セクションを参照してください。
メソッド
| 名前 | 説明 |
|---|---|
| Fit(IDataView) |
FeatureContributionCalculatingTransformerのエスティメーター。 各入力ベクターのスコアに対するモデル固有の特徴ごとの貢献度を計算します。 (継承元 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 が呼び出されると呼び出されるデリゲートをアタッチできます。 |
適用対象
こちらもご覧ください
- CalculateFeatureContribution(TransformsCatalog, ISingleFeaturePredictionTransformer<ICalculateFeatureContribution>, Int32, Int32, Boolean)
- CalculateFeatureContribution<TModelParameters,TCalibrator>(TransformsCatalog, ISingleFeaturePredictionTransformer<CalibratedModelParametersBase<TModelParameters, TCalibrator>>, Int32, Int32, Boolean)