qosst-bob


Nameqosst-bob JSON
Version 0.10.2 PyPI version JSON
download
home_pagehttps://github.com/qosst
SummaryBob submodule of QOSST, containing modules for Bob client, the GUI, the DSP of Bob and parameters estimation.
upload_time2024-06-29 08:23:46
maintainerNone
docs_urlNone
authorYoann Piétri
requires_python<3.13,>=3.9
licenseGPLv3
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # qosst-bob

<center>

![QOSST Logo](qosst_logo_full.png)

<a href='https://qosst-bob.readthedocs.io/en/latest/?badge=latest'>
    <img src='https://readthedocs.org/projects/qosst-bob/badge/?version=latest' alt='Documentation Status' />
</a>
<a href="https://github.com/qosst/qosst-bob/blob/main/LICENSE"><img alt="Github - License" src="https://img.shields.io/github/license/qosst/qosst-bob"/></a>
<a href="https://github.com/qosst/qosst-bob/releases/latest"><img alt="Github - Release" src="https://img.shields.io/github/v/release/qosst/qosst-bob"/></a>
<a href="https://pypi.org/project/qosst-bob/"><img alt="PyPI - Version" src="https://img.shields.io/pypi/v/qosst-bob"></a>
<a href="https://github.com/psf/black"><img alt="Code style: black" src="https://img.shields.io/badge/code%20style-black-000000.svg"></a>
<a href="https://github.com/pylint-dev/pylint"><img alt="Linting with pylint" src="https://img.shields.io/badge/linting-pylint-yellowgreen"/></a>
<a href="https://mypy-lang.org/"><img alt="Checked with mypy" src="https://www.mypy-lang.org/static/mypy_badge.svg"></a>
<a href="https://img.shields.io/pypi/pyversions/qosst-bob">
    <img alt="Python Version" src="https://img.shields.io/pypi/pyversions/qosst-bob">
</a>
<img alt="Docstr coverage" src=".docs_badge.svg" />
</center>
<hr/>

This project is part of [QOSST](https://github.com/qosst/qosst).

## Features

`qosst-bob` is the module of QOSST in charge of the functionalities of Bob for CV-QKD. In particular it includes:

* Acquisition of the signal detected by Bob's detector;
* Digital Signal Processing of the acquired signal to recover the symbols sent by Alice;
* Correlations analysis to estimate the parameters of the channel;
* Bob's client to interact with Alice's server;
* Interfaces to this client (scripts and graphical interface).

## Installation

The module can be installed with the following command:

```console
pip install qosst-bob
```

It is also possible to install it directly from the github repository:

```console
pip install git+https://github.com/qosst/qosst-bob
```

It also possible to clone the repository before and install it with pip or poetry

```console
git clone https://github.com/qosst/qosst-bob
cd qosst-alice
poetry install
pip install .
```

## Documentation

The whole documentation can be found at https://qosst-bob.readthedocs.io/en/latest/

## Usage of the client

The client can either be used with the graphical interface, with one of the provided script (optimize, excess noise or transmittance) or in a home-made script.

In any case the first step is to create a configuration file. This can be done with a command line tool shipped with the `qosst-core` package (which is a dependency of `qosst-alice`):

```console
qosst configuration create
```

This will create the default configuration file at the location `config.toml` (you change the location with the `-f` or `--file` option). For more information on the meaning of each parameter in the configuration and how to change them, check the [qosst tutorial](https://qosst.readthedocs.io/en/latest/tutorial.html).

### GUI usage

The GUI can be launched with the following command:

```console
qosst-bob-gui
```

A tutorial on the GUI can be found in the documentation.

### Scripts usage

The command line of the three scripts are given below:

```console
qosst-bob-excess-noise
qosst-bob-optimize
qosst-bob-transmittance
```

A good start is to add the `-h` flag to get information on the command line options. An extensive documentation is also written in the CLI section of the documentation.

### Usage in home-made scripts

It's possible to import Bob's client:

```python
from qosst_bob.bob import Bob
```

and use it in home-made script. Please refer to the documentation for more details.

## License

As for all submodules of QOSST, `qosst-bob` is shipped under the [Gnu General Public License v3](https://www.gnu.org/licenses/gpl-3.0.html).

## Contributing

Contribution are more than welcomed, either by reporting issues or proposing merge requests. Please check the contributing section of the [QOSST](https://github.com/qosst/qosst) project fore more information.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/qosst",
    "name": "qosst-bob",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<3.13,>=3.9",
    "maintainer_email": null,
    "keywords": null,
    "author": "Yoann Pi\u00e9tri",
    "author_email": "Yoann.Pietri@lip6.fr",
    "download_url": "https://files.pythonhosted.org/packages/f8/44/81a63c80b35c34cb01793bd4cdc09d71bc2ce306309126fb5467a595ecd5/qosst_bob-0.10.2.tar.gz",
    "platform": null,
    "description": "# qosst-bob\n\n<center>\n\n![QOSST Logo](qosst_logo_full.png)\n\n<a href='https://qosst-bob.readthedocs.io/en/latest/?badge=latest'>\n    <img src='https://readthedocs.org/projects/qosst-bob/badge/?version=latest' alt='Documentation Status' />\n</a>\n<a href=\"https://github.com/qosst/qosst-bob/blob/main/LICENSE\"><img alt=\"Github - License\" src=\"https://img.shields.io/github/license/qosst/qosst-bob\"/></a>\n<a href=\"https://github.com/qosst/qosst-bob/releases/latest\"><img alt=\"Github - Release\" src=\"https://img.shields.io/github/v/release/qosst/qosst-bob\"/></a>\n<a href=\"https://pypi.org/project/qosst-bob/\"><img alt=\"PyPI - Version\" src=\"https://img.shields.io/pypi/v/qosst-bob\"></a>\n<a href=\"https://github.com/psf/black\"><img alt=\"Code style: black\" src=\"https://img.shields.io/badge/code%20style-black-000000.svg\"></a>\n<a href=\"https://github.com/pylint-dev/pylint\"><img alt=\"Linting with pylint\" src=\"https://img.shields.io/badge/linting-pylint-yellowgreen\"/></a>\n<a href=\"https://mypy-lang.org/\"><img alt=\"Checked with mypy\" src=\"https://www.mypy-lang.org/static/mypy_badge.svg\"></a>\n<a href=\"https://img.shields.io/pypi/pyversions/qosst-bob\">\n    <img alt=\"Python Version\" src=\"https://img.shields.io/pypi/pyversions/qosst-bob\">\n</a>\n<img alt=\"Docstr coverage\" src=\".docs_badge.svg\" />\n</center>\n<hr/>\n\nThis project is part of [QOSST](https://github.com/qosst/qosst).\n\n## Features\n\n`qosst-bob` is the module of QOSST in charge of the functionalities of Bob for CV-QKD. In particular it includes:\n\n* Acquisition of the signal detected by Bob's detector;\n* Digital Signal Processing of the acquired signal to recover the symbols sent by Alice;\n* Correlations analysis to estimate the parameters of the channel;\n* Bob's client to interact with Alice's server;\n* Interfaces to this client (scripts and graphical interface).\n\n## Installation\n\nThe module can be installed with the following command:\n\n```console\npip install qosst-bob\n```\n\nIt is also possible to install it directly from the github repository:\n\n```console\npip install git+https://github.com/qosst/qosst-bob\n```\n\nIt also possible to clone the repository before and install it with pip or poetry\n\n```console\ngit clone https://github.com/qosst/qosst-bob\ncd qosst-alice\npoetry install\npip install .\n```\n\n## Documentation\n\nThe whole documentation can be found at https://qosst-bob.readthedocs.io/en/latest/\n\n## Usage of the client\n\nThe client can either be used with the graphical interface, with one of the provided script (optimize, excess noise or transmittance) or in a home-made script.\n\nIn any case the first step is to create a configuration file. This can be done with a command line tool shipped with the `qosst-core` package (which is a dependency of `qosst-alice`):\n\n```console\nqosst configuration create\n```\n\nThis will create the default configuration file at the location `config.toml` (you change the location with the `-f` or `--file` option). For more information on the meaning of each parameter in the configuration and how to change them, check the [qosst tutorial](https://qosst.readthedocs.io/en/latest/tutorial.html).\n\n### GUI usage\n\nThe GUI can be launched with the following command:\n\n```console\nqosst-bob-gui\n```\n\nA tutorial on the GUI can be found in the documentation.\n\n### Scripts usage\n\nThe command line of the three scripts are given below:\n\n```console\nqosst-bob-excess-noise\nqosst-bob-optimize\nqosst-bob-transmittance\n```\n\nA good start is to add the `-h` flag to get information on the command line options. An extensive documentation is also written in the CLI section of the documentation.\n\n### Usage in home-made scripts\n\nIt's possible to import Bob's client:\n\n```python\nfrom qosst_bob.bob import Bob\n```\n\nand use it in home-made script. Please refer to the documentation for more details.\n\n## License\n\nAs for all submodules of QOSST, `qosst-bob` is shipped under the [Gnu General Public License v3](https://www.gnu.org/licenses/gpl-3.0.html).\n\n## Contributing\n\nContribution are more than welcomed, either by reporting issues or proposing merge requests. Please check the contributing section of the [QOSST](https://github.com/qosst/qosst) project fore more information.\n",
    "bugtrack_url": null,
    "license": "GPLv3",
    "summary": "Bob submodule of QOSST, containing modules for Bob client, the GUI, the DSP of Bob and parameters estimation.",
    "version": "0.10.2",
    "project_urls": {
        "Documentation": "https://qosst-bob.readthedocs.io/",
        "Homepage": "https://github.com/qosst",
        "Repository": "https://github.com/qosst/qosst-bob"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b28578c772cfa7352b7e64a7220b18cc60ec7e412b3f1684b7b1cf8ccfb56486",
                "md5": "412683b2406c817318545d40d42652ee",
                "sha256": "182c6b5bcf4d2affdff1a68216b4248c856734c4d877b1393ee82f7dea973dfa"
            },
            "downloads": -1,
            "filename": "qosst_bob-0.10.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "412683b2406c817318545d40d42652ee",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<3.13,>=3.9",
            "size": 163288,
            "upload_time": "2024-06-29T08:23:44",
            "upload_time_iso_8601": "2024-06-29T08:23:44.502139Z",
            "url": "https://files.pythonhosted.org/packages/b2/85/78c772cfa7352b7e64a7220b18cc60ec7e412b3f1684b7b1cf8ccfb56486/qosst_bob-0.10.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f84481a63c80b35c34cb01793bd4cdc09d71bc2ce306309126fb5467a595ecd5",
                "md5": "a2d513249e62ba447ccedfe5c757d5dc",
                "sha256": "f21b0046a11adbff5ad7a440f09709da65aea14d539d5c04ee5d7ac27b02b8c7"
            },
            "downloads": -1,
            "filename": "qosst_bob-0.10.2.tar.gz",
            "has_sig": false,
            "md5_digest": "a2d513249e62ba447ccedfe5c757d5dc",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<3.13,>=3.9",
            "size": 134513,
            "upload_time": "2024-06-29T08:23:46",
            "upload_time_iso_8601": "2024-06-29T08:23:46.927924Z",
            "url": "https://files.pythonhosted.org/packages/f8/44/81a63c80b35c34cb01793bd4cdc09d71bc2ce306309126fb5467a595ecd5/qosst_bob-0.10.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-06-29 08:23:46",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "qosst",
    "github_project": "qosst-bob",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "qosst-bob"
}
        
Elapsed time: 0.38569s