Référence de l'espace de nommage aidge_in_space.training.config

Configuration d'entraînement : champs, validation, lecture et écriture YAML, préréglages. Plus de détails...

Classes
class	ConfigError
	Configuration d'entraînement invalide (code de retour 2 de la CLI train). Plus de détails...
class	TrainConfig
	Réglages d'un entraînement ; les défauts reprennent le notebook (cellule 4, mode GPU complet). Plus de détails...

Fonctions
	_int (field, v)
	Entier d'un champ, ou ConfigError (un flottant de valeur entière est accepté, jamais un booléen).
	_float (field, v)
	Flottant fini d'un champ, ou ConfigError (jamais un booléen).
	_str (field, v)
	Chaîne d'un champ, ou ConfigError.
	_check (cond, field, problem, value)
	Lève ConfigError("<champ> : <problème> (reçu <valeur>)") si la condition est fausse.
dict	schedule_for (int steps)
	Réglages non exposés dans l'interface, déduits du nombre de pas.
Path	resolve_path (p)
	Chemin absolu tel quel, sinon relatif à config.ROOT (lu à l'appel).

Variables
tuple	INT_FIELDS
	Champs entiers de TrainConfig.
tuple	FLOAT_FIELDS = ("lmbda", "lr", "lr_decay_at", "grad_clip")
	Champs flottants de TrainConfig.
tuple	STR_FIELDS = ("name", "author", "train_dir", "eval_dir")
	Champs textuels de TrainConfig.
int	MAX_LABEL_LEN = 60
	Nombre maximal de caractères du nom et de l'auteur.
int	MAX_BANK_BYTES = 2 ** 31
	Taille maximale de la banque de patchs en octets (uint8) : 2 Gio.
dict	PRESETS
	Préréglages : champs de TrainConfig (sans name, author, train_dir, eval_dir, lmbda).

Description détaillée

Configuration d'entraînement : champs, validation, lecture et écriture YAML, préréglages.

Module sans dépendance à torch (seulement dataclasses, yaml et pathlib) : il est importable à faible coût par l'interface et par la file d'attente. Le contrat est dans docs/conception_entrainement.md (§ 2.2).

Documentation des fonctions

resolve_path()

Path aidge_in_space.training.config.resolve_path

(

p

)

Chemin absolu tel quel, sinon relatif à config.ROOT (lu à l'appel).

Paramètres

p	Chemin absolu ou relatif au dépôt.

Renvoie

Chemin absolu.

schedule_for()

dict aidge_in_space.training.config.schedule_for

(

int

steps

)

Réglages non exposés dans l'interface, déduits du nombre de pas.

Paramètres

steps

Nombre de pas d'entraînement.

Renvoie

Dictionnaire log_every, eval_every, save_every et n_eval_images.