org.nuiton.math.matrix
Class AbstractMatrixND

java.lang.Object
  org.nuiton.math.matrix.AbstractMatrixND

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, MatrixND

Direct Known Subclasses:

MatrixNDImpl, SubMatrix

public abstract class AbstractMatrixND
extends java.lang.Object
implements MatrixND

AbstractMatrixND. Created: 29 oct. 2004

Version:

$Revision: 168 $ Mise a jour: $Date: 2009-07-17 18:18:45 +0200 (ven., 17 juil. 2009) $ par : $Author: echatellier $

Author:

Benjamin Poussin

See Also:

Serialized Form

Field Summary

static char	CSV_SEPARATOR Separateur CSV par défaut le point virgule.
protected double	defaultValue
protected int[]	dim
protected DimensionHelper	dimHelper
protected java.lang.String[]	dimNames
protected MatrixFactory	factory
protected java.lang.String	name
protected static java.util.regex.Pattern	NUMBER
protected java.util.List<?>[]	semantics

Constructor Summary

protected	AbstractMatrixND(MatrixFactory factory)
	AbstractMatrixND(MatrixFactory factory, int[] dim)
	AbstractMatrixND(MatrixFactory factory, java.util.List<?>[] semantics)
	AbstractMatrixND(MatrixFactory factory, java.lang.String name, int[] dim)
	AbstractMatrixND(MatrixFactory factory, java.lang.String name, int[] dim, java.lang.String[] dimNames)
	AbstractMatrixND(MatrixFactory factory, java.lang.String name, java.util.List<?>[] semantics)
	AbstractMatrixND(MatrixFactory factory, java.lang.String name, java.util.List<?>[] semantics, java.lang.String[] dimNames)

Method Summary

MatrixND	add(MatrixND m) Modifie la matrice actuelle en lui ajoutant les valeurs de la matrice passé en parametre.
MatrixND	adds(double d) Addition d'un scalaire à une matrice.
MatrixND	clone() Créer une nouvelle instance clonée de celle-ci
MatrixND	copy() Copy la matrice pour pouvoir la modifier sans perdre les donnees initiales.
MatrixND	cut(int dim, int[] toCut) Permet de supprimer des éléments de la matrice.
MatrixND	divs(double d) Multiplication d'une matrice par un scalaire.
boolean	equals(MatrixND mat)
boolean	equals(java.lang.Object o)
boolean	equalsValues(MatrixND mat) Verifie si les matrices sont egales en ne regardant que les valeurs et pas les semantiques
void	exportCSV(java.io.Writer writer, boolean withSemantics) Export dans un writer au format CSV de la matrice
void	fromList(java.util.List<java.lang.Object> list) Permet de charger une matrice a partir d'une representation List
int[]	getDim() Retourne les dimensions de la matrice.
int	getDim(int d) Retourne la dimension de la matrice dans la dimension d.
int	getDimCount() Retourne le nombre de dimensions de la matrice.
java.lang.String[]	getDimensionName() Deprecated. Use #getDimensionNames()
java.lang.String	getDimensionName(int dim) Retourne le nom de la dimension demandé.
java.lang.String[]	getDimensionNames() Permet de recuperer les noms des dimension.
MatrixFactory	getFactory() Retourne la factory utilisée pour créer cette matrice, la factory peut-être réutilisé pour créer d'autre matrice si besoin.
double	getMaxOccurence() Retourne la valeur la plus courrement rencontrer dans un tableau. si plusieurs valeurs ont le même nombre d'occurence la plus petite valeur est retourné.
java.lang.String	getName() Retourne le nom de la matrice
int	getNbDim() Deprecated. use #getDimCount() instead
java.util.List<?>	getSemantic(int dim) Retourne la semantique pour une dimension
java.util.List<?>[]	getSemantics() Donne toutes les semantiques de la matrice.
java.util.List<?>	getSemantics(int dim) Deprecated. Use #getSemantics(dim)
MatrixND	getSubMatrix(int dim, int[] elem) Permet de prendre une sous matrice dans la matrice courante.
MatrixND	getSubMatrix(int dim, int start, int nb) Permet de prendre une sous matrice dans la matrice courante.
MatrixND	getSubMatrix(int dim, java.lang.Object... elem) Permet de prendre une sous matrice dans la matrice courante.
MatrixND	getSubMatrix(int dim, java.lang.Object start, int nb) Permet de prendre une sous matrice dans la matrice courante.
MatrixND	getSubMatrixOnSemantic(int dim, java.lang.Object... elem) Add to desambiguas some call with xpath engine, but do the same thing getSubMatrix(int, Object[])
double	getValue(int x)
abstract double	getValue(int[] coordinates) Renvoie un element de la matrice demandée en fonction des dimensions passé en paramètre.
double	getValue(int x, int y)
double	getValue(int x, int y, int z)
double	getValue(int x, int y, int z, int t)
double	getValue(java.lang.Object x)
double	getValue(java.lang.Object[] coordinates)
double	getValue(java.lang.Object x, java.lang.Object y)
double	getValue(java.lang.Object x, java.lang.Object y, java.lang.Object z)
double	getValue(java.lang.Object x, java.lang.Object y, java.lang.Object z, java.lang.Object t)
void	importCSV(java.io.Reader reader, int[] origin) Import depuis un reader au format CSV des données dans la matrice
protected void	init(int[] dim)
boolean	isSupportedCSV() Determine si la matrice supporte l'import et l'export CSV
boolean	isValidCoordinates(int[] dim)
boolean	isValidCoordinates(java.lang.Object[] semantics)
abstract MatrixIterator	iterator() Retourne un iterator sur toute la matrice.
MatrixND	map(MapFunction f) Retourne la matrice elle meme.
MatrixND	minus(MatrixND m) Modifie la matrice actuelle en lui soustrayant les valeurs de la matrice passé en parametre.
MatrixND	minuss(double d) Soustraction d'un scalaire à une matrice
MatrixND	mult(MatrixND m) Multiplication normal (produit matriciel) de 2 matrices 2D.
MatrixND	mults(double d) Multiplication d'une matrice par un scalaire.
MatrixND	paste(int[] origin, MatrixND mat) Modifie la matrice actuel en metant les valeurs de mat passé en parametre
MatrixND	paste(MatrixND mat) Modifie la matrice actuel en metant les valeurs de mat passé en parametre
MatrixND	pasteSemantics(MatrixND mat) Modifie la matrice actuel en metant les valeurs de mat passé en parametre La copie se fait en fonction de la semantique, si un element dans une dimension n'est pas trouvé, alors il est passé
MatrixND	reduce() Reduit la matrice de sorte que toutes les dimensions qui n'ont qu'un élement soit supprimée.
MatrixND	reduce(int minNbDim) Reduit la matrice de sorte que toutes les dimensions qui n'ont qu'un élement soit supprimée.
protected MatrixND	reduce(java.util.List<java.lang.Object> dimName, java.util.List<java.lang.Object> sem, int[] correspondance) Create new matrice from the current matrix.
MatrixND	reduceDims(int... dims) Reduit le matrice seulement sur les dimensions passées en argument.
void	setDimensionName(int dim, java.lang.String name) Permet de mettre un nom à une dimension.
void	setDimensionName(java.lang.String[] names) Deprecated. Use #setDimensionName(String[])
void	setDimensionNames(java.lang.String[] names) Permet de mettre des noms aux différentes dimension.
void	setName(java.lang.String name) Permet de donner un nom à la matrice.
<E> void	setSemantic(int dim, java.util.List<E> sem) Modifie la semantique d'une dimension
<E> void	setSemantics(int dim, java.util.List<E> sem) Deprecated. Use #setSemantic(dim, List)
abstract void	setValue(int[] coordinates, double d) Modifie un element de la matrice en fonction des dimensions passé en paramètre.
void	setValue(int x, double d)
void	setValue(int x, int y, double d)
void	setValue(int x, int y, int z, double d)
void	setValue(int x, int y, int z, int t, double d)
void	setValue(java.lang.Object[] coordinates, double d)
void	setValue(java.lang.Object x, double d)
void	setValue(java.lang.Object x, java.lang.Object y, double d)
void	setValue(java.lang.Object x, java.lang.Object y, java.lang.Object z, double d)
void	setValue(java.lang.Object x, java.lang.Object y, java.lang.Object z, java.lang.Object t, double d)
double	sumAll() Somme toutes les valeurs de la matrice.
MatrixND	sumOverDim(int dim) Somme la matrice sur une dimension donnée.
MatrixND	sumOverDim(int dim, int step) Somme la matrice mais la matrice reste de la même dimension. la somme permet juste de regrouper dans une dimension un certain nombre de valeur.
MatrixND	sumOverDim(int dim, int start, int nb)
java.util.List<java.lang.Object>	toList() Donne la matrice sous forme de List de list ... de double
java.lang.String	toString()
MatrixND	transpose() retourne le transpose de la matrice.

Methods inherited from class java.lang.Object

finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

dimHelper

protected transient DimensionHelper dimHelper

factory

protected transient MatrixFactory factory

name

protected java.lang.String name

dimNames

protected java.lang.String[] dimNames

dim

protected int[] dim

semantics

protected java.util.List<?>[] semantics

defaultValue

protected double defaultValue

CSV_SEPARATOR

public static final char CSV_SEPARATOR

Separateur CSV par défaut le point virgule.

See Also:

Constant Field Values

NUMBER

protected static final java.util.regex.Pattern NUMBER

Constructor Detail

AbstractMatrixND

protected AbstractMatrixND(MatrixFactory factory)

AbstractMatrixND

public AbstractMatrixND(MatrixFactory factory,
                        int[] dim)

AbstractMatrixND

public AbstractMatrixND(MatrixFactory factory,
                        java.util.List<?>[] semantics)

AbstractMatrixND

public AbstractMatrixND(MatrixFactory factory,
                        java.lang.String name,
                        int[] dim)

AbstractMatrixND

public AbstractMatrixND(MatrixFactory factory,
                        java.lang.String name,
                        int[] dim,
                        java.lang.String[] dimNames)

AbstractMatrixND

public AbstractMatrixND(MatrixFactory factory,
                        java.lang.String name,
                        java.util.List<?>[] semantics)

AbstractMatrixND

public AbstractMatrixND(MatrixFactory factory,
                        java.lang.String name,
                        java.util.List<?>[] semantics,
                        java.lang.String[] dimNames)

Method Detail

iterator

public abstract MatrixIterator iterator()

Description copied from interface: MatrixND

Retourne un iterator sur toute la matrice.

Specified by:

iterator in interface MatrixND

Returns:

matrix iterator

getValue

public abstract double getValue(int[] coordinates)

Description copied from interface: MatrixND

Renvoie un element de la matrice demandée en fonction des dimensions passé en paramètre.
Exemple: Si on a un matrice 3D.
getValue(1,1,1) retourne un element de la matrice.

Specified by:

getValue in interface MatrixND

Parameters:

coordinates - les différentes dimension à extraire. Le tableau doit contenir toutes les dimensions de la matrice, et seulement des nombres positif

Returns:

un entier double.

setValue

public abstract void setValue(int[] coordinates,
                              double d)

Description copied from interface: MatrixND

Modifie un element de la matrice en fonction des dimensions passé en paramètre.
Exemple: Si on a un matrice 3D.
set([1,1,1], m) modifie un element de la matrice.

Specified by:

setValue in interface MatrixND

Parameters:

coordinates - les différentes dimension à extraire.

d - l'entier double qui doit remplacer l'entier double spécifié par l'argument dimensions

init

protected void init(int[] dim)

copy

public MatrixND copy()

Description copied from interface: MatrixND

Copy la matrice pour pouvoir la modifier sans perdre les donnees initiales.

Specified by:

copy in interface MatrixND

Returns:

new matrix

clone

public MatrixND clone()

Description copied from interface: MatrixND

Créer une nouvelle instance clonée de celle-ci

Specified by:

clone in interface MatrixND

Overrides:

clone in class java.lang.Object

Returns:

new matrix

getFactory

public MatrixFactory getFactory()

Retourne la factory utilisée pour créer cette matrice, la factory peut-être réutilisé pour créer d'autre matrice si besoin.

Specified by:

getFactory in interface MatrixND

Returns:

la MatrixFactory

See Also:

MatrixFactory

getSemantics

public java.util.List<?>[] getSemantics()

Description copied from interface: MatrixND

Donne toutes les semantiques de la matrice. Si la matrice n'a pas de semantique retourne null.

Specified by:

getSemantics in interface MatrixND

Returns:

la liste des semantics

getSemantics

public java.util.List<?> getSemantics(int dim)

Deprecated. Use #getSemantics(dim)

Retourne la semantique pour une dimension

Specified by:

getSemantics in interface MatrixND

Parameters:

dim - la dimension pour lequel on veut la semantique

Returns:

la semantique de la dimension on null s'il n'y a pas de semantique

getSemantic

public java.util.List<?> getSemantic(int dim)

Description copied from interface: MatrixND

Retourne la semantique pour une dimension

Specified by:

getSemantic in interface MatrixND

Parameters:

dim - la dimension pour lequel on veut la semantique

Returns:

la semantique de la dimension on null s'il n'y a pas de semantique

setSemantics

public <E> void setSemantics(int dim,
                             java.util.List<E> sem)

Deprecated. Use #setSemantic(dim, List)

Modifie la semantique d'une dimension

Specified by:

setSemantics in interface MatrixND

Parameters:

dim - dimension to modify semantic

sem - new semantic to set

setSemantic

public <E> void setSemantic(int dim,
                            java.util.List<E> sem)

Description copied from interface: MatrixND

Modifie la semantique d'une dimension

Specified by:

setSemantic in interface MatrixND

Parameters:

dim - dimension to modify semantic

sem - new semantic to set

setName

public void setName(java.lang.String name)

Description copied from interface: MatrixND

Permet de donner un nom à la matrice.

Specified by:

setName in interface MatrixND

Parameters:

name - name to set

getName

public java.lang.String getName()

Description copied from interface: MatrixND

Retourne le nom de la matrice

Specified by:

getName in interface MatrixND

Returns:

le nom de la matrice ou la chaine vide si pas de nom.

getDimensionNames

public java.lang.String[] getDimensionNames()

Description copied from interface: MatrixND

Permet de recuperer les noms des dimension.

Specified by:

getDimensionNames in interface MatrixND

Returns:

tableau des noms de dimension.

setDimensionNames

public void setDimensionNames(java.lang.String[] names)

Description copied from interface: MatrixND

Permet de mettre des noms aux différentes dimension.

Specified by:

setDimensionNames in interface MatrixND

Parameters:

names - names to set

getDimensionName

public java.lang.String[] getDimensionName()

Deprecated. Use #getDimensionNames()

Permet de recuperer les noms des dimension.

Specified by:

getDimensionName in interface MatrixND

Returns:

tableau des noms de dimension.

setDimensionName

public void setDimensionName(java.lang.String[] names)

Deprecated. Use #setDimensionName(String[])

Permet de mettre des noms aux différentes dimension.

Specified by:

setDimensionName in interface MatrixND

Parameters:

names - names to set

setDimensionName

public void setDimensionName(int dim,
                             java.lang.String name)

Description copied from interface: MatrixND

Permet de mettre un nom à une dimension.

Specified by:

setDimensionName in interface MatrixND

Parameters:

dim - la dimension dont on veut changer le nom

name - le nom à donner à la dimension

getDimensionName

public java.lang.String getDimensionName(int dim)

Description copied from interface: MatrixND

Retourne le nom de la dimension demandé.

Specified by:

getDimensionName in interface MatrixND

Parameters:

dim - la dimension dont on veut le nom

Returns:

le nom de la dimension ou la chaine vide si la dimension n'a pas de nom @ si la dimension demandé n'est pas valide

getMaxOccurence

public double getMaxOccurence()

Description copied from interface: MatrixND

Retourne la valeur la plus courrement rencontrer dans un tableau. si plusieurs valeurs ont le même nombre d'occurence la plus petite valeur est retourné.

Specified by:

getMaxOccurence in interface MatrixND

Returns:

la valeur la plus nombreuse dans le tableau

getNbDim

public int getNbDim()

Deprecated. use #getDimCount() instead

Retourne le nombre de dimensions de la matrice.

Specified by:

getNbDim in interface MatrixND

Returns:

le nombre de dimensions de la matrice.

getDimCount

public int getDimCount()

Description copied from interface: MatrixND

Retourne le nombre de dimensions de la matrice.

Specified by:

getDimCount in interface MatrixND

Returns:

le nombre de dimensions de la matrice.

getDim

public int[] getDim()

Description copied from interface: MatrixND

Retourne les dimensions de la matrice.

Specified by:

getDim in interface MatrixND

Returns:

matrix dimension

getDim

public int getDim(int d)

Description copied from interface: MatrixND

Retourne la dimension de la matrice dans la dimension d.

Specified by:

getDim in interface MatrixND

Parameters:

d - dimension

Returns:

matrix dimension

map

public MatrixND map(MapFunction f)

Retourne la matrice elle meme. Les modifications sont faites directement dessus

Specified by:

map in interface MatrixND

Parameters:

f - function to apply

Returns:

this

getValue

public double getValue(java.lang.Object[] coordinates)

Specified by:

getValue in interface MatrixND

getValue

public double getValue(java.lang.Object x)

Specified by:

getValue in interface MatrixND

getValue

public double getValue(java.lang.Object x,
                       java.lang.Object y)

Specified by:

getValue in interface MatrixND

getValue

public double getValue(java.lang.Object x,
                       java.lang.Object y,
                       java.lang.Object z)

Specified by:

getValue in interface MatrixND

getValue

public double getValue(java.lang.Object x,
                       java.lang.Object y,
                       java.lang.Object z,
                       java.lang.Object t)

Specified by:

getValue in interface MatrixND

getValue

public double getValue(int x)

Specified by:

getValue in interface MatrixND

getValue

public double getValue(int x,
                       int y)

Specified by:

getValue in interface MatrixND

getValue

public double getValue(int x,
                       int y,
                       int z)

Specified by:

getValue in interface MatrixND

getValue

public double getValue(int x,
                       int y,
                       int z,
                       int t)

Specified by:

getValue in interface MatrixND

setValue

public void setValue(java.lang.Object[] coordinates,
                     double d)

Specified by:

setValue in interface MatrixND

setValue

public void setValue(java.lang.Object x,
                     double d)

Specified by:

setValue in interface MatrixND

setValue

public void setValue(java.lang.Object x,
                     java.lang.Object y,
                     double d)

Specified by:

setValue in interface MatrixND

setValue

public void setValue(java.lang.Object x,
                     java.lang.Object y,
                     java.lang.Object z,
                     double d)

Specified by:

setValue in interface MatrixND

setValue

public void setValue(java.lang.Object x,
                     java.lang.Object y,
                     java.lang.Object z,
                     java.lang.Object t,
                     double d)

Specified by:

setValue in interface MatrixND

setValue

public void setValue(int x,
                     double d)

Specified by:

setValue in interface MatrixND

setValue

public void setValue(int x,
                     int y,
                     double d)

Specified by:

setValue in interface MatrixND

setValue

public void setValue(int x,
                     int y,
                     int z,
                     double d)

Specified by:

setValue in interface MatrixND

setValue

public void setValue(int x,
                     int y,
                     int z,
                     int t,
                     double d)

Specified by:

setValue in interface MatrixND

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

equals

public boolean equals(MatrixND mat)

equalsValues

public boolean equalsValues(MatrixND mat)

Verifie si les matrices sont egales en ne regardant que les valeurs et pas les semantiques

Specified by:

equalsValues in interface MatrixND

Parameters:

mat -

Returns:

equality on values

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

toList

public java.util.List<java.lang.Object> toList()

Description copied from interface: MatrixND

Donne la matrice sous forme de List de list ... de double

Specified by:

toList in interface MatrixND

Returns:

list matrix representation

fromList

public void fromList(java.util.List<java.lang.Object> list)

Description copied from interface: MatrixND

Permet de charger une matrice a partir d'une representation List

Specified by:

fromList in interface MatrixND

Parameters:

list - la matrice sous forme de List de list ... de double

isValidCoordinates

public boolean isValidCoordinates(int[] dim)

isValidCoordinates

public boolean isValidCoordinates(java.lang.Object[] semantics)

sumAll

public double sumAll()

Description copied from interface: MatrixND

Somme toutes les valeurs de la matrice.

Specified by:

sumAll in interface MatrixND

Returns:

sum result

sumOverDim

public MatrixND sumOverDim(int dim)

Description copied from interface: MatrixND

Somme la matrice sur une dimension donnée. La matrice résultat à le même nombre de dimension, pas la dimension sommer, ne contient qu'une ligne.

par exemple pour la matrice suivante si on somme sur la dimension 1 cela donnera

 1 2 3
 2 3 4
 3 4 5
 

 6 9 12
 

Specified by:

sumOverDim in interface MatrixND

Parameters:

dim - la dimension sur lequel il faut faire la somme

Returns:

new matrix

sumOverDim

public MatrixND sumOverDim(int dim,
                           int step)

Description copied from interface: MatrixND

Somme la matrice mais la matrice reste de la même dimension. la somme permet juste de regrouper dans une dimension un certain nombre de valeur.

pour la matrice suivante :

 1 2 3 4
 2 3 4 5
 3 4 5 6
 4 5 6 7
 

la somme sur la dimension 1 avec un pas de 2 donnera :

 3 5 7  9
 7 9 11 13
 

c'est à dire que la ligne 0 et la ligne 1 sont sommées. ainsi que la ligne 2 avec la ligne 3.

Specified by:

sumOverDim in interface MatrixND

Parameters:

dim - la dimension sur lequel il faut faire les sommes

step - le pas qu'il faut utiliser pour regrouper les elements. Si le pas est inférieur à 0, le pas se comporte comme si on avait passé en argument la taille de la dimension. Un pas de 0 ou 1, retourne juste une copie de la matrice actuelle. si la division du pas avec la taille de la dimension ne donne pas un nombre entier, les elements restants ne sont pas pris en compte. Par exemple si la dimension a 10 élements et que l'on donne un pas de 3, dans la matrice resultat la dimension aura 3 elements qui seront la somme par 3 des 9 premiers element de la matrice courante. Le 10eme element sera perdu.

Returns:

une nouvelle matrice avec le meme nombre de dimension mais dont la dimension passé en paramètre aura comme taille, le resultat de la division entier de la taille actuelle par le step

sumOverDim

public MatrixND sumOverDim(int dim,
                           int start,
                           int nb)

Specified by:

sumOverDim in interface MatrixND

cut

public MatrixND cut(int dim,
                    int[] toCut)

Description copied from interface: MatrixND

Permet de supprimer des éléments de la matrice. Par exemple, pour la matrice

 1 2 3 4
 2 3 4 5
 3 4 5 6
 4 5 6 7
 

un cut(1, [0,2]) donnera

 2 4
 3 5
 4 6
 5 7
 

Specified by:

cut in interface MatrixND

Parameters:

dim - la dimension dans lequel il faut supprimer des éléments

toCut - les éléments à supprimer

Returns:

une nouvelle matrice, la matrice actuelle n'est pas modifiée

paste

public MatrixND paste(MatrixND mat)

Modifie la matrice actuel en metant les valeurs de mat passé en parametre

Specified by:

paste in interface MatrixND

Parameters:

mat - la matrice à copier

Returns:

return la matrice courante.

paste

public MatrixND paste(int[] origin,
                      MatrixND mat)

Modifie la matrice actuel en metant les valeurs de mat passé en parametre

Specified by:

paste in interface MatrixND

Parameters:

origin - le point d'origine a partir duquel on colle la matrice

mat - une matrice avec le meme nombre de dimension, si la matrice que l'on colle est trop grande, les valeurs qui depasse ne sont pas prises en compte

Returns:

return la matrice courante.

pasteSemantics

public MatrixND pasteSemantics(MatrixND mat)

Modifie la matrice actuel en metant les valeurs de mat passé en parametre La copie se fait en fonction de la semantique, si un element dans une dimension n'est pas trouvé, alors il est passé

Specified by:

pasteSemantics in interface MatrixND

Parameters:

mat - matrix to paste

Returns:

new matrix

getSubMatrix

public MatrixND getSubMatrix(int dim,
                             int start,
                             int nb)

Description copied from interface: MatrixND

Permet de prendre une sous matrice dans la matrice courante. La sous matrice a le même nombre de dimensions mais sur une des dimensions on ne prend que certain élément.

Specified by:

getSubMatrix in interface MatrixND

Parameters:

dim - la dimension dans lequel on veut une sous matrice

start - la position dans dim d'ou il faut partir pour prendre la sous matrice. 0 <= start < dim.size si start est négatif alors la position de départ est calculé par rapport à la fin de la dimension, pour avoir le dernier élément il faut passer -1

nb - le nombre d'élément à prendre dans la dimension si nb est inférieur ou égal à 0 alors cela indique qu'il faut prendre tous les éléments jusqu'à la fin de la dimension.

Returns:

new matrix

getSubMatrix

public MatrixND getSubMatrix(int dim,
                             java.lang.Object start,
                             int nb)

Description copied from interface: MatrixND

Permet de prendre une sous matrice dans la matrice courante. La sous matrice a le même nombre de dimensions mais sur une des dimensions on ne prend que certain élément.

Specified by:

getSubMatrix in interface MatrixND

Parameters:

dim - la dimension dans lequel on veut une sous matrice si dim est négatif alors la dimension est prise à partir de la fin par exemple si l'on veut la derniere dimension il faut passer -1 pour dim

start - la position dans dim d'ou il faut partir pour prendre la sous matrice.

nb - le nombre d'élément à prendre dans la dimension. si nb est inférieur ou égal à 0 alors cela indique qu'il faut prendre tous les éléments jusqu'à la fin de la dimension.

Returns:

new matrix

getSubMatrixOnSemantic

public MatrixND getSubMatrixOnSemantic(int dim,
                                       java.lang.Object... elem)

Add to desambiguas some call with xpath engine, but do the same thing getSubMatrix(int, Object[])

Parameters:

dim -

elem -

Returns:

new matrix

getSubMatrix

public MatrixND getSubMatrix(int dim,
                             java.lang.Object... elem)

Description copied from interface: MatrixND

Permet de prendre une sous matrice dans la matrice courante. La sous matrice a le même nombre de dimensions mais sur une des dimensions on ne prend que certain élément.

Specified by:

getSubMatrix in interface MatrixND

Parameters:

dim - la dimension dans lequel on veut une sous matrice

elem - les éléments dans la dimension à conserver

Returns:

new matrix

getSubMatrix

public MatrixND getSubMatrix(int dim,
                             int[] elem)

Description copied from interface: MatrixND

Permet de prendre une sous matrice dans la matrice courante. La sous matrice a le même nombre de dimensions mais sur une des dimensions on ne prend que certain élément.

Specified by:

getSubMatrix in interface MatrixND

Parameters:

dim - la dimension dans lequel on veut une sous matrice

elem - les éléments dans la dimension à conserver

Returns:

new matrix

add

public MatrixND add(MatrixND m)

Modifie la matrice actuelle en lui ajoutant les valeurs de la matrice passé en parametre. La matrice passé en parametre doit avoir le meme nombre de dimension, et chacune de ses dimensions doit avoir un nombre d'element au moins egal a cette matrice.

Specified by:

add in interface MatrixND

Parameters:

m - matrix to add

Returns:

new matrix

minus

public MatrixND minus(MatrixND m)

Modifie la matrice actuelle en lui soustrayant les valeurs de la matrice passé en parametre. La matrice passé en parametre doit avoir le meme nombre de dimension, et chacune de ses dimensions doit avoir un nombre d'element au moins egal a cette matrice.

Specified by:

minus in interface MatrixND

Parameters:

m - matrix to minus

Returns:

new matrix

transpose

public MatrixND transpose()

Description copied from interface: MatrixND

retourne le transpose de la matrice.

Specified by:

transpose in interface MatrixND

Returns:

transposed matrix

reduce

public MatrixND reduce()

Description copied from interface: MatrixND

Reduit la matrice de sorte que toutes les dimensions qui n'ont qu'un élement soit supprimée. Au pire cette méthode retourne une matrice à une seule dimension à un seul élément.

Specified by:

reduce in interface MatrixND

Returns:

une nouvelle matrice plus petite que la matrice actuelle ou egal s'il n'y a aucune dimension à supprimer

reduceDims

public MatrixND reduceDims(int... dims)

Description copied from interface: MatrixND

Reduit le matrice seulement sur les dimensions passées en argument. Si une des dimensions passées en arguement n'a pas un seul élément, cette dimension n'est pas prise en compte.

Specified by:

reduceDims in interface MatrixND

Parameters:

dims - les dimensions sur lequel il faut faire la reduction

Returns:

une nouvelle matrice

reduce

public MatrixND reduce(int minNbDim)

Description copied from interface: MatrixND

Reduit la matrice de sorte que toutes les dimensions qui n'ont qu'un élement soit supprimée. Au pire cette méthode retourne une matrice à une seule dimension à un seul élément.

Specified by:

reduce in interface MatrixND

Parameters:

minNbDim - le nombre minimum de dimension que l'on souhaite pour la matrice résultat

Returns:

une nouvelle matrice plus petite que la matrice actuelle ou egal s'il n'y a aucune dimension à supprimer

reduce

protected MatrixND reduce(java.util.List<java.lang.Object> dimName,
                          java.util.List<java.lang.Object> sem,
                          int[] correspondance)

Create new matrice from the current matrix.

Parameters:

dimName - dimension name for new matrix

sem - semantic for new matrix

correspondance - array to do the link between current matrix and returned matrix

Returns:

new matrix

mult

public MatrixND mult(MatrixND m)
              throws MatrixException

Description copied from interface: MatrixND

Multiplication normal (produit matriciel) de 2 matrices 2D.

Specified by:

mult in interface MatrixND

Parameters:

m - matrix to mult

Returns:

Retourne une nouvelle matrice.

Throws:

MatrixException

mults

public MatrixND mults(double d)

Description copied from interface: MatrixND

Multiplication d'une matrice par un scalaire.

Specified by:

mults in interface MatrixND

Parameters:

d - scalaire

Returns:

new matrix

divs

public MatrixND divs(double d)

Description copied from interface: MatrixND

Multiplication d'une matrice par un scalaire.

Specified by:

divs in interface MatrixND

Parameters:

d - scalaire

Returns:

new matrix

adds

public MatrixND adds(double d)

Description copied from interface: MatrixND

Addition d'un scalaire à une matrice.

Specified by:

adds in interface MatrixND

Parameters:

d - scalaire

Returns:

new matrix

minuss

public MatrixND minuss(double d)

Description copied from interface: MatrixND

Soustraction d'un scalaire à une matrice

Specified by:

minuss in interface MatrixND

Parameters:

d - scalaire

Returns:

new matrix

isSupportedCSV

public boolean isSupportedCSV()

Determine si la matrice supporte l'import et l'export CSV

Specified by:

isSupportedCSV in interface MatrixND

Returns:

support du CSV

importCSV

public void importCSV(java.io.Reader reader,
                      int[] origin)
               throws java.io.IOException

Import depuis un reader au format CSV des données dans la matrice

Specified by:

importCSV in interface MatrixND

Parameters:

reader - le reader à importer

origin - le point à partir duquel il faut faire l'importation int[]{x,y}

Throws:

java.io.IOException

exportCSV

public void exportCSV(java.io.Writer writer,
                      boolean withSemantics)
               throws java.io.IOException

Export dans un writer au format CSV de la matrice

Specified by:

exportCSV in interface MatrixND

Parameters:

writer - le writer ou copier la matrice

withSemantics - export ou pas des semantiques de la matrice dans le writer

Throws:

java.io.IOException