Merge remote-tracking branch 'origin/master'

.gitignore

@@ -15,6 +15,9 @@ hs_err_pid*.log
 # log files
 rapport/
 !rapport/rapport.tex
+!rapport/pics/*.png
+!rapport/pics/*.PNG
+!rapport/pics/*.jpg
 
 # javadoc files
 doc/
@@ -24,4 +27,4 @@ build/
 
 # tests files
 
-result.txt
+test*.txt

README.txt

@@ -22,7 +22,7 @@ Pour compiler puis executer le programme, executez la commande: ant run
 
 Pour générer une archive jar dans le répertoire build/, executez la commande: ant packaging
 
-Pour générer la javadoc dans le répertoire dans le dossier doc/, executez la commande: ant javadoc
+Pour générer la javadoc dans le dossier doc/, executez la commande: ant javadoc
 Ouvrez ensuite le fichier index.html ou overview-summary.html dans un navigateur.
 
 Pour effectuer les tests, executez la commande: ant tests

build.xml

@@ -58,7 +58,8 @@
         <junit printsummary="true" haltonerror="no" haltonfailure="no" showoutput="true">
             <classpath refid="project.classpath"/>
             <formatter type="plain"/>
-            <test fork="true" name="lsystem.TestLSystem" outfile="result" />
+            <test fork="true" name="lsystem.TestLSystem" outfile="test1" />
+            <test fork="true" name="lsystem.StressTest" outfile="test2" />
         </junit>
     </target>
 </project>

rapport/sources/chapters/chapitre3.tex

@@ -4,8 +4,10 @@
 L'organisation du projet a été soumit a un ordre de priorité car, comme cité dans "Mise en place du projet" (voir section \ref{sec:MEPprog}), certaines parties étaient nécessaires pour que d'autres fonctionnent ou puissent être amorcées :
 \begin{itemize}
     \item En premier lieu nous fallait créer l'alphabet de notre L-Système (voir section \ref{sec:Alphabet}).
-    \item
+    \item Mise en place de méthode Parser\#isCorrect() pour vérifier certains que la syntaxe du l-système est correcte.
-    \item
+    \item Mise en place d'un moteur de réécriture.
+    \item Mis en place d'un parser qui transforme le mot obtenu par le moteur de réécriture en une structure de données plus facilement lisible afin d'être afficher par le moteur graphique.
+    \item affichage du L-Système dans le moteur graphique
 \end{itemize}
 
 \section{Structure du projet}
@@ -17,13 +19,16 @@ L'organisation du projet a été soumit a un ordre de priorité car, comme cité
     \end{itemize}
     \item screen
     \begin{itemize}
-        \item gl3d: Tout les objets relatifs a l'affichage 3d du L-Systeme, voir la section \label{src:interface3d}
+        \item gl3d: Tout les objets relatifs a l'affichage 3d du L-Systeme, voir la section \ref{sec:interface3d}
-        \item main: Tout les objets relatifs au menu, voir la section \label{sec:menu}
+        \item main: Tout les objets relatifs au menu, voir la section \ref{sec:menu}
     \end{itemize}
     \item utils: contient l'objet Pair qui est essentiel au fonctionnement du projet
 \end{itemize}
 
-À détailler un peu plus
+\begin{figure}[h!]
-
+    \centering
-\problem{!!!! Ajouter le diagramme de classe !!!!!}
+    \includegraphics[width=0.7\linewidth]{pics/diagram.png}
+    \caption{Diagramme de classe de notre projet}
+    \label{fig:class_diagram}
+\end{figure}
 

rapport/sources/chapters/chapitre4.tex

@@ -1,7 +1,5 @@
 \chapter{Élements techniques}
 
-\section{Parser}\label{sec:parser}
-
 \section{Moteur de réécriture}
 
 Le moteur de réécriture est chargé d'appliquer les règles de réécritures itérativement à partir de l'axiome pour obtenir le mot final.
@@ -11,12 +9,76 @@ Le mot est réécrit en 2 temps :\\
     \item On change toutes les occurrences du mot à remplacer par \$\{identifiant de la règle\}.
     \item On remplace toutes les occurrences de \$\{identifiant de la règle\} par la règle associée.
 \end{itemize}
-On répète cette opération n fois, pour obtenir le mot final.
+On répète cette opération n fois, pour obtenir le mot final.\\
 
-\section{Moteur graphique}\label{src:interface3d}
+L'algorithme de réécriture est séparé en 3 parties:\\
 
-Nous utilisons Java OpenGL pour afficher une fenêtre 3D, gl2 pour afficher les lignes de la grille, glu pour placer la caméra et GLUT pour afficher les cylindres.
+\begin{algorithm}
-Pour naviguer dans l'espace 3D, voir la section \ref{sec:nav_3d}
+\DontPrintSemicolon
+\KwIn{axiom: $String$, rules : $List[Tuple[String, String]$, recurrence: $Integer$}
+\KwOut{Le mot réécrit itérativement: $String$}
+\caption{{\sc Rewrite} Fonction principale appelé par la fenêtre principale}
+$rewritten \gets \emptyset$\;
+\For{$i \gets 0$ \textbf{à} $recurrence$} {
+    $toRewrite \gets replaceRulesByID(rewritten, rules)$\;
+    $rewritten \gets = replaceIDByRuleApplication(toRewrite, rules)$\;
+}
+$rewritten = rewritten.replace("[", "Y[")$\;
+\Return{$rewritten$}\;
+\end{algorithm}
+
+\begin{algorithm}
+\DontPrintSemicolon
+\KwIn{rewritten: $String$, rules : $List[Tuple[String, String]$}
+\KwOut{Le mot partiellement réécrit}
+\caption{{\sc replaceRulesByID} remplace les occurrences des différentes règles par \$\{id\}}
+$toRewrite \gets rewritten$\;
+\For{$i \gets 0$ \textbf{à} $rules.size()$}{
+    $pair \gets rules.get(i)$\;
+    $toRwrite \gets toRewrite.replace(pair[0], "\$\{" + i + "\}")$\;
+}
+\Return{$toRewrite$}
+
+\end{algorithm}
+
+\begin{algorithm}
+\DontPrintSemicolon
+\KwIn{toRewrite: $String$, rules : $List[Tuple[String, String]$}
+\KwOut{Le mot entièrement réécrit}
+\caption{{\sc replaceIDByRuleApplication} remplace les occurrences \$\{id\} par la définition des différentes règles}
+$rewritten \gets toRewrite$\;
+\For{$i \gets 0$ \textbf{à} $rules.size()$}{
+$rewritten \gets rewritten.replace("\$\{" + i + "\}", rules.get(i)[1]$\;
+}
+\Return{$rewritten$}
+\end{algorithm}
+
+\clearpage
+
+\section{Parser}
+\label{sec:parser}
+
+Le rôle du parser est à partir d'un mot réécrit par le moteur de réécriture de convertir celui-ci en une structure de données plus facilement manipulable afin de l'afficher dans le moteur graphique.
+En appliquant les règles précédemment énoncé, il construit un arbre grâce la structure de données suivante
+
+\begin{algorithm}
+\DontPrintSemicolon
+\caption{{\sc Element} Branche de l'arbre, si parent est vide alors, cet element est la racine}
+\Struct{Element}{
+propery: $ElementProperty$ \Comment{enumérateur, valeurs possibles: $DRAW$ ou $NOTHING$}\;
+parent: $Element$\;
+rotation: $Float[3]$\;
+children: $List[Element]$\;
+}
+\end{algorithm}
+
+
+\section{Moteur graphique}
+\label{sec:interface3d}
+
+Nous utilisons Java OpenGL pour afficher une fenêtre 3D, gl2 pour afficher les lignes de la grille, glu pour placer la caméra et GLUT pour afficher les cylindres.\\
+Pour naviguer dans l'espace 3D, voir la section \ref{sec:nav_3d}.\\
+Pour afficher le L-Système nous utilisons une méthode récursive.
 
 \begin{figure}[h!]
     \centering
@@ -27,12 +89,12 @@ Pour naviguer dans l'espace 3D, voir la section \ref{sec:nav_3d}
 
 \clearpage
 
-\section{Interface principale}\label{sec:menu}
+\section{Interface principale}
+\label{sec:menu}
 
 \subsection{Composition de l'interface}
 
-\paragraph{L'interface}
+\paragraph{L'interface} utilisateur de notre logiciel a été conçu grâce à la bibliothèque \Swing \ de \Java. Elle se compose de trois classes, une contenant la fenêtre principale \classe{MainFrame}, une autre permettant de créer des onglets, \classe{Tab} et une troisième classe gérant les événements, \classe{Listener}.
-utilisateur de notre logiciel a été conçu grâce à la bibliothèque \Swing \ de \Java. Elle se compose de trois classes, une contenant la fenêtre principale \classe{MainFrame}, une autre permettant de créer des onglets, \classe{Tab} et une troisième classe gérant les événements, \classe{Listener}.
  
 \subsection{Classes de l'interface}
 
@@ -47,5 +109,6 @@ Elle comporte aussi une instance de la classe JTabbedPane \label{jtpane}, un con
 
 \subsubsection{Listener}
 
-\paragraph{La classe \classe{Listener}} est une classe implémentant certaines classes Listener de \Swing (\classe{ActionListener, KeyListener et MouseWheelListener}). Elle permet de capter toutes les actions effectuées par l'utilisateur et d'appeler les méthodes correspondantes des classes de l'interface. Elle permet ainsi de créer de nouveaux onglets (Nouvelles instances de Tab) mais aussi d'en fermer ou bien encore de lancer la génération du modèle.
+\paragraph{La classe \classe{Listener}} est une classe implémentant certaines classes Listener de \\\Swing (\classe{ActionListener, KeyListener et MouseWheelListener}). Elle permet de capter toutes les actions effectuées par l'utilisateur et d'appeler les méthodes correspondantes des classes de l'interface. Elle permet ainsi de créer de nouveaux onglets (Nouvelles instances de Tab) mais aussi d'en fermer ou bien encore de lancer la génération du modèle.
+
 \section{Pair ou un tuple a 2 entrées en java}

rapport/sources/main.tex

@@ -23,6 +23,7 @@
 \usepackage[noend]{algpseudocode}
 \usepackage{listings}
 \usepackage{enumitem}
+\usepackage[linesnumbered,ruled,french,onelanguage]{algorithm2e}
 \hyphenpenalty 10000
 
 \definecolor{link}{HTML}{4169E1}
@@ -96,6 +97,12 @@
 
 \newcommand{\keywords}{\sffamily\textit{Keywords : }\bfseries}
 
+\makeatletter 
+\g@addto@macro{\@algocf@init}{\SetKwInput{KwOut}{Sortie}}
+\makeatother
+
+\SetKwRepeat{Struct}{struct \{}{\}}
+
 %Page style
 
 \pagestyle{headings}

src/lsystem/engine/Parser.java

@@ -156,7 +156,7 @@ public class Parser {
                 }
             }
         }
-        assert root == null;
+        assert root != null;
         return root;
     }
 

src/lsystem/engine/Rewrite.java

@@ -55,7 +55,7 @@ public class Rewrite {
             System.out.println(i + " / " + recurrences + " : " + rewritten.length());
         }
         rewritten = rewritten.replace("[", "Y[");
-        System.out.println(rewritten);
+        // System.out.println(rewritten);
         return rewritten;
     }
 

test/lsystem/StressTest.java

@@ -0,0 +1,30 @@
+package lsystem;
+
+import lsystem.engine.Parser;
+import lsystem.screen.gl3d.GLCanvas;
+import lsystem.utils.Pair;
+import org.junit.Test;
+
+import java.util.Arrays;
+import java.util.List;
+
+import static org.junit.Assert.assertNotNull;
+
+public class StressTest {
+
+    /**
+     * require at least 3GB of free ram
+     */
+    @Test
+    public void stressTest1() {
+        long millis = System.currentTimeMillis();
+        GLCanvas joglFrame = new GLCanvas();
+        Parser parser = new Parser("Y", Arrays.asList("Y=X+[[Y]-Y]-X[-XY]+Y", "X=XX"), 11);
+        List<Pair<String, String>> lSystemRules = parser.parseRules();
+        joglFrame.setLSystem(parser.getAxiom(), lSystemRules, parser.getNbIterations());
+        System.out.println(joglFrame.getLSystem());
+        System.out.println("time in millisecondes: " + (System.currentTimeMillis() - millis));
+        assertNotNull("L-System should not be null", joglFrame.getLSystem());
+    }
+
+}