Changeset 933

Show
Ignore:
Timestamp:
10/10/08 15:10:48 (3 months ago)
Author:
hobu
Message:

rework readme in prep for release

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • trunk/README

    r921 r933  
    33============================================================================== 
    44 
    5 libLAS is a BSD library for reading and writing ASPRS LAS version 1.0 and 1.1  
     5libLAS is a C/C++ library for reading and writing ASPRS LAS version 1.0 and 1.1  
    66data.  LAS-formatted data is heavily used in `LiDAR`_ processing operations, and  
    77the LAS format is a sequential binary format used to store data from sensors  
     
    1010libLAS is available under the terms of the `BSD License`_. It builds on work  
    1111by `Martin Isenburg and Jonathan Shewchuk`_ of the  University of North  
    12 Carolina in their `LAStools`_ project.  The base C++ library that reads  
     12Carolina in their `LAStools`_ project.  libLAS' base C++ library that reads  
    1313and writes LAS 1.0/1.1 data was replaced with new development, and Martin's  
    1414tools were ported to use this new code. 
     
    2121------------------------------------------------------------------------------ 
    2222 
    23 The latest version of libLAS can be downloaded from 
    24 http://liblas.org/wiki/Releases 
     23The 1.0.0 version of libLAS can be downloaded from http://liblas.org/wiki/1.0.0 
     24 
     25Older releases may be obtained from http://liblas.org/wiki/Releases 
    2526 
    2627Binaries 
    2728.............................................................................. 
     29 
    2830 
    2931Windows binaries of libLAS are provided in two forms.  The easiest form is  
    3032to obtain `OSGeo4W`_ and select the libLAS package to install.  Alternatively,  
    3133you can download a Windows package with full spatial reference support from  
    32 the release page.  GDAL support is *not* provided with either package, however.   
    33 We hope to resolve this by the 1.0.0 final release. 
    34  
    35 FAQ 
    36 ------------------------------------------------------------------------------ 
    37  
    38 The FAQ is available from http://liblas.org/wiki/FAQ 
    39  
    40 State of the Library 
    41 ------------------------------------------------------------------------------ 
    42  
    43 libLAS provides excellent coverage of the ASPRS LAS 1.0 and 1.1 specifications,  
    44 and it provides support for copying variable length records from one file to  
    45 another.  As of 1.0.0-beta-3, support for creating your own variable length records  
    46 is limited to the C and C++ APIs.  libLAS concentrates on reading and writing  
    47 point data for processing pipelines from C++, C, and Python.  Contact the  
    48 `Authors`_ if you have money burning a hole in your pocket to implement more  
    49 sophisticated support for LAS format items. 
    50  
    51 libLAS also provides support for reading and writing spatial reference system descriptions  
    52 from LAS 1.0 and 1.1 files as of version 1.0.0-beta-1.  `libgeotiff`_ 1.2.5  
    53 (released in `7/28/2008`_) must be linked with libLAS to provide reading support 
    54 for spatial reference systems.  `GDAL`_ is required to use the las2ogr command-line  
    55 utility for creating shapefiles, etc out of a .LAS file. 
    56  
    57 Features of libLAS 
    58 ------------------------------------------------------------------------------ 
    59  
    60 Open Source 
    61 .............................................................................. 
    62  
    63 libLAS is open source software.  You can embed it in your own applications  
    64 (and even resell it) as long as you follow the crediting restriction of the BSD  
    65 license.   
    66  
    67 Multiple APIs 
    68 .............................................................................. 
    69  
    70 libLAS supports has C, C++, and Python APIs.  This allows you to easily embed  
    71 libLAS in your own programs, or use the Python API for some one-off scripting.   
    72  
    73 Spatial Reference System Support 
    74 .............................................................................. 
    75  
    76 Linked against the latest version of `libgeotiff`_, you can set and get the spatial reference  
    77 systems of LAS files using simple `proj.4`_ coordinate system definitions.   
    78  
    79 Simple Variable Length Record Abstraction 
    80 .............................................................................. 
    81  
    82 libLAS provides a sensible abstraction for working with variable length records (VLR)  
    83 in LAS files, and it transparently manages the VLRs related to spatial referencing  
    84 systems for you.   
    85  
    86 Command-line Utilities 
    87 .............................................................................. 
    88  
    89 libLAS provides ports of the `LAStools`_ utilities by Martin Isenburg for doing  
    90 things like translating from one version of the LAS format to another, inspecting  
    91 header information, and translating LAS data to and from text. 
    92  
    93 Cross-platform operation 
    94 .............................................................................. 
    95  
    96 libLAS is known to work on MSVC 7.1+ (Windows) and GCC4.1+ (OS X and Linux) platforms  
    97 on both big- and little-endian architectures. 
    98  
     34the release page.  GDAL support is only provided with the `OSGeo4W`_ package, however. 
     35 
     36Linux, Mac OS X, and Solaris binaries are not provided.  The source code  
     37uses the standard GNU autotools/automake stack for compilation and installation. 
    9938 
    10039 
     
    10241------------------------------------------------------------------------------ 
    10342 
    104 LAS Format Specifications 
    105 .............................................................................. 
    106  
    107 The LAS Format Standard is maintained by `ASPRS Standards Committee`_. LAS  
    108 format standard documents are available in PDF format: 
    109  
    110 * `LAS 2.0 Format Standard`_ (2007-08-17) - *Proposed* 
    111 * `LAS 1.2 Format Standard`_ (2008-05-02) - *Proposed* 
    112 * `LAS 1.1 Format Standard`_ (2005-05-07) 
    113 * `LAS 1.0 Format Standard`_ (2003-05-09) 
    114  
    115 Library Documents 
    116 .............................................................................. 
    117  
    118 * `LAS Format Elements`_ - comparison of elements of LAS Format 1.0 and 1.1   
    119 * `Software`_ - list of geospatial software with reading and writing capabilities of LAS Format 
    120 * `Resources`_ - list of LiDAR/LAS resources 
    121 * `Tutorials`_ - Tutorials on using libLAS from C++, Python and .NET/Mono languages 
    122  
    123 Utilities 
     43`LAStools`_ / libLAS Command-line Utilities 
    12444.............................................................................. 
    12545 
     
    13050* `lasmerge`_ 
    13151 
     52Software Development with libLAS 
     53.............................................................................. 
     54 
     55* `FOSS4G 2008`_ presentation that provides a basic overview of the design  
     56   and philosophy of libLAS 
     57* `LAS Format Elements`_ - comparison of elements of LAS Format 1.0 and 1.1   
     58* `Software`_ - a list of geospatial software with reading and writing capabilities of LAS Format 
     59* `Resources`_ - a list of general LiDAR/LAS resources 
     60* `Tutorials`_ - tutorials on using libLAS from C++, Python and .NET/Mono languages 
     61* `LAS C API`_- doxygen docs that describe the libLAS C API 
     62* `dotnetLibLAS API`_ - docs for the .NET API 
     63* `LAS Doxygen Docs`_ - doxygen docs of the entire C/C++ API 
     64 
     65LAS Format Specifications 
     66.............................................................................. 
     67 
     68The LAS Format Standard is maintained by `ASPRS Standards Committee`_. LAS  
     69format standard documents are available in PDF format: 
     70 
     71* `LAS 2.0 Format Standard`_ (2007-08-17) - *Proposed* 
     72* `LAS 1.2 Format Standard`_ (2008-05-02) - *Proposed* 
     73* `LAS 1.1 Format Standard`_ (2005-05-07) 
     74* `LAS 1.0 Format Standard`_ (2003-05-09) 
     75 
     76License 
     77------------------------------------------------------------------------------ 
     78 
     79libLAS is available under the terms of the `BSD License`_.  
     80See `License`_ for a copy. 
     81 
     82FAQ 
     83------------------------------------------------------------------------------ 
     84 
     85The FAQ is available from http://liblas.org/wiki/FAQ 
     86 
     87Features of libLAS 
     88------------------------------------------------------------------------------ 
     89 
     90Open Source 
     91.............................................................................. 
     92 
     93libLAS is open source software.  You can embed it in your own applications  
     94(and even resell it) as long as you follow the crediting restriction of the BSD  
     95license.   
     96 
     97Multiple APIs 
     98.............................................................................. 
     99 
     100libLAS has C, C++, .NET, and Python APIs.    
     101 
     102Spatial Reference System Support 
     103.............................................................................. 
     104 
     105Linked against the latest version of `libgeotiff`_, you can set and get the spatial reference  
     106systems of LAS files using simple `proj.4`_ coordinate system definitions.   
     107 
     108Simple Variable Length Record Abstraction 
     109.............................................................................. 
     110 
     111libLAS provides a sensible abstraction for working with variable length records (VLR)  
     112in LAS files, and it transparently manages the VLRs related to spatial referencing  
     113systems for you.   
     114 
     115Command-line Utilities 
     116.............................................................................. 
     117 
     118libLAS provides ports of the `LAStools`_ utilities by Martin Isenburg for doing  
     119things like translating from one version of the LAS format to another, inspecting  
     120header information, and translating LAS data to and from text. 
     121 
     122Cross-platform operation 
     123.............................................................................. 
     124 
     125libLAS is known to work on MSVC 7.1+ (Windows) and GCC4.1+ (OS X and Linux) platforms  
     126on both big- and little-endian architectures. 
     127 
     128 
    132129Development 
    133130------------------------------------------------------------------------------ 
     
    157154    svn checkout http://liblas.org/svn/trunk/ 
    158155 
    159 Development Documentation 
    160 .............................................................................. 
    161  
    162 * `Library Design`_ 
    163 * `LAS C API`_ 
    164 * `LAS Doxygen Docs`_ 
    165 * `How To Release libLAS`_ 
    166  
    167156Information about Trac 
    168157.............................................................................. 
     
    188177* liblas-devel - http://mail.hobu.net/mailman/listinfo/liblas-devel 
    189178* liblas-commits - http://mail.hobu.net/mailman/listinfo/liblas-commits 
    190  
    191  
    192 License 
    193 ------------------------------------------------------------------------------ 
    194  
    195 libLAS is available under the terms of the `BSD License`_.  
    196 See `License`_ for a copy. 
    197  
    198  
    199179 
    200180 
     
    227207.. _`Freenode`: http://freenode.net 
    228208.. _`Library Design`: http://liblas.org/wiki/LibraryDesign 
     209.. _`FOSS4G 2008`: http://liblas.org/raw-attachment/wiki/WikiStart/liblas_foss4g_2008.pdf 
    229210.. _`LAS C API`: http://liblas.org/doxygen/liblas_8h.html 
    230211.. _`LAS Doxygen Docs`: http://liblas.org/doxygen/ 
     
    235216.. _`GDAL`: http://www.gdal.org 
    236217.. _`OSGeo4W`: http://wiki.osgeo.org/wiki/OSGeo_Win32_Installer 
    237  
    238 $Id$ 
    239  
     218.. _`dotnetLibLAS API`: http://liblas.org/wiki/dotnetapi