hashirlodhi commited on
Commit
27e2c67
·
verified ·
1 Parent(s): 0c04c4f

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +68 -5
README.md CHANGED
@@ -1,12 +1,75 @@
1
  ---
2
- title: Perfect Odd Number
3
- emoji: 👀
4
- colorFrom: blue
5
- colorTo: gray
6
  sdk: gradio
7
  sdk_version: 5.49.1
8
  app_file: app.py
9
  pinned: false
10
  ---
11
 
12
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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
+ ---