[Liblas-commits] hg: more doc work

liblas-commits at liblas.org liblas-commits at liblas.org
Wed May 26 14:31:33 EDT 2010


changeset 3c1f4dd15483 in /Volumes/Data/www/liblas.org/hg
details: http://hg.liblas.orghg?cmd=changeset;node=3c1f4dd15483
summary: more doc work

diffstat:

 doc/compilation.txt       |  47 +++++++++++++++++++++++++++++++++++++++++++----
 doc/index.txt             |  20 ++++++++++++--------
 doc/utilities/index.txt   |   3 ++-
 doc/utilities/las2oci.txt |  26 ++++++++++++++++++++++++++
 4 files changed, 83 insertions(+), 13 deletions(-)

diffs (190 lines):

diff -r 6c1bc65e8004 -r 3c1f4dd15483 doc/compilation.txt
--- a/doc/compilation.txt	Mon May 24 16:32:11 2010 -0500
+++ b/doc/compilation.txt	Wed May 26 13:31:23 2010 -0500
@@ -75,12 +75,16 @@
 `Debian`_ have `DebianGIS`_, Mac OS X has the `KyngChaos`_ software frameworks, 
 and Windows has the `OSGeo4W`_ platform.  
 
+* GDAL 1.7+ is required.
+
 
 `libgeotiff`_
 ------------------------------------------------------------------------------
 
 Obtain `libgeotiff`_ from the same place you got `GDAL`_.
 
+* libgeotiff 1.3.0+ is required
+
 .. note::
     `GDAL` surreptitiously embeds a copy of `libgeotiff`_ in its library build 
     but there is no way for you to know this.  In addition to embedding 
@@ -99,6 +103,8 @@
 installation procedure.  It does not have any dependent libraries.  It is also 
 available via `DebianGIS`_ and `OSGeo4W`_ as a binary.
 
+* libspatialindex 1.5.0+ is required
+
 `OCI`_
 ------------------------------------------------------------------------------
 
@@ -117,6 +123,8 @@
         ln -s libclntsh.so.10.1 libclntsh.so
         ln -s libociei.so.10.1 libociei.so
 
+* Oracle 11g is recommended, but OCI for 10g will work.
+
 .. _`libgeotiff`: http://www.remotesensing.org/geotiff/geotiff.html
 .. _`7/28/2008`: http://lists.maptools.org/pipermail/geotiff/2008-July/000501.html
 .. _`proj.4`: http://proj.maptools.org/
@@ -130,8 +138,7 @@
 .. _`Debian`: http://www.debian.org
 .. _`KyngChaos`: http://www.kyngchaos.com/software/unixport
 .. _`OSGeo4W`: http://trac.osgeo.org/osgeo4w/
-
-
+.. _`libtiff`: http://remotesensing.org/libtiff/
 
 
 
@@ -471,6 +478,11 @@
 Using "Visual Studio 9 2008" on Windows
 ..............................................................................
 
+Get the source code
+------------------------------------------------------------------------------
+
+See :ref:`source` for how to obtain the latest development version or visit
+:ref:`download` to get the latest released version.
 
 .. _msvc_prerequisites:
     
@@ -510,7 +522,7 @@
 
 ::
 
-    cd d:\liblas
+    cd d:\\liblas
     cmake-gui .
 
 .. figure:: ./images/windows-cmake-start.png
@@ -535,13 +547,40 @@
 * Click "Configure" and a window will pop up asking what type of build to
   generate. Choose "Visual Studio 9 2008."
 
-* Click "Generate" and a "libLAS.sln" file will be in ``d:\liblas``
+* Click "Generate" and a "libLAS.sln" file will be in ``d:\\liblas``
 
 * Open and build the project
 
 .. image:: ./images/windows-msvc-build.png
 
 
+Configure your `Optional Libraries`_.
+------------------------------------------------------------------------------
+
+By checking the "on" button for each, CMake may find your installations of
+these libraries, but in case it does not, set the following variables,
+substituting accordingly, to values that match your system layout.
+
+.. note::
+    If you are building using `OSGeo4W`_ libraries, you must use the "gdal-dev" 
+    version, not the base `GDAL`_ build.  libLAS requires GDDAL 1.7+ to 
+    operate, and this is provided by the "gdal-dev" `OSGeo4W`_ version.
+
+.. note::
+    You will need to choose "Advanced View" and select the location of the 
+    libTIFF library explicitly.
+    
+.. csv-table::
+
+    "`GDAL`_","GDAL_INCLUDE_DIR", "c:\\osgeo4w\\apps\\gdal-dev\\include"
+    "","GDAL_LIBRARY", "c:\\osgeo4w\\apps\\gdal-dev\\lib\\gdal_i.lib"
+    "`libgeotiff`_","GEOTIFF_INCLUDE_DIR","c:\\osgeo4w\\include"
+    "","GEOTIFF_LIBRARY","c:\\osgeo4w\\lib\\geotiff_i.lib"
+    "`libtiff`_","TIFF_INCLUDE_DIR","c:\\osgeo4w\\include"
+    "","TIFF_LIBRARY","c:\\osgeo4w\\lib\\libtiff_i.lib"
+    "`libspatialindex`_","SPATIALINDEX_INCLUDE_DIR","C:\\osgeo4w\\include\\spatialindex"
+    "","SPATIALINDEX_LIBRARY","C:\\osgeo4w\\lib\\spatialindex_i.lib"
+    
 ------------------------------------------------------------------------------
 
 .. _`CMake`: http://www.cmake.org/
diff -r 6c1bc65e8004 -r 3c1f4dd15483 doc/index.txt
--- a/doc/index.txt	Mon May 24 16:32:11 2010 -0500
+++ b/doc/index.txt	Wed May 26 13:31:23 2010 -0500
@@ -11,6 +11,11 @@
 interchange and archival.  See :ref:`features` for more details on what 
 libLAS can provide a LiDAR software developer.
 
+libLAS' initial development was supported in 2007-2008 by the `IGSB`_ of the
+Iowa DNR for use in its state-wide `LIDAR`_ project.  Ongoing support for 
+libLAS is provided by a number of organizations including the 
+`U.S. Army Cold Regions Research and Engineering Laboratory`_.
+
 libLAS builds upon by `Martin Isenburg and Jonathan Shewchuk`_ of LLNL/UC
 Berkeley in their `LAStools`_ project to do a number of things. First, the
 libLAS focuses almost completely on providing an easy-to-program-with library
@@ -22,14 +27,13 @@
 building block for developers to use to implement their own LiDAR data
 processing when working with ASPRS LAS data.
 
-.. seealso::
-    :ref:`libLAS and LAStools<lastools_liblas>` provides a comparison and description of the 
-    relationship of libLAS to LAStools.
-    
-libLAS' initial development was supported in 2007-2008 by the `IGSB`_ of the
-Iowa DNR for use in its state-wide `LIDAR`_ project.  Ongoing support for 
-libLAS is provided by a number of organizations including the 
-`U.S. Army Cold Regions Research and Engineering Laboratory`_.
+For more information, :ref:`this document <lastools_liblas>` provides a
+comparison and description of the relationship of libLAS to LAStools.
+
+. seealso::
+    http://trac.liblas.org contains the previous incarnation of the libLAS 
+    website.  If you can't find something here, it should still be there.
+
 
 .. _`U.S. Army Cold Regions Research and Engineering Laboratory` : http://www.crrel.usace.army.mil/
 
diff -r 6c1bc65e8004 -r 3c1f4dd15483 doc/utilities/index.txt
--- a/doc/utilities/index.txt	Mon May 24 16:32:11 2010 -0500
+++ b/doc/utilities/index.txt	Wed May 26 13:31:23 2010 -0500
@@ -13,4 +13,5 @@
    lasmerge
    lasdiff
    las2ogr
-   txt2las
\ No newline at end of file
+   txt2las
+   las2oci
\ No newline at end of file
diff -r 6c1bc65e8004 -r 3c1f4dd15483 doc/utilities/las2oci.txt
--- a/doc/utilities/las2oci.txt	Mon May 24 16:32:11 2010 -0500
+++ b/doc/utilities/las2oci.txt	Wed May 26 13:31:23 2010 -0500
@@ -0,0 +1,26 @@
+
+.. raw:: pdf
+
+    PageBreak
+    
+.. _las2oci:
+    
+******************************************************************************
+  las2oci
+******************************************************************************
+
+:Author: Howard Butler
+:Contact: hobu.inc at gmail.com
+
+
+Description
+==============================================================================
+
+:ref:`las2oci` allows a user to load LAS 1.0-1.2 data into `Oracle Point Cloud`_ 
+tables within Oracle 11gR2+.  All optional components are necessary to be 
+compiled with libLAS for this code to work, as spatial indexing and GDAL are 
+required.  See :ref:`optional_libraries` for details on obtaining the 
+necessary components if you are building for yourself.
+
+.. _`Oracle Point Cloud`: http://download.oracle.com/docs/cd/B28359_01/appdev.111/b28400/sdo_pc_pkg_ref.htm
+


More information about the Liblas-commits mailing list