{"id":21854791,"url":"https://github.com/nandite/pcl-optics","last_synced_at":"2025-04-14T18:06:06.905Z","repository":{"id":43921859,"uuid":"245610156","full_name":"Nandite/Pcl-Optics","owner":"Nandite","description":"C++ Implementation of the OPTICS algorithm compatible with the Point Cloud Library. ","archived":false,"fork":false,"pushed_at":"2022-11-16T22:28:25.000Z","size":4524,"stargazers_count":8,"open_issues_count":1,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-01-14T14:35:34.996Z","etag":null,"topics":["c-plus-plus","clustering","clustering-algorithm","cpp","density-classification","optics","pcl","pcl-library","point-cloud"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Nandite.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":"2020-03-07T10:13:52.000Z","updated_at":"2023-08-30T17:19:29.000Z","dependencies_parsed_at":"2023-01-22T16:30:17.771Z","dependency_job_id":null,"html_url":"https://github.com/Nandite/Pcl-Optics","commit_stats":null,"previous_names":[],"tags_count":0,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nandite%2FPcl-Optics","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nandite%2FPcl-Optics/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nandite%2FPcl-Optics/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nandite%2FPcl-Optics/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Nandite","download_url":"https://codeload.github.com/Nandite/Pcl-Optics/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226846700,"owners_count":17691353,"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":["c-plus-plus","clustering","clustering-algorithm","cpp","density-classification","optics","pcl","pcl-library","point-cloud"],"created_at":"2024-11-28T02:11:19.567Z","updated_at":"2024-11-28T02:11:20.136Z","avatar_url":"https://github.com/Nandite.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"Pcl-Optics\n===============\n\n[![][license-image]][license]\n![][platform-image]\n\n[license-image]: https://img.shields.io/badge/license-MIT-green.svg?style=flat-square\n[license]: https://github.com/Nandite/PclWalkerViewer/blob/master/LICENSE\n\n[platform-image]: https://img.shields.io/badge/platorms-linux64%20%7C%20osx%20%7C%20windows-lightgrey?style=flat-square\n\nOPTICS is an algorithm for finding density-based clusters in spatial data. It was presented by Mihael Ankerst, \nMarkus M. Breunig, Hans-Peter Kriegel and Jörg Sander in 1999.\n\nThe goal of this repository is to provide a C++ implementation of the algorithm compatible with the \ncloud and points of the Point Cloud Library ([PCL](http://www.pointclouds.org/)) project, without any further \ndependencies than those required by the PCL. The metric used by the algorithm to estimate density is the euclidean\ndistance in a 3D space. This work is derived from the implementation made by \n[Ingo Proff](https://github.com/CrikeeIP/OPTICS-Clustering).\n\n## Usage\n\n```cpp\n#include \"Optics.hpp\"\n\npcl::PointCloud\u003cpcl::PointXYZ\u003e::Ptr cloud(new pcl::PointCloud\u003cpcl::PointXYZ\u003e);\n\n// \n// Adding data to the cloud of points ...\n//\n\nstd::vector\u003cpcl::PointIndicesPtr\u003e clusters;\nOptics::optics\u003cpcl::PointXYZ\u003e(cloud, neighborhoodMinPts, reachabilityThreshold, clusters);\n\nfor (const auto\u0026 cluster : clusters) {\n    if (cluster-\u003eindices.size() \u003c minPtsPerCluster) continue;\n    \n    // Do something with the cluster\n}\n```\n\nYou can compile and execute the example program provided:\n\n```sh\nmkdir build \u0026\u0026 cd build\ncmake -DCMAKE_BUILD_TYPE=Release ..\nmake\n./Pcl_Optics ../table_scene_lms400.pcd\n```\n\nYou should get the following output into the pcl visualizer:\n\n![libjson-rpc-cpp logo](resources/clusters-example.png)\n\nEach color represents a different density cluster. \n\n## Dependencies\n\nThe only dependencies required is the [Point Cloud Libary](http://www.pointclouds.org/).\nTests have been performed with [pcl-1.8.1](https://github.com/PointCloudLibrary/pcl/releases/tag/pcl-1.8.1),\n[pcl-1.9.0](https://github.com/PointCloudLibrary/pcl/releases/tag/pcl-1.9.0) \nand [pcl-1.9.1](https://github.com/PointCloudLibrary/pcl/releases/tag/pcl-1.9.1) and using C++11, C++14 and C++17.\n\n\n## Installation\n\nThe implementation resides in a single header file making it easy to integrate into a c++ project.\nJust clone the repository\n```sh\ngit clone https://github.com/Nandite/Pcl-Optics\n```\nThen copy the [Optics](include/Optics.hpp) header file located into the include directory in your project.\n\n## Documentation\n\nYou will find into the [resources](resources) directory a publication from [Mihael Ankerst, Markus M. Breunig,\nHans-Peter Kriegel and Jörg Sander](resources/OPTICS.pdf) succinctly explaining the OPTICS algorithm.\n\nThere is also an excellent paper from [Izabela Anna Wowczko](https://www.academia.edu/8142139/Density_Based_Clustering_with_DBSCAN_and_OPTICS_-_Literature_Review)\nof the Institute of Technology Blanchardstown explaining the principle of the algorithm.\n\n## Feedback\n\nDon't hesitate if you have any suggestions for improving this project, or if you find any error. I will be glad to\nhear from you. Contributions are welcomed :)\n\n## License\n\nDistributed under the MIT Software License (X11 license).\nSee accompanying file LICENSE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnandite%2Fpcl-optics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnandite%2Fpcl-optics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnandite%2Fpcl-optics/lists"}