lab-camera-optimizer 1.0.2__tar.gz → 1.1.0__tar.gz

{lab_camera_optimizer-1.0.2/lab_camera_optimizer.egg-info → lab_camera_optimizer-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lab-camera-optimizer
-Version: 1.0.2
+Version: 1.1.0
 Summary: Automated camera placement optimiser for markerless biomechanics motion capture labs
 Author: Florian Delaplace
 License-Expression: MIT
@@ -41,7 +41,8 @@ all evaluation points, with optional bilateral coverage constraints.
 
 - **Any room shape** — define any polygon floor plan (L-shaped, rectangular, etc.)
 - **Obstacles & walls** — pillars, partial-height furniture, irregular wall segments
-- **Multiple camera sets** — wall-mounted cameras + optional tripod cameras
+- **Multiple camera sets** — wall-mounted cameras + tripod cameras, both placed by the same zone-wide optimiser
+- **Camera budget** — fix an exact count per set, *or* give a total and let the optimiser choose the wall/tripod split (`total_cameras` + per-set `count_min`/`count_max`)
 - **Per-camera height variation** — each camera in the same configuration can be at a different height
 - **3D visibility** — checks both horizontal FOV and vertical body coverage (0 → subject height)
 - **Line-of-sight** — occlusion by walls and floor-to-ceiling obstacles
@@ -207,12 +208,25 @@ camera_sets:
     height_options: [2.0, 2.2] # tested heights (metres)
     max_range: 10.0
     min_range: 0.5
-    max_count: 8
+    count_max: 8               # max cameras of this set (alias: max_count)
+    count_min: 0               # min cameras of this set (free mode only)
     min_spacing: 1.2
-    score_weight: 1.0
+    score_weight: 1.0          # weight of this set in the score
+    score_factor: 1.0          # extra per-set multiplier (e.g. 0.5 to down-weight)
     color: "#1f77b4"
 ```
 
+#### Camera budget — fixed vs free allocation
+
+```yaml
+optimization:
+  # total_cameras absent → FIXED: each set places exactly its count_max
+  #   (wall-only: tripod count_max 0; "5 wall + 3 tripod": set each count_max)
+  # total_cameras present → FREE: the optimiser splits the total across sets
+  #   within each set's [count_min, count_max] to maximise the score.
+  total_cameras: 8
+```
+
 #### `capture_zones` — where coverage matters
 
 **Corridor-based** (walking path):
@@ -266,6 +280,7 @@ optimization:
   bilateral_weight: 0.8        # 0 = disabled, 1 = fully enforced
   vertical_coverage_threshold: 0.9
   restarts_per_combo: 15
+  total_cameras: null          # null = fixed mode; an int = free allocation
   algo: "greedy_1opt"          # greedy | greedy_1opt
   early_stop: 5                # stop after N restarts with no improvement
   graph_mode: "best_per_combo" # all | records_only | best_per_combo
@@ -275,6 +290,10 @@ optimization:
   distance_quality_factor: 0.001
 ```
 
+> **Note:** the `point` (STS) capture zone is **optional**. With no `point` zone
+> declared, cameras simply optimise coverage of the corridor / analysis /
+> polygon zones — useful for tripod-only or pure zone-wide setups.
+
 ### Step 3 — Preview, then run
 
 ```bash

{lab_camera_optimizer-1.0.2 → lab_camera_optimizer-1.1.0}/README.md

@@ -14,7 +14,8 @@ all evaluation points, with optional bilateral coverage constraints.
 
 - **Any room shape** — define any polygon floor plan (L-shaped, rectangular, etc.)
 - **Obstacles & walls** — pillars, partial-height furniture, irregular wall segments
-- **Multiple camera sets** — wall-mounted cameras + optional tripod cameras
+- **Multiple camera sets** — wall-mounted cameras + tripod cameras, both placed by the same zone-wide optimiser
+- **Camera budget** — fix an exact count per set, *or* give a total and let the optimiser choose the wall/tripod split (`total_cameras` + per-set `count_min`/`count_max`)
 - **Per-camera height variation** — each camera in the same configuration can be at a different height
 - **3D visibility** — checks both horizontal FOV and vertical body coverage (0 → subject height)
 - **Line-of-sight** — occlusion by walls and floor-to-ceiling obstacles
@@ -180,12 +181,25 @@ camera_sets:
     height_options: [2.0, 2.2] # tested heights (metres)
     max_range: 10.0
     min_range: 0.5
-    max_count: 8
+    count_max: 8               # max cameras of this set (alias: max_count)
+    count_min: 0               # min cameras of this set (free mode only)
     min_spacing: 1.2
-    score_weight: 1.0
+    score_weight: 1.0          # weight of this set in the score
+    score_factor: 1.0          # extra per-set multiplier (e.g. 0.5 to down-weight)
     color: "#1f77b4"
 ```
 
+#### Camera budget — fixed vs free allocation
+
+```yaml
+optimization:
+  # total_cameras absent → FIXED: each set places exactly its count_max
+  #   (wall-only: tripod count_max 0; "5 wall + 3 tripod": set each count_max)
+  # total_cameras present → FREE: the optimiser splits the total across sets
+  #   within each set's [count_min, count_max] to maximise the score.
+  total_cameras: 8
+```
+
 #### `capture_zones` — where coverage matters
 
 **Corridor-based** (walking path):
@@ -239,6 +253,7 @@ optimization:
   bilateral_weight: 0.8        # 0 = disabled, 1 = fully enforced
   vertical_coverage_threshold: 0.9
   restarts_per_combo: 15
+  total_cameras: null          # null = fixed mode; an int = free allocation
   algo: "greedy_1opt"          # greedy | greedy_1opt
   early_stop: 5                # stop after N restarts with no improvement
   graph_mode: "best_per_combo" # all | records_only | best_per_combo
@@ -248,6 +263,10 @@ optimization:
   distance_quality_factor: 0.001
 ```
 
+> **Note:** the `point` (STS) capture zone is **optional**. With no `point` zone
+> declared, cameras simply optimise coverage of the corridor / analysis /
+> polygon zones — useful for tripod-only or pure zone-wide setups.
+
 ### Step 3 — Preview, then run
 
 ```bash

lab_camera_optimizer-1.1.0/configs/ISM_fast.yaml

@@ -0,0 +1,108 @@
+# =============================================================
+# ISM lab — FAST preview config (tripod-only)
+# Same room / cameras / zones as example_real_world_ISM, but with
+# coarser candidate grids and fewer restarts for a quick first look.
+# Increase grid resolution + restarts once the layout looks right.
+# =============================================================
+
+room:
+  corners:
+    - [0,   0  ]
+    - [0.87,  0  ]
+    - [0.87,  -0.4]
+    - [3.48,   -0.4]
+    - [3.48,   0]
+    - [17.55,   0]
+    - [17.55, 8.19]
+    - [0, 8.19]
+  height: 6.44
+
+obstacles:
+  - type: rect
+    bounds: [7.6, 5.7, 10, 7.2]
+    height: 1.5
+    label: "Table"
+    can_mount_camera: false
+
+  - type: polygon
+    vertices:
+      - [5.2, 6.89]
+      - [4.7, 7.69]
+      - [5.1, 8]
+      - [5.65, 7.14]
+    height: 1.05
+    label: "Console"
+    can_mount_camera: false
+
+subject:
+  height: 2.3
+  foot_z: 0.0
+
+camera_sets:
+  - id: "cam_B"
+    name: "tripod setup"
+    mounting: "tripod"
+    optional: false
+    fov_h_landscape: 54.0
+    fov_v_landscape:  42.0
+    fov_h_portrait:   42.0
+    fov_v_portrait:  54.0
+    max_range: 9.0
+    min_range:  2.0
+    height_options: [0.65, 3.0]
+    count_max: 18
+    min_spacing: 0.5
+    walk_axis_margin: 2.0
+    score_weight: 1.0
+    color: "#1f77b4"
+
+  - id: "cam_A"
+    name: "Wall camera"
+    mounting: "wall"
+    optional: false
+    fov_h_landscape: 110.0
+    fov_v_landscape:  70.0
+    fov_h_portrait:   70.0
+    fov_v_portrait:  110.0
+    max_range: 12.0
+    min_range:  0.5
+    height_options: [2.0, 2.2]
+    count_max:   0
+    min_spacing: 1.2
+    score_weight: 1.0
+    color: "#d62728"
+
+capture_zones:
+  - id: "platform_zone"
+    type: "polygon"
+    priority: 1
+    grid_step: 0.40           # coarser (was 0.20) → fewer eval points
+    vertices:
+      - [0.0, 0.0]
+      - [6.0, 1.0]
+      - [6.0, 2.8]
+      - [0.0, 1.8]
+    placement:
+      x_offsets: [3.0]
+      y_offsets: [1.5]
+
+  - id: "treadmill_zone"
+    type: "corridor"
+    priority: 1
+    length: 1.8
+    width:   1.0
+    placement:
+      x_start_options: [1.75]
+      y_options: [4.6]
+
+optimization:
+  target_coverage: 3
+  bilateral_weight: 0.9
+  vertical_coverage_threshold: 0.85   # slightly relaxed (was 0.90) — the 42° vertical
+                                      # FOV on a 2.3 m subject is geometrically tight
+  restarts_per_combo: 4               # fewer (was 10) for a fast first look
+  wall_step: 0.35
+  tripod_grid_step: 1.10              # coarser (was 0.70) → far fewer tripod candidates
+  distance_quality_factor: 0.001
+  algo: "greedy_1opt"
+  graph_mode: "best_per_combo"        # one figure per combo (was "all")

lab_camera_optimizer-1.1.0/configs/evaluate_labo_CHU.yaml

@@ -0,0 +1,212 @@
+# =============================================================
+# Lab Camera Optimizer — Configuration file (EVALUATION MODE)
+# Project : CHU Biomechanics Lab — L-shaped room
+# =============================================================
+# Units : metres for all distances, degrees for all angles.
+# Angles follow the standard mathematical convention:
+#   0° = East (+X), 90° = North (+Y), 180°/-180° = West (-X)
+# =============================================================
+
+# ─────────────────────────────────────────────────────────────
+# 1. ROOM GEOMETRY
+# ─────────────────────────────────────────────────────────────
+room:
+  corners:
+    - [0,   0  ]
+    - [13,  0  ]
+    - [13,  3.0]
+    - [8,   3.0]
+    - [8,   4.7]
+    - [0,   4.7]
+  height: 3.0
+
+
+# ─────────────────────────────────────────────────────────────
+# 2. OBSTACLES
+# ─────────────────────────────────────────────────────────────
+obstacles:
+  - type: rect
+    bounds: [1.70, 0.00, 2.04, 0.34]
+    height: 3.0
+    label: "Stub 1"
+    can_mount_camera: true
+
+  - type: rect
+    bounds: [5.39, 0.00, 5.59, 0.42]
+    height: 3.0
+    label: "Stub 2"
+    can_mount_camera: true
+
+  - type: rect
+    bounds: [8.94, 0.00, 9.14, 0.42]
+    height: 3.0
+    label: "Stub 3"
+    can_mount_camera: true
+
+  - type: rect
+    bounds: [5.65, 3.85, 5.85, 4.25]
+    height: 3.0
+    label: "Stub 4"
+    can_mount_camera: true
+
+  - type: rect
+    bounds: [5.65, 2.85, 6.35, 3.55]
+    height: 1.4
+    label: "Object 1"
+    can_mount_camera: false   # partial-height object, no camera mount
+
+  - type: polygon
+    vertices:
+      - [1.47, 4.70]
+      - [1.47, 4.38]
+      - [1.71, 4.38]
+      - [1.71, 3.88]
+      - [2.04, 3.88]
+      - [2.04, 4.27]
+      - [3.02, 4.27]
+      - [3.02, 4.70]
+    height: 3.0
+    label: "Wall N"
+    can_mount_camera: true
+
+
+# ─────────────────────────────────────────────────────────────
+# 3. SUBJECT (person being recorded)
+# ─────────────────────────────────────────────────────────────
+subject:
+  height: 1.9              # total height feet-to-head (metres)
+  foot_z: 0.0              # height of feet above floor (metres, usually 0)
+
+
+# ─────────────────────────────────────────────────────────────
+# 4. CAMERA SETS
+# ─────────────────────────────────────────────────────────────
+camera_sets:
+
+  - id: "cam_A"
+    name: "ZED2i"
+    mounting: "wall"
+    optional: false
+
+    fov_h_landscape: 110.0
+    fov_v_landscape:  70.0
+    fov_h_portrait:   70.0
+    fov_v_portrait:  110.0
+
+    max_range: 15.0
+    min_range:  0.5
+
+    height_options: [2.0, 2.2]
+
+    max_count: 7
+    min_spacing: 1.5
+
+    score_weight: 1.0
+    color: "#1f77b4"
+
+
+  - id: "cam_B"
+    name: "iPad"
+    mounting: "tripod"
+    optional: true
+
+    fov_h_landscape:  80.0
+    fov_v_landscape:  58.0
+    fov_h_portrait:   58.0
+    fov_v_portrait:   80.0
+
+    max_range: 10.0
+    min_range:  0.5
+
+    height_options: [1.5]
+
+    max_count: 2
+    min_spacing: 1.5
+    walk_axis_margin: 0.7
+
+    score_weight: 0.6
+    color: "#d62728"
+
+
+# ─────────────────────────────────────────────────────────────
+# 5. CAPTURE ZONES
+# ─────────────────────────────────────────────────────────────
+capture_zones:
+
+  - id: "full_corridor"
+    type: "corridor"
+    priority: 0.5
+
+    length: 8.0
+    width:   1.0
+
+    placement:
+      x_start_options: [2.0]
+      y_options: [1.70]
+
+  - id: "analysis_zone"
+    type: "sub_zone"
+    priority: 1.0
+
+    length: 6.0
+    contained_in: "full_corridor"
+    offset_options: [1.0] # Laisse 1m de run-up et 1m de decelération dans le couloir de 8m
+
+  - id: "sts_point"
+    type: "point"
+    priority: 2.0
+
+    radius: 0.6
+    contained_in: "analysis_zone"
+    auto_optimize: true
+
+
+# ─────────────────────────────────────────────────────────────
+# 6. OPTIMISATION PARAMETERS
+# ─────────────────────────────────────────────────────────────
+optimization:
+  target_coverage: 6
+  bilateral_weight: 0.8
+  vertical_coverage_threshold: 0.9
+  restarts_per_combo: 50
+
+  wall_step: 0.35
+  angle_steps: 24
+  tripod_grid_step: 0.70
+  distance_quality_factor: 0.015
+
+  algo: "greedy_1opt"
+  graph_mode: "all"
+
+
+# ─────────────────────────────────────────────────────────────
+# 7. EVALUATION SETUP (NEW SECTION)
+# ─────────────────────────────────────────────────────────────
+# This section defines the exact fixed camera setup to evaluate.
+# It completely bypasses the optimization process.
+#
+# Run with: python evaluate.py --config configs/evaluate_labo_CHU.yaml
+#
+# Note: The 'tilt' angle is still automatically calculated by the engine
+#       to point optimally towards the corridor height.
+# ─────────────────────────────────────────────────────────────
+evaluation_setup:
+  fixed_cameras:
+    # Cam 1 : Mur Sud
+    - { set_id: "cam_A", x: 5.30,  y: 0.00, z: 2.3, angle: 120, orientation: "L" }
+    # Cam 2 : Mur Sud
+    - { set_id: "cam_A", x: 7.25,  y: 0.00, z: 2.3, angle: 120, orientation: "L" }
+    # Cam 3 : Mur Sud
+    - { set_id: "cam_A", x: 11.50, y: 0.00, z: 2.3, angle: 120, orientation: "L" }
+    # Cam 4 : Mur Est
+    - { set_id: "cam_A", x: 13.00, y: 1.70, z: 2.3, angle: 180, orientation: "L" }
+    # Cam 5 : Renfoncement (Mur orienté Sud)
+    - { set_id: "cam_A", x: 8.10,  y: 3.00, z: 2.3, angle: 300, orientation: "L" }
+    # Cam 6 : Sur le Stub 4 (Pilier orienté Sud)
+    - { set_id: "cam_A", x: 5.70,  y: 3.85, z: 2.3, angle: 290, orientation: "L" }
+    # Cam 7 : Sur le Polygone (Mur orienté Sud)
+    - { set_id: "cam_A", x: 2.50,  y: 4.27, z: 2.3, angle: 310, orientation: "L" }
+    # iPad 1 : Avant le couloir, regarde le long de l'axe (vers l'Est)
+    - { set_id: "cam_B", x: 1.50,  y: 1.70, z: 1.5, angle: 0, orientation: "L" }
+    # iPad 2 : Au Nord du couloir, regarde vers la zone de marche (vers le Sud)
+    - { set_id: "cam_B", x: 4.70,  y: 3.40, z: 1.5, angle: 290, orientation: "L" }

lab_camera_optimizer-1.1.0/configs/example_evaluation_CHU.yaml

@@ -0,0 +1,66 @@
+# ==============================================================================
+# EXAMPLE CONFIG: EVALUATION MODE
+# ==============================================================================
+# This file demonstrates the "Evaluation Mode". Instead of optimizing camera
+# positions, it evaluates a predefined setup from the `evaluation_setup`
+# section below.
+#
+# To run:
+#   python evaluate.py --config configs/example_evaluation_CHU.yaml
+#
+# ==============================================================================
+
+room:
+  corners: [[0,0], [13,0], [13,5], [10,5], [10,3], [0,3]] # L-shaped room
+  height: 3.0
+
+obstacles:
+  - type: polygon
+    vertices: [[1.0,0.0],[1.2,0.0],[1.2,0.5],[1.0,0.5]]
+    height: 3.0
+    label: "Pillar A"
+    can_mount_camera: false
+
+subject:
+  height: 1.8
+  foot_z: 0.0
+
+camera_sets:
+  - id: "wall_cams"
+    name: "Wall-mounted Vicon"
+    mounting: "wall"
+    fov_h_landscape: 80.0
+    fov_v_landscape: 50.0
+    fov_h_portrait: 50.0
+    fov_v_portrait: 80.0
+    height_options: [2.0, 2.2, 2.4]
+    max_range: 12.0
+    min_range: 0.5
+    max_count: 8
+    min_spacing: 1.5
+    score_weight: 1.0
+    color: "#1f77b4"
+
+capture_zones:
+  - id: "analysis_zone"
+    type: "corridor"
+    priority: 1.0
+    length: 6.0
+    width: 1.2
+    placement:
+      x_start_options: [3.0]
+      y_options: [1.5]
+
+optimization:
+  target_coverage: 4
+  bilateral_weight: 0.8
+  vertical_coverage_threshold: 0.9
+
+evaluation_setup:
+  fixed_cameras:
+    - { set_id: "wall_cams", x: 0.1,  y: 0.1, z: 2.2, angle: 45,  orientation: "L" }
+    - { set_id: "wall_cams", x: 5.0,  y: 0.1, z: 2.2, angle: 90,  orientation: "P" }
+    - { set_id: "wall_cams", x: 12.9, y: 0.1, z: 2.4, angle: 135, orientation: "L" }
+    - { set_id: "wall_cams", x: 12.9, y: 4.9, z: 2.4, angle: 225, orientation: "L" }
+    - { set_id: "wall_cams", x: 10.1, y: 4.9, z: 2.2, angle: 270, orientation: "P" }
+    - { set_id: "wall_cams", x: 0.1,  y: 2.9, z: 2.2, angle: 315, orientation: "L" }

lab_camera_optimizer-1.1.0/configs/labo_CHU_10ZED_3iPad.yaml

@@ -0,0 +1,136 @@
+# =============================================================
+# Lab Camera Optimizer — CHU Biomechanics Lab
+# Run config: 10 ZED (wall) + 3 iPad (tripod), walking corridor + STS point.
+# Derived from labo_CHU.yaml (iPad count 2→3, graph_mode → best_per_combo).
+# =============================================================
+
+room:
+  corners:
+    - [0,   0  ]
+    - [13,  0  ]
+    - [13,  3.0]
+    - [8,   3.0]
+    - [8,   4.7]
+    - [0,   4.7]
+  height: 3.0
+
+obstacles:
+  - type: rect
+    bounds: [1.70, 0.00, 2.04, 0.34]
+    height: 3.0
+    label: "Stub 1"
+    can_mount_camera: true
+
+  - type: rect
+    bounds: [5.39, 0.00, 5.59, 0.42]
+    height: 3.0
+    label: "Stub 2"
+    can_mount_camera: true
+
+  - type: rect
+    bounds: [8.94, 0.00, 9.14, 0.42]
+    height: 3.0
+    label: "Stub 3"
+    can_mount_camera: true
+
+  - type: rect
+    bounds: [5.65, 3.85, 5.85, 4.25]
+    height: 3.0
+    label: "Stub 4"
+    can_mount_camera: true
+
+  - type: rect
+    bounds: [5.65, 2.85, 6.35, 3.55]
+    height: 1.4
+    label: "Object 1"
+    can_mount_camera: false
+
+  - type: polygon
+    vertices:
+      - [1.47, 4.70]
+      - [1.47, 4.38]
+      - [1.71, 4.38]
+      - [1.71, 3.88]
+      - [2.04, 3.88]
+      - [2.04, 4.27]
+      - [3.02, 4.27]
+      - [3.02, 4.70]
+    height: 3.0
+    label: "Wall N"
+    can_mount_camera: true
+
+subject:
+  height: 1.9
+  foot_z: 0.0
+
+camera_sets:
+
+  - id: "cam_A"
+    name: "ZED2i"
+    mounting: "wall"
+    optional: false
+    fov_h_landscape: 110.0
+    fov_v_landscape:  70.0
+    fov_h_portrait:   70.0
+    fov_v_portrait:  110.0
+    max_range: 15.0
+    min_range:  0.5
+    height_options: [1.8, 2.0, 2.2, 2.5]   # wall mount heights to test (1.8 → 2.5 m)
+    max_count: 10            # 10 ZED on the walls
+    min_spacing: 1.5
+    score_weight: 1.0
+    color: "#1f77b4"
+
+  - id: "cam_B"
+    name: "iPad"
+    mounting: "tripod"
+    optional: false
+    fov_h_landscape:  80.0
+    fov_v_landscape:  58.0
+    fov_h_portrait:   58.0
+    fov_v_portrait:   80.0
+    max_range: 10.0
+    min_range:  0.5
+    height_options: [1.5]
+    max_count: 3             # 3 iPad on tripods
+    min_spacing: 1.5
+    walk_axis_margin: 0.7
+    score_weight: 0.6
+    color: "#d62728"
+
+capture_zones:
+
+  - id: "full_corridor"
+    type: "corridor"
+    priority: 0.5
+    length: 10.0
+    width:   1.0
+    placement:
+      x_start_options: [1.0, 2.0]
+      y_options: [1.0, 1.4, 1.8]
+
+  - id: "analysis_zone"
+    type: "sub_zone"
+    priority: 1.0
+    length: 6.0
+    contained_in: "full_corridor"
+    offset_options: [1.0, 2.0, 3.0]
+
+  - id: "sts_point"
+    type: "point"
+    priority: 2.0
+    radius: 0.6
+    contained_in: "analysis_zone"
+    auto_optimize: true
+
+optimization:
+  target_coverage: 6
+  bilateral_weight: 0.9
+  vertical_coverage_threshold: 0.9
+  restarts_per_combo: 35      # Maximale
+  wall_step: 0.25             # finer wall candidate spacing
+  angle_steps: 24
+  tripod_grid_step: 0.50      # finer tripod grid
+  distance_quality_factor: 0.001
+  algo: "greedy_1opt"
+  graph_mode: "best_per_combo"