PretrainedTreeFeaturizationEstimator Klasa

Definicja

Przestrzeń nazw:

Microsoft.ML.Trainers.FastTree

Zestaw:

Microsoft.ML.FastTree.dll

Pakiet:

Microsoft.ML.FastTree v2.0.0

Element IEstimator<TTransformer> zawierający wstępnie wytrenowany TreeEnsembleModelParameters i wywołujący go Fit(IDataView) tworzy cechę opartą na wstępnie wytrenowanym modelu.

public sealed class PretrainedTreeFeaturizationEstimator : Microsoft.ML.Trainers.FastTree.TreeEnsembleFeaturizationEstimatorBase

type PretrainedTreeFeaturizationEstimator = class
    inherit TreeEnsembleFeaturizationEstimatorBase

Public NotInheritable Class PretrainedTreeFeaturizationEstimator
Inherits TreeEnsembleFeaturizationEstimatorBase

Dziedziczenie

Object

TreeEnsembleFeaturizationEstimatorBase

PretrainedTreeFeaturizationEstimator

Uwagi

Kolumny wejściowe i wyjściowe

Dane kolumny etykiety wejściowej muszą byćSingle. Dane kolumn danych wejściowych muszą być znanym wektoremSingle wielkości.

Ten narzędzie do szacowania generuje następujące kolumny:

Nazwa kolumny wyjściowej	Typ kolumny	Opis
Trees	WektorSingle	Wartości wyjściowe wszystkich drzew.
Leaves	Wektor Single	Identyfikatory wszystkich liści, w których wchodzi wektor funkcji wejściowej.
Paths	Wektor Single	Ścieżki wektora funkcji wejściowej przekazywane w celu dotarcia do liści.

Te kolumny wyjściowe są opcjonalne, a użytkownik może zmienić ich nazwy. Ustaw nazwy pominiętych kolumn na null, aby nie były generowane.

Szczegóły przewidywania

Ten narzędzie do szacowania generuje kilka kolumn wyjściowych z modelu zespołu drzewa. Załóżmy, że model zawiera tylko jedno drzewo decyzyjne:

               Node 0
               /    \
             /        \
           /            \
         /                \
       Node 1            Node 2
       /    \            /    \
     /        \        /        \
   /            \     Leaf -3  Node 3
  Leaf -1      Leaf -2         /    \
                             /        \
                            Leaf -4  Leaf -5

Załóżmy, że wektor funkcji wejściowej mieści się w obiekcie Leaf -1. Dane wyjściowe Trees mogą być wektorem 1-elementowym, gdzie jedyną wartością jest wartość decyzyjna przenoszona przez Leaf -1element . Dane wyjściowe Leaves są wektorem 0–1. Jeśli osiągnięto liść jest $i$-th (indeksowany przez $-(i+1)$, więc pierwszy liść to Leaf -1) liść w drzewie, $i$-th wartość będzie Leaves wynosić 1, a wszystkie inne wartości to 0. Dane wyjściowe Paths to reprezentacja 0–1 węzłów przekazywanych przed dotarciem do liścia. Element $i$-th w Paths pliku wskazuje, czy $i$-ta węzeł (indeksowany przez $i$) jest dotykany. Na przykład osiągnięcie Leaf -1 potencjalnych klientów do wartości $[1, 1, 0, 0]$ jako .Paths Jeśli istnieje wiele drzew, ten narzędzie do szacowania po Treesprostu łączy "s", LeavesPaths"s, ze wszystkich drzew (informacje pierwszego drzewa są najpierw w połączonych wektorach).

Zapoznaj się z sekcją Zobacz również, aby uzyskać linki do przykładów użycia.

Metody

Fit(IDataView)	Utwórz element, który mapuje kolumnę TreeEnsembleModelParameters o nazwie InputColumnName w input do trzech kolumn wyjściowych. (Odziedziczone po TreeEnsembleFeaturizationEstimatorBase)
GetOutputSchema(SchemaShape)	PretrainedTreeFeaturizationEstimator Dodaje trzy kolumny wektorów zmiennoprzecinkowych do inputSchemaelementu . Biorąc pod uwagę kolumnę wektora cech, dodane kolumny są wartościami przewidywania wszystkich drzew, identyfikatorami liści, do których należy wektor funkcji, oraz ścieżkami do tych liści. (Odziedziczone po TreeEnsembleFeaturizationEstimatorBase)

Metody rozszerzania

AppendCacheCheckpoint<TTrans>(IEstimator<TTrans>, IHostEnvironment)

Dołącz "punkt kontrolny buforowania" do łańcucha narzędzia do szacowania. Zapewni to, że narzędzia do szacowania podrzędnego zostaną wytrenowane pod kątem buforowanych danych. Warto mieć punkt kontrolny buforowania, zanim trenerzy przejdą wiele danych.

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

Biorąc pod uwagę narzędzie do szacowania, zwróć obiekt opakowujący, który będzie wywoływać delegata po Fit(IDataView) wywołaniu. Często ważne jest, aby narzędzie do szacowania zwracało informacje o tym, co było odpowiednie, dlatego Fit(IDataView) metoda zwraca specjalnie wpisany obiekt, a nie tylko ogólny ITransformerelement . Jednak w tym samym czasie IEstimator<TTransformer> są często tworzone w potoki z wieloma obiektami, więc może być konieczne utworzenie łańcucha narzędzi do szacowania, za pośrednictwem EstimatorChain<TLastTransformer> którego narzędzie do szacowania, dla którego chcemy uzyskać transformator jest pochowany gdzieś w tym łańcuchu. W tym scenariuszu możemy za pomocą tej metody dołączyć delegata, który zostanie wywołany po wywołaniu dopasowania.

Zobacz też

• FeaturizeByPretrainTreeEnsemble(TransformsCatalog, PretrainedTreeFeaturizationEstimator+Options)