[QGIS Commit] r10757 - in docs/trunk/english_us/user_guide: .
plugins_oracle_raster_images
svn_qgis at osgeo.org
svn_qgis at osgeo.org
Fri May 8 06:08:13 EDT 2009
Author: cfarmer
Date: 2009-05-08 06:08:12 -0400 (Fri, 08 May 2009)
New Revision: 10757
Added:
docs/trunk/english_us/user_guide/plugins_oracle_raster.tex
docs/trunk/english_us/user_guide/plugins_oracle_raster_images/oracle_create_dialog.png
docs/trunk/english_us/user_guide/plugins_oracle_raster_images/oracle_select_dialog.png
Modified:
docs/trunk/english_us/user_guide/plugins_oracle_raster_images/Makefile
docs/trunk/english_us/user_guide/user_guide.tex
Log:
add oracle georaster plugin section
Added: docs/trunk/english_us/user_guide/plugins_oracle_raster.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_oracle_raster.tex (rev 0)
+++ docs/trunk/english_us/user_guide/plugins_oracle_raster.tex 2009-05-08 10:08:12 UTC (rev 10757)
@@ -0,0 +1,109 @@
+% vim: set textwidth=78 autoindent:
+
+\subsection{Oracle GeoRaster Plugin}
+
+% when the revision of a section has been finalized,
+% comment out the following line:
+% \updatedisclaimer
+
+In Oracle databases, raster data can be stored in SDO\_GEORASTER objects available with the
+Oracle Spatial extension. In QGIS, the \toolbtntwo{oracle_raster}{Oracle GeoRaster Plugin}
+is supported by GDAL, and depends on Oracle's Database product being installed and working
+on your machine. While Oracle is proprietary software, they provide their software free for
+development and testing purposes. Here is one simple example of how to load raster images
+to GeoRaster:
+
+\begin{verbatim}
+$ gdal_translate -of georaster input_file.tif geor:scott/tiger at orcl
+\end{verbatim}
+
+This will load the raster into the default GDAL\_IMPORT table, as a column named RASTER.
+
+\subsubsection{Managing connections}
+
+Firstly, the Oracle GeoRaster Plugin must be enabled using the Plugin Manager (see Section
+\ref{sec:load_core_plugin}). The first time you load a GeoRaster in QGIS, you must create a
+connection to the Oracle database that contains the data. To do this, begin by clicking on
+the \toolbtntwo{oracle_raster}{Select GeoRaster} toolbar button, it will open the Select Oracle
+Spatial GeoRaster dialog window. Click on \button{New} to open the dialog window, and specify
+the connection parameters (See Figure \ref{fig:oracle_create}):
+
+\begin{itemize}
+\item \textbf{Name}: Enter a name for the database connection.
+\item \textbf{Database instance}: Enter the name of the database that you will connect to.
+\item \textbf{Username}: Specify your own username that you will use to access the database.
+\item \textbf{Password}: The password associated with your username that is required to access the database.
+\end{itemize}
+
+\begin{figure}[ht]
+ \begin{center}
+ \caption{Create Oracle connection dialog \nixcaption}\label{fig:oracle_create}\smallskip
+ \includegraphics[clip=true, width=9cm]{oracle_create_dialog}
+\end{center}
+\end{figure}
+
+Now, back on the main Oracle Spatial GeoRaster dialog window (See Figure \ref{fig:oracle_select}), use the
+drop-down list to choose one connection, and use the \button{Connect} button to establish a connection. You
+may also \button{Edit} the connection by opening the previous dialog and making changes to the connection
+information, or use the \button{Delete} button to remove the connection from the drop-down list.
+
+\subsubsection{Selecting a GeoRaster}
+
+Once a connection has been established, the sub-datasets window will show the names of all the tables that
+contains GeoRaster columns in that database in the format of a GDAL subdataset name.
+
+Click on one of the listed subdatasets and then click on \button{Select} to choose the table name. Now another
+list of subdatasets will show with the names of GeoRaster columns on that table. This is usually a short list,
+since most users will not have more than one or two GeoRaster columns on the same table.
+
+Click on one of the listed subdatasets and then click on \button{Select} to choose one of the the table/column
+combination. The dialog will now show all the rows that contains GeoRaster objects. Note that the subdataset
+list will now show the Raster Data Table and Raster Id's pairs.
+
+At anytime the Selection entry can be edited in order to go directly to a known GeoRaster or to go back to the
+beginning and select another table name.
+
+\begin{figure}[ht]
+ \begin{center}
+ \caption{Select Oracle GeoRaster dialog \nixcaption}\label{fig:oracle_select}\smallskip
+ \includegraphics[clip=true, width=9cm]{oracle_select_dialog}
+\end{center}
+\end{figure}
+
+The Selection data entry can also be used to enter a Where clause at the end of the identification string, e.g.,
+``geor:scott/tiger at orcl,gdal\_import,raster,geoid=''. See \url{http://www.gdal.org/frmt_georaster.html} for more information.
+
+\subsubsection{Displaying GeoRaster}
+
+Finally, by selecting a GeoRaster from the list of Raster Data Table and Raster Id's, the raster image will be
+loaded into QGIS.
+
+The Select Oracle Spatial GeoRaster dialog window can be closed now and next time it opens it will keep the same
+connection, and will show the same previous list of subdataset making it very easy to open up another image
+from the same context.
+
+\textbf{Note:} GeoRasters that contains pyramids will display much faster but the pyramids need to be generated
+outside of QGIS using Oracle PL/SQL or gdaladdo.
+
+The following is example using gdaladdo:
+
+\begin{verbatim}
+gdaladdo georaster:scott/tiger at orcl,georaster\_table,georaster,georid=6 -r
+nearest 2 4 6 8 16 32
+\end{verbatim}
+
+This is an example using PL/SQL:
+cd ..
+\begin{verbatim}
+$ sqlplus scott/tiger
+SQL> DECLARE
+ gr sdo_georaster;
+BEGIN
+ SELECT image INTO gr FROM cities WHERE id = 1 FOR UPDATE;
+ sdo_geor.generatePyramid(gr, 'rLevel=5, resampling=NN');
+ UPDATE cities SET image = gr WHERE id = 1;
+ COMMIT;
+END;
+/
+\end{verbatim}
+
Modified: docs/trunk/english_us/user_guide/plugins_oracle_raster_images/Makefile
===================================================================
--- docs/trunk/english_us/user_guide/plugins_oracle_raster_images/Makefile 2009-05-08 05:49:29 UTC (rev 10756)
+++ docs/trunk/english_us/user_guide/plugins_oracle_raster_images/Makefile 2009-05-08 10:08:12 UTC (rev 10757)
@@ -12,6 +12,8 @@
# nextfile.eps
PNG=oracle_raster.eps\
+ oracle_select_dialog.eps\
+ oracle_create_dialog.eps\
##### TARGETS #####
Added: docs/trunk/english_us/user_guide/plugins_oracle_raster_images/oracle_create_dialog.png
===================================================================
(Binary files differ)
Property changes on: docs/trunk/english_us/user_guide/plugins_oracle_raster_images/oracle_create_dialog.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: docs/trunk/english_us/user_guide/plugins_oracle_raster_images/oracle_select_dialog.png
===================================================================
(Binary files differ)
Property changes on: docs/trunk/english_us/user_guide/plugins_oracle_raster_images/oracle_select_dialog.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Modified: docs/trunk/english_us/user_guide/user_guide.tex
===================================================================
--- docs/trunk/english_us/user_guide/user_guide.tex 2009-05-08 05:49:29 UTC (rev 10756)
+++ docs/trunk/english_us/user_guide/user_guide.tex 2009-05-08 10:08:12 UTC (rev 10757)
@@ -37,6 +37,7 @@
\include{plugins_interpolation}
\include{plugins_mapserver_export}
\include{plugins_ogr_converter}
+\include{plugins_oracle_raster}
\include{other_core_plugins}
\include{external_plugins}
%\include{plugins_ftools}
More information about the QGIS-commit
mailing list