File: index.rst

package info (click to toggle)
python-laspy 2.5.4-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 3,928 kB
  • sloc: python: 9,065; makefile: 20
file content (79 lines) | stat: -rw-r--r-- 1,890 bytes parent folder | download
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
.. laspy documentation master file, created by
   sphinx-quickstart on Wed Mar 28 09:00:58 2018.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

===========================================
laspy: Python library for lidar LAS/LAZ IO.
===========================================

`LAS`_ (and its compressed counterpart LAZ), is a popular format for lidar pointcloud and full waveform,
laspy reads and writes these formats and provides a Python API via Numpy Arrays.

.. _LAS: https://www.asprs.org/committee-general/laser-las-file-format-exchange-activities.html


Here is an example of reading in LAZ data and getting some simple summaries of the pointcloud:

.. testcode::

    import numpy as np
    import laspy

    with laspy.open('laspytests/data/simple.laz') as fh:
        print('Points from Header:', fh.header.point_count)
        las = fh.read()
        print(las)
        print('Points from data:', len(las.points))
        ground_pts = las.classification == 2
        bins, counts = np.unique(las.return_number[ground_pts], return_counts=True)
        print('Ground Point Return Number distribution:')
        for r,c in zip(bins,counts):
            print('    {}:{}'.format(r,c))
        

Would output:

.. testoutput::

    Points from Header: 1065
    <LasData(1.2, point fmt: <PointFormat(3)>, 1065 points, 0 vlrs)>
    Points from data: 1065
    Ground Point Return Number distribution:
        1:239
        2:25
        3:11
        4:1


User Guide
==========

.. toctree::
    :maxdepth: 2

    installation
    intro
    basic
    examples
    complete_tutorial
    lessbasic
    migration
    changelog
    contributing


API Documentation
=================

.. toctree::
   :maxdepth: 2

   api/index

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`