OptiCommPy 0.6.0__tar.gz → 0.9.0__tar.gz

OptiCommPy-0.9.0/OptiCommPy.egg-info/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.1
+Name: OptiCommPy
+Version: 0.9.0
+Summary: Optical Communications Algorithms with Python
+Home-page: https://github.com/edsonportosilva/OptiCommPy
+Maintainer: Edson Porto da Silva
+Maintainer-email: edsonporto88@gmail.com
+License: GPL-3.0 license
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Telecommunications Industry
+Classifier: Operating System :: Unix
+Classifier: Programming Language :: Python
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Software Development
+Requires-Python: >=3.2
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+
+.. image:: ../../figures/logo_OptiCommPy.jpg
+   :width: 75%  
+   :align: center
+
+**OptiCommPy** is a Python-based framework to simulate systems, subsystems, and 
+components of fiber optic communication systems, for educational and research purposes.
+
+.. image:: ../../figures/eyeDisp.gif
+     :width: 45%      
+.. image:: ../../figures/40GOOK_spectrum.jpg
+     :width: 45% 
+     
+
+.. image:: ../../figures/DSP.jpg
+     :width: 600px  
+     :align: center
+
+|PyPI| |PyPI - Downloads| |Documentation Status| |DOI|
+
+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 <https://en.wikipedia.org/wiki/Split-step_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 <https://numba.pydata.org/>`__ 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 <https://opticommpy.readthedocs.io/en/latest/index.html>`__.
+
+Citing this repository
+----------------------
+
+Edson Porto da Silva, Adolfo Herbster, Carlos Daniel Fontes da Silva, &
+Joaquin Matres. (2023). edsonportosilva/OptiCommPy: v0.7.0-alpha
+(v0.7.0-alpha). Zenodo. https://doi.org/10.5281/zenodo.10304945
+
+.. |PyPI| image:: https://img.shields.io/pypi/v/OptiCommPy?label=pypi%20package
+.. |PyPI - Downloads| image:: https://img.shields.io/pypi/dm/OptiCommPy
+.. |Documentation Status| image:: https://readthedocs.org/projects/opticommpy/badge/?version=latest
+   :target: https://opticommpy.readthedocs.io/en/latest/?badge=latest
+.. |DOI| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.10304945.svg
+   :target: https://doi.org/10.5281/zenodo.10304945
+
+   
+

{OptiCommPy-0.6.0 → OptiCommPy-0.9.0}/OptiCommPy.egg-info/SOURCES.txt

@@ -1,5 +1,5 @@
 LICENSE
-README.md
+README.rst
 runner
 setup.py
 OptiCommPy.egg-info/PKG-INFO
@@ -8,13 +8,13 @@ OptiCommPy.egg-info/dependency_links.txt
 OptiCommPy.egg-info/requires.txt
 OptiCommPy.egg-info/top_level.txt
 optic/__init__.py
-optic/core.py
 optic/plot.py
-optic/comm/fec.py
+optic/utils.py
 optic/comm/metrics.py
 optic/comm/modulation.py
 optic/comm/ofdm.py
 optic/dsp/carrierRecovery.py
+optic/dsp/clockRecovery.py
 optic/dsp/core.py
 optic/dsp/coreGPU.py
 optic/dsp/equalization.py
@@ -22,4 +22,7 @@ optic/models/amplification.py
 optic/models/channels.py
 optic/models/devices.py
 optic/models/modelsGPU.py
-optic/models/tx.py
+optic/models/tx.py
+tests/test_dsp.py
+tests/test_metrics.py
+tests/test_modulation.py

OptiCommPy-0.9.0/OptiCommPy.egg-info/requires.txt

@@ -0,0 +1,11 @@
+numpy>=1.24.4
+scipy>=1.13.0
+matplotlib>=3.7.0
+sympy
+tqdm>=4.64.1
+numba<=0.57,>=0.54.0
+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

OptiCommPy-0.9.0/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.1
+Name: OptiCommPy
+Version: 0.9.0
+Summary: Optical Communications Algorithms with Python
+Home-page: https://github.com/edsonportosilva/OptiCommPy
+Maintainer: Edson Porto da Silva
+Maintainer-email: edsonporto88@gmail.com
+License: GPL-3.0 license
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Telecommunications Industry
+Classifier: Operating System :: Unix
+Classifier: Programming Language :: Python
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Software Development
+Requires-Python: >=3.2
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+
+.. image:: ../../figures/logo_OptiCommPy.jpg
+   :width: 75%  
+   :align: center
+
+**OptiCommPy** is a Python-based framework to simulate systems, subsystems, and 
+components of fiber optic communication systems, for educational and research purposes.
+
+.. image:: ../../figures/eyeDisp.gif
+     :width: 45%      
+.. image:: ../../figures/40GOOK_spectrum.jpg
+     :width: 45% 
+     
+
+.. image:: ../../figures/DSP.jpg
+     :width: 600px  
+     :align: center
+
+|PyPI| |PyPI - Downloads| |Documentation Status| |DOI|
+
+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 <https://en.wikipedia.org/wiki/Split-step_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 <https://numba.pydata.org/>`__ 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 <https://opticommpy.readthedocs.io/en/latest/index.html>`__.
+
+Citing this repository
+----------------------
+
+Edson Porto da Silva, Adolfo Herbster, Carlos Daniel Fontes da Silva, &
+Joaquin Matres. (2023). edsonportosilva/OptiCommPy: v0.7.0-alpha
+(v0.7.0-alpha). Zenodo. https://doi.org/10.5281/zenodo.10304945
+
+.. |PyPI| image:: https://img.shields.io/pypi/v/OptiCommPy?label=pypi%20package
+.. |PyPI - Downloads| image:: https://img.shields.io/pypi/dm/OptiCommPy
+.. |Documentation Status| image:: https://readthedocs.org/projects/opticommpy/badge/?version=latest
+   :target: https://opticommpy.readthedocs.io/en/latest/?badge=latest
+.. |DOI| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.10304945.svg
+   :target: https://doi.org/10.5281/zenodo.10304945
+
+   
+

OptiCommPy-0.9.0/README.rst

@@ -0,0 +1,119 @@
+
+.. image:: ../../figures/logo_OptiCommPy.jpg
+   :width: 75%  
+   :align: center
+
+**OptiCommPy** is a Python-based framework to simulate systems, subsystems, and 
+components of fiber optic communication systems, for educational and research purposes.
+
+.. image:: ../../figures/eyeDisp.gif
+     :width: 45%      
+.. image:: ../../figures/40GOOK_spectrum.jpg
+     :width: 45% 
+     
+
+.. image:: ../../figures/DSP.jpg
+     :width: 600px  
+     :align: center
+
+|PyPI| |PyPI - Downloads| |Documentation Status| |DOI|
+
+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 <https://en.wikipedia.org/wiki/Split-step_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 <https://numba.pydata.org/>`__ 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 <https://opticommpy.readthedocs.io/en/latest/index.html>`__.
+
+Citing this repository
+----------------------
+
+Edson Porto da Silva, Adolfo Herbster, Carlos Daniel Fontes da Silva, &
+Joaquin Matres. (2023). edsonportosilva/OptiCommPy: v0.7.0-alpha
+(v0.7.0-alpha). Zenodo. https://doi.org/10.5281/zenodo.10304945
+
+.. |PyPI| image:: https://img.shields.io/pypi/v/OptiCommPy?label=pypi%20package
+.. |PyPI - Downloads| image:: https://img.shields.io/pypi/dm/OptiCommPy
+.. |Documentation Status| image:: https://readthedocs.org/projects/opticommpy/badge/?version=latest
+   :target: https://opticommpy.readthedocs.io/en/latest/?badge=latest
+.. |DOI| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.10304945.svg
+   :target: https://doi.org/10.5281/zenodo.10304945
+
+   
+