Introduction

Ce document fournit un guide technique pour l'utilisation de la boîte à outils ttskit, conçue pour la synthèse vocale en chinois. Elle comprend des modules pour l'encodage, la synthèse, la vocodisation et la visualisation.

Structure du répertoire du projet

Voici l'organisation typique des fichiers dans le projet ttskit :

ttskit/
├── README.md
├── setup.py
├── src/
│   ├── initialisation.py
│   ├── parametres.py
│   ├── modeles/
│   ├── outils/
│   └── ...
├── tests/
├── documentation/
├── exemples/
└── ...

• README.md : Document principal décrivant le projet.
• setup.py : Script d'installation pour configurer l'environnement.
• src/ : Répertoire source contenant le code principal.
• src/initialisation.py : Fichier pour l'initialisation du projet.
• src/parametres.py : Fichier de gestion des configurations.
• src/modeles/ : Module regroupant les modèles de synthèse vocale.
• src/outils/ : Module avec des fonctions utilitaires.
• tests/ : Répertoire pour les tests unitaiers et d'intégration.
• documentation/ : Ressources documentaires supplémentaires.
• exemples/ : Scripts d'exemple pour démarrer rapidement.

Fichier de démarrage

Le point d'entrée principal du projet se trouve dans src/initialisation.py. Ce fichier orchestre le chargement des configurations et des modèles.

# src/initialisation.py
from src.parametres import recuperer_configuration
from src.modeles import instancier_modele
from src.outils import configurer_environnement

def executer():
    configuration = recuperer_configuration()
    modele_synthese = instancier_modele(configuration)
    configurer_environnement(configuration)
    # Autres étapes d'initialisation requises

if __name__ == "__main__":
    executer()

Ce code définit une fonction executer() qui charge les paramètres, initialise le modèle et prépare l'environnement d'exécution. L'appel direct depuis la ligne de commande active cette séquence.

Fichier de configuration

Les paramètres du projet sont gérés via src/parametres.py, permettant une personnalisation flexible via des variables d'environnement.

# src/parametres.py
import os

def recuperer_configuration():
    parametres = {
        'chemin_modele': os.environ.get('CHEMIN_MODELE', 'chemin_par_defaut'),
        'frequence_echantillonnage': int(os.environ.get('FREQUENCE_ECHANTILLONNAGE', 22500)),
        'activer_gpu': os.environ.get('ACTIVER_GPU', 'vrai').lower() == 'vrai',
        'voix_par_defaut': os.environ.get('VOIX_PAR_DEFAUT', 'voix_standard'),
    }
    return parametres

La fonction recuperer_configuration() extrait les valeurs depuis les vraiables d'environnement, avec des valeurs par défaut. Les clés incluent le chemin du modèle, la fréquence d'échantillonnage, l'utilisation du GPU et la voix sélectionnée.