.. index:: TEM-Störfestigkeit, Immunity-Datenstruktur, TEMCell

TEM-Störfestigkeitsdaten
========================

Diese Seite beschreibt die persistierten Pfade des TEM/GTEM-Ablaufs. Die
fachliche Bedeutung und Bewertung der EUT-Ereignisse steht unter
:doc:`immunity-results`.

Ein Datensatz wird über seinen Namen adressiert::

   raw = history.rawData_Immunity[description]
   result = history.processedData_Immunity[description]

Rohdaten und gespeicherte Ablaufvereinbarung
--------------------------------------------

Die Messwerte verwenden die beiden parallelen Pfade::

   raw["power"][frequency][position][0][attempt]
   raw["eutstatus"][frequency][position][0][attempt]

``frequency`` ist ein numerischer Frequenzwert in Hz, ``position`` die
EUT-Orientierung und ``attempt`` der Index eines Erst- oder
Wiederholungsversuchs. Die Ebene ``0`` ist der gegenwärtig einzige Portindex
und muss beim Lesen dennoch berücksichtigt werden.

Ein ``power``-Eintrag enthält ``value``, ``pfwd``, ``pbwd``, ``testfield``,
``am_enabled`` und ``am_modulation``. ``value`` ist aus historischen Gründen
noch einmal das Mapping der Messgrößen. ``pfwd`` und ``pbwd`` sind
Leistungs-Quantities, ``testfield`` eine Feldstärke-Quantity. Abhängig von der
Leveling-Strategie kommen ``leveling_*``-Keys hinzu.

Ein ``eutstatus``-Eintrag enthält mindestens ``value``, ``pfwd`` und ``pbwd``.
Der aktuelle Ablauf ergänzt ``testfield``, ``am_enabled``, ``am_modulation``
und ``eut_event`` sowie gegebenenfalls ``leveling_*``-Keys. ``value`` ist der
legacy-kompatible EUT-Status; ``eut_event`` ist das strukturierte Ereignis.

``exposure_status[frequency][position]`` besitzt ``status``, ``reason``,
``detail`` und ``testfield``. Relevante Statuswerte sind ``completed``,
``retry_pending``, ``not_evaluated``, ``observation_pending`` und
``not_executed``. Der letzte Wert wird beispielsweise bei ausgelöster
Verstärkerschutzgrenze gespeichert. ``monitor_diagnostics`` ist eine Liste
von Fehler- und Zustandsmeldungen der EUT-Überwachung.

.. list-table:: Wichtige Ablauf- und Herkunftsfelder
   :header-rows: 1
   :widths: 34 66

   * - Key
     - Bedeutung
   * - ``requested_frequencies``, ``requested_positions``
     - Geplanter Messumfang; Grundlage der Vollständigkeitsprüfung.
   * - ``reference_selection``, ``reference_summary``
     - Ausgewählte TEM-Verifikation und Zusammenfassung ihrer Eignung.
   * - ``immunity_target_efield``
     - Geforderte Feldstärke als Quantity.
   * - ``immunity_reference_power_selection``
     - Je Frequenz ausgewählte oder interpolierte Referenzleistung.
   * - ``am_headroom_policy``, ``am_modulation``
     - Schutz-/Nachweispolitik und tatsächlich konfigurierte AM-Parameter.
   * - ``position_coverage``
     - Prüfung der geforderten EUT-Orientierungen.
   * - ``performance_criterion``, ``eut_event_policy``
     - Bewertungskriterium und Aktionen für Monitorereignisse.
   * - ``post_exposure_timeout``
     - Beobachtungsdauer nach Abschalten der Störgröße.
   * - ``measurement_graph_mode``
     - Verwendeter logischer Graphkontext, standardmäßig ``"GTEM"``.
   * - ``immunity_run_contract``
     - Stabiler Snapshot der Einstellungen, die bei Autosave-Fortsetzung
       unverändert bleiben müssen.
   * - ``mg``
     - Persistierte Messgraphbeschreibung, nicht eine offene Geräteverbindung.

``immunity_run_contract`` ist ein eigenständig versioniertes Teildokument.
Sein ``schema_version`` ist gegenwärtig ``2``. Quantities werden darin als
Mapping mit ``__quantity__``, ``value``, ``uncertainty`` und ``unit``
gespeichert, damit Einstellungen stabil verglichen werden können. Dieses Feld
ist kein Ersatz für die SCUQ-Quantities in den eigentlichen Messdaten.

Ausgewertete Daten
------------------

Der primäre Ergebniszugriff lautet::

   result["result"][frequency][position][attempt]

Jeder Versuch enthält ``eutstatus``, ``eut_event``, ``passed``, ``effective``,
``testfield``, ``pfwd``, ``pbwd``, ``am_enabled`` und ``am_modulation``.
``leveling`` ist optional. Nur der letzte Versuch einer Position trägt
``effective == True``; ältere Versuche bleiben zur Nachvollziehbarkeit
erhalten. Für Kriterium A können frühere Beeinträchtigungen die Gesamtbewertung
trotz eines später bestandenen Versuchs weiterhin beeinflussen.

.. list-table:: Top-Level-Keys von ``processedData_Immunity[description]``
   :header-rows: 1
   :widths: 34 66

   * - Key
     - Bedeutung
   * - ``result``
     - Ausgewertete Versuche nach Frequenz und Position.
   * - ``performance_criterion``, ``performance_assessment``
     - Kriterium A/B/C und strukturierte Bewertung je Messpunkt.
   * - ``overall_passed``, ``overall_status``, ``complete``
     - Gesamtentscheidung und Vollständigkeit. ``overall_status`` ist
       ``passed``, ``failed`` oder ``incomplete``.
   * - ``incomplete_exposures``
     - Liste fehlender oder nicht auswertbarer Soll-Expositionen.
   * - ``leveling_summary``
     - Leveling-Metadaten nach Frequenz und Position.
   * - ``monitor_diagnostics``
     - Kopie der Diagnosen aus den Rohdaten.
   * - ``reference_selection``, ``reference_summary``
     - Verwendete Referenz und ihre Eignungszusammenfassung.
   * - ``immunity_target_efield``, ``immunity_reference_power_selection``
     - Sollfeld und verwendete Leistungsreferenz.
   * - ``am_headroom_policy``, ``am_modulation``
     - AM-Nachweis und Modulation.
   * - ``eut_event_policy``, ``position_coverage``, ``post_exposure_timeout``
     - Bewertungs- und Ablaufkontext.

Ein Eintrag in ``incomplete_exposures`` besitzt ``frequency``, ``position``,
``status``, ``reason``, ``detail`` und ``testfield``. ``complete`` ist nur dann
``True``, wenn für jede angeforderte Kombination aus Frequenz und Position ein
gültiger EUT-Status vorliegt. Deshalb darf ``overall_passed == False`` nicht
ohne ``overall_status`` interpretiert werden: Es kann ein fachliches
Nichtbestehen oder eine unvollständige Messung bedeuten.