load_to()

audb.load_to(root, name, *, version=None, only_metadata=False, pickle_tables=True, cache_root=None, num_workers=1, verbose=True)[source]

Load database to directory.

Loads the original state of the database to a custom directory. No conversion or filtering will be applied. If the target folder already contains some version of the database, it will upgrade to the requested version. Unchanged files will be skipped.

Parameters

  • root (str) – target directory

  • name (str) – name of database

  • version (Optional[str]) – version string, latest if None

  • only_metadata (bool) – load only header and tables of database

  • pickle_tables (bool) – if True, tables are stored in root in their original format and as pickle files. This allows for faster loading, when loading from root

  • cache_root (Optional[str]) – cache folder where databases are stored. If not set audb.default_cache_root() is used. Only used to read the dependencies of the requested version

  • num_workers (Optional[int]) – number of parallel jobs or 1 for sequential processing. If None will be set to the number of processors on the machine multiplied by 5

  • verbose (bool) – show debug messages

Return type

Database

Returns

database object