Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/potree/potree

WebGL point cloud viewer for large datasets
https://github.com/potree/potree

Last synced: 4 days ago
JSON representation

WebGL point cloud viewer for large datasets

Awesome Lists containing this project

README 

        



# About



* Potree is a free open-source WebGL based point cloud renderer for large point clouds. It is based on the [TU Wien Scanopy project](https://www.cg.tuwien.ac.at/research/projects/Scanopy/) and research projects [Harvest4D](https://harvest4d.org/), [GCD Doctoral College](https://gcd.tuwien.ac.at/) and [Superhumans](https://www.cg.tuwien.ac.at/research/projects/Superhumans/).

* Newest information and work in progress is usually available on [twitter](https://twitter.com/m_schuetz)

* Contact: Markus Schütz ([email protected])

* References: 

    * [Potree: Rendering Large Point Clouds in Web Browsers](https://www.cg.tuwien.ac.at/research/publications/2016/SCHUETZ-2016-POT/SCHUETZ-2016-POT-thesis.pdf) (2016)

    * [Fast Out-of-Core Octree Generation for Massive Point Clouds](https://www.cg.tuwien.ac.at/research/publications/2020/SCHUETZ-2020-MPC/) (2020)

    

 ![](./docs/images/potree_screens.png) 



# Getting Started



### Install on your PC



Install [node.js](http://nodejs.org/)



Install dependencies, as specified in package.json, and create a build in ./build/potree.



```bash

npm install

```



### Run on your PC



Use the `npm start` command to 



* create ./build/potree 

* watch for changes to the source code and automatically create a new build on change

* start a web server at localhost:1234. 



Go to http://localhost:1234/examples/ to test the examples.



### Deploy to a server



* Simply upload the Potree folderm with all your point clouds, the build directory, and your html files to a web server.

* It is not required to install node.js on your webserver. All you need is to host your files online. 



### Convert Point Clouds to Potree Format



Download [PotreeConverter](https://github.com/potree/PotreeConverter) and run it like this:



    ./PotreeConverter.exe C:/pointclouds/data.las -o C:/pointclouds/data_converted



Copy the converted directory into <potreeDirectory>/pointclouds/data_converted. Then, duplicate and rename one of the examples and modify the path in the html file to your own point cloud.



# Downloads



* [Potree](https://github.com/potree/potree/releases)

* [PotreeConverter ](https://github.com/potree/PotreeConverter/releases) - Convert your point cloud to the Potree format.

* [PotreeDesktop ](https://github.com/potree/PotreeDesktop/releases) - Desktop version of Potree. Allows drag&drop of point clouds into the viewer.



# Examples



	

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

	

	

		Basic ViewerCA13 (18 billion Points)Retz (Potree + Cesium)ClassificationsVarious FeaturesToolbar

	



More Examples



	

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

	

	

		Load ProjectMatcapVirtual RealityHeidentorLionLion LAS

	

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

	

	

		Lion LAZEPTEPT BinaryEPT zstandardClipping VolumeOriented Images

	

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

	

	

		Elevation ProfileMeasurementsMeshesMultiple Point CloudsCamera AnimationFeatures (CA13)

	

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

	

	

		AnnotationsHierarchical AnnotationsAnimation PathShapefilesCesium CA13Geopackage

	

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

	

	

		Cesium SorvilierCustom Sidebar SectionEmbedded IframeGradient Colors

	



# VR



	

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

	

	

		HeidentorEclepensMorro BayLionDechen Cave

	



# Showcase



	

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

	

	

		MatterhornRetzLake TahoeSorvilierGraveChowilla

	



More



	

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

	

	

		ChillerCoolerDechen CaveRuinsEclepensHeidentor

	

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

	

	

		BuildingLDHILion HeadOverpassPielachpompei

	

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

			

				

			

		

	

	

		SantoriniSkateparkSubsea Eq.Subsea Man.Westend PalaisWhitby

	



# Funding



Potree is funded by a combination of research projects, companies and institutions. 



Research projects who's funding contributes to Potree:



	

		Project Name

		Funding Agency

	

	

		LargeClouds2BIM

		FFG

	

	

		Harvest4D

		EU 7th Framework Program 323567

	

	

		GCD Doctoral College

		TU Wien

	

	

		Superhumans

		FWF

	



We would like to thank our sponsors for their financial contributions that keep this project up and running!



	

		

			Diamond


			€ 15,000+

		

		

			

				  

			  

			

				

			  

			

				

			  

			

				

			  

		

	

	

		

			Gold


			€ 10,000+

		

		

			

				

			

		

	

	

		

			Silver


			€ 5,000+

		

		

			

				  

			

			

				  

			

			

				

			

			

				

			

		

	

	

		

			Bronze


			€ 1,000+

		

		

			

				  

			

			

				  

			

			

				  

			

			

				  

			

			

				  

			

			

				  

			

			

				  

			

			

				  

			

			Data-viewer

			

				  

			

			

				  

			

			

				  

			

			

				 

			  

			


			

				  

			

			

				  

			

			

				  

			

		

	



# Credits



* The multi-res-octree algorithms used by this viewer were developed at the Vienna University of Technology by Michael Wimmer and Claus Scheiblauer as part of the [Scanopy Project](http://www.cg.tuwien.ac.at/research/projects/Scanopy/).

* [Three.js](https://github.com/mrdoob/three.js), the WebGL 3D rendering library on which potree is built.

* [plas.io](http://plas.io/) point cloud viewer. LAS and LAZ support have been taken from the laslaz.js implementation of plas.io. Thanks to [Uday Verma](https://twitter.com/udaykverma) and [Howard Butler](https://twitter.com/howardbutler) for this!

* [Harvest4D](https://harvest4d.org/) Potree currently runs as Master Thesis under the Harvest4D Project

* Christian Boucheny (EDL developer) and Daniel Girardeau-Montaut ([CloudCompare](http://www.danielgm.net/cc/)). The EDL shader was adapted from the CloudCompare source code!

* [Martin Isenburg](http://rapidlasso.com/), [Georepublic](http://georepublic.de/en/),

[Veesus](http://veesus.com/), [Sigeom Sa](http://www.sigeom.ch/), [SITN](http://www.ne.ch/sitn), [LBI ArchPro](http://archpro.lbg.ac.at/),  [Pix4D](http://pix4d.com/) as well as all the contributers to potree and PotreeConverter and many more for their support.



# Bibtex 



```

@article{SCHUETZ-2020-MPC,

	title =      "Fast Out-of-Core Octree Generation for Massive Point Clouds",

	author =     "Markus Schütz and Stefan Ohrhallinger and Michael Wimmer",

	year =       "2020",

	month =      nov,

	journal =    "Computer Graphics Forum",

	volume =     "39",

	number =     "7",

	doi =        "10.1111/cgf.14134",

	pages =      "13",

	publisher =  "John Wiley & Sons, Inc.",

	pages =      "1--13",

	keywords =   "point clouds, point-based rendering, level of detail",

}

```