calibrate-suite 0.1.0__tar.gz → 0.1.2__tar.gz

{calibrate_suite-0.1.0/src/calibrate_suite.egg-info → calibrate_suite-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: calibrate-suite
-Version: 0.1.0
+Version: 0.1.2
 Summary: Comprehensive camera-lidar calibration suite with GUI and fleet management
 Home-page: https://github.com/Opera5/calibrate-suite
 Author: Jamih
@@ -149,46 +149,39 @@ sudo apt update
 
 ### Installation Options
 
-**Option 1: ROS2 + System Packages (Recommended for ROS users)**
+**Option 1: ROS2 + System Packages (Recommended for ROS users in development mode)**
 ```bash
 # Install system dependencies
 sudo apt install python3-opencv python3-open3d python3-pyqt5 python3-yaml
 
+# Install in development mode
+pip install -e .
+
+# Or with GUI dependencies
+pip install -e .[gui]
+
+# Or with all features
+pip install -e .[full]
+
 # Build with ROS2
 cd ~/calib_ws
 colcon build --packages-select calibrate-suite
 source install/setup.bash
-
-# Launch after installation
-calibrate-suite  # GUI
-fleet-server      # REST API
 ```
 
 **Option 2: pip - Core Only (Minimal)**
 ```bash
-pip install calibrate-suite
-```
-
-**Option 3: pip - With Computer Vision**
-```bash
-pip install calibrate-suite[cv]
+pip install calibrate-suite==0.1.0
 ```
-
-**Option 4: pip - With 3D Processing**
+**Option 3: pip - with full features**
 ```bash
-pip install calibrate-suite[3d]
+pip install calibrate-suite==0.1.0 [full]
 ```
-
-**Option 5: pip - With GUI**
-```bash
-pip install calibrate-suite[gui]
-```
-
-**Option 6: pip - Full Installation (Isolated venv recommended)**
+**Option 4: pip - Full Installation (Isolated venv recommended)**
 ```bash
 python3 -m venv calib_env
 source calib_env/bin/activate
-pip install calibrate-suite[full]
+pip install calibrate-suite==0.1.0
 
 # Launch commands after installation
 calibrate-suite  # GUI
@@ -235,6 +228,34 @@ fleet-server --version
 
 ### Known Conflicts & Solutions
 
+**Issue: RViz snap glibc conflicts**
+```
+Problem: RViz snap conflicts with system glibc (__libc_pthread_init error)
+Solution: Use system RViz instead of snap
+  sudo apt install ros-humble-rviz2
+  # OR continue without RViz (extractor still works)
+```
+
+**Issue: NumPy version conflicts**
+```
+Problem: Mixed system (1.21.5) and pip NumPy versions causing sklearn conflicts
+Solution: Use consistent package sources
+  # Remove pip scientific packages
+  pip uninstall numpy scipy scikit-learn open3d opencv-python
+  
+  # Use system packages
+  sudo apt install python3-numpy python3-scipy python3-sklearn python3-opencv python3-open3d
+  
+  # Reinstall calibrate-suite without dependencies
+  pip install -e . --no-deps
+  or 
+  # Remove pip-installed numpy and opencv
+pip uninstall numpy opencv-python
+
+# Use system packages
+sudo apt install python3-numpy python3-opencv
+```
+
 **Issue: OpenCV conflicts with system Qt/RViz**
 ```
 Problem: pip opencv-python can conflict with system OpenCV
@@ -279,19 +300,34 @@ calibrate-suite
 
 **GUI Workflow Tabs:**
 
-| Home/Record | Overlay |
+| Home |
+| ![Home Interface](src/gui/assets/GUI_homepage.png)|
+
+| Single-LiDAR Record | Calibrate |
+|---|---|
+| ![Single LiDAR Record](src/gui/assets/single_lidar_record_page.png) | ![Single LiDAR Calibrate](src/gui/assets/single_lidar_calibrate_page.png) |
+
+| 2D-3D Record page | 3D-3D Record page |
+|---|---|
+| ![2D-3D Record](src/gui/assets/2d-record-page.png) | ![3D-3D Record](src/gui/assets/3d-record-page.png) | 
+
+| 2D-3D Calibrate page | 3D-3D Calibrate page |
 |---|---|
-| ![Home Interface](src/gui/assets/GUI_homepage.png) | ![Record Page](src/gui/assets/3d-or-2d-record-page.png) |
+| ![2D-3D Calibrator](src/gui/assets/2d-calibrate-page.png) | ![3D-3D Calibrator](src/gui/assets/3d-calibrate-page.png) | 
+
+| 2D-3D Overlay page | 3D-3D Overlay page |
+|---|---|
+| ![2D-3D Calibrator](src/gui/assets/2d-overlay-page.png) | ![3D-3D Calibrator](src/gui/assets/3d-overlay-page.png) |
 
 ### Command-Line (Quick Calibration)
 ```bash
 cd /home/jamih/calib_ws/src/calibrate-suite/src
 
 #launching calibrator suite from terminal
-# Method 2: Direct Python execution
+# Method 1: Direct Python execution
 python3 -m gui.main
 
-# Method 3: Direct script execution
+# Method 2: Direct script execution
 python3 gui/main.py
 
 # 2D-3D Calibration (AprilTag-based, recommended)
@@ -313,7 +349,7 @@ python3 2d_3d_data_extractor.py \
 python3 2d_3d_calibrator.py --data_root ../calib_data/multimodal_captures
 
 # 3. Visualize results
-python3 visualize_alignment.py --data_root ../calib_data/multimodal_captures
+python3 2d_3d_overlay.py --data_root ../calib_data/multimodal_captures
 ```
 
 ---
@@ -358,11 +394,6 @@ python3 visualize_alignment.py --data_root ../calib_data/multimodal_captures
 ```
 GUI → Single LiDAR Tab → Upload PCD files → Select method → Run → View metrics
 ```
-
-| Record | Calibrate |
-|---|---|
-| ![Single LiDAR Record](src/gui/assets/single_lidar_record_page.png) | ![Single LiDAR Calibrate](src/gui/assets/single_lidar_calibrate_page.png) |
-
 ---
 
 ### Framework 2: 3D-3D Camera-LiDAR Calibration
@@ -459,17 +490,13 @@ final_extrinsic.yaml:
 GUI → 2D-3D Tab → Select data directory → Configure quality filter → Run → View metrics
 ```
 
-| GUI Interface | Alignment Visualization |
-|---|---|
-| ![2D-3D Calibration](src/gui/assets/3d_or_2d_calibrate-page.png) | ![Alignment Overlay](src/gui/assets/3d-or-2d-overlay_page.png) |
-
 ---
 
-## 💻 Command-Line Tools
+## 💻 Command-Line Tools(without GUI)
 
 ### Data Extraction Tools
 ```bash
-# Synchronized extraction from ROS2 bag
+# Synchronized extraction from ROS2 bag for 3d-3d mode
 cd src
 python3 3d_3d_data_extractor.py \ 
   --bag path-to-bag \ 
@@ -477,13 +504,13 @@ python3 3d_3d_data_extractor.py \
   --num-poses 20 \ 
   --sync-tolerance 100
 
-# Extract camera images only(it will be 3d_3d_data extractor for the 3d_3d mode)
+# Extract camera images only for 2D-3D mode
 python3 2d_3d_data_extractor.py \ 
   --bag path-to-bag \ 
   --type camera \ 
   --output ../calib_data/camera_images
 
-# Extract LiDAR point clouds only
+# Extract LiDAR point clouds only for 2D-3D mode
 python3 2d_3d_data_extractor.py \ 
   --bag path-to-bag \ 
   --type lidar \ 
@@ -527,12 +554,26 @@ python3 2d_3d_overlay.py \
   --data_root ../calib_data/multimodal_captures \ 
   --pose 1
 
-# generate/Verify corner detection
+# generate/Verify corner detection in lidar and camera
 python3 camtag_det.py \ 
   --data_root ../calib_data/multimodal_captures
 
 python3 lidtag_det.py \ 
-  --data_root ../calib_data/multimodal_captures
+--data_root ../calib_data/multimodal_captures
+```
+### To use the package camera calibrator(if you're using AprilTag Grid)
+```bash
+# After pip install calibrate-suite
+calibrate-camera --data_root /path/to/data
+
+#For PyPI Users (after adding entry point)
+pip install calibrate-suite[cv]  # Need OpenCV
+calibrate-camera --data_root ./my_data
+
+#if you already have your camera intrinsics, 
+#make sure to select them in the GUI before running any tab execution 
+#as it has hardcoded intrinsics params(though if you capture with the GUI, 
+#the system saves camera_intrinsics.yaml once, but verify path is right in GUI)
 ```
 ---
 
@@ -540,7 +581,7 @@ python3 lidtag_det.py \
 
 ### Directory Structure (Package-Created)
 
-When using calibrate-suite, the following directory structure is created(note, they can be changed as per your wish in the GUI):
+When using calibrate-suite, the following directory structure is created(note: they can be changed as per your wish in the GUI or through terminal by passing --data-root flag with folder path):
 
 ```
 calib_data/
@@ -564,6 +605,33 @@ calib_data/
 
 ```
 
+### Camera Intrinsics Format
+
+All calibrate-suite scripts use a standardized `camera_intrinsics.yaml` format. If you have your own camera intrinsics, use this exact format:
+
+```yaml
+# Standard format supported across all calibrate-suite scripts
+camera_matrix: [[fx, 0.0, cx], [0.0, fy, cy], [0.0, 0.0, 1.0]]  # 3x3 intrinsic matrix
+dist_coeffs: [k1, k2, p1, p2, k3]                                # Distortion coefficients
+image_size: [width, height]                                      # Image dimensions in pixels
+distortion_model: "plumb_bob"                                     # OpenCV distortion model
+camera_name: "camera_frame"                                       # Camera frame ID (optional)
+
+# Example with real values:
+camera_matrix: [[1364.0, 0.0, 944.66], [0.0, 1363.42, 570.16], [0.0, 0.0, 1.0]]
+dist_coeffs: [0.1, -0.2, 0.001, 0.002, 0.05]
+image_size: [1920, 1080]
+distortion_model: "plumb_bob"
+camera_name: "camera_optical_frame"
+```
+
+**Important Notes:**
+- File must be named exactly `camera_intrinsics.yaml`
+- Place in your data root directory (e.g., `calib_data/multimodal_captures/camera_intrinsics.yaml`)
+- `camera_matrix` must be a 3×3 nested list (not a flat array)
+- `dist_coeffs` must be a flat list of 5 coefficients [k1, k2, p1, p2, k3]
+- All extractors, calibrators, and visualization scripts use this format
+
 ### Board Geometry Configuration
 ```yaml
 board_type: "AprilTag"
@@ -757,5 +825,5 @@ A: Run separate calibrations for each camera+LiDAR pair. Combine results using p
 
 ## 📄 Version
 
-**Package Version:** 0.1.0   
+**Package Version:** 0.1.2   
 **License:** MIT

{calibrate_suite-0.1.0 → calibrate_suite-0.1.2}/README.md

@@ -94,46 +94,39 @@ sudo apt update
 
 ### Installation Options
 
-**Option 1: ROS2 + System Packages (Recommended for ROS users)**
+**Option 1: ROS2 + System Packages (Recommended for ROS users in development mode)**
 ```bash
 # Install system dependencies
 sudo apt install python3-opencv python3-open3d python3-pyqt5 python3-yaml
 
+# Install in development mode
+pip install -e .
+
+# Or with GUI dependencies
+pip install -e .[gui]
+
+# Or with all features
+pip install -e .[full]
+
 # Build with ROS2
 cd ~/calib_ws
 colcon build --packages-select calibrate-suite
 source install/setup.bash
-
-# Launch after installation
-calibrate-suite  # GUI
-fleet-server      # REST API
 ```
 
 **Option 2: pip - Core Only (Minimal)**
 ```bash
-pip install calibrate-suite
-```
-
-**Option 3: pip - With Computer Vision**
-```bash
-pip install calibrate-suite[cv]
+pip install calibrate-suite==0.1.0
 ```
-
-**Option 4: pip - With 3D Processing**
+**Option 3: pip - with full features**
 ```bash
-pip install calibrate-suite[3d]
+pip install calibrate-suite==0.1.0 [full]
 ```
-
-**Option 5: pip - With GUI**
-```bash
-pip install calibrate-suite[gui]
-```
-
-**Option 6: pip - Full Installation (Isolated venv recommended)**
+**Option 4: pip - Full Installation (Isolated venv recommended)**
 ```bash
 python3 -m venv calib_env
 source calib_env/bin/activate
-pip install calibrate-suite[full]
+pip install calibrate-suite==0.1.0
 
 # Launch commands after installation
 calibrate-suite  # GUI
@@ -180,6 +173,34 @@ fleet-server --version
 
 ### Known Conflicts & Solutions
 
+**Issue: RViz snap glibc conflicts**
+```
+Problem: RViz snap conflicts with system glibc (__libc_pthread_init error)
+Solution: Use system RViz instead of snap
+  sudo apt install ros-humble-rviz2
+  # OR continue without RViz (extractor still works)
+```
+
+**Issue: NumPy version conflicts**
+```
+Problem: Mixed system (1.21.5) and pip NumPy versions causing sklearn conflicts
+Solution: Use consistent package sources
+  # Remove pip scientific packages
+  pip uninstall numpy scipy scikit-learn open3d opencv-python
+  
+  # Use system packages
+  sudo apt install python3-numpy python3-scipy python3-sklearn python3-opencv python3-open3d
+  
+  # Reinstall calibrate-suite without dependencies
+  pip install -e . --no-deps
+  or 
+  # Remove pip-installed numpy and opencv
+pip uninstall numpy opencv-python
+
+# Use system packages
+sudo apt install python3-numpy python3-opencv
+```
+
 **Issue: OpenCV conflicts with system Qt/RViz**
 ```
 Problem: pip opencv-python can conflict with system OpenCV
@@ -224,19 +245,34 @@ calibrate-suite
 
 **GUI Workflow Tabs:**
 
-| Home/Record | Overlay |
+| Home |
+| ![Home Interface](src/gui/assets/GUI_homepage.png)|
+
+| Single-LiDAR Record | Calibrate |
+|---|---|
+| ![Single LiDAR Record](src/gui/assets/single_lidar_record_page.png) | ![Single LiDAR Calibrate](src/gui/assets/single_lidar_calibrate_page.png) |
+
+| 2D-3D Record page | 3D-3D Record page |
+|---|---|
+| ![2D-3D Record](src/gui/assets/2d-record-page.png) | ![3D-3D Record](src/gui/assets/3d-record-page.png) | 
+
+| 2D-3D Calibrate page | 3D-3D Calibrate page |
 |---|---|
-| ![Home Interface](src/gui/assets/GUI_homepage.png) | ![Record Page](src/gui/assets/3d-or-2d-record-page.png) |
+| ![2D-3D Calibrator](src/gui/assets/2d-calibrate-page.png) | ![3D-3D Calibrator](src/gui/assets/3d-calibrate-page.png) | 
+
+| 2D-3D Overlay page | 3D-3D Overlay page |
+|---|---|
+| ![2D-3D Calibrator](src/gui/assets/2d-overlay-page.png) | ![3D-3D Calibrator](src/gui/assets/3d-overlay-page.png) |
 
 ### Command-Line (Quick Calibration)
 ```bash
 cd /home/jamih/calib_ws/src/calibrate-suite/src
 
 #launching calibrator suite from terminal
-# Method 2: Direct Python execution
+# Method 1: Direct Python execution
 python3 -m gui.main
 
-# Method 3: Direct script execution
+# Method 2: Direct script execution
 python3 gui/main.py
 
 # 2D-3D Calibration (AprilTag-based, recommended)
@@ -258,7 +294,7 @@ python3 2d_3d_data_extractor.py \
 python3 2d_3d_calibrator.py --data_root ../calib_data/multimodal_captures
 
 # 3. Visualize results
-python3 visualize_alignment.py --data_root ../calib_data/multimodal_captures
+python3 2d_3d_overlay.py --data_root ../calib_data/multimodal_captures
 ```
 
 ---
@@ -303,11 +339,6 @@ python3 visualize_alignment.py --data_root ../calib_data/multimodal_captures
 ```
 GUI → Single LiDAR Tab → Upload PCD files → Select method → Run → View metrics
 ```
-
-| Record | Calibrate |
-|---|---|
-| ![Single LiDAR Record](src/gui/assets/single_lidar_record_page.png) | ![Single LiDAR Calibrate](src/gui/assets/single_lidar_calibrate_page.png) |
-
 ---
 
 ### Framework 2: 3D-3D Camera-LiDAR Calibration
@@ -404,17 +435,13 @@ final_extrinsic.yaml:
 GUI → 2D-3D Tab → Select data directory → Configure quality filter → Run → View metrics
 ```
 
-| GUI Interface | Alignment Visualization |
-|---|---|
-| ![2D-3D Calibration](src/gui/assets/3d_or_2d_calibrate-page.png) | ![Alignment Overlay](src/gui/assets/3d-or-2d-overlay_page.png) |
-
 ---
 
-## 💻 Command-Line Tools
+## 💻 Command-Line Tools(without GUI)
 
 ### Data Extraction Tools
 ```bash
-# Synchronized extraction from ROS2 bag
+# Synchronized extraction from ROS2 bag for 3d-3d mode
 cd src
 python3 3d_3d_data_extractor.py \ 
   --bag path-to-bag \ 
@@ -422,13 +449,13 @@ python3 3d_3d_data_extractor.py \
   --num-poses 20 \ 
   --sync-tolerance 100
 
-# Extract camera images only(it will be 3d_3d_data extractor for the 3d_3d mode)
+# Extract camera images only for 2D-3D mode
 python3 2d_3d_data_extractor.py \ 
   --bag path-to-bag \ 
   --type camera \ 
   --output ../calib_data/camera_images
 
-# Extract LiDAR point clouds only
+# Extract LiDAR point clouds only for 2D-3D mode
 python3 2d_3d_data_extractor.py \ 
   --bag path-to-bag \ 
   --type lidar \ 
@@ -472,12 +499,26 @@ python3 2d_3d_overlay.py \
   --data_root ../calib_data/multimodal_captures \ 
   --pose 1
 
-# generate/Verify corner detection
+# generate/Verify corner detection in lidar and camera
 python3 camtag_det.py \ 
   --data_root ../calib_data/multimodal_captures
 
 python3 lidtag_det.py \ 
-  --data_root ../calib_data/multimodal_captures
+--data_root ../calib_data/multimodal_captures
+```
+### To use the package camera calibrator(if you're using AprilTag Grid)
+```bash
+# After pip install calibrate-suite
+calibrate-camera --data_root /path/to/data
+
+#For PyPI Users (after adding entry point)
+pip install calibrate-suite[cv]  # Need OpenCV
+calibrate-camera --data_root ./my_data
+
+#if you already have your camera intrinsics, 
+#make sure to select them in the GUI before running any tab execution 
+#as it has hardcoded intrinsics params(though if you capture with the GUI, 
+#the system saves camera_intrinsics.yaml once, but verify path is right in GUI)
 ```
 ---
 
@@ -485,7 +526,7 @@ python3 lidtag_det.py \
 
 ### Directory Structure (Package-Created)
 
-When using calibrate-suite, the following directory structure is created(note, they can be changed as per your wish in the GUI):
+When using calibrate-suite, the following directory structure is created(note: they can be changed as per your wish in the GUI or through terminal by passing --data-root flag with folder path):
 
 ```
 calib_data/
@@ -509,6 +550,33 @@ calib_data/
 
 ```
 
+### Camera Intrinsics Format
+
+All calibrate-suite scripts use a standardized `camera_intrinsics.yaml` format. If you have your own camera intrinsics, use this exact format:
+
+```yaml
+# Standard format supported across all calibrate-suite scripts
+camera_matrix: [[fx, 0.0, cx], [0.0, fy, cy], [0.0, 0.0, 1.0]]  # 3x3 intrinsic matrix
+dist_coeffs: [k1, k2, p1, p2, k3]                                # Distortion coefficients
+image_size: [width, height]                                      # Image dimensions in pixels
+distortion_model: "plumb_bob"                                     # OpenCV distortion model
+camera_name: "camera_frame"                                       # Camera frame ID (optional)
+
+# Example with real values:
+camera_matrix: [[1364.0, 0.0, 944.66], [0.0, 1363.42, 570.16], [0.0, 0.0, 1.0]]
+dist_coeffs: [0.1, -0.2, 0.001, 0.002, 0.05]
+image_size: [1920, 1080]
+distortion_model: "plumb_bob"
+camera_name: "camera_optical_frame"
+```
+
+**Important Notes:**
+- File must be named exactly `camera_intrinsics.yaml`
+- Place in your data root directory (e.g., `calib_data/multimodal_captures/camera_intrinsics.yaml`)
+- `camera_matrix` must be a 3×3 nested list (not a flat array)
+- `dist_coeffs` must be a flat list of 5 coefficients [k1, k2, p1, p2, k3]
+- All extractors, calibrators, and visualization scripts use this format
+
 ### Board Geometry Configuration
 ```yaml
 board_type: "AprilTag"
@@ -702,5 +770,5 @@ A: Run separate calibrations for each camera+LiDAR pair. Combine results using p
 
 ## 📄 Version
 
-**Package Version:** 0.1.0   
+**Package Version:** 0.1.2   
 **License:** MIT

{calibrate_suite-0.1.0 → calibrate_suite-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "calibrate-suite"
-version = "0.1.0"
+version = "0.1.2"
 description = "Comprehensive camera-lidar calibration suite with GUI and fleet management"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -70,6 +70,7 @@ Repository = "https://github.com/Opera5/calibrate-suite.git"
 [project.scripts]
 calibrate-suite = "utils.cli_calibrate:main"
 fleet-server = "utils.cli_fleet_server:main"
+calibrate-camera = "calibrate_camera:main"
 
 [tool.setuptools.packages]
 find = {where = ["src"]}

{calibrate_suite-0.1.0 → calibrate_suite-0.1.2}/setup.py

@@ -15,7 +15,7 @@ long_description = readme_file.read_text(encoding="utf-8") if readme_file.exists
 
 setup(
     name="calibrate-suite",
-    version="0.1.0",
+    version="0.1.2",
     description="camera-lidar calibration suite with GUI and fleet management",
     long_description=long_description,
     long_description_content_type="text/markdown",
@@ -29,6 +29,7 @@ setup(
         "console_scripts": [
             "calibrate-suite=utils.cli_calibrate:main",
             "fleet-server=utils.cli_fleet_server:main",
+            "calibrate-camera=calibrate_camera:main",
         ],
     },
     package_data={

{calibrate_suite-0.1.0 → calibrate_suite-0.1.2/src/calibrate_suite.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: calibrate-suite
-Version: 0.1.0
+Version: 0.1.2
 Summary: Comprehensive camera-lidar calibration suite with GUI and fleet management
 Home-page: https://github.com/Opera5/calibrate-suite
 Author: Jamih
@@ -149,46 +149,39 @@ sudo apt update
 
 ### Installation Options
 
-**Option 1: ROS2 + System Packages (Recommended for ROS users)**
+**Option 1: ROS2 + System Packages (Recommended for ROS users in development mode)**
 ```bash
 # Install system dependencies
 sudo apt install python3-opencv python3-open3d python3-pyqt5 python3-yaml
 
+# Install in development mode
+pip install -e .
+
+# Or with GUI dependencies
+pip install -e .[gui]
+
+# Or with all features
+pip install -e .[full]
+
 # Build with ROS2
 cd ~/calib_ws
 colcon build --packages-select calibrate-suite
 source install/setup.bash
-
-# Launch after installation
-calibrate-suite  # GUI
-fleet-server      # REST API
 ```
 
 **Option 2: pip - Core Only (Minimal)**
 ```bash
-pip install calibrate-suite
-```
-
-**Option 3: pip - With Computer Vision**
-```bash
-pip install calibrate-suite[cv]
+pip install calibrate-suite==0.1.0
 ```
-
-**Option 4: pip - With 3D Processing**
+**Option 3: pip - with full features**
 ```bash
-pip install calibrate-suite[3d]
+pip install calibrate-suite==0.1.0 [full]
 ```
-
-**Option 5: pip - With GUI**
-```bash
-pip install calibrate-suite[gui]
-```
-
-**Option 6: pip - Full Installation (Isolated venv recommended)**
+**Option 4: pip - Full Installation (Isolated venv recommended)**
 ```bash
 python3 -m venv calib_env
 source calib_env/bin/activate
-pip install calibrate-suite[full]
+pip install calibrate-suite==0.1.0
 
 # Launch commands after installation
 calibrate-suite  # GUI
@@ -235,6 +228,34 @@ fleet-server --version
 
 ### Known Conflicts & Solutions
 
+**Issue: RViz snap glibc conflicts**
+```
+Problem: RViz snap conflicts with system glibc (__libc_pthread_init error)
+Solution: Use system RViz instead of snap
+  sudo apt install ros-humble-rviz2
+  # OR continue without RViz (extractor still works)
+```
+
+**Issue: NumPy version conflicts**
+```
+Problem: Mixed system (1.21.5) and pip NumPy versions causing sklearn conflicts
+Solution: Use consistent package sources
+  # Remove pip scientific packages
+  pip uninstall numpy scipy scikit-learn open3d opencv-python
+  
+  # Use system packages
+  sudo apt install python3-numpy python3-scipy python3-sklearn python3-opencv python3-open3d
+  
+  # Reinstall calibrate-suite without dependencies
+  pip install -e . --no-deps
+  or 
+  # Remove pip-installed numpy and opencv
+pip uninstall numpy opencv-python
+
+# Use system packages
+sudo apt install python3-numpy python3-opencv
+```
+
 **Issue: OpenCV conflicts with system Qt/RViz**
 ```
 Problem: pip opencv-python can conflict with system OpenCV
@@ -279,19 +300,34 @@ calibrate-suite
 
 **GUI Workflow Tabs:**
 
-| Home/Record | Overlay |
+| Home |
+| ![Home Interface](src/gui/assets/GUI_homepage.png)|
+
+| Single-LiDAR Record | Calibrate |
+|---|---|
+| ![Single LiDAR Record](src/gui/assets/single_lidar_record_page.png) | ![Single LiDAR Calibrate](src/gui/assets/single_lidar_calibrate_page.png) |
+
+| 2D-3D Record page | 3D-3D Record page |
+|---|---|
+| ![2D-3D Record](src/gui/assets/2d-record-page.png) | ![3D-3D Record](src/gui/assets/3d-record-page.png) | 
+
+| 2D-3D Calibrate page | 3D-3D Calibrate page |
 |---|---|
-| ![Home Interface](src/gui/assets/GUI_homepage.png) | ![Record Page](src/gui/assets/3d-or-2d-record-page.png) |
+| ![2D-3D Calibrator](src/gui/assets/2d-calibrate-page.png) | ![3D-3D Calibrator](src/gui/assets/3d-calibrate-page.png) | 
+
+| 2D-3D Overlay page | 3D-3D Overlay page |
+|---|---|
+| ![2D-3D Calibrator](src/gui/assets/2d-overlay-page.png) | ![3D-3D Calibrator](src/gui/assets/3d-overlay-page.png) |
 
 ### Command-Line (Quick Calibration)
 ```bash
 cd /home/jamih/calib_ws/src/calibrate-suite/src
 
 #launching calibrator suite from terminal
-# Method 2: Direct Python execution
+# Method 1: Direct Python execution
 python3 -m gui.main
 
-# Method 3: Direct script execution
+# Method 2: Direct script execution
 python3 gui/main.py
 
 # 2D-3D Calibration (AprilTag-based, recommended)
@@ -313,7 +349,7 @@ python3 2d_3d_data_extractor.py \
 python3 2d_3d_calibrator.py --data_root ../calib_data/multimodal_captures
 
 # 3. Visualize results
-python3 visualize_alignment.py --data_root ../calib_data/multimodal_captures
+python3 2d_3d_overlay.py --data_root ../calib_data/multimodal_captures
 ```
 
 ---
@@ -358,11 +394,6 @@ python3 visualize_alignment.py --data_root ../calib_data/multimodal_captures
 ```
 GUI → Single LiDAR Tab → Upload PCD files → Select method → Run → View metrics
 ```
-
-| Record | Calibrate |
-|---|---|
-| ![Single LiDAR Record](src/gui/assets/single_lidar_record_page.png) | ![Single LiDAR Calibrate](src/gui/assets/single_lidar_calibrate_page.png) |
-
 ---
 
 ### Framework 2: 3D-3D Camera-LiDAR Calibration
@@ -459,17 +490,13 @@ final_extrinsic.yaml:
 GUI → 2D-3D Tab → Select data directory → Configure quality filter → Run → View metrics
 ```
 
-| GUI Interface | Alignment Visualization |
-|---|---|
-| ![2D-3D Calibration](src/gui/assets/3d_or_2d_calibrate-page.png) | ![Alignment Overlay](src/gui/assets/3d-or-2d-overlay_page.png) |
-
 ---
 
-## 💻 Command-Line Tools
+## 💻 Command-Line Tools(without GUI)
 
 ### Data Extraction Tools
 ```bash
-# Synchronized extraction from ROS2 bag
+# Synchronized extraction from ROS2 bag for 3d-3d mode
 cd src
 python3 3d_3d_data_extractor.py \ 
   --bag path-to-bag \ 
@@ -477,13 +504,13 @@ python3 3d_3d_data_extractor.py \
   --num-poses 20 \ 
   --sync-tolerance 100
 
-# Extract camera images only(it will be 3d_3d_data extractor for the 3d_3d mode)
+# Extract camera images only for 2D-3D mode
 python3 2d_3d_data_extractor.py \ 
   --bag path-to-bag \ 
   --type camera \ 
   --output ../calib_data/camera_images
 
-# Extract LiDAR point clouds only
+# Extract LiDAR point clouds only for 2D-3D mode
 python3 2d_3d_data_extractor.py \ 
   --bag path-to-bag \ 
   --type lidar \ 
@@ -527,12 +554,26 @@ python3 2d_3d_overlay.py \
   --data_root ../calib_data/multimodal_captures \ 
   --pose 1
 
-# generate/Verify corner detection
+# generate/Verify corner detection in lidar and camera
 python3 camtag_det.py \ 
   --data_root ../calib_data/multimodal_captures
 
 python3 lidtag_det.py \ 
-  --data_root ../calib_data/multimodal_captures
+--data_root ../calib_data/multimodal_captures
+```
+### To use the package camera calibrator(if you're using AprilTag Grid)
+```bash
+# After pip install calibrate-suite
+calibrate-camera --data_root /path/to/data
+
+#For PyPI Users (after adding entry point)
+pip install calibrate-suite[cv]  # Need OpenCV
+calibrate-camera --data_root ./my_data
+
+#if you already have your camera intrinsics, 
+#make sure to select them in the GUI before running any tab execution 
+#as it has hardcoded intrinsics params(though if you capture with the GUI, 
+#the system saves camera_intrinsics.yaml once, but verify path is right in GUI)
 ```
 ---
 
@@ -540,7 +581,7 @@ python3 lidtag_det.py \
 
 ### Directory Structure (Package-Created)
 
-When using calibrate-suite, the following directory structure is created(note, they can be changed as per your wish in the GUI):
+When using calibrate-suite, the following directory structure is created(note: they can be changed as per your wish in the GUI or through terminal by passing --data-root flag with folder path):
 
 ```
 calib_data/
@@ -564,6 +605,33 @@ calib_data/
 
 ```
 
+### Camera Intrinsics Format
+
+All calibrate-suite scripts use a standardized `camera_intrinsics.yaml` format. If you have your own camera intrinsics, use this exact format:
+
+```yaml
+# Standard format supported across all calibrate-suite scripts
+camera_matrix: [[fx, 0.0, cx], [0.0, fy, cy], [0.0, 0.0, 1.0]]  # 3x3 intrinsic matrix
+dist_coeffs: [k1, k2, p1, p2, k3]                                # Distortion coefficients
+image_size: [width, height]                                      # Image dimensions in pixels
+distortion_model: "plumb_bob"                                     # OpenCV distortion model
+camera_name: "camera_frame"                                       # Camera frame ID (optional)
+
+# Example with real values:
+camera_matrix: [[1364.0, 0.0, 944.66], [0.0, 1363.42, 570.16], [0.0, 0.0, 1.0]]
+dist_coeffs: [0.1, -0.2, 0.001, 0.002, 0.05]
+image_size: [1920, 1080]
+distortion_model: "plumb_bob"
+camera_name: "camera_optical_frame"
+```
+
+**Important Notes:**
+- File must be named exactly `camera_intrinsics.yaml`
+- Place in your data root directory (e.g., `calib_data/multimodal_captures/camera_intrinsics.yaml`)
+- `camera_matrix` must be a 3×3 nested list (not a flat array)
+- `dist_coeffs` must be a flat list of 5 coefficients [k1, k2, p1, p2, k3]
+- All extractors, calibrators, and visualization scripts use this format
+
 ### Board Geometry Configuration
 ```yaml
 board_type: "AprilTag"
@@ -757,5 +825,5 @@ A: Run separate calibrations for each camera+LiDAR pair. Combine results using p
 
 ## 📄 Version
 
-**Package Version:** 0.1.0   
+**Package Version:** 0.1.2   
 **License:** MIT

{calibrate_suite-0.1.0 → calibrate_suite-0.1.2}/src/calibrate_suite.egg-info/SOURCES.txt

@@ -19,12 +19,15 @@ src/fleet_server/templates/index.html
 src/fleet_server/templates/viewer.html
 src/gui/__init__.py
 src/gui/main.py
+src/gui/assets/2d-calibrate-page.png
 src/gui/assets/2d-or-3d-fleet-upload.png
+src/gui/assets/2d-overlay-page.png
+src/gui/assets/2d-record-page.png
 src/gui/assets/2d_3d_overlay_output.jpg
-src/gui/assets/3d-or-2d-overlay_page.png
-src/gui/assets/3d-or-2d-record-page.png
+src/gui/assets/3d-calibrate-page.png
+src/gui/assets/3d-overlay-page.png
+src/gui/assets/3d-record-page.png
 src/gui/assets/3d_3d_overlay_output.png
-src/gui/assets/3d_or_2d_calibrate-page.png
 src/gui/assets/GUI_homepage.png
 src/gui/assets/hardware_setup.jpeg
 src/gui/assets/single_lidar_calibrate_page.png

{calibrate_suite-0.1.0 → calibrate_suite-0.1.2}/src/calibrate_suite.egg-info/entry_points.txt

@@ -1,3 +1,4 @@
 [console_scripts]
+calibrate-camera = calibrate_camera:main
 calibrate-suite = utils.cli_calibrate:main
 fleet-server = utils.cli_fleet_server:main

{calibrate_suite-0.1.0 → calibrate_suite-0.1.2}/src/gui/widgets/extractor_widget.py

@@ -506,10 +506,21 @@ class ExtractorWidget(QWidget):
 
     def stop_process(self):
         if self.record_process and self.record_process.state() == QProcess.Running:
+            self.rec_log.append("🛑 Stopping process and closing RViz...")
             self.record_process.write(b'q\n')
-            self.record_process.waitForFinished(1000)
+            self.record_process.waitForFinished(3000)  # Wait longer for graceful shutdown
             if self.record_process.state() == QProcess.Running:
+                self.rec_log.append("⚠️ Force killing process...")
                 self.record_process.kill()
+                self.record_process.waitForFinished(1000)
+        
+        # Force kill any remaining RViz processes
+        try:
+            import subprocess
+            subprocess.run(['pkill', '-f', 'rviz2'], capture_output=True)
+            self.rec_log.append("🔧 Cleaned up RViz processes")
+        except Exception as e:
+            self.rec_log.append(f"⚠️ RViz cleanup warning: {e}")
 
     def capture_frame(self):
         if self.record_process: self.record_process.write(b'n\n')

{calibrate_suite-0.1.0 → calibrate_suite-0.1.2}/src/rviz_configs/3D-3D.rviz

@@ -63,7 +63,7 @@ Visualization Manager:
       Enabled: true
       Invert Rainbow: false
       Max Color: 255; 255; 255
-      Max Intensity: 217
+      Max Intensity: 206
       Min Color: 0; 0; 0
       Min Intensity: 0
       Name: PointCloud2
@@ -180,5 +180,5 @@ Window Geometry:
   Views:
     collapsed: false
   Width: 1200
-  X: 720
-  Y: 79
+  X: 555
+  Y: 101