Measurement lifecycle
=====================

The :class:`~mpylab.env.Measure.Measure` base class owns the common lifecycle
of a measurement: logging, user interaction, autosave and resume, device
initialization, RF-off, finalization, and pickle restoration. Measurement
environments such as ``MSC``, ``TEMCell``, and ``AmplifierTest`` derive from
it.

Persistence helpers
-------------------

.. autofunction:: mpylab.env.Measure.dump_pickle

.. autofunction:: mpylab.env.Measure.load_pickle_compat

Only load trusted pickle files. Loading a Python pickle can execute code.

Base class
----------

.. autoclass:: mpylab.env.Measure.Measure
   :members:
      set_autosave_resume,
      set_autosave_interval,
      set_autosave,
      do_autosave,
      wait,
      _init_measurement_devices,
      _finalize_measurement_devices

The two underscored device-lifecycle methods are documented because derived
measurement classes are expected to use them. Other underscored members
remain implementation details.

TEM uniform-area collections
----------------------------

The TEM verification and immunity starters accept a named ``uniform_areas``
mapping and register all entries in the ``TEMCell`` history. A single
``TEMCell.Measure_Verification`` call continues to select exactly one stored
name or one complete area definition through its ``uniform_area`` parameter.
The bilingual :doc:`German <../de/measurements/tem>` and :doc:`English
<../en/measurements/tem>` guides describe consecutive verification datasets,
later immunity selection, and interpolation constraints.

.. autoclass:: mpylab.env.Measure.AmplifierProtectionError

EUT monitoring and immunity results
-----------------------------------

The :doc:`German <../de/results/immunity-results>` and :doc:`English
<../en/results/immunity-results>` guides describe event semantics,
performance criteria, disturbance-neutral records, and the optional JSON
interchange document.
The task-oriented implementation guides are available in
:doc:`German <../de/framework/eut-monitoring>` and
:doc:`English <../en/framework/eut-monitoring>`.

.. autofunction:: mpylab.env.eut.make_eut_event

.. autofunction:: mpylab.env.eut.evaluate_performance_criterion

.. autoclass:: mpylab.env.eut.EUTMonitor
   :members:

.. autoclass:: mpylab.env.eut.ManualEUTMonitor
   :members:

.. autoclass:: mpylab.env.eut.CompositeEUTMonitor
   :members:

.. autoclass:: mpylab.env.eut.EUTMonitoringSession
   :members:

.. autoclass:: mpylab.env.eut.ThreadedEUTMonitor
   :members:

.. autoclass:: mpylab.env.eut.VirtualEUTMonitor
   :members:

.. autoclass:: mpylab.env.eut.RandomEUTMonitor
   :members:

.. autofunction:: mpylab.env.immunity_result.build_immunity_document

.. autofunction:: mpylab.env.immunity_result.write_immunity_document

.. autofunction:: mpylab.env.immunity_result.load_immunity_document