Documentation MantiKo

Introduction

MantiKo est un outil d'exploration sémantique du vocabulaire français. À partir d'un ou plusieurs mots, il calcule les termes les plus proches sur le plan du sens et les classe par similarité.
Il repose sur des vecteurs de mots (word embeddings) : chaque mot est représenté par un point dans un espace mathématique à plusieurs centaines de dimensions, et la proximité entre deux mots correspond à la distance entre leurs points. Plus deux mots se retrouvent fréquemment dans des contextes similaires dans les textes, plus ils seront proches.
MantiKo s'adresse aux poètes en quête de mots qui "sonnent" dans le même univers, aux auteurs qui cherchent des synonymes ou des termes associés, et à toute personne curieuse des liens sémantiques entre les mots.
Cette documentation vous guidera à travers toutes les fonctionnalités de MantiKo.

Interface

L'interface de MantiKo est organisée en trois panneaux :
Panneau gauche (Recherche) : contient les blocs de mots à explorer, les filtres et le nombre de résultats souhaité. Sur téléphone, ce panneau est accessible via le bouton Recherche.
Panneau central (Résultats) : affiche le tableau des mots trouvés, triés par similarité décroissante. Le bouton Afficher la constellation apparaît en bas une fois les résultats chargés.
Panneau droit (Ma sélection) : liste les mots que vous avez marqués d'une étoile pour les conserver. Sur téléphone, accessible via le bouton Ma sélection.
Les boutons Rechercher et Réinitialiser se trouvent en haut du panneau gauche. Appuyer sur Entrée dans un champ de mot lance également la recherche.

Mots à explorer

La section Mots à explorer permet de saisir jusqu'à trois mots. Chaque mot constitue un bloc. Le premier bloc est toujours en addition ; les blocs suivants peuvent être en addition ou en soustraction.
Le bouton ＋ Ajouter un mot crée un nouveau bloc. Il est désactivé lorsque le maximum de trois blocs est atteint.

1) Addition

Lorsque plusieurs mots sont en addition, MantiKo cherche des termes qui se trouvent à la fois dans l'univers sémantique de chacun d'eux. Le résultat est une intersection de leurs espaces de sens.
Exemples :
- nature + aride → désertique, inhospitalière, sauvage, hostile...
- amour + douleur → souffrance, affection, tourment, jalousie, solitude...

2) Soustraction

La soustraction retire une dimension sémantique de la recherche. Elle permet de trouver des mots proches du premier terme, mais éloignés du terme soustrait.
Pour basculer un bloc en soustraction, cliquez sur le signe + situé à gauche du champ : il devient −. Un clic supplémentaire revient à l'addition.
Exemples :
- amour - douleur → aimant, époux, fraternel, âme-soeur, idylle...
- foule - silence → manifestation, électriser, cosmopolite, plèbe, mouvante...
Un encart d'information apparaît automatiquement dès qu'un bloc est en soustraction pour rappeler son fonctionnement.

3) Poids

Chaque bloc possède un sélecteur de poids à trois niveaux :
- F (Faible) : le mot influence peu le résultat.
- N (Normal) : poids par défaut, influence équilibrée.
- + (Fort) : le mot prend plus d'importance dans le calcul de similarité.
Les poids permettent de nuancer la combinaison : avec amour (fort) + guerre (faible), les résultats resteront principalement dans l'univers de l'amour, avec une légère inflexion vers la conflictualité.

Filtres

L'onglet Filtres de la sidebar gauche donne accès à trois types de filtres appliqués aux résultats retournés.

1) Classes grammaticales

Cinq classes grammaticales peuvent être activées ou désactivées indépendamment :
- Nom : noms communs (ex. : forêt, lumière, chant).
- Nom propre : noms propres géographiques, mythologiques, etc. (ex. : Olympe, Seine, Apollon).
- Adjectif : adjectifs qualificatifs (ex. : sombre, ardent, limpide).
- Verbe : verbes à l'infinitif (ex. : brûler, murmurer, errer).
- Adverbe : adverbes (ex. : doucement, ardemment).
Par défaut, toutes les classes sont activées. Décochez celles que vous souhaitez exclure pour affiner la liste selon vos besoins poétiques.

2) Nombre de syllabes

Les champs De et à permettent de limiter les résultats aux mots dont le nombre de syllabes est compris dans un intervalle donné.
Exemples :
- De 1 à 1 : monosyllabes uniquement (nuit, feu, roi, voix...).
- De 3 à 4 : mots de 3 ou 4 syllabes (lumière, tendresse, mélancolie...).
Laisser les champs vides désactive ce filtre et retourne les mots quelle que soit leur longueur syllabique.

3) Nombre de résultats

Le sélecteur Nombre de résultats (dans l'onglet Mot) contrôle combien de mots sont retournés par la recherche : 100 ou 200.
Choisir 200 peut être utile pour explorer un champ sémantique large, mais allonge légèrement le temps de chargement.

Tableau de résultats

Le tableau central affiche les mots trouvés, classés du plus similaire au moins similaire.

1) Colonnes

- Actions : deux boutons : ★ pour ajouter ou retirer le mot de la sélection, et ? pour consulter sa définition.
- Mot : la forme orthographique du mot.
- Classe : la classe grammaticale du mot, affichée sous forme de badge coloré (NOM, NOMP, ADJ, VER, ADV).
- Syll. : le nombre de syllabes du mot.
- Similarité : score entre 0 et 1 représentant la proximité sémantique avec la combinaison de mots recherchée. Une barre de progression le visualise.

2) Similarité

La similarité est calculée à partir de la distance cosinus entre les vecteurs de mots. Elle est comprise entre 0 et 1 :
- Proche de 1 : très grande proximité sémantique.
- Proche de 0 : peu de lien sémantique avec la requête.
Les mots en tête de liste sont donc les plus directement liés au(x) mot(s) recherché(s). La valeur absolue n'est pas interprétable en isolation ; c'est l'ordre relatif qui compte.

3) Définition

Le bouton ? à gauche de chaque mot ouvre une fenêtre affichant la définition issue du dictionnaire intégré à SemiRimeS.
Chaque sens est présenté sur une ligne séparée. Un lien vers le CNRTL (Centre National de Ressources Textuelles et Lexicales) est proposé lorsqu'une définition est disponible, pour consulter l'article complet.

Ma sélection

La sidebar droite recense les mots que vous avez marqués d'une ★ dans le tableau de résultats. Elle permet de construire une liste de mots au fil de plusieurs recherches.
L'étoile est orange pour les mots sélectionnés et grise pour les autres. Cliquer à nouveau sur l'étoile d'un mot déjà sélectionné le retire de la liste.
Deux boutons sont disponibles :
- Export : télécharge la sélection sous forme d'un fichier texte (.txt), un mot par ligne. Pratique pour réutiliser la liste dans un éditeur.
- Réinitialiser : vide entièrement la sélection et remet toutes les étoiles en gris dans le tableau.
La sélection est locale à la session en cours et n'est pas sauvegardée entre les visites.

Constellation sémantique

Après une recherche, le bouton ✦ Afficher la constellation apparaît en bas du panneau central. Il ouvre une fenêtre plein écran affichant les résultats sous forme d'un nuage de mots.
Chaque mot est positionné aléatoirement dans l'espace disponible. Sa taille est proportionnelle à sa similarité : les mots les plus proches sémantiquement apparaissent en plus grand. Chaque mot possède une couleur distincte pour faciliter la lecture.
Survoler un mot le met en évidence (passage en orange, légère mise à l'échelle). Une infobulle affiche la classe grammaticale, le nombre de syllabes et le score de similarité.
La constellation affiche jusqu'à 60 mots. Pour fermer, cliquer sur ✕ ou en dehors de la fenêtre.
Cette vue est particulièrement utile pour saisir d'un coup d'œil le champ sémantique d'une combinaison de mots.