kececicurve 0.1.1

kececicurve, Keçeci Curve, Keçeci Eğrisi Modülü

kececicurve

Keçeci Curve (kececicurve, Keçeci Eğrisi)

---

PyPI
Conda
DOI
License: AGPL

---

🌿 Keçeci Curve (kececicurve: Keçeci Eğrisi) – Parametric Space-Filling Curve Family

Keçeci Eğrisi, uzay doldurma eğrileri ailesine yeni, tamamen özgün ve son derece esnek bir üyedir.
Dairesel geometri, ayarlanabilir çocuk sayısı, büyüme yönü, sıralama stratejileri ve açı varyasyonları ile klasik eğrilerin ötesine geçen parametrik bir fraktal eğri üretecidir.

Bu depo aynı zamanda Hilbert, Morton, Moore ve Sierpinski eğrilerini de içerir; lokalite (yerellik) karşılaştırmaları, süreklilik analizleri ve ileri kuantum fenomenlerinin (Majorana, Weyl, topolojik yarımetaller, Stratum modeli) 2B/3B görselleştirmelerini sunar.

---

✨ Öne Çıkan Özellikler

• 🎛️ Tamamen Parametrik Üretim

  • Çocuk sayısı (num_children): 2'den 20'ye kadar istenen simetri.
  • Büyüme modları: inward, outward, tangent, overlapping.
  • Sıralama stratejileri: Sıralı, alternatif, spiral, rastgele, çeyrek tabanlı...
  • Açı ofseti ve varyasyonu ile dinamik şekil kontrolü.

• 📊 Yerleşik Karşılaştırma Araçları

  • Lokalite ısı haritaları (Hilbert, Morton, Moore, Sierpinski ve Keçeci).
  • Radar grafikler ile çok boyutlu metrik karşılaştırması.
  • Başlangıç‑bitiş ilişkisi ve süreklilik görselleştirmeleri.

• 🔬 İleri Kuantum Görselleştirmeleri

  • Majorana sıfır modları, örgü (braiding) ve topolojik faz diyagramları.
  • Weyl konileri, Fermi yayları, Berry eğriliği.
  • Stratum Modeli: Hibrit kuantum mimarisi (süperiletken + Majorana + fotonik).
  • 3B Wigner fonksiyonları, dolanıklık ağları, adiabatik evrim.
  • Shor, Grover, Deutsch‑Jozsa algoritmalarının eğri tabanlı animasyonları.

• 🌌 Zengin Desen Kütüphanesi

  • Çiçek desenleri, galaksi sarmalları, kar taneleri, mandalalar, fraktal ağaçlar, deniz canlıları, sinir ağları, virüs kapsidleri ve kozmik ağ.

• 🧩 Klasik Eğriler Desteği

  • Hilbert, Morton (Z‑order), Moore, Sierpinski eğrileri saf Python ile implemente edilmiştir.

• ⚡ Optimize Edilmiş Performans

  • Sonuçları önbelleğe alan KececiCurve sınıfı sayesinde tekrarlı üretimlerde hız.

---

📦 Kurulum

git clone https://github.com/WhiteSymmetry/kececicurve.git
cd kececicurve
pip install -e .

Gereksinimler:

• Python 3.8+
• NumPy
• Matplotlib

İsterseniz bağımlılıkları manuel de kurabilirsiniz:

pip install numpy matplotlib

---

🚀 Hızlı Başlangıç

Temel Kullanım

from kececicurve import KececiCurve, quick_plot

# 5 çocuklu, 3 seviyeli bir Keçeci eğrisi oluştur
curve = KececiCurve(num_children=5, max_level=3, growth_mode='outward')
points = curve.generate()  # (x, y) noktalarının listesi

# Hızlı çizim
import matplotlib.pyplot as plt
pts = np.array(points)
plt.plot(pts[:,0], pts[:,1], '-')
plt.axis('equal')
plt.show()

Menü ile Tüm Görselleştirmelere Erişim

from kececicurve import show_menu
show_menu()

Bu interaktif menü, çiçek desenlerinden kuantum algoritmalarına kadar 30'dan fazla görselleştirme seçeneği sunar.

---

📚 Kullanım Örnekleri

1. Çiçek Desenleri Galerisi

from kececicurve import flower_patterns
flower_patterns()

2. Lokalite Isı Haritası Karşılaştırması

from kececicurve import locality_heatmap_comparison
locality_heatmap_comparison()

3. Majorana Fermiyonları Görselleştirmesi

from kececicurve import MajoranaVisualizer
viz = MajoranaVisualizer()
viz.visualize_majorana_zero_modes()

4. Özel Parametrelerle Kendi Eğrinizi Yaratın

from kececicurve import KececiCurveGenerator, ChildOrdering, GrowthDirection

gen = KececiCurveGenerator(
    num_children=7,
    max_level=4,
    scale_factor=0.42,
    child_ordering=ChildOrdering.SPIRAL_OUTWARD,
    growth_direction=GrowthDirection.TANGENT,
    angle_variation=0.2,
    color_by_angle=True
)
gen.generate_curve()

# Noktaları çiz
# ...

---

📁 Proje Yapısı

kececicurve/
├── __init__.py               # Paket dışa aktarımları
├── kececicurve.py            # Ana modül (tüm sınıflar ve fonksiyonlar)
├── README.md                 # Bu dosya
├── LICENSE                   # Lisans bilgisi
└── pyproject.toml            # Paket yapılandırması

---

📜 Lisans

Bu proje AGPL3.0-or-later Lisansı ile lisanslanmıştır.
Ayrıntılar için LICENSE dosyasına bakınız.

---

Keçeci Curve – Fraktal geometriyi, veri bilimini ve kuantum fiziğini aynı çatı altında buluşturan bir araç.

---

# Pixi:

[![Pixi](https://img.shields.io/badge/Pixi-Pixi-brightgreen.svg)](https://prefix.dev/channels/bilgi)

pixi init kececicurve

cd kececicurve

pixi workspace channel add [https://prefix.dev/channels/bilgi](https://prefix.dev/channels/bilgi) --prepend

✔ Added https://prefix.dev/channels/bilgi

pixi add kececicurve

✔ Added kececicurve >=...,<1

pixi install

pixi shell

pixi run python -c "import kececicurve; print(kececicurve.__version__)"

### Çıktı: 

pixi remove kececicurve

conda install -c https://prefix.dev/channels/bilgi kececicurve

pixi run python -c "import kececicurve; print(kececicurve.__version__)"

### Çıktı: 

pixi run pip list | grep kececicurve

### kececicurve  

pixi run pip show kececicurve

Name: kececicurve

Version: 

Summary: Keçeci Numbers: Keçeci Sayıları (Keçeci Conjecture)

Home-page: https://github.com/WhiteSymmetry/kececicurve

Author: Mehmet Keçeci

Author-email: Mehmet Keçeci <...>

License: GNU AFFERO GENERAL PUBLIC LICENSE

Copyright (c) 2025-2026 Mehmet Keçeci

----

1. https://pypi.org/project/kececicurve/
2. https://anaconda.org/bilgi/kececicurve
3. https://prefix.dev/channels/bilgi/packages/kececicurve

---

## License / Lisans

This project is licensed under the AGPL3.0 or Later License. See the `LICENSE` file for details.

## 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

```bibtex
@misc{kececi_2026_...,
  author       = {Keçeci, Mehmet},
  title        = {kececicurve},
  month        = apr,
  year         = 2026,
  publisher    = {Zenodo},
  version      = {0.1.0},
  doi          = {},
  url          = {https://doi.org/},
}

APA

Keçeci, M. (2026). kececicurve.