AutoMLConfig Klass
Representerar konfiguration för att skicka ett automatiserat ML-experiment i Azure Machine Learning.
Det här konfigurationsobjektet innehåller och bevarar parametrarna för att konfigurera experimentkörningen, samt de träningsdata som ska användas vid körning. Vägledning om hur du väljer dina inställningar finns i https://aka.ms/AutoMLConfig.
Skapa en AutoMLConfig.
- Arv
-
builtins.objectAutoMLConfig
Konstruktor
AutoMLConfig(task: str, path: str | None = None, iterations: int | None = None, primary_metric: str | None = None, positive_label: Any | None = None, compute_target: Any | None = None, spark_context: Any | None = None, X: Any | None = None, y: Any | None = None, sample_weight: Any | None = None, X_valid: Any | None = None, y_valid: Any | None = None, sample_weight_valid: Any | None = None, cv_splits_indices: List[List[Any]] | None = None, validation_size: float | None = None, n_cross_validations: int | str | None = None, y_min: float | None = None, y_max: float | None = None, num_classes: int | None = None, featurization: str | FeaturizationConfig = 'auto', max_cores_per_iteration: int = 1, max_concurrent_iterations: int = 1, iteration_timeout_minutes: int | None = None, mem_in_mb: int | None = None, enforce_time_on_windows: bool = True, experiment_timeout_hours: float | None = None, experiment_exit_score: float | None = None, enable_early_stopping: bool = True, blocked_models: List[str] | None = None, blacklist_models: List[str] | None = None, exclude_nan_labels: bool = True, verbosity: int = 20, enable_tf: bool = False, model_explainability: bool = True, allowed_models: List[str] | None = None, whitelist_models: List[str] | None = None, enable_onnx_compatible_models: bool = False, enable_voting_ensemble: bool = True, enable_stack_ensemble: bool | None = None, debug_log: str = 'automl.log', training_data: Any | None = None, validation_data: Any | None = None, test_data: Any | None = None, test_size: float | None = None, label_column_name: str | None = None, weight_column_name: str | None = None, cv_split_column_names: List[str] | None = None, enable_local_managed: bool = False, enable_dnn: bool | None = None, forecasting_parameters: ForecastingParameters | None = None, **kwargs: Any)
Parametrar
Name | Description |
---|---|
task
Obligatorisk
|
Den typ av uppgift som ska köras. Värdena kan vara "klassificering", "regression" eller "prognostisering" beroende på vilken typ av automatiserat ML-problem som ska lösas. |
path
Obligatorisk
|
Den fullständiga sökvägen till Azure Machine Learning-projektmappen. Om det inte anges är standardvärdet att använda den aktuella katalogen eller ".". |
iterations
Obligatorisk
|
Det totala antalet olika kombinationer av algoritmer och parametrar som ska testas under ett automatiserat ML-experiment. Om inget anges är standardvärdet 1 000 iterationer. |
primary_metric
Obligatorisk
|
Måttet som Automatiserad maskininlärning optimerar för modellval. Automatiserad maskininlärning samlar in fler mått än vad som kan optimeras. Du kan använda get_primary_metrics för att hämta en lista över giltiga mått för din angivna uppgift. Mer information om hur mått beräknas finns i https://docs.microsoft.com/azure/machine-learning/how-to-configure-auto-train#primary-metric. Om det inte anges används noggrannhet för klassificeringsuppgifter, normaliserat rotmedelvärde i kvadrat används för prognostiserings- och regressionsaktiviteter, precision används för bildklassificering och klassificering av flera etiketter och genomsnittlig genomsnittlig precision används för identifiering av bildobjekt. |
positive_label
Obligatorisk
|
Den positiva klassetiketten som automatiserad maskininlärning använder för att beräkna binära mått med. Binära mått beräknas i två villkor för klassificeringsuppgifter:
Mer information om klassificering finns i kassamått för klassificeringsscenarier. |
compute_target
Obligatorisk
|
Azure Machine Learning-beräkningsmålet för att köra experimentet Automatiserad maskininlärning på. Mer https://docs.microsoft.com/en-us/azure/machine-learning/concept-automated-ml#local-remote information om beräkningsmål finns i . |
spark_context
Obligatorisk
|
<xref:SparkContext>
Spark-kontexten. Gäller endast när det används i Azure Databricks/Spark-miljön. |
X
Obligatorisk
|
Träningsfunktionerna som ska användas vid montering av pipelines under ett experiment. Den här inställningen håller på att bli inaktuell. Använd training_data och label_column_name i stället. |
y
Obligatorisk
|
Träningsetiketterna som ska användas vid montering av pipelines under ett experiment. Det här är det värde som din modell kommer att förutsäga. Den här inställningen håller på att bli inaktuell. Använd training_data och label_column_name i stället. |
sample_weight
Obligatorisk
|
Vikten för varje träningsexempel när du kör passande pipelines, varje rad bör motsvara en rad i X- och y-data. Ange den här parametern när du |
X_valid
Obligatorisk
|
Valideringsfunktioner som ska användas vid montering av pipelines under ett experiment. Om detta anges |
y_valid
Obligatorisk
|
Valideringsetiketter som ska användas vid montering av pipelines under ett experiment. Både |
sample_weight_valid
Obligatorisk
|
Vikten för varje valideringsexempel när du kör bedömningspipelines bör varje rad motsvara en rad i X- och y-data. Ange den här parametern när du |
cv_splits_indices
Obligatorisk
|
Index där träningsdata ska delas upp för korsvalidering. Varje rad är en separat korsvikt och inom varje korsmapp ger du 2 numpy-matriser, den första med indexen för exempel som ska användas för träningsdata och den andra med indexen som ska användas för valideringsdata. dvs. [[t1, v1], [t2, v2], ...] där t1 är träningsindexen för den första korsvikten och v1 är valideringsindexen för det första korsdelegeringet. Om du vill ange befintliga data som valideringsdata använder du |
validation_size
Obligatorisk
|
Vilken del av data som ska lagras för validering när användarvalideringsdata inte har angetts. Detta bör vara mellan 0.0 och 1.0 icke-inkluderande. Ange Mer information finns i Konfigurera datadelningar och korsvalidering i automatiserad maskininlärning. |
n_cross_validations
Obligatorisk
|
Hur många korsvalideringar som ska utföras när användarverifieringsdata inte har angetts. Ange Mer information finns i Konfigurera datadelningar och korsvalidering i automatiserad maskininlärning. |
y_min
Obligatorisk
|
Minsta värde på y för ett regressionsexperiment. Kombinationen av |
y_max
Obligatorisk
|
Maximalt värde på y för ett regressionsexperiment. Kombinationen av |
num_classes
Obligatorisk
|
Antalet klasser i etikettdata för ett klassificeringsexperiment. Den här inställningen håller på att bli inaktuell. I stället beräknas det här värdet från data. |
featurization
Obligatorisk
|
str eller
FeaturizationConfig
"auto" / "off" / FeaturizationConfig Indicator för huruvida funktionaliseringssteget ska göras automatiskt eller inte, eller om anpassad funktionalisering ska användas. Obs! Om indata är glesa går det inte att aktivera funktionalisering. Kolumntypen identifieras automatiskt. Baserat på den identifierade kolumntypen utförs förbearbetning/funktionalisering på följande sätt:
Mer information finns i artikeln Konfigurera automatiserade ML-experiment i Python. Om du vill anpassa funktionaliseringssteget anger du ett FeaturizationConfig-objekt. Anpassad funktionalisering stöder för närvarande blockering av en uppsättning transformatorer, uppdatering av kolumnsyfte, redigering av transformeringsparametrar och släppning av kolumner. Mer information finns i Anpassa funktionsteknik. Obs! Tidsseriefunktioner hanteras separat när aktivitetstypen är inställd på prognostisering oberoende av den här parametern. |
max_cores_per_iteration
Obligatorisk
|
Det maximala antalet trådar som ska användas för en viss tränings iteration. Godtagbara värden:
|
max_concurrent_iterations
Obligatorisk
|
Representerar det maximala antalet iterationer som skulle köras parallellt. Standardvärdet är 1.
|
iteration_timeout_minutes
Obligatorisk
|
Maximal tid i minuter som varje iteration kan köras för innan den avslutas. Om inget anges används värdet 1 månad eller 4 3200 minuter. |
mem_in_mb
Obligatorisk
|
Maximal minnesanvändning som varje iteration kan köras för innan den avslutas. Om det inte anges används värdet 1 PB eller 1073741824 MB. |
enforce_time_on_windows
Obligatorisk
|
Om du vill framtvinga en tidsgräns för modellträning vid varje iteration i Windows. Standardvärdet är Sant. Om du kör från en Python-skriptfil (.py) läser du dokumentationen för att tillåta resursbegränsningar i Windows. |
experiment_timeout_hours
Obligatorisk
|
Maximal tid i timmar som alla iterationer tillsammans kan ta innan experimentet avslutas. Kan vara ett decimalvärde som 0,25 som representerar 15 minuter. Om det inte anges är standardtidsgränsen för experimentet 6 dagar. Om du vill ange en tidsgräns som är mindre än eller lika med 1 timme kontrollerar du att datauppsättningens storlek inte är större än 10 000 000 (kolumnen rader gånger) eller ett felresultat. |
experiment_exit_score
Obligatorisk
|
Målpoäng för experiment. Experimentet avslutas när den här poängen har uppnåtts. Om det inte anges (inga kriterier) körs experimentet tills inga ytterligare framsteg har gjorts för det primära måttet. Mer information om avslutsvillkor finns i den här artikeln. |
enable_early_stopping
Obligatorisk
|
Om du vill aktivera tidig uppsägning om poängen inte förbättras på kort sikt. Standardvärdet är Sant. Tidig stopplogik:
|
blocked_models
Obligatorisk
|
list(str) eller
list(Classification) <xref:for classification task> eller
list(Regression) <xref:for regression task> eller
list(Forecasting) <xref:for forecasting task>
En lista över algoritmer som ska ignoreras för ett experiment. Om |
blacklist_models
Obligatorisk
|
list(str) eller
list(Classification) <xref:for classification task> eller
list(Regression) <xref:for regression task> eller
list(Forecasting) <xref:for forecasting task>
Inaktuell parameter använder du blocked_models i stället. |
exclude_nan_labels
Obligatorisk
|
Om rader med NaN-värden ska undantas i etiketten. Standardvärdet är Sant. |
verbosity
Obligatorisk
|
Utförlighetsnivån för att skriva till loggfilen. Standardvärdet är INFO eller 20. Godkända värden definieras i Python-loggningsbiblioteket. |
enable_tf
Obligatorisk
|
Inaktuell parameter för att aktivera/inaktivera Tensorflow-algoritmer. Standardvärdet är Falskt. |
model_explainability
Obligatorisk
|
Om du vill aktivera förklaring av den bästa AutoML-modellen i slutet av alla AutoML-tränings iterationer. Standardvärdet är Sant. Mer information finns i Tolka: modellförklaringar i automatiserad maskininlärning. |
allowed_models
Obligatorisk
|
list(str) eller
list(Classification) <xref:for classification task> eller
list(Regression) <xref:for regression task> eller
list(Forecasting) <xref:for forecasting task>
En lista över modellnamn för att söka efter ett experiment. Om inte anges används alla modeller som stöds för uppgiften minus alla angivna i |
whitelist_models
Obligatorisk
|
list(str) eller
list(Classification) <xref:for classification task> eller
list(Regression) <xref:for regression task> eller
list(Forecasting) <xref:for forecasting task>
Inaktuell parameter använder du allowed_models i stället. |
enable_onnx_compatible_models
Obligatorisk
|
Om du vill aktivera eller inaktivera framtvingande av ONNX-kompatibla modeller. Standardvärdet är Falskt. Mer information om Open Neural Network Exchange (ONNX) och Azure Machine Learning finns i den här artikeln. |
forecasting_parameters
Obligatorisk
|
Ett ForecastingParameters-objekt som innehåller alla prognostiseringsspecifika parametrar. |
time_column_name
Obligatorisk
|
Namnet på tidskolumnen. Den här parametern krävs vid prognostisering för att ange kolumnen datetime i indata som används för att skapa tidsserier och härleda dess frekvens. Den här inställningen håller på att bli inaktuell. Använd forecasting_parameters i stället. |
max_horizon
Obligatorisk
|
Önskad maximal prognoshorisont i tidsseriefrekvensenheter. Standardvärdet är 1. Enheterna baseras på tidsintervallet för dina träningsdata, t.ex. varje månad, varje vecka som prognosmakaren bör förutsäga. När aktivitetstypen prognostiseras krävs den här parametern. Mer information om hur du ställer in prognosparametrar finns i Auto-train a time-series forecast model (Träna en prognosmodell för tidsserier automatiskt). Den här inställningen håller på att bli inaktuell. Använd forecasting_parameters i stället. |
grain_column_names
Obligatorisk
|
Namnen på kolumner som används för att gruppera en tidsserie. Den kan användas för att skapa flera serier. Om kornighet inte har definierats antas datauppsättningen vara en tidsserie. Den här parametern används med aktivitetstypsprognoser. Den här inställningen håller på att bli inaktuell. Använd forecasting_parameters i stället. |
target_lags
Obligatorisk
|
Antalet tidigare perioder som ska släpas från målkolumnen. Standard är 1. Den här inställningen håller på att bli inaktuell. Använd forecasting_parameters i stället. Vid prognostisering representerar den här parametern antalet rader som ska fördröja målvärdena baserat på datafrekvensen. Detta representeras som en lista eller ett heltal. Fördröjning bör användas när relationen mellan de oberoende variablerna och den beroende variabeln inte matchar eller korrelerar som standard. När du till exempel försöker prognostisera efterfrågan på en produkt kan efterfrågan under en månad bero på priset på specifika råvaror 3 månader tidigare. I det här exemplet kanske du vill fördröja målet (efterfrågan) negativt med 3 månader så att modellen tränar på rätt relation. Mer information finns i Auto-train a time-series forecast model (Träna en tidsserieprognosmodell automatiskt). |
feature_lags
Obligatorisk
|
Flagga för att generera fördröjningar för de numeriska funktionerna. Den här inställningen håller på att bli inaktuell. Använd forecasting_parameters i stället. |
target_rolling_window_size
Obligatorisk
|
Antalet tidigare perioder som används för att skapa ett medelvärde för rullande fönster för målkolumnen. Den här inställningen håller på att bli inaktuell. Använd forecasting_parameters i stället. Vid prognostisering representerar den här parametern n historiska perioder som ska användas för att generera prognostiserade värden, <= träningsuppsättningens storlek. Om det utelämnas är n den fullständiga träningsuppsättningens storlek. Ange den här parametern när du bara vill överväga en viss mängd historik när du tränar modellen. |
country_or_region
Obligatorisk
|
Det land/den region som används för att generera semesterfunktioner. Dessa bör vara iso 3166 tvåbokstavs lands-/regionkod, till exempel "USA" eller "GB". Den här inställningen håller på att bli inaktuell. Använd forecasting_parameters i stället. |
use_stl
Obligatorisk
|
Konfigurera STL-nedbrytning av tidsseriemålkolumnen. use_stl kan ta tre värden: Ingen (standard) – ingen stl-nedbrytning, "säsong" – genererar bara säsongskomponent och season_trend – genererar både säsongs- och trendkomponenter. Den här inställningen håller på att bli inaktuell. Använd forecasting_parameters i stället. |
seasonality
Obligatorisk
|
Ange säsongsvariationer för tidsserier. Om säsongsvariationen är inställd på "auto" kommer den att härledas. Den här inställningen är inaktuell. Använd forecasting_parameters i stället. |
short_series_handling_configuration
Obligatorisk
|
Parametern som definierar hur AutoML ska hantera korta tidsserier. Möjliga värden: "auto" (standard), "pad", "drop" och None.
Datum numeric_value sträng Mål 2020-01-01 23 green 55 Utdata som förutsätter att det minsta antalet värden är fyra: Datum numeric_value sträng Mål 2019-12-29 0 NA 55.1 2019-12-30 0 NA 55.6 2019-12-31 0 NA 54.5 2020-01-01 23 green 55 Observera: Vi har två parametrar short_series_handling_configuration och äldre short_series_handling. När båda parametrarna anges synkroniseras de enligt tabellen nedan (short_series_handling_configuration och short_series_handling för korthet markeras som handling_configuration respektive hantering). Hantering handling_configuration resulterande hantering resulterande handling_configuration Sant auto Sant auto Sant Pad Sant auto Sant drop Sant auto Sant Ingen Falskt Ingen Falskt auto Falskt Ingen Falskt Pad Falskt Ingen Falskt drop Falskt Ingen Falskt Ingen Falskt Ingen |
freq
Obligatorisk
|
Prognosfrekvens. Vid prognostisering representerar den här parametern den period med vilken prognosen önskas, till exempel dagligen, varje vecka, varje år osv. Prognosfrekvensen är datamängdsfrekvens som standard. Du kan också ställa in den på större (men inte mindre) än datauppsättningsfrekvensen. Vi aggregerar data och genererar resultaten med prognostiseringsfrekvens. För dagliga data kan du till exempel ange att frekvensen ska vara dagligen, varje vecka eller varje månad, men inte varje timme. Frekvensen måste vara ett Pandas-offsetalias. Mer information finns i Pandas-dokumentationen: https://pandas.pydata.org/pandas-docs/stable/user_guide/timeseries.html#dateoffset-objects |
target_aggregation_function
Obligatorisk
|
Funktionen som ska användas för att aggregera målkolumnen för tidsserier så att den överensstämmer med en användardefinieringsfrekvens. Om target_aggregation_function har angetts, men freq-parametern inte har angetts, utlöses felet. Möjliga målaggregeringsfunktioner är: "sum", "max", "min" och "mean". Freq target_aggregation_function Mekanism för korrigering av dataregelbundna data Ingen (standard) Ingen (standard) Aggregeringen tillämpas inte. Om den giltiga frekvensen inte kan fastställas utlöses felet. Värde Ingen (standard) Aggregeringen tillämpas inte. Om antalet datapunkter som är kompatibla med det angivna frekvensrutnätet är mindre kommer 90 % av dessa punkter att tas bort, annars utlöses felet. Ingen (standard) Sammansättningsfunktion Felet om saknade frekvensparametrar utlöses. Värde Sammansättningsfunktion Aggregera till frekvens med hjälp av den tillhandahållna aggregeringsfunktionen. |
enable_voting_ensemble
Obligatorisk
|
Om du vill aktivera/inaktivera VotingEnsemble-iteration. Standardvärdet är True. Mer information om ensembler finns i Ensemblekonfiguration. |
enable_stack_ensemble
Obligatorisk
|
Om stackEnsemble-iteration ska aktiveras/inaktiveras. Standardvärdet är Ingen. Om enable_onnx_compatible_models flagga anges inaktiveras StackEnsemble-iteration. På samma sätt inaktiveras StackEnsemble-iteration som standard för Timeseries-uppgifter för att undvika risker med överanpassning på grund av små träningsuppsättningar som används för att passa metaläraren. Mer information om ensembler finns i Ensemblekonfiguration. |
debug_log
Obligatorisk
|
Loggfilen som felsökningsinformationen ska skrivas till. Om inget anges används "automl.log". |
training_data
Obligatorisk
|
Träningsdata som ska användas i experimentet.
Den bör innehålla både träningsfunktioner och en etikettkolumn (valfritt en exempelviktkolumn).
Om
|
validation_data
Obligatorisk
|
Valideringsdata som ska användas i experimentet.
Den bör innehålla både träningsfunktioner och etikettkolumn (om du vill kan du välja en exempelviktkolumn).
Om
|
test_data
Obligatorisk
|
Dataset eller
TabularDataset
Funktionen Modelltest med hjälp av testdatamängder eller delningar av testdata är en funktion i förhandsversionstillstånd och kan ändras när som helst. Testdata som ska användas för en testkörning som startas automatiskt när modellträningen är klar. Testkörningen får förutsägelser med den bästa modellen och beräknar mått baserat på dessa förutsägelser. Om den här parametern eller parametern inte anges körs ingen testkörning automatiskt när modellträningen |
test_size
Obligatorisk
|
Funktionen Modelltest med hjälp av testdatamängder eller delningar av testdata är en funktion i förhandsversionstillstånd och kan ändras när som helst. Vilken del av träningsdata som ska lagras för testdata för en testkörning som startas automatiskt när modellträningen är klar. Testkörningen får förutsägelser med den bästa modellen och beräknar mått baserat på dessa förutsägelser. Detta bör vara mellan 0.0 och 1.0 icke-inkluderande.
Om För regressionsbaserade uppgifter används slumpmässig sampling. För klassificeringsuppgifter används stratifierad sampling. Prognostisering stöder för närvarande inte att ange en testdatauppsättning med hjälp av en tränings-/testdelning. Om den här parametern eller parametern inte anges körs ingen testkörning automatiskt när modellträningen |
label_column_name
Obligatorisk
|
Namnet på etikettkolumnen. Om indata kommer från en Pandas. DataFrame som inte har kolumnnamn, kolumnindex kan användas i stället, uttryckt som heltal. Den här parametern gäller för |
weight_column_name
Obligatorisk
|
Namnet på exempelviktkolumnen. Automatiserad ML stöder en viktad kolumn som indata, vilket gör att rader i data viktas upp eller ned. Om indata kommer från en Pandas. DataFrame som inte har kolumnnamn, kolumnindex kan användas i stället, uttryckt som heltal. Den här parametern gäller för |
cv_split_column_names
Obligatorisk
|
Lista över namnen på kolumnerna som innehåller anpassad korsvalideringsdelning. Var och en av DE DELADE CV-kolumnerna representerar en CV-delning där varje rad antingen är markerad 1 för träning eller 0 för validering. Den här parametern gäller för Använd antingen Mer information finns i Konfigurera datadelningar och korsvalidering i automatiserad maskininlärning. |
enable_local_managed
Obligatorisk
|
Inaktiverad parameter. Lokala hanterade körningar kan inte aktiveras just nu. |
enable_dnn
Obligatorisk
|
Om DNN-baserade modeller ska inkluderas under modellval. Standardvärdet i init är Ingen. Standardvärdet är dock Sant för DNN NLP-uppgifter och är Falskt för alla andra AutoML-uppgifter. |
task
Obligatorisk
|
Den typ av uppgift som ska köras. Värdena kan vara "klassificering", "regression" eller "prognostisering" beroende på vilken typ av automatiserat ML-problem som ska lösas. |
path
Obligatorisk
|
Den fullständiga sökvägen till projektmappen för Azure Machine Learning. Om inget anges är standardvärdet att använda den aktuella katalogen eller ".". |
iterations
Obligatorisk
|
Det totala antalet olika kombinationer av algoritmer och parametrar som ska testas under ett automatiserat ML-experiment. Om inget anges är standardvärdet 1 000 iterationer. |
primary_metric
Obligatorisk
|
Det mått som automatiserad maskininlärning optimerar för modellval. Automatiserad maskininlärning samlar in fler mått än vad som kan optimeras. Du kan använda get_primary_metrics för att hämta en lista över giltiga mått för din uppgift. Mer information om hur mått beräknas finns i https://docs.microsoft.com/azure/machine-learning/how-to-configure-auto-train#primary-metric. Om det inte anges används noggrannhet för klassificeringsuppgifter, normaliserat rotmedelvärde i kvadrat används för prognostiserings- och regressionsaktiviteter, noggrannhet används för bildklassificering och klassificering av flera etiketter och genomsnittlig genomsnittlig precision används för identifiering av bildobjekt. |
positive_label
Obligatorisk
|
Den positiva klassetiketten som automatiserad maskininlärning använder för att beräkna binära mått med. Binära mått beräknas i två villkor för klassificeringsuppgifter:
Mer information om klassificering finns i utcheckningsmått för klassificeringsscenarier. |
compute_target
Obligatorisk
|
Beräkningsmålet för Azure Machine Learning som automatiserat machine learning-experiment ska köras på. Mer https://docs.microsoft.com/azure/machine-learning/how-to-auto-train-remote information om beräkningsmål finns i. |
spark_context
Obligatorisk
|
<xref:SparkContext>
Spark-kontexten. Gäller endast när det används i Azure Databricks/Spark-miljön. |
X
Obligatorisk
|
Träningsfunktionerna som ska användas vid montering av pipelines under ett experiment. Den här inställningen är inaktuell. Använd training_data och label_column_name i stället. |
y
Obligatorisk
|
Träningsetiketterna som ska användas vid montering av pipelines under ett experiment. Det här är det värde som din modell förutsäger. Den här inställningen är inaktuell. Använd training_data och label_column_name i stället. |
sample_weight
Obligatorisk
|
Vikten för varje träningsexempel när du kör passande pipelines, varje rad bör motsvara en rad i X- och y-data. Ange den här parametern när du |
X_valid
Obligatorisk
|
Valideringsfunktioner som ska användas vid montering av pipelines under ett experiment. Om detta anges |
y_valid
Obligatorisk
|
Valideringsetiketter som ska användas vid montering av pipelines under ett experiment. Både |
sample_weight_valid
Obligatorisk
|
Vikten för varje valideringsexempel vid körning av bedömningspipelines bör varje rad motsvara en rad i X- och y-data. Ange den här parametern när du |
cv_splits_indices
Obligatorisk
|
Index där träningsdata ska delas upp för korsvalidering. Varje rad är en separat korsvikt och inom varje korsmapp ger du 2 numpy-matriser, den första med indexen för exempel som ska användas för träningsdata och den andra med indexen som ska användas för valideringsdata. dvs. [[t1, v1], [t2, v2], ...] där t1 är träningsindexen för den första korsvikten och v1 är valideringsindexen för det första korsdelegeringet. Det här alternativet stöds när data skickas som separata datauppsättningar för funktioner och kolumnen Etikett. Om du vill ange befintliga data som valideringsdata använder du |
validation_size
Obligatorisk
|
Vilken del av data som ska lagras för validering när användarvalideringsdata inte har angetts. Detta bör vara mellan 0.0 och 1.0 icke-inkluderande. Ange Mer information finns i Konfigurera datadelningar och korsvalidering i automatiserad maskininlärning. |
n_cross_validations
Obligatorisk
|
Hur många korsvalideringar som ska utföras när användarverifieringsdata inte har angetts. Ange Mer information finns i Konfigurera datadelningar och korsvalidering i automatiserad maskininlärning. |
y_min
Obligatorisk
|
Minsta värde på y för ett regressionsexperiment. Kombinationen av |
y_max
Obligatorisk
|
Maximalt värde på y för ett regressionsexperiment. Kombinationen av |
num_classes
Obligatorisk
|
Antalet klasser i etikettdata för ett klassificeringsexperiment. Den här inställningen håller på att bli inaktuell. I stället beräknas det här värdet från data. |
featurization
Obligatorisk
|
str eller
FeaturizationConfig
"auto" / "off" / FeaturizationConfig Indicator för huruvida funktionaliseringssteget ska göras automatiskt eller inte, eller om anpassad funktionalisering ska användas. Obs! Om indata är glesa går det inte att aktivera funktionalisering. Kolumntypen identifieras automatiskt. Baserat på den identifierade kolumntypen utförs förbearbetning/funktionalisering på följande sätt:
Mer information finns i artikeln Konfigurera automatiserade ML-experiment i Python. Om du vill anpassa funktionaliseringssteget anger du ett FeaturizationConfig-objekt. Anpassad funktionalisering stöder för närvarande blockering av en uppsättning transformatorer, uppdatering av kolumnsyfte, redigering av transformeringsparametrar och släppning av kolumner. Mer information finns i Anpassa funktionsteknik. Obs! Tidsseriefunktioner hanteras separat när aktivitetstypen är inställd på prognostisering oberoende av den här parametern. |
max_cores_per_iteration
Obligatorisk
|
Det maximala antalet trådar som ska användas för en viss tränings iteration. Godtagbara värden:
|
max_concurrent_iterations
Obligatorisk
|
Representerar det maximala antalet iterationer som skulle köras parallellt. Standardvärdet är 1.
|
iteration_timeout_minutes
Obligatorisk
|
Maximal tid i minuter som varje iteration kan köras för innan den avslutas. Om inget anges används värdet 1 månad eller 4 3200 minuter. |
mem_in_mb
Obligatorisk
|
Maximal minnesanvändning som varje iteration kan köras för innan den avslutas. Om det inte anges används värdet 1 PB eller 1073741824 MB. |
enforce_time_on_windows
Obligatorisk
|
Om du vill framtvinga en tidsgräns för modellträning vid varje iteration i Windows. Standardvärdet är Sant. Om du kör från en Python-skriptfil (.py) läser du dokumentationen för att tillåta resursbegränsningar i Windows. |
experiment_timeout_hours
Obligatorisk
|
Maximal tid i timmar som alla iterationer tillsammans kan ta innan experimentet avslutas. Kan vara ett decimalvärde som 0,25 som representerar 15 minuter. Om det inte anges är standardtidsgränsen för experimentet 6 dagar. Om du vill ange en tidsgräns som är mindre än eller lika med 1 timme kontrollerar du att datauppsättningens storlek inte är större än 10 000 000 (kolumnen rader gånger) eller ett felresultat. |
experiment_exit_score
Obligatorisk
|
Målpoäng för experiment. Experimentet avslutas när den här poängen har uppnåtts.
Om det inte anges (inga kriterier) körs experimentet tills inga ytterligare framsteg har gjorts för det primära måttet. Mer information om avslutsvillkor finns i det här >> |
enable_early_stopping
Obligatorisk
|
Om du vill aktivera tidig uppsägning om poängen inte förbättras på kort sikt. Standardvärdet är Sant. Tidig stopplogik:
|
blocked_models
Obligatorisk
|
list(str) eller
list(Classification) <xref:for classification task> eller
list(Regression) <xref:for regression task> eller
list(Forecasting) <xref:for forecasting task>
En lista över algoritmer som ska ignoreras för ett experiment. Om |
blacklist_models
Obligatorisk
|
list(str) eller
list(Classification) <xref:for classification task> eller
list(Regression) <xref:for regression task> eller
list(Forecasting) <xref:for forecasting task>
Inaktuell parameter använder du blocked_models i stället. |
exclude_nan_labels
Obligatorisk
|
Om rader med NaN-värden ska undantas i etiketten. Standardvärdet är Sant. |
verbosity
Obligatorisk
|
Utförlighetsnivån för att skriva till loggfilen. Standardvärdet är INFO eller 20. Godkända värden definieras i Python-loggningsbiblioteket. |
enable_tf
Obligatorisk
|
Om TensorFlow-algoritmer ska aktiveras/inaktiveras. Standardvärdet är Falskt. |
model_explainability
Obligatorisk
|
Om du vill aktivera förklaring av den bästa AutoML-modellen i slutet av alla AutoML-tränings iterationer. Standardvärdet är Sant. Mer information finns i Tolka: modellförklaringar i automatiserad maskininlärning. |
allowed_models
Obligatorisk
|
list(str) eller
list(Classification) <xref:for classification task> eller
list(Regression) <xref:for regression task> eller
list(Forecasting) <xref:for forecasting task>
En lista över modellnamn för att söka efter ett experiment. Om inte anges används alla modeller som stöds för uppgiften minus alla angivna i |
allowed_models
Obligatorisk
|
En lista över modellnamn för att söka efter ett experiment. Om inte anges används alla modeller som stöds för uppgiften minus alla angivna i |
whitelist_models
Obligatorisk
|
Inaktuell parameter använder du allowed_models i stället. |
enable_onnx_compatible_models
Obligatorisk
|
Om du vill aktivera eller inaktivera framtvingande av ONNX-kompatibla modeller. Standardvärdet är Falskt. Mer information om Open Neural Network Exchange (ONNX) och Azure Machine Learning finns i den här artikeln. |
forecasting_parameters
Obligatorisk
|
Ett objekt som innehåller alla prognostiseringsspecifika parametrar. |
time_column_name
Obligatorisk
|
Namnet på tidskolumnen. Den här parametern krävs vid prognostisering för att ange kolumnen datetime i indata som används för att skapa tidsserier och härleda dess frekvens. Den här inställningen håller på att bli inaktuell. Använd forecasting_parameters i stället. |
max_horizon
Obligatorisk
|
Önskad maximal prognoshorisont i tidsseriefrekvensenheter. Standardvärdet är 1. Den här inställningen håller på att bli inaktuell. Använd forecasting_parameters i stället. Enheterna baseras på tidsintervallet för dina träningsdata, t.ex. varje månad, varje vecka som prognosmakaren bör förutsäga. När aktivitetstypen prognostiseras krävs den här parametern. Mer information om hur du ställer in prognosparametrar finns i Auto-train a time-series forecast model (Träna en prognosmodell för tidsserier automatiskt). |
grain_column_names
Obligatorisk
|
Namnen på kolumner som används för att gruppera en tidsserie. Den kan användas för att skapa flera serier. Om kornighet inte har definierats antas datauppsättningen vara en tidsserie. Den här parametern används med aktivitetstypsprognoser. Den här inställningen håller på att bli inaktuell. Använd forecasting_parameters i stället. |
target_lags
Obligatorisk
|
Antalet tidigare perioder som ska släpas från målkolumnen. Standard är 1. Den här inställningen håller på att bli inaktuell. Använd forecasting_parameters i stället. Vid prognostisering representerar den här parametern antalet rader som ska fördröja målvärdena baserat på datafrekvensen. Detta representeras som en lista eller ett heltal. Fördröjning bör användas när relationen mellan de oberoende variablerna och den beroende variabeln inte matchar eller korrelerar som standard. När du till exempel försöker prognostisera efterfrågan på en produkt kan efterfrågan under en månad bero på priset på specifika råvaror 3 månader tidigare. I det här exemplet kanske du vill fördröja målet (efterfrågan) negativt med 3 månader så att modellen tränar på rätt relation. Mer information finns i Auto-train a time-series forecast model (Träna en tidsserieprognosmodell automatiskt). |
feature_lags
Obligatorisk
|
Flagga för att generera fördröjningar för de numeriska funktionerna. Den här inställningen håller på att bli inaktuell. Använd forecasting_parameters i stället. |
target_rolling_window_size
Obligatorisk
|
Antalet tidigare perioder som används för att skapa ett medelvärde för rullande fönster för målkolumnen. Den här inställningen håller på att bli inaktuell. Använd forecasting_parameters i stället. Vid prognostisering representerar den här parametern n historiska perioder som ska användas för att generera prognostiserade värden, <= träningsuppsättningens storlek. Om det utelämnas är n den fullständiga träningsuppsättningens storlek. Ange den här parametern när du bara vill överväga en viss mängd historik när du tränar modellen. |
country_or_region
Obligatorisk
|
Det land/den region som används för att generera semesterfunktioner. Dessa bör vara ISO 3166 tvåbokstavs lands-/regionkoder, till exempel "USA" eller "GB". Den här inställningen håller på att bli inaktuell. Använd forecasting_parameters i stället. |
use_stl
Obligatorisk
|
Konfigurera STL-nedbrytning av tidsseriemålkolumnen. use_stl kan ta tre värden: Ingen (standard) – ingen stl-nedbrytning, "säsong" – genererar bara säsongskomponent och season_trend – genererar både säsongs- och trendkomponenter. Den här inställningen håller på att bli inaktuell. Använd forecasting_parameters i stället. |
seasonality
Obligatorisk
|
Ange säsongsvariationer för tidsserier. Om säsongsvariationen är inställd på -1 härleds den. Om use_stl inte har angetts används inte den här parametern. Den här inställningen håller på att bli inaktuell. Använd forecasting_parameters i stället. |
short_series_handling_configuration
Obligatorisk
|
Parametern som definierar hur AutoML ska hantera korta tidsserier. Möjliga värden: "auto" (standard), "pad", "drop" och None.
Datum numeric_value sträng Mål 2020-01-01 23 green 55 Utdata förutsatt att det minsta antalet värden är fyra: +————+—————+———-+—–+| Datum | numeric_value | sträng | target | +============+===============+==========+========+ | 2019-12-29 | 0 | NA | 55.1 | +————+—————+———-+——–+ | 2019-12-30 | 0 | NA | 55,6 | +————+—————+———-+——–+ | 2019-12-31 | 0 | NA | 54,5 | +————+—————+———-+——–+ | 2020-01-01 | 23 | grön | 55 | +————+—————+———-+——–+ Observera: Vi har två parametrar short_series_handling_configuration och äldre short_series_handling. När båda parametrarna anges synkroniseras de enligt tabellen nedan (short_series_handling_configuration och short_series_handling för korthet markeras som handling_configuration respektive hantering). Hantering handling_configuration resulterande hantering resulterande handling_configuration Sant auto Sant auto Sant Pad Sant auto Sant drop Sant auto Sant Ingen Falskt Ingen Falskt auto Falskt Ingen Falskt Pad Falskt Ingen Falskt drop Falskt Ingen Falskt Ingen Falskt Ingen |
freq
Obligatorisk
|
Prognosfrekvens. Vid prognostisering representerar den här parametern den period med vilken prognosen önskas, till exempel dagligen, varje vecka, varje år osv. Prognosfrekvensen är datamängdsfrekvens som standard. Du kan också ange det till större (men inte mindre) än datauppsättningsfrekvensen. Vi aggregerar data och genererar resultaten med prognosfrekvens. För dagliga data kan du till exempel ange att frekvensen ska vara daglig, veckovis eller månadsvis, men inte varje timme. Frekvensen måste vara ett pandas-offsetalias. Mer information finns i Pandas-dokumentationen: https://pandas.pydata.org/pandas-docs/stable/user_guide/timeseries.html#dateoffset-objects |
target_aggregation_function
Obligatorisk
|
Funktionen som ska användas för att aggregera målkolumnen för tidsserier så att den överensstämmer med en angiven frekvens för användaren. Om target_aggregation_function har angetts, men freq-parametern inte har angetts, utlöses felet. Möjliga målaggregeringsfunktioner är: "sum", "max", "min" och "mean". Freq target_aggregation_function Mekanism för korrekthetsfixering av data Ingen (standard) Ingen (standard) Aggregeringen tillämpas inte. Om den giltiga frekvensen inte kan fastställas utlöses felet. Visst värde Ingen (standard) Aggregeringen tillämpas inte. Om antalet datapunkter som är kompatibla med det angivna frekvensrutnätet är mindre tas 90 %dessa punkter bort, annars utlöses felet. Ingen (standard) Sammansättningsfunktion Felet om saknade frekvensparametrar utlöses. Visst värde Sammansättningsfunktion Aggregera till frekvens med hjälp av den tillhandahållna aggregeringsfunktionen. |
enable_voting_ensemble
Obligatorisk
|
Om du vill aktivera/inaktivera VotingEnsemble-iteration. Standardvärdet är Sant. Mer information om ensembler finns i Ensemblekonfiguration. |
enable_stack_ensemble
Obligatorisk
|
Om stackEnsemble-iteration ska aktiveras/inaktiveras. Standardvärdet är Ingen. Om enable_onnx_compatible_models flagga anges inaktiveras StackEnsemble-iteration. På samma sätt inaktiveras StackEnsemble-iteration som standard för Timeseries-uppgifter för att undvika risker för överanpassning på grund av små träningsuppsättningar som används för att passa metainläraren. Mer information om ensembler finns i Ensemblekonfiguration. |
debug_log
Obligatorisk
|
Loggfilen som du vill skriva felsökningsinformation till. Om det inte anges används "automl.log". |
training_data
Obligatorisk
|
Träningsdata som ska användas i experimentet.
Den bör innehålla både träningsfunktioner och en etikettkolumn (valfritt en kolumn med exempelvikter).
Om
|
validation_data
Obligatorisk
|
Valideringsdata som ska användas i experimentet.
Den bör innehålla både träningsfunktioner och etikettkolumn (valfritt en kolumn med exempelvikter).
Om
|
test_data
Obligatorisk
|
Dataset eller
TabularDataset
Funktionen Modelltest med testdatamängder eller testdatadelningar är en funktion i förhandsversionstillstånd och kan ändras när som helst. Testdata som ska användas för en testkörning som startas automatiskt när modellträningen är klar. Testkörningen hämtar förutsägelser med hjälp av den bästa modellen och beräknar mått med tanke på dessa förutsägelser. Om den här parametern eller parametern inte anges körs ingen testkörning automatiskt när modellträningen |
test_size
Obligatorisk
|
Funktionen Modelltest med testdatamängder eller testdatadelningar är en funktion i förhandsversionstillstånd och kan ändras när som helst. Vilken del av träningsdata som ska lagras för testdata för en testkörning som startas automatiskt när modellträningen är klar. Testkörningen hämtar förutsägelser med hjälp av den bästa modellen och beräknar mått med tanke på dessa förutsägelser. Detta bör vara mellan 0.0 och 1.0 icke-inkluderande.
Om För regressionsbaserade uppgifter används slumpmässig sampling. För klassificeringsuppgifter används stratifierad sampling. Prognostisering stöder för närvarande inte att ange en testdatauppsättning med hjälp av en tränings-/testdelning. Om den här parametern eller parametern inte anges körs ingen testkörning automatiskt när modellträningen |
label_column_name
Obligatorisk
|
Namnet på etikettkolumnen. Om indata kommer från en Pandas. DataFrame som inte har kolumnnamn, kolumnindex kan användas i stället, uttryckt som heltal. Den här parametern gäller för |
weight_column_name
Obligatorisk
|
Namnet på exempelviktkolumnen. Automatiserad ML stöder en viktad kolumn som indata, vilket gör att rader i data viktas upp eller ned. Om indata kommer från en Pandas. DataFrame som inte har kolumnnamn, kolumnindex kan användas i stället, uttryckt som heltal. Den här parametern gäller för |
cv_split_column_names
Obligatorisk
|
Lista över namn på kolumner som innehåller anpassad korsvalideringsdelning. Var och en av de delade CV-kolumnerna representerar en CV-uppdelning där varje rad antingen är markerad 1 för träning eller 0 för validering. Den här parametern gäller för Använd antingen Mer information finns i Konfigurera datadelningar och korsvalidering i automatiserad maskininlärning. |
enable_local_managed
Obligatorisk
|
Inaktiverad parameter. Lokala hanterade körningar kan inte aktiveras just nu. |
enable_dnn
Obligatorisk
|
Om DNN-baserade modeller ska inkluderas under modellval. Standardvärdet i init är Ingen. Standardvärdet är dock Sant för DNN NLP-uppgifter och är Falskt för alla andra AutoML-uppgifter. |
Kommentarer
Följande kod visar ett grundläggande exempel på hur du skapar ett AutoMLConfig-objekt och skickar ett experiment för regression:
automl_settings = {
"n_cross_validations": 3,
"primary_metric": 'r2_score',
"enable_early_stopping": True,
"experiment_timeout_hours": 1.0,
"max_concurrent_iterations": 4,
"max_cores_per_iteration": -1,
"verbosity": logging.INFO,
}
automl_config = AutoMLConfig(task = 'regression',
compute_target = compute_target,
training_data = train_data,
label_column_name = label,
**automl_settings
)
ws = Workspace.from_config()
experiment = Experiment(ws, "your-experiment-name")
run = experiment.submit(automl_config, show_output=True)
Ett fullständigt exempel finns i Regression
Exempel på hur du använder AutoMLConfig för prognostisering finns i följande notebook-filer:
Exempel på hur du använder AutoMLConfig för alla aktivitetstyper finns i dessa automatiserade ML-notebook-filer.
Bakgrund om automatiserad ML finns i artiklarna:
Konfigurera automatiserade ML-experiment i Python. I den här artikeln finns information om de olika algoritmer och primära mått som används för varje aktivitetstyp.
Träna en prognosmodell för tidsserier automatiskt. I den här artikeln finns information om vilka konstruktorparametrar och
**kwargs
vilka som används i prognostisering.
Mer information om olika alternativ för att konfigurera datadelningar för träning/validering och korsvalidering för automatiserad maskininlärning, AutoML, experiment finns i Konfigurera datadelningar och korsvalidering i automatiserad maskininlärning.
Metoder
as_serializable_dict |
Konvertera objektet till en ordlista. |
get_supported_dataset_languages |
Hämta språk som stöds och deras motsvarande språkkoder i ISO 639-3. |
as_serializable_dict
Konvertera objektet till en ordlista.
as_serializable_dict() -> Dict[str, Any]
get_supported_dataset_languages
Hämta språk som stöds och deras motsvarande språkkoder i ISO 639-3.
get_supported_dataset_languages(use_gpu: bool) -> Dict[Any, Any]
Parametrar
Name | Description |
---|---|
cls
Obligatorisk
|
Klassobjekt för AutoMLConfig. |
use_gpu
Obligatorisk
|
booleskt värde som anger om gpu-beräkning används eller inte. |
Returer
Typ | Description |
---|---|
ordlista med formatet {: }. Språkkod följer ISO 639-3-standarden, se https://en.wikipedia.org/wiki/List_of_ISO_639-3_codes |