dragon-ml-toolbox 3.12.6__tar.gz → 4.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of dragon-ml-toolbox might be problematic. Click here for more details.

Files changed (41) hide show
  1. dragon_ml_toolbox-4.1.0/PKG-INFO +253 -0
  2. dragon_ml_toolbox-4.1.0/README.md +177 -0
  3. dragon_ml_toolbox-4.1.0/dragon_ml_toolbox.egg-info/PKG-INFO +253 -0
  4. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/dragon_ml_toolbox.egg-info/SOURCES.txt +6 -2
  5. dragon_ml_toolbox-4.1.0/dragon_ml_toolbox.egg-info/requires.txt +68 -0
  6. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/ml_tools/ETL_engineering.py +2 -2
  7. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/ml_tools/GUI_tools.py +2 -2
  8. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/ml_tools/MICE_imputation.py +4 -3
  9. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/ml_tools/ML_callbacks.py +8 -4
  10. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/ml_tools/ML_evaluation.py +11 -6
  11. dragon_ml_toolbox-4.1.0/ml_tools/ML_inference.py +131 -0
  12. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/ml_tools/ML_trainer.py +17 -8
  13. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/ml_tools/PSO_optimization.py +116 -62
  14. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/ml_tools/RNN_forecast.py +5 -0
  15. dragon_ml_toolbox-4.1.0/ml_tools/SQL.py +272 -0
  16. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/ml_tools/VIF_factor.py +4 -3
  17. dragon_ml_toolbox-4.1.0/ml_tools/_logger.py +36 -0
  18. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/ml_tools/_pytorch_models.py +1 -1
  19. dragon_ml_toolbox-4.1.0/ml_tools/_script_info.py +8 -0
  20. dragon_ml_toolbox-3.12.6/ml_tools/logger.py → dragon_ml_toolbox-4.1.0/ml_tools/custom_logger.py +4 -66
  21. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/ml_tools/data_exploration.py +2 -66
  22. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/ml_tools/datasetmaster.py +3 -2
  23. dragon_ml_toolbox-4.1.0/ml_tools/ensemble_inference.py +249 -0
  24. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/ml_tools/ensemble_learning.py +40 -294
  25. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/ml_tools/handle_excel.py +3 -2
  26. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/ml_tools/keys.py +13 -2
  27. dragon_ml_toolbox-4.1.0/ml_tools/path_manager.py +375 -0
  28. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/ml_tools/utilities.py +2 -180
  29. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/pyproject.toml +70 -18
  30. dragon_ml_toolbox-3.12.6/PKG-INFO +0 -137
  31. dragon_ml_toolbox-3.12.6/README.md +0 -94
  32. dragon_ml_toolbox-3.12.6/dragon_ml_toolbox.egg-info/PKG-INFO +0 -137
  33. dragon_ml_toolbox-3.12.6/dragon_ml_toolbox.egg-info/requires.txt +0 -29
  34. dragon_ml_toolbox-3.12.6/ml_tools/ML_tutorial.py +0 -300
  35. dragon_ml_toolbox-3.12.6/ml_tools/path_manager.py +0 -212
  36. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/LICENSE +0 -0
  37. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/LICENSE-THIRD-PARTY.md +0 -0
  38. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/dragon_ml_toolbox.egg-info/dependency_links.txt +0 -0
  39. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/dragon_ml_toolbox.egg-info/top_level.txt +0 -0
  40. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/ml_tools/__init__.py +0 -0
  41. {dragon_ml_toolbox-3.12.6 → dragon_ml_toolbox-4.1.0}/setup.cfg +0 -0
@@ -0,0 +1,253 @@
1
+ Metadata-Version: 2.4
2
+ Name: dragon-ml-toolbox
3
+ Version: 4.1.0
4
+ Summary: A collection of tools for data science and machine learning projects.
5
+ Author-email: Karl Loza <luigiloza@gmail.com>
6
+ License-Expression: MIT
7
+ Project-URL: Homepage, https://github.com/DrAg0n-BoRn/ML_tools
8
+ Project-URL: Changelog, https://github.com/DrAg0n-BoRn/ML_tools/blob/master/CHANGELOG.md
9
+ Classifier: Programming Language :: Python :: 3
10
+ Classifier: Operating System :: OS Independent
11
+ Requires-Python: >=3.10
12
+ Description-Content-Type: text/markdown
13
+ License-File: LICENSE
14
+ License-File: LICENSE-THIRD-PARTY.md
15
+ Provides-Extra: base
16
+ Requires-Dist: pandas; extra == "base"
17
+ Requires-Dist: numpy; extra == "base"
18
+ Requires-Dist: polars; extra == "base"
19
+ Requires-Dist: joblib; extra == "base"
20
+ Provides-Extra: ml
21
+ Requires-Dist: numpy; extra == "ml"
22
+ Requires-Dist: pandas; extra == "ml"
23
+ Requires-Dist: polars; extra == "ml"
24
+ Requires-Dist: joblib; extra == "ml"
25
+ Requires-Dist: scikit-learn; extra == "ml"
26
+ Requires-Dist: matplotlib; extra == "ml"
27
+ Requires-Dist: seaborn; extra == "ml"
28
+ Requires-Dist: imbalanced-learn; extra == "ml"
29
+ Requires-Dist: ipython; extra == "ml"
30
+ Requires-Dist: ipykernel; extra == "ml"
31
+ Requires-Dist: notebook; extra == "ml"
32
+ Requires-Dist: jupyterlab; extra == "ml"
33
+ Requires-Dist: ipywidgets; extra == "ml"
34
+ Requires-Dist: xgboost; extra == "ml"
35
+ Requires-Dist: lightgbm; extra == "ml"
36
+ Requires-Dist: shap; extra == "ml"
37
+ Requires-Dist: tqdm; extra == "ml"
38
+ Requires-Dist: Pillow; extra == "ml"
39
+ Provides-Extra: mice
40
+ Requires-Dist: numpy<2.0; extra == "mice"
41
+ Requires-Dist: pandas; extra == "mice"
42
+ Requires-Dist: polars; extra == "mice"
43
+ Requires-Dist: joblib; extra == "mice"
44
+ Requires-Dist: miceforest>=6.0.0; extra == "mice"
45
+ Requires-Dist: plotnine>=0.12; extra == "mice"
46
+ Requires-Dist: matplotlib; extra == "mice"
47
+ Requires-Dist: statsmodels; extra == "mice"
48
+ Requires-Dist: lightgbm<=4.5.0; extra == "mice"
49
+ Requires-Dist: shap; extra == "mice"
50
+ Provides-Extra: pytorch
51
+ Requires-Dist: torch; extra == "pytorch"
52
+ Requires-Dist: torchvision; extra == "pytorch"
53
+ Provides-Extra: excel
54
+ Requires-Dist: pandas; extra == "excel"
55
+ Requires-Dist: openpyxl; extra == "excel"
56
+ Requires-Dist: ipython; extra == "excel"
57
+ Requires-Dist: ipykernel; extra == "excel"
58
+ Requires-Dist: notebook; extra == "excel"
59
+ Requires-Dist: jupyterlab; extra == "excel"
60
+ Requires-Dist: ipywidgets; extra == "excel"
61
+ Provides-Extra: gui-boost
62
+ Requires-Dist: numpy; extra == "gui-boost"
63
+ Requires-Dist: joblib; extra == "gui-boost"
64
+ Requires-Dist: FreeSimpleGUI>=5.2; extra == "gui-boost"
65
+ Requires-Dist: pyinstaller; extra == "gui-boost"
66
+ Requires-Dist: xgboost; extra == "gui-boost"
67
+ Requires-Dist: lightgbm; extra == "gui-boost"
68
+ Provides-Extra: gui-torch
69
+ Requires-Dist: numpy; extra == "gui-torch"
70
+ Requires-Dist: FreeSimpleGUI>=5.2; extra == "gui-torch"
71
+ Requires-Dist: pyinstaller; extra == "gui-torch"
72
+ Provides-Extra: plot
73
+ Requires-Dist: matplotlib; extra == "plot"
74
+ Requires-Dist: seaborn; extra == "plot"
75
+ Dynamic: license-file
76
+
77
+ # dragon-ml-toolbox
78
+
79
+ A collection of Python utilities for data science and machine learning, structured as a modular package for easy reuse and installation. This package has no base dependencies, allowing for lightweight and customized virtual environments.
80
+
81
+ ### Features:
82
+
83
+ - Modular scripts for data exploration, logging, machine learning, and more.
84
+ - Designed for seamless integration as a Git submodule or installable Python package.
85
+
86
+ ## Installation
87
+
88
+ **Python 3.10+**
89
+
90
+ ### Via PyPI
91
+
92
+ Install the latest stable release from PyPI:
93
+
94
+ ```bash
95
+ pip install dragon-ml-toolbox
96
+ ```
97
+
98
+ ### Via GitHub (Editable)
99
+
100
+ Clone the repository and install in editable mode with optional dependencies:
101
+
102
+ ```bash
103
+ git clone https://github.com/DrAg0n-BoRn/ML_tools.git
104
+ cd ML_tools
105
+ pip install -e .
106
+ ```
107
+
108
+ ### Via conda-forge
109
+
110
+ Install from the conda-forge channel:
111
+
112
+ ```bash
113
+ conda install -c conda-forge dragon-ml-toolbox
114
+ ```
115
+
116
+ ## Modular Installation
117
+
118
+ ### 📦 Core Machine Learning Toolbox [ML]
119
+
120
+ Installs a comprehensive set of tools for typical data science workflows, including data manipulation, modeling, and evaluation. PyTorch is required.
121
+
122
+ ```Bash
123
+ pip install "dragon-ml-toolbox[ML]"
124
+ ```
125
+
126
+ To install the standard CPU-only versions of Torch and Torchvision:
127
+
128
+ ```Bash
129
+ pip install "dragon-ml-toolbox[pytorch]"
130
+ ```
131
+
132
+ ⚠️ To make use of GPU acceleration (highly recommended), follow the official instructions: [PyTorch website](https://pytorch.org/get-started/locally/)
133
+
134
+ #### Modules:
135
+
136
+ ```bash
137
+ custom_logger
138
+ data_exploration
139
+ datasetmaster
140
+ ensemble_learning
141
+ ensemble_inference
142
+ ETL_engineering
143
+ ML_callbacks
144
+ ML_evaluation
145
+ ML_trainer
146
+ ML_inference
147
+ path_manager
148
+ PSO_optimization
149
+ SQL
150
+ RNN_forecast
151
+ utilities
152
+ ```
153
+
154
+ ### 🔬 MICE Imputation and Variance Inflation Factor [mice]
155
+
156
+ ⚠️ Important: This group has strict version requirements. It is highly recommended to install this group in a separate virtual environment.
157
+
158
+ ```Bash
159
+ pip install "dragon-ml-toolbox[mice]"
160
+ ```
161
+
162
+ #### Modules:
163
+
164
+ ```bash
165
+ custom_logger
166
+ MICE_imputation
167
+ VIF_factor
168
+ path_manager
169
+ utilities
170
+ ```
171
+
172
+ ### 📋 Excel File Handling [excel]
173
+
174
+ Installs dependencies required to process and handle .xlsx or .xls files.
175
+
176
+ ```Bash
177
+ pip install "dragon-ml-toolbox[excel]"
178
+ ```
179
+
180
+ #### Modules:
181
+
182
+ ```bash
183
+ custom_logger
184
+ handle_excel
185
+ path_manager
186
+ ```
187
+
188
+ ### 🎰 GUI for Boosting Algorithms (XGBoost, LightGBM) [gui-boost]
189
+
190
+ For GUIs that include plotting functionality, you must also install the [plot] extra.
191
+
192
+ ```Bash
193
+ pip install "dragon-ml-toolbox[gui-boost]"
194
+ ```
195
+
196
+ ```Bash
197
+ pip install "dragon-ml-toolbox[gui-boost,plot]"
198
+ ```
199
+
200
+ #### Modules:
201
+
202
+ ```bash
203
+ GUI_tools
204
+ ensemble_inference
205
+ path_manager
206
+ ```
207
+
208
+ ### 🤖 GUI for PyTorch Models [gui-torch]
209
+
210
+ For GUIs that include plotting functionality, you must also install the [plot] extra.
211
+
212
+ ```Bash
213
+ pip install "dragon-ml-toolbox[gui-torch]"
214
+ ```
215
+
216
+ ```Bash
217
+ pip install "dragon-ml-toolbox[gui-torch,plot]"
218
+ ```
219
+
220
+ #### Modules:
221
+
222
+ ```bash
223
+ GUI_tools
224
+ ML_inference
225
+ path_manager
226
+ ```
227
+
228
+ ### 🎫 Base Tools [base]
229
+
230
+ General purpose functions and classes.
231
+
232
+ ```Bash
233
+ pip install "dragon-ml-toolbox[base]"
234
+ ```
235
+
236
+ #### Modules:
237
+
238
+ ```bash
239
+ ETL_Engineering
240
+ custom_logger
241
+ SQL
242
+ utilities
243
+ path_manager
244
+ ```
245
+
246
+ ## Usage
247
+
248
+ After installation, import modules like this:
249
+
250
+ ```python
251
+ from ml_tools.utilities import serialize_object, deserialize_object
252
+ from ml_tools.custom_logger import custom_logger
253
+ ```
@@ -0,0 +1,177 @@
1
+ # dragon-ml-toolbox
2
+
3
+ A collection of Python utilities for data science and machine learning, structured as a modular package for easy reuse and installation. This package has no base dependencies, allowing for lightweight and customized virtual environments.
4
+
5
+ ### Features:
6
+
7
+ - Modular scripts for data exploration, logging, machine learning, and more.
8
+ - Designed for seamless integration as a Git submodule or installable Python package.
9
+
10
+ ## Installation
11
+
12
+ **Python 3.10+**
13
+
14
+ ### Via PyPI
15
+
16
+ Install the latest stable release from PyPI:
17
+
18
+ ```bash
19
+ pip install dragon-ml-toolbox
20
+ ```
21
+
22
+ ### Via GitHub (Editable)
23
+
24
+ Clone the repository and install in editable mode with optional dependencies:
25
+
26
+ ```bash
27
+ git clone https://github.com/DrAg0n-BoRn/ML_tools.git
28
+ cd ML_tools
29
+ pip install -e .
30
+ ```
31
+
32
+ ### Via conda-forge
33
+
34
+ Install from the conda-forge channel:
35
+
36
+ ```bash
37
+ conda install -c conda-forge dragon-ml-toolbox
38
+ ```
39
+
40
+ ## Modular Installation
41
+
42
+ ### 📦 Core Machine Learning Toolbox [ML]
43
+
44
+ Installs a comprehensive set of tools for typical data science workflows, including data manipulation, modeling, and evaluation. PyTorch is required.
45
+
46
+ ```Bash
47
+ pip install "dragon-ml-toolbox[ML]"
48
+ ```
49
+
50
+ To install the standard CPU-only versions of Torch and Torchvision:
51
+
52
+ ```Bash
53
+ pip install "dragon-ml-toolbox[pytorch]"
54
+ ```
55
+
56
+ ⚠️ To make use of GPU acceleration (highly recommended), follow the official instructions: [PyTorch website](https://pytorch.org/get-started/locally/)
57
+
58
+ #### Modules:
59
+
60
+ ```bash
61
+ custom_logger
62
+ data_exploration
63
+ datasetmaster
64
+ ensemble_learning
65
+ ensemble_inference
66
+ ETL_engineering
67
+ ML_callbacks
68
+ ML_evaluation
69
+ ML_trainer
70
+ ML_inference
71
+ path_manager
72
+ PSO_optimization
73
+ SQL
74
+ RNN_forecast
75
+ utilities
76
+ ```
77
+
78
+ ### 🔬 MICE Imputation and Variance Inflation Factor [mice]
79
+
80
+ ⚠️ Important: This group has strict version requirements. It is highly recommended to install this group in a separate virtual environment.
81
+
82
+ ```Bash
83
+ pip install "dragon-ml-toolbox[mice]"
84
+ ```
85
+
86
+ #### Modules:
87
+
88
+ ```bash
89
+ custom_logger
90
+ MICE_imputation
91
+ VIF_factor
92
+ path_manager
93
+ utilities
94
+ ```
95
+
96
+ ### 📋 Excel File Handling [excel]
97
+
98
+ Installs dependencies required to process and handle .xlsx or .xls files.
99
+
100
+ ```Bash
101
+ pip install "dragon-ml-toolbox[excel]"
102
+ ```
103
+
104
+ #### Modules:
105
+
106
+ ```bash
107
+ custom_logger
108
+ handle_excel
109
+ path_manager
110
+ ```
111
+
112
+ ### 🎰 GUI for Boosting Algorithms (XGBoost, LightGBM) [gui-boost]
113
+
114
+ For GUIs that include plotting functionality, you must also install the [plot] extra.
115
+
116
+ ```Bash
117
+ pip install "dragon-ml-toolbox[gui-boost]"
118
+ ```
119
+
120
+ ```Bash
121
+ pip install "dragon-ml-toolbox[gui-boost,plot]"
122
+ ```
123
+
124
+ #### Modules:
125
+
126
+ ```bash
127
+ GUI_tools
128
+ ensemble_inference
129
+ path_manager
130
+ ```
131
+
132
+ ### 🤖 GUI for PyTorch Models [gui-torch]
133
+
134
+ For GUIs that include plotting functionality, you must also install the [plot] extra.
135
+
136
+ ```Bash
137
+ pip install "dragon-ml-toolbox[gui-torch]"
138
+ ```
139
+
140
+ ```Bash
141
+ pip install "dragon-ml-toolbox[gui-torch,plot]"
142
+ ```
143
+
144
+ #### Modules:
145
+
146
+ ```bash
147
+ GUI_tools
148
+ ML_inference
149
+ path_manager
150
+ ```
151
+
152
+ ### 🎫 Base Tools [base]
153
+
154
+ General purpose functions and classes.
155
+
156
+ ```Bash
157
+ pip install "dragon-ml-toolbox[base]"
158
+ ```
159
+
160
+ #### Modules:
161
+
162
+ ```bash
163
+ ETL_Engineering
164
+ custom_logger
165
+ SQL
166
+ utilities
167
+ path_manager
168
+ ```
169
+
170
+ ## Usage
171
+
172
+ After installation, import modules like this:
173
+
174
+ ```python
175
+ from ml_tools.utilities import serialize_object, deserialize_object
176
+ from ml_tools.custom_logger import custom_logger
177
+ ```
@@ -0,0 +1,253 @@
1
+ Metadata-Version: 2.4
2
+ Name: dragon-ml-toolbox
3
+ Version: 4.1.0
4
+ Summary: A collection of tools for data science and machine learning projects.
5
+ Author-email: Karl Loza <luigiloza@gmail.com>
6
+ License-Expression: MIT
7
+ Project-URL: Homepage, https://github.com/DrAg0n-BoRn/ML_tools
8
+ Project-URL: Changelog, https://github.com/DrAg0n-BoRn/ML_tools/blob/master/CHANGELOG.md
9
+ Classifier: Programming Language :: Python :: 3
10
+ Classifier: Operating System :: OS Independent
11
+ Requires-Python: >=3.10
12
+ Description-Content-Type: text/markdown
13
+ License-File: LICENSE
14
+ License-File: LICENSE-THIRD-PARTY.md
15
+ Provides-Extra: base
16
+ Requires-Dist: pandas; extra == "base"
17
+ Requires-Dist: numpy; extra == "base"
18
+ Requires-Dist: polars; extra == "base"
19
+ Requires-Dist: joblib; extra == "base"
20
+ Provides-Extra: ml
21
+ Requires-Dist: numpy; extra == "ml"
22
+ Requires-Dist: pandas; extra == "ml"
23
+ Requires-Dist: polars; extra == "ml"
24
+ Requires-Dist: joblib; extra == "ml"
25
+ Requires-Dist: scikit-learn; extra == "ml"
26
+ Requires-Dist: matplotlib; extra == "ml"
27
+ Requires-Dist: seaborn; extra == "ml"
28
+ Requires-Dist: imbalanced-learn; extra == "ml"
29
+ Requires-Dist: ipython; extra == "ml"
30
+ Requires-Dist: ipykernel; extra == "ml"
31
+ Requires-Dist: notebook; extra == "ml"
32
+ Requires-Dist: jupyterlab; extra == "ml"
33
+ Requires-Dist: ipywidgets; extra == "ml"
34
+ Requires-Dist: xgboost; extra == "ml"
35
+ Requires-Dist: lightgbm; extra == "ml"
36
+ Requires-Dist: shap; extra == "ml"
37
+ Requires-Dist: tqdm; extra == "ml"
38
+ Requires-Dist: Pillow; extra == "ml"
39
+ Provides-Extra: mice
40
+ Requires-Dist: numpy<2.0; extra == "mice"
41
+ Requires-Dist: pandas; extra == "mice"
42
+ Requires-Dist: polars; extra == "mice"
43
+ Requires-Dist: joblib; extra == "mice"
44
+ Requires-Dist: miceforest>=6.0.0; extra == "mice"
45
+ Requires-Dist: plotnine>=0.12; extra == "mice"
46
+ Requires-Dist: matplotlib; extra == "mice"
47
+ Requires-Dist: statsmodels; extra == "mice"
48
+ Requires-Dist: lightgbm<=4.5.0; extra == "mice"
49
+ Requires-Dist: shap; extra == "mice"
50
+ Provides-Extra: pytorch
51
+ Requires-Dist: torch; extra == "pytorch"
52
+ Requires-Dist: torchvision; extra == "pytorch"
53
+ Provides-Extra: excel
54
+ Requires-Dist: pandas; extra == "excel"
55
+ Requires-Dist: openpyxl; extra == "excel"
56
+ Requires-Dist: ipython; extra == "excel"
57
+ Requires-Dist: ipykernel; extra == "excel"
58
+ Requires-Dist: notebook; extra == "excel"
59
+ Requires-Dist: jupyterlab; extra == "excel"
60
+ Requires-Dist: ipywidgets; extra == "excel"
61
+ Provides-Extra: gui-boost
62
+ Requires-Dist: numpy; extra == "gui-boost"
63
+ Requires-Dist: joblib; extra == "gui-boost"
64
+ Requires-Dist: FreeSimpleGUI>=5.2; extra == "gui-boost"
65
+ Requires-Dist: pyinstaller; extra == "gui-boost"
66
+ Requires-Dist: xgboost; extra == "gui-boost"
67
+ Requires-Dist: lightgbm; extra == "gui-boost"
68
+ Provides-Extra: gui-torch
69
+ Requires-Dist: numpy; extra == "gui-torch"
70
+ Requires-Dist: FreeSimpleGUI>=5.2; extra == "gui-torch"
71
+ Requires-Dist: pyinstaller; extra == "gui-torch"
72
+ Provides-Extra: plot
73
+ Requires-Dist: matplotlib; extra == "plot"
74
+ Requires-Dist: seaborn; extra == "plot"
75
+ Dynamic: license-file
76
+
77
+ # dragon-ml-toolbox
78
+
79
+ A collection of Python utilities for data science and machine learning, structured as a modular package for easy reuse and installation. This package has no base dependencies, allowing for lightweight and customized virtual environments.
80
+
81
+ ### Features:
82
+
83
+ - Modular scripts for data exploration, logging, machine learning, and more.
84
+ - Designed for seamless integration as a Git submodule or installable Python package.
85
+
86
+ ## Installation
87
+
88
+ **Python 3.10+**
89
+
90
+ ### Via PyPI
91
+
92
+ Install the latest stable release from PyPI:
93
+
94
+ ```bash
95
+ pip install dragon-ml-toolbox
96
+ ```
97
+
98
+ ### Via GitHub (Editable)
99
+
100
+ Clone the repository and install in editable mode with optional dependencies:
101
+
102
+ ```bash
103
+ git clone https://github.com/DrAg0n-BoRn/ML_tools.git
104
+ cd ML_tools
105
+ pip install -e .
106
+ ```
107
+
108
+ ### Via conda-forge
109
+
110
+ Install from the conda-forge channel:
111
+
112
+ ```bash
113
+ conda install -c conda-forge dragon-ml-toolbox
114
+ ```
115
+
116
+ ## Modular Installation
117
+
118
+ ### 📦 Core Machine Learning Toolbox [ML]
119
+
120
+ Installs a comprehensive set of tools for typical data science workflows, including data manipulation, modeling, and evaluation. PyTorch is required.
121
+
122
+ ```Bash
123
+ pip install "dragon-ml-toolbox[ML]"
124
+ ```
125
+
126
+ To install the standard CPU-only versions of Torch and Torchvision:
127
+
128
+ ```Bash
129
+ pip install "dragon-ml-toolbox[pytorch]"
130
+ ```
131
+
132
+ ⚠️ To make use of GPU acceleration (highly recommended), follow the official instructions: [PyTorch website](https://pytorch.org/get-started/locally/)
133
+
134
+ #### Modules:
135
+
136
+ ```bash
137
+ custom_logger
138
+ data_exploration
139
+ datasetmaster
140
+ ensemble_learning
141
+ ensemble_inference
142
+ ETL_engineering
143
+ ML_callbacks
144
+ ML_evaluation
145
+ ML_trainer
146
+ ML_inference
147
+ path_manager
148
+ PSO_optimization
149
+ SQL
150
+ RNN_forecast
151
+ utilities
152
+ ```
153
+
154
+ ### 🔬 MICE Imputation and Variance Inflation Factor [mice]
155
+
156
+ ⚠️ Important: This group has strict version requirements. It is highly recommended to install this group in a separate virtual environment.
157
+
158
+ ```Bash
159
+ pip install "dragon-ml-toolbox[mice]"
160
+ ```
161
+
162
+ #### Modules:
163
+
164
+ ```bash
165
+ custom_logger
166
+ MICE_imputation
167
+ VIF_factor
168
+ path_manager
169
+ utilities
170
+ ```
171
+
172
+ ### 📋 Excel File Handling [excel]
173
+
174
+ Installs dependencies required to process and handle .xlsx or .xls files.
175
+
176
+ ```Bash
177
+ pip install "dragon-ml-toolbox[excel]"
178
+ ```
179
+
180
+ #### Modules:
181
+
182
+ ```bash
183
+ custom_logger
184
+ handle_excel
185
+ path_manager
186
+ ```
187
+
188
+ ### 🎰 GUI for Boosting Algorithms (XGBoost, LightGBM) [gui-boost]
189
+
190
+ For GUIs that include plotting functionality, you must also install the [plot] extra.
191
+
192
+ ```Bash
193
+ pip install "dragon-ml-toolbox[gui-boost]"
194
+ ```
195
+
196
+ ```Bash
197
+ pip install "dragon-ml-toolbox[gui-boost,plot]"
198
+ ```
199
+
200
+ #### Modules:
201
+
202
+ ```bash
203
+ GUI_tools
204
+ ensemble_inference
205
+ path_manager
206
+ ```
207
+
208
+ ### 🤖 GUI for PyTorch Models [gui-torch]
209
+
210
+ For GUIs that include plotting functionality, you must also install the [plot] extra.
211
+
212
+ ```Bash
213
+ pip install "dragon-ml-toolbox[gui-torch]"
214
+ ```
215
+
216
+ ```Bash
217
+ pip install "dragon-ml-toolbox[gui-torch,plot]"
218
+ ```
219
+
220
+ #### Modules:
221
+
222
+ ```bash
223
+ GUI_tools
224
+ ML_inference
225
+ path_manager
226
+ ```
227
+
228
+ ### 🎫 Base Tools [base]
229
+
230
+ General purpose functions and classes.
231
+
232
+ ```Bash
233
+ pip install "dragon-ml-toolbox[base]"
234
+ ```
235
+
236
+ #### Modules:
237
+
238
+ ```bash
239
+ ETL_Engineering
240
+ custom_logger
241
+ SQL
242
+ utilities
243
+ path_manager
244
+ ```
245
+
246
+ ## Usage
247
+
248
+ After installation, import modules like this:
249
+
250
+ ```python
251
+ from ml_tools.utilities import serialize_object, deserialize_object
252
+ from ml_tools.custom_logger import custom_logger
253
+ ```
@@ -12,18 +12,22 @@ ml_tools/GUI_tools.py
12
12
  ml_tools/MICE_imputation.py
13
13
  ml_tools/ML_callbacks.py
14
14
  ml_tools/ML_evaluation.py
15
+ ml_tools/ML_inference.py
15
16
  ml_tools/ML_trainer.py
16
- ml_tools/ML_tutorial.py
17
17
  ml_tools/PSO_optimization.py
18
18
  ml_tools/RNN_forecast.py
19
+ ml_tools/SQL.py
19
20
  ml_tools/VIF_factor.py
20
21
  ml_tools/__init__.py
22
+ ml_tools/_logger.py
21
23
  ml_tools/_pytorch_models.py
24
+ ml_tools/_script_info.py
25
+ ml_tools/custom_logger.py
22
26
  ml_tools/data_exploration.py
23
27
  ml_tools/datasetmaster.py
28
+ ml_tools/ensemble_inference.py
24
29
  ml_tools/ensemble_learning.py
25
30
  ml_tools/handle_excel.py
26
31
  ml_tools/keys.py
27
- ml_tools/logger.py
28
32
  ml_tools/path_manager.py
29
33
  ml_tools/utilities.py