qsp-modulation¶
Symbol-generation and modulation helpers for communication-oriented signal workflows.
What it is¶
qsp-modulation provides tools for constructing and processing modulated signals using quaternionic representations. It is focused on the modulation and symbol-generation stages of communication-oriented workflows.
Why it exists¶
Quaternionic representations offer a natural way to encode phase, amplitude, and polarization state simultaneously. qsp-modulation enables signal engineers to work in this representation natively — without manually decomposing into separate in-phase and quadrature components — and to design modulation schemes that exploit the full geometric structure of the signal space.
Key responsibilities¶
- Symbol generation for quaternionic signal constellations
- Modulation and demodulation helpers
- Phase-space signal construction utilities
- Integration with IQ-based workflows using QSP types
Typical users¶
- Communications engineers building modulation schemes for polarized or multi-axis channels
- Researchers exploring quaternionic modulation formats
- Signal engineers working at the interface between physical-layer signal geometry and digital processing
Example use cases¶
- Generating a quaternionic symbol stream for a communication channel
- Implementing a quaternionic QAM or PSK variant
- Mapping IQ data into quaternionic form for downstream processing
Relationship to other QSP packages¶
qsp-modulation depends on qsp-core. It is typically used after signal conditioning (qsp-filter) and may use spectral outputs from qsp-fft in analysis stages.
Status¶
The package is focused on foundational modulation primitives. Future expansion may include additional modulation formats, channel simulation utilities, and demodulation estimators.