mantidimaging.core.utility.progress_reporting.progress module

class mantidimaging.core.utility.progress_reporting.progress.Progress(num_steps=1, task_name='Task')[source]

Bases: object

Class used to perform basic progress monitoring and reporting.


Increments the number of steps this task is expected to take to complete.


Adds a handler to receiver progress updates. :param handler: Instance of a progress handler

static calculate_mean_time(progress_history: List[ProgressHistory]) float[source]

Mark the task tree that uses this progress instance for cancellation.

Task should either periodically inspect should_cancel or have suitably many calls to update() to be cancellable.


Gets the completion of the task in the range of 0.0 - 1.0

static ensure_instance(p: Progress | None = None, *args, num_steps: int | None = None, **kwargs) Progress[source]

Helper function used to select either a non-None Progress instance as a parameter, or simply create and configure a new one.


Gets the total time this task has been executing.

Total time is measured from the timestamp of the first progress message to the timestamp of the last progress message.


Checks if the task has been marked as completed.


Checks if the task has been started.

A task starts when it reports it’s first progress update.


Gets the message from the last progress update.


Marks the task as completed.

set_estimated_steps(num_steps: int)[source]

Sets the number of steps this task is expected to take to complete.

property should_cancel

Checks if the task should be cancelled.

update(steps: int = 1, msg: str = '', force_continue: bool = False) None[source]

Updates the progress of the task.

  • steps – Number of steps that have been completed since last call to this function

  • msg – Message describing current step

  • force_continue – Prevent cancellation of the async progress

class mantidimaging.core.utility.progress_reporting.progress.ProgressHandler[source]

Bases: object

class mantidimaging.core.utility.progress_reporting.progress.ProgressHistory(time, step, msg)

Bases: tuple

msg: str

Alias for field number 2

step: int

Alias for field number 1

time: float

Alias for field number 0