JtsUtil (GeOxygene 1.9-SNAPSHOT API)

Object
- JtsUtil

```
public class JtsUtil
extends Object
```
Cette classe contient des fonction géométriques courantes. Elle fonctionne sur des géométries JTS.

Author:

Julien Gaffuri, Julien Perret

Field Summary

Fields
Modifier and Type Field and Description

protected static EventListenerList listenerList

Fields
Modifier and Type	Field and Description
`protected static EventListenerList`	`listenerList`

Constructor Summary

Constructors
Constructor and Description

JtsUtil()

Constructors
Constructor and Description
`JtsUtil()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`addActionListener(ActionListener l)` Adds an `ActionListener`.
`static Polygon`	`affinite(Polygon geom, Coordinate c, double angle, double coef)` Calcul de l'affinité vectorielle.
`static Polygon`	`affinite(Polygon geom, double angle, double scale)` Calcul de l'affinité vectorielle.
`static IGeometry`	`bufferPolygones(Collection<? extends IFeature> collection, double seuilBuffer)` buffer sur des features.
`static double`	`circularite(Polygon poly)` Calcule l'indice de circularité de Miller pour un polygone.
`static IPolygon`	`convexHull(IFeatureCollection<?> collection)`
`static double`	`convexite(Geometry geom)` Calcul de la convexité d'un polygone.
`static double`	`elongation(Geometry geom)` Calcul de l'élongation d'une géométrie.
`static IGeometry`	`fermeture(Collection<? extends IFeature> collection, double seuilBuffer)` fermeture sur des features.
`static Polygon`	`fermeture(Polygon polygon, double distance, double distanceTolerance, int quadrantSegments, int endCapStyle, GeometryFactory factory)` Calcul de la fermeture d'un polygone.
`static Geometry`	`fermetureSuppTrous(Geometry geometry, double distance, int quadrantSegments, int endCapStyle)` Calcul de la fermeture d'une géométrie quelconque.
`protected static void`	`fireActionPerformed(ActionEvent event)` Notifies all listeners that have registered interest for notification on this event type.
`static List<Geometry>`	`getListeGeometriesIntersectant(Geometry geom, List<Geometry> elements)` Détermine la liste des géométries appartenant à la liste elements qui intersectent la géométrie geom.
`static List<Geometry>`	`getListeGeometriesIntersectant(Point point, List<Geometry> elements)` Détermine la liste des géométries appartenant à la liste elements qui intersectent le point point.
`static Polygon`	`homothetie(Polygon geom, double scale)` Calcule l'homothétie d'une géométrie.
`static Polygon`	`homothetie(Polygon geom, double scaleX, double scaleY)` Calcule l'homothétie d'une géométrie.
`static Polygon`	`homothetie(Polygon geom, double x0, double y0, double scale)` Calcule l'homothétie d'une géométrie.
`static Polygon`	`homothetie(Polygon geom, double x0, double y0, double scaleX, double scaleY)` Calcule l'homothétie d'une géométrie.
`static double`	`orientationLigne(IDirectPosition pt1, IDirectPosition pt2)` Orientation d'une ligne (en radian, dans l'intervalle [0, Pi[, par rapport a l'axe Ox)
`static double`	`plusPetitCote(Polygon poly)` Calcule la longueur du plus petit cété d'un polygone.
`static Polygon`	`PPRE(Geometry geom)` Plus Petit Rectangle Englobant d'une géométrie.
`static Polygon`	`PPREAireCible(Geometry geom, double aireCible)` Plus Petit Rectangle Englobant d'une géométrie respectant un aire donnée.
`static Polygon`	`PPREAirePreservee(Geometry geom)` Plus Petit Rectangle Englobant d'une géométrie préservant son aire.
`static double`	`projectionPointOrientationTroncon(IDirectPosition directPosition, ILineString geometrieTroncon)` Projection d'un point(Directposition) sur une GM_LineString et retour de l'orientation du segment ayant reçu la projection (en radian, dans l'intervalle [0, Pi[, par rapport a l'axe Ox).
`static Polygon`	`rotation(Polygon geom, Coordinate c, double angle)` Effectue une rotation sur une géométrie.
`static Polygon`	`rotation(Polygon geom, double angle)` Effectue une rotation sur une géométrie autour de son centroide.
`static Polygon`	`translation(Polygon geom, double dx, double dy)` Translate une géométrie.

Methods inherited from class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - listenerList
```
protected static EventListenerList listenerList
```
- Constructor Detail
  - JtsUtil
```
public JtsUtil()
```
- Method Detail
  - addActionListener
```
public static void addActionListener(ActionListener l)
```
    Adds an ActionListener.
    
    Parameters:
    
    l - the ActionListener to be added
  - fireActionPerformed
```
protected static void fireActionPerformed(ActionEvent event)
```
    Notifies all listeners that have registered interest for notification on this event type. The event instance is lazily created.
    
    See Also:
    
    EventListenerList
  - getListeGeometriesIntersectant
```
public static List<Geometry> getListeGeometriesIntersectant(Point point,
                                                            List<Geometry> elements)
```
    Détermine la liste des géométries appartenant à la liste elements qui intersectent le point point.
    
    Parameters:
    
    point - un point
    
    elements - liste de géométries
    
    Returns:
    
    liste des géométries de la liste elements qui intersectent le point.
  - getListeGeometriesIntersectant
```
public static List<Geometry> getListeGeometriesIntersectant(Geometry geom,
                                                            List<Geometry> elements)
```
    Détermine la liste des géométries appartenant à la liste elements qui intersectent la géométrie geom.
    
    Parameters:
    
    geom - une géométrie
    
    elements - liste de géométries
    
    Returns:
    
    liste des géométries de la liste elements qui intersectent geom.
  - fermeture
```
public static Polygon fermeture(Polygon polygon,
                                double distance,
                                double distanceTolerance,
                                int quadrantSegments,
                                int endCapStyle,
                                GeometryFactory factory)
```
    Calcul de la fermeture d'un polygone.
    
    Parameters:
    
    polygon - polygone de départ
    
    distance - distance utilisée pour le buffer positif puis pour le buffer négatif
    
    distanceTolerance - distance utilisée pour la simplification par l'algorithme de Douglas-Peucker
    
    quadrantSegments - nombre de segments utilisés pour la simplification par l'algorithme de Douglas-Peucker
    
    endCapStyle - type d'approximation utilisée pour la simplification par l'algorithme de Douglas-Peucker
    
    factory - factory pour la géométrie
    
    Returns:
    
    la fermeture du polygone passé en paramètre
  - fermetureSuppTrous
```
public static Geometry fermetureSuppTrous(Geometry geometry,
                                          double distance,
                                          int quadrantSegments,
                                          int endCapStyle)
```
    Calcul de la fermeture d'une géométrie quelconque.
    
    Parameters:
    
    geometry - géométrie de départ
    
    distance - distance utilisée pour le buffer positif puis pour le buffer négatif
    
    quadrantSegments - nombre de segments utilisés pour la simplification par l'algorithme de Douglas-Peucker
    
    endCapStyle - type d'approximation utilisée pour la simplification par l'algorithme de Douglas-Peucker
    
    Returns:
    
    la fermeture ++ de la géométrie passée en paramètre
  - affinite
```
public static Polygon affinite(Polygon geom,
                               Coordinate c,
                               double angle,
                               double coef)
```
    Calcul de l'affinité vectorielle.
    
    Parameters:
    
    geom - une géométrie, a geometry
    
    c - coordonnées d'un point par lequel passe l'axe de l'affinité
    
    angle - angle de la direction de l'affinite, à partir de l'axe des x
    
    coef - coefficient de l'homothétie
    
    Returns:
    
    polygone polygone résultant de l'application de l'affinité, resulting polygon
  - affinite
```
public static Polygon affinite(Polygon geom,
                               double angle,
                               double scale)
```
    Calcul de l'affinité vectorielle. Cette Méthode utilise la Méthode prenant comme paramètre supplèmentaire les coordonnées d'un point par lequel passe l'axe de l'affinité. Ici, on utilise le centroïde de la géométrie.
    
    Parameters:
    
    geom - une géométrie, a geometry
    
    angle - angle de la direction de l'affinite, à partir de l'axe des x
    
    scale - coefficient de l'homothétie
    
    Returns:
    
    polygone résultant de l'application de l'affinité, resulting polygon
    
    See Also:
    
    affinite(Polygon, Coordinate, double, double)
  - PPREAirePreservee
```
public static Polygon PPREAirePreservee(Geometry geom)
```
    Plus Petit Rectangle Englobant d'une géométrie préservant son aire. Smallest Enclosing Rectangle of a geometry preserving its area.
    
    Parameters:
    
    geom - une géométrie, a geometry
    
    Returns:
    
    le Plus Petit Rectangle Englobant, the Smallest Enclosing Rectangle
  - PPREAireCible
```
public static Polygon PPREAireCible(Geometry geom,
                                    double aireCible)
```
    Plus Petit Rectangle Englobant d'une géométrie respectant un aire donnée. Smallest Enclosing Rectangle of a geometry with a given area.
    
    Parameters:
    
    geom - une géométrie, a geometry
    
    aireCible - aire visée, target area
    
    Returns:
    
    le Plus Petit Rectangle Englobant, the Smallest Enclosing Rectangle
  - PPRE
```
public static Polygon PPRE(Geometry geom)
```
    Plus Petit Rectangle Englobant d'une géométrie. Smallest Enclosing Rectangle of a geometry.
    
    Parameters:
    
    geom - une géométrie, a geometry
    
    Returns:
    
    le Plus Petit Rectangle Englobant, the Smallest Enclosing Rectangle
  - homothetie
```
public static Polygon homothetie(Polygon geom,
                                 double x0,
                                 double y0,
                                 double scale)
```
    Calcule l'homothétie d'une géométrie.
    
    Parameters:
    
    geom - géométrie, geometry
    
    x0 - position en X du centre de l'homothétie, X position of the center of the operation
    
    y0 - position en Y du centre de l'homothétie, Y position of the center of the operation
    
    scale - facteur d'échelle, scale factor
    
    Returns:
    
    polygon résultant de l'homothétie, resulting polygon
  - homothetie
```
public static Polygon homothetie(Polygon geom,
                                 double x0,
                                 double y0,
                                 double scaleX,
                                 double scaleY)
```
    Calcule l'homothétie d'une géométrie.
    
    Parameters:
    
    geom - géométrie, geometry
    
    x0 - position en X du centre de l'homothétie, X position of the center of the operation
    
    y0 - position en Y du centre de l'homothétie, Y position of the center of the operation
    
    scaleX - facteur d'échelle en X, X scale factor
    
    scaleY - facteur d'échelle en Y, Y scale factor
    
    Returns:
    
    polygon résultant de l'homothétie, resulting polygon
  - homothetie
```
public static Polygon homothetie(Polygon geom,
                                 double scaleX,
                                 double scaleY)
```
    Calcule l'homothétie d'une géométrie.
    
    Parameters:
    
    geom - géométrie, geometry
    
    scaleX - facteur d'échelle en X, X scale factor
    
    scaleY - facteur d'échelle en Y, Y scale factor
    
    Returns:
    
    polygon résultant de l'homothétie, resulting polygon
  - homothetie
```
public static Polygon homothetie(Polygon geom,
                                 double scale)
```
    Calcule l'homothétie d'une géométrie.
    
    Parameters:
    
    geom - géométrie, geometry
    
    scale - facteur d'échelle, scale factor
    
    Returns:
    
    polygon résultant de l'homothétie, resulting polygon
  - translation
```
public static Polygon translation(Polygon geom,
                                  double dx,
                                  double dy)
```
    Translate une géométrie. Translate a geometry.
    
    Parameters:
    
    geom - une géométrie, a geometry
    
    dx - translation suivant l'axe des x, translation along the X axis
    
    dy - translation suivant l'axe des Y, translation along the Y axis
    
    Returns:
    
    polygone résultant de la translation, resulting polygon.
  - rotation
```
public static Polygon rotation(Polygon geom,
                               Coordinate c,
                               double angle)
```
    Effectue une rotation sur une géométrie. Rotate a geometry.
    
    Parameters:
    
    geom - une géométrie, a geometry
    
    c - centre de la rotation, center of the rotation
    
    angle - angle de rotation, angle of rotation
    
    Returns:
    
    polygone résultant de la rotation, resulting polygon.
  - rotation
```
public static Polygon rotation(Polygon geom,
                               double angle)
```
    Effectue une rotation sur une géométrie autour de son centroide. Rotate a geometry around its centroid.
    
    Parameters:
    
    geom - une géométrie, a geometry
    
    angle - angle de rotation, angle of rotation
    
    Returns:
    
    polygone résultant de la rotation, resulting polygon.
  - elongation
```
public static double elongation(Geometry geom)
```
    Calcul de l'élongation d'une géométrie. L'elongation est un reel entre 0 et 1.
    - 1: carré,
    - plus proche de 0: tend vers un segment
    C'est le quotient de la largeur et de la longueur du PPRE. Par convention, le résultat vaut -999.9 si le ppre n'existe pas (géométrie nulle ou vide par exemple)
    Parameters:
    
    geom - une géométrie, a geometry
    
    Returns:
    
    l'élongation du polygone passé en paramètre, -999.9 si la géométrie est nulle ou vide.
  - orientationLigne
```
public static double orientationLigne(IDirectPosition pt1,
                                      IDirectPosition pt2)
```
    Orientation d'une ligne (en radian, dans l'intervalle [0, Pi[, par rapport a l'axe Ox)
    
    Parameters:
    
    pt1 - et pt2 les DirectPosition des points Définissant la ligne
    
    Returns:
    
    l'orientation de la ligne
  - projectionPointOrientationTroncon
```
public static double projectionPointOrientationTroncon(IDirectPosition directPosition,
                                                       ILineString geometrieTroncon)
```
    Projection d'un point(Directposition) sur une GM_LineString et retour de l'orientation du segment ayant reçu la projection (en radian, dans l'intervalle [0, Pi[, par rapport a l'axe Ox).
    
    Parameters:
    
    directPosition - un point
    
    geometrieTroncon - une géométrie
    
    Returns:
    
    l'orientation du segment (en radian, dans l'intervalle [0, Pi[, par rapport a l'axe Ox)
  - convexite
```
public static double convexite(Geometry geom)
```
    Calcul de la convexité d'un polygone. La convexité est Définie comme le rapport de l'aire du polygone par l'aire de son enveloppe convexe. La convexité prends sa valeur entre 0 (peu convexe) et 1 (parfaitement convexe). La convexité vaut -999.9 si elle n'est pas definie (quand l'enveloppe convexe est d'aire nulle)
    
    Parameters:
    
    geom - une géométrie, a geometry
    
    Returns:
    
    convexité du polygone donné en paramètre - prend sa valeur dans ]0,1] ou -999.9 si elle n'est pas definie
  - plusPetitCote
```
public static double plusPetitCote(Polygon poly)
```
    Calcule la longueur du plus petit cété d'un polygone.
    
    Parameters:
    
    poly - un polygone, a polygon
    
    Returns:
    
    longueur du plus petit cété d'un polygone
  - circularite
```
public static double circularite(Polygon poly)
```
    Calcule l'indice de circularité de Miller pour un polygone. Cet indice, compris entre 0 et 1, vaut 1 si le polygone est parfaitement circulaire et tend vers 0 pour un segment. Cet indice n'est qu'un avatar de l'indice de compacité de Gravelius K=Perimètre / (2*sqrt(PI*Aire)). On vérifie en effet simplement que K=1/sqrt(C) avec C l'indice de circularité.
    
    Parameters:
    
    poly -
    
    Returns:
    
    indice de circularité compris entre 0 et 1. Il vaut 1 si le polygone est un cercle parfait.
  - convexHull
```
public static IPolygon convexHull(IFeatureCollection<?> collection)
```
  - fermeture
```
public static IGeometry fermeture(Collection<? extends IFeature> collection,
                                  double seuilBuffer)
```
    fermeture sur des features.
    
    Parameters:
    
    collection -
    
    seuilBuffer -
    
    Returns:
    
    TODO la fermeture pose problème : à modifier !
  - bufferPolygones
```
public static IGeometry bufferPolygones(Collection<? extends IFeature> collection,
                                        double seuilBuffer)
```
    buffer sur des features.
    
    Parameters:
    
    collection -
    
    seuilBuffer -
    
    Returns:

Class JtsUtil

Field Summary

Constructor Summary

Method Summary

Methods inherited from class Object

Field Detail

listenerList

Constructor Detail

JtsUtil

Method Detail

addActionListener

fireActionPerformed

getListeGeometriesIntersectant

getListeGeometriesIntersectant

fermeture

fermetureSuppTrous

affinite

affinite

PPREAirePreservee

PPREAireCible

PPRE

homothetie

homothetie

homothetie

homothetie

translation

rotation

rotation

elongation

orientationLigne

projectionPointOrientationTroncon

convexite

plusPetitCote

circularite

convexHull

fermeture

bufferPolygones