|
1 | | -# Py_Stats_Toolkit |
| 1 | +# Py-Stats-Toolkit |
2 | 2 |
|
3 | | -## Description |
| 3 | +Un toolkit Python complet pour l'analyse statistique et le traitement des données, conçu pour être simple d'utilisation tout en offrant des fonctionnalités avancées. |
4 | 4 |
|
5 | | -Py_Stats_Toolkit est une bibliothèque Python complète pour l'analyse statistique avancée. Elle offre une architecture modulaire avec polymorphisme, permettant une utilisation flexible et extensible pour l'analyse de données. |
| 5 | +## 🚀 Installation |
6 | 6 |
|
7 | | -## Installation |
| 7 | +### Installation depuis PyPI (recommandé) |
8 | 8 |
|
9 | 9 | ```bash |
10 | | -pip install py-stats-toolkit |
| 10 | +pip install py-stats-toolkit==1.0.3 |
11 | 11 | ``` |
12 | 12 |
|
13 | | -## Utilisation rapide |
| 13 | +### Installation depuis les sources |
| 14 | + |
| 15 | +```bash |
| 16 | +git clone https://github.com/PhoenixGuardianTools/py-stats-toolkit.git |
| 17 | +cd py-stats-toolkit |
| 18 | +pip install -e . |
| 19 | +``` |
| 20 | + |
| 21 | +## 📦 Fonctionnalités |
| 22 | + |
| 23 | +### Statistiques Descriptives |
| 24 | +- Calcul automatique de toutes les statistiques descriptives |
| 25 | +- Gestion des valeurs manquantes |
| 26 | +- Validation des données |
| 27 | + |
| 28 | +### Régression Linéaire |
| 29 | +- Régression linéaire simple et multiple |
| 30 | +- Validation des hypothèses |
| 31 | +- Diagnostics complets |
| 32 | + |
| 33 | +### Analyse de Corrélation |
| 34 | +- Matrices de corrélation |
| 35 | +- Tests de significativité |
| 36 | +- Visualisations avancées |
| 37 | + |
| 38 | +### Visualisation |
| 39 | +- Graphiques statistiques professionnels |
| 40 | +- Personnalisation complète |
| 41 | +- Export en haute qualité |
| 42 | + |
| 43 | +## 🔧 Utilisation Rapide |
14 | 44 |
|
15 | 45 | ```python |
| 46 | +from py_stats_toolkit.stats import descriptives, regression, correlation |
| 47 | +from py_stats_toolkit.visualization import plots |
16 | 48 | import pandas as pd |
17 | | -from py_stats_toolkit import DescriptiveStatistics, LinearRegression, CorrelationAnalysis, DataVisualizer |
18 | 49 |
|
19 | | -# Créer des données d'exemple |
20 | | -data = pd.DataFrame({ |
21 | | - 'x': [1, 2, 3, 4, 5], |
22 | | - 'y': [2, 4, 5, 4, 5] |
23 | | -}) |
| 50 | +# Charger vos données |
| 51 | +data = pd.read_csv('votre_fichier.csv') |
24 | 52 |
|
25 | 53 | # Statistiques descriptives |
26 | | -stats = DescriptiveStatistics() |
27 | | -result = stats.analyze(data) |
28 | | -print(result) |
| 54 | +stats = descriptives.calculate_descriptive_statistics(data) |
| 55 | +print(stats) |
29 | 56 |
|
30 | 57 | # Régression linéaire |
31 | | -reg = LinearRegression() |
32 | | -reg_result = reg.analyze(data, target='y') |
33 | | -print(reg_result) |
34 | | - |
35 | | -# Analyse de corrélation |
36 | | -corr = CorrelationAnalysis() |
37 | | -corr_result = corr.analyze(data) |
38 | | -print(corr_result) |
| 58 | +model = regression.linear_regression(data, 'variable_cible', ['var1', 'var2']) |
| 59 | +print(model.summary()) |
39 | 60 |
|
40 | 61 | # Visualisation |
41 | | -viz = DataVisualizer() |
42 | | -viz.plot_correlation_matrix(data) |
| 62 | +plots.create_correlation_matrix(data) |
43 | 63 | ``` |
44 | 64 |
|
45 | | -## Utilisation avancée avec polymorphisme |
| 65 | +## 🛠️ Scripts Utilitaires |
46 | 66 |
|
47 | | -```python |
48 | | -from py_stats_toolkit import create_analysis_module, analyze_data |
| 67 | +### Publication Automatisée |
| 68 | + |
| 69 | +Le projet inclut plusieurs scripts pour automatiser la publication : |
| 70 | + |
| 71 | +#### `publish_automated.py` (Recommandé) |
| 72 | +Publication PyPI 100% automatisée sans interaction utilisateur : |
| 73 | + |
| 74 | +```bash |
| 75 | +# Avec token PyPI |
| 76 | +set TWINE_PASSWORD=ton_token_pypi |
| 77 | +python publish_automated.py |
| 78 | + |
| 79 | +# Ou avec fichier .pypirc |
| 80 | +python publish_automated.py |
| 81 | +``` |
| 82 | + |
| 83 | +#### `build_and_ready.py` |
| 84 | +Prépare le package pour publication manuelle : |
| 85 | + |
| 86 | +```bash |
| 87 | +python build_and_ready.py |
| 88 | +``` |
| 89 | + |
| 90 | +#### `release_and_publish.py` |
| 91 | +Publication complète avec release GitHub (nécessite GITHUB_TOKEN) : |
| 92 | + |
| 93 | +```bash |
| 94 | +set GITHUB_TOKEN=ton_token_github |
| 95 | +set TWINE_PASSWORD=ton_token_pypi |
| 96 | +python release_and_publish.py |
| 97 | +``` |
| 98 | + |
| 99 | +#### `clean_cache.py` |
| 100 | +Nettoie tous les fichiers cache et temporaires : |
| 101 | + |
| 102 | +```bash |
| 103 | +python clean_cache.py |
| 104 | +``` |
| 105 | + |
| 106 | +## 🔄 Workflow GitHub Actions |
| 107 | + |
| 108 | +Le projet utilise GitHub Actions pour l'automatisation : |
| 109 | + |
| 110 | +1. **Création d'une release** sur GitHub |
| 111 | +2. **Déclenchement automatique** du workflow |
| 112 | +3. **Build et tests** automatiques |
| 113 | +4. **Publication PyPI** automatique |
| 114 | + |
| 115 | +## 📚 Documentation |
| 116 | + |
| 117 | +- [Documentation complète](https://py-stats-toolkit.readthedocs.io/) |
| 118 | +- [Exemples d'utilisation](https://github.com/PhoenixGuardianTools/py-stats-toolkit/tree/main/examples) |
| 119 | +- [Guide de contribution](CONTRIBUTING.md) |
| 120 | + |
| 121 | +## 🧪 Tests |
| 122 | + |
| 123 | +```bash |
| 124 | +# Installation des dépendances de développement |
| 125 | +pip install -r requirements-dev.txt |
49 | 126 |
|
50 | | -# Créer un module d'analyse avec polymorphisme |
51 | | -module = create_analysis_module("descriptives", precision=2) |
| 127 | +# Exécution des tests |
| 128 | +python -m pytest tests/ |
52 | 129 |
|
53 | | -# Analyser des données automatiquement |
54 | | -result = analyze_data(data, module_type="regression", target='y') |
| 130 | +# Avec couverture |
| 131 | +python -m pytest tests/ --cov=py_stats_toolkit --cov-report=html |
55 | 132 | ``` |
56 | 133 |
|
57 | | -## Modules disponibles |
| 134 | +## 📋 Dépendances |
58 | 135 |
|
59 | | -- **DescriptiveStatistics** : Statistiques descriptives de base |
60 | | -- **LinearRegression** : Régression linéaire avec validation |
61 | | -- **CorrelationAnalysis** : Analyse de corrélation multivariée |
62 | | -- **DataVisualizer** : Visualisations statistiques avancées |
63 | | -- **DataProcessor** : Traitement et nettoyage de données |
64 | | -- **DataValidator** : Validation et vérification de données |
| 136 | +### Dépendances principales |
| 137 | +- numpy >= 1.20.0 |
| 138 | +- pandas >= 1.3.0 |
| 139 | +- scipy >= 1.7.0 |
| 140 | +- matplotlib >= 3.4.0 |
| 141 | +- seaborn >= 0.11.0 |
| 142 | +- statsmodels >= 0.13.0 |
| 143 | +- scikit-learn >= 1.0.0 |
| 144 | +- networkx >= 2.6.0 |
| 145 | +- deap >= 1.3.0 |
65 | 146 |
|
66 | | -## Documentation |
| 147 | +### Dépendances de développement |
| 148 | +- pytest >= 7.0.0 |
| 149 | +- black >= 22.0.0 |
| 150 | +- isort >= 5.0.0 |
| 151 | +- flake8 >= 4.0.0 |
| 152 | +- mypy >= 0.900 |
67 | 153 |
|
68 | | -Pour plus d'informations, consultez la [documentation complète](https://py-stats-toolkit.readthedocs.io/). |
| 154 | +## 🤝 Contribution |
69 | 155 |
|
70 | | -## Contribution |
| 156 | +Les contributions sont les bienvenues ! Consultez notre [guide de contribution](CONTRIBUTING.md) pour plus de détails. |
71 | 157 |
|
72 | | -Les contributions sont les bienvenues ! Consultez notre guide de contribution pour plus de détails. |
| 158 | +## 📄 Licence |
73 | 159 |
|
74 | | -## Licence |
| 160 | +Ce projet est sous licence MIT. Voir le fichier [LICENSE](LICENSE) pour plus de détails. |
75 | 161 |
|
76 | | -Ce projet est sous licence MIT. |
| 162 | +## 🔗 Liens Utiles |
77 | 163 |
|
78 | | -## Contact |
| 164 | +- [PyPI](https://pypi.org/project/py-stats-toolkit/) |
| 165 | +- [GitHub](https://github.com/PhoenixGuardianTools/py-stats-toolkit) |
| 166 | +- [Issues](https://github.com/PhoenixGuardianTools/py-stats-toolkit/issues) |
| 167 | +- [Releases](https://github.com/PhoenixGuardianTools/py-stats-toolkit/releases) |
79 | 168 |
|
80 | | -- **Auteur** : Phoenix Project |
81 | | -- **Email** : contact@phonxproject.onmicrosoft.fr |
82 | | -- **Version** : 1.0.1 |
| 169 | +## 📞 Contact |
83 | 170 |
|
84 | | -## Changelog |
| 171 | +- Email : autopublisher.ai@gmail.com |
| 172 | +- GitHub : [PhoenixGuardianTools](https://github.com/PhoenixGuardianTools) |
85 | 173 |
|
86 | | -### Version 1.0.1 |
87 | | -- Structure PyPI conforme |
88 | | -- Modules autonomes et fonctionnels |
89 | | -- Tests indépendants |
90 | | -- Documentation mise à jour |
91 | | -- Nettoyage complet des dépendances obsolètes |
| 174 | +--- |
92 | 175 |
|
93 | | -### Version 1.0.0 |
94 | | -- Version initiale |
95 | | -- Modules de base implémentés |
96 | | -- Architecture modulaire complète |
| 176 | +**Version actuelle : 1.0.3** - Automatisation complète de la publication |
0 commit comments