org.kepler.gis.util

Class VectorUtilities

java.lang.Object

org.kepler.gis.util.VectorUtilities

public class VectorUtilities
extends java.lang.Object

A collection of utilities for vectors/features.

Author:

Daniel Crawl

Constructor Summary

Constructors

Constructor and Description
VectorUtilities()

Method Summary

Modifier and Type	Method and Description
static void	closeDataStores() Close all data stores opened in this thread while reading files.
static org.opengis.feature.simple.SimpleFeatureType	createEmptySchema(org.opengis.referencing.crs.CoordinateReferenceSystem defaultCRS) Create an empty feature schema
static void	main(java.lang.String[] args) For debugging, ignore.
static VectorToken	readFile(java.io.File inputFile) Create a vector token from reading a file containing features.
static VectorToken	readFile(java.io.File inputFile, java.lang.String typeNameStr) Create a vector token from a specific type in a file containing features.
static VectorToken	readFile(java.io.File inputFile, java.lang.String typeNameStr, org.opengis.referencing.crs.CoordinateReferenceSystem defaultCRS) Create a vector token from a specific type in a file containing features.
static VectorToken	readGeoJSONString(java.lang.String geoJSON) Read a string containing GeoJSON.
static VectorToken	readGeoJSONString(java.lang.String geoJSON, org.opengis.referencing.crs.CoordinateReferenceSystem defaultCRS) Read a string containing GeoJSON using a default CRS.
static org.geotools.data.simple.SimpleFeatureCollection	readGeoJSONString(java.lang.String geoJSON, org.opengis.referencing.crs.CoordinateReferenceSystem defaultCRS, org.opengis.feature.simple.SimpleFeatureType defaultType) Read a string containing GeoJSON.
static VectorToken	readGeoString(java.lang.String geoString, org.opengis.referencing.crs.CoordinateReferenceSystem defaultCRS) Read a string containing either GML or GeoJSON.
static VectorToken	readGMLString(java.lang.String gmlString) Read a string containing GML.
static VectorToken	readWFS(java.lang.String urlStr, java.lang.String typeNameStr) Get a vector token from a WFS service.
static org.geotools.data.simple.SimpleFeatureCollection	reproject(org.geotools.data.simple.SimpleFeatureCollection features, org.opengis.referencing.crs.CoordinateReferenceSystem destCRS) Reproject a set of features.
static org.geotools.data.simple.SimpleFeatureCollection	reproject(org.geotools.data.simple.SimpleFeatureCollection features, org.opengis.referencing.crs.CoordinateReferenceSystem crs, org.opengis.referencing.crs.CoordinateReferenceSystem destCRS) Reproject a set of features from the specified coordinate reference system.
static org.geotools.data.simple.SimpleFeatureCollection	setCRS(org.geotools.data.simple.SimpleFeatureCollection features, org.opengis.referencing.crs.CoordinateReferenceSystem defaultCRS) Set the coordinate reference system for a set of features.
static java.lang.String	toGeoJSONString(org.geotools.data.simple.SimpleFeatureCollection features) Convert a set of features into a GeoJSON string.

Methods inherited from class java.lang.Object

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

Constructor Detail

VectorUtilities

public VectorUtilities()

Method Detail

closeDataStores

public static void closeDataStores()

Close all data stores opened in this thread while reading files.

createEmptySchema

public static org.opengis.feature.simple.SimpleFeatureType createEmptySchema(org.opengis.referencing.crs.CoordinateReferenceSystem defaultCRS)

Create an empty feature schema

Parameters:

defaultCRS - The default CRS. can be null.

Returns:

an empty feature schema.

readFile

public static VectorToken readFile(java.io.File inputFile)
                            throws IllegalActionException,
                                   java.io.IOException

Create a vector token from reading a file containing features.

Throws:

IllegalActionException

java.io.IOException

readFile

public static VectorToken readFile(java.io.File inputFile,
                                   java.lang.String typeNameStr)
                            throws IllegalActionException,
                                   java.io.IOException

Create a vector token from a specific type in a file containing features.

Parameters:

inputFile - the file to read

typeNameStr - the feature type in the file to read. this can be null, but must be specified if more than one feature type is present in the file.

Throws:

IllegalActionException

java.io.IOException

readFile

public static VectorToken readFile(java.io.File inputFile,
                                   java.lang.String typeNameStr,
                                   org.opengis.referencing.crs.CoordinateReferenceSystem defaultCRS)
                            throws IllegalActionException,
                                   java.io.IOException

Create a vector token from a specific type in a file containing features.

Parameters:

inputFile - the file to read

typeNameStr - the feature type in the file to read. this can be null, but must be specified if more than one feature type is present in the file.

crs - The coordinate reference system used if not specified in the file.

Throws:

IllegalActionException

java.io.IOException

readGeoString

public static VectorToken readGeoString(java.lang.String geoString,
                                        org.opengis.referencing.crs.CoordinateReferenceSystem defaultCRS)
                                 throws IllegalActionException,
                                        java.io.IOException,
                                        JSONException

Read a string containing either GML or GeoJSON.

Throws:

IllegalActionException

java.io.IOException

JSONException

readGeoJSONString

public static VectorToken readGeoJSONString(java.lang.String geoJSON)
                                     throws java.io.IOException,
                                            JSONException,
                                            IllegalActionException

Read a string containing GeoJSON.

Throws:

java.io.IOException

JSONException

IllegalActionException

readGeoJSONString

public static VectorToken readGeoJSONString(java.lang.String geoJSON,
                                            org.opengis.referencing.crs.CoordinateReferenceSystem defaultCRS)
                                     throws java.io.IOException,
                                            JSONException,
                                            IllegalActionException

Read a string containing GeoJSON using a default CRS. The default CRS is only used if the GeoJSON string does not contain the CRS.

Throws:

java.io.IOException

JSONException

IllegalActionException

readGeoJSONString

public static org.geotools.data.simple.SimpleFeatureCollection readGeoJSONString(java.lang.String geoJSON,
                                                                                 org.opengis.referencing.crs.CoordinateReferenceSystem defaultCRS,
                                                                                 org.opengis.feature.simple.SimpleFeatureType defaultType)
                                                                          throws java.io.IOException,
                                                                                 JSONException,
                                                                                 IllegalActionException

Read a string containing GeoJSON.

Parameters:

geoJSON - the geojson string.

defaultCRS - CRS used if one not found in geojson string.

defaultType - feture type used if one not found in geojson string.

Returns:

Features in geojson string.

Throws:

java.io.IOException

JSONException

IllegalActionException

readGMLString

public static VectorToken readGMLString(java.lang.String gmlString)
                                 throws java.io.IOException,
                                        IllegalActionException

Read a string containing GML.

Throws:

java.io.IOException

IllegalActionException

readWFS

public static VectorToken readWFS(java.lang.String urlStr,
                                  java.lang.String typeNameStr)
                           throws java.io.IOException,
                                  IllegalActionException

Get a vector token from a WFS service.

Parameters:

urlStr - the WFS url

typeNameStr - the feature type to read. can be null, but must be specified if more than one type exists on in the WFS service.

Throws:

java.io.IOException

IllegalActionException

reproject

public static org.geotools.data.simple.SimpleFeatureCollection reproject(org.geotools.data.simple.SimpleFeatureCollection features,
                                                                         org.opengis.referencing.crs.CoordinateReferenceSystem destCRS)
                                                                  throws IllegalActionException

Reproject a set of features.

Parameters:

features - The set of features.

destCRS - The new coordinate reference system.

Returns:

The reprojected set of features.

Throws:

IllegalActionException

reproject

public static org.geotools.data.simple.SimpleFeatureCollection reproject(org.geotools.data.simple.SimpleFeatureCollection features,
                                                                         org.opengis.referencing.crs.CoordinateReferenceSystem crs,
                                                                         org.opengis.referencing.crs.CoordinateReferenceSystem destCRS)
                                                                  throws IllegalActionException

Reproject a set of features from the specified coordinate reference system.

Parameters:

features - The set of features.

crs - The source coordinate reference system.

destCRS - The new coordinate reference system.

Returns:

The reprojected set of features.

Throws:

IllegalActionException

setCRS

public static org.geotools.data.simple.SimpleFeatureCollection setCRS(org.geotools.data.simple.SimpleFeatureCollection features,
                                                                      org.opengis.referencing.crs.CoordinateReferenceSystem defaultCRS)

Set the coordinate reference system for a set of features.

toGeoJSONString

public static java.lang.String toGeoJSONString(org.geotools.data.simple.SimpleFeatureCollection features)

Convert a set of features into a GeoJSON string.

main

public static void main(java.lang.String[] args)

For debugging, ignore.