tried to add dijkstra implementation

tp6_enirely/tp6_self/README.md

@@ -0,0 +1,133 @@
+
+# **README - DM Piles et NPI**
+
+## **Comment exécuter le programme :**  
+1. Verfier que tous les fichiers sont dans le même répertoire :  
+   - `test.py`  
+   - `Pile_Tuple.py`  
+   - `Pile_LSC.py`  
+   - `Pile_Liste.py`
+   - `npi.py`
+2. Ouvrez un terminal dans ce répertoire.
+3. Exécutez le programme avec la commande suivante :  
+   ```bash
+   python3 test.py
+   ```
+    ou executer pour la notation polonaise inverse:
+    ```bash
+    python3 npi.py
+    ```
+---
+
+## **Fonctions disponibles et leur utilisation :**  
+
+### 1. **`creer_pile_vide()`**  
+- **Description** : Crée et renvoie une pile vide.
+- **Utilisation** :  
+  ```python
+  pile = creer_pile_vide()
+  ```
+
+---
+
+### 2. **`est_pile_vide(pile)`**  
+- **Description** : Vérifie si une pile est vide.  
+- **Paramètre** :  
+  - `pile` : La pile à vérifier.  
+- **Retour** : Renvoie `True` si la pile est vide, sinon `False`.  
+- **Utilisation** :  
+  ```python
+  if est_pile_vide(pile):
+      print("La pile est vide.")
+  ```
+
+---
+
+### 3. **`sommet(pile)`**  
+- **Description** : Retourne l’élément au sommet de la pile sans le retirer.  
+- **Paramètre** :  
+  - `pile` : La pile à consulter.  
+- **Retour** : L’élément au sommet de la pile.  
+- **Utilisation** :  
+  ```python
+  print(sommet(pile))
+  ```
+
+---
+
+### 4. **`empiler(pile, elt)`**  
+- **Description** : Ajoute un élément au sommet de la pile.  
+- **Paramètres** :  
+  - `pile` : La pile à modifier.  
+  - `elt` : L’élément à empiler.  
+- **Retour** : La nouvelle pile avec l’élément ajouté.  
+- **Utilisation** :  
+  ```python
+  pile = empiler(pile, 5)
+  ```
+
+---
+
+### 5. **`depiler(pile)`**  
+- **Description** : Retire l’élément au sommet de la pile.  
+- **Paramètre** :  
+  - `pile` : La pile à modifier.  
+- **Retour** : La pile sans l’élément au sommet.  
+- **Utilisation** :  
+  ```python
+  pile = depiler(pile)
+  ```
+
+---
+
+### 6. **`hauteur_pile(pile)`**  
+- **Description** : Renvoie le nombre d'éléments présents dans la pile sans la modifier.  
+- **Paramètre** :  
+  - `pile` : La pile à analyser.  
+- **Retour** : La hauteur de la pile (nombre d'éléments).  
+- **Utilisation** :  
+  ```python
+  print(hauteur_pile(pile))
+  ```
+
+---
+
+### 7. **`max_pile(pile, i)`**  
+- **Description** : Trouve le maximum parmi les `i` premiers éléments de la pile.  
+- **Paramètres** :  
+  - `pile` : La pile à analyser.  
+  - `i` : Le nombre d'éléments à prendre en compte depuis le sommet.  
+- **Retour** : Le maximum trouvé parmi les `i` éléments.  
+- **Utilisation** :  
+  ```python
+  print(max_pile(pile, 3))
+  ```
+
+---
+
+### 8. **`retourner(pile, j)`**  
+- **Description** : Inverse l’ordre des `j` premiers éléments de la pile.  
+- **Paramètres** :  
+  - `pile` : La pile à modifier.  
+  - `j` : Le nombre d'éléments à inverser.  
+- **Retour** : La pile modifiée.  
+- **Utilisation** :  
+  ```python
+  pile = retourner(pile, 2)
+  ```
+
+---
+
+### 9. **`tri_crepes_recursif(pile)`**  
+- **Description** : Trie une pile en suivant le tri des crêpes.  
+- **Paramètre** :  
+  - `pile` : La pile à trier.  
+- **Retour** : La pile triée.  
+- **Utilisation** :  
+  ```python
+  pile = tri_crepes_recursif(pile)
+  ```
+<hr>
+
+Cela conclut la documentation des fonctions. Pour toute question, consultez le fichier **test.py** pour des exemples plus détaillés.
+pour toutes questions: elouan.fare@protonmail.ch