fractal_algebra 0.1.6

A library for fractal algebra experimentation
Documentation

Fractal Algebra

This is the primary research and application crate where the computational and geometric engines are brought together. It focuses on discovering and analyzing the emergent structures from number-theoretic data.

The key innovation in this crate is the FractalGraph:

  • A custom data structure designed as a hybrid of a graph, a trie, and a spatial index.
  • It moves beyond simple visualization to create a rich, explorable network of relationships between numbers based on their prime factorizations.
  • Nodes in the graph represent n!, and relationships (edges) are formed dynamically based on mathematical similarity and shared number-theoretic traits.
  • Traversal of the graph mimics fractal expansion: recursive, self-similar, and semantically rich.

related Projects within the workspace

1. factorial_engine

A high-performance, zero-error crate for computing the prime factorization of factorials (n!). It uses Legendre's Formula to calculate results directly and efficiently, serving as a robust computational backend for number-theoretic analysis.

2. tma_engine

A lightweight crate providing the algebraic tools for 2D affine transformations (TMA). This engine is the geometric heart of the project, used for generating fractals via Iterated Function Systems (IFS) and the Chaos Game algorithm.

Vision

The overarching goal of this project is to develop tools and theories based on a "fractal" understanding of mathematical and physical systems. We explore the idea that complexity arises from simple, iterative rules, and that the relationships between objects are as important as the objects themselves.

The project investigates concepts such as:

  • The geometric patterns hidden in the prime factorizations of integers.
  • The potential for a unified "fractal algebra" to describe phenomena across different scales.
  • The nature of time and observation in a universe with fractal structure.