[FrontPage] [TitleIndex] [WordIndex

API subsystems in deegree2

This page describes the software modules which the deegree framework consists of, and which provide the functionality that the clients and services use internally.

1. Geometries

  1. deegree's geometry API bases on ISO 19107 specification
  2. suppoted are: Points, Curves, Surfaces, Rings, Arcs, Circles, CompositeSurfaces, MultiPoints, MultiCurves, MultiSurfaces and GeometryCollections

  3. there adapter classes available for GML, WKT, JTS, Oracle and Postgis geometries.
  4. GML adapter supports GML 2.1 and 3.1 for wrapping and GML 3.1 for exporting geometries
  5. geometries can be transformed from into any CRS known by deegree
  6. most topological and geometric operations are supported

2. Raster Data

  1. deegree supports several raster formats
    • tif, jpeg, png, bmp and gif georeferenced by a worldfile and GeoTiff

    • 16 BIT and 32 BIT tiff and GeoTiff are supported as data container (e.g. for DEM)

    • ECW
    • Oracle GeoRaster

  2. georeferenced raster can be transformed into any CRS supported by deegree
  3. readers/converters are available in deegree for
    • ArcGrid (text)

    • raw byte, int, float and double rasters (like idrisi .img)
    • x,y,z formated text files can be converted into tiffs even if koordinates are not regular
  4. Raster can be spatially indexed and arranged in a resolution pyramid
  5. deegree supports creating and updating a spatial index for raster data
  6. the index can be stored in shapefiles or in a postgis database
  7. creating a spatial index deegree also creates a resolution pyramid for fast accessing different raster resolutions.

3. Feature Model

The feature model is used to represent feature objects in memory. Important use cases are the reading of GML feature collection documents or the requesting of FeatureCollection from a WFS. In both cases, the features are represented as feature objects. Some

  1. Supports complex features.
  2. Lookup of properties by !XPath, this is especially useful for complex features.
  3. Evaluation of filter predicates (find features from a feature collection that match a filter expression).
  4. Works with and without type information (feature types).
  5. If a feature is persistent (i.e. stored, or to be stored in a datastore), it's feature type is a MappedFeatureType, which carries the mapping information.

4. Vector Data

4.1. Mapinfo Interchange Format MIF/MID

Two readers exist, one based on MapInfo 8.5 documentation, one based on an older version. The newer one is capable of extracting most geometries, and can also extract most features of the styling information and convert it to SLD (if you have some graphics files necessary for fill patterns etc.).

4.2. ESRI shape file format

Two readers exist:

5. Quadtrees in deegree

There are several Quadtree index implementations in deegree.

One is a database based implementation that can build a quadtree in a non-spatial DB. Insert/update/delete operations are supported.

Another one is a memory based implementation that can only hold points, and does not support the update operation.

6. Rendering

7. CRS

  1. Following projections are currently supported:
    • Lambert Azimuthal Equal Area
    • Stereographic Azimuthal (Alternative)
    • Lambert Conformal Conic
    • Transverse Mercator (Cassini-Soldner)
  2. Following transformations are supported:
    • Prime-Meridian rotation
    • 3-7 Parameter Helmert transformation
    • Geographic to Geodetic (2d->3d) transformation with height above ellipsoid

    • Direct polynomial transformations (Least square approximation) using jai.
  3. Following types can be used:
    • Projection (see above)
    • Transformation (see above)
    • Ellipsoid
    • Prime meridian
    • Axis
    • Datums:
      • Geodetic (uses ellipsoid, prime meridian and an optional Helmert transformation
      • Vertical
    • Coordinate Systems:
      • Geographic - two Axis, a geodetic datum
      • Projected - two axis, geographic crs and a projection
      • Geodetic - three axis, geodetic datum
      • Compound - projected with height axis
  4. Axis order is supported
  5. Default transformation-path uses helmert transformation and the wgs84 pivot crs.
  6. Following configuration types are supported:
    • deegree's own crs configuration
    • rudimentary proj4 support
    • rudimentary gml 3.2.1 dictionary support
  7. Following configuration can be exported:
    • deegree crs configuration.
  8. Tests for crs package exist
  9. Tools and utility classes using the crs api:
    • org.deegree.model.crs.GeoTransformer: supplying many functions for transforming rasters, geometries, featurecollections and lists of points.

    • org.deegree.tools.srs.!DemoCRSTransform: tool for transforming coordinate pair or a file containing pairs
    • org.deegree.tools.srs.PolynomialParameterCreator: Create the parameters for a direct Polynomial transformation

    • org.deegree.tools.srs.SRSInfo: output all available crs's and/or check if a given crs is available
    • org.deegree.tools.srs.Transform[Raster|Shape]File: transform the given file.
  10. A web client is also available. Please read the description of deegree coordinateCalculator.


  1. Supported versions:
    • 1.0, returning of WSDL 1.1 supported
    • 1.1
  2. SOAP is implemented as Servlet filters, extracting the SOAP:Body which should contain the OGC request.

  3. SOAP with multiparts is supported
  4. Header evaluation is very rudimentary almost not existing


2018-04-20 12:03