adnus


Nameadnus JSON
Version 0.1.1 PyPI version JSON
download
home_pageNone
SummaryA Python library for Advanced Number Systems (AdNuS), including Bicomplex, Neutrosophic, and Hyperreal numbers.
upload_time2025-08-07 12:33:11
maintainerNone
docs_urlNone
authorMehmet Keçeci
requires_python<4.0,>=3.11
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # adnus (AdNuS):  Advanced Number Systems.

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

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.16341919.svg)](https://doi.org/10.5281/zenodo.16341919)

[![WorkflowHub DOI](https://img.shields.io/badge/DOI-10.48546/workflowhub.datafile.23.1-blue)](https://doi.org/10.48546/workflowhub.datafile.23.1)

[![figshare DOI](https://img.shields.io/badge/DOI-10.6084/m9.figshare.29621336-blue)](https://doi.org/10.6084/m9.figshare.29621336)

[![OSF DOI](https://img.shields.io/badge/DOI-10.17605/OSF.IO/9C26Y-blue)](https://doi.org/10.17605/OSF.IO/9C26Y)

[![Anaconda-Server Badge](https://anaconda.org/bilgi/adnus/badges/version.svg)](https://anaconda.org/bilgi/adnus)
[![Anaconda-Server Badge](https://anaconda.org/bilgi/adnus/badges/latest_release_date.svg)](https://anaconda.org/bilgi/adnus)
[![Anaconda-Server Badge](https://anaconda.org/bilgi/adnus/badges/platforms.svg)](https://anaconda.org/bilgi/adnus)
[![Anaconda-Server Badge](https://anaconda.org/bilgi/adnus/badges/license.svg)](https://anaconda.org/bilgi/adnus)

[![Open Source](https://img.shields.io/badge/Open%20Source-Open%20Source-brightgreen.svg)](https://opensource.org/)
[![Documentation Status](https://app.readthedocs.org/projects/adnus/badge/?0.1.0=main)](https://adnus.readthedocs.io/en/latest)

[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/-/badge)](https://www.bestpractices.dev/projects/-)

[![Python CI](https://github.com/WhiteSymmetry/adnus/actions/workflows/python_ci.yml/badge.svg?branch=main)](https://github.com/WhiteSymmetry/adnus/actions/workflows/python_ci.yml)
[![codecov](https://codecov.io/gh/WhiteSymmetry/adnus/graph/badge.svg?token=ES98M5WZFI)](https://codecov.io/gh/WhiteSymmetry/adnus)
[![Documentation Status](https://readthedocs.org/projects/adnus/badge/?version=latest)](https://adnus.readthedocs.io/en/latest/)
[![Binder](https://terrarium.evidencepub.io/badge_logo.svg)](https://terrarium.evidencepub.io/v2/gh/WhiteSymmetry/adnus/HEAD)
[![PyPI version](https://badge.fury.io/py/adnus.svg)](https://badge.fury.io/py/adnus)
[![PyPI Downloads](https://static.pepy.tech/badge/adnus)](https://pepy.tech/projects/adnus)
[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](CODE_OF_CONDUCT.md)
[![Linted with Ruff](https://img.shields.io/badge/Linted%20with-Ruff-green?logo=python&logoColor=white)](https://github.com/astral-sh/ruff)

---

<p align="left">
    <table>
        <tr>
            <td style="text-align: center;">PyPI</td>
            <td style="text-align: center;">
                <a href="https://pypi.org/project/adnus/">
                    <img src="https://badge.fury.io/py/adnus.svg" alt="PyPI version" height="18"/>
                </a>
            </td>
        </tr>
        <tr>
            <td style="text-align: center;">Conda</td>
            <td style="text-align: center;">
                <a href="https://anaconda.org/bilgi/adnus">
                    <img src="https://anaconda.org/bilgi/adnus/badges/version.svg" alt="conda-forge version" height="18"/>
                </a>
            </td>
        </tr>
        <tr>
            <td style="text-align: center;">DOI</td>
            <td style="text-align: center;">
                <a href="https://doi.org/10.5281/zenodo.16341919">
                    <img src="https://zenodo.org/badge/DOI/10.5281/zenodo.16341919.svg" alt="DOI" height="18"/>
                </a>
            </td>
        </tr>
        <tr>
            <td style="text-align: center;">License: MIT</td>
            <td style="text-align: center;">
                <a href="https://opensource.org/licenses/MIT">
                    <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License" height="18"/>
                </a>
            </td>
        </tr>
    </table>
</p>

---
# adnus (AdNuS):  Advanced Number Systems.

`adnus` is a Python library that provides an implementation of various advanced number systems. This library is designed for mathematicians, researchers, and developers who need to work with number systems beyond the standard real and complex numbers.

## Features

- **Harmonic and Oresme Sequences**: Functions to generate harmonic numbers and Oresme sequences.
- **Bicomplex Numbers**: A class for bicomplex numbers with full arithmetic support.
- **Neutrosophic Numbers**: Classes for neutrosophic numbers, including their complex and bicomplex extensions.
- **Hyperreal Numbers**: A conceptual implementation of hyperreal numbers.
- **Extensible Design**: Built with an abstract base class to easily extend and add new number systems.
- **Fully Typed**: The library is fully type-hinted for better code quality and maintainability.

## Installation

To install the library, clone the repository and use Poetry:

```bash
git clone https://github.com/WhiteSymmetry/adnus.git
cd adnus
poetry install
```

## Kullanım (Türkçe) / Usage (English)

```python
import adnus
adnus.__version__
```

Here's a quick overview of how to use the different number systems available in `adnus`.

### Bicomplex Numbers

```python
import adnus as ad
#from adnus import BicomplexNumber

z1 = ad.BicomplexNumber(1 + 2j, 3 + 4j)
z2 = ad.BicomplexNumber(5 + 6j, 7 + 8j)

print(f"Addition: {z1 + z2}")
print(f"Multiplication: {z1 * z2}")
```

### Neutrosophic Numbers

```python
import adnus as ad
# from adnus import NeutrosophicNumber

n1 = ad.NeutrosophicNumber(1.5, 2.5)
n2 = ad. NeutrosophicNumber(3.0, 4.0)

print(f"Addition: {n1 + n2}")
print(f"Multiplication: {n1 * n2}")
```

## Running Tests

To ensure everything is working correctly, you can run the included tests using `pytest`:

```bash
poetry run pytest
```

---

## Kurulum (Türkçe) / Installation (English)

### Python ile Kurulum / Install with pip, conda, mamba
```bash
pip install adnus -U
python -m pip install -U adnus
conda install bilgi::adnus -y
mamba install bilgi::adnus -y
```

```diff
- pip uninstall adnus -y
+ pip install -U adnus
+ python -m pip install -U adnus
```

[PyPI](https://pypi.org/project/adnus/)

### Test Kurulumu / Test Installation

```bash
pip install -i https://test.pypi.org/simple/ adnus -U
```

### Github Master Kurulumu / GitHub Master Installation

**Terminal:**

```bash
pip install git+https://github.com/WhiteSymmetry/adnus.git
```

**Jupyter Lab, Notebook, Visual Studio Code:**

```python
!pip install git+https://github.com/WhiteSymmetry/adnus.git
# or
%pip install git+https://github.com/WhiteSymmetry/adnus.git
```

---

### Development
```bash
# Clone the repository
git clone https://github.com/WhiteSymmetry/adnus.git
cd adnus

# Install in development mode
python -m pip install -ve . # Install package in development mode

# Run tests
pytest

Notebook, Jupyterlab, Colab, Visual Studio Code
!python -m pip install git+https://github.com/WhiteSymmetry/adnus.git
```
---

## Citation

If this library was useful to you in your research, please cite us. Following the [GitHub citation standards](https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-citation-files), here is the recommended citation.

### BibTeX


### APA

```

Keçeci, M. (2025). adnus [Data set]. ResearchGate. https://doi.org/

Keçeci, M. (2025). adnus [Data set]. OSF. https://doi.org/10.17605/OSF.IO/9C26Y

Keçeci, M. (2025). adnus [Data set]. figshare. https://doi.org/10.6084/m9.figshare.29621336

Keçeci, M. (2025). adnus [Data set]. WorkflowHub. https://doi.org/10.48546/workflowhub.datafile.23.1

Keçeci, M. (2025). adnus. Open Science Articles (OSAs), Zenodo. https://doi.org/10.5281/zenodo.16341919

### Chicago

```


Keçeci, Mehmet. adnus [Data set]. ResearchGate, 2025. https://doi.org/

Keçeci, M. (2025). <i>adnus</i> (Version 1). figshare. https://doi.org/10.6084/m9.figshare.29621336

Keçeci, Mehmet. adnus [Data set]. WorkflowHub, 2025. https://doi.org/10.48546/workflowhub.datafile.23.1

Keçeci, Mehmet. adnus. Open Science Articles (OSAs), Zenodo, 2025. https://doi.org/10.5281/zenodo.16341919

```


### Lisans (Türkçe) / License (English)

```
This project is licensed under the MIT License.
```

## Contributing

Contributions are welcome! Please feel free to submit a pull request or open an issue for any bugs or feature requests.



            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "adnus",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<4.0,>=3.11",
    "maintainer_email": null,
    "keywords": null,
    "author": "Mehmet Ke\u00e7eci",
    "author_email": "mkececi@yaani.com",
    "download_url": "https://files.pythonhosted.org/packages/ab/13/ee59ec090dea2092636245b408ee1a1d6eafa11105347de489e7bd582abb/adnus-0.1.1.tar.gz",
    "platform": null,
    "description": "# adnus (AdNuS):  Advanced Number Systems.\n\n---\n[![PyPI version](https://badge.fury.io/py/adnus.svg)](https://badge.fury.io/py/adnus)\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.16341919.svg)](https://doi.org/10.5281/zenodo.16341919)\n\n[![WorkflowHub DOI](https://img.shields.io/badge/DOI-10.48546/workflowhub.datafile.23.1-blue)](https://doi.org/10.48546/workflowhub.datafile.23.1)\n\n[![figshare DOI](https://img.shields.io/badge/DOI-10.6084/m9.figshare.29621336-blue)](https://doi.org/10.6084/m9.figshare.29621336)\n\n[![OSF DOI](https://img.shields.io/badge/DOI-10.17605/OSF.IO/9C26Y-blue)](https://doi.org/10.17605/OSF.IO/9C26Y)\n\n[![Anaconda-Server Badge](https://anaconda.org/bilgi/adnus/badges/version.svg)](https://anaconda.org/bilgi/adnus)\n[![Anaconda-Server Badge](https://anaconda.org/bilgi/adnus/badges/latest_release_date.svg)](https://anaconda.org/bilgi/adnus)\n[![Anaconda-Server Badge](https://anaconda.org/bilgi/adnus/badges/platforms.svg)](https://anaconda.org/bilgi/adnus)\n[![Anaconda-Server Badge](https://anaconda.org/bilgi/adnus/badges/license.svg)](https://anaconda.org/bilgi/adnus)\n\n[![Open Source](https://img.shields.io/badge/Open%20Source-Open%20Source-brightgreen.svg)](https://opensource.org/)\n[![Documentation Status](https://app.readthedocs.org/projects/adnus/badge/?0.1.0=main)](https://adnus.readthedocs.io/en/latest)\n\n[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/-/badge)](https://www.bestpractices.dev/projects/-)\n\n[![Python CI](https://github.com/WhiteSymmetry/adnus/actions/workflows/python_ci.yml/badge.svg?branch=main)](https://github.com/WhiteSymmetry/adnus/actions/workflows/python_ci.yml)\n[![codecov](https://codecov.io/gh/WhiteSymmetry/adnus/graph/badge.svg?token=ES98M5WZFI)](https://codecov.io/gh/WhiteSymmetry/adnus)\n[![Documentation Status](https://readthedocs.org/projects/adnus/badge/?version=latest)](https://adnus.readthedocs.io/en/latest/)\n[![Binder](https://terrarium.evidencepub.io/badge_logo.svg)](https://terrarium.evidencepub.io/v2/gh/WhiteSymmetry/adnus/HEAD)\n[![PyPI version](https://badge.fury.io/py/adnus.svg)](https://badge.fury.io/py/adnus)\n[![PyPI Downloads](https://static.pepy.tech/badge/adnus)](https://pepy.tech/projects/adnus)\n[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](CODE_OF_CONDUCT.md)\n[![Linted with Ruff](https://img.shields.io/badge/Linted%20with-Ruff-green?logo=python&logoColor=white)](https://github.com/astral-sh/ruff)\n\n---\n\n<p align=\"left\">\n    <table>\n        <tr>\n            <td style=\"text-align: center;\">PyPI</td>\n            <td style=\"text-align: center;\">\n                <a href=\"https://pypi.org/project/adnus/\">\n                    <img src=\"https://badge.fury.io/py/adnus.svg\" alt=\"PyPI version\" height=\"18\"/>\n                </a>\n            </td>\n        </tr>\n        <tr>\n            <td style=\"text-align: center;\">Conda</td>\n            <td style=\"text-align: center;\">\n                <a href=\"https://anaconda.org/bilgi/adnus\">\n                    <img src=\"https://anaconda.org/bilgi/adnus/badges/version.svg\" alt=\"conda-forge version\" height=\"18\"/>\n                </a>\n            </td>\n        </tr>\n        <tr>\n            <td style=\"text-align: center;\">DOI</td>\n            <td style=\"text-align: center;\">\n                <a href=\"https://doi.org/10.5281/zenodo.16341919\">\n                    <img src=\"https://zenodo.org/badge/DOI/10.5281/zenodo.16341919.svg\" alt=\"DOI\" height=\"18\"/>\n                </a>\n            </td>\n        </tr>\n        <tr>\n            <td style=\"text-align: center;\">License: MIT</td>\n            <td style=\"text-align: center;\">\n                <a href=\"https://opensource.org/licenses/MIT\">\n                    <img src=\"https://img.shields.io/badge/License-MIT-yellow.svg\" alt=\"License\" height=\"18\"/>\n                </a>\n            </td>\n        </tr>\n    </table>\n</p>\n\n---\n# adnus (AdNuS):  Advanced Number Systems.\n\n`adnus` is a Python library that provides an implementation of various advanced number systems. This library is designed for mathematicians, researchers, and developers who need to work with number systems beyond the standard real and complex numbers.\n\n## Features\n\n- **Harmonic and Oresme Sequences**: Functions to generate harmonic numbers and Oresme sequences.\n- **Bicomplex Numbers**: A class for bicomplex numbers with full arithmetic support.\n- **Neutrosophic Numbers**: Classes for neutrosophic numbers, including their complex and bicomplex extensions.\n- **Hyperreal Numbers**: A conceptual implementation of hyperreal numbers.\n- **Extensible Design**: Built with an abstract base class to easily extend and add new number systems.\n- **Fully Typed**: The library is fully type-hinted for better code quality and maintainability.\n\n## Installation\n\nTo install the library, clone the repository and use Poetry:\n\n```bash\ngit clone https://github.com/WhiteSymmetry/adnus.git\ncd adnus\npoetry install\n```\n\n## Kullan\u0131m (T\u00fcrk\u00e7e) / Usage (English)\n\n```python\nimport adnus\nadnus.__version__\n```\n\nHere's a quick overview of how to use the different number systems available in `adnus`.\n\n### Bicomplex Numbers\n\n```python\nimport adnus as ad\n#from adnus import BicomplexNumber\n\nz1 = ad.BicomplexNumber(1 + 2j, 3 + 4j)\nz2 = ad.BicomplexNumber(5 + 6j, 7 + 8j)\n\nprint(f\"Addition: {z1 + z2}\")\nprint(f\"Multiplication: {z1 * z2}\")\n```\n\n### Neutrosophic Numbers\n\n```python\nimport adnus as ad\n# from adnus import NeutrosophicNumber\n\nn1 = ad.NeutrosophicNumber(1.5, 2.5)\nn2 = ad. NeutrosophicNumber(3.0, 4.0)\n\nprint(f\"Addition: {n1 + n2}\")\nprint(f\"Multiplication: {n1 * n2}\")\n```\n\n## Running Tests\n\nTo ensure everything is working correctly, you can run the included tests using `pytest`:\n\n```bash\npoetry run pytest\n```\n\n---\n\n## Kurulum (T\u00fcrk\u00e7e) / Installation (English)\n\n### Python ile Kurulum / Install with pip, conda, mamba\n```bash\npip install adnus -U\npython -m pip install -U adnus\nconda install bilgi::adnus -y\nmamba install bilgi::adnus -y\n```\n\n```diff\n- pip uninstall adnus -y\n+ pip install -U adnus\n+ python -m pip install -U adnus\n```\n\n[PyPI](https://pypi.org/project/adnus/)\n\n### Test Kurulumu / Test Installation\n\n```bash\npip install -i https://test.pypi.org/simple/ adnus -U\n```\n\n### Github Master Kurulumu / GitHub Master Installation\n\n**Terminal:**\n\n```bash\npip install git+https://github.com/WhiteSymmetry/adnus.git\n```\n\n**Jupyter Lab, Notebook, Visual Studio Code:**\n\n```python\n!pip install git+https://github.com/WhiteSymmetry/adnus.git\n# or\n%pip install git+https://github.com/WhiteSymmetry/adnus.git\n```\n\n---\n\n### Development\n```bash\n# Clone the repository\ngit clone https://github.com/WhiteSymmetry/adnus.git\ncd adnus\n\n# Install in development mode\npython -m pip install -ve . # Install package in development mode\n\n# Run tests\npytest\n\nNotebook, Jupyterlab, Colab, Visual Studio Code\n!python -m pip install git+https://github.com/WhiteSymmetry/adnus.git\n```\n---\n\n## Citation\n\nIf this library was useful to you in your research, please cite us. Following the [GitHub citation standards](https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-citation-files), here is the recommended citation.\n\n### BibTeX\n\n\n### APA\n\n```\n\nKe\u00e7eci, M. (2025). adnus [Data set]. ResearchGate. https://doi.org/\n\nKe\u00e7eci, M. (2025). adnus [Data set]. OSF. https://doi.org/10.17605/OSF.IO/9C26Y\n\nKe\u00e7eci, M. (2025). adnus [Data set]. figshare. https://doi.org/10.6084/m9.figshare.29621336\n\nKe\u00e7eci, M. (2025). adnus [Data set]. WorkflowHub. https://doi.org/10.48546/workflowhub.datafile.23.1\n\nKe\u00e7eci, M. (2025). adnus. Open Science Articles (OSAs), Zenodo. https://doi.org/10.5281/zenodo.16341919\n\n### Chicago\n\n```\n\n\nKe\u00e7eci, Mehmet. adnus [Data set]. ResearchGate, 2025. https://doi.org/\n\nKe\u00e7eci, M. (2025). <i>adnus</i> (Version 1). figshare. https://doi.org/10.6084/m9.figshare.29621336\n\nKe\u00e7eci, Mehmet. adnus [Data set]. WorkflowHub, 2025. https://doi.org/10.48546/workflowhub.datafile.23.1\n\nKe\u00e7eci, Mehmet. adnus. Open Science Articles (OSAs), Zenodo, 2025. https://doi.org/10.5281/zenodo.16341919\n\n```\n\n\n### Lisans (T\u00fcrk\u00e7e) / License (English)\n\n```\nThis project is licensed under the MIT License.\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a pull request or open an issue for any bugs or feature requests.\n\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A Python library for Advanced Number Systems (AdNuS), including Bicomplex, Neutrosophic, and Hyperreal numbers.",
    "version": "0.1.1",
    "project_urls": null,
    "split_keywords": [],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "8cecc5559592c415eec568e5b5fb9ac1966beca6fac9e4a8f32846f9343fa072",
                "md5": "539ba817a228a5727e1d147bbd912993",
                "sha256": "449ca1953fc552eff196a290d8940f163e74dbb7afaf47e76d407da8578e1bdc"
            },
            "downloads": -1,
            "filename": "adnus-0.1.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "539ba817a228a5727e1d147bbd912993",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4.0,>=3.11",
            "size": 7748,
            "upload_time": "2025-08-07T12:33:10",
            "upload_time_iso_8601": "2025-08-07T12:33:10.021914Z",
            "url": "https://files.pythonhosted.org/packages/8c/ec/c5559592c415eec568e5b5fb9ac1966beca6fac9e4a8f32846f9343fa072/adnus-0.1.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "ab13ee59ec090dea2092636245b408ee1a1d6eafa11105347de489e7bd582abb",
                "md5": "ffe745218c4644802ec112725330afaa",
                "sha256": "a6846fdc96ed775e34efc41255e6dd3361d84b33ae57a62cd9677873c418e947"
            },
            "downloads": -1,
            "filename": "adnus-0.1.1.tar.gz",
            "has_sig": false,
            "md5_digest": "ffe745218c4644802ec112725330afaa",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4.0,>=3.11",
            "size": 6619,
            "upload_time": "2025-08-07T12:33:11",
            "upload_time_iso_8601": "2025-08-07T12:33:11.652549Z",
            "url": "https://files.pythonhosted.org/packages/ab/13/ee59ec090dea2092636245b408ee1a1d6eafa11105347de489e7bd582abb/adnus-0.1.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-07 12:33:11",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "adnus"
}
        
Elapsed time: 0.50530s