diff --git a/kos2vec/README.md b/kos2vec/README.md
index 40417dd..207c2b0 100755
--- a/kos2vec/README.md
+++ b/kos2vec/README.md
@@ -1,7 +1,71 @@
 
-## Installation 
-pip3 install -r requirements.txt --user
 
-## execution
-python3 exec_indexer.py -indent  data/
+#kos2vec - Application d’indexation sémantique sur  une ressource termino-ontologique (RTO)
+
+**Identification de concepts sur la mémoire basé sur une ontology et utilisant un modèle de langue**
+
+## Principe de fonctionnement
+
+  
+![text](image.jpg)  
+  
+  
+Le système prend en entrée les métadonnées associées à un article (titre, résumé) et renvoie une sélection de concepts tirés du thesaurus mémoire.
+Il se compose de 3 modules principaux : 
+ 
+- le module syntaxique analyse les documents d'entrée et identifie les concepts qui sont explicitement mentionnés dans le document. 
+
+- le Module semantique  extrait des candidats termes (cunking) et calcule la similarité de ceux-ci avec les nœuds de l'ontologie en tirant parti de l'intégration des mots dans un modèle Embedding.  Il sélection des termes RTO directement présent ou proche voisin dans le modèle.
+
+![text](image2.jpg)
+  
+
+- le module de post-traitement combine les résultats de ces deux modules, élimine les valeurs aberrantes et les améliore en incluant les "super-concepts pertinents" (broader).
+
+
+L'approche exploite une RTO de loterre et des plongements lexicaux calculés sur un corpus du domaine.
+
+ * Le modele de langue est de type Word2Vec et il construit sur un corpus Istex de 540.000 résumés annotés par les termes de la RTO  et les ngrams les plus fréquents (collocation lexicale).
+ * L'Ontology mémoire provient du site Inist Loterre : https://skosmos.loterre.fr/P66/fr/
+
+
+## Utilisation
+
+### Sollicitation du WebService
+
+
+[/v1/en/index?indent=True](/v1/en/index?indent=True)
+
+
+
+* Prend en entrée un flux **json** au format **id/value** :
+```
+[
+{"idt":"11-0278198","value":"reduction fear child comparison positive information imagery control condition study...
+ effect ... "},
+{"idt":"07-0413881","value":"avoidance hemodilution selective cerebral perfusion neurobehavioral outcome ... "}
+]
+```
+* Produit en sortie un **flux json** contenant les résultats d'une indexation sur le thesaurus mémoire :
+  
+
+  * **"idt"** : identifiant fourni en entrée
+  * **"syntactic"** : résultat de l'indexation syntactique
+  * **"semantic"** : résultat de l'indexation semantique
+  * **"union"** : union des deuc indexations
+  * **"enhancement"** : trace textuelle des indexations
+  * **"explanation"** : les concepts broader de tous les concepts trouvés  
+
+#### Exemple
+```
+cat <<EOF | curl --proxy "" -X POST --data-binary @- "http://kos2vec-01.tdmservices.intra.inist.fr/v1/en/index?indent=True" 
+[
+{"idt":"6GQ-2M7PJ87J-N","value":" Autonoetic consciousness refers to the ability to mentally transport oneself back in subjective time to relive elements of, or all, of a past event, and is compromised in the early stages of disease of Alzheimer (AD). Here, we investigate autobiographical memory (ABM) and the recollective experience in amnestic mild cognitive impairment ( aMCI ). aMCI participants exhibited significant deficits compared with healthy elderly controls for both personal semantic and event detail components of ABM. These decrements were evident across all life epochs for episodic recall . Recall of an event that occurred 1 week previously, was tested in the same spatiotemporal context, and provided the greatest group dissociation, with elderly controls benefitting from a context-dependent memory effect . This reinstantiation of context did not ameliorate the anterograde deficits in the aMCI cohort, nor did it facilitate the mental reliving of these memories for either participant group. Whereas reliving judgments were comparable in both groups, aMCI participants exhibited a compromised capacity to generate vivid, self-referential visual imagery and to re-experience the original emotion of events. These contextual and experiential deficits extended beyond recently encountered events into remote epochs, and suggest a greater level of ABM impairment in aMCI than previously assumed. The value associated with a stimulus as expressed on a continuum from pleasant to unpleasant or from attractive to aversive.6H6-1MZ40HDG-C"
+},{
+"idt":"6H6-2K1Z5BMH-L","value":" Abstract: In the Deese paradigm , studying a list of semantic associates (holiday, beach, etc.) produces false explicit memory for a nonpresented lure (vacation). Here, we examine false memory with implicit retrieval . Experiment 1 tested memory for lures and matched on-list targets, using stem completion (implicit) and stem-cued recall (explicit). We replicated McDermott's (1997) finding of implicit false memory at a 10-min delay, using better controls for explicit contamination. In Experiment 2, we show that this semantic priming is modality-specific (on the visual test, lure priming was reduced with auditory study of the semantic associates ), consistent with the perceptual nature of stem completion . In Experiment 3, additional study presentations reduced false memory with explicit, but not implicit, retrieval , consistent with suppression of gist-based responses by veridical information only when explicit retrieval is required. Results also dissociate implicit and explicit false memory and demonstrate similarities between false and true memories with implicit retrieval . "}
+]
+EOF
+```
+
+
 
diff --git a/kos2vec/examples.http b/kos2vec/examples.http
new file mode 100644
index 0000000..20795e4
--- /dev/null
+++ b/kos2vec/examples.http
@@ -0,0 +1,8 @@
+
+POST http://kos2vec-01.tdmservices.intra.inist.fr/v1/en/index?indent=True  HTTP/1.1
+Content-Type: application/json
+
+[
+{"idt":"6GQ-2M7PJ87J-N","value":" Autonoetic consciousness refers to the ability to mentally transport oneself back in subjective time to relive elements of, or all, of a past event, and is compromised in the early stages of disease of Alzheimer (AD). Here, we investigate autobiographical memory (ABM) and the recollective experience in amnestic mild cognitive impairment ( aMCI ). aMCI participants exhibited significant deficits compared with healthy elderly controls for both personal semantic and event detail components of ABM. These decrements were evident across all life epochs for episodic recall . Recall of an event that occurred 1 week previously, was tested in the same spatiotemporal context, and provided the greatest group dissociation, with elderly controls benefitting from a context-dependent memory effect . This reinstantiation of context did not ameliorate the anterograde deficits in the aMCI cohort, nor did it facilitate the mental reliving of these memories for either participant group. Whereas reliving judgments were comparable in both groups, aMCI participants exhibited a compromised capacity to generate vivid, self-referential visual imagery and to re-experience the original emotion of events. These contextual and experiential deficits extended beyond recently encountered events into remote epochs, and suggest a greater level of ABM impairment in aMCI than previously assumed. The value associated with a stimulus as expressed on a continuum from pleasant to unpleasant or from attractive to aversive.6H6-1MZ40HDG-C"},
+{"idt":"6H6-2K1Z5BMH-L","value":" Abstract: In the Deese paradigm , studying a list of semantic associates (holiday, beach, etc.) produces false explicit memory for a nonpresented lure (vacation). Here, we examine false memory with implicit retrieval . Experiment 1 tested memory for lures and matched on-list targets, using stem completion (implicit) and stem-cued recall (explicit). We replicated McDermott's (1997) finding of implicit false memory at a 10-min delay, using better controls for explicit contamination. In Experiment 2, we show that this semantic priming is modality-specific (on the visual test, lure priming was reduced with auditory study of the semantic associates ), consistent with the perceptual nature of stem completion . In Experiment 3, additional study presentations reduced false memory with explicit, but not implicit, retrieval , consistent with suppression of gist-based responses by veridical information only when explicit retrieval is required. Results also dissociate implicit and explicit false memory and demonstrate similarities between false and true memories with implicit retrieval . "}
+]
diff --git a/kos2vec/image.jpg b/kos2vec/image.jpg
new file mode 100644
index 0000000..be6ae64
--- /dev/null
+++ b/kos2vec/image.jpg
Binary files differ
diff --git a/kos2vec/image2.jpg b/kos2vec/image2.jpg
new file mode 100644
index 0000000..f68c737
--- /dev/null
+++ b/kos2vec/image2.jpg
Binary files differ
diff --git a/kos2vec/swagger.json b/kos2vec/swagger.json
new file mode 100644
index 0000000..4da2f0d
--- /dev/null
+++ b/kos2vec/swagger.json
@@ -0,0 +1,23 @@
+{
+	"info": {
+        "version": "1.5.0"
+    },
+    "servers": [{
+        "url": "{scheme}://{hostname}",
+        "variables": {
+            "scheme": {
+                "default": "https"
+            }
+        }
+    }],
+    "tags": [
+        {
+            "name": "Indexation  Loterre",
+            "description": "indexation sur ressource Memoire Loterre",
+            "externalDocs": {
+                "description": "Plus de documentation",
+                "url": "https://gitbucket.inist.fr/tdm/web-services/tree/master/kos2vec"
+            }
+        }
+    ]     
+}
diff --git a/kos2vec/v1/en/index.ini b/kos2vec/v1/en/index.ini
index cee6696..9d5c46a 100755
--- a/kos2vec/v1/en/index.ini
+++ b/kos2vec/v1/en/index.ini
@@ -1,11 +1,13 @@
 # OpenAPI Documentation - JSON format (dot notation)
 mimeType = application/json
 post.operationId = post-v1-detect-lang
-post.description =indexation
-post.responses.default.description = Renvoie un Json composé d'`id`, `value` avec `value` qui contient le resultat d une indexation Loterre
+post.description = indexation controlée sur thesaursuy memoire
+post.responses.default.description = Renvoie un Json composé d'`id`, `value` avec `value` qui contient le resultat de l'indexation selon le thesaurus mémoire
 post.responses.default.content.application/json.schema.$ref =  #/components/schemas/JSONStream
-post.summary = indexation sur ressource loterre mémoire
-post.tags.0 = NLP
+post.summary = indexation controlée sur ressource loterre mémoire
+post.tags.0 = indexation
+post.responses.default.content.application/json.example.0.id = 0
+post.responses.default.content.application/json.example.0.value = Autonoetic consciousness refers to the ability to mentally transport oneself back in subjective time to relive elements of, or all, of a past event, and is compromised in the early stages of disease of Alzheimer (AD).
 post.requestBody.required = true
 post.requestBody.content.application/json.schema.$ref = #/components/schemas/JSONStream
 post.parameters.0.in = query