comyx


Namecomyx JSON
Version 0.2.4 PyPI version JSON
download
home_pageNone
SummaryComyx is an optimized and modular Python library for simulating wireless communication systems.
upload_time2024-03-24 19:44:26
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseNone
keywords python communication simulator wireless communication
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <p align="center">
  <img src="https://raw.githubusercontent.com/muhd-umer/comyx/main/resources/logo.png" width="600">
</p>

<!-- <p align="center">
    <a href="https://github.com/muhd-umer/comyx/actions?query=workflow:"build"" alt="build">
        <img src="https://github.com/muhd-umer/comyx/workflows/build/badge.svg" /></a>
    <a href="https://github.com/muhd-umer/comyx/releases/" alt="GitHub tag">
        <img src="https://img.shields.io/github/tag/muhd-umer/comyx?include_prereleases=&sort=semver&color=blue" /></a>
    <a href="https://badge.fury.io/py/comyx" alt="PyPI version">
        <img src="https://badge.fury.io/py/comyx.svg" /></a>
    <a href="#license" alt="License">
        <img src="https://img.shields.io/badge/license-MIT-blue?style=flat" /></a>
    <a href="/docs/" alt="view - Documentation">
        <img src="https://img.shields.io/badge/view-docs-blue?style=flat" /></a>
</p>

<p align="center">
    <a href="https://numpy.org/" alt="NumPy">
        <img src="https://img.shields.io/badge/NumPy-%23013243.svg?style=flat&logo=numpy&logoColor=white" /></a>
    <a href="https://scipy.org/" alt="SciPy">
        <img src="https://img.shields.io/badge/SciPy-%230C55A5.svg?style=flat&logo=scipy&logoColor=white" /></a>
    <a href="https://numba.pydata.org/" alt="Numba">
        <img src="https://img.shields.io/badge/Numba-009ed9?style=flat&logo=numba&logoColor=white" /></a>
    <a href="https://pytorch.org/" alt="PyTorch">
        <img src="https://img.shields.io/badge/PyTorch-%23EE4C2C.svg?flat&logo=PyTorch&logoColor=white" /></a>
</p> -->

# Comyx: Wireless Network Simulator

[![build](https://github.com/muhd-umer/comyx/workflows/build/badge.svg)](https://github.com/muhd-umer/comyx/actions?query=workflow:"build")
[![GitHub release](https://img.shields.io/github/release/muhd-umer/comyx?include_prereleases=&sort=semver&color=blue)](https://github.com/muhd-umer/comyx/releases/)
[![License](https://img.shields.io/badge/license-MIT-blue?style=flat)](#license)
[![view - Documentation](https://img.shields.io/badge/view-docs-blue?style=flat)](https://comyx.readthedocs.io/)
[![NumPy](https://img.shields.io/badge/NumPy-%23013243.svg?style=flat&logo=numpy&logoColor=white)](https://numpy.org/)
[![SciPy](https://img.shields.io/badge/SciPy-%230C55A5.svg?style=flat&logo=scipy&logoColor=white)](https://scipy.org/)
[![Numba](https://img.shields.io/badge/Numba-009ed9?style=flat&logo=numba&logoColor=white)](https://numba.pydata.org/)
[![PyTorch](https://img.shields.io/badge/PyTorch-%23EE4C2C.svg?flat&logo=PyTorch&logoColor=white)](https://pytorch.org/)

**Comyx** is a Python library for simulating wireless communication systems. It uses **NumPy** and **SciPy** for numerical computation, and **Numba** for just-in-time (JIT) compilation. It provides a number of features for simulating wireless communication systems:

- **B5G Features**: Supports a variety of B5G specific features, such as STAR-RIS, and NOMA.
- **Channel Models**: Provides the AWGN, Rayleigh, and Rician fading models.
- **Signal Modulation**: Supports a variety of modulation schemes, such as BPSK, QPSK, and QAM.
- **Performance Metrics**: Can calculate a variety of performance metrics, such as the sum rate, and outage probability.

## To-Do
- [ ] Update documentation
- [ ] Add network optimization support
- [ ] Add Reinforcement Learning (RL) support

## Installation

You can install the latest version of the package using pip:

```shell
pip install comyx
```

*Note: It is recommended to create a new virtual environment so that updates/downgrades of packages do not break other projects.*

Or you can clone the repository along with research code and perform an editable installation:

```shell
git clone https://github.com/muhd-umer/comyx.git
pip install -e .
```

**Reinforcement Learning (RL) Support**

For RL support, you will need to install the following dependencies:

- Install PyTorch (Stable)

    ```shell
    pip install torch torchvision torchaudio
    ```

- Install Ray RLlib

    ```shell
    pip install -U ray[default]  # core, dashboard, cluster launcher
    pip install -U ray[rllib]  # tune, rllib
    ```

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "comyx",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": "python, communication, simulator, wireless communication",
    "author": null,
    "author_email": "Muhammad Umer <thisismumer@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/be/05/25ac83450451687c6f29aaebc35f55299fa6b3155f182601713465f47b1d/comyx-0.2.4.tar.gz",
    "platform": null,
    "description": "<p align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/muhd-umer/comyx/main/resources/logo.png\" width=\"600\">\n</p>\n\n<!-- <p align=\"center\">\n    <a href=\"https://github.com/muhd-umer/comyx/actions?query=workflow:\"build\"\" alt=\"build\">\n        <img src=\"https://github.com/muhd-umer/comyx/workflows/build/badge.svg\" /></a>\n    <a href=\"https://github.com/muhd-umer/comyx/releases/\" alt=\"GitHub tag\">\n        <img src=\"https://img.shields.io/github/tag/muhd-umer/comyx?include_prereleases=&sort=semver&color=blue\" /></a>\n    <a href=\"https://badge.fury.io/py/comyx\" alt=\"PyPI version\">\n        <img src=\"https://badge.fury.io/py/comyx.svg\" /></a>\n    <a href=\"#license\" alt=\"License\">\n        <img src=\"https://img.shields.io/badge/license-MIT-blue?style=flat\" /></a>\n    <a href=\"/docs/\" alt=\"view - Documentation\">\n        <img src=\"https://img.shields.io/badge/view-docs-blue?style=flat\" /></a>\n</p>\n\n<p align=\"center\">\n    <a href=\"https://numpy.org/\" alt=\"NumPy\">\n        <img src=\"https://img.shields.io/badge/NumPy-%23013243.svg?style=flat&logo=numpy&logoColor=white\" /></a>\n    <a href=\"https://scipy.org/\" alt=\"SciPy\">\n        <img src=\"https://img.shields.io/badge/SciPy-%230C55A5.svg?style=flat&logo=scipy&logoColor=white\" /></a>\n    <a href=\"https://numba.pydata.org/\" alt=\"Numba\">\n        <img src=\"https://img.shields.io/badge/Numba-009ed9?style=flat&logo=numba&logoColor=white\" /></a>\n    <a href=\"https://pytorch.org/\" alt=\"PyTorch\">\n        <img src=\"https://img.shields.io/badge/PyTorch-%23EE4C2C.svg?flat&logo=PyTorch&logoColor=white\" /></a>\n</p> -->\n\n# Comyx: Wireless Network Simulator\n\n[![build](https://github.com/muhd-umer/comyx/workflows/build/badge.svg)](https://github.com/muhd-umer/comyx/actions?query=workflow:\"build\")\n[![GitHub release](https://img.shields.io/github/release/muhd-umer/comyx?include_prereleases=&sort=semver&color=blue)](https://github.com/muhd-umer/comyx/releases/)\n[![License](https://img.shields.io/badge/license-MIT-blue?style=flat)](#license)\n[![view - Documentation](https://img.shields.io/badge/view-docs-blue?style=flat)](https://comyx.readthedocs.io/)\n[![NumPy](https://img.shields.io/badge/NumPy-%23013243.svg?style=flat&logo=numpy&logoColor=white)](https://numpy.org/)\n[![SciPy](https://img.shields.io/badge/SciPy-%230C55A5.svg?style=flat&logo=scipy&logoColor=white)](https://scipy.org/)\n[![Numba](https://img.shields.io/badge/Numba-009ed9?style=flat&logo=numba&logoColor=white)](https://numba.pydata.org/)\n[![PyTorch](https://img.shields.io/badge/PyTorch-%23EE4C2C.svg?flat&logo=PyTorch&logoColor=white)](https://pytorch.org/)\n\n**Comyx** is a Python library for simulating wireless communication systems. It uses **NumPy** and **SciPy** for numerical computation, and **Numba** for just-in-time (JIT) compilation. It provides a number of features for simulating wireless communication systems:\n\n- **B5G Features**: Supports a variety of B5G specific features, such as STAR-RIS, and NOMA.\n- **Channel Models**: Provides the AWGN, Rayleigh, and Rician fading models.\n- **Signal Modulation**: Supports a variety of modulation schemes, such as BPSK, QPSK, and QAM.\n- **Performance Metrics**: Can calculate a variety of performance metrics, such as the sum rate, and outage probability.\n\n## To-Do\n- [ ] Update documentation\n- [ ] Add network optimization support\n- [ ] Add Reinforcement Learning (RL) support\n\n## Installation\n\nYou can install the latest version of the package using pip:\n\n```shell\npip install comyx\n```\n\n*Note: It is recommended to create a new virtual environment so that updates/downgrades of packages do not break other projects.*\n\nOr you can clone the repository along with research code and perform an editable installation:\n\n```shell\ngit clone https://github.com/muhd-umer/comyx.git\npip install -e .\n```\n\n**Reinforcement Learning (RL) Support**\n\nFor RL support, you will need to install the following dependencies:\n\n- Install PyTorch (Stable)\n\n    ```shell\n    pip install torch torchvision torchaudio\n    ```\n\n- Install Ray RLlib\n\n    ```shell\n    pip install -U ray[default]  # core, dashboard, cluster launcher\n    pip install -U ray[rllib]  # tune, rllib\n    ```\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Comyx is an optimized and modular Python library for simulating wireless communication systems.",
    "version": "0.2.4",
    "project_urls": {
        "homepage": "https://github.com/muhd-umer/comyx"
    },
    "split_keywords": [
        "python",
        " communication",
        " simulator",
        " wireless communication"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f502167898f8481d2b46c8afc55c8ee5d4dc0793aff4dc59e44d0b2e4b4d3d8c",
                "md5": "25d81376a508be17d245be47e4ca2c05",
                "sha256": "a76566c470c943e3de7b34ceab2aec6b4da8ebfcf0516e918ccf0c91831ae17c"
            },
            "downloads": -1,
            "filename": "comyx-0.2.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "25d81376a508be17d245be47e4ca2c05",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 28193,
            "upload_time": "2024-03-24T19:44:23",
            "upload_time_iso_8601": "2024-03-24T19:44:23.663780Z",
            "url": "https://files.pythonhosted.org/packages/f5/02/167898f8481d2b46c8afc55c8ee5d4dc0793aff4dc59e44d0b2e4b4d3d8c/comyx-0.2.4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "be0525ac83450451687c6f29aaebc35f55299fa6b3155f182601713465f47b1d",
                "md5": "2049e48fb714e93306f6213a6eac34d1",
                "sha256": "22eada85759427a1e52888d073e811e3b05fd849cc28650db80d927966ff0881"
            },
            "downloads": -1,
            "filename": "comyx-0.2.4.tar.gz",
            "has_sig": false,
            "md5_digest": "2049e48fb714e93306f6213a6eac34d1",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 9904802,
            "upload_time": "2024-03-24T19:44:26",
            "upload_time_iso_8601": "2024-03-24T19:44:26.003877Z",
            "url": "https://files.pythonhosted.org/packages/be/05/25ac83450451687c6f29aaebc35f55299fa6b3155f182601713465f47b1d/comyx-0.2.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-03-24 19:44:26",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "muhd-umer",
    "github_project": "comyx",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "comyx"
}
        
Elapsed time: 0.25676s