potree / potree.github.io

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 and research projects Harvest4D, GCD Doctoral College and Superhumans.
• Newest information and work in progress is usually available on twitter
• Contact: Markus Schütz ([email protected])
• References:
  • Potree: Rendering Large Point Clouds in Web Browsers (2016)
  • Fast Out-of-Core Octree Generation for Massive Point Clouds (2020)

Getting Started

Install on your PC

Install node.js

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

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 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
• PotreeConverter - Convert your point cloud to the Potree format.
• PotreeDesktop - Desktop version of Potree. Allows drag&drop of point clouds into the viewer.

Examples

Basic Viewer	CA13 (18 billion Points)	Retz (Potree + Cesium)	Classifications	Various Features	Toolbar

More Examples

Load Project	Matcap	Virtual Reality	Heidentor	Lion	Lion LAS
Lion LAZ	EPT	EPT Binary	EPT zstandard	Clipping Volume	Oriented Images
Elevation Profile	Measurements	Meshes	Multiple Point Clouds	Camera Animation	Features (CA13)
Annotations	Hierarchical Annotations	Animation Path	Shapefiles	Cesium CA13	Geopackage
Cesium Sorvilier	Custom Sidebar Section	Embedded Iframe	Gradient Colors

VR

Heidentor	Eclepens	Morro Bay	Lion	Dechen Cave

Showcase

Matterhorn	Retz	Lake Tahoe	Sorvilier	Grave	Chowilla

More

Chiller	Cooler	Dechen Cave	Ruins	Eclepens	Heidentor
Building	LDHI	Lion Head	Overpass	Pielach	pompei
Santorini	Skatepark	Subsea Eq.	Subsea Man.	Westend Palais	Whitby

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.
• Three.js, the WebGL 3D rendering library on which potree is built.
• plas.io point cloud viewer. LAS and LAZ support have been taken from the laslaz.js implementation of plas.io. Thanks to Uday Verma and Howard Butler for this!
• Harvest4D Potree currently runs as Master Thesis under the Harvest4D Project
• Christian Boucheny (EDL developer) and Daniel Girardeau-Montaut (CloudCompare). The EDL shader was adapted from the CloudCompare source code!
• Martin Isenburg, Georepublic, Veesus, Sigeom Sa, SITN, LBI ArchPro, Pix4D 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",
}

potree.github.io's Issues

HTTPS for custom domain

HTTPS for custom domains is still not supported unfortunately by Github Pages, but there seem to be workarounds using CloudFlare: https://support.cloudflare.com

I want to setup HTTPS for the pgRouting websites as well, so I can help with this.
The only annoying part of CloudFlare is, that it requires another 3rd party account.

Setup CNAME file

We need the CNAME file for potree.

OSGeo Community Project

It's relatively easy to apply as OSGeo Community Project.
https://wiki.osgeo.org/wiki/OSGeo_Community_Projects

At the moment there is a lot of activity in OSGeo with developing a new logo and website and a lot of content is reviewed as well.

There are no difficult hurdles to become an OSGeo Community Project and it helps a bit to be compliant with at least the basics of and Open Source project.

(FYI, the logos on the Wiki page are the old ones and will be replaced soon.)

Import old blog entries

The old blog entries are stored in wordpress, it would be good to keep the links and not break any pages linking to those blog entries.

Rename repository to `website`

Referencing potree/potree#355

I think you could rename the repository from potree.github.io to just website for example.

In the end the website would be accessible by "www.potree.org" or just "potree.org", and these settings for Github Pages can be just made with some configuration file.

Modification of the Potree.Gradient

I am using POTREE to display point clouds over a server in a browser. My data contains some point distortions (extreme highs and lows) which are not classified and therefore stretch my colorramp to such an extreme, that the actual ground heights are displayed as only one color.

Is there any way I can set the Potree.Gradient for only a specific elevation range? e.g. between 60 and 120 Meters?

Community Insights

With pgRouting I recently stumbled upon the "Community Insights" page. I couldn't see the menu entry as non-admin for Potree, but modifying the URL worked: https://github.com/potree/potree/community

Github makes it quite easy to raise the progress bar to 100%, I think. It's usually just a few clicks away.

I'm posting this on this repository, because there is no "org" repository and I don't want to mess up the main repository with administrational tasks. (Btw., just recently I added an "admin" repository to pgRouting and it tunred out to be convenient).

Add parameters to URL

Is it possible to add parameters to a Potree URL, e.g. for linking to a specific view?

For example, for http://potree.org/potree/examples/annotations.html , let's say I would like to link to:
viewer.scene.view.position.set(589863.919, 231456.400, 750.975);
viewer.scene.view.lookAt(new THREE.Vector3(589899.779, 231327.250, 747.285));

Is there a strategy to put this in a hyperlink, such as http://potree.org/potree/examples/annotations.html#viewer.scene.view.position.set(589863.919, 231456.400, 750.975); ?

(I'm a noob, so it's possible that this already exists, but I do not know the syntax.)

Thank you!