kececifractals
Advanced tools
Keçeci Circle Fractal: Keçeci-style circle fractal.
| PyPI |
|
| Conda |
|
| DOI |
|
| License: AGPL |
|
Keçeci Circle Fractal: Keçeci-style circle fractal.:
This module provides two primary functionalities for generating Keçeci Fractals:
Many systems encountered in nature and engineering exhibit complex and hierarchical geometric structures. Fractal geometry provides a powerful tool for understanding and modeling these structures. However, existing deterministic circle packing fractals, such as the Apollonian gasket, often adhere to fixed geometric rules and may fall short in accurately reflecting the diversity of observed structures. Addressing the need for greater flexibility in modeling physical and mathematical systems, this paper introduces the Keçeci Circle Fractal (KCF), a novel deterministic fractal. The KCF is generated through a recursive algorithm where a parent circle contains child circles scaled down by a specific scale_factor and whose number (initial_children, recursive_children) is controllable. These parameters allow for the tuning of the fractal's morphological characteristics (e.g., density, void distribution, boundary complexity) over a wide range. The primary advantage of the KCF lies in its tunable geometry, enabling more realistic modeling of diverse systems with varying structural parameters, such as porous media (for fluid flow simulations), granular material packings, foam structures, or potentially biological aggregations. Furthermore, the controllable structure of the KCF provides an ideal testbed for investigating structure-dependent physical phenomena like wave scattering, heat transfer, or electrical conductivity. Mathematically, it offers opportunities to study variations in fractal dimension and packing efficiency for different parameter values. In conclusion, the Keçeci Circle Fractal emerges as a valuable and versatile tool for generating geometries with controlled complexity and investigating structure-property relationships across multidisciplinary fields.
Doğada ve mühendislik uygulamalarında karşılaşılan birçok sistem, karmaşık ve hiyerarşik geometrik yapılar sergiler. Bu yapıları anlamak ve modellemek için fraktal geometri güçlü bir araç sunar. Ancak, Apollon contası gibi mevcut deterministik dairesel paketleme fraktalları genellikle sabit geometrik kurallara bağlıdır ve gözlemlenen yapıların çeşitliliğini tam olarak yansıtmakta yetersiz kalabilir. Bu çalışmada, fiziksel ve matematiksel sistemlerin modellenmesinde daha fazla esneklik sağlama ihtiyacından doğan yeni bir deterministik fraktal olan Keçeci Dairesel Fraktalı (KDF) tanıtılmaktadır. KDF, özyinelemeli bir algoritma ile üretilir; burada bir ana daire, belirli bir ölçek faktörü (scale_factor) ile küçültülmüş ve sayısı (initial_children, recursive_children) kontrol edilebilen çocuk daireleri içerir. Bu parametreler, fraktalın morfolojik özelliklerinin (yoğunluk, boşluk dağılımı, sınır karmaşıklığı vb.) geniş bir aralıkta ayarlanmasına olanak tanır. KDF'nin temel avantajı, bu ayarlanabilir geometrisi sayesinde, gözenekli ortamlar (akışkan simülasyonları için), granüler malzeme paketlemeleri, köpük yapıları veya potansiyel olarak biyolojik kümeleşmeler gibi yapısal parametreleri farklılık gösteren çeşitli sistemleri daha gerçekçi bir şekilde modelleyebilmesidir. Ayrıca, KDF'nin kontrol edilebilir yapısı, dalga saçılması, ısı transferi veya elektriksel iletkenlik gibi yapıya bağlı fiziksel olayların incelenmesi için ideal bir test ortamı sunar. Matematiksel olarak, farklı parametre değerleri için fraktal boyut değişimlerini ve paketleme verimliliğini inceleme imkanı sunar. Sonuç olarak, Keçeci Dairesel Fraktalı, kontrollü karmaşıklığa sahip geometriler üretmek ve çok disiplinli alanlarda yapı-özellik ilişkilerini araştırmak için değerli ve çok yönlü bir araç olarak öne çıkmaktadır.
conda install bilgi::kececifractals -y
pip install kececifractals
https://anaconda.org/bilgi/kececifractals
https://pypi.org/project/kececifractals/
https://github.com/WhiteSymmetry/kececifractals
import kececifractals as kf
import importlib # Useful if you modify the .py file and want to reload it
# --- Example 1: Show the fractal inline ---
print("Generating fractal to show inline...")
kf.kececifractals_circle(
initial_children=5,
recursive_children=5,
text="Keçeci Circle Fractal: Keçeci Dairesel Fraktalı",
max_level=4,
scale_factor=0.5,
min_size_factor=0.001,
output_mode='show' # This will display the plot below the cell
)
print("Inline display finished.")
# --- Example 2: Save the fractal as an SVG file ---
print("\nGenerating fractal to save as SVG...")
kf.kececifractals_circle(
initial_children=7,
recursive_children=3,
text="Keçeci Circle Fractal: Keçeci Dairesel Fraktalı",
max_level=5,
scale_factor=0.5,
min_size_factor=0.001,
base_radius=4.5,
background_color=(0.95, 0.9, 0.85), # Light beige
initial_circle_color=(0.3, 0.1, 0.1), # Dark brown
output_mode='svg',
filename="kececi_fractal_svg-1" # Will be saved in the notebook's directory
)
print("SVG saving finished.")
# --- Example 3: Save as PNG with high DPI ---
print("\nGenerating fractal to save as PNG...")
kf.kececifractals_circle(
initial_children=4,
recursive_children=6,
text="Keçeci Circle Fractal: Keçeci Dairesel Fraktalı",
max_level=6, # Deeper recursion
scale_factor=0.5,
min_size_factor=0.001, # Smaller details
output_mode='png',
filename="kececi_fractal_png-1",
dpi=400 # High resolution
)
print("PNG saving finished.")
print("\nGenerating fractal and saving as JPG...")
kf.kececifractals_circle(
initial_children=5,
recursive_children=7,
text="Keçeci Circle Fractal: Keçeci Dairesel Fraktalı",
max_level=5,
scale_factor=0.5,
min_size_factor=0.001,
output_mode='jpg', # Save as JPG
filename="kececifractal_jpg-1",
dpi=300 # Medium resolution JPG
)
print("JPG saving finished.")
# --- If you modify kececifractals.py and want to reload it ---
# Without restarting the Jupyter kernel:
print("\nReloading the module...")
importlib.reload(kf)
print("Module reloaded. Now you can run the commands again with the updated code.")
kf.kececifractals_circle(output_mode='show', text="Keçeci Circle Fractal: Keçeci Dairesel Fraktalı")
This project is licensed under the AGPL License. See the LICENSE file for details.
If this library was useful to you in your research, please cite us. Following the GitHub citation standards, here is the recommended citation.
@misc{kececi_2025_15392518,
author = {Keçeci, Mehmet},
title = {kececifractals},
month = may,
year = 2025,
publisher = {GitHub, PyPI, Anaconda, Zenodo},
version = {0.1.0},
doi = {10.5281/zenodo.15392518},
url = {https://doi.org/10.5281/zenodo.15392518},
}
@misc{kececi_2025_15396198,
author = {Keçeci, Mehmet},
title = {Scalable Complexity: Mathematical Analysis and
Potential for Physical Applications of the Keçeci
Circle Fractal
},
month = may,
year = 2025,
publisher = {Zenodo},
doi = {10.5281/zenodo.15396198},
url = {https://doi.org/10.5281/zenodo.15396198},
}
Keçeci, M. (2025). Scalable Complexity in Fractal Geometry: The Keçeci Fractal Approach. Authorea. June, 2025. https://doi.org/10.22541/au.175131225.56823239/v1
Keçeci, M. (2025). Keçeci Fractals. Open Work Flow Articles (OWFAs), WorkflowHub https://doi.org/10.48546/workflowhub.document.32.2
Keçeci, M. (2025, May 13). Scalable complexity: Mathematical analysis and potential for physical applications of the Keçeci circle fractal. Open Science Articles (OSAs), Zenodo. https://doi.org/10.5281/zenodo.15392772
Keçeci, M. (2025). kececifractals [Data set]. Open Work Flow Articles (OWFAs), WorkflowHub https://doi.org/10.48546/workflowhub.datafile.16.3
Keçeci, M. (2025, May 13). Kececifractals. Open Science Articles (OSAs), Zenodo. https://doi.org/10.5281/zenodo.15392518
Keçeci, Mehmet. Scalable Complexity in Fractal Geometry: The Keçeci Fractal Approach. Authorea. June, 2025. https://doi.org/10.22541/au.175131225.56823239/v1
Keçeci, Mehmet. "kececifractals" [Data set]. WorkflowHub, 2025. https://doi.org/10.48546/workflowhub.datafile.16.3
Keçeci, Mehmet. "kececifractals". Zenodo, 01 May 2025. https://doi.org/10.5281/zenodo.15392518
Keçeci, Mehmet. "Scalable Complexity: Mathematical Analysis and Potential for Physical Applications of the Keçeci Circle Fractal", 13 Mayıs 2025. https://doi.org/10.5281/zenodo.15396198.
🧬🦠🧊🧂💧🛢️🌀🔄➗📏🧱⚙️🎛️🌍🧵🔧🛠️🏗️🧪✅🔬🎚️🌐
Analogy: Scalable complexity: Mathematical analysis and potential for physical applications of the Keçeci circle fractal. Mehmet Keçeci
The Keçeci Circle Fractal is like an architectural system where the builder doesn’t just lay bricks—but can dynamically adjust each brick’s size, count, and spacing on demand. While classical deterministic fractals (e.g., the Apollonian gasket) follow a rigid, unchangeable recipe—like baking a cake with a fixed mold—the KCF functions more like a parametric LEGO® kit: every circle’s placement is governed not by inevitability, but by designer-defined parameters (scale_factor, initial_children, recursive_children). This tunability enables faithful emulation—not just of the aesthetic self-similarity in nature, but of functionally critical traits: pore connectivity in rocks, cell-cell spacing in tissues, or bubble-wall thickness in foams—making KCF a bridge between idealized geometry and measurable physical behavior. These analogies concretize the core innovation of the KCF—controlled, scalable complexity—while also highlighting both its mathematical flexibility and its potential for real-world physical applications.
🇹🇷 Analoji (Benzetim): Ölçeklenebilir Karmaşıklık: Keçeci Çember Fraktalinin Matematiksel Analizi ve Fiziksel Uygulamalardaki Potansiyeli. Mehmet Keçeci
Keçeci Çember Fraktalı (KÇF), bir mimârın yâlnızca tuğlalarla değil, aynı zamanda tuğlaların boyutunu, sayısını ve yerleşim sıklığını isteğe göre ayarlayabildiği bir yapı sistemine benzer: Geleneksel fraktaller sâbit bir “yapı târifi”ne (örneğin Apollonian pastası) bağlı kalırken, Keçeci Fraktalı bir modüler yapı setidir — bir tür “Lego sistemi” gibidir: Her parça (çember) ebeveyninin ölçeğine ve konumuna göre değil, tasarımcının seçtiği kurallara göre konumlanır. Bu sâyede doğadaki gözenekli kayalar, köpükler veya hücre kümeleri gibi yapıların yâlnızca “güzelliğini” değil, fiziksel işlevlerini etkileyen gözenek dağılımı, yoğunluk ve yüzey pürüzlülüğü gibi kritik özelliklerini de hassasça taklit etmek mümkün hâle gelir. Bu analojiler, KÇF’nin öne çıkan yeniliği olan kontrollü, ölçeklenebilir karmaşıklık fikrini somutlaştırır; ayrıca hem matematiksel esnekliği hem de fiziksel uygulamalara açılabilen kapısını vurgular.
🌊🔌🌡️
Physics Analogy: Scalable complexity: Mathematical analysis and potential for physical applications of the Keçeci circle fractal. Mehmet Keçeci
The Keçeci Circle Fractal is like an acoustic diffuser panel in a recording studio: A flat wall (simple geometry) reflects sound waves coherently—causing echoes and standing waves. In contrast, the KCF—through its parametrically designed, multi-scale hierarchy of cavities (circles within circles)—scatters, absorbs, and redirects waves across length scales. Just as the size, depth, and spacing of wells in a quadratic-residue diffuser determine its frequency response, the KCF’s parameters (scale_factor, recursive_children) allow predictive tuning of physical responses: thermal conductivity, electrical percolation thresholds, or electromagnetic scattering cross-sections. Thus, the KCF is not merely a pattern—it is a geometric encoding of physical behavior.
🇹🇷 Fizik Analoji (Benzetimi): Ölçeklenebilir Karmaşıklık: Keçeci Çember Fraktalinin Matematiksel Analizi ve Fiziksel Uygulamalardaki Potansiyeli. Mehmet Keçeci
Keçeci Çember Fraktalı, bir akustik stüdyo duvarı gibidir: Düz bir beton yüzey (basit geometri) ses dalgalarını tek bir yönde yansıtır ve yankı oluşturur; Oysa KÇF, parametrik olarak tasarlanmış girinti-çıkıntılarla (çemberlerin hiyerarşik yerleşimi) ses dalgalarını çoklu ölçeklerde dağıtır, emer ve yönlendirir. Tıpkı bir stüdyoda yutucu panoların boyutu, derinliği ve dağılımı sesin frekans tepkisini belirlediği gibi, KÇF’de scale_factor ve recursive_children parametreleri, bir malzemenin ısı iletimi, elektriksel direnç veya dalga saçılımı gibi fiziksel yanıtlarını hesaplanabilir ve ayarlanabilir hâle getirir. Yâni KÇF, yâlnızca bir şekil değil — bir fiziksel davranışın geometrik kodudur.
pixi init kececifractals
cd kececifractals
pixi workspace channel add https://repo.prefix.dev/bilgi --prepend
✔ Added https://repo.prefix.dev/bilgi
pixi add kececifractals
✔ Added kececifractals >=0.1.6,<2
pixi install
pixi shell
pixi run python -c "import kececifractals; print(kececifractals.version)"
pixi remove kececifractals
conda install -c https://prefix.dev/bilgi kececifractals
pixi run python -c "import kececifractals; print(kececifractals.version)"
pixi run pip list | grep kececifractals
pixi run pip show kececifractals
Name: kececifractals
Version: 0.1.6
Summary: Keçeci Circle Fractal: Keçeci-style circle fractal.
Home-page: https://github.com/WhiteSymmetry/kececifractals
Author: Mehmet Keçeci
Author-email: Mehmet Keçeci <...>
License: GNU AFFERO GENERAL PUBLIC LICENSE
Copyright (c) 2025-2026 Mehmet Keçeci
FAQs
Keçeci Fractals: Keçeci-style circle fractal.
We found that kececifractals demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
Malicious dYdX client packages were published to npm and PyPI after a maintainer compromise, enabling wallet credential theft and remote code execution.
Security News
gem.coop is testing registry-level dependency cooldowns to limit exposure during the brief window when malicious gems are most likely to spread.
Security News
Following multiple malicious extension incidents, Open VSX outlines new safeguards designed to catch risky uploads earlier.