engager

# Test Transcript Examples for engager Package

This directory contains realistic Zoom VTT transcript examples designed for testing the `engager` R package. These transcripts simulate various educational scenarios with different participation patterns, course types, and engagement levels.

## File Structure

```
test_transcripts/
├── README.md                           # This documentation file
├── intro_statistics_week1.vtt         # Statistics course - Week 1
├── intro_statistics_week2.vtt         # Statistics course - Week 2
├── computer_science_101_week1.vtt     # Computer Science course - Week 1
├── english_literature_discussion.vtt  # English Literature discussion
├── biology_lab_session.vtt            # Biology lab session
├── ideal_course_roster.csv            # Roster with name variations
├── ideal_course_session1.vtt          # Ideal course - Session 1
├── ideal_course_session2.vtt          # Ideal course - Session 2
└── ideal_course_session3.vtt          # Ideal course - Session 3
```

## Transcript Descriptions

### 1. Statistics Course Series
**Files:** `intro_statistics_week1.vtt`, `intro_statistics_week2.vtt`

**Course Type:** Introductory Statistics
**Instructor:** Professor Smith
**Students:** Student A, Student B, Student C, Student D
**Duration:** ~3-4 minutes each

**Characteristics:**
- Progressive difficulty from basic concepts to probability theory
- Multiple student participation with varying engagement levels
- Technical terminology (normal distribution, standard deviation, etc.)
- Realistic classroom interactions and questions
- Assignment discussions and due dates

**Use Cases:**
- Testing multi-session analysis
- Analyzing participation patterns over time
- Measuring engagement with technical content
- Tracking student progression and comfort levels

### 2. Computer Science Course
**File:** `computer_science_101_week1.vtt`

**Course Type:** Introduction to Programming
**Instructor:** Dr. Johnson
**Students:** Student X, Student Y, Student Z
**Duration:** ~5 minutes

**Characteristics:**
- Hands-on programming instruction
- Code examples and demonstrations
- Technical explanations (Python syntax, data types)
- Student questions about programming concepts
- Practical examples (Hello World, calculations)

**Use Cases:**
- Testing engagement with technical demonstrations
- Analyzing question patterns in programming courses
- Measuring understanding of complex concepts
- Tracking student comfort with new technical skills

### 3. English Literature Discussion
**File:** `english_literature_discussion.vtt`

**Course Type:** Shakespeare Analysis
**Instructor:** Professor Williams
**Students:** Student M, Student N, Student O, Student P
**Duration:** ~5 minutes

**Characteristics:**
- Socratic discussion format
- Literary analysis and interpretation
- Complex philosophical concepts
- Multiple valid interpretations
- Historical context discussions
- Essay assignment details

**Use Cases:**
- Testing engagement in discussion-based courses
- Analyzing participation in interpretive discussions
- Measuring depth of student contributions
- Tracking understanding of complex themes

### 4. Biology Lab Session
**File:** `biology_lab_session.vtt`

**Course Type:** Molecular Biology Lab
**Instructor:** Dr. Chen
**Students:** Student Q, Student R, Student S, Student T
**Duration:** ~7 minutes

**Characteristics:**
- Laboratory procedures and safety protocols
- Technical scientific terminology
- Step-by-step instructions
- Safety considerations and warnings
- Hands-on experimental procedures
- Results interpretation

**Use Cases:**
- Testing engagement in laboratory settings
- Analyzing safety protocol comprehension
- Measuring understanding of experimental procedures
- Tracking technical skill development

### 5. Ideal Course Example
**Files:** `ideal_course_session1.vtt`, `ideal_course_session2.vtt`,
`ideal_course_session3.vtt`

**Course Type:** Training Workshop  
**Instructor:** Professor Ed  
**Students:** Thomas Miller, Samantha Smith, Robert Jones, Ling Wei,  
José Álvarez, Anthony García-Lopez, Priya Patel  
**Duration:** ~1 minute each

**Characteristics:**
- Roster with preferred and transcript name variations
- Students missing some or all sessions
- Guests in multiple sessions (one session with multiple guests)
- Mid-session display name change and cross-session name shifts
- Consecutive utterances and long pauses

**Use Cases:**
- Testing name matching and attendance logic
- Ensuring support for internationalized names
- Handling guest speakers and display name changes
- Evaluating dead air and rapid dialogue handling

## Transcript Features

### Speaker Identification
All transcripts use consistent speaker identification:
- Instructors: `Professor Smith`, `Dr. Johnson`, `Professor Williams`, `Dr. Chen`, `Professor Ed`
- Students: `Student A`, `Student B`, `Student C`, etc.

### Timing
- Realistic timing for educational interactions
- Varied response times to simulate natural conversation
- Appropriate pauses for thinking and processing

### Content Realism
- Authentic educational dialogue
- Realistic student questions and concerns
- Appropriate technical terminology for each field
- Natural progression of topics and concepts

### Engagement Patterns
- Varied participation levels among students
- Different types of questions (clarification, application, synthesis)
- Realistic instructor responses and guidance
- Natural classroom dynamics

## Testing Scenarios

### 1. Basic Functionality Testing
- Transcript parsing and speaker identification
- Timing extraction and analysis
- Word count and participation metrics

### 2. Engagement Analysis Testing
- Participation equity measurements
- Question frequency and types
- Response patterns and timing
- Instructor-student interaction ratios

### 3. Multi-Session Analysis Testing
- Cross-session participation tracking
- Progress and comfort level changes
- Topic complexity progression
- Student engagement evolution

### 4. Course Type Comparison Testing
- Different subject area engagement patterns
- Technical vs. discussion-based course analysis
- Laboratory vs. lecture engagement differences
- Assignment and assessment discussions

### 5. Privacy and Anonymization Testing
- Speaker name masking and replacement
- Sensitive content identification
- Data anonymization procedures
- Privacy compliance verification

## Usage Guidelines

### For Package Development
1. Use these transcripts to test new features and functions
2. Verify that engagement metrics work across different course types
3. Test multi-session analysis capabilities
4. Validate privacy and anonymization features

### For Documentation Examples
1. Include realistic examples in package documentation
2. Demonstrate various use cases and scenarios
3. Show different course types and engagement patterns
4. Provide examples for vignettes and tutorials

### For Quality Assurance
1. Test edge cases and error handling
2. Verify consistent results across different transcript formats
3. Validate engagement metrics accuracy
4. Test performance with realistic data sizes

## Data Privacy Considerations

These transcripts contain:
- **Fictional names** for all participants
- **Educational content only** - no personal information
- **Realistic but anonymized** interactions
- **No identifying details** about institutions or individuals

The transcripts are designed to be:
- **Safe for testing** without privacy concerns
- **Representative** of real educational scenarios
- **Diverse** in content and participation patterns
- **Suitable** for public package examples

## Contributing New Transcripts

When adding new test transcripts:
1. Use fictional names and scenarios
2. Include realistic educational content
3. Maintain consistent formatting (VTT format)
4. Add appropriate documentation
5. Consider different course types and engagement patterns
6. Ensure privacy and anonymity

## File Format Specifications

All transcripts follow the WebVTT format:
```
WEBVTT

1
00:00:00.000 --> 00:00:02.000
Speaker Name: Transcript content here.

2
00:00:02.000 --> 00:00:04.000
Another Speaker: More transcript content.
```

- Comment numbers for each entry
- Speaker names followed by colon and space
- Timestamps in HH:MM:SS.mmm format
- Realistic timing intervals
- Proper VTT formatting and structure

## Related Documentation

- Package main documentation: `?engager`
- Function documentation: `?analyze_engagement`, `?extract_participation`
- Vignettes: `vignette("engagement_analysis")`
- Privacy guidelines: `vignette("privacy_considerations")`