path: root/python-happy-learning.spec

%global _empty_manifest_terminate_build 0
Name:		python-happy-learning
Version:	0.5.0
Release:	1
Summary:	Toolbox for reinforced developing of machine learning models (as proof-of-concept)
License:	GNU
URL:		https://github.com/GianniBalistreri/happy_learning
Source0:	https://mirrors.aliyun.com/pypi/web/packages/9a/40/70cb3eba749057af04b42d868831ed4cec2c5216c018d2c4b66d5c236ed3/happy_learning-0.5.0.tar.gz
BuildArch:	noarch

Requires:	python3-catboost
Requires:	python3-Chaid
Requires:	python3-combo
Requires:	python3-dask-ml
Requires:	python3-easyexplore
Requires:	python3-emoji
Requires:	python3-fast-gsdmm
Requires:	python3-gensim
Requires:	python3-geocoder
Requires:	python3-googletrans
Requires:	python3-nltk
Requires:	python3-mlflow
Requires:	python3-protobuf
Requires:	python3-pygam
Requires:	python3-requests
Requires:	python3-sentence-transformers
Requires:	python3-spacy
Requires:	python3-sqlalchemy
Requires:	python3-statsmodels
Requires:	python3-torch
Requires:	python3-torchtext
Requires:	python3-xgboost

%description
# Happy ;) Learning

## Description:
Toolbox for reinforced developing of machine learning models (as proof-of-concept) in python. 
It is specially designed to evolve and optimize machine learning models using evolutionary algorithms both on the feature engineering side and on the hyper parameter tuning side.

## Table of Content:
1. Installation
2. Requirements
3. Introduction
    - Practical Usage
    - FeatureEngineer
    - FeatureTournament
    - FeatureSelector
    - FeatureLearning
    - ModelGenerator
    - NetworkGenerator
    - ClusteringGenerator
    - GeneticAlgorithm
    - SwarmIntelligence
    - DataMiner


## 1. Installation:
You can easily install Happy Learning via pip install happy_learning on every operating system.

## 2. Requirements:
 - ...

## 3. Introduction:
 - Practical Usage:

It covers all aspects of the developing process, such as feature engineering, feature and model selection as well as hyper parameter optimization.

- Feature Engineer:

Process your tabular data smartly. The Feature Engineer module is equipped with all necessary (tabular) feature processing methods. Moreover, it is able to capture the metadata about the data set such as scaling measurement types of the features, taken processing steps, etc.
To scale big data sets it generates temporary data files for each feature separately and loads them for processing purposes only.

 - Feature Learning:
 
It combines both the feature engineering module and the genetic algorithm module to create a reinforcement learning environment to smartly generate new features.
The module creates separate learning environments for categorical and continuous features. The categorical features are one-hot encoded and then unified (one-hot merging).
Whereas the (semi-) continuous features are systematically processed by using several transformation and interaction methods.

 - Feature Tournament:
 
Feature tournament is a process to evaluate the importance of each feature regarding to a specific target feature. It uses the concept of (Additive) Shapley Values to calculate the importance score.

    -- Data Typing:

        Check whether represented data types of Pandas is equal to the real data types occuring in the data

- Feature Selector:

The Feature Selector module applies the feature tournament to calculate feature importance scores and select automatically the best n features based on the scoring.

- ModelGenerator:

The ModelGenerator module generates supervised machine learning models and all necessary hyper parameters for structured (tabular) data.

      -- Model / Hyper parameter:

         Classification models ...
            -> Ada Boosting (ada)
            -> Cat Boost (cat)
            -> Gradient Boosting Decision Tree (gbo)
            -> K-Nearest Neighbor (knn)
            -> Linear Discriminant Analysis (lida)
            -> Logisitic Regression (log)
            -> Quadratic Discriminant Analysis (qda)
            -> Random Forest (rf)
            -> Support-Vector Machine (svm)
            -> Nu-Support-Vector Machine (nusvm)
            -> Extreme Gradient Boosting Decision Tree (xgb)

         Regression models ...
            -> Ada Boosting (ada)
            -> Cat Boost (cat)
            -> Elastic Net (elastic)
            -> Generalized Additive Models (gam)
            -> Gradient Boosting Decision Tree (gbo)
            -> K-Nearest Neighbor (knn)
            -> Random Forest (rf)
            -> Support-Vector Machine (svm)
            -> Nu-Support-Vector Machine (nusvm)
            -> Extreme Gradient Boosting Decision Tree (xgb)

- NetworkGenerator:

The NetworkGenerator module generates neural network architectures and all necessary hyper parameters for text data using PyTorch.

      -- Model / Hyper parameter:

         -> Attention Network (att)
         -> Gated Recurrent Unit (gru)
         -> Long-Short Term Memory (lstm)
         -> Multi-Layer Perceptron (mlp)
         -> Recurrent Neural Network (rnn)
         -> Recurrent Convolutional Neural Network (rcnn)
         -> Self-Attention (self)
         -> Transformer (trans)

- ClusteringGenerator:

The ClusteringGenerator module generates unsupervised machine learning models and all necessary hyper parameters for text clustering.

      -- Model / Hyper parameter:

         -> Gibbs-Sampling Dirichlet Multinomial Modeling (gsdmm)
         -> Latent Dirichlet Allocation (lda)
         -> Latent Semantic Indexing (lsi)
         -> Non-Negative Matrix Factorization (nmf)

- GeneticAlgorithm:

Reinforcement learning module either to evaluate the fittest model / hyper parameter configuration or to engineer (tabular) features. 
It captures several evaluation statistics regarding the evolution process as well as the model performance metrics.
More over, it is able to transfer knowledge across re-trainings.

    -- Model / Hyperparameter Optimization:

        Optimize model / hyper parameter selection ...
            -> Sklearn models
            -> Popular "stand alone" models like XGBoost, CatBoost, etc.
            -> Deep Learning models (using PyTorch only)
            -> Text clustering models (document & short-text)

    -- Feature Engineering / Selection:

        Optimize feature engineering / selection using processing methods from Feature Engineer module ...
            -> Choose only features of fittest models to apply feature engineering based on the action space of the Feature Engineer module

- SwarmIntelligence:

Reinforcement learning module either to evaluate the fittest model / hyper parameter configuration or to engineer (tabular) features. 
It captures several evaluation statistics regarding the evolution process as well as the model performance metrics.
More over, it is able to transfer knowledge across re-trainings.

    -- Model / Hyper parameter Optimization:

        Optimize model / hyper parameter selection ...
            -> Sklearn models
            -> Popular "stand alone" models like XGBoost, CatBoost, etc.
            -> Deep Learning models (using PyTorch only)
            -> Text clustering models (document & short-text)

    -- Feature Engineering / Selection:

        Optimize feature engineering / selection using processing methods from Feature Engineer module ...
            -> Choose only features of fittest models to apply feature engineering based on the action space of the Feature Engineer module

- DataMiner:

Combines all modules for handling structured (tabular) data sets. 
Therefore, it uses the ...
   -> Feature Engineer module to pre-process data in general (imputation, label encoding, date feature processing, etc.)
   -> Feature Learning module to smartly engineer tabular features
   -> Feature Selector module to select the most important features
   -> GeneticAlgorithm / SwarmIntelligence module to find a proper model and hyper parameter configuration by its self.

- TextMiner

Use text data (natural language) by generating various numerical features describing the text

    -- Segmentation:

        Categorize potential text features into following segments ...
            -> Web features
                1) URL
                2) EMail
            -> Enumerated features
            -> Natural language (original text features)
            -> Identifier (original id features)
            -> Unknown

    -- Simple text processing:
        Apply simple processing methods to text features
            -> Merge two text features by given separator
            -> Replace occurances
            -> Subset data set or feature list by given string

    -- Language methods:
        Apply methods to ...
            -> ... detect language in text
            -> ... translate using Google Translate under the hood

    -- Generate linguistic features:
        Apply semantic text processing to generate numeric features
            -> Clean text counter (text after removing stop words, punctuation and special character and lemmatizing)
            -> Part-of-Speech Tagging counter & labels
            -> Named Entity Recognition counter & labels
            -> Dependencies counter & labels (Tree based / Noun Chunks)
            -> Emoji counter & labels

    -- Generate similarity / clustering features:
        Apply similarity methods to generate continuous features using word embeddings
            -> TF-IDF

## 4. Documentation & Examples:

Check the methodology.pdf for the documentation and jupyter notebook for examples. Happy ;) Learning


%package -n python3-happy-learning
Summary:	Toolbox for reinforced developing of machine learning models (as proof-of-concept)
Provides:	python-happy-learning
BuildRequires:	python3-devel
BuildRequires:	python3-setuptools
BuildRequires:	python3-pip
%description -n python3-happy-learning
# Happy ;) Learning

## Description:
Toolbox for reinforced developing of machine learning models (as proof-of-concept) in python. 
It is specially designed to evolve and optimize machine learning models using evolutionary algorithms both on the feature engineering side and on the hyper parameter tuning side.

## Table of Content:
1. Installation
2. Requirements
3. Introduction
    - Practical Usage
    - FeatureEngineer
    - FeatureTournament
    - FeatureSelector
    - FeatureLearning
    - ModelGenerator
    - NetworkGenerator
    - ClusteringGenerator
    - GeneticAlgorithm
    - SwarmIntelligence
    - DataMiner


## 1. Installation:
You can easily install Happy Learning via pip install happy_learning on every operating system.

## 2. Requirements:
 - ...

## 3. Introduction:
 - Practical Usage:

It covers all aspects of the developing process, such as feature engineering, feature and model selection as well as hyper parameter optimization.

- Feature Engineer:

Process your tabular data smartly. The Feature Engineer module is equipped with all necessary (tabular) feature processing methods. Moreover, it is able to capture the metadata about the data set such as scaling measurement types of the features, taken processing steps, etc.
To scale big data sets it generates temporary data files for each feature separately and loads them for processing purposes only.

 - Feature Learning:
 
It combines both the feature engineering module and the genetic algorithm module to create a reinforcement learning environment to smartly generate new features.
The module creates separate learning environments for categorical and continuous features. The categorical features are one-hot encoded and then unified (one-hot merging).
Whereas the (semi-) continuous features are systematically processed by using several transformation and interaction methods.

 - Feature Tournament:
 
Feature tournament is a process to evaluate the importance of each feature regarding to a specific target feature. It uses the concept of (Additive) Shapley Values to calculate the importance score.

    -- Data Typing:

        Check whether represented data types of Pandas is equal to the real data types occuring in the data

- Feature Selector:

The Feature Selector module applies the feature tournament to calculate feature importance scores and select automatically the best n features based on the scoring.

- ModelGenerator:

The ModelGenerator module generates supervised machine learning models and all necessary hyper parameters for structured (tabular) data.

      -- Model / Hyper parameter:

         Classification models ...
            -> Ada Boosting (ada)
            -> Cat Boost (cat)
            -> Gradient Boosting Decision Tree (gbo)
            -> K-Nearest Neighbor (knn)
            -> Linear Discriminant Analysis (lida)
            -> Logisitic Regression (log)
            -> Quadratic Discriminant Analysis (qda)
            -> Random Forest (rf)
            -> Support-Vector Machine (svm)
            -> Nu-Support-Vector Machine (nusvm)
            -> Extreme Gradient Boosting Decision Tree (xgb)

         Regression models ...
            -> Ada Boosting (ada)
            -> Cat Boost (cat)
            -> Elastic Net (elastic)
            -> Generalized Additive Models (gam)
            -> Gradient Boosting Decision Tree (gbo)
            -> K-Nearest Neighbor (knn)
            -> Random Forest (rf)
            -> Support-Vector Machine (svm)
            -> Nu-Support-Vector Machine (nusvm)
            -> Extreme Gradient Boosting Decision Tree (xgb)

- NetworkGenerator:

The NetworkGenerator module generates neural network architectures and all necessary hyper parameters for text data using PyTorch.

      -- Model / Hyper parameter:

         -> Attention Network (att)
         -> Gated Recurrent Unit (gru)
         -> Long-Short Term Memory (lstm)
         -> Multi-Layer Perceptron (mlp)
         -> Recurrent Neural Network (rnn)
         -> Recurrent Convolutional Neural Network (rcnn)
         -> Self-Attention (self)
         -> Transformer (trans)

- ClusteringGenerator:

The ClusteringGenerator module generates unsupervised machine learning models and all necessary hyper parameters for text clustering.

      -- Model / Hyper parameter:

         -> Gibbs-Sampling Dirichlet Multinomial Modeling (gsdmm)
         -> Latent Dirichlet Allocation (lda)
         -> Latent Semantic Indexing (lsi)
         -> Non-Negative Matrix Factorization (nmf)

- GeneticAlgorithm:

Reinforcement learning module either to evaluate the fittest model / hyper parameter configuration or to engineer (tabular) features. 
It captures several evaluation statistics regarding the evolution process as well as the model performance metrics.
More over, it is able to transfer knowledge across re-trainings.

    -- Model / Hyperparameter Optimization:

        Optimize model / hyper parameter selection ...
            -> Sklearn models
            -> Popular "stand alone" models like XGBoost, CatBoost, etc.
            -> Deep Learning models (using PyTorch only)
            -> Text clustering models (document & short-text)

    -- Feature Engineering / Selection:

        Optimize feature engineering / selection using processing methods from Feature Engineer module ...
            -> Choose only features of fittest models to apply feature engineering based on the action space of the Feature Engineer module

- SwarmIntelligence:

Reinforcement learning module either to evaluate the fittest model / hyper parameter configuration or to engineer (tabular) features. 
It captures several evaluation statistics regarding the evolution process as well as the model performance metrics.
More over, it is able to transfer knowledge across re-trainings.

    -- Model / Hyper parameter Optimization:

        Optimize model / hyper parameter selection ...
            -> Sklearn models
            -> Popular "stand alone" models like XGBoost, CatBoost, etc.
            -> Deep Learning models (using PyTorch only)
            -> Text clustering models (document & short-text)

    -- Feature Engineering / Selection:

        Optimize feature engineering / selection using processing methods from Feature Engineer module ...
            -> Choose only features of fittest models to apply feature engineering based on the action space of the Feature Engineer module

- DataMiner:

Combines all modules for handling structured (tabular) data sets. 
Therefore, it uses the ...
   -> Feature Engineer module to pre-process data in general (imputation, label encoding, date feature processing, etc.)
   -> Feature Learning module to smartly engineer tabular features
   -> Feature Selector module to select the most important features
   -> GeneticAlgorithm / SwarmIntelligence module to find a proper model and hyper parameter configuration by its self.

- TextMiner

Use text data (natural language) by generating various numerical features describing the text

    -- Segmentation:

        Categorize potential text features into following segments ...
            -> Web features
                1) URL
                2) EMail
            -> Enumerated features
            -> Natural language (original text features)
            -> Identifier (original id features)
            -> Unknown

    -- Simple text processing:
        Apply simple processing methods to text features
            -> Merge two text features by given separator
            -> Replace occurances
            -> Subset data set or feature list by given string

    -- Language methods:
        Apply methods to ...
            -> ... detect language in text
            -> ... translate using Google Translate under the hood

    -- Generate linguistic features:
        Apply semantic text processing to generate numeric features
            -> Clean text counter (text after removing stop words, punctuation and special character and lemmatizing)
            -> Part-of-Speech Tagging counter & labels
            -> Named Entity Recognition counter & labels
            -> Dependencies counter & labels (Tree based / Noun Chunks)
            -> Emoji counter & labels

    -- Generate similarity / clustering features:
        Apply similarity methods to generate continuous features using word embeddings
            -> TF-IDF

## 4. Documentation & Examples:

Check the methodology.pdf for the documentation and jupyter notebook for examples. Happy ;) Learning


%package help
Summary:	Development documents and examples for happy-learning
Provides:	python3-happy-learning-doc
%description help
# Happy ;) Learning

## Description:
Toolbox for reinforced developing of machine learning models (as proof-of-concept) in python. 
It is specially designed to evolve and optimize machine learning models using evolutionary algorithms both on the feature engineering side and on the hyper parameter tuning side.

## Table of Content:
1. Installation
2. Requirements
3. Introduction
    - Practical Usage
    - FeatureEngineer
    - FeatureTournament
    - FeatureSelector
    - FeatureLearning
    - ModelGenerator
    - NetworkGenerator
    - ClusteringGenerator
    - GeneticAlgorithm
    - SwarmIntelligence
    - DataMiner


## 1. Installation:
You can easily install Happy Learning via pip install happy_learning on every operating system.

## 2. Requirements:
 - ...

## 3. Introduction:
 - Practical Usage:

It covers all aspects of the developing process, such as feature engineering, feature and model selection as well as hyper parameter optimization.

- Feature Engineer:

Process your tabular data smartly. The Feature Engineer module is equipped with all necessary (tabular) feature processing methods. Moreover, it is able to capture the metadata about the data set such as scaling measurement types of the features, taken processing steps, etc.
To scale big data sets it generates temporary data files for each feature separately and loads them for processing purposes only.

 - Feature Learning:
 
It combines both the feature engineering module and the genetic algorithm module to create a reinforcement learning environment to smartly generate new features.
The module creates separate learning environments for categorical and continuous features. The categorical features are one-hot encoded and then unified (one-hot merging).
Whereas the (semi-) continuous features are systematically processed by using several transformation and interaction methods.

 - Feature Tournament:
 
Feature tournament is a process to evaluate the importance of each feature regarding to a specific target feature. It uses the concept of (Additive) Shapley Values to calculate the importance score.

    -- Data Typing:

        Check whether represented data types of Pandas is equal to the real data types occuring in the data

- Feature Selector:

The Feature Selector module applies the feature tournament to calculate feature importance scores and select automatically the best n features based on the scoring.

- ModelGenerator:

The ModelGenerator module generates supervised machine learning models and all necessary hyper parameters for structured (tabular) data.

      -- Model / Hyper parameter:

         Classification models ...
            -> Ada Boosting (ada)
            -> Cat Boost (cat)
            -> Gradient Boosting Decision Tree (gbo)
            -> K-Nearest Neighbor (knn)
            -> Linear Discriminant Analysis (lida)
            -> Logisitic Regression (log)
            -> Quadratic Discriminant Analysis (qda)
            -> Random Forest (rf)
            -> Support-Vector Machine (svm)
            -> Nu-Support-Vector Machine (nusvm)
            -> Extreme Gradient Boosting Decision Tree (xgb)

         Regression models ...
            -> Ada Boosting (ada)
            -> Cat Boost (cat)
            -> Elastic Net (elastic)
            -> Generalized Additive Models (gam)
            -> Gradient Boosting Decision Tree (gbo)
            -> K-Nearest Neighbor (knn)
            -> Random Forest (rf)
            -> Support-Vector Machine (svm)
            -> Nu-Support-Vector Machine (nusvm)
            -> Extreme Gradient Boosting Decision Tree (xgb)

- NetworkGenerator:

The NetworkGenerator module generates neural network architectures and all necessary hyper parameters for text data using PyTorch.

      -- Model / Hyper parameter:

         -> Attention Network (att)
         -> Gated Recurrent Unit (gru)
         -> Long-Short Term Memory (lstm)
         -> Multi-Layer Perceptron (mlp)
         -> Recurrent Neural Network (rnn)
         -> Recurrent Convolutional Neural Network (rcnn)
         -> Self-Attention (self)
         -> Transformer (trans)

- ClusteringGenerator:

The ClusteringGenerator module generates unsupervised machine learning models and all necessary hyper parameters for text clustering.

      -- Model / Hyper parameter:

         -> Gibbs-Sampling Dirichlet Multinomial Modeling (gsdmm)
         -> Latent Dirichlet Allocation (lda)
         -> Latent Semantic Indexing (lsi)
         -> Non-Negative Matrix Factorization (nmf)

- GeneticAlgorithm:

Reinforcement learning module either to evaluate the fittest model / hyper parameter configuration or to engineer (tabular) features. 
It captures several evaluation statistics regarding the evolution process as well as the model performance metrics.
More over, it is able to transfer knowledge across re-trainings.

    -- Model / Hyperparameter Optimization:

        Optimize model / hyper parameter selection ...
            -> Sklearn models
            -> Popular "stand alone" models like XGBoost, CatBoost, etc.
            -> Deep Learning models (using PyTorch only)
            -> Text clustering models (document & short-text)

    -- Feature Engineering / Selection:

        Optimize feature engineering / selection using processing methods from Feature Engineer module ...
            -> Choose only features of fittest models to apply feature engineering based on the action space of the Feature Engineer module

- SwarmIntelligence:

Reinforcement learning module either to evaluate the fittest model / hyper parameter configuration or to engineer (tabular) features. 
It captures several evaluation statistics regarding the evolution process as well as the model performance metrics.
More over, it is able to transfer knowledge across re-trainings.

    -- Model / Hyper parameter Optimization:

        Optimize model / hyper parameter selection ...
            -> Sklearn models
            -> Popular "stand alone" models like XGBoost, CatBoost, etc.
            -> Deep Learning models (using PyTorch only)
            -> Text clustering models (document & short-text)

    -- Feature Engineering / Selection:

        Optimize feature engineering / selection using processing methods from Feature Engineer module ...
            -> Choose only features of fittest models to apply feature engineering based on the action space of the Feature Engineer module

- DataMiner:

Combines all modules for handling structured (tabular) data sets. 
Therefore, it uses the ...
   -> Feature Engineer module to pre-process data in general (imputation, label encoding, date feature processing, etc.)
   -> Feature Learning module to smartly engineer tabular features
   -> Feature Selector module to select the most important features
   -> GeneticAlgorithm / SwarmIntelligence module to find a proper model and hyper parameter configuration by its self.

- TextMiner

Use text data (natural language) by generating various numerical features describing the text

    -- Segmentation:

        Categorize potential text features into following segments ...
            -> Web features
                1) URL
                2) EMail
            -> Enumerated features
            -> Natural language (original text features)
            -> Identifier (original id features)
            -> Unknown

    -- Simple text processing:
        Apply simple processing methods to text features
            -> Merge two text features by given separator
            -> Replace occurances
            -> Subset data set or feature list by given string

    -- Language methods:
        Apply methods to ...
            -> ... detect language in text
            -> ... translate using Google Translate under the hood

    -- Generate linguistic features:
        Apply semantic text processing to generate numeric features
            -> Clean text counter (text after removing stop words, punctuation and special character and lemmatizing)
            -> Part-of-Speech Tagging counter & labels
            -> Named Entity Recognition counter & labels
            -> Dependencies counter & labels (Tree based / Noun Chunks)
            -> Emoji counter & labels

    -- Generate similarity / clustering features:
        Apply similarity methods to generate continuous features using word embeddings
            -> TF-IDF

## 4. Documentation & Examples:

Check the methodology.pdf for the documentation and jupyter notebook for examples. Happy ;) Learning


%prep
%autosetup -n happy_learning-0.5.0

%build
%py3_build

%install
%py3_install
install -d -m755 %{buildroot}/%{_pkgdocdir}
if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
pushd %{buildroot}
if [ -d usr/lib ]; then
	find usr/lib -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/lib64 ]; then
	find usr/lib64 -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/bin ]; then
	find usr/bin -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/sbin ]; then
	find usr/sbin -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
touch doclist.lst
if [ -d usr/share/man ]; then
	find usr/share/man -type f -printf "\"/%h/%f.gz\"\n" >> doclist.lst
fi
popd
mv %{buildroot}/filelist.lst .
mv %{buildroot}/doclist.lst .

%files -n python3-happy-learning -f filelist.lst
%dir %{python3_sitelib}/*

%files help -f doclist.lst
%{_docdir}/*

%changelog
* Thu Jun 08 2023 Python_Bot <Python_Bot@openeuler.org> - 0.5.0-1
- Package Spec generated