First draft of wktraster faq

git-svn-id: http://svn.osgeo.org/postgis/trunk@5511 b70326c6-7e19-0410-871a-916f4a2858ee

diff --git a/doc/Makefile.in b/doc/Makefile.in
index c5f3eac196429ce1a0ebbe93c1a092978ee42a56..3a8c53314d2da2be639e3a0e6c8ca4595f812ba2 100644 (file)
--- a/doc/Makefile.in
+++ b/doc/Makefile.in
@@ -67,7 +67,7 @@ postgis_aggs_mm.xml: ./xsl/postgis_aggs_mm.xml.xsl postgis.xml
 postgis_comments.sql: ./xsl/postgis_comments.sql.xsl postgis.xml postgis_aggs_mm.xml
        $(XSLTPROC) ./xsl/postgis_comments.sql.xsl postgis.xml > $@
 
-postgis-out.xml: postgis.xml introduction.xml installation.xml faq.xml using_postgis_dataman.xml  using_postgis_app.xml performance_tips.xml reference.xml reference_management.xml reference_constructor.xml reference_accessor.xml reference_editor.xml reference_output.xml reference_operator.xml reference_measure.xml reference_processing.xml reference_lrs.xml reference_transaction.xml reference_misc.xml reference_exception.xml postgis_aggs_mm.xml reference_wktraster.xml reporting.xml release_notes.xml ../Version.config
+postgis-out.xml: postgis.xml introduction.xml installation.xml faq.xml using_postgis_dataman.xml  using_postgis_app.xml performance_tips.xml reference.xml reference_management.xml reference_constructor.xml reference_accessor.xml reference_editor.xml reference_output.xml reference_operator.xml reference_measure.xml reference_processing.xml reference_lrs.xml reference_transaction.xml reference_misc.xml reference_exception.xml postgis_aggs_mm.xml reference_wktraster.xml faq_wktraster.xml reporting.xml release_notes.xml ../Version.config
        cat $< | sed "s/@@LAST_RELEASE_VERSION@@/${POSTGIS_MAJOR_VERSION}.${POSTGIS_MINOR_VERSION}.${POSTGIS_MICRO_VERSION}/g" > $@
 
 chunked-html: postgis-out.xml images

diff --git a/doc/faq_wktraster.xml b/doc/faq_wktraster.xml
new file mode 100644 (file)
index 0000000..e81ea51
--- /dev/null
+++ b/doc/faq_wktraster.xml
@@ -0,0 +1,69 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter>
+  <title>Raster Frequently Asked Questions</title>
+
+  <qandaset>
+        <qandaentry>
+      <question>
+        <para>Where can I find out more about the WKT Raster Project?</para>
+      </question>
+
+      <answer>
+        <para>Refer to the <ulink url="http://trac.osgeo.org/postgis/wiki/WKTRaster">WKT Raster home page</ulink>.</para>
+      </answer>
+    </qandaentry>
+       
+        <qandaentry>
+      <question>
+        <para>How do I install Raster support in my PostGIS database?</para>
+      </question>
+
+      <answer>
+        <para>First you need a working PostGIS 1.3.5 or above database.  Then you need to compile WKT Raster if you are on Linux/Mac OSX.
+                       If you are on windows, you can compile yourself, or use the <ulink url="http://www.postgis.org/download/windows/experimental.php#wktraster">pre-comiled WKT Raster windows binaries</ulink>.
+               </para>
+               <para>For more details about compiling from source, please refer to <ulink url="http://trac.osgeo.org/postgis/wiki/WKTRaster/Documentation01#a2.3-CompilingandInstallingfromSources">Installing WKT Raster from source</ulink></para>
+      </answer>
+    </qandaentry>
+       
+       <qandaentry>
+      <question>
+        <para>How do I load Raster data into PostGIS?</para>
+      </question>
+
+      <answer>
+        <para>Currently you need <ulink url="http://www.gdal.org/">GDAL 1.6+</ulink>, <ulink url="http://www.python.org/download/releases/2.5/">Python 2.5</ulink> with <ulink url="http://pypi.python.org/pypi/GDAL/1.6.1">GDAL 1.6 or higher bindings</ulink>, 
+                       and <ulink url="http://pypi.python.org/pypi/numpy">NumPy</ulink>.</para>
+               <para>
+                       For windows users, installing these components from binary sources is documented in the 
+                       ReadMe.txt packaged with the <ulink url="http://www.postgis.org/download/windows/experimental.php#wktraster">Windows WKT Raster experimental builds</ulink>.</para>
+               <para>Once you have a functioning Python with GDAL and NumPy, you can use the gdal2wktraster.py script packaged with WKT Raster.
+                       Please refer to <ulink url="http://trac.osgeo.org/gdal/wiki/frmts_wtkraster.html">gdal2wktraster.py usage</ulink> for more details.
+               </para>
+      </answer>
+    </qandaentry>
+       
+    <qandaentry>
+      <question>
+        <para>What kind of raster file formats can I load into my database?</para>
+      </question>
+
+      <answer>
+        <para>Any that gdal supports. GDAL supported formats are documented <ulink url="http://www.gdal.org/formats_list.html">GDAL File Formats</ulink>.</para>
+               <para>Your particular gdal install may not support all formats.  To verify the ones supported by your particular gdal install, you can use gdalinfo --formats</para> 
+      </answer>
+    </qandaentry>
+       
+       <qandaentry>
+      <question>
+        <para>What functions can I currently use with my raster data?</para>
+      </question>
+
+      <answer>
+        <para>Refer to the list of <xref linkend="Raster_Functions">documented raster functions</xref>. There are more, but this is still a work in progress.</para>
+               <para>Refer to the <ulink url="http://trac.osgeo.org/postgis/wiki/WKTRaster/PlanningAndFunding">WKT Raster roadmap page</ulink> for details of what you can expect in the future.</para>
+      </answer>
+    </qandaentry>
+       
+  </qandaset>
+</chapter>
\ No newline at end of file

diff --git a/doc/postgis.xml b/doc/postgis.xml
index 3396907bd9edb535b9ac675b07a01e612ab29ec9..6924f1d946a408bc7a0317a0242389f4da5bc6ec 100644 (file)
--- a/doc/postgis.xml
+++ b/doc/postgis.xml
@@ -33,6 +33,7 @@
 <!ENTITY reference_misc SYSTEM "reference_misc.xml">
 <!ENTITY reference_exception SYSTEM "reference_exception.xml">
 <!ENTITY reference_wktraster SYSTEM "reference_wktraster.xml">
+<!ENTITY faq_wktraster SYSTEM "faq_wktraster.xml">
 
 <!ENTITY sfs_compliant 
 "<inlinemediaobject>