Skip to main content

A Python library for Advanced Number Systems (AdNuS), including Bicomplex, Neutrosophic, Hyperreal numbers, reals, Complex, Quaternion, Octonion, Sedenion, Pathion, Chingon, Routon, Voudon.

Project description

adnus (AdNuS): Advanced Number Systems.


PyPI version

License: MIT

DOI

WorkflowHub DOI

figshare DOI

OSF DOI

Anaconda-Server Badge Anaconda-Server Badge Anaconda-Server Badge Anaconda-Server Badge

Open Source Documentation Status

OpenSSF Best Practices

Python CI codecov Documentation Status Binder PyPI version PyPI Downloads Contributor Covenant Linted with Ruff


PyPI PyPI version
Conda conda-forge version
DOI DOI
License: AGPL License


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.
  • Real numbers
  • Complex numbers
  • Quaternion numbers
  • Octonion numbers
  • Sedenion numbers
  • Pathion numbers
  • Chingon numbers
  • Routon numbers
  • Voudon numbers

Installation

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

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

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

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

Bicomplex Numbers

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

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}")
import adnus as ad 
C = ad.cayley_dickson_construction(ad.Complex)
print(C(3-7j))
import adnus as ad 
q1 = ad.Quaternion(1, 2, 3, 4)
q2 = ad.Quaternion(5, 6, 7, 8)
print(f"Quaternions: {q1} * {q2} = {q1 * q2}")

Running Tests

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

poetry run pytest

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

Python ile Kurulum / Install with pip, conda, mamba

pip install adnus -U
python -m pip install -U adnus
conda install bilgi::adnus -y
mamba install bilgi::adnus -y
- pip uninstall adnus -y
+ pip install -U adnus
+ python -m pip install -U adnus

PyPI

Test Kurulumu / Test Installation

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

Github Master Kurulumu / GitHub Master Installation

Terminal:

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

Jupyter Lab, Notebook, Visual Studio Code:

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

Development

# 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, 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). adnus [Data set]. 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 AGPL License.

Contributing

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

adnus-0.1.8.tar.gz (49.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

adnus-0.1.8-py3-none-any.whl (21.4 kB view details)

Uploaded Python 3

File details

Details for the file adnus-0.1.8.tar.gz.

File metadata

  • Download URL: adnus-0.1.8.tar.gz
  • Upload date:
  • Size: 49.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for adnus-0.1.8.tar.gz
Algorithm Hash digest
SHA256 bb0f6bb80a2d91fc166d1e2d80b4b36ed77346b63938ec0aca0bd15d14369228
MD5 d40a378c3f670862540ed68e5c0ecafd
BLAKE2b-256 9279e6233cd5b67a4b525d4aa776b2cf1dddaeaffd94e0c0f66f88e7ac78403e

See more details on using hashes here.

Provenance

The following attestation bundles were made for adnus-0.1.8.tar.gz:

Publisher: workflow.yml on WhiteSymmetry/adnus

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file adnus-0.1.8-py3-none-any.whl.

File metadata

  • Download URL: adnus-0.1.8-py3-none-any.whl
  • Upload date:
  • Size: 21.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for adnus-0.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 f079233ba926695193f266c1cc74c8c7c59d375aecd85dd9ede3c7fa043430a1
MD5 902a253676a8ae7fc58ec7b4bd55a283
BLAKE2b-256 7892ee57c10ab7c8ce482a11ae66e717ba13e84bbf48729464e6fb1bfc8ca2bd

See more details on using hashes here.

Provenance

The following attestation bundles were made for adnus-0.1.8-py3-none-any.whl:

Publisher: workflow.yml on WhiteSymmetry/adnus

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page