chatbot-mimic-notes / evaluation_module_readme.md
Jesse Liu
update files
c26f5b3
# Patient Sample Evaluation Module 🏥
## Overview
A professional patient sample evaluation module has been added to your medical AI interface, allowing medical experts to rate and provide feedback on AI-generated patient summaries, with support for sentence-level commenting.
## Features
### 1. Patient Sample Evaluation System
- **Overall Quality Rating**: 1-5 scale evaluation of AI summary quality
- **Medical Accuracy**: Evaluate accuracy of medical information
- **Clinical Relevance**: Assess clinical value of the summary
- **Completeness**: Evaluate information completeness of the summary
- **Clarity & Organization**: Assess clarity of expression and logical structure
### 2. Sentence-level Comment System
- Provide specific comments for each sentence of AI summary
- Support sentence numbering format: `Sentence number: Comment content`
- Track specific issues and improvement suggestions
- Detailed sentence-by-sentence analysis capability
### 3. Patient Data Management
- Evaluation based on real patient samples
- Display original patient data and AI-generated summaries
- Automatically save in JSON and CSV formats
- Link patient ID with evaluation data
## Usage
### For Medical Experts
1. **Select Patient Sample**
- Choose a case to evaluate from the patient sample list
- System will automatically display original patient data and AI-generated summary
2. **Conduct Evaluation**
- Enter your name
- Compare original data with AI summary
- Use sliders for multi-dimensional rating (1-5 scale)
- Provide overall feedback
3. **Sentence-level Comments** (Optional)
- In the "Sentence-by-Sentence Comments" section
- Provide detailed comments for specific sentences
- Format: `1: Comment for first sentence`
4. **Submit Evaluation**
- Click "Submit Patient Evaluation" button
- System will confirm successful save and reset form
### For Administrators
1. **View Statistics**
- Click "Refresh Statistics" to view patient evaluation data
- Includes average ratings, expert count, patient count, sentence comment count, etc.
2. **Export Data**
- Click "Export Data" to download CSV file
- For further analysis and research
## Data Storage Structure
Evaluation data is stored in two formats:
1. **JSON files** (detailed data)
- Individual evaluation files with timestamp
- Complete evaluation information including ratings and comments
2. **CSV file** (summary data)
- Master file for all evaluations
- Easy to import into analysis tools
## Multi-Admission Support
- Same patients may have multiple hospital admissions
- Each admission is treated as a separate evaluation case
- Clear labeling: "Patient [ID] - Admission [Number] (ID: [Admission ID])"
## Google Drive Integration
- Automatic backup of all evaluation data to cloud
- Secure access with your Google account
- Version control with timestamps
- Easy sharing and collaboration
This module provides comprehensive evaluation capabilities for AI-generated medical summaries while maintaining data integrity and providing valuable feedback for system improvement.