mgbam commited on
Commit
d674340
·
verified ·
1 Parent(s): be22b03

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +68 -59
README.md CHANGED
@@ -1,60 +1,69 @@
1
- # Sundew Algorithm Demo
2
-
3
- A simple, interactive demonstration of the Sundew adaptive gating algorithm.
4
-
5
- ## What This Demo Shows
6
-
7
- This demo visualizes how the Sundew algorithm:
8
- 1. **Scores input significance** based on multiple features
9
- 2. **Adapts the activation threshold** to maintain target processing rates
10
- 3. **Saves energy** by skipping low-importance inputs
11
- 4. **Maintains stability** using hysteresis to prevent oscillation
12
-
13
- ## Running Locally
14
-
15
- ```bash
16
- pip install -r requirements.txt
17
- python app.py
18
- ```
19
-
20
- Then open your browser to the displayed URL (usually http://localhost:7860).
21
-
22
- ## Deploying to Hugging Face Spaces
23
-
24
- 1. Create a new Space on [Hugging Face](https://huggingface.co/spaces)
25
- 2. Upload these files:
26
- - `app.py`
27
- - `requirements.txt`
28
- - `README.md`
29
- 3. Set SDK to "Gradio"
30
- 4. The demo will automatically deploy
31
-
32
- ## Understanding the Visualization
33
-
34
- ### Top Chart: Significance vs Threshold
35
- - **Blue line**: Significance score for each input (0-1)
36
- - **Red line**: Adaptive threshold that adjusts over time
37
- - **Green dots**: Inputs that were processed (activated)
38
-
39
- ### Middle Chart: Activation Pattern
40
- - Shows which samples were processed (green) vs skipped (white)
41
- - Gives a clear view of the selective processing pattern
42
-
43
- ### Bottom Chart: Energy Savings
44
- - Real-time percentage of energy saved
45
- - Orange dashed line shows the target based on processing rate
46
-
47
- ## Key Parameters
48
-
49
- - **Target Processing Rate**: What percentage of inputs to process
50
- - **Number of Samples**: How many data points to simulate
51
- - **Anomaly Rate**: Percentage of high-importance events in the stream
52
-
53
- ## Technical Innovation
54
-
55
- The algorithm uses a PI controller with hysteresis to maintain stable activation rates while adapting to changing input patterns. This prevents oscillation while enabling efficient energy management.
56
-
57
- Typical results:
58
- - 70-85% energy savings
59
- - ±3% accuracy in maintaining target rates
 
 
 
 
 
 
 
 
 
60
  - Stable operation across varying input patterns
 
1
+ ---
2
+ license: mit
3
+ title: sundew_demo
4
+ sdk: gradio
5
+ emoji: 🚀
6
+ colorFrom: indigo
7
+ colorTo: indigo
8
+ short_description: ' Sundew: Adaptive Energy-Aware Gating Algorithm'
9
+ ---
10
+ # Sundew Algorithm Demo
11
+
12
+ A simple, interactive demonstration of the Sundew adaptive gating algorithm.
13
+
14
+ ## What This Demo Shows
15
+
16
+ This demo visualizes how the Sundew algorithm:
17
+ 1. **Scores input significance** based on multiple features
18
+ 2. **Adapts the activation threshold** to maintain target processing rates
19
+ 3. **Saves energy** by skipping low-importance inputs
20
+ 4. **Maintains stability** using hysteresis to prevent oscillation
21
+
22
+ ## Running Locally
23
+
24
+ ```bash
25
+ pip install -r requirements.txt
26
+ python app.py
27
+ ```
28
+
29
+ Then open your browser to the displayed URL (usually http://localhost:7860).
30
+
31
+ ## Deploying to Hugging Face Spaces
32
+
33
+ 1. Create a new Space on [Hugging Face](https://huggingface.co/spaces)
34
+ 2. Upload these files:
35
+ - `app.py`
36
+ - `requirements.txt`
37
+ - `README.md`
38
+ 3. Set SDK to "Gradio"
39
+ 4. The demo will automatically deploy
40
+
41
+ ## Understanding the Visualization
42
+
43
+ ### Top Chart: Significance vs Threshold
44
+ - **Blue line**: Significance score for each input (0-1)
45
+ - **Red line**: Adaptive threshold that adjusts over time
46
+ - **Green dots**: Inputs that were processed (activated)
47
+
48
+ ### Middle Chart: Activation Pattern
49
+ - Shows which samples were processed (green) vs skipped (white)
50
+ - Gives a clear view of the selective processing pattern
51
+
52
+ ### Bottom Chart: Energy Savings
53
+ - Real-time percentage of energy saved
54
+ - Orange dashed line shows the target based on processing rate
55
+
56
+ ## Key Parameters
57
+
58
+ - **Target Processing Rate**: What percentage of inputs to process
59
+ - **Number of Samples**: How many data points to simulate
60
+ - **Anomaly Rate**: Percentage of high-importance events in the stream
61
+
62
+ ## Technical Innovation
63
+
64
+ The algorithm uses a PI controller with hysteresis to maintain stable activation rates while adapting to changing input patterns. This prevents oscillation while enabling efficient energy management.
65
+
66
+ Typical results:
67
+ - 70-85% energy savings
68
+ - ±3% accuracy in maintaining target rates
69
  - Stable operation across varying input patterns