load()

audmodel.load(uid, *, cache_root=None, verbose=False)

Download a model by its unique ID.

If root is not set, the model is downloaded to the default cache folder, see audmodel.default_cache_root(). If the model already exists in the cache folder, the download is skipped.

Parameters

• uid (str) – unique model ID or short ID for latest version

• cache_root (Optional[str]) – cache folder where models and headers are stored. If not set audmodel.default_cache_root() is used

• verbose (bool) – show debug messages

Return type

str

Returns

path to model folder

Raises

• audbackend.BackendError – if connection to repository on backend cannot be established

• RuntimeError – if model does not exist

Examples

>>> root = load("d4e9c65b-3.0.0")
>>> "/".join(root.split(os.path.sep)[-2:])
'd4e9c65b/3.0.0'