---

---

📖 About

MMC (Moroccan Mathematical Community) presents SiMath:
A collaborative, open-source collection of scripts (mainly in Python 3) designed to visually illustrate mathematical concepts, theorems, and algorithms. The project welcomes contributions and aims to be a reference for educators, students, and enthusiasts.

---

📁 Repository Structure

simath/
│
├── algorithms/
│   ├── <AlgorithmName>/
│   │   ├── <AlgorithmScript>.py
│   │   ├── <AlgorithmDoc>.md
│   │   └── config.yaml (if needed)
│   │   └── __init__.py
│   └── __init__.py
│
├── simulations/
│   ├── linux/
│   │   └── <AlgorithmName>.bash
│   └── windows/
│       └── <AlgorithmName>.bat
│
├── CONTRIBUTION.md
├── README.md
└── requirements.txt

---

🚀 Quick Start

# 1. Clone the repository
git clone https://github.com/Moroccan-Mathematical-Community/simath.git
cd simath

# 2. (Optional) Create a virtual environment
python -m venv venv
venv\Scripts\activate  # On Windows
# or
source venv/bin/activate  # On Linux

# 3. Install dependencies
pip install -r requierments.txt

# 4. Run an algorithm simulation  
# On Windows  
simulations\windows\GaussPivot.bat  
simulations\windows\SierpinskiFractal.bat  

# On Linux  
bash simulations/linux/GaussPivot.bash  
bash simulations/linux/SierpinskiFractal.bash  

---

📋 Algorithms & Theorems

📝 Name	✅ Implemented	📅 Addition Date
Gauss Pivot	✔️	2025-09-07
Sierpinski Fractal	✔️	2025-09-07
More coming soon...	⬜	--

---

🤝 Contributing

See CONTRIBUTING.md for guidelines.
We welcome new scripts, improvements, and documentation!

---

📢 Contact

• MMC: mathmarcom.ma
• GitHub: Moroccan-Mathematical-Community/simath