Skip to content

WhiteSymmetry/kececicurve

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

168 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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

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

PyPI version License: AGPL DOI WorkflowHub DOI figshare 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 Contributor Covenant Linted with Ruff Lang:Python

PyPI Downloads PyPI Downloads PyPI Downloads


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


🌿 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 Example

0.1.6: inherit_parent_angle=False (default) or inherit_parent_angle=True


✨ Ö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, Peano 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.

Kullanım Alanları Karşılaştırması/Usage Area Comparison

Kullanım Alanı/Usage Area Keçeci Hilbert Morton Peano Moore Sierpinski
Veritabanı İndeksleme/Database Indexing ⭐⭐⭐ ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐⭐ ⭐⭐⭐ ⭐⭐⭐⭐⭐ ⭐⭐
Görüntü İşleme/Image Processing ⭐⭐⭐⭐ ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐ ⭐⭐⭐⭐ ⭐⭐⭐⭐⭐ ⭐⭐
Kuantum Görselleştirme/Quantum Visualization ⭐⭐⭐⭐⭐ ⭐⭐ ⭐⭐ ⭐⭐ ⭐⭐ ⭐⭐
Prosedürel İçerik Üretimi/Procedural Content Generation ⭐⭐⭐⭐⭐ ⭐⭐⭐ ⭐⭐⭐ ⭐⭐⭐ ⭐⭐⭐ ⭐⭐⭐
Bilimsel Simülasyon/Scientific Simulation ⭐⭐⭐⭐⭐ ⭐⭐⭐ ⭐⭐⭐ ⭐⭐⭐ ⭐⭐⭐ ⭐⭐⭐
Sanat ve Tasarım/Art & Design ⭐⭐⭐⭐⭐ ⭐⭐ ⭐⭐ ⭐⭐ ⭐⭐⭐⭐⭐
Kriptografi/Cryptography ⭐⭐⭐⭐ ⭐⭐⭐ ⭐⭐⭐ ⭐⭐⭐ ⭐⭐⭐ ⭐⭐
Yol Bulma/Pathfinding ⭐⭐⭐ ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐ ⭐⭐⭐⭐ ⭐⭐⭐⭐⭐ ⭐⭐
Eğitim ve Görselleştirme/Education & Visualization ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐ ⭐⭐⭐ ⭐⭐⭐⭐ ⭐⭐⭐⭐ ⭐⭐⭐⭐
Harita ve CBS/GIS/Spatial Mapping ⭐⭐⭐ ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐⭐ ⭐⭐⭐ ⭐⭐⭐⭐⭐

📦 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

import numpy as np
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.

====================================================================== KEÇECİ CURVE GÖRSELLEŞTİRME MENÜSÜ

DESEN GALERİLERİ / PATTERN GALLERIES

  1. Flower Patterns / Çiçek Desenleri
  2. Galaxy Patterns / Galaksi Desenleri
  3. Snowflake Patterns / Kar Taneleri
  4. Mandala Patterns / Mandala Desenleri
  5. Fractal Trees / Fraktal Ağaçlar
  6. Marine Patterns / Deniz Canlıları
  7. Cosmic Web / Kozmik Ağ
  8. Neural Network Patterns / Sinir Ağı Desenleri
  9. Virus Patterns / Virüs Desenleri
  10. Keçeci Curve Gallery / Keçeci Eğri Galerisi

EĞRİ KARŞILAŞTIRMALARI / CURVE COMPARISONS

  1. Locality Heatmap / Lokalite Isı Haritası
  2. Continuity Visualization / Süreklilik Görselleştirmesi
  3. Radar Chart Comparison / Radar Grafik Karşılaştırması
  4. Start-End Comparison / Başlangıç-Bitiş Karşılaştırması
  5. Comprehensive Comparison (Table) / Kapsamlı Karşılaştırma (Tablo)
  6. Locality Combined Score / Lokalite Birleşik Skoru
  7. Indexing Performance Comparison / Veri İndeksleme Karşılaştırması

KUANTUM GÖRSELLEŞTİRMELERİ / QUANTUM VISUALIZATIONS

  1. Majorana Zero Modes / Majorana Sıfır Modları
  2. Weyl Semimetal / Weyl Yarımetali
  3. Stratum Architecture / Stratum Mimarisi
  4. 3D Wigner Function / 3B Wigner Fonksiyonu
  5. Entanglement Network 3D / Dolanıklık Ağı 3B
  6. Adiabatic Process 3D / Adiabatik Kuantum Süreci 3B
  7. Topological Anyons 3D / Topolojik Anyonlar 3B
  8. QFT Spectrum 3D / Kuantum Fourier Dönüşümü 3B

KUANTUM ALGORİTMALARI / QUANTUM ALGORITHMS

  1. Shor Algorithm / Shor Algoritması
  2. Grover Algorithm / Grover Algoritması
  3. Deutsch-Jozsa Algorithm / Deutsch-Jozsa Algoritması
  4. Quantum Error Correction / Kuantum Hata Düzeltme
  5. Bloch Sphere States / Bloch Küresi Durumları
  6. Superposition States / Süperpozisyon Durumları
  7. Entanglement (Bell States) / Dolanıklık (Bell Durumları)
  8. Coherence → Decoherence / Koherens → Dekoherens
  9. Quantum Tunneling / Kuantum Tünelleme
  10. Interference Patterns / Girişim Desenleri
  11. Wave Function Collapse / Dalga Fonksiyonu Çöküşü

KEÇECİ PARAMETRE ETKİLERİ / KEÇECİ PARAMETER EFFECTS

  1. Effect of Child Count / Çocuk Sayısının Etkisi
  2. Effect of Growth Mode / Büyüme Modunun Etkisi
  3. Effect of Ordering Strategy / Sıralama Stratejisinin Etkisi
  4. Effect of Scale Factor / Ölçek Faktörünün Etkisi
  5. Effect of Angle Parameters / Açı Parametrelerinin Etkisi

SİERPİNSKİ & PEANO ÖZEL / SIERPINSKI & PEANO SPECIALS

  1. Sierpinski Comparison / Sierpinski Karşılaştırması
  2. Sierpinski Curve / Sierpinski Eğrisi
  3. Sierpinski Process / Sierpinski Süreci
  4. Sierpinski Triangle / Sierpinski Üçgeni
  5. Sierpinski Test / Sierpinski Doğrulama Testi
  6. Peano Curve / Peano Eğrisi
  7. Peano Verification Test / Peano Doğrulama Testi

EK KARŞILAŞTIRMA VE ANALİZLER / ADDITIONAL COMPARISONS & ANALYSES

  1. Curve Process by Level / Eğrilerin Seviyeye Göre Gelişimi
  2. Locality / Lokalite
  3. Keçeci Parametric Variations / Keçeci Parametrik Varyasyonları
  4. Keçeci Parametric Variations / Keçeci Parametrik Varyasyonları (inherit_parent_angle=True)
  5. Detailed Radar Comparison / Detaylı Radar Karşılaştırması
  6. Locality Heatmap – Both Normalizations / Lokalite Isı Haritası – İki Normalizasyon

KRİPTOGRAFİ / CRYPTOGRAPHY

  1. Görüntü İmzalama ve Doğrulama (Signature & Verify)
  2. Keçeci Örnekleme RNG (Sampling RNG)
  3. Görüntüden Anahtar Türetme (Key Derivation)
  4. Toplu Görüntü Şifreleme (Batch Encrypt)
  5. Permütasyon Parametrelerini Anahtar Olarak Kullanma
  6. Görüntü Şifreleme/Deşifreleme (Encrypt/Decrypt)

🎮 OYUN / GAME

  1. 🐢 Kaplumbağa Ninja vs 🐇 Beyaz Tavşan Oyunu (Rastgele Sayı Tahmin)

Decimation / Seyreltme

  1. Decimation / Seyreltme (RDP ve Distance Karşılaştırması)

  1. Exit / Çıkış ======================================================================

Seçiminiz (1-61):


📚 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/
├── kececicurve/__init__.py               # Paket dışa aktarımları
├── kececicurve/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_19696338,
  author       = {Keçeci, Mehmet},
  title        = {kececicurve},
  month        = apr,
  year         = 2026,
  publisher    = {Zenodo},
  version      = {0.1.0},
  doi          = {10.5281/zenodo.19696338},
  url          = {https://doi.org/10.5281/zenodo.19696338},
}

APA


Keçeci, M. (2026). Keçeci Eğrisi Âilesinin Yerellik Performansı ve Kuantum Durum Simülasyonlarındaki Uygulamaları. Open Science Articles (OSAs), Zenodo. https://doi.org/10.5281/zenodo.20263326

Keçeci, M. (2026). kececicurve. IEEE Dataport. https://dx.doi.org/10.21227/s756-cy21 

Keçeci, M. (2026). Keçeci Curve: A Circular-Based Parametric Space-Filling Curve Family. Open Science Articles (OSAs), Zenodo. https://doi.org/10.5281/zenodo.19885259

Keçeci, M. (2026). Keçeci Eğrisi: Dairesel Temelli Parametrik Bir Uzay Doldurma Eğrisi Âilesi. Open Science Articles (OSAs), Zenodo. https://doi.org/10.5281/zenodo.19796065

Keçeci, M. (2026). Space-Filling Curves for Quantum Computing: From Molecular Simulations to Error Correction. Open Science Articles (OSAs), Zenodo. https://doi.org/10.5281/zenodo.19793852

Keçeci, M. (2026). Kuantum Hesaplamada Uzay Dolduran Eğriler: Moleküler Simülasyonlardan Hata Düzeltmeye. Open Science Articles (OSAs), Zenodo. https://doi.org/10.5281/zenodo.19666944

Keçeci, M. (2026). kececicurve. Open Science Articles (OSAs), Zenodo. https://doi.org/10.5281/zenodo.19696338

Keçeci, M. (2026). spacecurves. Open Science Articles (OSAs), Zenodo. https://doi.org/10.5281/zenodo.19672791

About

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

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors