=============
Duplex Modem
=============

.. inheritance-diagram:: hermespy.modem.modem.DuplexModem
   :parts: 1
   :top-classes: hermespy.core.device.Receiver, hermespy.core.device.Transmitter, hermespy.modem.modem.BaseModem

Duplex modems represent the signal processing chain of a communication device simulatenously transmitting
and receiving information,
implementing the digital signal processing before digital-to-analog conversion and after analog-to-digital conversion, respectively.
They are a combination of a :doc:`modem.modem.TransmittingModem` and a :doc:`modem.modem.ReceivingModem`.


After a :class:`DuplexModem<hermespy.modem.modem.DuplexModem>` is added as a
type of :class:`Transmitter<hermespy.core.device.Transmitter>` to a :class:`Device<hermespy.core.device.Device>`,
a call to :meth:`Device.transmit<hermespy.core.device.Device.transmit>` will be delegated
to :meth:`TransmittingModem._transmit()<hermespy.modem.modem.TransmittingModem._transmit>`.
Similarly, after a :class:`DuplexModem<hermespy.modem.modem.DuplexModem>` is added as a
type of :class:`Receiver<hermespy.core.device.Receiver>` to a :class:`Device<hermespy.core.device.Device>`,
a call to :meth:`Device.receive<hermespy.core.device.Device.receive>` will be delegated
to :meth:`ReceivingModem._receive()<hermespy.modem.modem.ReceivingModem._receive>`

.. literalinclude:: ../scripts/examples/modem_DuplexModem.py
   :language: python
   :linenos:
   :lines: 19-34

For a detailed description of the transmit and receive routines,
refer to the :doc:`modem.modem.TransmittingModem` and a :doc:`modem.modem.ReceivingModem` of
the base classes.

The barebone configuration can be extend by additional components such as
:class:`Custom Bit Sources<hermespy.modem.bits_source.BitsSource>`,
:class:`Synchronization<hermespy.modem.waveform.Synchronization>`,
:class:`Stream Precoding<hermespy.precoding.stream_precoding.ReceiveStreamCoding>`,
:class:`Channel Estimation<hermespy.modem.waveform.ChannelEstimation>`,
:class:`Symbol Precoding<hermespy.modem.precoding.symbol_precoding.SymbolPrecoding>`,
:class:`Channel Equalization<hermespy.modem.waveform.ChannelEqualization>` and
:class:`Bit Encoders<hermespy.fec.coding.Encoder>`:

.. literalinclude:: ../scripts/examples/modem_DuplexModem.py
   :language: python
   :linenos:
   :lines: 26-57

.. autoclass:: hermespy.modem.modem.DuplexModem

.. footbibliography::