FastForestRegressionFeaturizationEstimator Třída

Definice

A IEstimator<TTransformer> pro transformaci vstupního vektoru prvku na funkce založené na stromové struktuře.

public sealed class FastForestRegressionFeaturizationEstimator : Microsoft.ML.Trainers.FastTree.TreeEnsembleFeaturizationEstimatorBase
type FastForestRegressionFeaturizationEstimator = class
    inherit TreeEnsembleFeaturizationEstimatorBase
Public NotInheritable Class FastForestRegressionFeaturizationEstimator
Inherits TreeEnsembleFeaturizationEstimatorBase
Dědičnost
FastForestRegressionFeaturizationEstimator

Poznámky

Vstupní a výstupní sloupce

Vstupní data sloupce popisku musí být Single. Data sloupce vstupních funkcí musí být vektorem Singleznámé velikosti .

Tento estimátor vypíše následující sloupce:

Název výstupního sloupce Typ sloupce Description
Trees Vektor známé velikosti Single Výstupní hodnoty všech stromů. Jeho velikost je shodná s celkovým počtem stromů v modelu stromového souboru.
Leaves Vektor známé velikosti Single Znázornění vektoru 0-1 na ID všech listů, do kterých spadá vstupní vektor funkce. Jeho velikost je počet listů celkem v modelu stromového souboru.
Paths Vektor známé velikosti Single Znázornění vektoru 0-1 k cestám, kterými vektor vstupního prvku prošel, aby dosáhl listů. Jeho velikost je počet uzlů bez typu list v modelu souboru stromu.

Všechny tyto výstupní sloupce jsou volitelné a uživatel může změnit jejich názvy. Nastavte názvy přeskočených sloupců na hodnotu null, aby se nevygenerovaly.

Podrobnosti o predikci

Tento odhad vytvoří několik výstupních sloupců z modelu souboru stromu. Předpokládejme, že model obsahuje pouze jeden rozhodovací strom:

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

Předpokládejme, že vektor funkce vstupu spadá do Leaf -1. Výstupem Trees může být vektor s 1 prvky, kde jedinou hodnotou je rozhodovací hodnota přenášená nástrojem Leaf -1. Výstupem Leaves je vektor 0-1. Pokud je dosažený list $i$-th (indexovaný podle $-(i+1)$, takže první list je Leaf -1) list ve stromu, $i$-ta hodnota v Leaves hodnotě by byla 1 a všechny ostatní hodnoty by byly 0. Výstupem Paths je 0-1 reprezentace uzlů předaných před dosažením listu. Prvek $i$-th v Paths indikuje, jestli se dotkne $i$-ten uzel (indexovaný $i$). Například dosažení Leaf -1 potenciálního zákazníka na $[1; 1; 0; 0]$ jako Paths. Pokud existuje více stromů, tento odhadce pouze zřetězí Trees's Leaves, 's Paths' ze všech stromů (informace o prvním stromu jsou první ve zřetězených vektorech).

V části Viz také najdete odkazy na příklady použití.

Metody

Fit(IDataView)

Vytvoří , TreeEnsembleModelParameters který namapuje volaný InputColumnNameinput sloupec na tři výstupní sloupce.

(Zděděno od TreeEnsembleFeaturizationEstimatorBase)
GetOutputSchema(SchemaShape)

PretrainedTreeFeaturizationEstimator přidá tři sloupce s plovoucím vektorem do inputSchema. Vzhledem k tomu, že je sloupec vektoru funkce, přidané sloupce představují hodnoty předpovědi všech stromů, ID listů, do kterých vektor funkce spadá, a cesty k těmto listům.

(Zděděno od TreeEnsembleFeaturizationEstimatorBase)

Metody rozšíření

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

K řetězu estimátoru připojte kontrolní bod ukládání do mezipaměti. Tím se zajistí, že podřízené estimátory budou natrénovány na data uložená v mezipaměti. Je užitečné mít kontrolní bod pro ukládání do mezipaměti před školiteli, kteří mají více průchodů dat.

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

Vzhledem k estimátoru vrátí objekt obtékání, který bude volat delegáta, jakmile Fit(IDataView) je volána. Často je důležité, aby estimátor vrátil informace o tom, co bylo vhodné, což je důvod, proč Fit(IDataView) metoda vrací objekt s konkrétním typem, spíše než jen obecný ITransformerobjekt . Současně jsou však často tvořeny kanály s mnoha objekty, takže možná budeme muset vytvořit řetězec estimátorů prostřednictvím EstimatorChain<TLastTransformer> toho, IEstimator<TTransformer> kde je odhadce, pro který chceme získat transformátor, uložen někde v tomto řetězci. Pro tento scénář můžeme pomocí této metody připojit delegáta, který bude volána po zavolání fit.

Platí pro

Viz také