API Reference

This section provides auto-generated documentation for the public API of the kececinumbers module. It includes high-level functions, core components, custom classes, and constants.

For this to work correctly, your Python code should have well-written docstrings following a standard format (like Google or NumPy style).

High-Level Functions

These are the main functions intended for direct user interaction.

kececinumbers.get_with_params(kececi_type_choice: int, iterations: int, start_value_raw: str, add_value_raw: str, include_intermediate_steps: bool = True, first_divisor: int = 3, ask_plus_first: bool = True) → List[Any][source]

Keçeci sayıları serisi üretir. :param kececi_type_choice: 1-23 arası tip numarası :param iterations: adım sayısı :param start_value_raw: başlangıç değeri (string) :param add_value_raw: artım değeri (string) :param include_intermediate_steps: ara adımlar dahil mi? :param first_divisor: ilk bölen sayısı (varsayılan 3) :param ask_plus_first: ASK işleminde önce +1 mi? (True=+1 önce, False=-1 önce)

Returns:

Seri listesi

kececinumbers.get_interactive(auto_values: Dict[str, str] | None = None) → Tuple[List[Any], Dict[str, Any]][source]

Interactively (or programmatically via auto_values) gets parameters to generate a Keçeci sequence.

kececinumbers.get_random_type(num_iterations: int = 10, fixed_start_raw: str | float | int = '0', fixed_add_base_scalar: str | float | int = 9.0, exclude_types: List[int] | None = None, seed: int | None = None) → List[Any][source]

Generates Keçeci Numbers for a randomly selected type.

Parameters:

  • num_iterations – Number of iterations to generate

  • fixed_start_raw – Starting value (can be string, float, or int)

  • fixed_add_base_scalar – Value to add each iteration (can be string, float, or int)

  • exclude_types – List of type numbers to exclude from random selection

  • seed – Random seed for reproducible results

Returns:

List of generated Keçeci numbers

Core Generation & Analysis

These functions provide the core logic for sequence generation and mathematical analysis.

kececinumbers.unified_generator(kececi_type: int, start_input_raw: str, add_input_raw: str, iterations: int, operation='ask', include_intermediate_steps: bool = True, first_divisor: int = 3, ask_plus_first: bool = True) → List[Any][source]

  1. Başlangıç değerini parse et → start_value

  2. Artış değerini parse et → add_value

  3. İşlem tipine göre (operation) döngüyü çalıştır: - ‘ask’: Collatz benzeri kural - ‘add’: Sadece toplama - ‘multiply’: Çarpma - vs.

  4. Her adımda: - include_intermediate_steps=True ise TÜM değerleri kaydet - False ise sadece ana adımları kaydet

Keçeci sayıları üretici – 23 farklı sayı sistemi için ask_unit kullanır. Tüm matematiksel işlemler (+, -, *, /, %, is_prime_like) tip-specific olarak tanımlanmıştır.

kececinumbers.find_kececi_prime_number(kececi_numbers_list: List[Any], include_intermediate_steps: bool = True, min_repeats: int = 3) → int | None[source]

ASK algoritması ile üretilmiş dizide (ara adımlar dahil) döngüdeki ilk asal sayıyı (KPN) bulur.

Parametreler:

kececi_numbers_list: _generate_ask_sequence_complete ile üretilmiş dizi. include_intermediate_steps: Dizi sözlük listesi içeriyorsa True (varsayılan), düz liste ise False. min_repeats: find_period için minimum tekrar sayısı.

Dönüş:

KPN (int) veya None (döngü veya asal yoksa).

kececinumbers.is_prime(n_input: Any) → bool[source]

Checks if a given number (or its principal component) is prime using the robust sympy.isprime function.

Custom Number Classes

These classes define the custom algebraic structures supported by the library.

class kececinumbers.NeutrosophicNumber(t: float = 0.0, i: float = 0.0, f: float = 0.0)[source]

Nötrosofik sayı sınıfı: t + iI + fF formunda t = doğruluk değeri (truth) i = belirsizlik değeri (indeterminacy) f = yanlışlık değeri (falsity)

accuracy() → float[source]

Doğruluk değeri

conjugate() → NeutrosophicNumber[source]

Nötrosofik eşlenik (belirsizlik ve yanlışlık işaret değiştirir)

classmethod falsity(value: float) → NeutrosophicNumber[source]

Sadece yanlışlık içeren sayı

classmethod from_string(s: str) → NeutrosophicNumber[source]

String ifadeden oluştur (örn: ‘3+2I+1F’ veya ‘3+2I’)

classmethod from_tuple(tpl: Tuple[float, float, float]) → NeutrosophicNumber[source]

Tuple’dan oluştur

classmethod indeterminacy(value: float) → NeutrosophicNumber[source]

Sadece belirsizlik içeren sayı

magnitude() → float[source]

Euclidean norm (büyüklük)

normalized() → NeutrosophicNumber[source]

Birim büyüklüğe normalize edilmiş sayı

score() → float[source]

Net skor: doğruluk - yanlışlık

to_tuple() → Tuple[float, float, float][source]

Tuple temsili

classmethod truth(value: float) → NeutrosophicNumber[source]

Sadece doğruluk değeri içeren sayı

uncertainty() → float[source]

Belirsizlik seviyesi

class kececinumbers.NeutrosophicComplexNumber(real: float = 0.0, imag: float = 0.0, indeterminacy: float = 0.0)[source]

Nötrosofik karmaşık sayı: (a + bj) + cI formunda a = gerçel kısım, b = sanal kısım, c = belirsizlik

property complex_part: complex

Karmaşık kısmı döndür

conjugate() → NeutrosophicComplexNumber[source]

Karmaşık eşlenik (belirsizlik değişmez)

classmethod from_complex(z: complex, indeterminacy: float = 0.0) → NeutrosophicComplexNumber[source]

Karmaşık sayıdan oluştur

classmethod from_polar(r: float, theta: float, indeterminacy: float = 0.0) → NeutrosophicComplexNumber[source]

Kutupsal koordinatlardan oluştur

magnitude_sq() → float[source]

Karmaşık kısmın büyüklük karesi

phase() → float[source]

Faz açısı

to_polar() → Tuple[float, float, float][source]

Kutupsal koordinatlara dönüşüm

class kececinumbers.HyperrealNumber(*args)[source]

Represents a hyperreal number as a sequence of real numbers.

property finite

Returns the finite part (first component)

property infinitesimal

Returns the first infinitesimal part (second component)

class kececinumbers.BicomplexNumber(z1: complex, z2: complex)[source]

Represents a bicomplex number with two complex components.

class kececinumbers.NeutrosophicBicomplexNumber(a=0, b=0, c=0, d=0, e=0, f=0, g=0, h=0)[source]
property coeffs: list

Tüm katsayıları liste olarak döndürür.

property imag: list

Sanal kısımları (gerçel kısım hariç) döndürür.

Visualization & Reporting

kececinumbers.plot_numbers(sequence: List[Any], title: str = 'Keçeci Number Sequence Analysis')[source]

Tüm 23 Keçeci Sayı türü için detaylı görselleştirme sağlar.

kececinumbers.print_detailed_report(sequence: List[Any], params: Dict[str, Any], show_all: bool = False) → None[source]

Generates and logs a detailed report of the sequence results.

Parameters:

  • sequence – generated sequence (list)

  • params – dict of parameters used to generate the sequence

  • show_all – if True, include full sequence in the log; otherwise only preview

Module Constants

These constants are used to specify the number type in functions like get_with_params.

Keçeci Number Types

kececinumbers.TYPE_POSITIVE_REAL
kececinumbers.TYPE_NEGATIVE_REAL
kececinumbers.TYPE_COMPLEX
kececinumbers.TYPE_FLOAT
kececinumbers.TYPE_RATIONAL
kececinumbers.TYPE_QUATERNION
kececinumbers.TYPE_NEUTROSOPHIC
kececinumbers.TYPE_NEUTROSOPHIC_COMPLEX
kececinumbers.TYPE_HYPERREAL
kececinumbers.TYPE_BICOMPLEX
kececinumbers.TYPE_NEUTROSOPHIC_BICOMPLEX