config.yaml.example

execution:
  device: auto
  strict_parity: true

background:
  sample_frames: 200
  uniform_sampling: true

detection:
  blur_kernel: 5
  threshold_mode: otsu
  diff_threshold: 18
  otsu_offset: -4
  morph_open: 1
  morph_close: 3
  min_area: 6
  max_area: 5000
  max_global_intensity_shift: -1.0
  max_foreground_ratio: -1.0
  max_detections_per_frame: 0
  roi_x_min: -1.0
  roi_x_max: -1.0
  roi_y_min: -1.0
  roi_y_max: -1.0
  temporal_burst_min_detections: 0
  temporal_burst_window_frames: 0
  temporal_burst_trigger_frames: 0
  temporal_burst_cooldown_frames: 0

tracking:
  max_distance: 60.0
  max_missed: 12
  min_track_length: 1
  min_track_duration_sec: 0.0
  min_track_displacement: 12.0
  min_track_path_length: 18.0
  min_track_straightness: 0.0
  require_start_or_end_in_valid_region: false
  valid_region_gate_dilate_px: 0
  auto_merge_suggested: false
  merge_max_gap_frames: 8
  merge_max_endpoint_distance: 80.0
  merge_overlap_min_common_frames: 3
  merge_overlap_max_mean_distance: 60.0
  merge_overlap_min_direction_cosine: 0.8

valid_region:
  enabled: true
  method: horizontal_illumination_profile
  apply_to_detection: true
  hybrid_combine_mode: and
  input_image: ""
  blur_kernel_size: 151
  profile_smooth_window: 31
  threshold_ratio: 0.45
  safety_margin: 10
  min_region_width_ratio: 0.35
  depth_percentile: 85.0
  depth_morph_kernel: 9
  depth_min_area_ratio: 0.02
  depth_layer_percentiles: []
  depth_layer_dilate_px: []
  bottom_contour_snap_enabled: false
  bottom_contour_search_up_px: 18
  bottom_contour_search_down_px: 48
  bottom_contour_smooth_window: 31
  bottom_contour_gradient_quantile: 55.0
  bottom_contour_regularization: 0.90
  bottom_contour_max_step_px: 10
  bottom_contour_downward_bias: 0.10
  bottom_contour_regularization_mix: 0.75
  bottom_contour_deepest_strong_ratio: 0.70
  output_subdir: valid_region

output:
  overlay_line_thickness: 2
  overlay_start_radius: 5
  overlay_alpha: 1.0
  overlay_draw_track_labels: false
  overlay_draw_track_labels_at_end: false
  overlay_label_font_scale: 0.5
  overlay_label_thickness: 1
  progress_enabled: true
  progress_step_percent: 5
  export_track_clips: false
  track_clips_subdir: track_clips
  track_clips_padding_frames: 0