mpylab.env.ui.sweep_review module

Qt-free decisions exchanged between sweep workflows and review adapters.

class mpylab.env.ui.sweep_review.SweepEvaluationSelection(name: str, sweeps: dict, created_at_utc: str | None = None)

Bases: object

Proposed evaluation; the workflow validates and stores it.

name

Non-empty, unused evaluation name.

Type:

str

sweeps

One retained sweep ID per orientation.

Type:

dict

created_at_utc

ISO UTC timestamp when this set was added. None keeps compatibility with adapters that supply only name and sweeps; the workflow then records its commit time.

Type:

str or None, optional

created_at_utc: str | None = None

name: str

sweeps: dict

class mpylab.env.ui.sweep_review.SweepReviewAdapter(*args, **kwargs)

Bases: Protocol

Interface for Qt, terminal or application-specific sweep review.

prepare(tem)

Check availability before acquisition.

Parameters:

tem (TEMCell) – Measurement environment providing UI hooks and output paths.

review(tem, description, record)

Return an explicit decision from a detached sweep snapshot.

Parameters:

• tem (TEMCell) – Environment providing pre/post user-event hooks.

• description (str) – Measurement description.

• record (dict) – Detached snapshot; changes do not modify retained measurement data.

Returns:

Operator decision and edited metadata.

Return type:

SweepReviewDecision

Raises:

UserWarning – Save and exit without evaluation was requested.

select(tem, raw, triplets)

Propose explicitly selected evaluations without changing history.

Parameters:

• tem (TEMCell) – Environment providing user-event hooks.

• raw (dict) – Detached retained-sweep data.

• triplets (sequence of sequence) – Existing canonical orientation groups.

Returns:

Proposed evaluations. Empty means no new evaluation.

Return type:

list of SweepEvaluationSelection

class mpylab.env.ui.sweep_review.SweepReviewDecision(action: str, variant: str, notes: str)

Bases: object

Operator decision without a reference to measurement or GUI objects.

action

repeat, continue or stop (finish and select evaluations).

Type:

str

variant

EUT variant as measured.

Type:

str

notes

Notes attached to this sweep.

Type:

str

action: str

notes: str

variant: str