.. index:: e0y, GTEM-Feldfaktor, TEMCell-Datenstruktur TEM-e0y-Daten ============== ``TEMCell.Measure_e0y`` bestimmt den frequenzabhängigen Feldfaktor einer GTEM-Zelle. ``TEMCell.Evaluate_e0y`` normiert die gemessenen Feldkomponenten auf die Quadratwurzel der vorlaufenden Leistung. Beide Stufen verwenden ``description`` als Datensatznamen:: raw = history.rawData_e0y[description] result = history.processedData_e0y[description] Die nachfolgend beschriebenen Pfade bilden die zugesicherte Schnittstelle für persistierte Daten. Zusätzliche Metadaten aus Leveling und Messablauf sind additiv und können zwischen Messmodi variieren. Rohdaten -------- Die eigentlichen Messwerte liegen unter:: raw["efield"][frequency][port][position_index][entry_index] ``frequency`` ist ein numerischer Frequenzwert in Hz. ``port`` und ``position_index`` sind ganzzahlige Indizes; die innerste Ebene ist eine Liste von Wiederholungsmessungen. .. list-table:: Keys eines Rohdaten-Datensatzes :header-rows: 1 :widths: 27 25 48 * - Key - Typ - Bedeutung * - ``efield`` - verschachteltes Mapping - Feld- und Leistungswerte nach Frequenz, Port und Position. * - ``geometry`` - ``GTEMGeometry`` - Geometrie, mit der gemessen wurde. * - ``source`` - Mapping - Herkunft des Feldfaktors; siehe unten. * - ``point`` - ``CalibrationPoint`` oder ``None`` - Benannter Messpunkt, sofern seine Position bekannt ist. * - ``probe_axis_maps`` - Mapping - Zuordnung der Achsen je Feldsonde. * - ``field_probe_values_are_cell_mapped`` - ``bool`` - ``True`` kennzeichnet ``value`` als bereits auf Zellachsen abgebildet. * - ``measurement_graph_mode`` - ``str`` - Beim Standardablauf ``"GTEM"``; der tatsächlich verwendete Graphkontext. * - ``mg`` - ``MGraph`` - Persistierte Beschreibung des Messgraphen. Nicht zur Wiederherstellung geöffneter Geräteverbindungen verwenden. Jeder Eintrag in der innersten Liste besitzt mindestens ``value``, ``pfwd`` und ``pbwd``. ``value`` ist ein Vektor aus drei Feldstärke-Quantities in der Reihenfolge ``cell_x``, ``cell_y``, ``cell_z``. ``pfwd`` und ``pbwd`` sind Leistungs-Quantities; ``pbwd`` darf ``None`` sein. Typische optionale Keys sind ``value_probe`` (Vektor in Sondenachsen), ``field_probe``, ``probe_axis_map``, ``point`` und ``position``. Leveling kann weitere Keys mit dem Präfix ``leveling_`` sowie Ziel- und Schutzmetadaten ergänzen. Herkunft und Position --------------------- ``source`` besitzt immer ``source_type``, ``method`` und ``geometry``. Eine Messung mit bekannter Position verwendet ``source_type == "point"`` und ergänzt ``position``. Darin sind ``x``, ``y``, ``z`` und ``h`` Längen-Quantities; ``h`` ist die Septumhöhe am Messort, ``z`` die Längskoordinate der Zelle. Ältere oder nicht vollständig konfigurierte Datensätze können ``source_type == "unknown"`` besitzen. Ausgewertete Daten ------------------ Der für weitere Rechnungen zentrale Pfad lautet:: result["e0y"][frequency][port][sample_index][component_index] Der Komponentenindex folgt ``cell_x``, ``cell_y``, ``cell_z``. Jeder Wert ist eine Quantity in ``(V/m)/sqrt(W)``. ``sample_index`` zählt die ausgewerteten Einträge eines Ports in der Reihenfolge von Position und Wiederholung. Für positionsbezogenen Zugriff ist deshalb ``points`` vorzuziehen. .. list-table:: Top-Level-Keys von ``processedData_e0y[description]`` :header-rows: 1 :widths: 30 70 * - Key - Bedeutung * - ``e0y`` - Normierte Feldvektoren nach Frequenz und Port. * - ``points`` - Vollständige Einträge nach Frequenz und Punktbezeichnung. * - ``point_summary`` - Letzter zusammengefasster Eintrag je Punkt und Frequenz. * - ``frequency_summary`` - Anzahl und Namen gemessener Punkte sowie Vergleichszusammenfassung. * - ``probe_axis_map``, ``probe_axis_maps`` - Effektive Standardzuordnung und Zuordnung je Sonde. * - ``geometry``, ``source`` - Messgeometrie und Herkunft. * - ``source_e0y`` - Name dieses e0y-Datensatzes. * - ``e0y_comparison`` - Punktweiser Vergleich mit dem analytischen GTEM-Wert. * - ``e0y_comparison_summary`` - Statistische Zusammenfassung des analytischen Vergleichs je Frequenz. * - ``analytical_e0y_max_m`` - Bei der analytischen Reihenentwicklung verwendete obere Indexgrenze. * - ``e0y_comparison_status`` - Verfügbarkeit oder Grund für einen ausgelassenen Vergleich. ``points[frequency][point_label]`` ist eine Liste. Jeder Eintrag enthält ``port``, ``position_index``, ``entry_index``, ``point``, ``position``, ``value``, ``value_probe``, ``pfwd``, ``pbwd``, ``e0y``, ``field_probe`` und ``probe_axis_map``. Optionale Werte bleiben als ``None`` erhalten. ``point_summary[point_label][frequency]`` enthält ``point``, ``position``, ``field``, ``primary_field``, ``pfwd``, ``pbwd``, ``e0y``, ``field_probe`` und ``probe_axis_map``. ``primary_field`` ist die gemessene ``cell_y``-Komponente. Diese Zusammenfassung ist bequem, verliert aber bei Wiederholungsmessungen ältere Einträge; für eine vollständige Auswertung ist ``points`` maßgeblich. Analytischer Vergleich ---------------------- Bei bekannter Position und Geometrie enthält ``e0y_comparison[frequency][point_label]`` die Keys ``point``, ``position``, ``measured_e0y``, ``analytical_e0y``, ``ratio``, ``delta_relative`` und ``delta_db``. Die beiden Feldfaktoren sind Quantities in ``(V/m)/sqrt(W)``; Verhältnis und Abweichungen sind Zahlen. Bei einem analytischen Nullwert sind die drei Verhältnisfelder ``None``. ``e0y_comparison_summary[frequency]`` enthält ``point_count`` sowie Minimum, Maximum und Mittelwert für ``ratio`` und ``delta_db``. Der Status ist einer von ``available``, ``skipped_missing_position``, ``skipped_missing_geometry`` oder ``skipped_incomplete_data``. Der Vergleich ist informativ und verändert ``e0y`` nicht. Geometrieprüfung und Weiterverwendung ------------------------------------- Die Auswertung lehnt widersprüchliche aktive, rohe und in ``source`` gespeicherte Geometrien ab. Anwendungen sollen den Feldfaktor deshalb nicht ohne die zugehörige ``geometry`` und ``source`` in eine andere Historie kopieren. Für Emissionsrechnungen ist die explizite e0y-Quellenauswahl zu verwenden; eine Verifikationsmessung kann ebenfalls eine geeignete Quelle liefern. Siehe :doc:`tem-verification-data`.