{"id":13423582,"url":"https://github.com/heremaps/pptk","last_synced_at":"2025-04-05T04:12:18.640Z","repository":{"id":41100317,"uuid":"140545769","full_name":"heremaps/pptk","owner":"heremaps","description":"The Point Processing Toolkit (pptk) is a Python package for visualizing and processing 2-d/3-d point clouds.","archived":false,"fork":false,"pushed_at":"2020-09-17T19:34:33.000Z","size":8906,"stargazers_count":624,"open_issues_count":59,"forks_count":113,"subscribers_count":21,"default_branch":"master","last_synced_at":"2025-03-29T03:07:49.942Z","etag":null,"topics":["3-d","gps-data","graphics-3d","kd-tree","lidar","octree","pointclouds","visualization"],"latest_commit_sha":null,"homepage":"https://heremaps.github.io/pptk","language":"C++","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/heremaps.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":"2018-07-11T08:33:04.000Z","updated_at":"2025-03-05T15:33:19.000Z","dependencies_parsed_at":"2022-07-09T19:16:23.283Z","dependency_job_id":null,"html_url":"https://github.com/heremaps/pptk","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fpptk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fpptk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fpptk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fpptk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/heremaps","download_url":"https://codeload.github.com/heremaps/pptk/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247284951,"owners_count":20913704,"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":["3-d","gps-data","graphics-3d","kd-tree","lidar","octree","pointclouds","visualization"],"created_at":"2024-07-31T00:00:38.142Z","updated_at":"2025-04-05T04:12:18.623Z","avatar_url":"https://github.com/heremaps.png","language":"C++","funding_links":[],"categories":["C++","Sensor Processing","Not in PyViz","Python tools"],"sub_categories":["Lidar and Point Cloud Processing","Point Cloud Processing","Misc"],"readme":"# pptk - Point Processing Toolkit\n\nCopyright (C) 2011-2018 HERE Europe B.V.\n\nThe Point Processing Toolkit (pptk) is a Python package for visualizing and processing 2-d/3-d point clouds.\n\nAt present, pptk consists of the following features.\n\n* A 3-d point cloud viewer that\n  - accepts any 3-column numpy array as input,\n  - renders tens of millions of points interactively using an octree-based level of detail mechanism,\n  - supports point selection for inspecting and annotating point data.\n* A fully parallelized point k-d tree that supports k-nearest neighbor queries and r-near range queries\n  (both build and queries have been parallelized).\n* A normal estimation routine based on principal component analysis of point cloud neighborhoods.\n\n[Homepage](https://heremaps.github.io/pptk/index.html)\n\n![pptk screenshots](/docs/source/tutorials/viewer/images/tutorial_banner.png)\n\nThe screenshots above show various point datasets visualized using pptk.\nThe `bildstein1` Lidar point cloud from Semantic3D (left),\nBeijing GPS trajectories from Geolife (middle left),\n`DistrictofColumbia.geojson` 2-d polygons from US building footprints (middle right),\nand a Mobius strip (right).\nFor details, see the [tutorials](https://heremaps.github.io/pptk/tutorial.html).\n\n## License\n\nUnless otherwise noted in `LICENSE` files for specific files or directories,\nthe [LICENSE](LICENSE) in the root applies to all content in this repository.\n\n## Install\n\nOne can either install pptk directly from PyPI\n\n```\n\u003e\u003e pip install pptk\n```\n\nor from the .whl file that results from [building pptk from source](#build).\n\n```\n\u003e\u003e pip install \u003c.whl file\u003e\n```\n\n## Quickstart\n\nIn Python, generate 100 random 3-d points.\n\n```\n\u003e\u003e import numpy as np\n\u003e\u003e x = np.random.rand(100, 3)\n```\n\nVisualize.\n\n```\n\u003e\u003e import pptk\n\u003e\u003e v = pptk.viewer(x)\n```\n\nSet point size to 0.01.\n\n```\n\u003e\u003e v.set(point_size=0.01)\n```\n\nFor more advanced examples, see [tutorials](https://heremaps.github.io/pptk/tutorial.html).\n\n## Build\n\nWe provide CMake scripts for automating most of the build process, but ask the\nuser to manually prepare [dependencies](#requirements) and record their paths\nin the following CMake cache variables.\n\n* `Numpy_INCLUDE_DIR`\n* `PYTHON_INCLUDE_DIR`\n* `PYTHON_LIBRARY`\n* `Eigen_INCLUDE_DIR`\n* `TBB_INCLUDE_DIR`\n* `TBB_tbb_LIBRARY`\n* `TBB_tbb_RUNTIME`\n* `TBB_tbbmalloc_LIBRARY`\n* `TBB_tbbmalloc_RUNTIME`\n* `Qt5_DIR`\n\nTo set these variables, either use one of CMake's GUIs (ccmake or cmake-gui),\nor provide an initial CMakeCache.txt in the target build folder\n(for examples of initial cache files, see the CMakeCache.\u003cplatform\u003e.txt files)\n\n##### Requirements\n\nListed are versions of libraries used to develop pptk, though earlier versions\nof these libraries may also work.\n\n* [QT](https://www.qt.io/) 5.4\n* [TBB](https://www.threadingbuildingblocks.org/) 4.3\n* [Eigen](http://eigen.tuxfamily.org) 3.2.9\n* [Python](https://www.python.org/) 2.7+ or 3.6+\n* [Numpy](http://www.numpy.org/) 1.13\n\n##### Windows\n\n1. Create an empty build folder\n\n```\n\u003e\u003e mkdir \u003cbuild_folder\u003e\n```\n\n2. Create an initial CMakeCache.txt under \u003cbuild_folder\u003e and use it to provide\nvalues for the CMake cache variables listed above. (e.g. see CMakeCache.win.txt)\n\n3. Type the following...\n\n```\n\u003e\u003e cd \u003cbuild_folder\u003e\n\u003e\u003e cmake -G \"NMake Makefiles\" \u003csource_folder\u003e\n\u003e\u003e nmake\n\u003e\u003e python setup.py bdist_wheel\n\u003e\u003e pip install dist\\\u003c.whl file\u003e\n```\n\n##### Linux\n\nSimilar to building on Windows.\n\n##### Mac\n\nSimilar to building on Windows.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheremaps%2Fpptk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fheremaps%2Fpptk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheremaps%2Fpptk/lists"}