riccio3di

A web app for exploring in 3D an art exhibition based on Potree JS.

A working example can be found on the LabMGF@PoliMi website.

Home page of the Potree based platform

Example of an artwork view with informative panel

Example of custom legend panel for data sources

Table of content 📋

How to install and run

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:

Once you cloned this repository, make sure that it is located inside the xampp/htdocs directory. The web app will then be accessible by connecting to the url localhost/riccio3di/.

In order to enable the db connection for annotations loading, install PostgreSQL and create a new database containing a table for artworks information. For the Ricci Oddi case study, PostgreSQL 16.1 version has been used. Then, fix the connection credentials in index.php according to your case.

License

For continuity sake, this project carries the same license as the original Potree project. More information can be found in the LICENSE file.

Features 💡

Custom welcome page

3D scene exploration

Point cloud source legend

Search bar and info panel

Indoor floor plan navigation

Database-connected annotations

Performance 💻

Examples work best and with Google Chrome and Firefox.

Credits 👥

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, Rebecca Fascia and Francesco Ioli

The collected data were first processed within the research thesis project entitled Galleria Ricci Oddi: Indagine storica - rilievo e rappresentazione del complesso architettonico by Gaia Castelli.

The digital twin platform implementation was carried by Federica Gaspari.

How to contribute

if you are willing to contribute or test the template for several applications and report a bug or suggest new features:

  1. Fork this repository
  2. Clone your fork
  3. Create a new branch
  4. Make desired changes to the code and commit them
  5. Push changes to your GitHub repository
  6. Open a pull request

References 📚