[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