← Back to branch summary

~ubuntu-branches/ubuntu/trusty/liblas/trusty-proposed

« back to all changes in this revision

Viewing changes to doc/utilities/lasblock.txt

  • Committer: Package Import Robot
  • Author(s): Francesco Paolo Lovergine
  • Date: 2014-01-05 17:00:29 UTC
  • mfrom: (7.1.2 sid)
  • Revision ID: package-import@ubuntu.com-20140105170029-ddtp0j63x5jvck2u
Tags: 1.7.0+dfsg-2
http://bugs.debian.org/733282
Fixed missing linking of system boost component.
(closes: #733282)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/utilities/lasblock.txt
 
1
 
 
2
.. raw:: pdf
 
3
 
 
4
    PageBreak
 
5
    
 
6
.. _lasblock:
 
7
    
 
8
****************************************************************
 
9
  lasblock
 
10
****************************************************************
 
11
 
 
12
:Author: Howard Butler
 
13
:Contact: hobu.inc at gmail.com
 
14
 
 
15
 
 
16
lasblock is a utility for pre-processing an LAS file into "chips" or "blocks".  
 
17
These blocks are a custom point partitioning process that aims to optimize 
 
18
the fill capacity, shape, and speed of processing.  More specifically, 
 
19
it attempts to keep the blocks as full as possible and as square as possible 
 
20
to augment querying characteristics for `Oracle Point Cloud`_. 
 
21
This pre-processing is needed as precursor 
 
22
step in the processing chain that ends with actually loading the data via 
 
23
:ref:`las2oci`.
 
24
 
 
25
 
 
26
Usage
 
27
------------------------------------------------------------------------------
 
28
 
 
29
 
 
30
Block a file, and write out blocks with 6 decimals of precision with 
 
31
a nominal capacity of 3000 points per block:
 
32
 
 
33
::
 
34
 
 
35
    $ lasblock -c 3000  -p 6 myfile.las
 
36
 
 
37
.. note::
 
38
    If no capacity is specified with ``-c``, 10000 is assumed.  
 
39
 
 
40
.. note::
 
41
    lasblock will always write out a myfile.las.kdx file name by default, 
 
42
    but you can override the output name with a ``-o`` command-line switch.
 
43
 
 
44
Arguments
 
45
------------------------------------------------------------------------------
 
46
 
 
47
::
 
48
 
 
49
    Allowed lasblock options:
 
50
      -h [ --help ]                 Produce this help message
 
51
      -c [ --capacity ] arg (=3000) Number of points to nominally put into each 
 
52
                                    block (note that this number will not be exact)
 
53
      -p [ --precision ] arg (=8)   Number of decimal points to write for each bbox
 
54
      -i [ --input ] arg            input LAS file
 
55
      -o [ --output ] arg           The output .kdx file (defaults to input 
 
56
                                    filename + .kdx)
 
57
      -v [ --verbose ]              Verbose message output
 
58
 
 
59
 
 
60
 
 
61
 
 
62
.. figure:: ../images/lasblock_small.png
 
63
    :alt: lasblock output
 
64
 
 
65
.. figure:: ../images/lasblock_big.png
 
66
    :alt: lasblock output
 
67
 
 
68
 
 
69
Format
 
70
------------------------------------------------------------------------------
 
71
 
 
72
lasblock's format is quite simple.  It contains an id, a point count, a 2d block, and 
 
73
a list of all the point ids that exist within that block in a simple text file.
 
74
These files are called ``.kdx`` files for :ref:`las2oci` to be able to 
 
75
consume, but there's nothing preventing you from giving them your own name.
 
76
 
 
77
::
 
78
 
 
79
    id count minx miny maxx maxy {id1 id2 ... idx}
 
80
    0 9686 630250 4834500 630305.47 4834543.1 41357 ...
 
81
    1 9686 630250.01 4834543.1 630305.47 4834617.4 210093 ...
 
82
 
 
83
.. _`Oracle Point Cloud`: http://download.oracle.com/docs/cd/B28359_01/appdev.111/b28400/sdo_pc_pkg_ref.htm
 
84