Viewing Your Timeline¶

Once you've uploaded documents and extracted events, ChronoScope offers six interactive views to explore your timeline. Each view reveals different insights about your personal timeline data.

The Six Views¶

ChronoScope organizes your timeline into six tabs, each designed for a specific purpose:

1. Interactive Timeline View¶

What You'll See¶

The Interactive Timeline presents your events as horizontal bars on a chronological axis. Each event appears as a colored bar showing its duration, with the most recent events at the top.

Customizable Title: - Edit the timeline title using the text input at the top - Default: "My Personal Timeline" - Your custom title appears on the visualization and persists across sessions

Visual Elements: - Horizontal bars - Each represents one event, sized by duration - Colors - Earth-tone palette based on priority (1-10 scale) - Event labels - Truncated titles appear directly on bars - Date axis - Bottom axis shows chronological progression

Interacting with the Timeline¶

Hover for Details:

Move your cursor over any event to see a rich information card:

📊 Senior Software Engineer

📅 Period: 2020-01-15 → 2023-03-30
📍 Location: San Francisco, CA
📝 Description: Led development team building cloud-native...
🏷️ Tags: career, engineering, leadership
👥 People: John Doe, Jane Smith
⭐ Priority: 8/10
🎯 Confidence: 85.0%

Zoom and Pan: - Zoom in/out - Use mouse scroll wheel - Pan left/right - Click and drag the timeline - Reset view - Double-click the background - Download chart - Click the camera icon (top right)

Color Coding:

Events are colored by priority level using earth tones: - High priority (7-10) - Darker, terra cotta tones - Medium priority (4-6) - Sand and taupe - Low priority (1-3) - Light stone colors

When to Use This View¶

Use the Interactive Timeline when you want to: - See the big picture of your life journey - Identify gaps or busy periods - Understand event sequences and timings - Present your timeline visually to others

2. Data Table View¶

What You'll See¶

A sortable, searchable spreadsheet showing all events with key details in columns. Some fields are editable directly in the table.

Editable Columns: - Title - Click to edit event name - Tags - Multiselect dropdown for adding/removing tags - Priority - Number input (1-10 scale)

Read-Only Columns: - Select - Checkbox for bulk actions - Start Date - When the event began (extracted from document) - End Date - When it ended (extracted from document) - Duration - Calculated length in days - Location - Where it occurred - Confidence - Extraction certainty (0-100%) - Source - Originating document

User Feedback Columns: - Verified - Checkbox to mark event as verified - Rating - Number input (1-5 stars) for quality rating - Feedback - Text notes about the event or extraction accuracy

Interacting with the Table¶

Sorting: - Click any column header to sort ascending/descending - Click again to toggle sort order - Events are initially sorted by start date (newest first)

Searching: - Use the search box above the table - Searches across titles, descriptions, tags, and locations - Results update in real-time as you type

Filtering: - Use the sidebar filters (date range, confidence, priority) - Table updates automatically to show only matching events

Editing Fields: 1. Click on any editable field (Title, Tags, Priority, Verified, Rating, Feedback) 2. Make your changes directly in the table 3. Click "💾 Save Field Edits" to persist changes to storage 4. Changes are applied immediately after saving

Tag Manager: - Create new tags using the "New Tag" input field - Click "Add Tag" to add it to the system - New tags become available in all event tag dropdowns - Helps maintain consistency across your timeline

Bulk Actions: 1. Select multiple events using checkboxes 2. Click "Delete Selected Events" to remove them 3. Click "Clear Selection" to uncheck all events 4. Confirm deletion in the dialog

Timeline Statistics¶

Below the table, you'll find summary statistics:

Event Breakdown: - Total events - Events with/without end dates - Events with/without locations - Average confidence score - Date range coverage (earliest to latest)

Source Documents: - Count of unique source files - Events per document

When to Use This View¶

Use the Data Table when you need to: - Edit event details - Update titles, add/remove tags, adjust priorities - Add user feedback - Mark events as verified, rate quality, add notes - Manage tags - Create new tags and organize your timeline - Search for specific events quickly - Review event details systematically - Delete or audit individual entries - Export data for external use - Check confidence scores and validate quality

3. Analytics Dashboard¶

What You'll See¶

Two complementary visualizations that reveal patterns in your timeline:

Priority Matrix (Scatter Plot): - X-axis - Time (event start date) - Y-axis - Priority level (1-10) - Bubble size - Event duration - Bubble color - Event category

Insights: - High-priority recent events appear in the top-right - Large bubbles indicate long-duration commitments - Clusters show concentrated activity periods

Temporal Distribution (Histogram): - Bars - Number of events per time period - Height - Event frequency - Granularity - Automatically adjusted based on date range

Insights: - Tall bars indicate high-activity periods - Gaps show quiet periods or career transitions - Overall shape reveals life phases

When to Use This View¶

Use Analytics when you want to: - Identify patterns in your timeline - See which periods were busiest - Understand priority distribution over time - Spot trends or changes in life focus - Prepare for performance reviews or self-assessment

4. Validation View¶

What You'll See¶

The Validation tab provides quality assurance for your extracted timeline data.

Three Validation Modes:

1. Quick Validation - Instant quality checks
2. Gold Standard Comparison - Benchmark against reference data
3. Event Management - Find and merge duplicates

Quick Validation Checks¶

Automatic checks for common data quality issues:

• Missing dates - Events without start/end dates
• Low confidence scores - Events below threshold (typically <70%)
• Incomplete locations - Events missing location data
• Empty descriptions - Events with no context
• Suspicious date ranges - Events spanning implausible timeframes

Gold Standard Validation¶

If you've created reference data, this mode compares extracted events against your gold standard to calculate:

• Precision - Percentage of extracted events that are correct
• Recall - Percentage of actual events successfully extracted
• F1 Score - Harmonic mean of precision and recall

Finding Duplicates¶

The duplicate detection tool identifies similar events using: - Title similarity - Fuzzy string matching - Date overlap - Events with overlapping timeframes - Location matching - Same place, similar dates

Merging Duplicates: 1. Click "Find Potential Duplicates" 2. Review suggested duplicate groups 3. Select primary event to keep 4. Merge secondary events into it 5. Combined event retains all information

When to Use This View¶

Use Validation when you: - First upload new documents - Notice inconsistencies in visualizations - Want to verify extraction accuracy - Need to clean up duplicate entries - Are preparing timeline data for important use

5. Export to TimelineJS¶

See the dedicated Export Guide for complete details.

Quick Summary:

This tab lets you export your timeline to TimelineJS, a professional web-based timeline tool.

Features: - 6 color schemes (Earth Tones, Vibrant Sunset, Ocean Blues, etc.) - 10 font combinations (Professional Sans, Classic Serif, Modern Mono, etc.) - Event grouping by tags or priority - Excel or JSON export formats - Live preview of first 10 events

6. Knowledge Graph View¶

See the Knowledge Graph Guide for complete details.

Quick Summary:

Visualizes relationships between events, people, places, and tags as an interactive network graph.

What It Shows: - Nodes - Events, people, locations, tags - Edges - Connections between nodes - Colors - Different entity types - Size - Importance (how many connections)

Insights: - Which people appear across multiple events - Geographic clustering of activities - Tag relationships and categories - Timeline flow and event sequences

Navigation Tips¶

Switching Between Views¶

Quick Access: - Click any tab at the top to switch views instantly - No data is lost when switching - Filters applied in sidebar persist across tabs

Using Multiple Views Together¶

Recommended Workflow:

1. Start with Interactive Timeline - Get the big picture
2. Switch to Data Table - Find specific events or details
3. Check Validation - Ensure data quality
4. Use Analytics - Discover patterns
5. Explore Knowledge Graph - Understand relationships
6. Export to TimelineJS - Share your final timeline

Filtering Across All Views¶

Filters in the sidebar affect all six views simultaneously:

• Date Range - Limit to specific time period
• Minimum Confidence - Show only high-quality extractions
• Priority Range - Focus on important events
• Source Documents - Filter by origin file

To clear filters: Click "Clear All Filters" button in sidebar

Performance Tips¶

For Large Timelines (100+ events):

• Use date range filters to focus on specific periods
• Increase minimum confidence threshold to reduce noise
• Start with Data Table for quick searching
• Use Analytics for overview before detailed examination

For Better Visualizations:

• Ensure events have end dates for accurate duration bars
• Add tags for color-coding and grouping
• Set priority levels to highlight important events
• Include location data for geographic insights

Troubleshooting¶

Timeline appears empty: - Check if filters are too restrictive - Verify events exist in Data Table view - Clear all filters and try again

Events overlap and are hard to read: - Zoom in using mouse wheel - Use Data Table for detailed inspection - Filter by date range to reduce visible events

Colors look similar: - Events are colored by priority (1-10) - Adjust priority values to create more distinction - Consider exporting to TimelineJS for more color options

Next Steps¶

• Filtering Events - Master the filtering system
• Validation Guide - Ensure data quality
• Export Options - Share your timeline

Back to Documentation Home