kangxinyuan commited on
Commit
f0271be
Β·
verified Β·
1 Parent(s): 28f5ab9

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +120 -7
README.md CHANGED
@@ -1,14 +1,127 @@
1
  ---
2
  title: Color Quantification Tool
3
- emoji: πŸ“Š
4
- colorFrom: pink
5
- colorTo: yellow
6
  sdk: gradio
7
- sdk_version: 5.35.0
8
- app_file: app.py
9
  pinned: false
10
  license: mit
11
- short_description: Color Quantification Tool
12
  ---
13
 
14
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
  title: Color Quantification Tool
3
+ emoji: 🎨
4
+ colorFrom: blue
5
+ colorTo: purple
6
  sdk: gradio
7
+ sdk_version: 4.0.0
8
+ app_file: huggingface_app.py
9
  pinned: false
10
  license: mit
 
11
  ---
12
 
13
+ # 🎨 Color Quantification Tool
14
+
15
+ **Professional Color Analysis Platform** - Web Demo Version
16
+
17
+ This is a simplified web demonstration of the Color Quantification Tool. For full functionality and advanced features, please download the desktop application.
18
+
19
+ ## 🌟 Features (Web Demo)
20
+
21
+ - **Single Image Analysis**: Upload and analyze individual images
22
+ - **Color Extraction**: K-means clustering for dominant color identification
23
+ - **Visual Results**: Color palette and percentage distribution
24
+ - **Real-time Processing**: Instant analysis with interactive interface
25
+
26
+ ## πŸ–₯️ Desktop Version
27
+
28
+ The full desktop application offers advanced features:
29
+
30
+ ### πŸ”¬ **Advanced Analysis**
31
+ - Multi-color space analysis (RGB, LAB, HSV)
32
+ - Professional distance metrics (Ξ”E2000, Bhattacharyya, Euclidean)
33
+ - Statistical analysis with comprehensive reporting
34
+ - Configurable clustering parameters
35
+
36
+ ### πŸ“Š **Professional Visualizations**
37
+ - 3D color space distribution plots
38
+ - Distance matrix heatmaps with scientific colormaps
39
+ - Interactive dashboard with zoom and pan controls
40
+ - High-quality export options (PNG, SVG, HTML)
41
+
42
+ ### πŸ’Ύ **Export & Reporting**
43
+ - Excel reports with detailed statistics
44
+ - CSV data for further analysis
45
+ - JSON format for machine processing
46
+ - Professional PDF reports
47
+
48
+ ### ⚑ **Performance**
49
+ - Batch processing of thousands of images
50
+ - GPU-accelerated computation
51
+ - Multi-threaded analysis
52
+ - Progress tracking and logging
53
+
54
+ ## πŸ“₯ Download Desktop Version
55
+
56
+ **Latest Version: v1.0.0** | **File Size: 1.1GB** | **Platform: Windows 64-bit**
57
+
58
+ ### Primary Download Links:
59
+ - πŸ”— **Google Drive**: [Download ColorQuantificationTool.exe](https://drive.google.com/file/d/your-file-id/view)
60
+ - πŸ”— **OneDrive**: [Download ColorQuantificationTool.exe](https://onedrive.live.com/download?cid=your-cid)
61
+ - πŸ”— **SourceForge**: [Download](https://sourceforge.net/projects/colorquantificationtool/)
62
+
63
+ ### System Requirements:
64
+ - **OS**: Windows 10/11 (64-bit)
65
+ - **RAM**: 8GB minimum, 16GB recommended
66
+ - **Storage**: 2GB free space for analysis results
67
+ - **Display**: 1920x1080 or higher resolution
68
+
69
+ ## πŸš€ Quick Start (Web Demo)
70
+
71
+ 1. **Upload an image** using the file uploader
72
+ 2. **Adjust parameters** (number of colors to extract)
73
+ 3. **Click "Analyze Colors"** to start the analysis
74
+ 4. **View results** in the interactive table and color palette
75
+
76
+ ## πŸ“š Documentation
77
+
78
+ - **[User Guide](https://github.com/your-username/ColorQuantificationTool/blob/main/User_Guide_Instructions.md)** - Comprehensive usage instructions
79
+ - **[δΈ­ζ–‡ζŒ‡ε—](https://github.com/your-username/ColorQuantificationTool/blob/main/δ½Ώη”¨ζŒ‡ε―Όθ―΄ζ˜Ž.md)** - θ―¦η»†ηš„δΈ­ζ–‡δ½Ώη”¨θ―΄ζ˜Ž
80
+ - **[GitHub Repository](https://github.com/your-username/ColorQuantificationTool)** - Source code and releases
81
+
82
+ ## πŸ† Use Cases
83
+
84
+ ### πŸ”¬ **Scientific Research**
85
+ - Color analysis in biological specimens
86
+ - Material science color characterization
87
+ - Quality control in manufacturing
88
+
89
+ ### 🎨 **Creative Industries**
90
+ - Digital art color palette analysis
91
+ - Brand color consistency verification
92
+ - Print color matching and calibration
93
+
94
+ ### πŸ“Š **Data Analysis**
95
+ - Image dataset color profiling
96
+ - Batch color extraction and clustering
97
+ - Statistical color distribution analysis
98
+
99
+ ## πŸ”’ Security & Privacy
100
+
101
+ - **Local Processing**: All analysis performed locally (desktop version)
102
+ - **No Data Collection**: Web demo processes images temporarily
103
+ - **Open Source**: Code available for security audit
104
+ - **Privacy First**: No user data stored or transmitted
105
+
106
+ ## πŸ“„ License
107
+
108
+ This project is licensed under the MIT License.
109
+
110
+ ## πŸ™ Acknowledgments
111
+
112
+ - Built with Python, NumPy, OpenCV, Matplotlib, and scikit-learn
113
+ - Web interface powered by Gradio
114
+ - Color science algorithms based on CIE standards
115
+ - Special thanks to the open-source community
116
+
117
+ ## πŸ“ž Support
118
+
119
+
120
+ - πŸ“§ **Email**: 1967151971@qq.com
121
+ - πŸ’¬ **Community**: Join our user community
122
+
123
+ ---
124
+
125
+ **⭐ If this tool helps your research or work, please consider giving it a star on GitHub!**
126
+
127
+ *Color Quantification Tool - Making color analysis accessible to everyone*