Final Publication of LAS 1.4 Revision 16 (Aug 2025)

.github/workflows/pdf.yml

@@ -0,0 +1,48 @@
+name: Docs
+
+on:
+  push:
+    branches: '*'
+
+jobs:
+  docs:
+    name: Docs
+
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: true
+    container: ghcr.io/osgeo/proj-docs
+
+    steps:
+    - uses: actions/checkout@v3
+    - name: Print versions
+      run: |
+          python3 --version
+          sphinx-build --version
+          DEBIAN_FRONTEND=noninteractive apt-get update  -y
+          DEBIAN_FRONTEND=noninteractive apt-get install texlive-fonts-recommended -y
+    - name: Lint .rst files
+      run: |
+        if find . -name '*.rst' | xargs grep -P '\t'; then echo 'Tabs are bad, please use four spaces in .rst files.'; false; fi
+    - name: PDF
+      run: |
+        make latexpdf
+    - name: Spelling
+      run: |
+        make spelling
+    - uses: actions/upload-artifact@v4
+      with:
+        name: PDF
+        path: build/latex/LAS.pdf
+        if-no-files-found: error
+    - uses: actions/upload-artifact@v4
+      with:
+        name: TEX
+        path: build/latex/LAS.tex
+        if-no-files-found: error
+    - uses: actions/upload-artifact@v4
+      with:
+        name: Misspelled
+        path: build/spelling/output.txt
+        if-no-files-found: ignore
+

.gitignore

@@ -1 +1,2 @@
 build/
+.vscode

Makefile

@@ -17,4 +17,6 @@ help:
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
-	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+

README.md

@@ -25,3 +25,4 @@ New to LAS? New to GitHub? Want to help? No problem!
 Learn how to sign up and contribute [here](https://github.com/ASPRSorg/LAS/wiki/Get-Involved).
 
 [![Build Status](https://api.travis-ci.org/ASPRSorg/LAS.svg?branch=master)](https://travis-ci.org/ASPRSorg/LAS)
+

source/01_intro.txt

@@ -104,6 +104,25 @@ Summary of LAS 1.4 revisions (GitHub Issue numbers included when applicable):
   * Added missing Scanner Channel field in note about PDRF6-10 bit field.
     (`I-80 <https://github.com/ASPRSorg/LAS/issues/80>`_)
 
+* R16 - Readability improvements and clarifications (August 2025):
+
+  * Clarified uniformity of GPS Time for all returns of a pulse.
+    (`I-81 <https://github.com/ASPRSorg/LAS/issues/81>`_)
+  * Added example usage of Overlap bit.
+    (`I-5 <https://github.com/ASPRSorg/LAS/issues/5>`_)
+  * Reworded mandatory zero Classification for Synthetic PDRF0-5.
+    (`I-86 <https://github.com/ASPRSorg/LAS/issues/86>`_)
+  * Added Byte Offset columns to Header, VLR, EVLR, and PDRF tables.
+    (`I-55 <https://github.com/ASPRSorg/LAS/issues/55>`_)
+  * Clarified how and when certain header fields should be zero-filled.
+    (`I-101 <https://github.com/ASPRSorg/LAS/issues/101>`_)
+  * Added Official LAS Wiki section.
+    (`I-71 <https://github.com/ASPRSorg/LAS/issues/71>`_)
+  * Clarified source of min/max XYZ and ExtraByte values.
+    (`I-89 <https://github.com/ASPRSorg/LAS/issues/89>`_)
+  * More closely aligned data types with C99 definitions.
+    (`I-115 <https://github.com/ASPRSorg/LAS/issues/115>`_)
+
 For detailed information on changes in revisions R14 and newer, review the
 inline differencing provided on the `GitHub page <https://github.com/ASPRSorg/LAS>`_.
 
@@ -127,21 +146,21 @@ The additions of LAS 1.4 include:
     Systems.
   * Addition of an Overlap bit to indicate points in the overlap
     region while maintaining the class definition.
-  * Addition of an (optional) :ref:`extrabytes_vlr_label` Variable Length Record to describe
+  * Addition of an (optional) :ref:`Extra Bytes Variable Length Record <extrabytes_vlr_label>` to describe
     "extra bytes" stored with each point.
 
 * Other minor changes:
 
   * Added definitions for "LAS Domain Profile" and "LAS Domain Profile
     Description".
-  * Added links to official LAS wiki: https://github.com/ASPRSorg/LAS/wiki
+  * Added references to :ref:`Official LAS Wiki <laswiki_link>`.
 
 
 Conformance
 ................................................................................
 
 The data types used in the LAS format definition are conformant to the 1999
-ANSI C Language Specification (ANSI/ISO/IEC 9899:1999 ("C99").
+ANSI C Language Specification (ANSI/ISO/IEC 9899:1999 ("C99")).
 
 
 Authority
@@ -156,24 +175,29 @@ organization as directed by the ASPRS Board of Directors. Questions related to
 this standard can be directed to ASPRS:
 
 * Online at https://github.com/ASPRSorg/LAS
-* By phone at 301-493-0290
+* By phone at 225-408-4747
 * By email at las@asprs.org or asprs@asprs.org
-* By mail at 425 Barlow Place, Suite 210, Bethesda, Maryland 20814-2160
+* By mail at 8550 United Plaza Blvd, Suite 1001, Baton Rouge, LA 70809
 
 OGC
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-LAS has been recognized by the Open Geospatial Consortium (`OGC`_) in 2018 as an
+LAS has been recognized by the Open Geospatial Consortium (`OGC`_) since 2018 as an
 OGC Community Standard. The OGC version of the document with forward material
 about standards that LAS references and its status within the standard body can
-be found at https://portal.opengeospatial.org/files/17-030r1.
+be found at https://www.ogc.org/publications/standard/las/.
 
 Future recognition and activity on OGC referencing activities of LAS can be
-followed at http://www.opengeospatial.org/standards/community.
+followed at https://www.ogc.org/publications/.
+
+.. _`OGC`: https://www.ogc.org
 
-.. _`OGC`: http://www.opengeospatial.org
 
-.. raw:: latex
+.. _laswiki_link:
 
-    \newpage
+Official LAS Wiki
+................................................................................
 
+The official LAS wiki hosts supplemental guidance pages, links to external
+resources, public registries, and more LAS-related resources.
+The wiki can be found at https://github.com/ASPRSorg/LAS/wiki.

source/02.00_definition.txt

@@ -1,3 +1,7 @@
+.. raw:: latex
+
+    \newpage
+
 LAS Format Definition
 --------------------------------------------------------------------------------
 

source/02.03_datatypes.sub

@@ -3,19 +3,22 @@ Data Types
 
 The following data types are used in the LAS format definition. Note that these
 data types are conformant to the 1999 ANSI C Language Specification
-(ANSI/ISO/IEC 9899:1999 ("C99")).
-
-* char (1 byte)
-* unsigned char (1 byte)
-* short (2 bytes)
-* unsigned short (2 bytes)
-* long (4 bytes)
-* unsigned long (4 bytes)
-* long long (8 bytes)
-* unsigned long long (8 bytes)
-* float (4 byte IEEE floating point format)
-* double (8 byte IEEE floating point format)
-* string (a variable series of 1 byte characters, ASCII encoded, null-terminated)
+(ANSI/ISO/IEC 9899:1999 ("C99")), as defined in the standard header
+``<stdint.h>``.
+
+* int8_t (1 byte)
+* uint8_t (1 byte)
+* int16_t (2 bytes)
+* uint16_t (2 bytes)
+* int32_t (4 bytes)
+* uint32_t (4 bytes)
+* int64_t (8 bytes)
+* uint64_t (8 bytes)
+* float (4-byte ``binary32`` IEEE floating point format)
+* double (8-byte ``binary64`` IEEE floating point format)
+* string (a variable-length array of 1-byte characters, ASCII-encoded,
+  null-terminated, contained in a fixed-length ``char`` array, where ``char``
+  must be equivalent to either ``int8_t`` or ``uint8_t``)
 
 .. warning::