Update README.md

README.md

@@ -1,14 +1,95 @@
----
-title: Math
-emoji: 📈
-colorFrom: green
-colorTo: pink
-sdk: gradio
-sdk_version: 5.42.0
-app_file: app.py
-pinned: false
-license: mit
-short_description: 'mathematical equations '
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 📊 Mathematical Equation Visualizer
+
+An interactive web application for visualizing mathematical equations with multiple plot types and customization options.
+
+## Features
+
+- **Multiple Plot Types:**
+  - 2D Functions (y = f(x))
+  - Parametric Equations (x = f(t), y = g(t))
+  - Polar Equations (r = f(θ))
+  - Implicit Equations (F(x,y) = 0)
+  - 3D Surface Plots (z = f(x,y))
+- **Customization Options:**
+  - Adjustable plot ranges
+  - Color selection
+  - Line styles
+  - Grid toggle
+  - Custom titles
+  - Multiple color schemes for 3D plots
+- **Built-in Examples:**
+  - Pre-loaded examples for each plot type
+  - Easy-to-use example selector
+
+## Supported Mathematical Functions
+
+- Trigonometric: `sin`, `cos`, `tan`
+- Exponential: `exp`, `log`
+- Power: `sqrt`, `**` (exponentiation)
+- Basic arithmetic: `+`, `-`, `*`, `/`
+- Other: `abs`
+
+## Usage Examples
+
+### 2D Functions
+
+- `sin(x)` - Sine wave
+- `x**2 + 2*x + 1` - Parabola
+- `exp(-x**2)` - Gaussian curve
+
+### Parametric Equations
+
+- x: `cos(t)`, y: `sin(t)` - Circle
+- x: `t*cos(t)`, y: `t*sin(t)` - Spiral
+
+### Polar Equations
+
+- `1 + cos(theta)` - Cardioid
+- `sin(4*theta)` - Four-petaled rose
+
+### Implicit Equations
+
+- `x**2 + y**2 - 1` - Circle
+- `x**3 + y**3 - 3*x*y` - Folium of Descartes
+
+### 3D Surfaces
+
+- `sin(sqrt(x**2 + y**2))` - Sinc function
+- `x**2 - y**2` - Hyperbolic paraboloid
+
+## How to Use
+
+1. Select a plot type from the dropdown menu
+1. Enter your mathematical equation using the supported functions
+1. Adjust the plot ranges as needed
+1. Customize colors, line styles, and other visual options
+1. Click “Generate Plot” or let it auto-generate as you type
+1. Use the examples section to load pre-made equations
+
+## Technical Details
+
+- Built with Gradio for the web interface
+- Uses Matplotlib for plotting
+- SymPy for mathematical expression parsing
+- NumPy for numerical computations
+
+## Deployment
+
+This application is ready to be deployed on Hugging Face Spaces. Simply:
+
+1. Create a new Space on Hugging Face
+1. Upload the `app.py` and `requirements.txt` files
+1. The app will automatically build and deploy
+
+## Error Handling
+
+The application includes robust error handling for:
+
+- Invalid mathematical expressions
+- Division by zero
+- Complex number results (automatically converted to real)
+- Infinite values (clipped for display)
+
+-----
+
+**Note:** This application is designed for educational and visualization purposes. For complex mathematical analysis, consider using specialized mathematical software.