From 913e9b462e2f6c9268e7f2b403bd227b12120a90 Mon Sep 17 00:00:00 2001 From: Evon Silvia Date: Thu, 20 Feb 2025 10:01:09 -0800 Subject: [PATCH 01/14] Add vscode to gitignore --- .gitignore | 1 + 1 file changed, 1 insertion(+) diff --git a/.gitignore b/.gitignore index 567609b..f785746 100644 --- a/.gitignore +++ b/.gitignore @@ -1 +1,2 @@ build/ +.vscode From 61e250b8b44b247a946d201b871366f50b206a0a Mon Sep 17 00:00:00 2001 From: Evon Silvia Date: Tue, 11 Mar 2025 10:15:46 -0700 Subject: [PATCH 02/14] Add wiki link for user-contributed VLRs. --- source/04_optional_vlrs.txt | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/source/04_optional_vlrs.txt b/source/04_optional_vlrs.txt index 8086fd9..f7f0823 100644 --- a/source/04_optional_vlrs.txt +++ b/source/04_optional_vlrs.txt @@ -7,6 +7,13 @@ Optional VLR Definitions -------------------------------------------------------------------------------- +LAS 1.5 defines Variable Length Records (VLRs) in :ref:`vlrdef_label` and EVLRs +in :ref:`evlrdef_label`. Definitions for official VLRs as part of the specification +are provided in this section as a means to extend the LAS file format. + +Additional VLR definitions contributed by the LAS Working Group and the +LAS community can be found on the official LAS wiki: https://github.com/ASPRSorg/LAS/ + Classification Lookup ................................................................................ From c2293ca1591e0f97f2e52f15b4a7653550877f59 Mon Sep 17 00:00:00 2001 From: Evon Silvia Date: Tue, 11 Mar 2025 10:16:13 -0700 Subject: [PATCH 03/14] Removed outdated Classification Lookup VLR. (#82) --- source/04_optional_vlrs.txt | 19 ------------------- 1 file changed, 19 deletions(-) diff --git a/source/04_optional_vlrs.txt b/source/04_optional_vlrs.txt index f7f0823..d63ff09 100644 --- a/source/04_optional_vlrs.txt +++ b/source/04_optional_vlrs.txt @@ -14,25 +14,6 @@ are provided in this section as a means to extend the LAS file format. Additional VLR definitions contributed by the LAS Working Group and the LAS community can be found on the official LAS wiki: https://github.com/ASPRSorg/LAS/ -Classification Lookup -................................................................................ - -+----------------------------+-----------------------------------+ -| User ID | LASF_Spec | -+----------------------------+-----------------------------------+ -| Record ID | 0 | -+----------------------------+-----------------------------------+ -| Record Length after Header | 256 records * 16 bytes per struct | -+----------------------------+-----------------------------------+ - -:: - - struct CLASSIFICATION { - uint8_t ClassNumber; - char Description[15]; - }; //total of 16 bytes - - Text Area Description ................................................................................ From 329e138631596b40d217c3d998a844c0b38ad757 Mon Sep 17 00:00:00 2001 From: Evon Silvia Date: Tue, 11 Mar 2025 10:47:16 -0700 Subject: [PATCH 04/14] Update upload-artifact to v4 --- .github/workflows/pdf.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/pdf.yml b/.github/workflows/pdf.yml index e2af798..8ac9311 100644 --- a/.github/workflows/pdf.yml +++ b/.github/workflows/pdf.yml @@ -28,11 +28,11 @@ jobs: - name: Spelling run: | make spelling - - uses: actions/upload-artifact@v3 + - uses: actions/upload-artifact@v4 with: name: PDF path: build/latex/LAS.pdf - - uses: actions/upload-artifact@v3 + - uses: actions/upload-artifact@v4 with: name: Misspelled path: build/spelling/output.txt From aef2601ea69f5e41dfccb01f64b31b3649ccdd87 Mon Sep 17 00:00:00 2001 From: Evon Silvia Date: Tue, 11 Mar 2025 10:51:41 -0700 Subject: [PATCH 05/14] Configure warnings for file-not-found. --- .github/workflows/pdf.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.github/workflows/pdf.yml b/.github/workflows/pdf.yml index 8ac9311..b749a9d 100644 --- a/.github/workflows/pdf.yml +++ b/.github/workflows/pdf.yml @@ -32,10 +32,12 @@ jobs: with: name: PDF path: build/latex/LAS.pdf + if-no-files-found: error - uses: actions/upload-artifact@v4 with: name: Misspelled path: build/spelling/output.txt + if-no-files-found: ignore From 6e9bd9b1c3cb345d14e852a4c730e118b1695fe5 Mon Sep 17 00:00:00 2001 From: Evon Silvia Date: Tue, 11 Mar 2025 10:56:12 -0700 Subject: [PATCH 06/14] Improve readability of Optional VLR section intro. --- source/04_optional_vlrs.txt | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/source/04_optional_vlrs.txt b/source/04_optional_vlrs.txt index d63ff09..2ba702b 100644 --- a/source/04_optional_vlrs.txt +++ b/source/04_optional_vlrs.txt @@ -7,11 +7,9 @@ Optional VLR Definitions -------------------------------------------------------------------------------- -LAS 1.5 defines Variable Length Records (VLRs) in :ref:`vlrdef_label` and EVLRs -in :ref:`evlrdef_label`. Definitions for official VLRs as part of the specification +Definitions for official :ref:`vlrdef_label` and :ref:`evlrdef_label` are provided in this section as a means to extend the LAS file format. - -Additional VLR definitions contributed by the LAS Working Group and the +Additional (E)VLR definitions contributed by the LAS Working Group and the LAS community can be found on the official LAS wiki: https://github.com/ASPRSorg/LAS/ Text Area Description From 5631cae7309fbcee57cc1720df067b6ddca2b0d6 Mon Sep 17 00:00:00 2001 From: Evon Silvia Date: Tue, 11 Mar 2025 10:57:53 -0700 Subject: [PATCH 07/14] Standardize VLR/EVLR notation --- source/02.02_crs.sub | 6 +++--- source/04_optional_vlrs.txt | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/source/02.02_crs.sub b/source/02.02_crs.sub index 9b0cdb6..bc7e71b 100644 --- a/source/02.02_crs.sub +++ b/source/02.02_crs.sub @@ -27,9 +27,9 @@ The CRS representation is summarized below: | 6-10 | Error | WKT | +-----------------------+----------------------------+-----------------------+ -It is considered a file error to have more than one GeoTIFF (E)VLR or more than -one WKT (E)VLR in the file. A writer can append a new CRS EVLR to a file by -"superseding" the existing CRS (E)VLR. Superseding is performed by changing the +It is considered a file error to have more than one GeoTIFF VLR/EVLR or more than +one WKT VLR/EVLR in the file. A writer can append a new CRS EVLR to a file by +"superseding" the existing CRS VLR/EVLR. Superseding is performed by changing the LAS_Spec ID of the record to ":ref:`superseded_vlr_label`", a new LASF_Spec defined in this release. diff --git a/source/04_optional_vlrs.txt b/source/04_optional_vlrs.txt index 2ba702b..d0f5f6c 100644 --- a/source/04_optional_vlrs.txt +++ b/source/04_optional_vlrs.txt @@ -9,7 +9,7 @@ Optional VLR Definitions Definitions for official :ref:`vlrdef_label` and :ref:`evlrdef_label` are provided in this section as a means to extend the LAS file format. -Additional (E)VLR definitions contributed by the LAS Working Group and the +Additional VLR/EVLR definitions contributed by the LAS Working Group and the LAS community can be found on the official LAS wiki: https://github.com/ASPRSorg/LAS/ Text Area Description From 6e715a9a775956500039ef77b0f51f839384e90f Mon Sep 17 00:00:00 2001 From: Evon Silvia Date: Thu, 20 Mar 2025 11:35:48 -0700 Subject: [PATCH 08/14] Restore Classification Lookup VLR, but deprecated --- source/04_optional_vlrs.txt | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/source/04_optional_vlrs.txt b/source/04_optional_vlrs.txt index d0f5f6c..3278fd1 100644 --- a/source/04_optional_vlrs.txt +++ b/source/04_optional_vlrs.txt @@ -12,6 +12,29 @@ are provided in this section as a means to extend the LAS file format. Additional VLR/EVLR definitions contributed by the LAS Working Group and the LAS community can be found on the official LAS wiki: https://github.com/ASPRSorg/LAS/ +Classification Lookup (Deprecated) +................................................................................ + ++----------------------------+-----------------------------------+ +| User ID | LASF_Spec | ++----------------------------+-----------------------------------+ +| Record ID | 0 | ++----------------------------+-----------------------------------+ +| Record Length after Header | 256 records * 16 bytes per struct | ++----------------------------+-----------------------------------+ + +The legacy Classification Lookup VLR has a feature of the LAS specification +since LAS 1.0. This VLR has been deprecated in LAS 1.5 due to 15 characters +being too short to store a sufficiently detailed description. An updated +version of the VLR can be found on the LAS wiki. + +:: + + struct CLASSIFICATION { + uint8_t ClassNumber; + char Description[15]; + }; //total of 16 bytes + Text Area Description ................................................................................ From 9d7c138606d159908ae2f9f7850e3ee590e9a194 Mon Sep 17 00:00:00 2001 From: Evon Silvia Date: Thu, 20 Mar 2025 11:37:10 -0700 Subject: [PATCH 09/14] Normalize LAS wiki links to match #71 --- source/04_optional_vlrs.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/04_optional_vlrs.txt b/source/04_optional_vlrs.txt index 7fca436..72ccae0 100644 --- a/source/04_optional_vlrs.txt +++ b/source/04_optional_vlrs.txt @@ -10,7 +10,7 @@ Optional VLR Definitions Definitions for official :ref:`vlrdef_label` and :ref:`evlrdef_label` are provided in this section as a means to extend the LAS file format. Additional VLR/EVLR definitions contributed by the LAS Working Group and the -LAS community can be found on the official LAS wiki: https://github.com/ASPRSorg/LAS/ +LAS community can be found on the :ref:`Official LAS Wiki `. Classification Lookup (Deprecated) ................................................................................ @@ -26,7 +26,7 @@ Classification Lookup (Deprecated) The legacy Classification Lookup VLR has a feature of the LAS specification since LAS 1.0. This VLR has been deprecated in LAS 1.5 due to 15 characters being too short to store a sufficiently detailed description. An updated -version of the VLR can be found on the LAS wiki. +version of the VLR can be found on the :ref:`Official LAS Wiki `. :: From d1f9b555675538cbcea1b32bf99ae139ee52d9e2 Mon Sep 17 00:00:00 2001 From: Evon Silvia Date: Thu, 20 Mar 2025 11:40:57 -0700 Subject: [PATCH 10/14] Added deprecation notice to intro. #82 --- source/01_intro.txt | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/01_intro.txt b/source/01_intro.txt index b25a7d5..32609ea 100644 --- a/source/01_intro.txt +++ b/source/01_intro.txt @@ -44,6 +44,8 @@ The additions of LAS 1.5 include: `I-129 `_) * Clarify requirement that the Extra Bytes VLR must be unique. (`I-150 `_) + * Deprecated Classification Lookup VLR. + (`I-82 `_) LAS 1.4 Revision History ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ From 323af37583f8dfc42e6ae90a8ce82ea96457580c Mon Sep 17 00:00:00 2001 From: Evon Silvia Date: Thu, 20 Mar 2025 11:57:36 -0700 Subject: [PATCH 11/14] Wording changes to deprecation notice. #82 --- source/04_optional_vlrs.txt | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/source/04_optional_vlrs.txt b/source/04_optional_vlrs.txt index 72ccae0..400e722 100644 --- a/source/04_optional_vlrs.txt +++ b/source/04_optional_vlrs.txt @@ -23,11 +23,6 @@ Classification Lookup (Deprecated) | Record Length after Header | 256 records * 16 bytes per struct | +----------------------------+-----------------------------------+ -The legacy Classification Lookup VLR has a feature of the LAS specification -since LAS 1.0. This VLR has been deprecated in LAS 1.5 due to 15 characters -being too short to store a sufficiently detailed description. An updated -version of the VLR can be found on the :ref:`Official LAS Wiki `. - :: struct CLASSIFICATION { @@ -35,6 +30,12 @@ version of the VLR can be found on the :ref:`Official LAS Wiki `. char Description[15]; }; //total of 16 bytes +The legacy Classification Lookup VLR (Record ID 0) has been a feature of the LAS specification +since LAS 1.0. This VLR is deprecated in LAS 1.5 due to the limitation of +15 characters being insufficient for a detailed description. An updated +version of the VLR may be found on the :ref:`Official LAS Wiki `. + + Text Area Description ................................................................................ From cb1ccf51360cee7a1fcaddc3f77971e76361af68 Mon Sep 17 00:00:00 2001 From: Evon Silvia Date: Fri, 25 Apr 2025 10:07:18 -0700 Subject: [PATCH 12/14] Add page break before FWF VLR for readability --- source/04_optional_vlrs.txt | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/04_optional_vlrs.txt b/source/04_optional_vlrs.txt index 8d7b08e..85ef2a5 100644 --- a/source/04_optional_vlrs.txt +++ b/source/04_optional_vlrs.txt @@ -247,6 +247,10 @@ updating a record such as projection information where a new EVLR is appended to the end of the LAS file. The existing VLR which has been superseded must be marked with the SUPERSEDED Record ID. +.. raw:: latex + + \newpage + .. _fwf_descriptor_label: Waveform Packet Descriptor From 2666a2404c8cac0a1341239004235652cd963912 Mon Sep 17 00:00:00 2001 From: Evon Silvia Date: Mon, 25 Aug 2025 14:42:25 -0700 Subject: [PATCH 13/14] Revert conflicting changes to CRS section --- source/02.02_crs.sub | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/02.02_crs.sub b/source/02.02_crs.sub index 1100a31..6d4d455 100644 --- a/source/02.02_crs.sub +++ b/source/02.02_crs.sub @@ -10,9 +10,9 @@ point formats are no longer supported in LAS 1.5. The CRS for the file must be located in the WKT (Extended) Variable Length Records (EVLR, VLR). It is considered a file error to have more than -one WKT VLR/EVLR in the file. A writer can append a new CRS EVLR to a file by -"superseding" the existing CRS VLR/EVLR. Superseding is performed by changing the -Record ID of the VLR/EVLR to match the :ref:`superseded_vlr_label` VLR defined +one WKT (E)VLR in the file. A writer can append a new CRS EVLR to a file by +"superseding" the existing CRS (E)VLR. Superseding is performed by changing the +Record ID of the (E)VLR to match the :ref:`superseded_vlr_label` VLR defined later in this document. From 22c69db8143d4382371ecd8d6f2a13ddd75f5cc5 Mon Sep 17 00:00:00 2001 From: Evon Silvia Date: Mon, 25 Aug 2025 14:57:42 -0700 Subject: [PATCH 14/14] Normalize VLR/EVLR wording to match current LAS 1.5 --- source/04_optional_vlrs.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/04_optional_vlrs.txt b/source/04_optional_vlrs.txt index 85ef2a5..6f968b6 100644 --- a/source/04_optional_vlrs.txt +++ b/source/04_optional_vlrs.txt @@ -9,7 +9,7 @@ Optional VLR Definitions Definitions for official :ref:`vlrdef_label` and :ref:`evlrdef_label` are provided in this section as a means to extend the LAS file format. -Additional VLR/EVLR definitions contributed by the LAS Working Group and the +Additional VLR and EVLR definitions contributed by the LAS Working Group and the LAS community can be found on the :ref:`Official LAS Wiki `. Classification Lookup (Deprecated)