.. index:: Verstärkertest, Verstärkerdatenstruktur, Kompressionspunkt

Verstärkertestdaten
====================

``AmplifierTest`` verwendet je einen allgemeinen Roh- und
Auswertungscontainer::

   raw = history.rawData[description]
   result = history.processedData[description]

Rohdaten
--------

Ein Datensatz besitzt die drei parallelen Kanäle ``sg_pout``, ``amp_pin`` und
``amp_pout``. Ihr Pfad lautet::

   raw[channel][frequency][repr(generator_level)][sample]

``frequency`` ist ein numerischer Frequenzwert in Hz. Der Generatorpegel ist
aus historischen Kompatibilitätsgründen die Zeichenkettendarstellung einer
Power-Quantity, beispielsweise ``"Quantity(W, 0.001)"``. Anwendungen sollen
diesen Schlüssel nicht numerisch interpretieren, sondern den gespeicherten
``value`` verwenden oder :func:`mpylab.env.Measure.parse_quantity` nutzen.

Jeder Listeneintrag enthält ``value``, ``pfwd`` und ``pbwd``:

* In ``sg_pout`` ist ``value`` der eingestellte Generatorpegel.
* In ``amp_pin`` ist ``value`` die pfadkorrigierte Verstärkereingangsleistung.
* In ``amp_pout`` ist ``value`` die pfadkorrigierte
  Verstärkerausgangsleistung.

Alle drei Werte sind Power-Quantities. Im Aufbau ``rack`` enthalten ``pfwd``
und ``pbwd`` die rohen Messwerte der beiden Rack-Leistungsmesser. Im Aufbau
``direct`` sind beide ``None`` und der Eintrag ergänzt ``pm_out`` mit dem rohen
Messwert des direkt angeschlossenen Leistungsmessers. Werte aus verschiedenen
Aufbauten sind deshalb über ``value`` zu vergleichen, nicht über die
aufbauspezifischen Rohkanäle.

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

``GetGainAndCompression`` ersetzt ``processedData[description]`` durch fünf
Frequenztabellen:

.. list-table:: Auswertungskanäle
   :header-rows: 1
   :widths: 35 25 40

   * - Key
     - Pfad
     - Inhalt
   * - ``gain``
     - ``[frequency][sample]``
     - Leistungsverstärkung als dimensionslose Quantity.
   * - ``input_compression_1dB``
     - ``[frequency][sample]``
     - Eingangsleistung am 1-dB-Kompressionspunkt.
   * - ``input_compression_3dB``
     - ``[frequency][sample]``
     - Eingangsleistung am 3-dB-Kompressionspunkt.
   * - ``output_compression_1dB``
     - ``[frequency][sample]``
     - Ausgangsleistung am 1-dB-Kompressionspunkt.
   * - ``output_compression_3dB``
     - ``[frequency][sample]``
     - Ausgangsleistung am 3-dB-Kompressionspunkt.

Kompressionswerte sind Power-Quantities oder ``None``, wenn der jeweilige
Punkt in den Messdaten nicht gefunden wurde. Alle Frequenzkanäle enthalten
Listen, weil mehrere Wiederholungen je Generatorpegel ausgewertet werden
können. Ein Index bezeichnet über alle fünf Kanäle dieselbe Wiederholung.

``OutputIniFile`` exportiert aus diesen Ergebnissen die Kanäle ``S21``,
``MAXIN``, ``C1DB`` und ``C3DB``. Das INI ist eine abgeleitete Gerätekonfiguration
und ersetzt die Messhistorie mit Rohdaten und beiden Kompressionsrichtungen
nicht.