ign-pdal-tools 1.7.8__py3-none-any.whl → 1.7.10__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,10 +1,11 @@
1
- Metadata-Version: 2.2
1
+ Metadata-Version: 2.4
2
2
  Name: ign-pdal-tools
3
- Version: 1.7.8
3
+ Version: 1.7.10
4
4
  Summary: Library for common LAS files manipulation with PDAL
5
5
  Author-email: Guillaume Liegard <guillaume.liegard@ign.fr>
6
6
  Description-Content-Type: text/markdown
7
7
  License-File: LICENSE.md
8
+ Dynamic: license-file
8
9
 
9
10
  # ign-pdal-tools
10
11
 
@@ -1,7 +1,8 @@
1
- pdaltools/_version.py,sha256=_9dnWGQSoerUjXo6a6mDsI_oUJbf9SP5h2HkjA-Zd9E,74
1
+ ign_pdal_tools-1.7.10.dist-info/licenses/LICENSE.md,sha256=iVzCFZTUXeiqP8bP474iuWZiWO_kDCD4SPh1Wiw125Y,1120
2
+ pdaltools/_version.py,sha256=2hMdkmuq8cBrwb79NJB3d8dhjK2v9egMpm_KrdD0S3o,75
2
3
  pdaltools/add_points_in_las.py,sha256=TGbt5JUkszjmbQiA2LCUntsjz6A8DHb7QPIXGDuEgWA,3643
3
- pdaltools/add_points_in_pointcloud.py,sha256=g9V_gUA-vOy3wuYdWXFSObDZtSKO2LhzXa5Vy-yypuA,5684
4
- pdaltools/color.py,sha256=PSdtMMdsapOtgzojdnaKVx6IxbKOaN2xP9mScAbCGm0,8629
4
+ pdaltools/add_points_in_pointcloud.py,sha256=lstU-iO4fkHAm8gqNSEyc3sELApqMLLvtJQ9IDQmUrM,12328
5
+ pdaltools/color.py,sha256=-a0ramyLMkZX4-M3siPq1zIio5u-a0p8UzvgcfoU6zU,8313
5
6
  pdaltools/las_add_buffer.py,sha256=sBpTywlfsHHS8KuCUa-eydB2hylshEvjrMQt5TrqXb8,11275
6
7
  pdaltools/las_clip.py,sha256=GvEOYu8RXV68e35kU8i42GwSkbo4P9TvmS6rkrdPmFM,1034
7
8
  pdaltools/las_info.py,sha256=lMKxKzsViptDENI1wOlANG4qOvdc19ixyasYKD-N1ck,9512
@@ -11,8 +12,7 @@ pdaltools/pcd_info.py,sha256=NIAH5KGikVDQLlbCcw9FuaPqe20UZvRfkHsDZd5kmZA,3210
11
12
  pdaltools/replace_attribute_in_las.py,sha256=po1F-fi8s7iilqKWaryW4JRbsmdMOUe0yGvG3AEKxtk,4771
12
13
  pdaltools/standardize_format.py,sha256=gqm2GJbtDkT4k4oC_NX2LIPh9R2BLh4sMHLKYgfKrMc,3973
13
14
  pdaltools/unlock_file.py,sha256=pIThdWMNkTph0xgJVVRaM1o9aUMQhM6804PscScB3JI,1963
14
- ign_pdal_tools-1.7.8.dist-info/LICENSE.md,sha256=iVzCFZTUXeiqP8bP474iuWZiWO_kDCD4SPh1Wiw125Y,1120
15
- ign_pdal_tools-1.7.8.dist-info/METADATA,sha256=BW25glZH1wZ1Ntgp6MQbPa_iMJZrJNBTs_acW7AxVYg,5722
16
- ign_pdal_tools-1.7.8.dist-info/WHEEL,sha256=jB7zZ3N9hIM9adW7qlTAyycLYW9npaWKLRzaoVcLKcM,91
17
- ign_pdal_tools-1.7.8.dist-info/top_level.txt,sha256=KvGW0ZzqQbhCKzB5_Tp_buWMZyIgiO2M2krWF_ecOZc,10
18
- ign_pdal_tools-1.7.8.dist-info/RECORD,,
15
+ ign_pdal_tools-1.7.10.dist-info/METADATA,sha256=8JpuSz74R6IiEbQ1XvonH1en-FI1gdzMNTzp-8Li1yY,5745
16
+ ign_pdal_tools-1.7.10.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
17
+ ign_pdal_tools-1.7.10.dist-info/top_level.txt,sha256=KvGW0ZzqQbhCKzB5_Tp_buWMZyIgiO2M2krWF_ecOZc,10
18
+ ign_pdal_tools-1.7.10.dist-info/RECORD,,
@@ -1,5 +1,5 @@
1
1
  Wheel-Version: 1.0
2
- Generator: setuptools (75.8.2)
2
+ Generator: setuptools (78.1.0)
3
3
  Root-Is-Purelib: true
4
4
  Tag: py3-none-any
5
5
 
pdaltools/_version.py CHANGED
@@ -1,4 +1,4 @@
1
- __version__ = "1.7.8"
1
+ __version__ = "1.7.10"
2
2
 
3
3
 
4
4
  if __name__ == "__main__":
@@ -6,14 +6,16 @@ import laspy
6
6
  import numpy as np
7
7
  from pyproj import CRS
8
8
  from pyproj.exceptions import CRSError
9
- from shapely.geometry import box
9
+ from shapely.geometry import MultiPoint, Point, box
10
10
 
11
11
  from pdaltools.las_info import get_epsg_from_las, get_tile_bbox
12
12
 
13
13
 
14
14
  def parse_args(argv=None):
15
15
  parser = argparse.ArgumentParser("Add points from GeoJSON in LIDAR tile")
16
- parser.add_argument("--input_geojson", "-ig", type=str, required=True, help="Input GeoJSON file")
16
+ parser.add_argument(
17
+ "--input_geometry", "-ig", type=str, required=True, help="Input Geometry file (GeoJSON or Shapefile)"
18
+ )
17
19
  parser.add_argument("--input_las", "-i", type=str, required=True, help="Input las file")
18
20
  parser.add_argument("--output_las", "-o", type=str, required=True, default="", help="Output las file")
19
21
  parser.add_argument(
@@ -35,48 +37,91 @@ def parse_args(argv=None):
35
37
  default=1000,
36
38
  help="width of tiles in meters",
37
39
  )
40
+ parser.add_argument(
41
+ "--spacing",
42
+ type=float,
43
+ default=0.25,
44
+ help="spacing between generated points in meters (default. 25 cm)",
45
+ )
46
+ parser.add_argument(
47
+ "--altitude_column",
48
+ "-z",
49
+ type=str,
50
+ required=False,
51
+ default=None,
52
+ help="altitude column name from input geometry (use point.z if altitude_column is not set)",
53
+ )
38
54
 
39
55
  return parser.parse_args(argv)
40
56
 
41
57
 
42
- def clip_3d_points_to_tile(input_points: str, input_las: str, crs: str, tile_width: int) -> gpd.GeoDataFrame:
58
+ def clip_3d_lines_to_tile(
59
+ input_lines: gpd.GeoDataFrame, input_las: str, crs: str, tile_width: int = 1000
60
+ ) -> gpd.GeoDataFrame:
43
61
  """
44
- Add points from a GeoJSON file in the LIDAR's tile.
62
+ Select lines from a GeoDataFrame that intersect the the LIDAR tile.
45
63
 
46
64
  Args:
47
- input_points (str): Path to the input GeoJSON file with 3D points.
65
+ input_lines (gpd.GeoDataFrame): GeoDataFrame with lines.
48
66
  input_las (str): Path to the LIDAR `.las/.laz` file.
49
67
  crs (str): CRS of the data.
50
68
  tile_width (int): Width of the tile in meters (default: 1000).
51
69
 
52
- Return:
53
- gpd.GeoDataFrame: Points 2d with "Z" value
70
+ Returns:
71
+ gpd.GeoDataFrame: Lines that intersect with the tile.
54
72
  """
55
73
  # Compute the bounding box of the LIDAR tile
56
74
  tile_bbox = get_tile_bbox(input_las, tile_width)
57
75
 
58
- # Read the input GeoJSON with 3D points
59
- points_gdf = gpd.read_file(input_points)
76
+ if crs:
77
+ input_lines = input_lines.to_crs(crs)
78
+
79
+ # Create a polygon from the bounding box
80
+ bbox_polygon = box(*tile_bbox)
81
+
82
+ # Clip the lines to the bounding box
83
+ clipped_lines = input_lines[input_lines.intersects(bbox_polygon)]
84
+
85
+ return clipped_lines
86
+
87
+
88
+ def clip_3d_points_to_tile(
89
+ input_points: gpd.GeoDataFrame, input_las: str, crs: str, tile_width: int = 1000
90
+ ) -> gpd.GeoDataFrame:
91
+ """
92
+ Select points from a GeoDataFrame that intersect the LIDAR tile
93
+
94
+ Args:
95
+ input_points (gpd.GeoDataFrame): GeoDataFrame with 3D points.
96
+ input_las (str): Path to the LIDAR `.las/.laz` file.
97
+ crs (str): CRS of the data.
98
+ tile_width (int): Width of the tile in meters (default: 1000).
99
+
100
+ Return:
101
+ gpd.GeoDataFrame: Points 2D with "Z" value
102
+ """
103
+ # Compute the bounding box of the LIDAR tile
104
+ tile_bbox = get_tile_bbox(input_las, tile_width)
60
105
 
61
106
  if crs:
62
- points_gdf = points_gdf.to_crs(crs)
107
+ input_points = input_points.to_crs(crs)
63
108
 
64
109
  # Create a polygon from the bounding box
65
110
  bbox_polygon = box(*tile_bbox)
66
111
 
67
112
  # Clip the points to the bounding box
68
- clipped_points = points_gdf[points_gdf.intersects(bbox_polygon)].copy()
113
+ clipped_points = input_points[input_points.intersects(bbox_polygon)]
69
114
 
70
115
  return clipped_points
71
116
 
72
117
 
73
118
  def add_points_to_las(
74
- input_points_with_z: gpd.GeoDataFrame, input_las: str, output_las: str, crs: str, virtual_points_classes=66
119
+ input_points_with_z: gpd.GeoDataFrame, input_las: str, output_las: str, crs: str, virtual_points_classes: int = 66
75
120
  ):
76
121
  """Add points (3D points in LAZ format) by LIDAR tiles (tiling file)
77
122
 
78
123
  Args:
79
- input_points_with_z(gpd.GeoDataFrame): geometry columns (2D points) as encoded to WKT.
124
+ input_points_with_z (gpd.GeoDataFrame): geometry columns (3D points) as encoded to WKT.
80
125
  input_las (str): Path to the LIDAR tiles (LAZ).
81
126
  output_las (str): Path to save the updated LIDAR file (LAS/LAZ format).
82
127
  crs (str): CRS of the data.
@@ -94,7 +139,7 @@ def add_points_to_las(
94
139
  # Extract XYZ coordinates and additional attribute (classification)
95
140
  x_coords = input_points_with_z.geometry.x
96
141
  y_coords = input_points_with_z.geometry.y
97
- z_coords = input_points_with_z.RecupZ
142
+ z_coords = input_points_with_z.geometry.z
98
143
  classes = virtual_points_classes * np.ones(len(input_points_with_z.index))
99
144
 
100
145
  with laspy.open(input_las, mode="r") as las:
@@ -126,29 +171,156 @@ def add_points_to_las(
126
171
  writer.write_points(updated_las.points)
127
172
 
128
173
 
129
- def add_points_from_geojson_to_las(
130
- input_geojson: str, input_las: str, output_las: str, virtual_points_classes: int, spatial_ref: str, tile_width: int
174
+ def line_to_multipoint(line, spacing: float, z_value: float = None):
175
+ """
176
+ Convert a LineString to a MultiPoint with equally spaced points and a given Z value.
177
+
178
+ Args:
179
+ line (shapely.geometry.LineString): The input LineString.
180
+ spacing (float): Spacing between generated points in meters.
181
+ z_value (float): The Z value to assign to each point.
182
+
183
+ Returns:
184
+ shapely.geometry.MultiPoint: A MultiPoint geometry with the generated points.
185
+ """
186
+ # Create points along the line with spacing
187
+ length = line.length
188
+ distances = np.arange(0, length + spacing, spacing)
189
+ points_nd = [line.interpolate(distance) for distance in distances]
190
+
191
+ if line.has_z:
192
+ multipoint = MultiPoint([Point(point.x, point.y, point.z) for point in points_nd])
193
+ else:
194
+ if z_value is None:
195
+ raise ValueError("z_value must be provided for 2D lines.")
196
+ multipoint = MultiPoint([Point(point.x, point.y, z_value) for point in points_nd])
197
+
198
+ return multipoint
199
+
200
+
201
+ def generate_3d_points_from_lines(
202
+ lines_gdf: gpd.GeoDataFrame, spacing: float, altitude_column: str = None
203
+ ) -> gpd.GeoDataFrame:
204
+ """
205
+ Generate regularly spaced 3D points from 2.5D lines in a GeoJSON file.
206
+
207
+ Args:
208
+ lines_gdf (gpd.GeoDataFrame): GeoDataFrame with 2.5D lines.
209
+ spacing (float): Spacing between generated points in meters.
210
+ altitude_column (str, optional): Altitude column name from input geometry.
211
+ If not provided, use Z from geometry.
212
+
213
+ Returns:
214
+ gpd.GeoDataFrame: GeoDataFrame with generated 3D points.
215
+
216
+ Raises:
217
+ ValueError: If altitude_column is not provided or not found in the GeoDataFrame
218
+ and Z coordinates are not available in the geometry.
219
+ """
220
+ # Check if altitude_column is provided and exists in the GeoDataFrame
221
+ if altitude_column and (altitude_column not in lines_gdf.columns):
222
+ raise ValueError("altitude_column must exist in the GeoDataFrame if provided.")
223
+
224
+ if altitude_column:
225
+ lines_gdf["geometry"] = lines_gdf.apply(
226
+ lambda row: line_to_multipoint(row.geometry, spacing, row[altitude_column]), axis=1
227
+ )
228
+ else:
229
+ # Check if geometries have Z values
230
+ if lines_gdf.geometry.has_z.any():
231
+ lines_gdf["geometry"] = lines_gdf.apply(
232
+ lambda row: line_to_multipoint(row.geometry, spacing, None), axis=1
233
+ )
234
+ else:
235
+ raise ValueError("Geometries do not have Z values and altitude_column is not provided.")
236
+
237
+ # Explode the MultiPoint geometries into individual points
238
+ points_gdf = lines_gdf.dissolve().explode(index_parts=False).reset_index(drop=True)
239
+
240
+ return points_gdf
241
+
242
+
243
+ def add_points_from_geometry_to_las(
244
+ input_geometry: str,
245
+ input_las: str,
246
+ output_las: str,
247
+ virtual_points_classes: int,
248
+ spatial_ref: str,
249
+ tile_width: int,
250
+ spacing: float,
251
+ altitude_column: str,
131
252
  ):
132
- """Add points with Z value(GeoJSON format) by LIDAR tiles (tiling file)
253
+ """Add points with Z value by LIDAR tiles (tiling file)
133
254
 
134
255
  Args:
135
- input_geojson (str): Path to the input GeoJSON file with 3D points.
256
+ input_geometry (str): Path to the input geometry file (GeoJSON or Shapefile) with 3D points.
136
257
  input_las (str): Path to the LIDAR `.las/.laz` file.
137
258
  output_las (str): Path to save the updated LIDAR file (LAS/LAZ format).
138
259
  virtual_points_classes (int): The classification value to assign to those virtual points (default: 66).
139
260
  spatial_ref (str): CRS of the data.
140
261
  tile_width (int): Width of the tile in meters (default: 1000).
262
+ spacing (float): Spacing between generated points in meters.
263
+ altitude_column (str): Altitude column name from input geometry
141
264
 
142
265
  Raises:
143
266
  RuntimeError: If the input LAS file has no valid EPSG code.
267
+ ValueError: Unsupported geometry type in the input Geometry file OR
268
+ The parameters "spacing" <= 0.
144
269
  """
145
270
  if not spatial_ref:
146
271
  spatial_ref = get_epsg_from_las(input_las)
147
272
  if spatial_ref is None:
148
273
  raise RuntimeError(f"LAS file {input_las} does not have a valid EPSG code.")
149
274
 
275
+ # Read the input GeoJSON
276
+ gdf = gpd.read_file(input_geometry)
277
+
278
+ if gdf.crs is None:
279
+ gdf.set_crs(epsg=spatial_ref, inplace=True)
280
+
281
+ # Check if both Z in geometries and altitude_column are provided
282
+ if gdf.geometry.has_z.any() and altitude_column:
283
+ raise ValueError("Both Z in geometries and altitude_column are provided. Please provide only one.")
284
+
285
+ # Store the unique geometry type in a variable
286
+ unique_geom_type = gdf.geometry.geom_type.unique()
287
+
288
+ # Check the geometry type
289
+ if len(unique_geom_type) != 1:
290
+ raise ValueError("Several geometry types found in geometry file. This case is not handled.")
291
+
292
+ if unique_geom_type in ["Point", "MultiPoint"]:
293
+ gdf = gdf.explode(index_parts=False).reset_index(drop=True)
294
+ if altitude_column:
295
+ # Add the Z dimension from the 'RecupZ' property
296
+ gdf["geometry"] = gdf.apply(
297
+ lambda row: Point(row["geometry"].x, row["geometry"].y, row[altitude_column]), axis=1
298
+ )
299
+ # If the geometry type is Point, use the points directly
300
+ points_gdf = gdf[["geometry"]]
301
+ else:
302
+ # Add the Z dimension from the Geometry Z
303
+ gdf["geometry"] = gdf.apply(
304
+ lambda row: Point(row["geometry"].x, row["geometry"].y, row["geometry"].z), axis=1
305
+ )
306
+ # If the geometry type is Point, use the points directly
307
+ points_gdf = gdf[["geometry"]]
308
+ elif unique_geom_type in ["LineString", "MultiLineString"]:
309
+ gdf = gdf.explode(index_parts=False).reset_index(drop=True)
310
+ gdf = clip_3d_lines_to_tile(gdf, input_las, spatial_ref, tile_width)
311
+ # If the geometry type is LineString, generate 3D points
312
+ if spacing <= 0:
313
+ raise NotImplementedError(
314
+ f"add_points_from_geometry_to_las requires spacing > 0 to run on (Multi)LineString geometries, \
315
+ but the values provided are geometry type: {unique_geom_type} and spacing = {spacing} "
316
+ )
317
+ else:
318
+ points_gdf = generate_3d_points_from_lines(gdf, spacing, altitude_column)
319
+ else:
320
+ raise ValueError("Unsupported geometry type in the input Geometry file.")
321
+
150
322
  # Clip points from GeoJSON by LIDAR tile
151
- points_clipped = clip_3d_points_to_tile(input_geojson, input_las, spatial_ref, tile_width)
323
+ points_clipped = clip_3d_points_to_tile(points_gdf, input_las, spatial_ref, tile_width)
152
324
 
153
325
  # Add points by LIDAR tile and save the result
154
326
  add_points_to_las(points_clipped, input_las, output_las, spatial_ref, virtual_points_classes)
@@ -156,4 +328,4 @@ def add_points_from_geojson_to_las(
156
328
 
157
329
  if __name__ == "__main__":
158
330
  args = parse_args()
159
- add_points_from_geojson_to_las(**vars(args))
331
+ add_points_from_geometry_to_las(**vars(args))
pdaltools/color.py CHANGED
@@ -37,15 +37,9 @@ def retry(times, delay, factor=2, debug=False):
37
37
  need_retry = False
38
38
  try:
39
39
  return func(*args, **kwargs)
40
- except requests.exceptions.ConnectionError as err:
40
+ except requests.exceptions.RequestException as err:
41
41
  print("Connection Error:", err)
42
42
  need_retry = True
43
- except requests.exceptions.HTTPError as err:
44
- if "Server Error" in str(err):
45
- print("HTTP Error:", err)
46
- need_retry = True
47
- else:
48
- raise err
49
43
  if need_retry:
50
44
  print(f"{attempt}/{times} Nouvel essai après une pause de {pretty_time_delta(new_delay)} .. ")
51
45
  if not debug:
@@ -126,8 +120,7 @@ def color(
126
120
 
127
121
  writer_extra_dims = "all"
128
122
 
129
- # apply decorator to retry 3 times, and wait 30 seconds each times
130
- download_image_from_geoplateforme_retrying = retry(7, 15, 2)(download_image_from_geoplateforme)
123
+ download_image_from_geoplateforme_retrying = retry(times=9, delay=5, factor=2)(download_image_from_geoplateforme)
131
124
 
132
125
  if veget_index_file and veget_index_file != "":
133
126
  print(f"Remplissage du champ Deviation à partir du fichier {veget_index_file}")