Metadata-Version: 2.4
Name: kececicurve
Version: 0.1.0
Summary: kececicurve, Keçeci Curve, Keçeci Eğrisi Modülü
Home-page: https://github.com/WhiteSymmetry/kececicurve
Author: Mehmet Keçeci
Author-email: Mehmet Keçeci <mkececi@yaani.com>
Maintainer: Mehmet Keçeci
Maintainer-email: mkececi@yaani.com
License-Expression: GPL-3.0-or-later
Project-URL: Homepage, https://github.com/WhiteSymmetry/kececicurve
Project-URL: Repository, https://github.com/WhiteSymmetry/kececicurve
Keywords: Space Curves
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: matplotlib
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-cov; extra == "test"
Requires-Dist: pytest-mock; extra == "test"
Requires-Dist: ruff; extra == "test"
Requires-Dist: numpy; extra == "test"
Requires-Dist: matplotlib; extra == "test"
Dynamic: author
Dynamic: home-page
Dynamic: keywords
Dynamic: license-file
Dynamic: maintainer
Dynamic: maintainer-email
Dynamic: requires-python

# kececicurve

# Keçeci Curve (kececicurve, Keçeci Eğrisi) <img src="docs/logo.jpg" alt="Keçeci Curve (kececicurve, Keçeci Eğrisi)" align="right" height="140"/>

[![PyPI version](https://badge.fury.io/py/kececicurve.svg)](https://badge.fury.io/py/kececicurve/)
[![License: AGPL](https://img.shields.io/badge/License-AGPL-yellow.svg)](https://opensource.org/licenses/AGPL)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.***.svg)](https://doi.org/10.5281/zenodo.***)
[![WorkflowHub DOI](https://img.shields.io/badge/DOI-10.48546%2Fworkflowhub.datafile.***-blue)](https://doi.org/10.48546/workflowhub.datafile.***)
[![figshare DOI](https://img.shields.io/badge/DOI-10.6084/m9.figshare.***-blue)](https://doi.org/10.6084/m9.figshare.***)

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

[![Open Source](https://img.shields.io/badge/Open%20Source-Open%20Source-brightgreen.svg)](https://opensource.org/)
[![Documentation Status](https://app.readthedocs.org/projects/kececicurve/badge/?0.2.0=main)](https://kececicurve.readthedocs.io/en/latest)
[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/10536/badge)](https://www.bestpractices.dev/projects/10536)

[![Python CI](https://github.com/WhiteSymmetry/kececicurve/actions/workflows/python_ci.yml/badge.svg?branch=main)](https://github.com/WhiteSymmetry/kececicurve/actions/workflows/python_ci.yml)
[![codecov](https://codecov.io/gh/WhiteSymmetry/kececicurve/graph/badge.svg?token=0X78S7TL0W)](https://codecov.io/gh/WhiteSymmetry/kececicurve)
[![Documentation Status](https://readthedocs.org/projects/kececicurve/badge/?version=latest)](https://kececicurve.readthedocs.io/en/latest/)
[![Binder](https://terrarium.evidencepub.io/badge_logo.svg)](https://terrarium.evidencepub.io/v2/gh/WhiteSymmetry/kececicurve/HEAD)

[![PyPI version](https://badge.fury.io/py/kececicurve.svg)](https://badge.fury.io/py/kececicurve)
[![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)
[![Lang:Python](https://img.shields.io/badge/Lang-Python-blue?style=flat-square&logo=python)](https://python.org/)

[![PyPI Downloads](https://static.pepy.tech/badge/kececicurve)](https://pepy.tech/projects/kececicurve)
![PyPI Downloads](https://img.shields.io/pypi/dm/kececicurve?logo=pypi&label=PyPi%20downloads)
[![PyPI Downloads](https://static.pepy.tech/personalized-badge/kececicurve?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/kececicurve)

---

<p align="left">
    <table>
        <tr>
            <td style="text-align: center;">PyPI</td>
            <td style="text-align: center;">
                <a href="https://pypi.org/project/kececicurve/">
                    <img src="https://badge.fury.io/py/kececicurve.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/kececicurve">
                    <img src="https://anaconda.org/bilgi/kececicurve/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.***">
                    <img src="https://zenodo.org/badge/DOI/10.5281/zenodo.***.svg" alt="DOI" height="18"/>
                </a>
            </td>
        </tr>
        <tr>
            <td style="text-align: center;">License: AGPL</td>
            <td style="text-align: center;">
                <a href="https://opensource.org/licenses/AGPL">
                    <img src="https://img.shields.io/badge/License-AGPL-yellow.svg" alt="License" height="18"/>
                </a>
            </td>
        </tr>
    </table>
</p>

---

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

![Keçeci Curve Gallery](https://...)

---

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

```bash
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:
```bash
pip install numpy matplotlib
```

---

## 🚀 Hızlı Başlangıç

### Temel Kullanım

```python
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

```python
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

```python
from kececicurve import flower_patterns
flower_patterns()
```

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

```python
from kececicurve import locality_heatmap_comparison
locality_heatmap_comparison()
```

### 3. Majorana Fermiyonları Görselleştirmesi

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

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

```python
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](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. 

