From 492d6ea2f70b3deb519c4cf963630f42dc825de1 Mon Sep 17 00:00:00 2001 From: Wesley B <62723358+wesleyboar@users.noreply.github.com> Date: Mon, 3 Aug 2026 14:37:31 -0500 Subject: [PATCH 1/2] docs(curating): consolidate Potree limitations note into shared include Point cloud note duplicated with slight wording differences across bestpractices.md, hazmapper.md, and potree-viewer.md; now maintained in one file (user-guide/include/potree-note.md) and pulled in via include-markdown, following the api-note.md pattern. --- user-guide/curating/bestpractices.md | 4 +++- user-guide/include/potree-note.md | 1 + user-guide/tools/visualization/hazmapper.md | 2 +- user-guide/tools/visualization/potree-viewer.md | 2 +- 4 files changed, 6 insertions(+), 3 deletions(-) create mode 100644 user-guide/include/potree-note.md diff --git a/user-guide/curating/bestpractices.md b/user-guide/curating/bestpractices.md index db0850d5..c10f6f0a 100644 --- a/user-guide/curating/bestpractices.md +++ b/user-guide/curating/bestpractices.md @@ -82,7 +82,9 @@ Understanding that ArcGIS software is widespread in this community, it is possib ### Point Cloud Data -Point cloud data should be published in open, non-proprietary formats that ensure long-term usability and interoperability (e.g., LAS/LAZ, E57). The standard formats for publication are LAS and its compressed counterpart LAZ, both of which are widely supported by geospatial software and community tools. These formats store the raw point measurements along with important metadata, including the coordinate reference system (CRS), which is essential to accurately locate the data in space and make it usable in mapping and analysis. In DS, we have Potree available for users to view point cloud datasets. Through the Potree Convertor application, non-proprietary point cloud files can be converted to a Potree readable format for visualization in DesignSafe. The Potree viewer is intended for preliminary, exploratory viewing: it streams the cloud at a level of detail and renders only a portion of the points at any given time, so it is not a substitute for the source data. For full-resolution analysis, work from the original LAS/LAZ file in a dedicated point cloud tool such as [CloudCompare](https://www.cloudcompare.org/) or [QGIS](https://www.designsafe-ci.org/use-designsafe/tools-applications/gis-tools/qgis/). +Point cloud data should be published in open, non-proprietary formats that ensure long-term usability and interoperability (e.g., LAS/LAZ, E57). The standard formats for publication are LAS and its compressed counterpart LAZ, both of which are widely supported by geospatial software and community tools. These formats store the raw point measurements along with important metadata, including the coordinate reference system (CRS), which is essential to accurately locate the data in space and make it usable in mapping and analysis. In DS, we have Potree available for users to view point cloud datasets. Through the Potree Convertor application, non-proprietary point cloud files can be converted to a Potree readable format for visualization in DesignSafe. + +{% include-markdown '../include/potree-note.md' %} Authors are encouraged to: diff --git a/user-guide/include/potree-note.md b/user-guide/include/potree-note.md new file mode 100644 index 00000000..9525527c --- /dev/null +++ b/user-guide/include/potree-note.md @@ -0,0 +1 @@ +_**Note:** The Potree Viewer is intended for preliminary, exploratory viewing. For performance, it streams the point cloud at a level of detail and renders only a portion of the points at any given time, so the in-browser view is not full density and is not a substitute for the source data. For full-resolution analysis, work from the original LAS/LAZ file in a dedicated point cloud tool such as [CloudCompare](https://www.cloudcompare.org/) (download to your local machine) or [QGIS](https://www.designsafe-ci.org/use-designsafe/tools-applications/gis-tools/qgis/) (available in the DesignSafe Workspace)._ diff --git a/user-guide/tools/visualization/hazmapper.md b/user-guide/tools/visualization/hazmapper.md index 7f80066e..952282b4 100644 --- a/user-guide/tools/visualization/hazmapper.md +++ b/user-guide/tools/visualization/hazmapper.md @@ -179,7 +179,7 @@ If the user clicks on the _View_ button on the information box, the Potree Viewe **Fig 2.13** -The Potree Viewer is intended for preliminary, exploratory viewing. For performance, it streams the cloud at a level of detail and renders only a portion of the points at any given time, so the in-browser view is not full density and is not a substitute for the source data. For full-resolution analysis, work from the original LAS/LAZ file in a dedicated point cloud tool such as [CloudCompare](https://www.cloudcompare.org/) (download to your local machine) or [QGIS](https://www.designsafe-ci.org/use-designsafe/tools-applications/gis-tools/qgis/) (available in the DesignSafe Workspace). +{% include-markdown '../../include/potree-note.md' %} The URL to the Potree Viewer created for the asset will be permanent as long as the asset exists. Furthermore, this can be shared with other researchers. diff --git a/user-guide/tools/visualization/potree-viewer.md b/user-guide/tools/visualization/potree-viewer.md index e49071ed..faca63c0 100644 --- a/user-guide/tools/visualization/potree-viewer.md +++ b/user-guide/tools/visualization/potree-viewer.md @@ -3,7 +3,7 @@ Potree Viewer is a point cloud viewer that enables exploration and measurement of very large LiDAR datasets and is designed to be efficient in a web browser. Use the Potree Converter to first convert your point cloud data to a format compatible with the Potree Viewer. -The Potree Viewer is intended for preliminary, exploratory viewing; for performance it renders point clouds at a level of detail rather than at full density, so it is not a substitute for the source data. For full-resolution analysis, work from the original LAS/LAZ file in a dedicated point cloud tool such as CloudCompare or QGIS. +{% include-markdown '../../include/potree-note.md' %} ### How to Start a Potree Interactive Session in the Workspace { #submit } From 8c38a4b5244c96e41c069397afa49081c3a348cb Mon Sep 17 00:00:00 2001 From: Wesley B <62723358+wesleyboar@users.noreply.github.com> Date: Mon, 3 Aug 2026 14:52:11 -0500 Subject: [PATCH 2/2] docs(curating): use admonition callout for Potree note Switches the shared Potree note from an italic-bold prefix to the site's standard "!!! note" admonition, matching the callout style already used elsewhere (e.g. hazmapper.md). --- user-guide/include/potree-note.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/user-guide/include/potree-note.md b/user-guide/include/potree-note.md index 9525527c..b16db0b1 100644 --- a/user-guide/include/potree-note.md +++ b/user-guide/include/potree-note.md @@ -1 +1,2 @@ -_**Note:** The Potree Viewer is intended for preliminary, exploratory viewing. For performance, it streams the point cloud at a level of detail and renders only a portion of the points at any given time, so the in-browser view is not full density and is not a substitute for the source data. For full-resolution analysis, work from the original LAS/LAZ file in a dedicated point cloud tool such as [CloudCompare](https://www.cloudcompare.org/) (download to your local machine) or [QGIS](https://www.designsafe-ci.org/use-designsafe/tools-applications/gis-tools/qgis/) (available in the DesignSafe Workspace)._ +!!! note + The Potree Viewer is intended for preliminary, exploratory viewing. For performance, it streams the point cloud at a level of detail and renders only a portion of the points at any given time, so the in-browser view is not full density and is not a substitute for the source data. For full-resolution analysis, work from the original LAS/LAZ file in a dedicated point cloud tool such as [CloudCompare](https://www.cloudcompare.org/) (download to your local machine) or [QGIS](https://www.designsafe-ci.org/use-designsafe/tools-applications/gis-tools/qgis/) (available in the DesignSafe Workspace).