API Reference

The API reference section contains the generated documentation of individual structures and functions from source code docstrings.

Configuration

Some basic functions and classes used by the toolkit.

class vot.GlobalConfiguration

Global configuration object for the toolkit. It is used to store global configuration options. It can be initialized from environment variables. The following options are supported:

  • VOT_DEBUG_MODE: Enables debug mode for the toolkit.

  • VOT_SEQUENCE_CACHE_SIZE: Maximum number of sequences to keep in cache.

  • VOT_RESULTS_BINARY: Enables binary results format.

  • VOT_MASK_OPTIMIZE_READ: Enables mask optimization when reading masks.

  • VOT_WORKER_POOL_SIZE: Number of workers to use for parallel processing.

  • VOT_PERSISTENT_CACHE: Enables persistent cache for analysis results in workspace.

exception vot.ToolkitException

Base class for all toolkit related exceptions.

vot.check_debug() bool

Checks if debug is enabled for the toolkit via an environment variable.

Returns

True if debug is enabled, False otherwise

Return type

bool

vot.check_updates() bool

Checks for toolkit updates on Github, requires internet access, fails silently on errors.

Returns

True if an update is available, False otherwise.

Return type

bool

vot.log_debug(message: str, *args, **kwargs)

Prints a debug message to the logger if debug mode is enabled.

Parameters
  • message (str) – The message to be printed.

  • args – Additional arguments to be formatted into the message.

  • kwargs – Additional keyword arguments to be formatted into the message.

vot.log_info(message: str, *args, **kwargs)

Prints an info message to the logger.

Parameters
  • message (str) – The message to be printed.

  • args – Additional arguments to be formatted into the message.

  • kwargs – Additional keyword arguments to be formatted into the message.

vot.print_config()

Prints the global configuration object to the logger.

vot.toolkit_version() str

Returns toolkit version as a string.

Returns

Version of the toolkit

Return type

str