mpylab.env.ui.emission_review module

Select a sweep-review adapter without importing Qt into measurement code.

class mpylab.env.ui.emission_review.QtSweepReviewAdapter

Bases: object

Adapt the existing Qt dialogs to detached sweep-review decisions.

prepare(tem)

Validate Qt availability before acquisition.

Parameters:

tem (TEMCell) – Measurement environment.

review(tem, description, record)

Return the existing dialog’s decision and edited metadata.

Parameters:

  • tem (TEMCell) – Measurement environment and GUI-thread dispatcher.

  • description (str) – Measurement description.

  • record (dict) – Detached sweep snapshot.

Returns:

Explicit decision and metadata.

Return type:

SweepReviewDecision

Raises:

UserWarning – The GUI requested save and exit without evaluation.

select(tem, raw, triplets)

Translate the existing selection dialog’s detached result.

Parameters:

  • tem (TEMCell) – Measurement environment and GUI-thread dispatcher.

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

  • triplets (sequence of sequence) – Canonical orientation groups.

Returns:

Explicitly added evaluations.

Return type:

list of SweepEvaluationSelection

mpylab.env.ui.emission_review.resolve_sweep_review(tem, backend='auto', output_dir=None)

Prepare an explicit adapter, Qt, or a terminal fallback.

Parameters:

  • tem (TEMCell) – Measurement environment.

  • backend (str or SweepReviewAdapter, optional) – auto prefers available Qt with a display/GUI dispatcher, otherwise terminal review. qt and terminal choose explicitly. An adapter object may implement prepare, review and select directly.

  • output_dir (path-like or None, optional) – Terminal image directory. None derives a directory from the autosave path, falling back to tem-emission-review in the working directory.

Returns:

Prepared adapter, kept local to the calling workflow.

Return type:

SweepReviewAdapter

Raises:

  • ValueError – Unknown backend or incomplete adapter contract.

  • RuntimeError – No usable interactive display or terminal is available.

  • OSError – Terminal images cannot be written.

mpylab.env.ui.emission_review.review_orientation(adapter, tem, description, record)

Validate an adapter decision before updating sweep metadata.

Parameters:

  • adapter (SweepReviewAdapter) – Prepared review implementation.

  • tem (TEMCell) – Measurement environment.

  • description (str) – Measurement description.

  • record (dict) – Retained sweep; only variant and notes are updated after validation.

Returns:

Validated repeat, continue or stop action.

Return type:

str

Raises:

  • ValueError – The adapter returns an invalid decision or metadata.

  • UserWarning – Review was interrupted without accepting the sweep.

mpylab.env.ui.emission_review.select_evaluations(adapter, tem, raw, triplets)

Validate proposed evaluations before committing any to measurement data.

Parameters:

  • adapter (SweepReviewAdapter) – Prepared review implementation.

  • tem (TEMCell) – Measurement environment.

  • raw (dict) – Retained-sweep data receiving validated selection entries.

  • triplets (sequence of sequence) – Canonical orientation groups.

Returns:

Newly committed evaluation names.

Return type:

list of str

Raises:

ValueError – A proposed selection is invalid, duplicated or incomplete, or its supplied creation timestamp is not an ISO UTC timestamp.