Registre des codecs. Plus de détails...

Espaces de nommage
namespace	balle2017
	Ballé 2017 entraîné par le notebook : un codec par architecture trouvée dans outputs/checkpoints.
namespace	base
	Interface commune des codecs : Codec, Level, Result et LearnedCodec.
namespace	bmshj2018
	Ballé et al.
namespace	classical
	Codecs classiques de référence, via Pillow : JPEG, JPEG 2000, WebP.

Fonctions
	discover ()
	(Re)construit le registre en important tous les modules de codecs.
	all_codecs ()
	Tous les codecs enregistrés : les classiques d'abord, puis par nom.
	get (key)
	Codec d'identifiant donné.
	closest_level (codec, img, mode, target_bpp)
	Niveau dont le débit sur cette image est le plus proche d'une cible.

Variables
dict	_REGISTRY = {}
	Codecs enregistrés : identifiant -> Codec.

Description détaillée

Registre des codecs.

Chaque module de ce dossier qui définit une fonction codecs() (renvoyant une liste de Codec) est découvert automatiquement : ajouter un algorithme revient à ajouter un fichier ici. Les modules dont le nom commence par « _ » et le module base sont ignorés.

Documentation des fonctions

◆ all_codecs()

aidge_in_space.codecs.all_codecs ( )

Tous les codecs enregistrés : les classiques d'abord, puis par nom.

Renvoie: Liste de Codec (le registre est construit au premier appel).

◆ closest_level()

aidge_in_space.codecs.closest_level	(	codec,
		img,
		mode,
		target_bpp )

Niveau dont le débit sur cette image est le plus proche d'une cible.

Recherche par dichotomie (les niveaux vont du plus bas au plus haut débit), avec des débits estimés et le moteur PyTorch pour aller vite.

Paramètres

codec	Codec.
img	Image uint8.
mode	`"gris"` ou `"rgb"`.
target_bpp	Débit visé, en bits par pixel.

Renvoie: Level le plus proche.

◆ discover()

aidge_in_space.codecs.discover ( )

(Re)construit le registre en important tous les modules de codecs.

Utile après l'ajout d'un module ou d'un checkpoint dans outputs/checkpoints.

Renvoie: Liste triée des codecs (voir all_codecs()).

Exceptions

ValueError si deux codecs ont le même identifiant.

◆ get()

aidge_in_space.codecs.get ( key )

Codec d'identifiant donné.

Paramètres

key	Identifiant (Codec.key).

Renvoie: Le codec.

Exceptions

KeyError si l'identifiant est inconnu.

Espaces de nommage