Complex to Mag^2
Das Quadrat des Betrags einer komplexen Zahl — nützlich für Leistungsschätzung und Energiedetektion.
1. Beschreibung des Blocks
Der Complex to Mag^2-Block (blocks.complex_to_mag_squared) berechnet für jedes komplexe Eingangssample $z = x + jy$ das Quadrat des Betrags:
$$\text{Magnitude}^2 = x^2 + y^2$$
Im Unterschied zum Complex-to-Mag-Block wird hier kein Quadratwurzel gezogen — das Ergebnis ist proportional zur Signalleistung, nicht zur Signalamplitude.

2. Technischer Einsatz
Der Block wird überall dort eingesetzt, wo die Leistung statt der Amplitude relevant ist: Energiedetektion (Carrier Sensing), Leistungsschätzung für AGC-Regelkreise, oder als schnellerer Vorstufen-Baustein, wenn ohnehin nur ein Schwellwertvergleich auf das Quadrat folgt (die Wurzel des echten Betrags wäre hier unnötiger Rechenaufwand).
Mag^2 exakt dieselbe Entscheidung wie auf Mag — nur ohne die vergleichsweise teure Quadratwurzel-Operation.3. Parameter und Dimensionierung
| Parameter | Typ/Einheit | Bedeutung | Dimensionierungshinweis |
|---|---|---|---|
vlen (Vector Length) |
Integer | Anzahl Elemente pro Vektor-Sample | Standard 1 (Skalarstrom); nur für vektorisierte Verarbeitung erhöhen |
Der Block hat keine weiteren konfigurierbaren Parameter — die Berechnung ist fest vorgegeben.
4. Ein- und Ausgänge
| Ein-/Ausgang | Typ |
|---|---|
| Eingang | Complex |
| Ausgang | Float |
5. Weitere wichtige Aspekte
Verwandter Block: Complex to Mag liefert denselben Betrag, jedoch mit Quadratwurzel — für Envelope-Detection (z. B. AM-Demodulation), bei der die tatsächliche Amplitude benötigt wird, ist jener Block die richtige Wahl.