Release v3.0.0 (#105)

* Update the README example to use TileDB writer

* Bump version to 3.0.0 for new major release

* Update the README example to write to both a LAS file and a TileDB array

Author: gsakkis

CHANGES.txt

@@ -1,10 +1,26 @@
 Changes
 --------------------------------------------------------------------------------
 
+3.0.0
+................................................................................
+
+* Pythonic pipeline creation https://github.com/PDAL/python/pull/91
+
+* Support streaming pipeline execution https://github.com/PDAL/python/pull/94
+
+* Replace Cython with PyBind11 https://github.com/PDAL/python/pull/102
+
+* Remove pdal.pio module https://github.com/PDAL/python/pull/101
+
+* Move readers.numpy and filters.python to separate repository https://github.com/PDAL/python/pull/104
+
+* Miscellaneous refactorings and cleanups
+
 2.3.5
 ................................................................................
 
 * Fix memory leak https://github.com/PDAL/python/pull/74
+
 * Handle metadata with invalid unicode by erroring https://github.com/PDAL/python/pull/74
 
 2.3.0
@@ -29,5 +45,3 @@ Changes
   schedule at https://github.com/PDAL/python
 
 * Extension now builds and works under PDAL OSGeo4W64 on Windows.
-
-

README.rst

@@ -137,14 +137,14 @@ The following more complex scenario demonstrates the full cycling between
 PDAL and Python:
 
 * Read a small testfile from GitHub into a Numpy array
-* Filters those arrays with Numpy for Intensity
+* Filters the array with Numpy for Intensity
 * Pass the filtered array to PDAL to be filtered again
-* Write the filtered array to an LAS file.
+* Write the final filtered array to a LAS file and a TileDB_ array
+  via the `TileDB-PDAL integration`_ using the `TileDB writer plugin`_
 
 .. code-block:: python
 
     import pdal
-    import numpy as np
 
     data = "https://github.com/PDAL/PDAL/blob/master/test/data/las/1.2-with-color.las?raw=true"
 
@@ -170,18 +170,27 @@ PDAL and Python:
     print(pipeline.execute())  # 387 points
     clamped = pipeline.arrays[0]
 
-    # Write our intensity data to an LAS file
+    # Write our intensity data to a LAS file and a TileDB array. For TileDB it is
+    # recommended to use Hilbert ordering by default with geospatial point cloud data,
+    # which requires specifying a domain extent. This can be determined automatically
+    # from a stats filter that computes statistics about each dimension (min, max, etc.).
     pipeline = pdal.Writer.las(
-        filename="clamped2.las",
+        filename="clamped.las",
         offset_x="auto",
         offset_y="auto",
         offset_z="auto",
         scale_x=0.01,
         scale_y=0.01,
         scale_z=0.01,
     ).pipeline(clamped)
+    pipeline |= pdal.Filter.stats() | pdal.Writer.tiledb(array_name="clamped")
     print(pipeline.execute())  # 387 points
 
+    # Dump the TileDB array schema
+    import tiledb
+    with tiledb.open("clamped") as a:
+        print(a.schema)
+
 Executing Streamable Pipelines
 ................................................................................
 Streamable pipelines (pipelines that consist exclusively of streamable PDAL
@@ -288,6 +297,9 @@ USE-CASE : Take a LiDAR map, create a mesh from the ground points, split into ti
 .. _`Numpy`: http://www.numpy.org/
 .. _`schema`: http://www.pdal.io/dimensions.html
 .. _`metadata`: http://www.pdal.io/development/metadata.html
+.. _`TileDB`: https://tiledb.com/
+.. _`TileDB-PDAL integration`: https://docs.tiledb.com/geospatial/pdal
+.. _`TileDB writer plugin`: https://pdal.io/stages/writers.tiledb.html
 
 .. image:: https://github.com/PDAL/python/workflows/Build/badge.svg
    :target: https://github.com/PDAL/python/actions?query=workflow%3ABuild

pdal/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "2.4.2"
+__version__ = "3.0.0"
 __all__ = ["Pipeline", "Stage", "Reader", "Filter", "Writer", "dimensions", "info"]
 
 from . import libpdalpython