Utils Module

This module contains utility functions.

Progress

Progress tracking functionality for FMUS-VID.

This module provides utilities for tracking and reporting operation progress.

class fmusvid.utils.progress.OperationType(value)

Types of video operations for progress tracking.

LOAD = 'Loading'

SAVE = 'Saving'

ENCODE = 'Encoding'

DECODE = 'Decoding'

PROCESS = 'Processing'

ANALYZE = 'Analyzing'

EXPORT = 'Exporting'

STREAM = 'Streaming'

class fmusvid.utils.progress.ProgressStats(start_time, current_time, total_frames, processed_frames, fps, eta, percentage)

Statistics for operation progress.

start_time: float

current_time: float

total_frames: int

processed_frames: int

fps: float

eta: timedelta

percentage: float

__init__(start_time, current_time, total_frames, processed_frames, fps, eta, percentage)

class fmusvid.utils.progress.ProgressTracker(operation, total_frames, callback=None, update_interval=0.1)

Class for tracking operation progress.

__init__(operation, total_frames, callback=None, update_interval=0.1)

Initialize progress tracker.

Parameters:

• operation (OperationType) – Type of operation being tracked

• total_frames (int) – Total number of frames to process

• callback (Optional[Callable[[ProgressStats], None]]) – Function to call with progress updates

• update_interval (float) – Minimum time between progress updates

update(frames=1)

Update progress.

Parameters:

frames (int) – Number of frames processed since last update

Return type:

None

complete()

Mark operation as complete.

Return type:

None

class fmusvid.utils.progress.ConsoleProgress(operation, total_frames)

Console-based progress reporter.

__init__(operation, total_frames)

Initialize console progress reporter.

Parameters:

• operation (OperationType) – Type of operation being tracked

• total_frames (int) – Total number of frames to process

update(frames=1)

Update progress.

Parameters:

frames (int) – Number of frames processed

Return type:

None

complete()

Mark operation as complete.

Return type:

None

class fmusvid.utils.progress.ProgressManager

Manager for tracking multiple operations.

__init__()

Initialize progress manager.

start_operation(name, operation, total_frames, callback=None)

Start tracking a new operation.

Parameters:

• name (str) – Operation identifier

• operation (OperationType) – Type of operation

• total_frames (int) – Total frames to process

• callback (Optional[Callable[[ProgressStats], None]]) – Progress callback function

Return type:

ProgressTracker

Returns:

Progress tracker for the operation

update(name, frames=1)

Update operation progress.

Parameters:

• name (str) – Operation identifier

• frames (int) – Frames processed

Return type:

None

complete(name)

Mark operation as complete.

Parameters:

name (str) – Operation identifier

Return type:

None

get_stats(name)

Get current statistics for an operation.

Parameters:

name (str) – Operation identifier

Return type:

Optional[ProgressStats]

Returns:

Current progress statistics or None if operation not found

Benchmark

Optimization

Quality