org.geotools.coverage.util

Class FeatureUtilities

Object

FeatureUtilities

public final class FeatureUtilities
extends Object

A set of utilities methods for interactions between GridCoverage and Feature. Those methods are not really rigorous; must of them should be seen as temporary implementations.

Since:

2.4

Author:

Simone Giannecchini

Field Summary

Fields

Modifier and Type	Field and Description
static FilterFactory2	DEFAULT_FILTER_FACTORY
static PropertyName	GRID_PROPERTY_NAME
static PropertyName	PARAMS_PROPERTY_NAME

Method Summary

Modifier and Type	Method and Description
static double	area(Point2D[] polyPoints) Function to calculate the area of a polygon, according to the algorithm defined at http://local.wasp.uwa.edu.au/~pbourke/geometry/polyarea/
static Polygon	convertPolygon(Polygon roiInput, MathTransform worldToGridTransform) Converts a JTS Polygon, which represents a ROI, int an AWT Polygon by means of the provided MathTransform.
static Polygon	convertPolygonToPointArray(Polygon roiInput, MathTransform worldToGridTransform, List<Point2D> points) Converts a JTS Polygon, which represents a ROI, int an AWT Polygon by means of the provided MathTransform.
static Polygon	getPolygon(GeneralEnvelope env, GeometryFactory gf) Convert the crop envelope into a polygon and the use the world-to-grid transform to get a ROI for the source coverage.
static Polygon	getPolygon(Rectangle2D rect, int srid) Returns the polygon surrounding the specified rectangle.
static boolean	isWrappedCoverage(SimpleFeatureType featureType) Checks if the feature type specified is a GridCoverage wrapper
static boolean	isWrappedCoverageReader(SimpleFeatureType featureType) Checks if the feature type specified is a GridCoverage2DReader wrapper
static SimpleFeatureCollection	wrapGridCoverage(GridCoverage2D coverage) Wraps a grid coverage into a Feature.
static SimpleFeatureCollection	wrapGridCoverageReader(GridCoverage2DReader gridCoverageReader, GeneralParameterValue[] params) Wraps a grid coverage into a Feature.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_FILTER_FACTORY

public static final FilterFactory2 DEFAULT_FILTER_FACTORY

GRID_PROPERTY_NAME

public static final PropertyName GRID_PROPERTY_NAME

PARAMS_PROPERTY_NAME

public static final PropertyName PARAMS_PROPERTY_NAME

Method Detail

getPolygon

public static Polygon getPolygon(Rectangle2D rect,
                                 int srid)

Returns the polygon surrounding the specified rectangle. Code lifted from ArcGridDataSource (temporary).

wrapGridCoverage

public static SimpleFeatureCollection wrapGridCoverage(GridCoverage2D coverage)
                                                throws TransformException,
                                                       SchemaException

Wraps a grid coverage into a Feature. Code lifted from ArcGridDataSource (temporary).

Parameters:

coverage - the grid coverage.

Returns:

a feature with the grid coverage envelope as the geometry and the grid coverage itself in the "grid" attribute.

Throws:

TransformException

SchemaException

isWrappedCoverage

public static boolean isWrappedCoverage(SimpleFeatureType featureType)

Checks if the feature type specified is a GridCoverage wrapper

wrapGridCoverageReader

public static SimpleFeatureCollection wrapGridCoverageReader(GridCoverage2DReader gridCoverageReader,
                                                             GeneralParameterValue[] params)
                                                      throws TransformException,
                                                             FactoryRegistryException,
                                                             SchemaException

Wraps a grid coverage into a Feature. Code lifted from ArcGridDataSource (temporary).

Parameters:

gridCoverageReader - the grid coverage reader.

Returns:

a feature with the grid coverage envelope as the geometry and the grid coverage itself in the "grid" attribute.

Throws:

TransformException

FactoryRegistryException

SchemaException

isWrappedCoverageReader

public static boolean isWrappedCoverageReader(SimpleFeatureType featureType)

Checks if the feature type specified is a GridCoverage2DReader wrapper

convertPolygon

public static Polygon convertPolygon(Polygon roiInput,
                                     MathTransform worldToGridTransform)
                              throws TransformException

Converts a JTS Polygon, which represents a ROI, int an AWT Polygon by means of the provided MathTransform.

Parameters:

roiInput - the input ROI as a JTS Polygon.

worldToGridTransform - the MathTransform to apply to the input ROI.

Returns:

an AWT Polygon.

Throws:

TransformException - in case the provided MathTransform chokes.

convertPolygonToPointArray

public static Polygon convertPolygonToPointArray(Polygon roiInput,
                                                 MathTransform worldToGridTransform,
                                                 List<Point2D> points)
                                          throws TransformException

Converts a JTS Polygon, which represents a ROI, int an AWT Polygon by means of the provided MathTransform.

It also stores the points for this polygon into the provided List.

Parameters:

roiInput - the input ROI as a JTS Polygon.

worldToGridTransform - the MathTransform to apply to the input ROI.

points - a List that should hold the transformed points.

Returns:

an AWT Polygon.

Throws:

TransformException - in case the provided MathTransform chokes.

getPolygon

public static Polygon getPolygon(GeneralEnvelope env,
                                 GeometryFactory gf)
                          throws IllegalStateException,
                                 MismatchedDimensionException

Convert the crop envelope into a polygon and the use the world-to-grid transform to get a ROI for the source coverage.

Throws:

IllegalStateException

MismatchedDimensionException

area

public static double area(Point2D[] polyPoints)

Function to calculate the area of a polygon, according to the algorithm defined at http://local.wasp.uwa.edu.au/~pbourke/geometry/polyarea/

Parameters:

polyPoints - array of points in the polygon

Returns:

area of the polygon defined by pgPoints