An updated template for Potree pages based on Vizcaya Museum project and inspired by potree-sfm project features.
A working example can be found on the LabMGF DICA PoliMi website.
Information about how the project was developed, including details on the survey campaign and on web platform implementation, can be found on the official documentation website.
potree-chtemplate extends the Potree WebGL point cloud viewer with specialized features for cultural heritage documentation. The template transforms multi-modal survey data (point clouds, photogrammetric models, oriented images) into an interactive web-accessible digital twin supporting both free exploration and guided narrative experiences.
- Dual-scene architecture - Separate outdoor and indoor environments with seamless transitions
- Interactive annotations - 17 clickable hotspots with contextual multimedia content
- Camera animations - Guided tours through predefined navigation paths
- Oriented images - Photo overlays aligned with 3D geometry
- Historical phases - Toggle between 9 construction evolution phases template-implementation.rst:23
- Responsive design - Bootstrap integration for mobile and desktop compatibility
Make sure you have the following installed and working in order to reproduce the project. You can view detailed installation guidelines within the following links:
- Convert point clouds using PotreeConverter from LAS/LAZ to Potree JSON format
- Place converted data in ./pointclouds/ directory
- Configure loaders in JavaScript modules (loadpointclouds.js, loadannotations.js, etc.)
For continuity sake, this project carries the same license as the original Potree project. More information can be found in the LICENSE file.
Examples work best and with Google Chrome and Firefox.
The project has been originally developed by LAB2R (Laboratory of Survey and Representation) and LabMGF (Geodetic and Photogrammetric Laboratory) coordinated by Professor Livio Pinto at Politecnico di Milano - Piacenza campus.
The in situ survey was part of the laboratories for the RELIEF TECHNIQUE AND 3D MODELING FOR THE ARCHITECTURE course from the Bachelor of Science Degree in Architectural Design. Drone surveys and laser scanner acquisitions were conducted and pre-processed by Federico Barbieri and Francesco Ioli
The collected data were first processed within the research thesis project entitled Riscoprire il gigante sommerso - Rilievo, indagine storica e ricostruzione digitale del Castello di Pierluigi Farnese by Michele Dondi and Clara Rivieri. by Michele Dondi and Clara Rivieri.
The digital twin platform implementation was carried by Federica Gaspari.
Full documentation available at potree-chtemplate.readthedocs.io
Topics covered:
- Template implementation guide
- Data acquisition methodology
- Survey techniques and processing workflow
- Customization instructions
if you are willing to contribute or test the template for several applications and report a bug or suggest new features:
- Fork this repository
- Clone your fork
- Create a new branch
- Make desired changes to the code and commit them
- Push changes to your GitHub repository
- Open a pull request
- Castello Farnese in Piacenza (Italy)
- Belvedere Glacier in Macugnaga (Italy)
The project team thanks Marcello Spigaroli and Ente Farnese for the stimulating and exciting study opportunity and for the support on the historical investigation on the site. Moreover, we would like to acknowledge the collaboration demonstrated by the Military Arsenal of Piacenza and the Historical Archives of Parma in facilitating the research in the archives and libraries.
-
Gaspari, F., Barbieri, F., Fascia, R., Ioli, F., Pinto, L. (2024) An Open-Source Web Platform for 3D Documentation and Storytelling of Hidden Cultural Heritage. Heritage, 7, 517-536. https://doi.org/10.3390/heritage7020025
-
Gaspari, F., Ioli, F., Barbieri, F., Rivieri, C., Dondi, M., and Pinto, L.: Rediscoverinng cultural heritage sites by interactive 3D exploration: a practical review of open-source WebGL tools, Int. Arch. Photogramm. Remote Sens. Spatial Inf. Sci., XLVIII-M-2-2023, 661–668, https://doi.org/10.5194/isprs-archives-XLVIII-M-2-2023-661-2023, 2023
- CIPA 2023 Firenze (28.06.2023) - Rediscoverinng cultural heritage sites by interactive 3D exploration: a practical review of open-source WebGL tools by Federica Gaspari (SLIDES)