Skip to main content

Package for digitial communications functions

Project description

# DigCommPy Python3 package for digital communications simulations.

It includes channel coding and different channel models. Simulations can be run to calculate bit/block error rates for different configurations.

# Installation The package can be installed using pip with the command pip install digcommpy.

Alternatively, you can clone the Gitlab repository and install the local copy using the following commands:

git clone https://gitlab.com/klb2/digcommpy.git

cd digcommpy pip install .

# Usage There are multiple example files in the examples folder.

## Basic Encoding/Decoding Example A simple encoding example using a polar code: `python from digcommpy import messages, encoders n, k = 16, 4 encoder = encoders.PolarEncoder(n, k, "BAWGN", 0.) mess = messages.generate_data(k, number=1000, binary=True) codewords = encoder.encode_messages(mess) `

A full transmission chain can be simulated as follows: `python from digcommpy import messages, encoders, decoders, channels, modulators, metrics # Parameters n, k = 16, 4 snr = 5. # dB # Blocks encoder = encoders.PolarEncoder(n, k, "BAWGN", snr) modulator = modulator.BpskModulator() channel = channels.BawgnChannel(snr, rate=k/n) decoder = decoders.PolarDecoder(n, k, "BAWGN", snr) # Simulation mess = messages.generate_data(k, number=1000, binary=True) codewords = encoder.encode_messages(mess) channel_input = modulator.modulate_symbols(codewords) channel_output = channel.transmit_data(channel_input) est_mess = decoder.decode_messages(channel_output) ber = metrics.ber(mess, est_mess) print("The BER is {}".format(ber)) `

This can be simplified by using the simulations module from the package (in progress).

# Used Software Some parts of this library are based on different open source implementations. The polar code encoding and decoding code is based on the Matlab implementation from Harish Vangala et al. (http://polarcodes.com/). The implementation of some functions, e.g., the QAM-modulation are based on the Octave communications package (https://octave.sourceforge.io/).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

digcommpy-0.9.tar.gz (20.7 kB view hashes)

Uploaded source

Built Distribution

digcommpy-0.9-py3-none-any.whl (24.2 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page