adnus

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:

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

Usage

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

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:

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

adnus（AdNuS）：高级数系库

adnus是一款专为数学家、科研人员及开发者打造的Python库，实现了多种超出标准实数与复数范畴的高级数系。

## 核心特性
- 调和数与奥雷斯姆序列：提供生成调和数与奥雷斯姆序列的专用函数。
- 双复（Bicomplex）数：实现双复数类，并支持完整的算术运算。
- 中智（Neutrosophic）数：提供中智数类，涵盖其复数与双复扩展形式。
- 超实（Hyperreal）数：实现超实数的概念性版本。
- 可扩展设计：基于抽象基类构建，可便捷扩展并新增数系类型。
- 全类型标注：库内实现完整的类型提示，以提升代码质量与可维护性。

## 安装指南
若需安装该库，可克隆仓库并通过Poetry进行安装：
bash
git clone https://github.com/WhiteSymmetry/adnus.git
cd adnus
poetry install

## 使用示例
以下为adnus中各类数系的快速使用示例：

### 双复（Bicomplex）数
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）数
python
import adnus as ad

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

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

## 测试运行
若需验证库功能是否正常，可通过pytest运行内置测试：
bash
poetry run pytest

## 安装说明（土耳其语）/ 安装说明（英语）
### 基于Python的安装 / 通过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

### 测试版安装
bash
pip install -i https://test.pypi.org/simple/ adnus -U

### GitHub主分支安装
#### 终端执行：
bash
pip install git+https://github.com/WhiteSymmetry/adnus.git

#### 在Jupyter Lab、Jupyter Notebook、Visual Studio Code中执行：
python
!pip install git+https://github.com/WhiteSymmetry/adnus.git

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