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.

Keys eines Rohdaten-Datensatzes

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.

Top-Level-Keys von processedData_e0y[description]

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 TEM-Verifikationsdaten.