{"id":27306885,"url":"https://github.com/kekeblom/strayvisualizer","last_synced_at":"2025-04-12T04:02:43.752Z","repository":{"id":46003633,"uuid":"347428708","full_name":"kekeblom/StrayVisualizer","owner":"kekeblom","description":"Visualize Data From Stray Scanner https://keke.dev/blog/2021/03/10/Stray-Scanner.html","archived":false,"fork":false,"pushed_at":"2023-01-04T09:52:13.000Z","size":32,"stargazers_count":49,"open_issues_count":1,"forks_count":11,"subscribers_count":7,"default_branch":"main","last_synced_at":"2023-04-06T10:26:09.286Z","etag":null,"topics":["3d-reconstruction","camera","computer-vision","dataset","depth-maps","mapping","open3d","pointclouds","python","reconstruction","rgb-d","slam"],"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/kekeblom.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}},"created_at":"2021-03-13T17:02:48.000Z","updated_at":"2023-04-06T08:56:44.000Z","dependencies_parsed_at":"2023-02-02T07:46:25.359Z","dependency_job_id":null,"html_url":"https://github.com/kekeblom/StrayVisualizer","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kekeblom%2FStrayVisualizer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kekeblom%2FStrayVisualizer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kekeblom%2FStrayVisualizer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kekeblom%2FStrayVisualizer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kekeblom","download_url":"https://codeload.github.com/kekeblom/StrayVisualizer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248514226,"owners_count":21116902,"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","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":["3d-reconstruction","camera","computer-vision","dataset","depth-maps","mapping","open3d","pointclouds","python","reconstruction","rgb-d","slam"],"created_at":"2025-04-12T04:01:16.053Z","updated_at":"2025-04-12T04:02:43.721Z","avatar_url":"https://github.com/kekeblom.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# StrayVisualizer\n\nA set of scripts to work with data collected using [Stray Scanner](https://apps.apple.com/us/app/stray-scanner/id1557051662).\n\n![Staircase pointcloud](images/pointcloud.webp)\n\n## Usage\n\nTo access the data from your device, see [this wiki entry](https://github.com/kekeblom/StrayVisualizer/wiki/Accessing-Data).\n\n### Installing Dependencies\n\nInstall dependencies with `pip -r requirements.txt`.\n\n### Example Datasets\n\nIf you don't have your own dataset, you can download one of these example datasets:\n```\nwget https://stray-data.nyc3.digitaloceanspaces.com/datasets/dinosaur.tar.gz\ntar -xvf dinosaur.tar.gz\npython stray_visualize.py dinosaur/\n```\n\n## Visualizing the data\n\nRun `python stray_visualize.py \u003cpath-to-dataset\u003e`.\n\nAvailable command line options are:\n- `--point-clouds` shows pointclouds.\n- `--confidence=\u003cvalue\u003e` there are three levels of confidence for the depth outputs: 0, 1 and 2. Higher is more confident. Only points having confidence higher or equal to the given value are shown.\n- `--frames` shows the camera pose coordinate frames.\n- `--every=\u003cn\u003e` determines how often the coordinate frame is drawn. Default is to draw every 60th frame.\n- `--trajectory` shows a black line for the trajectory of the camera.\n- `--integrate` will run the data through the Open3D RGB-D integration pipeline and visualize the resulting mesh.\n- `--voxel-size=\u003csize\u003e` sets the voxel size in meters for RGB-D integration.\n- `--mesh-filename` save the mesh from RGB-D integration into the given file. Defaults to no mesh saved.\n\n## Creating a Video From the Depth Maps\n\n`python make_video.py \u003cdataset-path\u003e` will combine depth maps into a video. It will create a file `depth_video.mp4` inside the dataset folder.\n\n## Converting to a ROS bag\n\n`python create_rosbag.py \u003cscan_folder\u003e --out ros.bag` will create a rosbag from your scene. This has to be done with your ROS distribution sourced, as it requires some ros packages, such as `sensor_msgs`, `cv_bridge` and `rosbag`.\n\n## Reporting Issues\n\nIf you find any issues with this project or bugs in the Stray Scanner app, you can open an issue on this repository.\n\n\n## Related Projects\n\n[PyojinKim](https://github.com/PyojinKim) created a set of [helpful scripts](https://github.com/PyojinKim/StrayScannerVisualizer) to work with data collected with the App in Matlab.\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkekeblom%2Fstrayvisualizer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkekeblom%2Fstrayvisualizer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkekeblom%2Fstrayvisualizer/lists"}