fr.ign.cogit.geoxygene.sig3d.semantic

Class DTM

Object

AbstractDTM

AbstractDTMLayer

DTM

All Implemented Interfaces:

Layer

Direct Known Subclasses:

DTMArea, MNTRGE

public class DTM
extends AbstractDTMLayer

This software is released under the licence CeCILL see LICENSE.TXT see

Version:

0.1 Classe permettant d'afficher un MNT et de plaquer une photo Cette classe sert avant tout pour l'affichage, il n'y a donc pas de modèle de données derrière On peut toujours récupèrer les points des différents triangles à l'aide du triangle strip et des différents paramètres On peut cependant récupérer les géométries correspondant à une zone (zone rectangle entre 2 coordonnées) Class used to render DTM from a .asc file. The DTM is displayed with an image mapped on it or with a ColorShade

Author:

Brasebin Mickaël

Field Summary

Fields

Modifier and Type	Field and Description
protected Color4f[]	color4fShade
static double	CONSTANT_OFFSET
int	echantillonage
protected double	noDataValue
protected int	nX
protected int	nY
protected int	sampling
protected double	stepX
protected double	stepY
protected TriangleStripArray	strip
protected double	xIni
protected double	yIni
protected double	zMax
protected double	zMin

Fields inherited from class AbstractDTMLayer

bgLayer, layerName, selectable, visible

Fields inherited from class AbstractDTM

colorShade, emprise, exageration, imageEnvelope, imagePath, isFilled, path

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DTM()
	DTM(InputStream is, String layerName, boolean fill, int exager, Color[] colorGradation) Permet de créer un MNT en utilisant un InputStream
	DTM(InputStream is, String layerName, boolean fill, int exager, String imageFileName, IEnvelope imageEnvelope) Permet de créer un MNT en utilisant un InputStream
	DTM(String file, String layerName, boolean fill, int exager, Color[] colorGradation) Permet de créer un MNT en appliquant un dégradé de couleur.
	DTM(String file, String layerName, boolean fill, int exager, String imageFileName, IEnvelope imageEnvelope) Ajoute à la carte un MNT avec orthophoto.

Method Summary

Modifier and Type	Method and Description
Coordinate	castCoordinate(double x, double y) Cette fonction permet de projeter un point sur un MNT en lui ajoutant un altitude offsetting
Box3D	get3DEnvelope() Fournit l'emprise 3D de la couche (Pavé englobant parallèle aux axes)
double	getAverageAltitude() Method to get average value Input : none Output : double
Color4f	getColor4f(double z) Permet de faire une petite classification sur les altitudes des points Il faut modifier le code pour influer sur cette classification, pour l'instant Cette classification utilise les véritables altitudes et non les altitudes exaggarees On utilise une classification linéaire en fonction du tableau de dégradé utilisé
GM_Object	getGeometryAt(double x, double y) Permet de renvoyer la géométrie du modèle se trouvant aux coordonnées x,y
DirectPosition	getHighestPoint() Method to get highest position Input : none Output : DirectPosition
DirectPosition	getLowestPoint() Method to get lowest position Input : none Output : DirectPosition
int	getNX()
int	getNY()
IDirectPosition	getPMaxImage()
IDirectPosition	getPMinImage()
double	getRatioUnder(double threshold) Method to get surface ratio under threshold altitude Input : none Output : double
TriangleStripArray	getRepresentation()
Component	getRepresentationComponent()
double	getStdAltitude() Method to get standard deviation value Input : none Output : double
double	getStepX()
double	getStepY()
DirectPositionList	getTriangle(int indexX, int indexY, boolean inferior) Renvoie le triangle qui se trouve dans la maille indexX, indexY et dans le bas de la maille si inferior est true et dans le haut de celle-ci sinon Renvoie null si les indices ne correspondent pas à un triangle existant
double	getXIni()
double	getYIni()
MultiLineString	processLinearGrid(double xmin, double ymin, double xmax, double ymax) Cette fonction renvoie les lignes comprises dans le rectangles ayant dpMin et dpMax comme points extrémités
MultiPolygon	processSurfacicGrid(double xmin, double xmax, double ymin, double ymax) Cette fonction permet d'extraire en géométrie géoxygene les triangles du MNT compris dans le rectangle formé par dpMin et dpMax en 2D
void	refresh() Met à jour la représentation de la carte dans la vue
void	refresh(String file, String layerName, boolean fill, int exager, Color[] colorGradation) Rafraichit la représentation d'un MNT en appliquer un dégradé
void	refresh(String file, String layerName, boolean fill, int exager, String imageFileName, IEnvelope imageEnvelope) Permet de rafraichir un MNT en appliquant les paramètres nécessaires pour l'utilisation d'un MNT

Methods inherited from class AbstractDTMLayer

getBranchGroup, getLayerName, isSelectable, isVisible, setLayerName, setSelectable, setVisible

Methods inherited from class AbstractDTM

cast, cast, castCoordinate, castCoordinate, getColorShade, getExageration, getImageEnvelope, getImagePath, getPath, isFilled, mapCurve, mapCurve, mapFeatureCollection, mapGeom, mapGeom, mapShapeFile, mapSurface, mapSurface

Methods inherited from class Object

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

Field Detail

echantillonage

public int echantillonage

CONSTANT_OFFSET

public static double CONSTANT_OFFSET

xIni

protected double xIni

yIni

protected double yIni

zMax

protected double zMax

zMin

protected double zMin

stepX

protected double stepX

stepY

protected double stepY

nX

protected int nX

nY

protected int nY

strip

protected TriangleStripArray strip

noDataValue

protected double noDataValue

sampling

protected int sampling

color4fShade

protected Color4f[] color4fShade

Constructor Detail

DTM

protected DTM()

DTM

public DTM(String file,
           String layerName,
           boolean fill,
           int exager,
           String imageFileName,
           IEnvelope imageEnvelope)

Ajoute à la carte un MNT avec orthophoto. L'orthophoto doit être orientée nord, sud

Parameters:

file - Nom du fichier du MNT, il doit être au format

layerName - Nom de couche du MNT

fill - Indique si l'on fait une représentation maille ou une représentation continue

exager - L'exaggération du MNT

imageFileName - Nom du fichier de l'image à plaquer

imageEnvelope - coordonnées min et max de l'image

DTM

public DTM(InputStream is,
           String layerName,
           boolean fill,
           int exager,
           String imageFileName,
           IEnvelope imageEnvelope)

Permet de créer un MNT en utilisant un InputStream

Parameters:

is -

layerName -

fill -

exager -

imageFileName -

imageEnvelope -

DTM

public DTM(String file,
           String layerName,
           boolean fill,
           int exager,
           Color[] colorGradation)

Permet de créer un MNT en appliquant un dégradé de couleur.

Parameters:

file - Fichier MNT au format .asc

layerName - Nom de la couche

fill - Si l'on veut une représentation sous forme remplie ou sous forme de maille

exager - exaggeration à appliquer

colorGradation - dégradé appliqué sur le MNT. Il s'agit d'un Color[]. Les triangles seront classés en fonction du nombre de couleur dans le tableau de couleur. La classe Degrade propose une série de tableau de couleurs.

DTM

public DTM(InputStream is,
           String layerName,
           boolean fill,
           int exager,
           Color[] colorGradation)

Permet de créer un MNT en utilisant un InputStream

Parameters:

is -

layerName -

fill -

exager -

colorGradation -

Method Detail

refresh

public void refresh(String file,
                    String layerName,
                    boolean fill,
                    int exager,
                    String imageFileName,
                    IEnvelope imageEnvelope)

Permet de rafraichir un MNT en appliquant les paramètres nécessaires pour l'utilisation d'un MNT

Parameters:

file -

layerName -

fill -

exager -

imageFileName -

imageEnvelope -

refresh

public void refresh(String file,
                    String layerName,
                    boolean fill,
                    int exager,
                    Color[] colorGradation)

Rafraichit la représentation d'un MNT en appliquer un dégradé

Parameters:

file -

layerName -

fill -

exager -

colorGradation -

refresh

public void refresh()

Met à jour la représentation de la carte dans la vue

getColor4f

public Color4f getColor4f(double z)

Permet de faire une petite classification sur les altitudes des points Il faut modifier le code pour influer sur cette classification, pour l'instant Cette classification utilise les véritables altitudes et non les altitudes exaggarees On utilise une classification linéaire en fonction du tableau de dégradé utilisé

Parameters:

z - l'altitude dont on veut obtenir la couleur

Returns:

la couleur au format Color3f

getPMinImage

public IDirectPosition getPMinImage()

Returns:

Les coordonnées inférieures gauche de l'image plaquée (renvoie 0,0 si il n'y a pas d'image définie

getPMaxImage

public IDirectPosition getPMaxImage()

Returns:

Les coordonnées supérieures droite de l'image plaquée (renvoie 0,0 si il n'y a pas d'image définie

processSurfacicGrid

public MultiPolygon processSurfacicGrid(double xmin,
                                        double xmax,
                                        double ymin,
                                        double ymax)

Cette fonction permet d'extraire en géométrie géoxygene les triangles du MNT compris dans le rectangle formé par dpMin et dpMax en 2D

Specified by:

processSurfacicGrid in class AbstractDTM

Parameters:

dpMin - point inférieur gauche du rectangle

dpMax - point supérieur droit du rectangle

Returns:

une liste de polygones décrivant les géométries du MNT compris dans le rectangle formé par les 2 points en 2D

processLinearGrid

public MultiLineString processLinearGrid(double xmin,
                                         double ymin,
                                         double xmax,
                                         double ymax)

Cette fonction renvoie les lignes comprises dans le rectangles ayant dpMin et dpMax comme points extrémités

Overrides:

processLinearGrid in class AbstractDTM

Parameters:

dpMin - point inférieur gauche

dpMax - point supérieur droit

Returns:

une liste de points correspondant aux lignes des mailles comprises entre ces 2 points

getTriangle

public DirectPositionList getTriangle(int indexX,
                                      int indexY,
                                      boolean inferior)

Renvoie le triangle qui se trouve dans la maille indexX, indexY et dans le bas de la maille si inferior est true et dans le haut de celle-ci sinon Renvoie null si les indices ne correspondent pas à un triangle existant

Parameters:

indexX - l'indice de la maille en X

indexY - l'indice de la maille en Y

inferior - la position du triangle par rapport à la maille

Returns:

une liste de points correspondants au sommet du triangle concerné

castCoordinate

public Coordinate castCoordinate(double x,
                                 double y)

Cette fonction permet de projeter un point sur un MNT en lui ajoutant un altitude offsetting

Specified by:

castCoordinate in class AbstractDTM

Parameters:

x - ,y le point à projeter

offsetting - l'altitude que l'on rajoute au point final

Returns:

un point 3D ayant comme altitude Z du MNT + offesting

get3DEnvelope

public Box3D get3DEnvelope()

Description copied from interface: Layer

Fournit l'emprise 3D de la couche (Pavé englobant parallèle aux axes)

Returns:

pavé englobant

getRepresentation

public TriangleStripArray getRepresentation()

Returns:

Objet Java3D servant a representer le MNT

getNX

public int getNX()

Returns:

Nombre de mailes en X

getNY

public int getNY()

Returns:

Nombre de mailles en Y

getXIni

public double getXIni()

Returns:

Origine en X du MNT

getYIni

public double getYIni()

Returns:

Origine en Y du MNT

getStepX

public double getStepX()

Returns:

Pas des mailles en X

getStepY

public double getStepY()

Returns:

Pas des mailles en Y

getRepresentationComponent

public Component getRepresentationComponent()

Specified by:

getRepresentationComponent in interface Layer

Overrides:

getRepresentationComponent in class AbstractDTMLayer

Returns:

Renvoie le composant représentant la couche dans la table des couches

getGeometryAt

public GM_Object getGeometryAt(double x,
                               double y)

Description copied from class: AbstractDTM

Permet de renvoyer la géométrie du modèle se trouvant aux coordonnées x,y

Specified by:

getGeometryAt in class AbstractDTM

Returns:

getLowestPoint

public DirectPosition getLowestPoint()

Method to get lowest position Input : none Output : DirectPosition

getHighestPoint

public DirectPosition getHighestPoint()

Method to get highest position Input : none Output : DirectPosition

getAverageAltitude

public double getAverageAltitude()

Method to get average value Input : none Output : double

getStdAltitude

public double getStdAltitude()

Method to get standard deviation value Input : none Output : double

getRatioUnder

public double getRatioUnder(double threshold)

Method to get surface ratio under threshold altitude Input : none Output : double