Experiment Osztály

Az Azure Machine Learningben végzett kísérletek létrehozásának és használatának fő belépési pontját jelöli.

A kísérlet több modellfuttatást ábrázoló próbaverziók tárolója.

Kísérlet konstruktor.

Konstruktor

Experiment(workspace, name, _skip_name_validation=False, _id=None, _archived_time=None, _create_in_cloud=True, _experiment_dto=None, **kwargs)

Paraméterek

Name	Description
workspace Kötelező	Workspace A kísérletet tartalmazó munkaterület-objektum.
name Kötelező	str A kísérlet neve.
kwargs Kötelező	dict A kulcsszó args szótára.
workspace Kötelező	Workspace A kísérletet tartalmazó munkaterület-objektum.
name Kötelező	str A kísérlet neve.
kwargs Kötelező	dict A kulcsszó args szótára.
_skip_name_validation	Alapértelmezett érték: False
_id	Alapértelmezett érték: None
_archived_time	Alapértelmezett érték: None
_create_in_cloud	Alapértelmezett érték: True
_experiment_dto	Alapértelmezett érték: None

Megjegyzések

Az Azure Machine Learning-kísérlet a felhasználó hipotézisének ellenőrzésére használt kísérletek gyűjteményét jelenti.

Az Azure Machine Learningben a kísérletet az osztály, a Experiment próbaverziót pedig az Run osztály képviseli.

Ha egy munkaterületről szeretne kísérletet lekérni vagy létrehozni, a kísérlet nevét kell használnia. A kísérlet nevének 3–36 karakternek kell lennie, betűvel vagy számmal kell kezdődnie, és csak betűket, számokat, aláhúzásjeleket és kötőjeleket tartalmazhat.

   experiment = Experiment(workspace, "MyExperiment")

Ha a kísérlet nem található a munkaterületen, létrejön egy új kísérlet.

A kísérlet próbaverziója kétféleképpen hajtható végre. Ha interaktívan kísérletezik egy Jupyter-jegyzetfüzetben, használja start_logging a Ha egy kísérletet forráskódból vagy más típusú konfigurált próbaverzióból küld el, használja a submit

Mindkét mechanizmus létrehoz egy objektumot Run . Interaktív forgatókönyvekben olyan naplózási módszereket használjon, mint például log mérések és metrikák hozzáadása a próbarekordhoz. A konfigurált forgatókönyvekben olyan állapotmetókkal, mint például get_status a futtatás adatainak lekérése.

Mindkét esetben használhat lekérdezési módszereket, például get_metrics lekérheti a próbamérések és metrikák aktuális értékeit, ha vannak ilyenek.

Metódusok

archive	Kísérlet archiválása.
delete	Kísérlet törlése a munkaterületen.
from_directory	(Elavult) Kísérlet betöltése a megadott elérési útról.
get_docs_url	Az osztály dokumentációjának URL-címe.
get_runs	Adja vissza a kísérlethez tartozó futtatások generátorát fordított időrendi sorrendben.
list	Adja vissza a munkaterületen található kísérletek listáját.
reactivate	Archivált kísérlet újraaktiválása.
refresh	A kísérlet legújabb verzióját adja vissza a felhőből.
remove_tags	Törölje a megadott címkéket a kísérletből.
set_tags	Adjon hozzá vagy módosítsa a kísérlethez tartozó címkéket. A szótárban nem átadott címkék érintetlenek maradnak.
start_logging	Indítsa el az interaktív naplózási munkamenetet, és hozzon létre egy interaktív futtatásokat a megadott kísérletben.
submit	Küldjön be egy kísérletet, és adja vissza az aktív létrehozott futtatásokat.
tag	A kísérletet sztringkulccsal és opcionális sztringértékkel címkézhető meg.

archive

Kísérlet archiválása.

archive()

Megjegyzések

Az archiválás után a kísérlet alapértelmezés szerint nem lesz felsorolva. Ha archivált kísérletbe próbál írni, egy új, azonos nevű aktív kísérletet hoz létre. Az archivált kísérletek visszahívhatók mindaddig, reactivate amíg nincs egy másik, azonos nevű aktív kísérlet.

delete

Kísérlet törlése a munkaterületen.

static delete(workspace, experiment_id)

Paraméterek

Name	Description
workspace Kötelező	Workspace A munkaterület, amelyhez a kísérlet tartozik.
experiment_id Kötelező	A törölni kívánt kísérlet kísérletazonosítója.

from_directory

(Elavult) Kísérlet betöltése a megadott elérési útról.

static from_directory(path, auth=None)

Paraméterek

Name	Description
path Kötelező	str A kísérletkonfigurációs fájlokat tartalmazó könyvtár.
auth	ServicePrincipalAuthentication vagy InteractiveLoginAuthentication A hitelesítési objektum. Ha nincs, akkor az alapértelmezett Azure CLI-hitelesítő adatok lesznek használatban, vagy az API hitelesítő adatokat kér. Alapértelmezett érték: None

Válaszok

Típus	Description
Experiment	A kísérlet visszaadása

get_docs_url

Az osztály dokumentációjának URL-címe.

get_docs_url()

Válaszok

Típus	Description
str	URL-cím

get_runs

Adja vissza a kísérlethez tartozó futtatások generátorát fordított időrendi sorrendben.

get_runs(type=None, tags=None, properties=None, include_children=False)

Paraméterek

Name	Description
type	string Szűrje a megadott típusú futtatások visszaadott generátorát. Tekintse meg add_type_provider a futtatási típusok létrehozását. Alapértelmezett érték: None
tags	string vagy dict A szűrő "címke" vagy {"tag": "value"} szerint fut. Alapértelmezett érték: None
properties	string vagy dict A szűrő "tulajdonság" vagy {"tulajdonság" szerint fut: "value"} Alapértelmezett érték: None
include_children	bool Alapértelmezés szerint csak a legfelső szintű futtatások beolvasása. Állítsa igaz értékre az összes futtatás listázásához. Alapértelmezett érték: False

Válaszok

Típus	Description
list[Run]	A megadott szűrőknek megfelelő futtatások listája.

list

Adja vissza a munkaterületen található kísérletek listáját.

static list(workspace, experiment_name=None, view_type='ActiveOnly', tags=None)

Paraméterek

Name	Description
workspace Kötelező	Workspace Az a munkaterület, ahonnan a kísérleteket listázni szeretné.
experiment_name	str Nem kötelező név a kísérletek szűréséhez. Alapértelmezett érték: None
view_type	ViewType Nem kötelező enumerálási érték az archivált kísérletek szűréséhez vagy belefoglalásához. Alapértelmezett érték: ActiveOnly
tags	Nem kötelező címkekulcs vagy címkekulcs-érték párok szótára a kísérletek szűréséhez. Alapértelmezett érték: None

Válaszok

Típus	Description
list[Experiment]	Kísérletobjektumok listája.

reactivate

Archivált kísérlet újraaktiválása.

reactivate(new_name=None)

Paraméterek

Name	Description
new_name Kötelező	str Már nem támogatott

Megjegyzések

Az archivált kísérletek csak akkor aktiválhatók újra, ha nincs egy másik, azonos nevű aktív kísérlet.

refresh

A kísérlet legújabb verzióját adja vissza a felhőből.

refresh()

remove_tags

Törölje a megadott címkéket a kísérletből.

remove_tags(tags)

Paraméterek

Name	Description
tags Kötelező	[str] Az eltávolítható címkekulcsok

set_tags

Adjon hozzá vagy módosítsa a kísérlethez tartozó címkéket. A szótárban nem átadott címkék érintetlenek maradnak.

set_tags(tags)

Paraméterek

Name	Description
tags Kötelező	dict[str] A kísérletobjektumban tárolt címkék

start_logging

Indítsa el az interaktív naplózási munkamenetet, és hozzon létre egy interaktív futtatásokat a megadott kísérletben.

start_logging(*args, **kwargs)

Paraméterek

Name	Description
experiment Kötelező	Experiment A kísérlet.
outputs Kötelező	str Nem kötelező, hogy a kódtár nyomon követhető legyen. Kimenet nélkül adja át a False (Hamis) értéket.
snapshot_directory Kötelező	str Nem kötelező könyvtár, amelyről pillanatképet szeretne készíteni. A Nincs beállítás nem fog pillanatképet készíteni.
args Kötelező	list
kwargs Kötelező	dict

Válaszok

Típus	Description
Run	Elindított futtatás visszaadása.

Megjegyzések

start_logging interaktív futtatási lehetőséget hoz létre olyan helyzetekben való használatra, mint a Jupyter Notebooks. A munkamenet során naplózott metrikákat a rendszer hozzáadja a kísérlet futási rekordjához. Ha kimeneti könyvtár van megadva, a rendszer futtatási összetevőként tölti fel a könyvtár tartalmát a futtatás befejezésekor.

   experiment = Experiment(workspace, "My Experiment")
   run = experiment.start_logging(outputs=None, snapshot_directory=".", display_name="My Run")
   ...
   run.log_metric("Accuracy", accuracy)
   run.complete()

Megjegyzés:

run_id minden futtatáshoz automatikusan létrejön, és a kísérleten belül egyedi.

submit

Küldjön be egy kísérletet, és adja vissza az aktív létrehozott futtatásokat.

submit(config, tags=None, **kwargs)

Paraméterek

Name	Description
config Kötelező	object Az elküldendő konfiguráció.
tags	dict A beküldött futtatáshoz hozzáadandó címkék: {"tag": "value"}. Alapértelmezett érték: None
kwargs Kötelező	dict A konfigurációk küldési függvényében használt további paraméterek.

Válaszok

Típus	Description
Run	Egy futtatás.

Megjegyzések

A Küldés egy aszinkron hívás az Azure Machine Learning platformra a próbaverzió helyi vagy távoli hardveren való végrehajtásához. A konfigurációtól függően a küldés automatikusan előkészíti a végrehajtási környezeteket, végrehajtja a kódot, és rögzíti a forráskódot és az eredményeket a kísérlet futtatási előzményeibe.

A kísérlet elküldéséhez először létre kell hoznia egy konfigurációs objektumot, amely leírja a kísérlet futtatásának módját. A konfiguráció a szükséges próbaverzió típusától függ.

A kísérlet helyi gépről való elküldésére a következő példa látható:

   from azureml.core import ScriptRunConfig

   # run a trial from the train.py code in your current directory
   config = ScriptRunConfig(source_directory='.', script='train.py',
       run_config=RunConfiguration())
   run = experiment.submit(config)

   # get the url to view the progress of the experiment and then wait
   # until the trial is complete
   print(run.get_portal_url())
   run.wait_for_completion()

A futtatás konfigurálásának részleteiért tekintse meg a konfiguráció típusának részleteit.

• ScriptRunConfig

• azureml.train.automl.automlconfig.AutoMLConfig

• azureml.pipeline.core.Pipeline

• azureml.pipeline.core.PublishedPipeline

• azureml.pipeline.core.PipelineEndpoint

Megjegyzés:

A betanítási futtatás elküldésekor a rendszer létrehoz egy pillanatképet a betanítási szkripteket tartalmazó könyvtárról, és elküldi a számítási célnak. A rendszer a kísérlet részeként is tárolja a munkaterületen. Ha módosítja a fájlokat, és újra elküldi a futtatásokat, csak a módosított fájlok lesznek feltöltve.

Ha meg szeretné akadályozni, hogy a fájlok bekerüljenek a pillanatképbe, hozzon létre egy .gitignore vagy .amlignore fájlt a könyvtárban, és adja hozzá a fájlokat. Az .amlignore fájl ugyanazt a szintaxist és mintákat használja, mint a .gitignore fájl. Ha mindkét fájl létezik, az .amlignore fájl elsőbbséget élvez.

További információ: Pillanatképek.

tag

A kísérletet sztringkulccsal és opcionális sztringértékkel címkézhető meg.

tag(key, value=None)

Paraméterek

Name	Description
key Kötelező	str A címkekulcs
value Kötelező	str A címke opcionális értéke

Megjegyzések

A kísérlet címkéi sztringkulcsokat és sztringértékeket tartalmazó szótárban vannak tárolva. A címkék beállíthatók, frissíthetők és törölhetők. A címkék felhasználói elérésűek, és általában jelentéssel bíró információkat tartalmaznak a kísérlet felhasználói számára.

   experiment.tag('')
   experiment.tag('DeploymentCandidate')
   experiment.tag('modifiedBy', 'Master CI')
   experiment.tag('modifiedBy', 'release pipeline') # Careful, tags are mutable

Attribútumok

archived_time

A kísérlet archivált idejét adja vissza. Aktív kísérlet esetén a Nincs értéknek kell lennie.

Válaszok

Típus	Description
str	A kísérlet archivált ideje.

id

A kísérlet visszatérési azonosítója.

Válaszok

Típus	Description
str	A kísérlet azonosítója.

name

A kísérlet nevét adja vissza.

Válaszok

Típus	Description
str	A kísérlet neve.

tags

Adja vissza a kísérlet címkéinek mutable készletét.

Válaszok

Típus	Description
dict[str]	A kísérlet címkéi.

workspace

Adja vissza a kísérletet tartalmazó munkaterületet.

Válaszok

Típus	Description
Workspace	A munkaterület objektumát adja vissza.

workspace_object

(Elavult) Adja vissza a kísérletet tartalmazó munkaterületet.

Használja az workspace attribútumot.

Válaszok

Típus	Description
Workspace	A munkaterület objektuma.