Author: jive Date: 2011-10-30 05:02:24 -0700 (Sun, 30 Oct 2011) New Revision: 38286 Modified: trunk/docs/user/extension/brewer/index.rst trunk/docs/user/library/api/index.rst trunk/docs/user/library/coverage/geotiff.rst trunk/docs/user/library/coverage/grassraster.rst trunk/docs/user/library/coverage/gtopo30.rst trunk/docs/user/library/coverage/image-collection.rst trunk/docs/user/library/coverage/image.rst trunk/docs/user/library/coverage/imageio.rst trunk/docs/user/library/coverage/index.rst trunk/docs/user/library/coverage/jp2k.rst trunk/docs/user/library/coverage/matlab.rst trunk/docs/user/library/coverage/mosaic.rst trunk/docs/user/library/coverage/oracle.rst trunk/docs/user/library/coverage/pgraster.rst trunk/docs/user/library/coverage/pyramid.rst trunk/docs/user/library/cql/index.rst trunk/docs/user/library/data/index.rst trunk/docs/user/library/jdbc/index.rst trunk/docs/user/library/jts/index.rst trunk/docs/user/library/main/index.rst trunk/docs/user/library/metadata/index.rst trunk/docs/user/library/opengis/index.rst trunk/docs/user/library/referencing/index.rst trunk/docs/user/library/render/index.rst trunk/docs/user/library/xml/index.rst trunk/docs/user/tutorial/advanced/index.rst trunk/docs/user/tutorial/index.rst trunk/docs/user/tutorial/quickstart/eclipse.rst trunk/docs/user/tutorial/quickstart/netbeans.rst trunk/docs/user/tutorial/raster/image.rst trunk/docs/user/unsupported/efeature/index.rst trunk/docs/user/unsupported/geometry/index.rst trunk/docs/user/unsupported/index.rst trunk/docs/user/unsupported/postgis-versioned/index.rst trunk/docs/user/unsupported/process/index.rst trunk/docs/user/unsupported/swing/index.rst trunk/docs/user/unsupported/swt/index.rst Log: add in maven dependency snippets so users can cut and paste Modified: trunk/docs/user/extension/brewer/index.rst =================================================================== --- trunk/docs/user/extension/brewer/index.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/extension/brewer/index.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -61,5 +61,5 @@ "ColorBrewer" appear in their name, without prior written permission of Cynthia Brewer. -In keeping with the above license the GeoTools does an written permission to use the +In keeping with the above license GeoTools does have written permission to use the name "ColorBrewer". Thanks Cynthia for your contribution to the state of the art. \ No newline at end of file Modified: trunk/docs/user/library/api/index.rst =================================================================== --- trunk/docs/user/library/api/index.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/api/index.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -2,8 +2,30 @@ API === -The **gt-api** module is where we publish out stable interfaces that are implemented by the rest of the library. +The **gt-api** module is where we publish out stable interfaces that are implemented by GeoTools. +These interfaces build on the ideas and concepts defined by standards the **gt-opengis** module. +.. image:: /images/gt-api.png + +The gt-api module provides: + +* Interfaces implemented by :doc:`gt-main <../main/index>` such as *FeatureSource*; and +* Utility classes to help with integration such as *ReferencedEnvelope*; and +* :doc:`gt-main <../main/index>` offers helper classes to translate Geometry into a Java Shape + +In general *gt-opengis* module defines data structures and concepts while the *gt-api* module +provides data access and functionality. + +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-api</artifactId> + <version>${geotools.version}</version> + </dependency> + +**Contents** + .. sidebar:: Details .. toctree:: @@ -21,18 +43,3 @@ envelope jts convert - -These interfaces build on the ideas and concepts defined by standards (as captured in the **gt-opengis** module). - -.. image:: /images/gt-api.png - -The gt-api module provides: - -* Interfaces implemented by:doc:`gt-main <../main/index>` such as -* Utility classes to help with integration such as ReferencedEnvelope and -* :doc:`gt-main <../main/index>` offers helper classes to translate Geometry into a Java Shape - -In general: - -* gt-opengis module defines data structures and concepts -* gt-api module defines data access and functionality \ No newline at end of file Modified: trunk/docs/user/library/coverage/geotiff.rst =================================================================== --- trunk/docs/user/library/coverage/geotiff.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/coverage/geotiff.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -3,12 +3,20 @@ The gt-geotiff module in the plugin group provides access to the GeoTiff file format. -References: +**References** * http://www.jroller.com/jsight/entry/back_to_code_geotools_geotiff * `GeoTiffReaderTest.java <http://svn.osgeo.org/geotools/trunk/modules/plugin/geotiff/src/test/java/org/geotools/gce/geotiff/GeoTiffReaderTest.java>`_ * `GeoTiffWriterTest.java <http://svn.osgeo.org/geotools/trunk/modules/plugin/geotiff/src/test/java/org/geotools/gce/geotiff/GeoTiffWriterTest.java>`_ +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-geotiff</artifactId> + <version>${geotools.version}</version> + </dependency> + **Happy Fun Ball License** In addition to the normal LGPL license the gt-geotiff module includes files marked with:: Modified: trunk/docs/user/library/coverage/grassraster.rst =================================================================== --- trunk/docs/user/library/coverage/grassraster.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/coverage/grassraster.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -1,8 +1,19 @@ GrassRaster Plugin ------------------ -The module supplies support for reading and writing GRASS rasters. The metadata contain both the colortable and the categories (if available) of the raster map. The original colortable of the GRASS raster is read into the geotools coverage Categories and can as such be visualized if using a default styler. +The module supplies support for reading and writing GRASS rasters. The metadata contain both the +colortable and the categories (if available) of the raster map. The original colortable of the +GRASS raster is read into the geotools coverage Categories and can as such be visualized +if using a default styler. +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-grassraster</artifactId> + <version>${geotools.version}</version> + </dependency> + Data structure of a rastermap ----------------------------- Modified: trunk/docs/user/library/coverage/gtopo30.rst =================================================================== --- trunk/docs/user/library/coverage/gtopo30.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/coverage/gtopo30.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -1,8 +1,17 @@ GTOPO30 Plugin -------------- -The gt-gtopo30 module of the plugin group provides access to the file format used by the GTOPO 30 Digital Elevation Model data set created by NASA. +The gt-gtopo30 module of the plugin group provides access to the file format used by the +GTOPO 30 Digital Elevation Model data set created by NASA. -References: +**References** * http://eros.usgs.gov/#/Find_Data/Products_and_Data_Available/gtopo30_info + +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-gtopo30</artifactId> + <version>${geotools.version}</version> + </dependency> Modified: trunk/docs/user/library/coverage/image-collection.rst =================================================================== --- trunk/docs/user/library/coverage/image-collection.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/coverage/image-collection.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -1,10 +1,28 @@ Image collection plug-in ------------------------ -An ``ImageReader`` and ``Format`` implementation working against a directory tree of non georeferenced images (scanned maps or plain photos). The directory tree location is specified while building the reader (it's the location being read). +An ``ImageReader`` and ``Format`` implementation working against a directory tree of non +georeferenced images (scanned maps or plain photos). The directory tree location is specified +while building the reader (it's the location being read). -The plug-in will normally return images in the ``EPSG:404000`` wild-card Cartesian 2D reference system. The image to be returned is chosen randomly among the available ones on start up unless a filter is specified to choose a particular one. +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-imagecollection</artifactId> + <version>${geotools.version}</version> + </dependency> -The filter has to follow the ``PATH=relative/path/to/image.jpeg`` pattern and be provided to the reader as a ``ParameterValue`` of type ``org.opengis.filter.Filter`` and name ``Filter``. +Instructions +^^^^^^^^^^^^ -The plugin is meant to be used in an environment where the underlying image collection is very large and varies through time, and assumes the caller has some external knowledge about what images are available in the directory being published. +The plug-in will normally return images in the ``EPSG:404000`` wild-card Cartesian 2D reference +system. The image to be returned is chosen randomly among the available ones on start up unless +a filter is specified to choose a particular one. + +The filter has to follow the ``PATH=relative/path/to/image.jpeg`` pattern and be provided to the +reader as a ``ParameterValue`` of type ``org.opengis.filter.Filter`` and name ``Filter``. + +The plugin is meant to be used in an environment where the underlying image collection is very +large and varies through time, and assumes the caller has some external knowledge about what +images are available in the directory being published. Modified: trunk/docs/user/library/coverage/image.rst =================================================================== --- trunk/docs/user/library/coverage/image.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/coverage/image.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -3,23 +3,39 @@ The image module in the plugin group provides access to the 'world plus image' file formats. -This is the quickest way to get a GIF or JEPG onto a map display - simply add a small text file along side the image defining the image's extend and use this plugin. +This is the quickest way to get a GIF or JEPG onto a map display - simply add a small text +file along side the image defining the image's extend and use this plugin. -Related: +**References** * http://www.kralidis.ca/gis/worldfile.htm * http://geos.gsi.gov.il/vladi/FEFLOW/help/general/file_format.html#tfw_file -The WorldImageReader allows access to image data through the GridFormatFinder. This supports raster images with an associated world file.:: +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-image</artifactId> + <version>${geotools.version}</version> + </dependency> + +Example +^^^^^^^ + +The WorldImageReader allows access to image data through the GridFormatFinder. This supports +raster images with an associated world file.:: File file = new File("test.jpg"); AbstractGridFormat format = GridFormatFinder.findFormat( file ); AbstractGridCoverage2DReader reader = format.getReader( file ); -World files have the same name as the image (different file extension) and contain just enough information to convert pixel coordinates to real world coordinates. They do not store any coordinate reference system information for the coordinates. +World files have the same name as the image (different file extension) and contain just +enough information to convert pixel coordinates to real world coordinates. They do not +store any coordinate reference system information for the coordinates. -The gt-image plugin depends on Java to read the image file; so depending on how you have JAI / Image IO configured the following should be supported: +The gt-image plugin depends on Java to read the image file; so depending on how you have +JAI / Image IO configured the following should be supported: ============= ======================= ===================== Image Format Image Format Extension World File Extension @@ -30,12 +46,17 @@ GIF file.gif file.gfw or file.wld ============= ======================= ===================== -**World File** -A world file is a small text file that says where the corners of the image is. The extension of a world file is the first and last letters of the image extension with "w" appended at the end. The coordinates are in the units of the projections, so -180,180 -90,90 for lat/long. +World File +^^^^^^^^^^ -If your image is not in lat/long you will have to include a .prj file, which is a text file with the WKT definition of the coordinate system that should be used. +A world file is a small text file that says where the corners of the image is. The extension of +a world file is the first and last letters of the image extension with "w" appended at the end. +The coordinates are in the units of the projections, so -180,180 -90,90 for lat/long. +If your image is not in lat/long you will have to include a .prj file, which is a text file with +the WKT definition of the coordinate system that should be used. + Example contents of a world file are as follows: +------+----------------+---------------------------------------------------------------+ Modified: trunk/docs/user/library/coverage/imageio.rst =================================================================== --- trunk/docs/user/library/coverage/imageio.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/coverage/imageio.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -1,16 +1,30 @@ ImageIO-EXT GDAL Plugin ----------------------- -The ImageIO-EXT plug-in allows geotools to make use of the additional formats provided via the Java Extension ImageIO-EXT. +The ImageIO-EXT plug-in allows geotools to make use of the additional formats provided via the +Java Extension ImageIO-EXT. -The Java ImageIO library comes with a few formats out of the box (such as PNG, etc...) the imageio-ext project provides support for additional geospatial formats. +The Java ImageIO library comes with a few formats out of the box (such as PNG, etc...) the +imageio-ext project provides support for additional geospatial formats. -References: +**References** * http://java.net/projects/imageio-ext/ -At the GeoTools level, the set of formats supported by the GeoTools ImageIO-Ext GDAL plugin is composed of: +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-imageio-ext-gdal</artifactId> + <version>${geotools.version}</version> + </dependency> +Formats +^^^^^^^ + +At the GeoTools level, the set of formats supported by the GeoTools ImageIO-Ext GDAL plugin +is composed of: + * DTED Elevation Raster * ESRI .hdr labelled * Erdas Imagine Images @@ -24,7 +38,8 @@ GDAL ^^^^ -If your Java Runtime Environment includes GDAL libraries you will be able to support additional file formats: +If your Java Runtime Environment includes GDAL libraries you will be able to support additional +file formats: * Arc/Info ASCII Grid * Arc/Info Binary Grid @@ -33,7 +48,8 @@ * GeoTIFF * JPEG -The ImageIO-EXT website includes ready to use ImageIO-Ext binaries including GDAL libraries. See "Release Information" for more info about the list of supported formats and available drivers. +The ImageIO-EXT website includes ready to use ImageIO-Ext binaries including GDAL libraries. See +"Release Information" for more info about the list of supported formats and available drivers. Example Use ^^^^^^^^^^^ Modified: trunk/docs/user/library/coverage/index.rst =================================================================== --- trunk/docs/user/library/coverage/index.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/coverage/index.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -1,8 +1,34 @@ Coverage ======== -Supports the use of coverage information (ie raster) from a range of sources. +The gt-coverage module provides a way to build and use highly structured grids of numeric values +such as imagery data, for instance GeoTIFF format files, or multi-dimensional matrix data, like +that found in NetCDF format files. +.. image:: /images/gt-coverage.png + +The gt-coverage module is responsible for: + +* implementation of the coverage interfaces from :doc:`gt-opengis <../opengis/index>` such as GridCoverage2D and Format +* Bridging between Java Advanced Imaging, JAI Image IO and Java Image facilities and the geospatial idea of a GridCoverage +* Recognising additional formats available on the CLASSPATH using **GridFormatFinder** + +The module supports the use of coverage information (ie raster) from a range of sources. + +**Tutorial** + +* :doc:`/tutorial/raster/image` + +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-coverage</artifactId> + <version>${geotools.version}</version> + </dependency> + +**Contents** + .. sidebar:: Details .. toctree:: @@ -10,6 +36,9 @@ faq internal/index + + +Contents: .. toctree:: :maxdepth: 1 @@ -46,15 +75,4 @@ jp2k netCDF matlab - tools - -The gt-coverage module provides a way to build and use highly structured grids of numeric values such as imagery data, for instance GeoTIFF format files, or multi-dimensional matrix data, like that found in NetCDF format files. - - -.. image:: /images/gt-coverage.png - -The gt-coverage module is responsible for: - -* implementation of the coverage interfaces from :doc:`gt-opengis <../opengis/index>` such as GridCoverage2D and Format -* Bridging between Java Advanced Imaging, JAI Image IO and Java Image facilities and the geospatial idea of a GridCoverage -* Recognising additional formats available on the CLASSPATH using **GridFormatFinder** + tools \ No newline at end of file Modified: trunk/docs/user/library/coverage/jp2k.rst =================================================================== --- trunk/docs/user/library/coverage/jp2k.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/coverage/jp2k.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -1,11 +1,24 @@ JP2K Plugin ----------- -The JP2K plug-in allows GeoTools to make use of the JP2K format provided via the available JP2K image readers in the JAI ImageIO project plus an optional ImageIO plugin based on the Kakadu library which is activated only when the Kakadu SDK is in the path (the Kakakdu SDK is not Open Source but t comes with a variety of licenses). Notice that: +The JP2K plug-in allows GeoTools to make use of the JP2K format provided via the available JP2K +image readers in the JAI ImageIO project plus an optional ImageIO plugin based on the Kakadu +library which is activated only when the Kakadu SDK is in the path (the Kakakdu SDK is not +Open Source but t comes with a variety of licenses). +Notice that: + 1. The Kakadu ImageIO plugin, when available, takes precedence over the standard ImageIO JP2K plugins 2. The JP2K plugins available through GDAL, which relies on the ImageIO-Ext GDAL plugin, are separate from this plugin and leave in their own module +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-jp2k</artifactId> + <version>${geotools.version}</version> + </dependency> + Use of Kakadu ^^^^^^^^^^^^^ Modified: trunk/docs/user/library/coverage/matlab.rst =================================================================== --- trunk/docs/user/library/coverage/matlab.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/coverage/matlab.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -3,4 +3,12 @@ Unsupported plugin to read SAS matlab files with georeferencing information. -No documentation has been provided. \ No newline at end of file +No documentation has been provided. + +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-matfile5</artifactId> + <version>${geotools.version}</version> + </dependency> Modified: trunk/docs/user/library/coverage/mosaic.rst =================================================================== --- trunk/docs/user/library/coverage/mosaic.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/coverage/mosaic.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -1,17 +1,26 @@ Mosaic Plugin ------------- -This format make use of a shapefile to act as a kind of index, the features in this shapefile list the filename of the "images" to display and the location in which they should be displayed. +This format make use of a shapefile to act as a kind of index, the features in this shapefile +list the filename of the "images" to display and the location in which they should be displayed. -The best source of documentation is (surprise surprise) the code; here are a couple of javadoc links: +**Reference** -* ImageMosaicFormat -* ImageMosaicReader +* `ImageMosaicFormat <http://docs.geotools.org/latest/javadocs/org/geotools/gce/imagemosaic/ImageMosaicFormat.html>`_ (javadoc) +* `ImageMosaicJDBCReader <http://docs.geotools.org/latest/javadocs/org/geotools/gce/imagemosaic/jdbc/ImageMosaicJDBCReader.html>`_ (javadoc) +* :doc:`pyramid` +* `Using the ImageMoasic plugin <http://docs.geoserver.org/stable/en/user/tutorials/image_mosaic_plugin/imagemosaic.html>`_ -Related +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-imagemosaic</artifactId> + <version>${geotools.version}</version> + </dependency> -* :doc:`pyramid`. -* http://docs.geoserver.org/stable/en/user/tutorials/image_mosaic_plugin/imagemosaic.html +Example +^^^^^^^ An example data set looks something like:: Modified: trunk/docs/user/library/coverage/oracle.rst =================================================================== --- trunk/docs/user/library/coverage/oracle.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/coverage/oracle.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -1,13 +1,16 @@ Oracle GeoRaster Plugin ----------------------- -This plugin is an extension to the Image Mosaicing Pyramidal JDBC Plugin. Since an Oracle Raster Object contains tiles and pyramids, configuration is simple. +This plugin is an extension to the Image Mosaicing Pyramidal JDBC Plugin. Since an Oracle Raster +Object contains tiles and pyramids, configuration is simple. Credits * Thanks to Steve Way and Pablo Najarro, who started with this module. -* Baskar Dhanapal developed a lot of code for getting image metadata from Oracle GeoRaster and constructing a Java image from pure raster data. - Studying this code, I decided to request image data in TIFF format from GeoRaster and construct the Java image using JAI and AWT. +* Baskar Dhanapal developed a lot of code for getting image metadata from Oracle + GeoRaster and constructing a Java image from pure raster data. + Studying this code, I decided to request image data in TIFF format from GeoRaster and construct + the Java image using JAI and AWT. Prerequisites Modified: trunk/docs/user/library/coverage/pgraster.rst =================================================================== --- trunk/docs/user/library/coverage/pgraster.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/coverage/pgraster.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -1,9 +1,9 @@ Postgis Raster Plug in ---------------------- -This plug in is an extension to the Image Mosaicing Pyramidal JDBC Plugin. Since a Postgis raster object offers spatial functions and predicates, configuration is simple. +This plug in is an extension to the Image Mosaicing Pyramidal JDBC Plugin. Since a Postgis raster +object offers spatial functions and predicates, configuration is simple. - Prerequisites * Postgis 2.0 available Modified: trunk/docs/user/library/coverage/pyramid.rst =================================================================== --- trunk/docs/user/library/coverage/pyramid.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/coverage/pyramid.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -1,20 +1,31 @@ Image Pyramid Plugin ^^^^^^^^^^^^^^^^^^^^ -There are a series of interesting raster "formats" that make use of a bunch of raster files and present the result as a single image. This format uses a magic directory structure combined with a property file describing what goes where. +There are a series of interesting raster "formats" that make use of a bunch of raster files and +present the result as a single image. This format uses a magic directory structure combined with +a property file describing what goes where. -The best source of documentation is (surprise surprise) the code; here are a couple of javadoc links: +**Reference** -* ImagePyramidReader - -Related - -* :doc:`mosaic`. +* `ImagePyramidReader <http://docs.geotools.org/latest/javadocs/index.html?org/geotools/gce/imagemosaic/ImageMosaicFormat.html>`_ +* :doc:`mosaic` * http://docs.geoserver.org/stable/en/user/data/imagepyramid.html * http://docs.geoserver.org/stable/en/user/tutorials/imagepyramid/imagepyramid.html?highlight=bluemarble -On disk an image pyramid is going to look a bit like the following (you can use any format for the tiles from mrsid to tiff):: +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-gt-imagepyramid</artifactId> + <version>${geotools.version}</version> + </dependency> +Example +^^^^^^^ + +On disk an image pyramid is going to look a bit like the following (you can use any format for +the tiles from mrsid to tiff):: + directory/ directory/pyramid.properties directory/0/mosaic metadata files @@ -27,7 +38,8 @@ directory/0/32/... directory/0/32/mosiac_file_n.tiff -The format of that pyramid.properties file is magic, while we can look at the javadocs (and the following example), you are going to have to read the source code on this one:: +The format of that pyramid.properties file is magic, while we can look at the javadocs +(and the following example), you are going to have to read the source code on this one:: # Pyramid Description # Modified: trunk/docs/user/library/cql/index.rst =================================================================== --- trunk/docs/user/library/cql/index.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/cql/index.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -1,9 +1,34 @@ CQL === -The gt-cql module a human readable "Contextual Query Language -" for writing filter expressions for working with geospatial information. +The gt-cql module a human readable "Contextual Query Language" for writing filter expressions +for working with geospatial information. +CQL was originally known as Common Query Language (so you will find lots of examples that still +refer to this name). The standard comes out of library science and was picked up by the OGC when +they were implementing their catalog server specification. + +.. image:: /images/gt-cql.png + +For our purposes it provides a great human readable way to expression Filter similar to an +SQL "where clause". Indeed we have our own extension that allows you to represent the full +range of GeoTools Filter and Expression ideas using simple text strings. + +**References** + +* http://en.wikipedia.org/wiki/Contextual_Query_Language +* http://www.opengeospatial.org/standards/specifications/catalog + +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-cql</artifactId> + <version>${geotools.version}</version> + </dependency> + +**Contents** + .. sidebar:: Details .. toctree:: @@ -16,18 +41,4 @@ :maxdepth: 1 cql - ecql - -References: - -* http://en.wikipedia.org/wiki/Contextual_Query_Language -* http://www.opengeospatial.org/standards/specifications/catalog - -CQL was originally known as Common Query Language (so you will find lots of examples that still refer to this name). The standard comes out of library science and was picked up by the OGC when they were implementing their catalog server specification. - - -.. image:: /images/gt-cql.png - -For our purposes it provides a great human readable way to expression Filter similar to an -SQL "where clause". Indeed we have our own extension that allows you to represent the full -range of GeoTools Filter and Expression ideas using simple text strings. \ No newline at end of file + ecql \ No newline at end of file Modified: trunk/docs/user/library/data/index.rst =================================================================== --- trunk/docs/user/library/data/index.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/data/index.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -2,7 +2,34 @@ ==== Supports access to feature information (ie vector information) from a range of data sources. +Additional DataStore plugins are available from :doc:`gt-jdbc <../jdbc/index>` for database access. +The Data module is all about hoisting data (usually in the form of features) off of external +services, disk files etc... into your application. This is where you can finally start putting +the toolkit to work. + +.. image:: /images/gt-data.png + +The gt-data module is the foundation for implementing additional :doc:`gt-api <../api/index>` +DataStore formats: + +* Abstract classes for :doc:`gt-api <../api/index>` DataStore implementors to start from such + as **ContentDataStore** and **DirectoryDataStore** + +The gt-data module requires plug ins for different formats to be supplied. This module does not +define any additional interfaces beyond those provided by *gt-api*. + +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-data</artifactId> + <version>${geotools.version}</version> + </dependency> + +**Contents** + + .. sidebar:: Details .. toctree:: @@ -48,16 +75,3 @@ wfs wfs-ng vpf - - -Additional DataStore plugins are available from :doc:`gt-jdbc <../jdbc/index>` for database access. - -The Data module is all about hoisting data (usually in the form of features) off of external services, disk files etc... into your application. This is where you can finally start putting the toolkit to work. - -.. image:: /images/gt-data.png - -The gt-data module is the foundation for implementing additional :doc:`gt-api <../api/index>` DataStore formats: - -* Abstract classes for :doc:`gt-api <../api/index>` DataStore implementors to start from such as **ContentDataStore** and **DirectoryDataStore** - -The gt-data module requires plug ins for different formats to be supplied. The module does not define any additional interfaces. Modified: trunk/docs/user/library/jdbc/index.rst =================================================================== --- trunk/docs/user/library/jdbc/index.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/jdbc/index.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -1,8 +1,24 @@ JDBC ==== -Supports accessing information databases using the Java JDBC library. +Supports accessing feature information databases using the Java JDBC library. +.. image:: /images/gt-jdbc.png + +The JDBC module is used as the base for all JDBC / Database backed DataStores. Alone it does not +contain any useful functionality. The useful functionality is contained within modules specific +to a particular database. + +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-jdbc</artifactId> + <version>${geotools.version}</version> + </dependency> + +**Contents** + .. sidebar:: Details .. toctree:: @@ -35,8 +51,4 @@ .. toctree:: :maxdepth: 1 - ingres - -The JDBC module is used as the base for all JDBC/database backed datastores. Alone it does not contain any useful functionality. The useful functionality is contained within modules specific to a particular database. - -.. image:: /images/gt-jdbc.png + ingres \ No newline at end of file Modified: trunk/docs/user/library/jts/index.rst =================================================================== --- trunk/docs/user/library/jts/index.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/jts/index.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -2,8 +2,38 @@ JTS === -The JTS Topology Suite is an external project that GeoTools uses to provide an implementation of the Geometry data structure. The major benefit is the numerically stable geometry operations as a result of years of dedicated effort. +The JTS Topology Suite is an external project that GeoTools uses to provide an implementation of +the Geometry data structure. The major benefit is the numerically stable geometry operations as a +result of years of dedicated effort. +.. image:: /images/gt-jts.png + +GeoTools is all about implementing spatial solutions, and we do our very best to follow a don't +invent here policy (rather than get off topic). The excellent **JTS Topology Suite** project offers +an implementation of Geometry which we use throughout our library. + +The GeoTools provides some help for working with JTS: + +* :doc:`gt-api <../api/index>` offers helper classes such as JTS and Geometries +* :doc:`gt-main <../main/index>` offers helper classes to translate Geometry into a Java Shape + +**References** + +* http://sourceforge.net/projects/jts-topo-suite/ +* http://tsusiatsoftware.net/jts/main.html +* http://www.vividsolutions.com/jts/bin/JTS%20Developer%20Guide.pdf +* http://www.vividsolutions.com/jts/bin/JTS%20Technical%20Specs.pdf + +**Maven**:: + + <dependency> + <groupId>com.vividsolutions</groupId> + <artifactId>jts</artifactId> + <version>1.12</version> + </dependency> + +**Contents** + .. sidebar:: Details .. toctree:: @@ -24,20 +54,3 @@ snap ring combine - -GeoTools is all about implementing spatial solutions, and we do our very best to follow a don't invent here policy (rather than get off topic). -The excellent **JTS Topology Suite** project offers an implementation of Geometry which we use throughout our library. - -.. image:: /images/gt-jts.png - -The GeoTools provides some help for working with JTS: - -* :doc:`gt-api <../api/index>` offers helper classes such as JTS and Geometries -* :doc:`gt-main <../main/index>` offers helper classes to translate Geometry into a Java Shape - -References: - -* http://sourceforge.net/projects/jts-topo-suite/ -* http://tsusiatsoftware.net/jts/main.html -* http://www.vividsolutions.com/jts/bin/JTS%20Developer%20Guide.pdf -* http://www.vividsolutions.com/jts/bin/JTS%20Technical%20Specs.pdf Modified: trunk/docs/user/library/main/index.rst =================================================================== --- trunk/docs/user/library/main/index.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/main/index.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -1,8 +1,30 @@ Main ==== -Implementation of core geospatial data models. +The gt-main module provides default implementations for the remaining *gt-api* and *gt-opengis* +interfaces (Filter, Style, Feature etc...) and enough glue code to make creating an application +possible (various builders and utility classes). +.. image:: /images/gt-main.png + +The gt-main module is responsible for: + +* Default implementation :doc:`gt-opengis <../opengis/index>` interfaces for Feature, FeatureType and Filter and Style +* Default set of :doc:`gt-opengis <../api/convert>` Converters supporting basic Java types +* Default set of :doc:`gt-opengis <../opengis/filter>` Functions for working with spatial data +* Helper classes for your own application development such as *DataUtilities* and *SimpleFeatureTypeBuilder* +* Abstract classes to help implementors of :doc:`gt-api <../api/index>` DataStore + +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-main</artifactId> + <version>${geotools.version}</version> + </dependency> + +**Contents** + .. sidebar:: Details .. toctree:: @@ -21,20 +43,7 @@ shape geometry repository - -The gt-main module provides default implementations for the remaining gt-api and gt-opengis interfaces (Filter, Style, Feature etc...) and enough glue code to make creating an application possible (various builders and utility classes). - - -.. image:: /images/gt-main.png - -The gt-main module is responsible for: - -* Default implementation :doc:`gt-opengis <../opengis/index>` interfaces for Feature, FeatureType and Filter and Style -* Default set of :doc:`gt-opengis <../api/convert>` Converters supporting basic Java types -* Default set of :doc:`gt-opengis <../opengis/filter>` Functions for working with spatial data -* Helper classes for your own application development such as *DataUtilities* and *SimpleFeatureTypeBuilder* -* Abstract classes to help implementors of :doc:`gt-api <../api/index>` DataStore - + **SOSNOKILLLICENSE** The file **DateUtils** requires that this license be included with your GeoTools documentation.:: Modified: trunk/docs/user/library/metadata/index.rst =================================================================== --- trunk/docs/user/library/metadata/index.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/metadata/index.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -1,8 +1,35 @@ Metadata ======== -Metadata is used by GeoTools to describe GeoSpatial information and services. The data structure is an implementation of ISO19115 (for metadata describing spatial data). +Metadata is used by GeoTools to describe GeoSpatial information and services. The data structure +is an implementation of ISO19115 (for metadata describing spatial data). +.. image:: /images/gt-metadata.png + +The gt-metadata module also pulls double duty as the first implementation module it is responsible for providing +the facilities we use to wire the library together at runtime. + +The gt-metadata module is responsible for: + +* implementation of the metadata interfaces from :doc:`gt-opengis <../opengis/index>` such as Citation and Identifier +* Configuring the library at runtime with **GeoTools** and **FactoryRegistery** and **Logging** facilities +* Utility classes with helpful implementations for Collections, Caching and Object pools + +**References** + +* ISO 19115 +* ISO 19119 + +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-metadata</artifactId> + <version>${geotools.version}</version> + </dependency> + +**Contents** + .. sidebar:: Details .. toctree:: @@ -17,20 +44,4 @@ metadata geotools range - text - -The gt-metadata module also pulls double duty as the first implementation module it is responsible for providing -the facilities we use to wire the library together at runtime. - -.. image:: /images/gt-metadata.png - -The gt-metadata module is responsible for: - -* implementation of the metadata interfaces from :doc:`gt-opengis <../opengis/index>` such as Citation and Identifier -* Configuring the library at runtime with **GeoTools** and **FactoryRegistery** and **Logging** facilities -* Utility classes with helpful implementations for Collections, Caching and Object pools - -References: - -* ISO 19115 -* ISO 19119 \ No newline at end of file + text \ No newline at end of file Modified: trunk/docs/user/library/opengis/index.rst =================================================================== --- trunk/docs/user/library/opengis/index.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/opengis/index.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -1,8 +1,40 @@ OpenGIS ======= -Interfaces for GeoSpatial concepts, often defined by the OGC or ISO standards bodies. The interfaces in this module serve as a great reference if you do not have the time to purchase and read the official standards documents. Approach the standards using an environment you are comfortable with - Java! +Interfaces for GeoSpatial concepts, often defined by the OGC or ISO standards bodies. The interfaces +in this module serve as a great reference if you do not have the time to purchase and read +the official standards documents. Approach the standards using an environment you +are comfortable with - Java! +.. image:: /images/gt-opengis.png + +GeoTools is all about implementing spatial solutions, and we do our very best to follow a don't +invent here policy (rather than get off topic). By referencing standards we are able to use well +understood names for common spatial ideas and constructs. + +The *gt-opengis* module provides: + +* interfaces implemented by :doc:`gt-main <../main/index>` such as Feature, FeatureType, Filter and Function +* interfaces implemented by :doc:`gt-coverage <../referencing/index>` such as GridCoverage +* interfaces implemented by :doc:`gt-referencing <../referencing/index>` such as CoordinateReferenceSystem +* interfaces implemented by :doc:`gt-metadata <../metadata/index>` such as Citation + +For more information on the standards covered by the library as whole: :ref:`standards` + +**Reference** + +* http://www.opengeospatial.org/standards + +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-opengis</artifactId> + <version>${geotools.version}</version> + </dependency> + +**Contents** + .. sidebar:: Details .. toctree:: @@ -25,19 +57,4 @@ name text parameter - unit - -GeoTools is all about implementing spatial solutions, and we do our very best to follow a don't invent here policy (rather than get off topic). By referencing standards we are able to use well understood names for common spatial ideas and constructs. - -.. image:: /images/gt-opengis.png - -The gt-opengis module provides: - -* interfaces implemented by :doc:`gt-main <../main/index>` such as Feature, FeatureType, Filter and Function -* interfaces implemented by :doc:`gt-coverage <../referencing/index>` such as GridCoverage -* interfaces implemented by :doc:`gt-referencing <../referencing/index>` such as CoordinateReferenceSystem -* interfaces implemented by :doc:`gt-metadata <../metadata/index>` such as Citation - -For more information on the standards covered by the library as whole: - -* :ref:`standards` \ No newline at end of file + unit \ No newline at end of file Modified: trunk/docs/user/library/referencing/index.rst =================================================================== --- trunk/docs/user/library/referencing/index.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/referencing/index.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -5,6 +5,44 @@ coordinates. Includes implementation of CoordinateReferenceSystem (CRS), conversion and transformation services. +.. image:: /images/gt-referencing.png + + +The gt-referencing module is our first example that makes use of the plugin system provided +by :doc:`gt-metadata <../metadata/index>`. It does require a little bit of care when configuring +the module with appropriate epsg authority. + +The gt-referencing module is responsible for: + +* Implementation of the referencing interfaces from :doc:`gt-opengis <../opengis/index>` such + as CoordinateReferenceSystem and MathTransform +* Providing a definition for common spatial reference system codes using plugins available + on the CLASSPATH + + +This module is basically care and feeding for the CoordinateReferenceSystem class - and enough +math to make it useful. Before you get too worried it is easy to use (There is a class called +CRS that has helper methods for reprojection and stuff). + +**References** + +* http://www.epsg-registry.org/ + +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-referencing</artifactId> + <version>${geotools.version}</version> + </dependency> + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-epsg-hsql</artifactId> + <version>${geotools.version}</version> + </dependency> + +**Contents** + .. sidebar:: Details .. toctree:: @@ -42,25 +80,4 @@ :maxdepth: 1 h2 - oracle - -The gt-referencing module is our first example that makes use of the plugin system provided -by :doc:`gt-metadata <../metadata/index>`. It does require a little bit of care when configuring -the module with appropriate epsg authority. - -.. image:: /images/gt-referencing.png - -The gt-referencing module is responsible for: - -* Implementation of the referencing interfaces from :doc:`gt-opengis <../opengis/index>` such - as CoordinateReferenceSystem and MathTransform -* Providing a definition for common spatial reference system codes using plugins available - on the CLASSPATH - -References: - -* http://www.epsg-registry.org/ - -This module is basically care and feeding for the CoordinateReferenceSystem class - and enough -math to make it useful. Before you get too worried it is easy to use (There is a class called -CRS that has helper methods for reprojection and stuff). \ No newline at end of file + oracle \ No newline at end of file Modified: trunk/docs/user/library/render/index.rst =================================================================== --- trunk/docs/user/library/render/index.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/render/index.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -3,6 +3,37 @@ Supports the rendering of geospatial information using the Java2D api. +.. image:: /images/gt-render.png + +This is most likely the reason you are interested in the GeoTools library - this module finally +lets you draw a map using all that data you set up. + +**Reference** + +* :doc:`/library/opengis/se` +* :doc:`/library/api/sld` +* http://www.opengeospatial.org/standards/sld +* http://www.opengeospatial.org/standards/se + +**Tutorial** + +* :doc:`style </tutorial/map/style>` (tutorial) + +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-referencing</artifactId> + <version>${geotools.version}</version> + </dependency> + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-epsg-hsql</artifactId> + <version>${geotools.version}</version> + </dependency> + +**Contents** + .. sidebar:: Details .. toctree:: @@ -33,12 +64,3 @@ wkt shapefile - -References: - -* :doc:`style </tutorial/map/style>` (tutorial) - -This is most likely the reason you are interested in the GeoTools library - this module finally lets you draw a map using all that data you set up. - - -.. image:: /images/gt-render.png \ No newline at end of file Modified: trunk/docs/user/library/xml/index.rst =================================================================== --- trunk/docs/user/library/xml/index.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/library/xml/index.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -3,6 +3,24 @@ Supports the parsing and encoding of geospatial information using XML. +.. image:: /images/gt-xml.png + +There are a large number of supporting plugins capturing xml schemas, and "bindings" mapping +these ideas into concrete Java objects. + +The Geotools library has spent a lot of time and energy on this problem, this document introduces +you to what is available. + +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-xml</artifactId> + <version>${geotools.version}</version> + </dependency> + +**Contents** + .. sidebar:: Details .. toctree:: @@ -17,9 +35,3 @@ geometry filter style - -There are a large number of supporting plugins capturing xml schemas, and "bindings" mapping these ideas into concrete Java objects. - -.. image:: /images/gt-xml.png - -The Geotools library has spent a lot of time and energy on this problem, this document introduces you to what is available. \ No newline at end of file Modified: trunk/docs/user/tutorial/advanced/index.rst =================================================================== --- trunk/docs/user/tutorial/advanced/index.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/tutorial/advanced/index.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -1,5 +1,3 @@ -.. _advanced: - Advanced Tutorials ------------------ @@ -25,8 +23,4 @@ contentdatastore For the extension and integration of GeoTools it is worth starting with :doc:`function` above -as it provides an cooks tour of the plugin system. - -References: - -* :doc:`/advanced/index` \ No newline at end of file +as it provides an cooks tour of the plugin system. \ No newline at end of file Modified: trunk/docs/user/tutorial/index.rst =================================================================== --- trunk/docs/user/tutorial/index.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/tutorial/index.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -6,6 +6,13 @@ Welcome to the GeoTools tutorial material. These workbooks are provided as part of an introduction to GIS workshop making use of examples from GeoTools and other Java libraries. +.. sidebar: OSDC + + Have you signed up for the `Open Source Developers Conference 2011 <http://osdc.com.au/>`_ Canberra and + the `GeoTools Mini Conference <http://osdc.com.au/miniconfs/#geotools>`_? + + This course will be run on *November 14* and we hope to see you there! + .. toctree:: :maxdepth: 1 Modified: trunk/docs/user/tutorial/quickstart/eclipse.rst =================================================================== --- trunk/docs/user/tutorial/quickstart/eclipse.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/tutorial/quickstart/eclipse.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -4,8 +4,6 @@ :Version: |release| :License: Create Commons with attribution -.. _eclipse-quickstart: - ********************** Eclipse Quickstart ********************** Modified: trunk/docs/user/tutorial/quickstart/netbeans.rst =================================================================== --- trunk/docs/user/tutorial/quickstart/netbeans.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/tutorial/quickstart/netbeans.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -4,8 +4,6 @@ :Version: |release| :License: Create Commons with attribution -.. _netbeans-quickstart: - ********************** Netbeans Quickstart ********************** Modified: trunk/docs/user/tutorial/raster/image.rst =================================================================== --- trunk/docs/user/tutorial/raster/image.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/tutorial/raster/image.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -150,10 +150,7 @@ 4. To display color we need to use a slightly more complex Style that specifies which bands in the grid coverage map to the R, G and B colors on screen. - - While this will be very easy for a simple color image; it can be harder for things like - satellite images where none of the bands quite line up with what human eyes see. - + The methods checks the image to see if its bands (known as *sample dimensions*) have labels indicating which to use. If not, we just use the first three bands and hope for the best ! @@ -162,6 +159,10 @@ :start-after: // docs start create rgb style :end-before: // docs end source +5. Please note that the above technique (checking colour bands) is specific to RGB images. + While this is easy for a simple color image; it can be harder for things like + satellite images where none of the bands quite line up with what human eyes see. + Running the application ======================= @@ -226,14 +227,28 @@ world plus image A normal image format like jpeg or png that has a side-car file describing where it is located as well as a prj sidecar file defining the map projection just like a shapefile uses. + + * jpeg - is common due to small download size; however performance at runtime is terrible as + the entire image needs be read into memory. + + * tiff + + * Geotiff - A normal tiff image that has geospatial information stored in the image metadata fields. + A normal tiff image that has geospatial information stored in the image metadata fields. This + is generally a safe bet for fast performnace; especially if it has been prepaired with an + internal overlay (which can be used when zoomed out) or internal tiling (allowing for fast + pans when zoomed in. + + Performs best when your computer has faster disks than CPUs. JPEG2000 The sequel to jpeg that uses wavelet compression to handle massive images. The file format also supports metadata fields that can be used to store geospatial information. - + + This format performs best when you have more faster CPUs than disk access. + There are also more exotic formats such as ECW and MRSID that can be supported if you have installed the imageio-ext project into your JRE. Modified: trunk/docs/user/unsupported/efeature/index.rst =================================================================== --- trunk/docs/user/unsupported/efeature/index.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/unsupported/efeature/index.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -3,3 +3,10 @@ The EFeature DataStore module adds support for spatial read and write operations to (any) EMF model. +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-efeature</artifactId> + <version>${geotools.version}</version> + </dependency> Modified: trunk/docs/user/unsupported/geometry/index.rst =================================================================== --- trunk/docs/user/unsupported/geometry/index.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/unsupported/geometry/index.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -1,22 +1,26 @@ Geometry Plugin --------------- -The Geometry module creates and manipulates geometric objects such as Points, Curves, and Surfaces. Users of this module can assemble the factories needed to create the various objects they will use, use the factories to make the objects, and then manipulate the objects directly. +The Geometry module creates and manipulates geometric objects such as Points, Curves, and Surfaces. +Users of this module can assemble the factories needed to create the various objects they will use, +use the factories to make the objects, and then manipulate the objects directly. -.. toctree:: - :maxdepth: 1 +**Volunteer Needed** - build - operation +This module currently has support for 2D objects; with the addition of 2.5D and 3D pending a +willing volunteer. -This module currently has support for 2D objects; with the addition of 2.5D and 3D pending a willing volunteer. +Internally some of the operations are a fork of the Java Topology Suite code base, since this +is also an LGPL project we are within the license restrictions of the JTS project. -Internally some of the operations are a fork of the Java Topology Suite code base, since this is also an LGPL project we are within the license restrictions of the JTS project. +The module was created in 2007 with an initial implementation of 2D objects completed by late +summer 2007. Hopefully this module will eventually become one of the core implementations used +by the GeoTools library. -The module was created in 2007 with an initial implementation of 2D objects completed by late summer 2007. Hopefully this module will eventually become one of the core implementations used by the GeoTools library. +This module is not currently "hooked-up" to anything in GeoTools, however the GeoTools feature +module can support additional geometry implementations such as ISO Geometry if people are willing +to put in the effort. -This module is not currently "hooked-up" to anything in GeoTools, however the GeoTools feature module can support additional geometry implementations such as ISO Geometry if people are willing to put in the effort. - .. note:: ISO 19107 Geometry Interfaces @@ -28,4 +32,20 @@ Users of the objects created by this module should therefore make instances using factories and then use only the methods defined in the gt-opengis javadocs to avoid accidentally depending on any specific - implementation details. \ No newline at end of file + implementation details. + +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-geometry</artifactId> + <version>${geotools.version}</version> + </dependency> + +**Contents** + +.. toctree:: + :maxdepth: 1 + + build + operation \ No newline at end of file Modified: trunk/docs/user/unsupported/index.rst =================================================================== --- trunk/docs/user/unsupported/index.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/unsupported/index.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -11,7 +11,7 @@ The following modules are provided for your amusement only to encourage collaborate on making these modules part of our library: -**Research and Development** +Research and Development: .. toctree:: :maxdepth: 1 @@ -30,7 +30,7 @@ Modules under active development: -* :doc:`process/index` * API for working with GeoSpatial processes and annotations to make defining additional processes easy +* :doc:`process/index` - API for working with GeoSpatial processes and annotations to make defining additional processes easy * :doc:`swing/index` - collection of GUI components and utilities based on the Swing framework * :doc:`swt/index` - collection of GUI components and utilities based on the SWT framework * :doc:`grid` - generates vector grids (lattices) of polygons or lines Modified: trunk/docs/user/unsupported/postgis-versioned/index.rst =================================================================== --- trunk/docs/user/unsupported/postgis-versioned/index.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/unsupported/postgis-versioned/index.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -1,4 +1,12 @@ PostGIS Versioned ================= -Builds a data model supporting feature revisions on top of the PostGIS datastore. \ No newline at end of file +Builds a data model supporting feature revisions on top of the PostGIS datastore. + +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-postgis-versioned<</artifactId> + <version>${geotools.version}</version> + </dependency> Modified: trunk/docs/user/unsupported/process/index.rst =================================================================== --- trunk/docs/user/unsupported/process/index.rst 2011-10-30 08:42:48 UTC (rev 38285) +++ trunk/docs/user/unsupported/process/index.rst 2011-10-30 12:02:24 UTC (rev 38286) @@ -3,6 +3,31 @@ API for working with GeoSpatial processes and annotations to make defining additional processes easy. +**Maven**:: + + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-process</artifactId> + <version>${geotools.version}</version> + </dependency> + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-process-feature</artifactId> + <version>${geotools.version}</version> + </dependency> + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-process-geometry</artifactId> + <version>${geotools.version}</version> + </dependency> + <dependency> + <groupId>org.geotools</groupId> + <artifactId>gt-process-raster</artifactId> + <version>${geotools.version}</version> + </dependency> + +**Contents** + .. sidebar:: Details .. toctree:: Modified: trunk/docs/user/unsupported/swing/index.rst ===================================================... [truncated message content] |