-
Notifications
You must be signed in to change notification settings - Fork 432
/
RELEASENOTES.txt
1699 lines (1529 loc) · 75.8 KB
/
RELEASENOTES.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
================================================================================
2.4.1
================================================================================
Changes of Note
===============
- ``writers.copc`` now sorts chunks by GPStime, allowing better
compression.
Enhancements
============
- Errors from the geotiff library are now directed to the console
(standard error).
- ``readers.bpf`` now adds a ``count`` of the number of points to
metadata.
- The ``pdal info`` command now writes a GeoJSON metadata entry
describing the area boundary called ``boundary_json``.
Bug Fixes
=========
- The ``pdal pipeline --pipeline-serialization`` command now maintains
input directory separators. (#3574)
- Better handling of UTF-8 -> UTF-16 filenames on Windows has been
added. (#3756, #3760)
================================================================================
2.4.0
================================================================================
Changes of Note
===============
- A compiler that supports C++17 is now required to build PDAL or
include PDAL headers in your code.
- The PDAL_STATIC_BUILD cmake option has been removed. We do not
support building PDAL as a static library, though it may work.
- The behavior of ``readers.ept`` when specifying both ``bounds`` and
``polygon`` options has changed such that a point must pass both the
filters independently in order to be accepted. (#3506)
- ``readers.ept`` will now ignore the spatial reference on a clip
region if the point source has no spatial reference. This behavior is
consistent with ``filters.crop``. (#3580)
- ``readers.las`` and ``writers.las`` no longer support the laszip
library. Both stages now use the lazperf library, which is embedded
into the PDAL library. The ``compression`` option is still accepted
in ``readers.las``, but is ignored. The ``compression`` option on
``writers.las`` still accepts the ``LASZIP`` and ``LAZPERF`` , but
those values are treated the same as ``TRUE``.
- PDAL now builds on MinGW, though future support depends on community
contributions.
- Source code supporting las and ept has been moved to a private
namespace.
New Stages
==========
- ``readers.copc`` and ``writers.copc`` have been added to support
reading and writing of
`COPC <https://github.com/copcio/copcio.github.io>`__ files.
- ``readers.smrmsg`` was added to read from post-processed MMS accuracy
files to be used with SBET data.
Enhancements
============
- The performance of ``filters.litree`` has been improved. (#3518)
- Support for time query/storage in ``readers.tiledb`` and
``writers.tiledb`` has been added. (#3495)
- Added various remote access support (AWS Fargate, AWS session token
support, Azure SAS token support). (#3496)
- An error is now reported when reading a pipeline with multiple leaf
nodes.
- Support for beam direction and origin in ``readers.rxp`` has been
added. (#3565)
- Add a cmake macro ``PDAL_CREATE_PLUGIN`` that may simplify the
creation of some PDAL plugin stages. (#3588)
- ``writers.null`` is now streamable. (#3591)
- Added support for multiple output files in ``writers.ply`` (#3617 -
Thanks @longhuan2018)
- ``filters.csf`` now permits selective output of debugging/analysis
files. (#3488)
- Comments in JSON input files (pipelines) are now supported. (#3670)
- Added support in ``writers.las`` for creating VLRs from metadata.
(#3683)
- Added query support origin query in version 1.1 of EPT. (#3505)
Bug Fixes
=========
- Fix a bug in ``FileUtils::unmapFile()`` where attempting to unmap a
file that wasn’t mapped would crash on Windows. (#3606)
- Make sure UUID is initialized to NULL. (#3483)
- Catch bounds exceptions in Metadata handling. (#3485)
- Support writing metadata in ``writers.gdal``. Add raster metadata to
PDAL metadata when using ``readers.gdal``. (#3479)
- Fix potential error in computing mean-square error computation for
``filters.icp``. (#3471)
- Fix crash in ``writers.pcd`` when the stage is run twice. (#3548)
- Prevent pipeline from being read more than once when using
PipelineExecutor. (#3587)
- Initialize ``m_curCount`` in ``writers.ogr`` to prevent a crash in
some situations. (#3611)
- Fix an off-by-one error in
``Extractor::get(std::string& s, size_t size)``. (#3650)
- Fix a bug in lazperf compression where a crash could occur when
writing a 0-point file. (#3652)
- Fix an error introduced in PDAL 2.2 where ``writers.gltf`` would
create invalid output. (#3694)
- Address a clarification in the LAS specification such that header
min/max values should be set to 0 in a 0-point file. (#3653)
================================================================================
2.3.0
================================================================================
Changes of Note
===============
- GDAL version 3 is now required. (#3428)
- ``readers.tiledb`` now defaults to unordered reads. (#3267)
- ``readers.tiledb`` now supports Hilbert ordering. (#3345)
- ``writers.pcd`` now writes 32-bit floating point for X, Y and Z by
default. (#3286)
- The GDAL error handler is redirected to its destination when PDAL
logging stops. (#3244)
- LAZperf version 2.0 is now required if building with LAZperf. (#3459)
New Command
===========
- Added ``pdal eval`` to print a classification report from two input
point clouds. (#3346)
- Added ``pdal chamfer`` to calculate the chamfer distance, a metric
used to quantify the similarity of two point clouds by evaluating the
mean square distance of nearest neighbor correspondences between
clouds.
New Stages
==========
- ``filters.gpstimeconvert`` allows conversion between the various GPS
time standards.
- ``filters.teaser`` uses the truncated least squares estimation and
semidefinite relaxation (TEASER) algorithm to create a rigid
transformation between two datasets.
- ``readers.draco`` reads the
`Draco <https://google.github.io/draco/>`__ format.
- ``writers.draco`` writes the
`Draco <https://google.github.io/draco/>`__ format.
- ``filters.zsmooth`` sets a dimension to a value determined by nearby
points. (#3408)
Removed Stages
==============
- ``readers.oci``
- ``writers.oci``
Enhancements
============
- ``pdal pipeline`` and ``pdal translate`` now support a ``--dims``
option that allows the stored dimensions to be easily controlled.
(#3310)
- ``readers.las`` now reports and terminates on some previously
undetected LAS file errors. (#3226)
- Added ``override_srs`` and ``default_srs`` options to
``readers.gdal`` to allow a raster with only NODATA to have an SRS.
(#3271)
- Support was added for MSVC 2019. (#3292)
- Added text output of GeoTIFF keys to metadata when reading LAS data.
(#3299)
- Added programmatic support to merge summary statistics. (#3321)
- Extra dimension names in a LAS file containing characters deemed
illegal by PDAL are now converted by default to legal PDAL dimension
names. (#3325)
- The sample filter is now streamable. (#3275)
- Added the ``--error_on_failure`` option to ``filters.reprojection``
to allow the program to terminate if a projection operation fails.
(#3316)
- Added the ``--start`` option to ``readers.las`` to allow skipping
some number of points. (#3313)
- Set the \`ACCEPT_ENCODING’ curl option to enable automatic
decompression of HTTP replies.
- Improve error messages for LAS where a specified point format is not
permitted. (#3324)
- Add the ``--where`` option to all writers. (#3319)
- Added a ``--nosrs`` option to ``readers.las`` to avoid reading the
SRS information. (#3441)
- Improved performance of ``readers.ept`` in stream mode. (#3331)
Bug Fixes
=========
- ``readers.tindex`` could improperly filter based on a provided
polygon. This has been fixed (#3236)
- A bug in ``filters.eigenvalues`` was fixed where improper eigenvalues
would be returned if the minimum number of neighbors wasn’t
satisfied. (#3245)
- A regression in ``filters.csf`` where an extra loop would
substantially slow processing has been fixed. (#3248)
- An infinite loop could occur in ``readers.ept`` if there was no data
to be read. This has been fixed. (#3268)
- A situation where ``readers.ept`` would attempt to transform an
invalid polygon has been fixed. (#3276)
- ``readers.obj`` is now properly closes its input file at the end of
processing. (#3294)
- A bug in auto-scaling/auto-offset has been fixed when the variance of
the data is 0. (#3304)
- Trailing NULL bytes are now stripped from WKT when read via
``readers.las``. (#3332)
- A crash that could occur in ``fitlers.hag`` if there were no points
to process has been fixed. (#3343)
- The ``dimbuilder`` utility now sets the exit code as appropriate.
(#3353)
- The ``pdal`` program now sets an error code if no command is
provided. (#3354)
- Eliminate some small memory leaks when using XMLSchema. (#3368)
- A check was added for a too-large grid in ``writers.gdal``. (#3383)
- ``filters.colorization`` now properly ignores points outside the
input raster in streaming mode. (#3391)
- A bug in handling HTTP ``Content-Length`` headers of various case has
been fixed.
- A bug in the order of reading the min/max values for ``readers.bpf``
version 1 has been fixed. (#3394)
- Fixed a bug in ``readers.i3s`` where a clip region might not properly
find all the intersecting points. (#3397)
- Replace invalid characters from EPT dimension names to make them
valid for PDAL. (#3400)
- Fixed a problem writing LAZ scan angle outside of the range [-90, 90]
for LAZ 1.4. (#3288)
- Allow LAS 1.4 to use GeoTIFF SRS for point data record format 0-5.
(#3242)
- Set the LAS extended VLR offset to zero if there are no extended VLRs
for LAS 1.4. (#3407)
- Add precision for options taking doubles. (#3235)
- Detect filter-only pipelines so applications don’t crash with their
use. (#3233)
- Fix mapping of large files on Windows NTFS. (#3282)
- Fix reading of PCD files with Linux-style line endings on Windows.
(#3424)
- ``filters.fps`` now returns all points if input contains fewer points
than requested. (#3447)
- ``filters.head`` now returns the specified number of points for *all*
input PointViews in standard mode. (#3448)
================================================================================
2.2.0
================================================================================
Changes of Note
===============
- The Zstandard compression library is no longer required in order to
build PDAL.
- The Ubuntu conda image now installs all of PDAL under ``/usr``.
- The default type of the ClusterID dimension has changed from
``uint64_t`` to ``int64_t``.
- Most operations now store data using ``ColumnPointTable``, which
stores data in arrays of dimensions, rather than arrays of point
data. This can improve the performance of some operations
substantially. Generally, this change should not be noticeable to
users.
- Normal refinement (``refine`` option) in ``filters.normal`` is now
off by default. (#3133)
- All filters now accept a ``where`` option to allow points to skip the
filters. (#3118)
- PDAL now searches for plugins in the same directory containing the
PDAL library. (#3181)
API User Notes
==============
- ``ColumnPointTable`` is now the default PDAL point table. If you have
written code that expects row-major data rather than column-major
data, be sure to use ``RowPointTable`` instead.
New Stages
==========
- ``filters.lloydkmeans`` labels points with a ``ClusterID`` based on
Lloyd’s algorithm. (#3075)
- ``filters.litree`` provides segmentation of points into trees and
non-trees. (#3111)
- ``filters.faceraster`` creates a raster from an existing
triangulation. (#3152)
- ``filters.optimalneighborhood`` computes the optimal number of
neighbors and corresponding radii (#3180)
- ``reader.obj`` allows reading of OBJ files.
Removed Stages
==============
- ``filters.hag`` has been removed. Use ``filters.hag_dem``,
``filter.hag_delaunay`` or ``filters.hag_nn`` instead.
Deprecated Stages
=================
- ``filters.ferry``. Use the ``value`` option of ``filters.assign``
instead.
- ``writers.oci``. OCI support will be removed in a future release.
- ``readers.oci``. OCI support will be removed in a future release.
Enhancements
============
- ``filters.colorinterp`` now provides the ``clamp`` option to force
values to be in the range [min, max]. (#2729 - Thanks to Matt
Csencsits)
- Long options can now be specified on the command line without and
equal sign (‘=’) separating the option name and value. (#3016)
- Added ``seed`` option ``readers.faux`` in order to allow consistent
generation of random data. (#3014)
- Improvements have been made to cmake installation to better support
downstream projects. (#2262)
- Added ``color_vertices`` option to ``writers.gltf`` to allow writing
of RGB and normals. (#3043 - Thanks to Emma Krantz)
- Added ``classbits`` option to ``filters.smrf`` to specify points to
be ignored by the SMRF algorithm. (#3055)
- Delaunay triangulation performance has been improved on systems using
libstdc++. (#3076)
- ``filters.covariancefeatures`` now provides the options ``min_k`` and
``radius`` to support radius search of neighbors in addition to
k-nearest. (#3083)
- ``filters.cluster`` now provide the option ``is3d`` to support
2-dimensional clustering. (#3084)
- ``filters.icp`` now emits a fully composed transformation matrix as
metadata that can be provided to ``filters.transformation`` to modify
point locations using a single operation. (#2939, #2962)
- ``filters.eigenvalues`` added the options ``stride``, ``radius`` and
``min_k`` to allow radius and strided neighbor searching. (#3132)
- ``writers.las`` now accepts the ``filename`` key in the ``vlrs``
option to import VLR data from files. (#3146)
- ``filters.transformation`` now provides the ``invert`` option to
apply the inverse of the provided ``matrix``. (#3126)
- ``readers.ept`` now returns a clipped boundary in the summary to
match the behavior of the point count. (#3168)
- ``filters.head`` is now streamable.
- ``readers.i3s`` is now streamable.
- ``readers.slpk`` no longer expands the source file into a temporary
directory.
- ``filters.assign`` added the ``value`` option to allow standard
expression-based conditional assignment of values.(#1468)
- ``readers.tiledb`` and ``writers.tiledb`` now support TileDB version
2 and duplicate points when using version 2 of TileDB. (#3030, #3047)
Bug Fixes
=========
- A problem where the classifications of voting points were being
changed in ``filters.neighborclassifier`` has been fixed. (#3210)
- Fixed an issue where NITF-wrapped LAS files may fail to open (#3010)
- Reading and writing of E57 files over 2GB in size on Windows has been
fixed. (#3000)
- Fixed various compilations issues in ``filters.matlab``. (#3013)
- Added better handling for some cases of coordinate transformation
failure. (#3009)
- An error in calculating position for some data in ``filters.smrf``
has been fixed. (#3069)
- An error in calculating neighbors for isolated points in
``filters.smrf`` has been fixed. (#3071)
- ``readers.las`` now creates dimensions ``ScanChannel`` and
``ClassFlags`` only when reading point formats 6-10. It used to
create them for any version 1.4 file. (#3092)
- ``filters.poisson`` now throws exceptions instead of calling
``exit()`` when it encounters a fatal error. (#3094)
- Errors that could occur in ``gdal::Raster::statistics()`` are now
returned to the caller, rather than resulting in a crash. (#3097)
- ``pdal tindex`` now ensures that traditional GIS axis order is used.
(#3099)
- ``readers.tindex`` now uses the file SRS rather than the tile index
column SRS unless overridden by the ``srs_column`` option. (#3012)
- An error in ``readers.ept`` that could create bad data when both the
``bounds`` and ``addons`` options were specified has been fixed.
(#3054)
- ``filters.hag_nn`` and ``filter.hag_delaunay`` now log an error
rather than terminate if no ground points are found. (#3112)
- An error in reporting point count was when the number of points
exceeded the maximum 32-bit value in ``readers.ept`` has been fixed.
(#3120)
- ``pdal tindex`` now stores WKT instead of EPSG codes to handle
vertical SRS instances. (#3100)
- A bug in ``filters.crop`` that didn’t properly handle 2D cropping has
been fixed. (#3115)
- ``readers.text`` now properly handles quoted dimension names in the
header. (#2201)
- Windows-style directory separators are now properly handled in cases
using relative filenames. (#2936)
- An exception reading E57 points with a transform has been fixed.
(#3163)
- Fix a failure in ``readers.pcd`` when preview() was called before
execute(). (#3169)
- The compression level for ``writers.tiledb`` is now properly set to
7. (#3198)
- An issue where ``filters.neighborclassifier`` would modify
classifications as it calculated them has been fixed. (#3210)
- An extra comma was written using ``readers.text`` when creating
GEOJson output. This has been fixed. (#3204)
================================================================================
2.1.0
================================================================================
Changes of Note
===============
- The X, Y and Z dimensions are now always stored internally as
double-precision floating point. This was normally case previously,
but it is now enforced. (#2892)
- The interface include file directory is now set for downstream
projects using cmake, eliminating the need to explicitly set the
location of PDAL header files. (#2262)
- PDAL is now always built using the arbiter library, which is included
in the source distribution.
- ``filters.python`` has been removed from the primary PDAL library and
is part of the `PDAL python <https://pdal.io/python.html>`__ library.
- When the ``bounds`` option of ``filters.crop`` represents a 3D
volume, the filter now does 3D cropping, rather than 2D cropping as
in previous releases. (#2904)
- ``writers.ply`` no longer accepts ``default`` as a valid value for
the ``storage_mode`` option. (#2385)
API User Notes
==============
- Support has been added for range-based iteration of PointView
objects. The dereferenced iterator yields a PointRef object.
- We are now providing private header files as part of the
distribution. The API exposed by these files may change or be
eliminated in a future release. Use of these files may require the
installation of the header files from other packages. The symbols for
some of these functions may not be public, especially on Windows.
- There are now enumerations for classifications (pdal::ClassLabel).
- N-dimensional KD-tree support has been added.
- There are some small API changes (const changes, for example), but
almost all code using the PDAL library should build without
modification.
- We do not guarantee ABI compatibility, though in most cases this
release should be backward compatible.
New Stages
==========
- ``filters.voxeldownsize`` provides streamed support for voxel
filtering. (#2699 - Thanks
`Helix.re <http://https://helixre.com/>`__!)
- ``filters.separatescanline`` splits input into separate output point
views based on associated scan lines. (#2724 - Thanks Guilhem
Villemin)
- ``filters.farthestpointsampling`` add points from the input to the
output one-at-a-time by selecting the point in the input that is the
furthest from any point in the output. (#2761)
- ``filters.skewnessbalancing`` classifies ground points using the
method of Bartels. (#2740)
- ``filters.dbscan`` provides density-based clustering. (#2748)
- ``filters.csf`` provides ground classification of points using the
cloth simulation method of Zhang. (#2765)
- ``readers.hdf`` provides generic support for many HDF files. (#2934)
- ``filters.hag_nn``, ``filters.hag_delaunay`` and ``filters.hag_dem``
have been created to replace ``filters.hag``. (#2886)
Deprecated Stages
=================
- ``filters.hag`` is deprecated and will be removed in a future
release. Use ``filters.hag_nn``, ``filters.hag_delaunay`` and
``filters.hag_dem`` instead.
Removed Stages
==============
- ``readers.sqlite`` and ``writers.sqlite``
Enhancements
============
- ``readers.ept`` now supports the ``headers`` and ``query`` options to
be forwarded to remote endpoints. (#2690)
- ``readers.ept`` now supports multipolygons for point filtering.
(#2758)
- ``readers.ept`` now supports asynchronous operation when streaming.
(#2772)
- ``readers.ept`` now supports filtering via OGR queries. (#2295)
- ``writers.ept`` now supports Zstandard compression. (#2561)
- ``writers.gdal`` now supports a ``power`` option that can be used to
impact the output of inverse distance weighting mode. (#2550)
- Eliminated an error as exception in ``readers.e57`` in order to
improve performance. (#2721)
- ``readers.rxp`` now supports reading the ``EdgeOfFlightLine``
dimension. (#2367)
- ``filters.randomize`` now has a ``seed`` option to initialize the
random number generator. (#2736)
- ``filters.rdb`` and ``filters.rxp`` now support fetching data from
remote sources.
- ``filters.hexbin`` now has the option ``smooth``, to smooth generated
geometry, and ``preserve_topology`` that forces creation of valid
geometry during the smoothing operation.
- ``filters.transformation`` now has a ``spatialreference`` option to
set the spatial reference of output data. (#2796)
- ``filters.overlay`` now uses the same point-in-polygon algorithm used
by ``filters.crop``. (#2812)
- ``writers.tiledb`` now supports TileDB attribute filters. (#2828)
- Output from ``pdal translate`` can now be directed to the null device
by using either ``devnull`` or ``/dev/null`` as the output filename.
(#2835)
- ``filters.transformation`` now supports providing a filename as the
``matrix`` option if the referenced file contains a matrix that
matches the format supported inline. (#2856)
- ``writers.las`` now allows specification of a ``filesource_id`` as an
option. (#2862)
- ``readers.text`` now handles quoted dimension names in a header line.
(#2201)
- ``pdal info`` now reports the reader used for a file, the current
time and the size of the file. (#2900)
- ``filters.reprojection`` now supports the options
``in_axis_ordering`` and ``out_axis_ordering`` to allow the matching
feature in GDAL 3+ be accessed. (#2916)
- ``filters.normal`` added the ``refine`` option to re-orient normal
vectors using a minimum spanning tree. (#2860)
Bug Fixes
=========
- ``readers.e57`` and ``writers.e57`` now build cleanly on Windows.
- ``writers.pgpointcloud`` no longer uses the wrong schema when
creating a new database and there is an existing database using the
same SRS. (#2692)
- Fixed a potential crash when destroying logs on shutdown. (#2702)
- Fixed a case where ``filters.voxelcentroidnearestneighbor`` could
return points for a voxel that weren’t actually in the voxel. (#2703)
- Fixed a typo in the alternate names of the ``NormalY`` dimension.
(#2723)
- ``filters.divider`` now handles empty input. (#2727)
- An error in calculating variance, standard deviation, skewness and
kurtosis has been fixed in ``filters.stats``. (#2790)
- An error where a list of dimensions would be expanded improperly in
``writers.ply`` under certain API uses. (#2791)
- Crashes in filters using the delaunay triangulation code have been
fixed. (#2805)
- ``writers.pcd`` now always writes dimension names as lowercase.
(#2789)
- The extended VLR offset was not being written to LAS files. This has
been fixed. (#2823)
- Fixed some small memory leaks.
- ``filters.elm`` now works properly when input is an empty point view.
(#2921)
- ``filters.pmf`` now classifies all points either as “Ground” or
“Unclassified”. Points are no longer marked as “Created, Never
Classified”. (#2898)
- LAS VLRs specified in a pipeline are now properly handled by
``writers.las``. (#2937)
- When not building with LASzip or LAZperf, ``writers.las`` would fail
to properly set a spatial reference in some cases. This has been
fixed.
- ``writers.las`` now always uses WKT version 1. In the previous
release it may have used WKT version 2 in some cases. (#2943)
- A bug in ``pdal tile`` where the input spatial reference wasn’t set
on the output has been fixed. (#2976)
================================================================================
2.0.0
================================================================================
Changes of Note
===============
- Python support now requires at least version 3.5+ of Python and
version 1.13 of Numpy.
- ``filters.icp`` is no longer a plugin and provides options not
previously available.
- Linear algebra that was using single-precision math is now using
double-precision math.
- Support was added for GDAL version 3+.
- PCL support has been removed. PCD read/write and ``filters.icp`` is
now natively supported. The PCL filters have been moved to the
`unsupported-plugins <https://github.com/PDAL/unsuppported-plugins>`__
repository for those that might need functionality they provided.
- PDAL now uses a JSON library that doesn’t support comments. If your
pipelines contains non-standard JSON, they will no longer be
accepted.
- PDAL now supports GCC 9.2, clang 8.0.1 and Visual Studio 17
New Stages
==========
- ``filters.covariancefeatures`` computes statistics about features of
points in a neighborhood. (#2455 - Thanks
`Helix.re <http://https://helixre.com/>`__!)
- ``readers.e57`` reads the E57 format. (#2442 - Thanks
`Helix.re <http://https://helixre.com/>`__!)
- ``writers.e57`` writes the E57 format. (#2442 - Thanks
`Helix.re <http://https://helixre.com/>`__!)
- ``writers.gltf`` provides simple glTF mesh output support. (#2643)
- ``filters.reciprocity`` computes the percentage of points that are
considered uni-directional. (#2504 - @chambbj)
- ``filters.miniball`` computes a criterion for neighbors based on the
miniball algorithm. (#2504 - @chambbj)
- ``filters.planefit`` computes a deviation of a point from a manifold
approximating its neighbors. (#2504 - @chambbj)
- ``readers.memory`` provides an API interface for direct reading of
row-oriented point data. (#2620)
- ``filters.projpipeline`` processes point through a `PROJ
pipeline <https://proj.org/operations/transformations/deformation.html>`__.
(#2626 - Thanks @vilaa!)
Deprecated Stages
=================
- readers.sqlite (will be moved to
`unsupported-plugins <https://github.com/PDAL/unsuppported-plugins>`__
in a future release)
- writers.sqlite (will be moved to
`unsupported-plugins <https://github.com/PDAL/unsuppported-plugins>`__
in a future release)
- readers.geowave (will be moved to
`unsupported-plugins <https://github.com/PDAL/unsuppported-plugins>`__
in a future release)
- writers.geowave (will be moved to
`unsupported-plugins <https://github.com/PDAL/unsuppported-plugins>`__
in a future release)
Removed Stages
==============
- ``filters.mongus``
- ``filters.kdistance``
- ``readers.greyhound``
Enhancements
============
- ``readers.mrsid`` now supports more recent versions of the Mr. Sid
SDK. (#2460)
- ``readers.tiledb`` and ``writers.tiledb`` now support stream mode
processing. It also supports an ``append`` option.
- ``readers.ept`` now accepts an optional ``\<spatial reference>``
after the bounds specification in the ``bounds`` option to indicate
the SRS of the provided boundary. (#2295)
- ``filters.hag`` now supports interpolation from a TIN (triangulated
network) of points. (#2520 - Thanks `James
McClain <https://github.com/jamesmcclain>`__!)
- ``filters.poisson`` now properly applies an inverse transform to
points it creates. (#1840)
- ``pdal --drivers`` now shows the file extensions associated with each
driver. It also shows when stages are streamable. (#2571, #2528)
- Some threaded execution has been added to ``readers.ept``.
- Alternate dimension names have been added for “Red”, “Green” and
“Blue” to better support PLY input. (#2570)
Bug Fixes
=========
- Fixed a problem where data in a forwarded LAS VLR would be lost.
(#2542)
- Clear dimension list in ``filters.colorization`` to eliminate the
possibility of writing invalid data. (#2487)
- Delete code that removed control characters when converting to JSON.
(#2355)
- Fixed an issue where nested geometries were being written as invalid
WKT in ``filter.hexbin``. (#2507)
- Fixed a segmentation fault in ``readers.bpf`` if the specified file
didn’t exist. (#2515)
- Fixed an issue in ``writers.gdal`` where interpolation would
terminate if the process hit the raster edge. (#2545)
- Fixed an issue writing JSON when characters needed to be escaped.
(#2558)
- Delaunay triangulation no longer segfaults with fewer than three
points. (#2513)
- Issues with reading binary data with ``filters.ept`` have been fixed.
(#2585)
- ``pdal`` now errors if an option is provided that wasn’t expected.
(#2574)
- Forwarding for scale with multiple LAS inputs was fixed. (#2663)
================================================================================
1.9.1
================================================================================
Version 1.9.1 is a bug fix release.
Bug Fixes
---------
- When writing numerous LAS files with the PDAL API, an internal list
of fields to forward could grow excessively. This has been fixed.
(#2452)
- A computation in ``writers.gdal`` that could overflow with very large
rasters has been fixed. (#2454)
- A bug that could result in the same pipeline tag name being used for
multiple stages of the same type has been fixed. (#2458)
- A potential segmentation fault in ``pdal density`` has been fixed.
(#2461)
- A segmentation fault in ``filters.chipper`` when processing multiple
inputs has been fixed. (#2479)
- An issue with ``readers.ept`` overwriting temporary files before they
weren’t needed has been fixed. (#2474)
- Fixed an issue where ``filters.icp`` would create data that appeared
invalid due to the precision of data when positions weren’t located
near the origin. (#2492)
================================================================================
1.9.0
================================================================================
Changes of Note
===============
- PDAL now requires at least version 2.2 of GDAL.
- Pipelines can optionally be specified as an array of stages (without
an encapsulating “pipeline” object).
- The location of installed cmake files has been changed to match the
cmake convention.
- ``filters.delaunay`` now uses the delaunator library instead of
geogram.
- PDAL no longer depends on the GEOS library. However, some polygon
functions will not work if PDAL isn’t built with a version of the
GDAL library that has GEOS support.
- PDAL now uses the standard cmake script to locate the necessary GDAL
files when building.
- ``readers.sbet`` now reads angles as degrees rather than radians.
(#2354)
- The ``tindex`` command now requires one of the subcommands ``create``
or ``merge``. It no longer accepts the ``merge`` option, which has
been replaced by the ``merge`` subcommand.
- The argument for the function ``PipelineManager::executeStream`` is
now of type ``StreamPointTable&`` instead of ``FixedPointTable&``.
Enhancements
============
- All readers now accept the ``default_srs`` and ``override_srs``
options. ``override_srs`` is an alias for the existing
``spatialreference`` option. ``default_srs`` applies only if no
spatial reference exists in the source file. (#2194, #2195)
- Added some dimension detection capability to ``readers.pts``. (#2317)
- Hardened API use of LASzip in ``writers.las`` for points with data
format 6 and above and set the extended_point_type variable. (#2320,
#2329)
- Support the ``libgeotiff`` path suffix when searching for the geotiff
library with cmake.
- Added a ``resolution`` option to ``readers.ept`` to limit the number
of points read. (#2331)
- ``readers.rxp`` now supports stream mode.
- Added the ``invert`` option to ``filters.head`` and ``filters.tail``.
- Added support for subcommands in kernels. (#2293)
New stages
==========
- ``filters.mongo`` - Filtering of points using the mongo expression
language.
- ``readers.tiledb`` - Reads points from the tileDB database.
- ``writers.tiledb`` - Writes points to the tileDB database.
- ``writers.ept_addon`` - Adds sidecar data to an existing EPT dataset.
Deprecated stages
=================
- ``filters.kdistance`` - Replaced by ``filters.nndistance``.
``filters.kdistance`` will be removed in the next PDAL release.
- ``filters.mongus`` - Replaces by ``filters.pmf`` and ``filters.smrf``
Bug fixes
=========
- The tindex command now uses sufficient precision when using the
``fast_boundary`` option (#2271)
- ``filters.smrf`` and ``filters.pmf`` now process all points if the
``NumberOfReturns`` or ``ReturnNumber`` dimension is missing. This
fixes a regression introduced with PDAL 1.8. (#2275)
- The density command is now found by pdal. This fixes a regression
introduced with PDAL 1.8. (#2378)
- The ``scale=auto`` and ``offset=auto`` options now work with
``writers.bpf`` in stream mode. (#1983)
- Pipelines with diamond shapes now properly re-execute ancestor
stages. This fixes a regression introduced with PDAL 1.8. (#2290)
- ``filters.crop`` now uses the correct logic when the ``outside``
option is used in standard mode. (#2305)
- A bug in ``writers.gdal`` with streaming mode that caused an improper
location shift in some instances has been fixed. (#2292)
- Added an explicit dependency on the arbiter library for curl. This
fixes build issues on some Unix platforms. (#1822)
- Fixed a bug in ``filters.icp`` introduced by a change in PCL (see:
https://github.com/PointCloudLibrary/pcl/issues/2724) that improperly
removed a function call. (#2319)
- ``readers.tindex`` now provides a default of “EPSG:4326” for the
``filter_srs`` option. (#2316)
- Points in buffer corners are now properly placed in tiles in
``filters.splitter``. (#2372)
- Fixed reference counting in ``filters.python`` that might have caused
a crash in some circumstances.
- Generalized the python library re-loaded by PDAL when being used as a
python extension. This is only relevant on some Unix distributions.
================================================================================
1.8.0
================================================================================
Changes of Note
===============
- PointTableRef is now publicly accessible from PointView (#1926)
- Minimum CMake version is now 3.5
- ``filters.hexbin`` is now a built-in stage, rather than a plugin.
(#2001)
- Removed support for ``ght`` compression in ``writers.pgpointcloud``.
(#2148)
- On OSX, plugins are now installed with ID of ``@rpath`` rather than
``@loader_path/../lib``
Enhancements
============
- Added ``denoise`` and ``reset`` options to ``pdal ground``. (#1579)
- ``readers.gdal`` now supports stream mode and provides the ``header``
option to map dimensions. It also supports fetching bounds without
reading the entire file. (#1819)
- ``readers.mbio`` added ``datatype`` option to support reading
sidescan data. (#1852)
- ``filters.stats`` was computing expensive kurtosis and skewness
statistics by default. These statistics are now available with the
``advanced`` option. (#1878)
- Added backtrace support for alpine linux-based Docker containers.
(#1904)
- Added a ``condition`` option for ``filters.assign`` to limit
assignment. (#1956)
- Add access to artifact manager keys. (#2026)
- Added support for LAZ compression in ``writers.pgpointcloud`` (#2050)
- Replaced ``last`` option with ``returns`` to support more flexible
segmentation in ``filters.smrf`` and ``filters.pmf``. (#2053)
- ``writers.text`` now supports stream mode. (#2064)
- Added ``pdal tile`` kernel with streaming support to conveniently
tile data. (#2065)
- A KD-tree used in one filter will now be reused in subsequent filters
when possible. (#2123)
- ``writers.ply`` now has a ``precision`` option to specify output
precision. (#2144)
- ``filters.smrf`` and ``filters.pmf`` supports complete range syntax
for the ``ignore`` option. (#2157)
- ``filters.hexbin`` now supports stream mode. (#2170)
- ``readers.numpy`` now has the ``order`` option, which replaces the
previous ``x``, ``y`` and ``z`` options. It also supports structured
numpy arrays and maps values to the X, Y and Z dimensions
accordingly.
- All readers now support setting a spatial reference to override any
in the data with the ``spatialreference`` option.
- Add support for unicode filenames in pipelines on Windows platforms.
- Added NumpyReader::setArray() to support direct setting of a numpy
array into ``readers.numpy``.
- Added StreamPointTable::setNumPoints() and support in
Streamable::execute() allowing custom point tables to know the number
of points in each pass through the point table.
- Added SpatialReference::isProjected() to allow callers to determine
if a spatial reference specifies a projection. Also added
SpatialReference::identifyHorizontalEPSG() and
SpatialReference::identifyVerticalEPSG() to return an EPSG code from
a spatial reference if possible.
- Added support for reading BPF files stored remotely.
New stages
==========
- ``readers.rdb`` - Support reading RIEGL RDB data.
- ``readers.i3s`` - Support reading of web service-style Esri I3S point
clouds.
- ``readers.slpk`` - Support reading of file-based I3S-style point
clouds.
- ``writers.fbx`` - Experimental Unity engine (SDK required) support.
(#2127)
- ``filters.nndistance`` - Replaces ``filters.kdistance`` and adds
average distance support. (#2071)
- ``filters.dem`` - Filter data based on bounds relative to a raster
value. (#2090)
- ``filters.delaunay`` - Create a delauany triangulation of a point
cloud. (#1855)
- ``filters.info`` - Generate metadata about an input point set. Used
by ``pdal info``.
Deprecated stages
=================
- ``filters.kdistance`` - Replaced by ``filters.nndistance``.
Bug fixes
=========
- Fixed an incorrect error message suggesting there were multiple SRSs
in some cases when reading multiple inputs. (#2009)
- Fixed a problem in ``filters.reprojection`` in stream mode that would
improperly reproject when there were multiple input sources with
differing SRSs. (#2058)
- Fixed a problem in stream mode where a stage with no SRS would
override the active SRS during processing. (#2069)
- Fixed a problem in ``writers.gdal`` where output would be aggregated
if multiple inputs were provided. (#2074)
- The ``count`` option was not respected in stream mode. It now
properly limits the number of points read. (#2086)
- Fixed an off-by-one error that could create improper values in
``writers.gdal``. Most data differences were small and not usually
problematic. (#2095)
- Multiple option values can be specified on the command line by
repeating the option assignment. (#2114)
- Added a missing initialization in ``filters.returns`` that could
cause more point views to be returned than requested. (#2115)
- Emit an error if the ``count`` option isn’t set for ``readers.faux``.
(#2128)
- PipelineManager::getStage() now returns a proper leaf node. (#2149)
- Fixed logic for ``filters.crop`` in streaming mode with multiple crop
areas that could return too few points. (#2198)
- Added the ``minimal`` option for ``readers.rxp`` that was documented
but not fully implemented. (#2225)
- Fixed an error in failing to read all points in ``readers.rxp``
exposed with a newer SDK. (#2226)
- Fixed an error in fetching floating point data from a PointContainer
when the value was NaN. (#2239)
================================================================================
1.7.0
================================================================================
Changes of Note
===============
- ``filter.ferry`` now creates output dimensions with the same type as
the input dimension. It also takes an arrow ‘=>’ in addition to ‘=’
in the ``--dimension`` specification.
- ``filters.hexbin`` now falls back to slow boundary creation if no
bounds information exists to do fast boundary creation.
- Dimension names can now contain the forward slash (‘/’) character.
- ``readers.gdal`` and ``filters.colorization`` now attempt to create
dimensions with the type of the associated raster.
- The Python PDAL extension code was removed from the PDAL source tree
to its own `repository <https://github.com/PDAL/python>`__.
- The JAVA PDAL interface was remove from the PDAL source tree to its
own `repository <https://github.com/PDAL/java>`__.
- ``pdal pipeline``\ and ``pdal translate`` now use stream mode if the
operation being performed is streamable. An option ``--nostream`` has
been added to both commands to prevent the use of stream mode. The
``--stream`` option of ``pdal pipeline`` is now obsolete and ignored.
- A new interface has been provided for the creation of plugins
requiring less boilerplate code. There has been no API change.
- Stages and pipelines can now be tested to check whether they are
streamable.
Enhancements
============
- Added options ``--timegap`` and ``--speedmin`` to ``readers.mbio`` to
allow configuration of which points should be read.
- Added support for compression schemes (xz, lzma, zstd) and created a
standardized interface (#1722).
- ``writers.bpf`` now supports the option ``auto`` for the ``coord_id``
option to allow the UTM zone to be set from the spatial reference if
possible (#1723).
- Added the ability read stage-specific options from a file with the
``--option_file`` option (#1641).
- Replace the GDAL point-in-polygon with a much faster implementation
in ``filters.crop``.
- Add a ``--reverse`` option to ``filters.mortonorder`` to provide a
point ordering for good dispersal.
- ``readers.bpf`` now supports the TCR (ECEF - earth centered, earth
fixed) coordinate system.
- Added option ``--use_eb_vlr`` to allow ``readers.las`` to interpret
an extra bytes VLR as if the file were version 1.4 even if it’s using
an earlier LAS version.
- ``readers.text`` added options ``--header`` and ``--skip`` to provide
an alternative header line and to allow skipping lines before reading
the header, respectively.
- ``writers.text`` now supports the ability to specify individual
dimension precision using a colon (‘:’) and integer following the
dimension name in the ``--order`` option.
- ``readers.numpy`` adds support for reading from Numpy (.npy) save
files.
- ``pdal info`` now provides the ``--enumerate`` option. See the
documentation for
`filters.stats <https://pdal.io/stages/filters.stats.html>`__ for
details.
- Added a general option ``--logtiming`` to cause log output to contain
the elapsed time from the start of the program. (#1882)
Documentation
=============
- Added a description of the Alpine Linux environment used for Travis
and Docker.
- Updated the documentation for building PDAL on Windows.
- Added an example of how to loop files with PowerShell.
- Corrected output shown in the documentation for ``filters.hexbin``.
- Reorganized the stages landing page to make it easier to find.
(#1880)
New stages
==========
- ``readers.greyhound`` - Allows reading points from a source using the
`greyhound <https://github.com/hobu/greyhound>`__ protocol.