Package: talos-automl
Talos (in development)Talos: Automated Machine Learning (AutoML) library focused on One-Class Learning algorithms (AutoEncoders, Isolation Forest and One-Class SVM)Explore the docs »View Demo·Report Bug·Request FeatureTable of ContentsAbout The ProjectBuilt WithGetting StartedPrerequisitesInstallationUsageRoadmapContributingLicenseContactAcknowledgementsAbout The ProjectThere are many great README templates available on GitHub, however, I didn't find one that really suit my needs so I created this enhanced one. I want to create a README template so amazing that it'll be the last one you ever need -- I think this is it.Here's why:Your time should be focused on creating something amazing. A project that solves a problem and helps othersYou shouldn't be doing the same tasks over and over like creating a README from scratchYou should element DRY principles to the rest of your life :smile:Of course, no one template will serve all projects since your needs may be different. So I'll be adding more in the near future. You may also suggest changes by forking this repo and creating a pull request or opening an issue. Thanks to all the people have have contributed to expanding this template!A list of commonly used resources that I find helpful are listed in the acknowledgements.Built WithThis section should list any major frameworks that you built your project using. Leave any add-ons/plugins for the acknowledgements section. Here are a few examples.PythonPonyGE2TensorFlowScikit-LearnGetting StartedThis section presents how the package can be reached and installed.Where to get itThe source code is currently hosted on GitHub at:https://github.com/luisferreira97/talosBinary installer for the latest released version are available at the Python Package Index (PyPI).
Note that the PyPI name of the package istalos-automland nottalos.pipinstalltalos-automlUsage1. Import the packageThe first step in using the package is, after it has been installed, to import it. The main class from which all the methods are available isTalos.fromtalos.talosimportTalos2. Instantiate a Talos objectThe second step is to instantiate the Talos class with the information about your dataset and context (e.g., normal and anomaly classes, wether to run single-objective or multi-objective, the performance_metric, and the algorithm).
You can change thealgorithmparameter to select which algorithms are used during the optimization. The options are:"autoencoders": Deep AutoEncoders (from TensorFlow)"iforest": Isolation Forest (from Scikit-Learn)"svm": One-Class SVM (from Scikit-Learn)"all": the optimization is done using the three algorithms abovetalos=Talos(anomaly_class=0,normal_class=1,multiobjective=True,performance_metric="training_time",algorithm="autoencoder")3. Load datasetThe third step is to load the dataset. Depending on the type of validation you needtrain data(only 'normal' instances),validation data(you can use (1) only 'normal' instances or (2) both 'normal' and 'anomaly' instances with the respective labels), andtest data(both types of instances and labels). You can use theload_example_data()function to load the popular ECG dataset.X_train,X_val,X_test,y_test=talos.load_example_data()4. TrainThe fourth step is to train the model. Thefit()function computes the optimization using the given parameters.run=talos.fit(X=X_train,X_val=X_val,pop=10,gen=10,experiment_name="test",epochs=1000)5. PredictThe fifth step is to predict the labels of the test data. You can use thepredict()function to predict the labels of the test data. You can change themodeparameter to select which individuals are used to predict."all": uses all individuals (models) from the last generation"best": uses the from the last generation which achieved the best predictive metric"simplest": uses the from the last generation which achieved the best efficiency metric"pareto": uses the pareto individuals from the last generation (only for multiobjective. These are the models that achieved simultaneouly the best predictive metric and efficiency metric.Additionally, you can use thethresholdparameter (only used for AutoEncoders) to set the threshold for the prediction. You can use the following values:"default": uses a different threshold value for each individual (model). For each model the threshold value is the associated default value (currently this works similar to the "mean" value)."mean": For each model the threshold value is the sum of the mean reconstruction error obtained on the validation data and one standard deviation."percentile": For each model the threshold value is the 95th percentile of the reconstruction error obtained on the validation data (you can also use thepercentileparameter to change the percentile)."max": For each model the threshold value is maximum reconstruction error obtained on the validation data.You can also pass an Integer of Float value. In this case, the threshold value is the same for all the models.predictions=talos.predict(X_test,mode="all",threshold="default")6. EvaluateYou can use the predictions to calculate manually the performance metrics of the model. However, theevaluate()function is a more convenient way to do it. You can also use themodeparameter (works similarly to thepredict()function) and use metrics from thesklearn.metricspackage (currently available are "roc_auc", "accuracy", "precision", "recall", and "f1").score=talos.evaluate(X_test,y_test,mode="all",metric="roc_auc",threshold="default")Usagefromtalos.talosimportTalostalos=Talos(anomaly_class=0,normal_class=1,multiobjective=True,performance_metric="training_time",algorithm="autoencoder")X_train,X_val,X_test,y_test=talos.load_example_data()run=talos.fit(X=X_train,X_val=X_val,pop=10,gen=10,experiment_name="test",epochs=1000)predictions=talos.predict(X_test,mode="all",threshold="default")score=talos.evaluate(X_test,y_test,mode="all",metric="roc_auc",threshold="default")For more examples, please refer to theDocumentation-->RoadmapSee theopen issuesfor a list of proposed features (and known issues).ContributingContributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make aregreatly appreciated.Fork the ProjectCreate your Feature Branch (git checkout -b feature/AmazingFeature)Commit your Changes (git commit -m 'Add some AmazingFeature')Push to the Branch (git push origin feature/AmazingFeature)Open a Pull RequestLicenseDistributed under the MIT License. SeeLICENSEfor more information.ContactLuís Ferreira -LinkedIn-email@example.comProject Link:https://github.com/luisferreira97/talosAcknowledgementsPonyGE2