RASH-HIT Fractal Analiz Studio

RASH-HIT Fractal Analiz Studio is a research-grade, zero-rasterization computational geometry engine engineered for exact vector box-counting, spatial occupancy profiling (fill vs. empty void ratio), and fractal dimension ($D_B$) analysis directly from Scalable Vector Graphics (SVG) vector motifs, architectural drawings, textile patterns, and graphic compositions.

---

🔬 Scientific Foundation & The Exact Vector Paradigm

For over three decades, computational fractal analysis in design and morphology has relied on raster image-processing tools (e.g., ImageJ FracLac, HarFA, Benoit). These conventional tools force vector artwork to be rasterized into fixed-resolution pixel grids (PNG/JPEG/TIFF), introducing three severe classes of mathematical error:

1. Resolution & DPI Inconsistency: Measured fractal dimensions vary artificially depending on the arbitrary export resolution, canvas size, or DPI chosen.
2. Anti-Aliasing & Fringing Distortion: Vector curves produce semi-transparent grayscale boundary pixels during rasterization, forcing arbitrary binarization thresholds that corrupt fine geometric boundaries.
3. Discretization Corner Clipping: Fine ornamental strokes, sharp corner vertices, and sub-pixel details smaller than pixel dimensions are merged, blurred, or obliterated.

The RASH-HIT Solution

RASH-HIT Fractal Analiz Studio completely eliminates rasterization artifacts. It operates natively on continuous vector path geometry in floating-point coordinate space using the C++ GEOS spatial engine (RASH-HIT Fractal Analiz Engine via Shapely 2.0). Grid cell occupancy is evaluated via continuous point-set topological intersection predicates ($E \cap B_{i,j} \neq \emptyset$), guaranteeing 100% mathematical determinism, zero discretization error, and publication-grade reproducibility.

---

🏛️ Comprehensive Application Domains

RASH-HIT Fractal Analiz Studio serves as a bridge between pure computational geometry and creative design disciplines:

1. 🧵 Textile, Fashion & Pattern Design

• Jacquard & Woven Structure Porosity: Quantify the exact spatial density and void-to-fill distribution of woven structures, knitwear repeats, and lace filigree.
• Carpet & Kilim Motif Analysis: Mathematically profile traditional Anatolian, Persian, Caucasian, and Oriental carpet motifs, quantifying the transition of motif density from central medallions to borders.
• Fashion Print Scaling & Repeat Balance: Evaluate self-similarity across different scale factors in surface pattern design and all-over textile prints.

2. 🏺 Cultural Heritage, Islamic Geometry & Visual Ornamentation

• Historic Ornament Morphology: Analyze ornamental styles across cultural eras (Seljuk, Ottoman, Celtic, Gothic, Baroque, Islamic Geometric Star Patterns, Muqarnas, Tezhip, Ebru, Marbling).
• Cultural Motif Classification: Provide objective numerical metrics ($D_B$, $R^2$, level-by-level fill ratios) for digital humanities, archaeological pattern classification, and museum heritage preservation.
• Geometric Complexity Indexing: Distinguish between Euclidean symmetry and true fractal self-similarity in traditional craftsmanship.

3. 🎨 Graphic Design, Typography & Visual Branding

• Logo Visual Weight & Balance: Quantify positive vs. negative space distribution and visual occupancy ratios across branding assets.
• Typographic Complexity: Measure the structural complexity, stroke density, and spatial coverage of diverse typefaces and calligraphic scripts.
• Generative & Algorithmic Vector Art: Benchmark procedural vector patterns, cellular automata graphics, and L-system fractals.

4. 🏢 Architectural & Urban Morphology

• Facade Articulation & Porosity: Analyze architectural screens (e.g., Mashrabiya, Brise-soleil, perforated metal panels) for light filtration and structural complexity.
• Floor Plan Spatial Hierarchy: Quantify structural enclosure, wall-to-void density, and circulation complexity in architectural layouts.
• Urban Footprint Scaling: Evaluate the fractal scaling behavior of street networks, historical urban perimeters, and building layouts.

5. ⚙️ Industrial, Surface & Parametric Product Design

• Laser-Cutting & CNC Path Optimization: Assess vector distribution and material removal ratios prior to fabrication.
• Biomimetic Textures & Metamaterials: Measure geometric scale hierarchies in biologically-inspired lattice structures and textured functional surfaces.

---

📊 Analytical Comparison: Exact Vector vs. Raster Box-Counting

Metric / Capability	Conventional Raster Tools (ImageJ/FracLac)	RASH-HIT Fractal Analiz Studio (Exact Vector)
Input Representation	Discrete Bitmap Pixels (PNG/JPG/TIFF)	Continuous Double-Precision Floating Point (SVG)
Geometry Evaluation	Pixel counting (Binary 0/1 threshold)	C++ GEOS Topological Predicates (intersects)
DPI / Resolution Dependency	⚠️ High (Results shift with image size/DPI)	🟢 Zero (Scale-invariant exact geometry)
Anti-Aliasing Artifacts	⚠️ Severe (Blurred edges distort boundary counts)	🟢 None (Evaluated as true continuous boundaries)
Stroke Width Accuracy	⚠️ Subject to pixel round-off error	🟢 Exact (Converts strokes to precise buffer polygons)
Aspect Ratio Handling	Often square-padded, distorting non-square ratios	🟢 Adaptive (Aspect-ratio-aware grid planning)
Execution Performance	Slower on large images (O(N*M) pixel scan)	🟢 Ultra-fast (Hierarchical quadtree pruning)
Reproducibility	Depends on export settings and binarizer threshold	🟢 100% Deterministic & Scientifically Exact

---

⚡ Core Architecture & Engineering

• Exact Vector Intersection Engine: Powered by C++ GEOS / Shapely 2.0 with spatial indexing (STRtree) and strict point-set topological testing.
• Aspect-Ratio-Aware Multi-Level Grid Planning: Automatically adapts grid cell dimensions to arbitrary SVG viewbox dimensions ($AR = W/H$) with power-of-two resolution doubling across levels ($L_1 \dots L_N$).
• Hierarchical Quadtree Pruning: Automatically skips empty child cells based on parent occupancy, delivering sub-millisecond execution speeds even at deep resolution levels.
• Comprehensive SVG Specification Support:
  • Standard shapes: <rect>, <circle>, <ellipse>, <line>, <polyline>, <polygon>, and <path> (Cubic/Quadratic Bézier curves, elliptical arcs).
  • 2D affine transformation matrices: matrix(), translate(), scale(), rotate(), skewX(), skewY().
  • CSS style hierarchy: Inline style="...", presentation attributes, and <style> blocks (via tinycss2).
  • Per-channel alpha and visibility resolution: Filters non-rendered, hidden, or zero-opacity geometries.
• Ordinary Least Squares (OLS) Regression: Evaluates Box-Counting Fractal Dimension ($D_B$) and coefficient of determination ($R^2$) from: $$\log N(\epsilon) = D_B \cdot \log(1/\epsilon) + C$$
• Zero Disk Footprint: Generates clean, publication-ready ASCII framed summary tables directly to stdout.

---

📦 Installation & Setup

Method 1: Instant Execution via NPX (Zero Setup)

# Run immediately without manual dependency installation
npx rash-hit-fractal-analiz-studio --input motif.svg --levels 7

# Or install globally
npm install -g rash-hit-fractal-analiz-studio
rash-hit-fractal --input motif.svg --levels 7

(All required Python core libraries such as NumPy and Shapely are automatically detected and installed on first run).

Method 2: Install via PyPI

pip install rash-hit-fractal-analiz-studio

Method 3: Install from Source

git clone https://github.com/rasitnarcicek/RASH-HIT-Fractal-Analiz-Studio.git
cd RASH-HIT-Fractal-Analiz-Studio
pip install -e .

---

🚀 Usage & Examples

When installed via pip or npm, the rash-hit-fractal command is available system-wide:

1. Analyze a Single SVG Motif

rash-hit-fractal --input input_svgs/16D.svg --levels 7

Terminal Output:

+------------------------------------------------------------------------------+
|               RASH-HIT FRACTAL ANALIZ STUDIO - ANALYSIS REPORT               |
+------------------------------------------------------------------------------+
  Motif Loaded       : 16D (100.00 x 200.00)
  Geometries         : 2 vector elements
  Analysis Engine    : cpu
  Selected Engine    : CPU Exact Vector Geometry Engine (Shapely/GEOS)
+------------------------------------------------------------------------------+
| Level | Grid     | Total Cells | Filled Cells | Empty Cells | Occupancy % | Time ms  |
+-------+----------+-------------+--------------+-------------+-------------+----------+
|  L01  | 4x8      |          32 |           32 |           0 |     100.00% |     0.32 |
|  L02  | 8x16     |         128 |          128 |           0 |     100.00% |     0.24 |
|  L03  | 16x32    |         512 |          420 |          92 |      82.03% |     0.40 |
|  L04  | 32x64    |       2,048 |        1,508 |         540 |      73.63% |     1.65 |
|  L05  | 64x128   |       8,192 |        6,032 |       2,160 |      73.63% |     7.09 |
|  L06  | 128x256  |      32,768 |       23,744 |       9,024 |      72.46% |    25.14 |
|  L07  | 256x512  |     131,072 |       93,888 |      37,184 |      71.63% |    94.80 |
+-------+----------+-------------+--------------+-------------+-------------+----------+
  [RESULT] Box-Counting Fractal Dimension Db = 1.8675
  [RESULT] Linear Regression Fit R2           = 0.9993
  [RESULT] Total Execution Time               = 129.64 ms
+------------------------------------------------------------------------------+

2. Batch Process an Entire Directory of Motifs

rash-hit-fractal --dir ./input_svgs --levels 5

---

🎓 Academic Citation

If you use RASH-HIT Fractal Analiz Studio in your research, thesis, journal articles, or architectural/textile studies, please cite the software using the persistent DOIs below:

• Concept DOI: 10.5281/zenodo.22069152
• Version DOI (v1.0.0): 10.5281/zenodo.22069153
• Author ORCID: 0009-0005-3423-255X

BibTeX

@software{Narcicek_RASH_HIT_Fractal_Analiz_Studio_2026,
  author    = {Nar{\c{c}}i{\c{c}}ek, Mehmet Ra{\s}it},
  title     = {RASH-HIT Fractal Analiz Studio},
  year      = {2026},
  version   = {1.0.0},
  publisher = {GitHub},
  doi       = {10.5281/zenodo.22069153},
  url       = {https://doi.org/10.5281/zenodo.22069153},
  orcid     = {https://orcid.org/0009-0005-3423-255X},
  license   = {Apache-2.0}
}

APA

Narçiçek, M. R. (2026). RASH-HIT Fractal Analiz Studio (Version 1.0.0) [Computer software]. GitHub. https://doi.org/10.5281/zenodo.22069153

RIS

TY  - COMP
AU  - Narçiçek, Mehmet Raşit
TI  - RASH-HIT Fractal Analiz Studio
PY  - 2026
ET  - 1.0.0
PB  - GitHub
DO  - 10.5281/zenodo.22069153
UR  - https://doi.org/10.5281/zenodo.22069153
ER  - 

---

📜 License & Authorship

Licensed under the Apache License, Version 2.0.
Copyright (c) 2026 Mehmet Raşit Narçiçek. All rights reserved.