Skip to content

๐Ÿ““ Jupyter Notebook (Interactive Exploration & Experimentation)

The MIRROR platform includes a fully integrated Jupyter Notebook environment inside Docker โ€” allowing you to explore, validate, and prototype workflows with live access to your PostgreSQL database, point cloud data, and ingestion tools.


โœ… Key Capabilities

๐Ÿ”Œ Pre-connected to PostgreSQL

  • The notebook is preconfigured to connect to your platform's PostgreSQL instance.
  • You can run live SQL queries to inspect data, test joins, and validate ingestion.

๐Ÿ› ๏ธ Data Science & Analysis

  • Leverage Python tools like pandas, geopandas, matplotlib, and psycopg2 for:
  • Building spatial analytics
  • Validating geometry data
  • Creating charts and summaries from ingested content

Folder Structure

All notebooks and data can be placed inside the shared volume:

./db/notebooks/
  โ”œโ”€โ”€ sample_data.laz
  โ”œโ”€โ”€ example_pipeline.ipynb
  โ””โ”€โ”€ test_query.ipynb

This folder is mounted inside the Jupyter container and persists across runs.


๐Ÿš€ Accessing Jupyter

Once your Docker setup is running:

๐Ÿ‘‰ Open http://localhost:8888

No token is required โ€” youโ€™ll land directly in the browser interface.


๐Ÿงช Example Use Cases

  • Test .laz ingestion pipelines with custom PDAL configurations
  • Query and inspect glossary, projects, or GIS tables with SQL
  • Analyze ingestion failures by checking raw data
  • Prototype logic before hardcoding into backend pipelines

๐Ÿง  Why It Matters

The Jupyter environment makes the MIRROR platform:

  • ๐ŸŒ More transparent for technical and semi-technical users
  • ๐Ÿงช Perfect for experimentation without rebuilding containers
  • ๐Ÿ”ฌ Ideal for exploration, troubleshooting, and education