Test Insights and Error Explorer
Pawtograder provides powerful tools to help instructors understand patterns in test failures and efficiently regrade submissions when issues are identified.Error Explorer
The error explorer helps you identify and analyze common test failures across all student submissions. This feature groups similar errors together, making it easy to:- Identify widespread issues that may indicate problems with the assignment or autograder
- Find students affected by specific errors
- Quickly regrade submissions after fixing autograder issues
Viewing Error Groups
Navigate to the assignment’s autograder page to access the error explorer. Errors are automatically grouped by:- Test name
- Error message
- Stack trace patterns
- Number of affected submissions
- Representative error message
- List of affected students
Copying Student Emails
You can view and copy the email addresses of all students affected by a specific error group. This is useful for:- Notifying students about known issues
- Communicating fixes or workarounds
- Following up with students who need assistance
- Click on an error group in the error explorer
- Click the “Copy Emails” button
- Paste the email list into your email client
Regrade Workflow
When you identify an issue with your autograder or tests, Pawtograder provides a streamlined workflow to regrade affected submissions.Launching Regrade from Error Explorer
- Identify the Issue: Use the error explorer to find the error group you want to regrade
- Launch Regrade: Click the “Regrade” button from the error explorer
- Preselect Submissions: The system automatically preselects all submissions affected by that error
- Choose Commits: Select which commits to regrade in the regrade dialog
Regrade Dialog Options
The regrade dialog provides several options:- Regrade Latest Commits: Regrade each student’s most recent submission
- Regrade Specific SHA: Enter a specific commit SHA to regrade
- Auto-Promote: Automatically promote the new submission if it scores higher than the current active submission
Auto-promote is useful when fixing autograder bugs that incorrectly penalized students. It ensures students automatically receive the benefit of the corrected grading without manual intervention.
Conflict Detection
The regrade system includes conflict detection to prevent issues:- Warns if students have made new commits since the error occurred
- Alerts if submissions are already being graded
- Provides clear validation messages before executing the regrade
Best Practices
Analyzing Test Failures
- Review error patterns early: Check the error explorer shortly after the assignment deadline
- Look for clusters: Large error groups may indicate assignment or autograder issues
- Compare across submissions: Use the error explorer to see if errors are consistent or varied
Regrading Submissions
- Test your fix first: Use the test assignment feature to verify your autograder fix works correctly
- Document the issue: Keep notes on what was fixed for future reference
- Communicate with students: Let affected students know about the regrade and any changes
- Use auto-promote carefully: Only enable auto-promote when you’re confident the new grades are correct
Office Hours Integration
When students request help with test failures:- Use the error explorer to see if their issue is widespread
- Check if other students have the same error pattern
- Direct students to existing help requests or discussions if the issue is common
- Use the AI assistance feature to help diagnose unique errors
Technical Details
Error Grouping Algorithm
Errors are grouped using:- Exact test name matching
- Fuzzy matching on error messages (ignoring line numbers and variable names)
- Stack trace similarity analysis
Regrade Performance
- Regrades are processed asynchronously in the background
- Students receive notifications when their regrade completes
- The system prevents duplicate regrades for the same commit
Data Retention
- Error groups are updated in real-time as new submissions arrive
- Historical error data is preserved for analysis
- Regrade history is maintained for audit purposes