FreeAeon-Fractal 0.5.2

Toolkit for Multifractal Analysis

FreeAeon-Fractal

FreeAeon-Fractal is a Python toolkit for computing Multifractal Spectra, Fractal Dimensions, Fractal Lacunarity and Fourier Spectra of images or series.

📦 Installation

Install via pip:

pip install FreeAeon-Fractal

💡 Requires Python 3.6+ and OpenCV (cv2) support.

🖼 Usage

Calculate the Multifractal Spectrum of an image

python demo.py --mode mfs --image ./images/face.png

Example:

Calculate the Fractal Dimensions (Box-Counting, DBC, SDBC) of an image

python demo.py --mode fd --image ./images/fractal.png

Example:

Lacunarity analysis of an image

python python demo.py --mode=lacunarity --image=./images/fractal.png

Example:

Fourier analysis of an image

python demo.py --mode fourier --image ./images/face.png

Example:

Calculate the Multifractal Spectrum of a Series

python demo.py --mode series

Example:

Parameters

• --image: Path to the input image
• --mode: Analysis mode:
  • fd – Fractal Dimension
  • mfs – Multifractal Spectrum (default)
  • lacunarity - Lacunarity analysis
  • fourier - Fourier analysis
  • series - Multifractal Spectrum for Series analysis

Use GPU to speed up

from FreeAeonFractal.FAImageDimensionGPU import CFAImageDimensionGPU as CFAImageDimension
from FreeAeonFractal.FA2DMFSGPU import CFA2DMFSGPU as CFA2DMFS

📁 Directory Structure

FreeAeon-Fractal/
├── FreeAeonFractal/      # Core module
├── demo.py               # CLI interface
├── images/               # Example images
├── requirements.txt
├── setup.py
└── README.md

📄 License

This project is licensed under the MIT License. See LICENSE for details.

✍️ Author

Jim Xie

📧 E-Mail: [e-mail], [e-mail]

🔗 GitHub: https://github.com/jim-xie-cn/FreeAeon-Fractal

Yin Jie

📧 E-Mail: [e-mail]

Cindy Ma

📧 E-Mail: [e-mail]

Wenjing Zhang

📧 E-Mail: [e-mail]

Danny Zhang

📧 E-Mail: [e-mail]

---

🧠 Citation

If you use this project in academic work, please cite it as:

Jim Xie, FreeAeon-Fractal: A Python Toolkit for Fractal and Multifractal Image Analysis, 2025.
GitHub Repository: https://github.com/jim-xie-cn/FreeAeon-Fractal