https://github.com/catkira/py3gpp

A Python package for 5G-NR simulations
https://github.com/catkira/py3gpp

5g 5g-nr 5g-simulation matlab python

Last synced: 2 days ago
JSON representation

A Python package for 5G-NR simulations

• Host: GitHub
• URL: https://github.com/catkira/py3gpp
• Owner: catkira
• License: agpl-3.0
• Created: 2022-11-19T09:42:57.000Z (about 2 years ago)
• Default Branch: master
• Last Pushed: 2024-11-01T15:32:40.000Z (about 2 months ago)
• Last Synced: 2024-12-13T19:14:10.632Z (9 days ago)
• Topics: 5g, 5g-nr, 5g-simulation, matlab, python
• Language: Python
• Homepage:
• Size: 26.8 MB
• Stars: 100
• Watchers: 10
• Forks: 18
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![CI](https://github.com/catkira/py3gpp/actions/workflows/lint_and_test.yml/badge.svg)](https://github.com/catkira/py3gpp/actions/workflows/lint_and_test.yml)

[![Pylint](https://catkira.github.io/py3gpp/pylint.svg)](https://github.com/catkira/py3gpp/actions/workflows/python-package.yml)

[![PyPI version](https://badge.fury.io/py/py3gpp.svg)](https://badge.fury.io/py/py3gpp)

[![Downloads](https://static.pepy.tech/badge/py3gpp)](https://pepy.tech/project/py3gpp)

# Summary

This python package aims to replace the Matlab 5G Toolbox in Python. The call syntax of functions is the same as in matlab where possible. There are some differences, because matlab allows to continuously index a multidimensional array in one axis. In python this is not possible, therefore the result of functions like nrPBCHIndices() is also multidimensional here to make it compatible with Python.

# Installation

'python3 -m pip install py3gpp'

or

clone this repo and then do 'python3 -m pip install -e .'

# Getting started

run 'examples/test_py3gpp.ipynb'

The example data is ideal data generated with Matlab, but the code has been tested with real data that has CFO, SFO and noise.

# Documentation

See Matlab documentation of equivalent function

# Coding Guideline

## Formatting

* Screen width 120

* spaces on each side of math operators like +-*/

## Testing

* Each function must have a hard-coded test that can run on CI

* Each function should have a Matlab test that can run on a machine with Matlab license

* Hard-coded test cases should cover the most common argument combinations

* Matlab tests should cover more argument combinations than the hard-coded tests

## Function interface

* Functions should return numpy arrays if the return value is an array

* Functions should accept numpy arrays and python lists if an input value is an array

* Config objects should have a getter and setter method and declare the internal variable with underscore at the beginning

* Input arguments should be checked and a 'ValueError' or 'TypeError' should be raised if an argument is not correct