Spaces:
Sleeping
Sleeping
Update README.md
Browse files
README.md
CHANGED
|
@@ -1,12 +1,75 @@
|
|
| 1 |
---
|
| 2 |
-
title: Perfect Odd Number
|
| 3 |
-
emoji:
|
| 4 |
-
colorFrom:
|
| 5 |
-
colorTo:
|
| 6 |
sdk: gradio
|
| 7 |
sdk_version: 5.49.1
|
| 8 |
app_file: app.py
|
| 9 |
pinned: false
|
| 10 |
---
|
| 11 |
|
| 12 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
---
|
| 2 |
+
title: Perfect Odd Number
|
| 3 |
+
emoji: 🔢
|
| 4 |
+
colorFrom: indigo
|
| 5 |
+
colorTo: purple
|
| 6 |
sdk: gradio
|
| 7 |
sdk_version: 5.49.1
|
| 8 |
app_file: app.py
|
| 9 |
pinned: false
|
| 10 |
---
|
| 11 |
|
| 12 |
+
# 🔢 Perfect Number Visualizer & Explorer
|
| 13 |
+
|
| 14 |
+
Discover the beauty of **perfect numbers** — integers that are equal to the sum of their proper divisors.
|
| 15 |
+
This interactive Gradio app not only checks if a number is *Perfect*, *Abundant*, or *Deficient*, but also gives you a **comprehensive visual explanation**.
|
| 16 |
+
|
| 17 |
+
---
|
| 18 |
+
|
| 19 |
+
## 🧠 About Perfect Numbers
|
| 20 |
+
|
| 21 |
+
A **Perfect Number** satisfies:
|
| 22 |
+
\[
|
| 23 |
+
σ(n) - n = n
|
| 24 |
+
\]
|
| 25 |
+
Example:
|
| 26 |
+
**6 → 1 + 2 + 3 = 6**
|
| 27 |
+
|
| 28 |
+
All known perfect numbers are **even** and can be generated using Euclid’s formula:
|
| 29 |
+
\[
|
| 30 |
+
2^{p-1}(2^p - 1), \text{ when } (2^p - 1) \text{ is prime.}
|
| 31 |
+
\]
|
| 32 |
+
|
| 33 |
+
---
|
| 34 |
+
|
| 35 |
+
## ✨ Features
|
| 36 |
+
|
| 37 |
+
- 📊 **Interactive Visualization** — Pie charts, bar plots, and divisor pair breakdowns
|
| 38 |
+
- 🔍 **Classification System** — Perfect, Abundant, or Deficient
|
| 39 |
+
- 🔢 **Prime Factorization** — Understand the number’s structure
|
| 40 |
+
- 🧮 **Mathematical Explanation** — See the divisor-sum formula visually
|
| 41 |
+
- 🧔 **Historical Insights** — Learn about Euclid, Euler, Mersenne, and more
|
| 42 |
+
- 🎨 **Clean UI with Gradio Blocks** — Educational and visually rich layout
|
| 43 |
+
|
| 44 |
+
---
|
| 45 |
+
|
| 46 |
+
## 🚀 How to Use
|
| 47 |
+
|
| 48 |
+
1. Enter any integer between **1 and 1,000,000**
|
| 49 |
+
2. Click **“Analyze Number”**
|
| 50 |
+
3. See the classification, visual breakdown, and historical context
|
| 51 |
+
|
| 52 |
+
Try these:
|
| 53 |
+
- ✅ 6
|
| 54 |
+
- ✅ 28
|
| 55 |
+
- ✅ 496
|
| 56 |
+
- ✅ 8128
|
| 57 |
+
|
| 58 |
+
---
|
| 59 |
+
|
| 60 |
+
## 🧩 Built With
|
| 61 |
+
|
| 62 |
+
- [Gradio](https://www.gradio.app/) — For interactive web interface
|
| 63 |
+
- [Matplotlib](https://matplotlib.org/) — For data visualization
|
| 64 |
+
- [Python](https://www.python.org/) — For number theory logic
|
| 65 |
+
|
| 66 |
+
---
|
| 67 |
+
|
| 68 |
+
## 💬 Credits
|
| 69 |
+
|
| 70 |
+
Developed to explore the mathematical and historical depth of **Perfect Numbers** —
|
| 71 |
+
from **Euclid** and **Euler** to modern computational discoveries.
|
| 72 |
+
|
| 73 |
+
> “Mathematics, rightly viewed, possesses not only truth, but supreme beauty.” — *Bertrand Russell*
|
| 74 |
+
|
| 75 |
+
---
|