Properties Reference

Complete reference of all properties in the TrialManager class, organized by functional category.

Core Properties

Experiment State Properties

Calibration Properties

Gaze Tracking Properties

Data Storage

Kalman Filtering

Head Pose Tracking

Outlier Detection

Adaptive Sampling

Image Management Properties

Example Exclusion Structure

{
  1: [2, 3, 15],     // Object 1 cannot appear with objects 2, 3, or 15
  2: [1, 4],         // Object 2 cannot appear with objects 1 or 4
  // ... etc
}

UI Element Properties

Property Access Patterns

Reading Trial Data

// Access current trial information
const currentTrialNum = trialManager.currentTrial + 1; // 1-based for display
const totalTrials = trialManager.trialCount;
const progress = (currentTrialNum / totalTrials * 100).toFixed(1) + '%';

// Access gaze data for current trial
const currentGaze = trialManager.currentGazeData;
const gazePointCount = currentGaze.length;
const avgX = currentGaze.reduce((sum, p) => sum + p.x, 0) / gazePointCount;

Checking Calibration Status

if (trialManager.calibrationComplete) {
    console.log('Calibration successful - ready for trials');
} else if (trialManager.calibrationInProgress) {
    console.log('Calibration in progress...');
} else {
    console.log('Calibration not started');
}

Examining Head Pose Data

// Check if head pose tracking is active
if (trialManager.baselineHeadPose) {
    console.log('Head pose baseline established');
    console.log('Baseline:', trialManager.baselineHeadPose);
}

// Check recent gaze points for outlier detection
const recentPoints = trialManager.recentGazePoints;
console.log(`Tracking last ${recentPoints.length} gaze points`);

Monitoring Kalman Filter State

// Inspect Kalman filter state
console.log('Kalman X state:', trialManager.kalmanX);
// Output: {q: 0.01, r: 0.1, p: 0.95, x: 512.34, k: 0.09}

// Process noise / measurement noise ratio indicates filter behavior
const filterRatio = trialManager.kalmanX.q / trialManager.kalmanX.r;
// Lower ratio = more smoothing, higher ratio = more responsive

Property Modification Guidelines

Safe to Modify (with care)

• maxRecentPoints - Adjust outlier detection sensitivity (5-10 recommended)
• CALIBRATION_POINTS - Change before calibration (9-15 recommended)

Never Modify Directly

• trialData - Managed by runTrial()
• allGazeData - Managed by processGazeData()
• calibrationComplete - Set by startCalibrationPhase()
• kalmanX/kalmanY - Managed by kalmanFilter()

Read-Only in Practice

• participantId - Set in constructor
• totalImages - Set by setupImages()
• testType - Set by showInitialsDialog()
• userInitials - Set by showInitialsDialog()

Data Structure Examples

currentTrialData Structure

{
  trialNumber: 5,
  type: 1,
  startTime: 1706284843120,
  endTime: 1706284858125,
  object1: 45,
  testObjects: [45, 127, 127],
  positions: [
    { position: "left", objectNum: 45, isTarget: true },
    { position: "center", objectNum: 127, isTarget: false },
    { position: "right", objectNum: 127, isTarget: false }
  ],
  gazeData: [/* array of gaze points for this trial */]
}

Gaze Data Point Structure

{
  x: 512.3,
  y: 384.7,
  rawX: 515.1,
  rawY: 388.2,
  headPose: {
    roll: 0.05,
    pitch: -0.02,
    yaw: 0.08,
    distance: 125.4
  },
  time: 1706284847123,
  relativeTime: 2543,
  phase: "experiment"
}

See Also

• TrialManager Class Overview
• Methods Reference
• Gaze Tracking Deep Dive
• Quick Start Guide