SVector3d

java.lang.Object
- sim.math.SVector3d

All Implemented Interfaces:

SVector, SWriteable
```
public class SVector3d
extends java.lang.Object
implements SVector
```
La classe SVector3d représente une vecteur à trois dimensions.

Les opérations mathématiques supportées sont les suivantes :
Since:

2014-12-16

Version:

2016-02-24

Author:

Simon Vezina

Field Summary

Fields
Modifier and Type Field and Description

static SVector3d ORIGIN
La constante ORIGIN représente le vecteur origine étant situé à la coordonnée (0.0, 0.0, 0.0).

Fields
Modifier and Type	Field and Description
`static SVector3d`	`ORIGIN` La constante ORIGIN représente le vecteur origine étant situé à la coordonnée (0.0, 0.0, 0.0).

Constructor Summary

Constructors
Constructor and Description
`SVector3d()` Constructeur représentant un vecteur 3d à l'origine d'un système d'axe xyz.
`SVector3d(double x, double y, double z)` Constructeur avec composante x,y et z du vecteur 3d.
`SVector3d(java.lang.String string)` Constructeur d'un vecteur 3d en utilisant un string décrivant les paramètres x, y et z du vecteur.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static SVector3d`	`Across_BcrossC(SVector3d A, SVector3d B, SVector3d C)` Méthode qui effectue le triple produit vectoriel de trois vecteurs A, B et C avec l'ordre de priorité
`static SVector3d`	`AcrossB_crossC(SVector3d A, SVector3d B, SVector3d C)` Méthode qui effectue le triple produit vectoriel de trois vecteurs A, B et C avec l'ordre de priorité
`static SVector3d`	`AcrossBcrossC(SVector3d A, SVector3d B, SVector3d C)` Méthode qui effectue le triple produit vectoriel de trois vecteurs A, B et C.
`static double`	`AcrossBdotC(SVector3d A, SVector3d B, SVector3d C)` Méthode qui effectue le produit mixte de trois vecteurs A, B et C.
`SVector`	`add(SVector v)` Méthode permettant d'effectuer l'addition mathématique entre deux vecteurs.
`SVector3d`	`add(SVector3d v)` Méthode qui retourne l'addition de deux vecteurs.
`static double`	`AdotCsubstractBdotC(SVector3d A, SVector3d B, SVector3d C)` Méthode pour effectuer la soustraction entre deux produits scalaires.
`static SVector3d`	`AmultiplyBaddC(double a, SVector3d B, SVector3d C)` Méthode qui effectue une opération spécialisée de multiplication par un scalaire et d'addition vectorielle équivalente à V = a*B + C.
`SVector3d`	`cross(SVector3d v)` Méthode pour effectuer le produit vectoriel avec un autre vecteur v.
`double`	`dot(SVector3d v)` Méthode pour effectuer le produit scalaire avec un autre vecteur v.
`boolean`	`equals(java.lang.Object obj)`
`static SVector3d`	`findMaxValue(java.util.List<SVector3d> value_list)` Méthode pour obtenir un vecteur avec les coordonnée (x,y,z) les plus grandes (en considérant le signe) parmi un ensemble de vecteurs.
`static SVector3d`	`findMaxValue(SVector3d[] tab)` Méthode pour obtenir un vecteur avec les coordonnée (x,y,z) les plus grandes (en considérant le signe) parmi un ensemble de vecteurs.
`static SVector3d`	`findMinValue(java.util.List<SVector3d> value_list)` Méthode pour obtenir un vecteur avec les coordonnée (x,y,z) les plus petites (en considérant le signe) parmi un ensemble de vecteurs.
`static SVector3d`	`findMinValue(SVector3d[] tab)` Méthode pour obtenir un vecteur avec les coordonnée (x,y,z) les plus petites (en considérant le signe) parmi un ensemble de vecteurs.
`double`	`getX()` Méthode qui donne accès à la coordonnée x du vecteur.
`double`	`getY()` Méthode qui donne accès à la coordonnée y du vecteur.
`double`	`getZ()` Méthode qui donne accès à la coordonnée z du vecteur.
`int`	`hashCode()`
`double`	`modulus()` Méthode pour obtenir le module d'un vecteur.
`SVector3d`	`multiply(double m)` Méthode qui effectue la multiplication par une scalaire sur un vecteur.
`SVector3d`	`normalize()` Méthode pour normaliser un vecteur à trois dimensions.
`SVector3d`	`substract(SVector3d v)` Méthode qui retourne la soustraction de deux vecteurs.
`java.lang.String`	`toString()`
`void`	`write(java.io.BufferedWriter bw)` Méthode pour écrire les paramètres xyz du vecteur dans un fichier en format txt.

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - ORIGIN
```
public static final SVector3d ORIGIN
```
    La constante ORIGIN représente le vecteur origine étant situé à la coordonnée (0.0, 0.0, 0.0). Ce vecteur peut également représenter un vecteur orientation sans orientation.
- Constructor Detail
  - SVector3d
```
public SVector3d()
```
    Constructeur représentant un vecteur 3d à l'origine d'un système d'axe xyz.
  - SVector3d
```
public SVector3d(double x,
                 double y,
                 double z)
```
    Constructeur avec composante x,y et z du vecteur 3d.
    
    Parameters:
    
    x - - La composante x du vecteur.
    
    y - - La composante y du vecteur.
    
    z - - La composante z du vecteur.
  - SVector3d
```
public SVector3d(java.lang.String string)
          throws SReadingException
```
    Constructeur d'un vecteur 3d en utilisant un string décrivant les paramètres x, y et z du vecteur. Une lecture autorisée peut prendre la forme suivante : "double x" "double y" "double z" (incluant la notation avec , ( ) [ ] comme délimieur dans l'expression du string comme par exemple (2.3, 4.3, 5.7) ).
    
    Parameters:
    
    string - - Le string de l'expression du vecteur en paramètres x, y, et z.
    
    Throws:
    
    SReadingException - Si le format de la lecture n'est pas adéquat.
- Method Detail
  - getX
```
public double getX()
```
    Méthode qui donne accès à la coordonnée x du vecteur.
    
    Returns:
    
    La coordonnée x.
  - getY
```
public double getY()
```
    Méthode qui donne accès à la coordonnée y du vecteur.
    
    Returns:
    
    La coordonnée y.
  - getZ
```
public double getZ()
```
    Méthode qui donne accès à la coordonnée z du vecteur.
    
    Returns:
    
    La coordonnée z.
  - add
```
public SVector add(SVector v)
            throws SRuntimeException
```
    Description copied from interface: SVector
    
    Méthode permettant d'effectuer l'addition mathématique entre deux vecteurs.
    
    Specified by:
    
    add in interface SVector
    
    Parameters:
    
    v - - Le vecteur à additionner
    
    Returns:
    
    Le vecteur résultat de l'addition des deux vecteurs.
    
    Throws:
    
    SRuntimeException
  - add
```
public SVector3d add(SVector3d v)
```
    Méthode qui retourne l'addition de deux vecteurs.
    
    Parameters:
    
    v - - Le vecteur à ajouter au vecteur présent.
    
    Returns:
    
    La somme des deux vecteurs.
  - substract
```
public SVector3d substract(SVector3d v)
```
    Méthode qui retourne la soustraction de deux vecteurs.
    
    Parameters:
    
    v - - Le vecteur à soustraire au vecteur présent.
    
    Returns:
    
    La soustraction des deux vecteurs.
  - multiply
```
public SVector3d multiply(double m)
```
    Méthode qui effectue la multiplication par une scalaire sur un vecteur.
    
    Specified by:
    
    multiply in interface SVector
    
    Parameters:
    
    m - - Le muliplicateur.
    
    Returns:
    
    Le résultat de la multiplication par un scalaire m sur le vecteur.
  - modulus
```
public double modulus()
```
    Méthode pour obtenir le module d'un vecteur.
    
    Returns:
    
    Le module du vecteur.
  - normalize
```
public SVector3d normalize()
                    throws SImpossibleNormalizationException
```
    Méthode pour normaliser un vecteur à trois dimensions. Un vecteur normalisé possède la même orientation, mais possède une longeur unitaire . Si le module du vecteur est nul, le vecteur normalisé sera le vecteur nul (0.0, 0.0, 0.0).
    
    Returns:
    
    Le vecteur normalisé.
    
    Throws:
    
    SImpossibleNormalizationException - Si le vecteur ne peut pas être normalisé étant trop petit (modulus() < SMath.EPSILON) ou de longueur nulle.
  - dot
```
public double dot(SVector3d v)
```
    Méthode pour effectuer le produit scalaire avec un autre vecteur v.
    
    Parameters:
    
    v - - L'autre vecteur en produit scalaire.
    
    Returns:
    
    Le produit scalaire entre les deux vecteurs.
  - cross
```
public SVector3d cross(SVector3d v)
```
    Méthode pour effectuer le produit vectoriel avec un autre vecteur v. Cette version du produit vectoriel est implémenté en respectant la règle de la main droite . Il est important de rappeler que le produit vectoriel est anticommutatif (AxB = -BxA) et que l'ordre des vecteurs doit être adéquat pour obtenir le résultat désiré. Si l'un des deux vecteurs est nul ou les deux vecteurs sont parallèles , le résultat sera un vecteur nul .
    
    Parameters:
    
    v - Le second vecteur dans le produit vectoriel.
    
    Returns:
    
    Le résultat du produit vectoriel.
  - findMinValue
```
public static SVector3d findMinValue(java.util.List<SVector3d> value_list)
```
    Méthode pour obtenir un vecteur avec les coordonnée (x,y,z) les plus petites (en considérant le signe) parmi un ensemble de vecteurs.
    
    Parameters:
    
    value_list - La liste des vecteurs à analyser.
    
    Returns:
    
    Un vecteur ayant comme coordonnée les plus petites valeurs (x,y,z) trouvées.
  - findMinValue
```
public static SVector3d findMinValue(SVector3d[] tab)
```
    Méthode pour obtenir un vecteur avec les coordonnée (x,y,z) les plus petites (en considérant le signe) parmi un ensemble de vecteurs.
    
    Parameters:
    
    tab - - Le tableau des vecteurs à analyser.
    
    Returns:
    
    Un vecteur ayant comme coordonnée les plus petites valeurs (x,y,z) trouvées.
  - findMaxValue
```
public static SVector3d findMaxValue(java.util.List<SVector3d> value_list)
```
    Méthode pour obtenir un vecteur avec les coordonnée (x,y,z) les plus grandes (en considérant le signe) parmi un ensemble de vecteurs.
    
    Parameters:
    
    value_list - La liste des vecteurs à analyser.
    
    Returns:
    
    Un vecteur ayant comme coordonnée les plus grandes valeurs (x,y,z) trouvées.
  - findMaxValue
```
public static SVector3d findMaxValue(SVector3d[] tab)
```
    Méthode pour obtenir un vecteur avec les coordonnée (x,y,z) les plus grandes (en considérant le signe) parmi un ensemble de vecteurs.
    
    Parameters:
    
    tab - - Le tableau des vecteurs à analyser.
    
    Returns:
    
    Un vecteur ayant comme coordonnée les plus grandes valeurs (x,y,z) trouvées.
  - write
```
public void write(java.io.BufferedWriter bw)
           throws java.io.IOException
```
    Méthode pour écrire les paramètres xyz du vecteur dans un fichier en format txt. Le format de l'écriture est "x" "y" "z" comme l'exemple suivant : 0.6 0.2 0.5
    
    Specified by:
    
    write in interface SWriteable
    
    Parameters:
    
    bw - Le buffer d'écriture.
    
    Throws:
    
    java.io.IOException - S'il y a une erreur avec le buffer d'écriture.
    
    See Also:
    
    BufferedWriter
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object
  - equals
```
public boolean equals(java.lang.Object obj)
```
    Overrides:
    
    equals in class java.lang.Object
  - AdotCsubstractBdotC
```
public static double AdotCsubstractBdotC(SVector3d A,
                                         SVector3d B,
                                         SVector3d C)
```
    Méthode pour effectuer la soustraction entre deux produits scalaires. Cette opération vectorielle est équivalente à l'expression
    Parameters:
    
    A - - Le vecteur A de l'expression.
    
    B - - Le vecteur B de l'expression.
    
    C - - Le vecteur C de l'expression.
    
    Returns:
    
    Le scalaire représentant la solution de l'équation.
  - AcrossBdotC
```
public static double AcrossBdotC(SVector3d A,
                                 SVector3d B,
                                 SVector3d C)
```
    Méthode qui effectue le produit mixte de trois vecteurs A, B et C. Cette opération vectorielle est équivalente à l'expression
    Il est à remarquer que si deux des trois vecteurs sont égaux ou colinéaires, le produit mixte est nul.
    Parameters:
    
    A - - Le 1ier vecteur dans le produit mixte.
    
    B - - Le 2ième vecteur dans le produit mixte.
    
    C - - Le 3ième vecteur dans le produit mixte.
    
    Returns:
    
    Le scalaire résultant du produit mixte.
  - AcrossBcrossC
```
public static SVector3d AcrossBcrossC(SVector3d A,
                                      SVector3d B,
                                      SVector3d C)
```
    Méthode qui effectue le triple produit vectoriel de trois vecteurs A, B et C. Cette opération vectorielle est équivalente à l'expression
    Il est important de préciser que les deux expressions
    ne sont pas égaux. L'ordre de priorité des opérations doit être bien défini.
    Parameters:
    
    A - - Le 1ier vecteur dans le double produit vectoriel.
    
    B - - Le 2ième vecteur dans le double produit vectoriel.
    
    C - - Le 3ième vecteur dans le double produit vectoriel.
    
    Returns:
    
    Le vecteur résultant du produit mixte.
  - Across_BcrossC
```
public static SVector3d Across_BcrossC(SVector3d A,
                                       SVector3d B,
                                       SVector3d C)
```
    Méthode qui effectue le triple produit vectoriel de trois vecteurs A, B et C avec l'ordre de priorité
    où D est le résultat du triple produit vectoriel. Cette opération vectorielle est équivalente à l'expression
    et il est important de préciser que les deux expressions
    ne sont pas égaux puisque le produit vectoriel n'est pas commutatif.
    Parameters:
    
    A - - Le 1ier vecteur dans le double produit vectoriel.
    
    B - - Le 2ième vecteur dans le double produit vectoriel.
    
    C - - Le 3ième vecteur dans le double produit vectoriel.
    
    Returns:
    
    Le vecteur résultant du triple produit vectoriel.
  - AcrossB_crossC
```
public static SVector3d AcrossB_crossC(SVector3d A,
                                       SVector3d B,
                                       SVector3d C)
```
    Méthode qui effectue le triple produit vectoriel de trois vecteurs A, B et C avec l'ordre de priorité
    où D est le résultat du triple produit vectoriel. Cette opération vectorielle est équivalente à l'expression
    et il est important de préciser que les deux expressions
    ne sont pas égaux puisque le produit vectoriel n'est pas commutatif.
    Parameters:
    
    A - - Le 1ier vecteur dans le double produit vectoriel.
    
    B - - Le 2ième vecteur dans le double produit vectoriel.
    
    C - - Le 3ième vecteur dans le double produit vectoriel.
    
    Returns:
    
    Le vecteur résultant du triple produit vectoriel.
  - AmultiplyBaddC
```
public static SVector3d AmultiplyBaddC(double a,
                                       SVector3d B,
                                       SVector3d C)
```
    Méthode qui effectue une opération spécialisée de multiplication par un scalaire et d'addition vectorielle équivalente à
    Parameters:
    
    a - - Le scalaire à multiplier avec B.
    
    B - - Le 1ier vecteur dans l'expression vectorielle.
    
    C - - Le 2ième vecteur dans l'expression vectorielle à ajouter.
    
    Returns:
    
    Le vecteur résultant de cette opération spécialisée.

Class SVector3d

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

ORIGIN

Constructor Detail

SVector3d

SVector3d

SVector3d

Method Detail

getX

getY

getZ

add

add

substract

multiply

modulus

normalize

dot

cross

findMinValue

findMinValue

findMaxValue

findMaxValue

write

toString

hashCode

equals

AdotCsubstractBdotC

AcrossBdotC

AcrossBcrossC

Across_BcrossC

AcrossB_crossC

AmultiplyBaddC