User Guide

The Lab Report Generator helps you create professional electrical engineering lab reports in minutes. Here's how to get started:

1. **Click "Generate Report"** on the homepage to start the wizard
2. **Fill in your information** step by step through the guided process
3. **Review and customize** your report before generating
4. **Download** your report in PDF or DOCX format

The wizard guides you through 6 simple steps:
- Step 1: Student Information
- Step 2: Experiment Details
- Step 3: Measurements & Data
- Step 4: Graph Configuration
- Step 5: Final Review & Edit
- Step 6: Download Your Report

You can add images to your report in two ways:

**Camera Capture:**
1. Click the camera icon (📷) next to any field
2. Allow camera access when prompted
3. Position your document/diagram in the frame
4. Click "Capture" to take the photo
5. Choose "Attach Image" to include it in your report, or "Extract Text" to use OCR

**File Upload:**
1. Click the upload icon (📤) next to any field
2. Select an image file from your device
3. Supported formats: PNG, JPG, JPEG, GIF
4. The image will be attached to that section

**Where to Add Images:**
- Circuit Diagram: Add your experiment circuit
- Objective: Attach handwritten objectives
- Procedure: Include step-by-step photos
- Equipment: Show the devices used
- Theory: Add relevant diagrams

**Tips:**
- Use good lighting for clear captures
- Keep handwriting neat for better OCR results
- Images appear in the final PDF/DOCX under their respective sections

There are multiple ways to enter your measurement data:

**Manual Entry (CSV Format):**
1. Enter data in CSV format in the text area
2. First row should be headers (column names)
3. Separate values with commas
4. Example:
   ```
   Voltage (V), Current (A), Resistance (Ω)
   1.0, 0.1, 10
   2.0, 0.2, 10
   3.0, 0.3, 10
   ```

**Excel Import:**
1. Click "Import Excel" button
2. Select your .xlsx or .xls file
3. Data will be automatically converted to CSV format
4. Review and edit if needed

**Camera/OCR:**
1. Click camera icon on the data field
2. Capture your handwritten data table
3. Choose "Extract Text" to use OCR
4. AI will convert the image to CSV format

**Auto-fill Sample Data:**
1. Select an experiment type first
2. Click "Auto-fill Sample Data"
3. Sample data for that experiment will be generated
4. Modify values as needed for your actual measurements

**Data Tips:**
- Include units in column headers (e.g., "Voltage (V)")
- Use decimal points, not commas for decimals
- Ensure consistent number of columns in each row

The generator includes templates for many common electrical experiments:

**DC Circuits:**
- Ohm's Law Verification
- Kirchhoff's Voltage Law (KVL)
- Kirchhoff's Current Law (KCL)
- Series & Parallel Resistors
- Voltage Divider
- Wheatstone Bridge

**DC Machines:**
- DC Generator (Shunt, Series, Compound)
- DC Motor Characteristics
- Speed Control Methods
- Motor Starters

**AC Circuits:**
- RLC Series Circuit
- RLC Parallel Circuit
- Resonance Frequency
- Power Factor Correction
- AC Power Measurement

**Transformers:**
- Single-Phase Transformer
- Open Circuit Test
- Short Circuit Test
- Transformer Efficiency

**Semiconductors:**
- Diode Characteristics
- Rectifier Circuits
- Transistor Characteristics
- Op-Amp Circuits

**How to Use Templates:**
1. In Step 2, select your experiment type from the dropdown
2. Click "Auto-fill" buttons to generate:
   - Objective
   - Equipment list
   - Theory
   - Procedure
3. Customize the generated content as needed

Create professional graphs from your data:

**Selecting Variables:**
1. After entering data, column names appear in dropdowns
2. Select X-axis variable (independent variable)
3. Select Y-axis variable (dependent variable)
4. Add a title for your graph

**Chart Types:**
- **Line Chart**: Best for continuous data relationships
- **Bar Chart**: Best for comparing discrete values
- **Scatter Plot**: Best for showing data distribution
- **Pie Chart**: Best for showing proportions

**Adding Multiple Graphs:**
1. Click "Add Another Graph"
2. Configure each graph separately
3. All graphs will appear in your report

**Smart Suggestions:**
- The system analyzes your data
- Suggests the best chart type automatically
- Shows reasoning for the suggestion
- You can accept or choose differently

**Graph Tips:**
- Always include units in axis labels
- Choose appropriate scale for your data
- Line charts work best for V-I characteristics
- Bar charts are good for comparing efficiency values

In the Final Review step, you can customize your report:

**Hiding Sections:**
1. Each section has a visibility toggle (eye icon)
2. Click to hide sections you don't need
3. Hidden sections won't appear in the final PDF/DOCX
4. Useful for experiments that don't need all sections

**Reordering Sections:**
1. Use the up/down arrows next to each section
2. Move sections to your preferred order
3. Click "Reset Order" to restore default order
4. Custom order is preserved in the final report

**Editing Content:**
1. All sections are editable in Final Review
2. Click on any text to modify it
3. Use AI generation buttons to improve content
4. Changes are reflected in the final output

**Common Customizations:**
- Hide "Precautions" if not required
- Move "Conclusion" before "Discussion"
- Hide "Theory" for practical-focused reports
- Reorder based on your institution's format

The AI assistant helps you create professional content:

**Generate New Content:**
1. Leave a field empty
2. Click "Generate with AI" (✨ button)
3. AI creates appropriate content based on:
   - Experiment title
   - Objective
   - Your data
4. Review and edit the generated text

**Improve Existing Content:**
1. Enter your draft text
2. Click "Generate with AI"
3. AI enhances your text:
   - Adds technical details
   - Improves academic language
   - Expands on key points
4. Original text is saved for undo

**Undo Changes:**
1. Click "Undo" (↩️ button) after AI generation
2. Restores your original text
3. If original was empty, clears the AI text

**AI-Generated Sections:**
- Theory: Technical background
- Procedure: Step-by-step instructions
- Calculations: Mathematical analysis
- Discussion: Result interpretation
- Conclusion: Summary of findings
- Precautions: Safety measures

**Tips for Best Results:**
- Provide clear experiment title
- Include specific objectives
- Enter accurate measurement data
- AI uses all context for better generation

Export your report in multiple formats:

**PDF Format:**
- Professional formatting
- Embedded fonts and images
- Print-ready quality
- Best for submission

**DOCX Format:**
- Editable in Microsoft Word
- Maintains formatting
- Easy to make final adjustments
- Good for collaborative editing

**HTML (Web Page):**
- Shareable online link
- View in any browser
- No download required
- Good for quick sharing

**Download Process:**
1. Complete all steps in the wizard
2. Review your report in Final Review
3. Click "Generate Report"
4. Wait for processing (may take 30-60 seconds)
5. Choose your preferred format
6. Click download button

**Tips:**
- PDF is recommended for final submission
- Use DOCX if you need to make manual edits
- HTML link can be shared with classmates