From 125f00f5e1c7fb2d1bb9d637fd808947e764741d Mon Sep 17 00:00:00 2001
From: Emmanuel Dellandrea <emmanuel.dellandrea@ec-lyon.fr>
Date: Thu, 13 Feb 2025 20:37:09 +0100
Subject: [PATCH] Ajout TD5

---
 TD/TD5/ML-TD5.pdf    | Bin 0 -> 62246 bytes
 TD/TD5/q_learning.py | 129 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 129 insertions(+)
 create mode 100644 TD/TD5/ML-TD5.pdf
 create mode 100644 TD/TD5/q_learning.py

diff --git a/TD/TD5/ML-TD5.pdf b/TD/TD5/ML-TD5.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..22ca7ee0e445b78e445128437bb2087c9439122d
GIT binary patch
literal 62246
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
BXMF$w

literal 0
HcmV?d00001

diff --git a/TD/TD5/q_learning.py b/TD/TD5/q_learning.py
new file mode 100644
index 0000000..f1f7898
--- /dev/null
+++ b/TD/TD5/q_learning.py
@@ -0,0 +1,129 @@
+import numpy as np
+
+def choix_action(epsilon, s, R, Q):
+    """ Renvoie l'action sélectionnée pour l'état s. Epsilon est une valeur seuil entre 0 et 1 permettant 
+        soit de faire de l'exploration (si tirage aléatoire supérieur au seuil), soit de faire 
+        de l'exploitation (si tirage aléatoire inférieur au seuil)
+
+    Parametres
+    ----------
+    epsilon : seuil (entre 0 et 1) pour choisir entre exploration et exploitation afin de sélectionner une action
+    s : état courant
+    R : matrice des récompenses immédiates
+    Q : matrice représentant la fonction action-valeur
+
+    Retour
+    -------
+    a : action sélectionnée
+
+    """
+
+    #########################################################
+    ##### A compléter (et supprimer l'instruction pass) ##### 
+    #########################################################
+    pass
+    
+    # return a
+
+def calcule_q(s, a, alpha, gamma, R, Q):
+    """ Calcule la nouvelle valeur de la fonction action valeur pour l'état s et l'action a
+
+    Parametres
+    ----------
+    s : état courant
+    a : action choisie
+    alpha : vitesse d'apprentissage
+    gamma : facteur d'actualisation
+    R : matrice des récompenses immédiates
+    Q : matrice représentant la fonction action-valeur
+
+    Retour
+    -------
+    q : nouvelle valeur de la fonction action valeur pour l'état s et l'action a
+
+    """
+
+    #########################################################
+    ##### A compléter (et supprimer l'instruction pass) ##### 
+    #########################################################
+    pass
+
+    # return q
+
+def politique(s,Q):
+    """ Détermine la meilleure action connaissant l'état S et la fonction action valeur Q
+
+    Parametres
+    ----------
+    s : état courant
+    Q : matrice représentant la fonction action-valeur
+
+    Retour
+    -------
+    a : action sélectionnée
+
+    """    
+
+    #########################################################
+    ##### A compléter (et supprimer l'instruction pass) ##### 
+    #########################################################
+    pass
+    
+    # return a
+
+
+
+# ===================== Partie 1: Initialisation des données =====================
+alpha = 1
+gamma = 0.8
+nb_episodes = 1000
+epsilon = 0.
+
+R = [
+    [-1, -1, -1, -1, 0, -1],
+    [-1, -1, -1, 0, -1, 100],
+    [-1, -1, -1, 0, -1, -1],
+    [-1, 0, 0, -1, 0, -1],
+    [0, -1, -1, 0, -1, 100],
+    [-1, 0, -1, -1, 0, 100],
+] 
+R = np.array(R) # Matrice des récompenses immédiates
+etat_final = 5
+
+Q = np.zeros(R.shape) # Matrice représentant la fonction action-valeur
+
+nb_etats = nb_actions = R.shape[0]
+
+# ===================== Partie 2: Apprentissage de la fonction action-valeur Q =====================
+print("Apprentissage de la fonction Q")
+for i in range(nb_episodes):
+    print("Episode : ",i)
+    s = np.random.randint(0,nb_etats)
+    print("Etat initial : ",s)
+    while True:      
+        a = choix_action(epsilon, s, R, Q)
+        print("action choisie : ", a)
+
+        Q[s,a] = calcule_q(s, a, alpha, gamma, R, Q)
+
+        if s == etat_final:
+            break
+
+        s = a
+        
+print("Matrice Q_value : ", Q)
+Q = Q / np.max(Q) * 100
+print("Matrice Q_value normalisée : ", Q)
+
+# ===================== Partie 3: Exploitation de la politique d'action apprise =====================
+
+print("Exploitation")
+
+s = 2 # choix d'un état initial
+print("Etat initial : ", s)
+
+while s != etat_final :
+    a = politique(s, Q)
+
+    s = a # nouvel état
+    print("nouvel état : ",s)
-- 
GitLab