Tree Node Interactions

Hover Behavior:

• Move cursor over any rectangular node in the tree
• Node brightens slightly and border becomes more prominent
• Tooltip appears near cursor showing:
  • Node label (e.g., "Average Motion Sickness")
  • Node value (e.g., "5.2/10")
  • Node type/context (Root, Gender category, or Metric)

Tooltip Position:

• Tooltip follows cursor smoothly
• Auto-repositions to avoid going off-screen
• Disappears when cursor leaves node
• Smart positioning: appears to cursor right/below when possible, reverses if near screen edge

Radar Chart Interactions

Data Point Hover:

• Move cursor over any colored point on the radar lines
• Tooltip displays metric name and exact value for that gender
• Example: "Male - Average Age: 34.5"

Center Hotspot Hover:

• Move cursor to the center of the radar chart
• Displays comprehensive summary tooltip
• Shows all four metrics for each visible gender category
• Useful for quick multi-metric comparison

Icon Label Hover:

• Move cursor over gender label and count in corner
• Confirmation tooltip appears (e.g., "Male: 152 users")
• Provides quick reference for demographic breakdown

Filter Controls

View Selection (Primary):

• Click "Individual" button to see three separate trees
• Click "Summary" button for consolidated tree + headset filters
• Click "Charts" button for radar visualization + headset & gender filters
• Active view highlighted in blue with solid border

Headset Checkboxes (Summary & Charts Views):

• Click checkbox to include/exclude a VR headset
• Multiple selections allowed and encouraged
• Selection labeled in tree title (e.g., "Summary: PlayStation VR, Oculus Rift")
• Unchecked devices' data immediately excluded from visualization
• All three devices selected by default

Gender Toggle Buttons (Charts View Only):

• Click button to toggle gender category on/off
• Button color fills when gender is selected
• At least one gender must remain selected
• Last selected gender cannot be deselected
• Radar chart updates immediately to show only selected genders
• Icons disappear if their gender is deselected

---

🚀 Getting Started

Initial Setup

1. Load the Application

   • Open index.html in a modern web browser
   • No build process or server required
   • Works on desktop, tablet, and mobile devices

2. Wait for Data Load

   • CSV file loads automatically on page open
   • Small loading delay (data parsed and converted to numbers)
   • Visualization appears once data is ready

First-Time Usage

1. Select a View Mode

   • Click one of three view buttons at top:
     • "Individual" (default: shows three trees)
     • "Summary" (shows consolidated view)
     • "Charts" (shows radar and demographics)

2. Explore Individual Trees (if viewing Individual)

   • Three trees display side-by-side (or stacked on mobile)
   • Each tree represents one VR headset
   • Hover over nodes to learn about metrics
   • Trees are read left-to-right: Root → Gender → Metrics

3. Apply Filters (if viewing Summary or Charts)

   • Summary View:
     • Use checkboxes to select/deselect VR headsets
     • Tree updates instantly to show only selected devices
   • Charts View:
     • Use headset checkboxes to filter devices
     • Use gender buttons to filter demographics
     • Radar and icons update in real-time

4. Interpret the Visualizations

   • Tree size: Larger boxes = higher values
   • Tree color: Indicates node type (green=root, blue=male, pink=female, orange=other)
   • Radar shape: Pentagon = balanced metrics, pointed star = unbalanced
   • Radar size: Larger polygon = higher average values

5. Generate Insights

   • Compare metrics across genders using Summary view
   • Check if certain devices cause more motion sickness
   • Identify which demographics have longest sessions
   • Find immersion correlations with age or gender

---

🎨 Visual Design System

Color Palette

Typography

• Heading/Title: 14-16px, bold, dark gray (#222)
• Node Labels: 9-10px, bold, black
• Node Values: 8-9px, medium weight, dark gray (#444)
• Tooltips: 12-13px, white text on dark background
• Buttons: 13-14px, varies by state

Responsive Breakpoints

Interactive Feedback

• Hover Effects: +15% brightness, +1px border width
• Button Active: Blue fill (#2196F3), solid border
• Disabled Elements: 50% opacity, cursor changes to "not-allowed"
• Transitions: 0.2-0.3s ease for smooth animations

---

💻 Technical Architecture

Technology Stack

File Organization

Data Flow

Browser Support

• Chrome/Edge: Full support, ES6 modules
• Firefox: Full support, ES6 modules
• Safari: Full support, ES6 modules
• Mobile Browsers: Responsive layout, touch-friendly
• Minimum Requirements: ES6 module support, Canvas API, SVG support

---

📊 Section-by-Section Breakdown

Section 1: Individual Tree Views

What it shows:

• Three separate hierarchical visualizations
• One tree per VR headset (PlayStation VR, HTC Vive, Oculus Rift -) )wi All data grouped by gender with averaged metrics

How to read it:

• Left side (green box) = Total users for that headset
• Three branches from root = Male, Female, Other genders
• Right side leaves = Four metrics (Age, Sickness, Duration, Immersion)
• Box size corresponds to value (larger = higher number)

Interpretation tips:

• Compare tree shapes across devices
• Narrow leaf (e.g., motion sickness = 2.1) = good for that metric
• Wide leaf (e.g., motion sickness = 8.7) = potential issue
• If one gender branch is much larger, that demographic dominates that device

When to use:

• Initial exploration of each device
• Understanding device-specific patterns
• Baseline comparison before viewing aggregates

---

Section 2: Summary View

What it shows:

• Single consolidated tree combining selected headsets
• User count aggregates across devices
• Averaged metrics now represent the combined dataset

How to read it:

• Same tree structure as Individual view
• Root node count = sum of all selected headsets
• Gender branches = combined males/females/others from selected devices
• Leaf values = averages across the filtered dataset

Filtering workflow:

1. Uncheck devices you want to exclude
2. Tree regenerates with remaining data
3. Title updates to show which devices are included
4. Compare different combinations to find patterns

Interpretation tips:

• If PlayStation VR + Oculus shows high motion sickness but individually they're low, different user demographics
• Subset comparison: try just PlayStation + HTC to see if pattern holds
• Watch how averages shift as you add/remove headsets

When to use:

• Market-wide analysis across devices
• Testing hypotheses about user behavior
• Comparing subsets (e.g., "do premium devices attract different users?")
• Generating management reports

---

Section 3: Charts (Radar & Demographics)

What it shows:

• Radar chart with four metrics plotted in 2D space
• Gender icons in corners with demographic counts
• Center hotspot for summary statistics

Radar Chart Explanation:

• Each axis represents one metric (Age, Motion Sickness, Duration, Immersion)
• Each colored polygon = one gender's data
• Polygon size/shape shows relative performance across metrics
• Overlapping areas show similarities between genders

Reading the Radar:

• Large polygon: Gender has high average values
• Pointed corners: Good performance in specific metrics
• Rounded polygon: Balanced performance
• Small polygon: Lower average values

Gender Icon Components:

• Visual icon: SVG figure illustration in gender color
• Label: Gender name
• Count: "n = X" shows number of users in that demographic
• Position: Top-left (Male), Top-right (Female), Bottom-left (Other)

Filtering on Charts:

• Headsets: Check/uncheck to include/exclude devices from radar
• Genders: Click buttons to show/hide gender polygons
• Constraints: Must have at least one gender visible

Interaction features:

• Hover data points → see specific metric value
• Hover center → see all metrics summary
• Hover icons → confirm user count

Interpretation tips:

• If Female polygon is much larger, females in your dataset rate things higher
• If Male age point is far right, males are older on average
• Comparing radar shapes: are males more immersed? Do females experience more sickness?
• Test filtered subsets: "Do older users have longer sessions?"

When to use:

• Demographic analysis and comparison
• Understanding gender-based user experience differences
• Identifying outlier metrics
• Creating presentable comparative charts

---

⚙️ Advanced Features

Responsive Design Implementation

Mobile-First Approach:

• Base styles target small screens (< 480px)
• Breakpoints scale up from there
• Touch-friendly button sizes (minimum 44px × 44px)
• Vertical scrolling preferred over horizontal

Adaptive Layouts:

• Individual View: Stacks vertically on mobile
• Trees reduce size but maintain proportions
• Summary and Charts: Center with max-width for readability
• Tooltips reposition to avoid screen edges

Real-Time Data Filtering

Filtering Architecture:

• No data recalculation → pure filtering of existing data
• New aggregations computed immediately
• Tree structure rebuilt with filtered data
• Radar chart dataset updated with new averages

Performance Considerations:

• CSV parse happens once at startup
• Filter operations are O(n) = fast even with large datasets
• Tree layout recalculation < 100ms
• Smooth visual transitions between states

Tooltip System

Smart Positioning:

• Calculated offset from cursor (10px right/below)
• Viewport boundary detection
• Automatic repositioning if would go off-screen
• Fixed positioning keeps tooltips visible during scroll

Content Adaptation:

• Different tooltip formats for different elements
• Node tooltips: include type/context
• Metric tooltips: show actual values
• Icon tooltips: confirm demographic labels
• Center hotspot: comprehensive summary

---

🔍 Metrics Deep Dive:# Ra# Age (Years)

Scale: Real-world ages from user population Meaning: Average age of users in that demographic Implications:

• Older users (>50): May have different VR tolerance
• Younger users (<25): Likely more gaming experience
• Age differences by gender: Marketing targeting clues
• Age differences by device: User preference correlation

Example interpretation:

• PlayStation VR female users average 45 years
• HTC Vive female users average 28 years
• PlayStation VR may attract different demographic

Motion Sickness (0-10 Scale)

Scale: 0 = No sickness, 10 = Severe nausea Meaning: Average reported motion sickness level Implications:

• Score > 6: Significant usability issue
• Score < 3: Device/content well-designed for comfort
• Differences by gender: Women may report differently than men
• Differences by device: Hardware/tracking quality matters
• Correlation with duration: High sickness = shorter sessions

Example interpretation:

• PlayStation VR male users: 5.2/10 sickness
• HTC Vive male users: 3.1/10 sickness
• HTC Vive appears more comfortable for males

Duration (Minutes)

Scale: Session length from 0 to 60+ minutes Meaning: Average VR session length before logout/break Implications:

• Longer duration = higher engagement/tolerance
• Shorter duration = content too intense or device uncomfortable
• Correlates with immersion: Immersed users stay longer
• May inverse-correlate with motion sickness: Sickness forces exit
• Marketing proxy: Engagement metric

Example interpretation:

• High immersion users stay 45 minutes on average
• Low immersion users stay 15 minutes on average
• 3x engagement difference suggests immersion quality matters

Immersion Level (0-5 Scale)

Scale: 0 = Not immersive, 5 = Completely immersive Meaning: User's subjective sense of presence in VR Implications:

• Score > 4: Excellent user experience
• Score < 2: Breaks sense of presence
• Correlates with duration: Immersed users stay longer
• May vary by content, not just hardware
• Key metric for VR effectiveness

Example interpretation:

• PlayStation VR females: 3.8/5 immersion
• Oculus Rift females: 2.1/5 immersion
• PlayStation VR provides better female user immersion

---

🎯 Common Analysis Workflows

Workflow 1: Device Comparison

1. Switch to Individual view
2. Compare tree shapes for PlayStation VR vs HTC Vive vs Oculus Rift
3. Look for consistent patterns in motion sickness or duration
4. Insight: Which device has the best user experience?

Workflow 2: Gender-Based Analysis

1. Switch to Charts view
2. Examine radar polygon shapes for each gender
3. Look at icon counts to understand demographic breakdown
4. Insight: Do different genders experience VR differently?

Workflow 3: Demographic Targeting

1. Use Summary view with specific headset combinations
2. Check age ranges for each gender
3. Combine with duration to understand engagement
4. Insight: Which demographic is most engaged with which device?

Workflow 4: Troubleshooting User Experience

1. Look for high motion sickness (> 6/10) in any category
2. Compare duration for that group
3. Check if immersion rating is also low
4. Insight: Hardware/content causing discomfort needs fixing

Workflow 5: Market Expansion

1. Analyze which device/gender combination has lowest immersion
2. Consider it opportunity for improvement
3. Check if motion sickness is related to low immersion
4. Insight: Targeting this segment with better content could expand market

---

📱 Mobile Experience

Touch Interactions

• Hover effects replaced with tap/hold feedback
• Tooltips appear on tap, dismiss on tap elsewhere
• Buttons enlarged for touch targets (48px minimum)
• Scrolling enabled for long content

Screen Adaptations

• < 480px: Single-column layout, stacked trees
• < 600px: Reduced font sizes, simplified spacing
• Full-width SVGs scale responsively
• Radar chart height reduced but maintains aspect ratio

Performance on Mobile

• Smaller tree dimensions to reduce rendering load
• Tooltip positioned intelligently to avoid occlusion
• Canvas rendering optimized for tablet processors
• Touch events debounced to prevent double-triggers

---

🐛 Troubleshooting

Data Not Loading

• Issue: CSV file not found
• Solution: Verify "Virtual Reality Experiences.csv" is in same directory as index.html
• Check: Browser console for 404 errors

Trees Not Rendering

• Issue: SVG appears blank
• Solution: Wait for data to load (check browser network tab)
• Check: Ensure browser supports ES6 modules (Chrome 63+)

Tooltips Appearing Offscreen

• Issue: Tooltips cut off at screen edges
• Solution: This is auto-corrected, may need to move cursor
• Check: Browser zoom level (try 100%)

Mobile Layout Issues

• Issue: Trees overlapping or too narrow
• Solution: Rotate device to landscape for more space
• Check: Browser zoom reset to 100%

---

📞 Support & Questions

For technical issues:

• Check browser console (F12) for error messages
• Verify data file exists and is properly formatted
• Test in different browser
• Check that JavaScript is enabled

For data interpretation questions:

• Review "Metrics Deep Dive" section above
• Check "Interpretation tips" in Section-by-Section breakdown
• Try filtering to test hypotheses
• Compare across multiple views for validation

---

📝 License & Attribution

• D3.js: BSD 3-Clause License
• React: MIT License
• Chart.js: MIT License

---

📅 Version History

v1.0.0 - Initial Release

• Individual tree views for each VR headset
• Summary view with multi-device filtering
• Charts view with radar visualization
• Gender-based demographic analysis
• Full responsive design
• Interactive tooltips across all views

---

Last Updated: 2024 Data Format: CSV with user-level VR experience records Browser Support: Chrome, Firefox, Safari, Edge (modern versions)