Welcome to OptiCommPy’s documentation!
Note
This project is under active development.
OptiCommPy is a Python-based framework to simulate systems, subsystems, and components of fiber optic communication systems, for educational and research purposes.
Available features
Several digital modulations available (M-PAM, square M-QAM, M-PSK, OOK) to simulate IM-DD and coherent optical systems.
Numerical models to simulate optical transmitters, optical amplification, nonlinear propagation over optical fibers, and optical receivers.
CPU and GPU-based implementations of the split-step Fourier Method to simulate polarization multiplexed WDM transmission.
Standard digital signal processing (DSP) blocks employed in coherent optical receivers, such as:
Signal resampling.
Matched filtering.
Clock recovery.
Electronic chromatic dispersion compensation (EDC).
Several NxN MIMO adaptive equalization algorithms.
Carrier phase recovery algorithms.
For most of the cases, Numba is used to speed up the core DSP functions.
Evaluate transmission performance with metrics such as:
Bit-error-rate (BER).
Symbol-error-rate (SER).
Error vector magnitude (EVM).
Mutual information (MI).
Generalized mutual information (GMI).
Normalized generalized mutual information (NGMI).
Visualization of the spectrum of electrical/optical signals, signal constellations, and eyediagrams.
How can I contribute?
If you want to contribute to this project, implement the feature you want and send me a pull request. If you want to suggest new features or discuss anything related to OptiCommPy, please get in touch with me (edsonporto88@gmail.com).
Requirements/Dependencies
python>=3.2
numpy>=1.24.4
scipy>=1.13.0
matplotlib>=3.7.0
numba>=0.54.1,<=0.57.0
tqdm>=4.64.1
simple-pid>=1.0.1
mpl-scatter-density>=0.7.0
sphinx-rtd-theme>=1.2.2
nbsphinx>=0.9.3
nbsphinx-link>=1.3.0
cupy-cuda12x >= 13.1.0 (optional, in case GPU processing is desired)
Installation
Using pip:
pip install OptiCommPy
Cloning the repository from GitHub:
$ git clone https://github.com/edsonportosilva/OptiCommPy.git
$ cd OptiCommPy
$ pip install .
Documentation
We are continuously making efforts to improve the code documentation. You can find the latest documentation in opticommpy.readthedocs.io.
Citing this repository
Edson Porto da Silva, Adolfo Fernandes Herbster. “OptiCommPy: Open-source Simulation of Fiber Optic Communications with Python”, Journal of Open Source Software, 9(98), 6600, (2024) https://doi.org/10.21105/joss.06600