{"id":30770665,"url":"https://github.com/cpscript/dk2-positional-calibrator","last_synced_at":"2025-09-04T23:12:09.147Z","repository":{"id":310323155,"uuid":"1039454025","full_name":"CPScript/DK2-Positional-Calibrator","owner":"CPScript","description":"Oculus DK2 Positional Tracking Calibration Tool","archived":false,"fork":false,"pushed_at":"2025-08-17T09:19:57.000Z","size":11,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-30T05:57:43.740Z","etag":null,"topics":["oculus","oculus-rift","ovr","python","vr"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CPScript.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-17T09:09:42.000Z","updated_at":"2025-08-28T00:42:12.000Z","dependencies_parsed_at":"2025-08-17T11:36:59.297Z","dependency_job_id":null,"html_url":"https://github.com/CPScript/DK2-Positional-Calibrator","commit_stats":null,"previous_names":["cpscript/dk2-positonal-calibrator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/CPScript/DK2-Positional-Calibrator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CPScript%2FDK2-Positional-Calibrator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CPScript%2FDK2-Positional-Calibrator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CPScript%2FDK2-Positional-Calibrator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CPScript%2FDK2-Positional-Calibrator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CPScript","download_url":"https://codeload.github.com/CPScript/DK2-Positional-Calibrator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CPScript%2FDK2-Positional-Calibrator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273685604,"owners_count":25149722,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-04T02:00:08.968Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["oculus","oculus-rift","ovr","python","vr"],"created_at":"2025-09-04T23:12:05.812Z","updated_at":"2025-09-04T23:12:09.131Z","avatar_url":"https://github.com/CPScript.png","language":"Python","readme":"# DK2 Positional Tracking Calibration Tool\n\nA Python utility for testing and calibrating Oculus Rift DK2 positional tracking accuracy. (Even though it's outdated)\n\n## Features\n\n### 🎯 Real-time Monitoring\n- Live tracking status display\n- Position and rotation values in real-time\n- Frame rate monitoring\n- Connection status indicators\n\n### 📊 3D Visualization\n- Interactive pygame-based 3D visualization\n- Real-time head position tracking\n- Movement trail history\n- Tracking boundary visualization\n- Coordinate system display\n\n### 🔧 Calibration System\n- Interactive multi-point calibration process\n- Progress tracking and visual feedback\n- Save/load calibration configurations\n- One-click tracking center reset\n\n### 📈 Analysis Tools\n- Position accuracy metrics\n- Jitter measurement (RMS)\n- Drift rate calculation\n- Comprehensive tracking reports\n- CSV data export for external analysis\n\n### ⚙️ Settings Management\n- Adjustable tracking bounds (X, Y, Z limits)\n- Configurable parameters\n- Settings persistence\n\n## Installation\n\n### Prerequisites\n- Python 3.7 or higher\n- Windows (for Oculus SDK support)\n\n### Required Python Packages\n```bash\npip install pygame numpy\n```\n\n### For Hardware Support (Optional)\nTo use with an actual DK2 headset:\n1. Install the [Oculus SDK](https://developer.oculus.com/downloads/package/oculus-sdk-for-windows/)\n2. Install Python OVR bindings:\n```bash\npip install ovr\n```\n\n**Note:** The tool works in simulation mode without hardware, perfect for testing and development.\n\n## Usage\n\n### Quick Start\n1. Clone the repository:\n```bash\ngit clone https://github.com/CPScript/DK2-Positonal-Calibrator.git\ncd DK2-Positonal-Calibrator\n```\n\n2. Run the tool:\n```bash\npython main.py.py\n```\n\n### Basic Workflow\n1. **Start Tracking**: Click \"Start Tracking\" in the Real-time Monitor tab\n2. **View Visualization**: The pygame window shows live 3D tracking data\n3. **Calibrate**: Use the Calibration tab to run accuracy tests\n4. **Analyze**: Check the Analysis tab for performance metrics\n5. **Export**: Save tracking data and reports for further analysis\n\n### Interface Overview\n\n#### Real-time Monitor Tab\n- **Status Indicators**: Connection, tracking status, and frame rate\n- **Live Data**: Current position (X, Y, Z) and rotation values\n- **Controls**: Start/stop tracking, reset center position\n\n#### Calibration Tab\n- **Interactive Calibration**: Step-by-step calibration process\n- **Progress Tracking**: Visual progress bar and status updates\n- **Data Management**: Save and load calibration profiles\n\n#### Analysis Tab\n- **Accuracy Metrics**: Position accuracy, rotation accuracy, jitter, drift\n- **Data Export**: Export tracking data to CSV format\n- **Report Generation**: Generate comprehensive tracking reports\n\n#### Settings Tab\n- **Tracking Bounds**: Configure X, Y, Z tracking limits\n- **Parameter Adjustment**: Fine-tune tracking parameters\n\n## Hardware Requirements\n\n### Minimum Requirements\n- **CPU**: Intel Core i5-4590 / AMD FX 8350 equivalent or better\n- **Memory**: 4 GB RAM\n- **Graphics**: NVIDIA GTX 970 / AMD R9 280 equivalent or better\n- **USB**: USB 3.0 port\n- **OS**: Windows 7 SP1 64-bit or newer\n\n### Recommended Setup\n- Oculus Rift DK2 headset\n- Proper lighting conditions (avoid direct sunlight)\n- Clear tracking area (2m x 1.5m minimum)\n- Stable mounting for the tracking camera\n\n## Configuration\n\nThe tool saves configuration data in JSON format:\n\n```json\n{\n  \"tracking_bounds\": {\n    \"x_min\": -2.0,\n    \"x_max\": 2.0,\n    \"y_min\": -1.5,\n    \"y_max\": 1.5,\n    \"z_min\": 0.5,\n    \"z_max\": 3.0\n  },\n  \"calibration_points\": [...],\n  \"timestamp\": \"2025-01-01T12:00:00\"\n}\n```\n\n## Troubleshooting\n\n### Common Issues\n\n**\"OVR SDK not found\" Warning**\n- This is normal if you don't have a DK2 connected\n- The tool will run in simulation mode for testing\n\n**Tracking Data Shows Zeros**\n- Check USB 3.0 connection\n- Ensure proper lighting conditions\n- Verify DK2 camera is connected and recognized\n\n**Poor Tracking Accuracy**\n- Run the calibration process\n- Check for reflective surfaces in the tracking area\n- Ensure the camera has a clear view of the headset\n\n**Performance Issues**\n- Close unnecessary applications\n- Check system requirements\n- Reduce visualization quality in settings\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcpscript%2Fdk2-positional-calibrator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcpscript%2Fdk2-positional-calibrator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcpscript%2Fdk2-positional-calibrator/lists"}