fr.ign.cogit.geoxygene.contrib.appariement

Class EnsembleDeLiens

Object

FT_FeatureCollection<Feat>

Population<Lien>

EnsembleDeLiens

All Implemented Interfaces:

IFeatureCollection<Lien>, IPopulation<Lien>, Iterable<Lien>, Collection<Lien>

public class EnsembleDeLiens
extends Population<Lien>

Resultats de la réalisation d'un appariement : un ensemble de liens.

Version:

1.0

Author:

Mustiere / IGN Laboratoire COGIT

Field Summary

Fields inherited from class Population

dataSet, id, persistant

Fields inherited from class FT_FeatureCollection

classe, elements, featureType, flagGeom, flagTopo, listenerList, nomClasse

Constructor Summary

Constructors

Constructor and Description
EnsembleDeLiens() Constructor.
EnsembleDeLiens(boolean persistant) Constructor.
EnsembleDeLiens(Class<?> classeDesLiens) Constructor.

Method Summary

Modifier and Type	Method and Description
List<EnsembleDeLiens>	classeSelonSeuilEvaluation(List<Double> valeursClassement) Crée une liste de population en fonction des seuils sur l'evaluation passés en paramètre.
void	clear() Efface toute la liste.
void	compile(EnsembleDeLiens liensAAjouter) Ajout des liens à this.
static EnsembleDeLiens	compile(EnsembleDeLiens liens1, EnsembleDeLiens liens2) Compilation de deux listes de liens.
EnsembleDeLiens	copie() Copie d'un ensemble de liens.
void	creeGeometrieDesLiens() Affecte une géométrie à l'ensemble des liens, cette géométrie relie les centroïdes des objets concernés entre eux.
void	creeGeometrieDesLiensEntreLignesEtLignes() Affecte une géométrie à l'ensemble des liens, cette géométrie relie le milieu d'une ligne au milieu d'une ligne correspondant des objets.
void	creeGeometrieDesLiensEntreSurfacesEtLignes(boolean comparaison) Affecte une géométrie à l'ensemble des liens, cette géométrie relie le centroide d'une surface au milieu du segment correspondant des objets.
void	creeGeometrieDesLiensEntreSurfacesEtPoints(boolean comparaison) Affecte une géométrie à l'ensemble des liens, cette géométrie relie le centroïde d'une surface à un point.
void	detruitGeometrieDesLiens() Détruit la géométrie des liens.
void	evaluationLiensParCardinalite(boolean flag, double seuilCardinalite) Change l'évaluation d'un lien si celui-ci a un nombre d'objets associés à la base de comparaison (flag=true) ou à la base de référence (flag=false) supérieur au seuilCardinalite, en lui donnant la valeur nulle.
void	filtreLiens(float seuilEvaluation) Filtrage des liens, on ne retient que ceux dont l'évaluation est supérieure ou égale au seuil passé en paramètre.
String	getEvaluationGlobale()
String	getEvaluationInterne()
String	getNom()
String	getParametrage()
static List<IPopulation<IFeature>>	objetsApparies(EnsembleDeLiens ensemble, IFeatureCollection<? extends IFeature> popRef, IFeatureCollection<? extends IFeature> popComp) Méthode qui renvoie à partir d'un ensemble de liens une liste de dimension 4, avec en 1. la population issue de la population de référence qui a été appariée, en 2. la population issue de la population de comparaison qui a été appariée, en 3. la population issue de la population de référence qui n'a pas été appariée, en 4. la population issue de la population de comparaison qui n'a pas été appariée.
EnsembleDeLiens	regroupeLiens(IFeatureCollection<? extends IFeature> popRef, IFeatureCollection<? extends IFeature> popComp) Regroupement de liens pointant vers les mêmes objets.
EnsembleDeLiens	regroupeLiens(Population<? extends IFeature> popRef, Population<? extends IFeature> popComp) Regroupement de liens pointant vers les mêmes objets.
EnsembleDeLiens	regroupeLiensCartoQuiPointentSurMemeTopo() Methode de regroupement des liens 1-1 carto qui pointent sur le meme objet topo; non optimisee du tout!!!
List<EnsembleDeLiens>	scindeSelonValeursCommentaires(List<String> valeursClassement) Methode utile principalement pour analyser les résultats d'un appariement, qui découpe un réseau en plusieurs réseaux selon les valeurs de l'attribut "resultatAppariement" des arcs et noeuds du réseau apparié.
void	setEvaluationGlobale(String evaluation)
void	setEvaluationInterne(String evaluation)
void	setNom(String name)
void	setParametrage(String parameters)
CarteTopo	transformeEnCarteTopo(IFeatureCollection<? extends IFeature> popRef, IFeatureCollection<? extends IFeature> popComp) Transforme les liens, qui relient des objets de popRef et popComp, en une carte topo (graphe sans géométrie) où : - les objets de popRef et popComp sont des noeuds (sans géométrie), - les liens sont des arcs entre ces noeuds (sans géométrie).

Methods inherited from class Population

add, chargeElements, chargeElementsAvecMetadonnees, chargeElementsPartie, chargeElementsPartie, chargeElementsProches, copiePopulation, detruitPopulation, enleveElement, getDataSet, getDataSetID, getId, getIdNouvelElement, getPersistant, nouvelElement, nouvelElement, nouvelElement, selectionElementsProchesGenerale, selectionLargeElementsProches, setDataSet, setDataSetID, setId, setIdNouvelElement, setPersistant

Methods inherited from class FT_FeatureCollection

addAll, addCollection, addFeatureCollectionListener, addUnique, addUniqueCollection, contains, contains, containsAll, envelope, fireActionPerformed, get, getCenter, getClasse, getElements, getEnvelope, getFeatureType, getFlagGeom, getGeomAggregate, getNomClasse, getSpatialIndex, hasGeom, hasSpatialIndex, hasTopo, initSpatialIndex, initSpatialIndex, initSpatialIndex, initSpatialIndex, isEmpty, iterator, remove, remove, remove, removeAll, removeCollection, removeSpatialIndex, retainAll, select, select, select, select, select, setCenter, setClasse, setElements, setEnvelope, setFeatureType, setFlagGeom, setFlagTopo, setNomClasse, setSpatialIndexToExisting, size, toArray, toArray, toString

Methods inherited from class Object

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

Methods inherited from interface IFeatureCollection

addAll, addCollection, addFeatureCollectionListener, addUnique, addUniqueCollection, contains, contains, containsAll, envelope, fireActionPerformed, get, getCenter, getClasse, getElements, getEnvelope, getFeatureType, getFlagGeom, getGeomAggregate, getNomClasse, getSpatialIndex, hasGeom, hasSpatialIndex, hasTopo, initSpatialIndex, initSpatialIndex, initSpatialIndex, initSpatialIndex, isEmpty, iterator, remove, remove, remove, removeAll, removeCollection, removeSpatialIndex, retainAll, select, select, select, select, select, setCenter, setClasse, setElements, setEnvelope, setFeatureType, setFlagGeom, setFlagTopo, setNomClasse, size, toArray, toArray

Methods inherited from interface Collection

equals, hashCode, parallelStream, removeIf, spliterator, stream

Methods inherited from interface Iterable

forEach

Constructor Detail

EnsembleDeLiens

public EnsembleDeLiens()

Constructor.

EnsembleDeLiens

public EnsembleDeLiens(boolean persistant)

Constructor.

Parameters:

persistant - true if links have to be stored

EnsembleDeLiens

public EnsembleDeLiens(Class<?> classeDesLiens)

Constructor.

Parameters:

classeDesLiens - link class

Method Detail

getNom

public final String getNom()

Specified by:

getNom in interface IPopulation<Lien>

Overrides:

getNom in class Population<Lien>

setNom

public final void setNom(String name)

Specified by:

setNom in interface IPopulation<Lien>

Overrides:

setNom in class Population<Lien>

getParametrage

public final String getParametrage()

Returns:

matching parameters

setParametrage

public final void setParametrage(String parameters)

Parameters:

parameters - matching parameters

getEvaluationInterne

public final String getEvaluationInterne()

Returns:

internal evaluation

setEvaluationInterne

public final void setEvaluationInterne(String evaluation)

Parameters:

evaluation - internal evaluation

getEvaluationGlobale

public final String getEvaluationGlobale()

Returns:

global evaluation

setEvaluationGlobale

public final void setEvaluationGlobale(String evaluation)

Parameters:

evaluation - global evaluation

copie

public final EnsembleDeLiens copie()

Copie d'un ensemble de liens.

Returns:

a copy of this

compile

public static final EnsembleDeLiens compile(EnsembleDeLiens liens1,
                                            EnsembleDeLiens liens2)

Compilation de deux listes de liens.

Parameters:

liens1 - set of links

liens2 - set of links

Returns:

set of links

compile

public final void compile(EnsembleDeLiens liensAAjouter)

Ajout des liens à this. NB: modifie this.

Parameters:

liensAAjouter - links to add

regroupeLiens

public final EnsembleDeLiens regroupeLiens(Population<? extends IFeature> popRef,
                                           Population<? extends IFeature> popComp)

Regroupement de liens pointant vers les mêmes objets. Autrement dit : les liens en entrée forment un graphe entre les objets; la méthode crée un seul lien pour toute partie connexe du graphe. exemple : Ref = (A,B,C), Comp = (X,Y,Z) en entrée (this) on a 4 liens 1-1 (A-X) (B-X) (B-Y) (C-Z) en sortie on a un lien n-m (A,B)-(X-Y) et 1 lien 1-1 (C-Z)

Parameters:

popRef - reference population

popComp - comparison population

Returns:

set of links

regroupeLiens

public final EnsembleDeLiens regroupeLiens(IFeatureCollection<? extends IFeature> popRef,
                                           IFeatureCollection<? extends IFeature> popComp)

Regroupement de liens pointant vers les mêmes objets. Autrement dit : les liens en entrée forment un graphe entre les objets; la méthode crée un seul lien pour toute partie connexe du graphe. exemple : Ref = (A,B,C), Comp = (X,Y,Z) en entrée (this) on a 4 liens 1-1 (A-X) (B-X) (B-Y) (C-Z) en sortie on a un lien n-m (A,B)-(X-Y) et 1 lien 1-1 (C-Z)

Parameters:

popRef - reference population

popComp - comparison population

Returns:

set of links

transformeEnCarteTopo

public final CarteTopo transformeEnCarteTopo(IFeatureCollection<? extends IFeature> popRef,
                                             IFeatureCollection<? extends IFeature> popComp)

Transforme les liens, qui relient des objets de popRef et popComp, en une carte topo (graphe sans géométrie) où : - les objets de popRef et popComp sont des noeuds (sans géométrie), - les liens sont des arcs entre ces noeuds (sans géométrie).

Parameters:

popRef - reference population

popComp - comparison population

Returns:

topological map

regroupeLiensCartoQuiPointentSurMemeTopo

public final EnsembleDeLiens regroupeLiensCartoQuiPointentSurMemeTopo()

Methode de regroupement des liens 1-1 carto qui pointent sur le meme objet topo; non optimisee du tout!!!

Returns:

EnsembleDeLiens

filtreLiens

public final void filtreLiens(float seuilEvaluation)

Filtrage des liens, on ne retient que ceux dont l'évaluation est supérieure ou égale au seuil passé en paramètre.

Parameters:

seuilEvaluation - evaluation threshold

evaluationLiensParCardinalite

public final void evaluationLiensParCardinalite(boolean flag,
                                                double seuilCardinalite)

Change l'évaluation d'un lien si celui-ci a un nombre d'objets associés à la base de comparaison (flag=true) ou à la base de référence (flag=false) supérieur au seuilCardinalite, en lui donnant la valeur nulle. Si le seuil n'est pas dépassé, l'évaluation du lien reste ce qu'elle est.

Parameters:

flag - : true si l'on s'intéresse aux objets de la base de comparaison des liens, false s'il s'agit de la base de référence

seuilCardinalite - : seuil au dessus duquel la méthode affecte une évaluation nulle au lien

classeSelonSeuilEvaluation

public final List<EnsembleDeLiens> classeSelonSeuilEvaluation(List<Double> valeursClassement)

Crée une liste de population en fonction des seuils sur l'evaluation passés en paramètre. Exemple: si la liste en entree contient 2 "Double" (0.5, 1), alors renvoie 3 populations avec les liens ayant respectivement leur évaluation... 0: inférieur à 0.5 (strictement) 1: entre 0.5 et 1 (strictement sur 1) 2: supérieur ou égal à 1

Parameters:

valeursClassement - sorting values

Returns:

a list of sets of links

creeGeometrieDesLiens

public final void creeGeometrieDesLiens()

Affecte une géométrie à l'ensemble des liens, cette géométrie relie les centroïdes des objets concernés entre eux.

creeGeometrieDesLiensEntreLignesEtLignes

public final void creeGeometrieDesLiensEntreLignesEtLignes()

Affecte une géométrie à l'ensemble des liens, cette géométrie relie le milieu d'une ligne au milieu d'une ligne correspondant des objets.

creeGeometrieDesLiensEntreSurfacesEtLignes

public final void creeGeometrieDesLiensEntreSurfacesEtLignes(boolean comparaison)

Affecte une géométrie à l'ensemble des liens, cette géométrie relie le centroide d'une surface au milieu du segment correspondant des objets.

Parameters:

comparaison - : true si les objets de la BD de comparaison sont des lignes; false s'il s'agit des objets de la BD de référence

creeGeometrieDesLiensEntreSurfacesEtPoints

public final void creeGeometrieDesLiensEntreSurfacesEtPoints(boolean comparaison)

Affecte une géométrie à l'ensemble des liens, cette géométrie relie le centroïde d'une surface à un point.

Parameters:

comparaison - : true si les objets de la BD de comparaison sont des points; false s'il s'agit des objets de la BD de référence

detruitGeometrieDesLiens

public final void detruitGeometrieDesLiens()

Détruit la géométrie des liens.

objetsApparies

public static List<IPopulation<IFeature>> objetsApparies(EnsembleDeLiens ensemble,
                                                         IFeatureCollection<? extends IFeature> popRef,
                                                         IFeatureCollection<? extends IFeature> popComp)

Méthode qui renvoie à partir d'un ensemble de liens une liste de dimension 4, avec en 1. la population issue de la population de référence qui a été appariée, en 2. la population issue de la population de comparaison qui a été appariée, en 3. la population issue de la population de référence qui n'a pas été appariée, en 4. la population issue de la population de comparaison qui n'a pas été appariée.

Parameters:

ensemble - ensemble de liens issu d'un appariement

popRef - reference population

popComp - comparison population

Returns:

liste des populations appariées et non appariées

scindeSelonValeursCommentaires

public final List<EnsembleDeLiens> scindeSelonValeursCommentaires(List<String> valeursClassement)

Methode utile principalement pour analyser les résultats d'un appariement, qui découpe un réseau en plusieurs réseaux selon les valeurs de l'attribut "resultatAppariement" des arcs et noeuds du réseau apparié.

Parameters:

valeursClassement - sorting values

Returns:

a list of sets of links

clear

public void clear()

Description copied from interface: IFeatureCollection

Efface toute la liste. Detruit l'index spatial si celui existe.

Specified by:

clear in interface IFeatureCollection<Lien>

Specified by:

clear in interface Collection<Lien>

Overrides:

clear in class FT_FeatureCollection<Lien>

See Also:

Collection.clear()