{"id":17844320,"url":"https://github.com/kerschke/flacco","last_synced_at":"2025-05-10T23:26:43.878Z","repository":{"id":28055494,"uuid":"31551859","full_name":"kerschke/flacco","owner":"kerschke","description":"Feature-Based Landscape Analysis of Continuous and Constrained Optimization Problems","archived":false,"fork":false,"pushed_at":"2023-04-03T13:50:55.000Z","size":2031,"stargazers_count":61,"open_issues_count":3,"forks_count":8,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-03-31T21:51:18.269Z","etag":null,"topics":["exploratory-landscape-analysis","gui","optimization","r","r-package"],"latest_commit_sha":null,"homepage":"http://kerschke.github.io/flacco/","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kerschke.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2015-03-02T17:07:42.000Z","updated_at":"2024-11-11T10:23:56.000Z","dependencies_parsed_at":"2023-01-14T08:02:19.630Z","dependency_job_id":"9c22af95-72bd-4794-bcdb-f615d7fb1658","html_url":"https://github.com/kerschke/flacco","commit_stats":{"total_commits":268,"total_committers":11,"mean_commits":"24.363636363636363","dds":0.6268656716417911,"last_synced_commit":"e647309b16425c808cccb69e8b5af6f52ec27bc5"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kerschke%2Fflacco","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kerschke%2Fflacco/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kerschke%2Fflacco/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kerschke%2Fflacco/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kerschke","download_url":"https://codeload.github.com/kerschke/flacco/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253497036,"owners_count":21917680,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["exploratory-landscape-analysis","gui","optimization","r","r-package"],"created_at":"2024-10-27T21:28:42.581Z","updated_at":"2025-05-10T23:26:43.859Z","avatar_url":"https://github.com/kerschke.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"flacco: Feature-Based Landscape Analysis of Continuous and Constrained Optimization Problems\n============================================================================================\n\n[![CRAN Status Badge](http://www.r-pkg.org/badges/version/flacco)](https://cran.r-project.org/package=flacco)\n[![GitHub Status Badge](https://img.shields.io/badge/GitHub-1.8-green.svg)](https://github.com/kerschke/flacco)\n[![CRAN Downloads](http://cranlogs.r-pkg.org/badges/flacco)](https://cran.r-project.org/package=flacco)\n[![Research software impact](http://depsy.org/api/package/cran/flacco/badge.svg)](http://depsy.org/package/r/flacco)\n[![Tutorial](https://img.shields.io/badge/tutorial-flacco-ff69b5.svg)](http://kerschke.github.io/flacco-tutorial/site/)\n[![Web-GUI](https://img.shields.io/badge/GUI-flacco-bb6fbf.svg)](https://flacco.shinyapps.io/flacco/)\n\n[![Build Status](https://travis-ci.org/kerschke/flacco.svg?branch=master)](https://travis-ci.org/kerschke/flacco)\n[![Build status](https://ci.appveyor.com/api/projects/status/cd170v2xlpw8db47/branch/master?svg=true)](https://ci.appveyor.com/project/kerschke/flacco/branch/master)\n[![Coverage Status](https://coveralls.io/repos/github/kerschke/flacco/badge.svg?branch=master)](https://coveralls.io/r/kerschke/flacco?branch=master)\n[![codecov.io](http://codecov.io/github/kerschke/flacco/coverage.svg?branch=master)](http://codecov.io/github/kerschke/flacco?branch=master)\n\n* *If you like our package, please [star](https://github.com/blog/1204-notifications-stars) it on Github.*\n\nIntroduction\n------------\n\n**flacco** is a collection of features for *Explorative Landscape Analysis (ELA)* of single-objective, continuous *(Black-Box-)Optimization Problems*.\nIt allows the user to quantify characteristics of an (unknown) optimization problem's landscape.\n\nFeatures, which used to be spread over different packages and platforms (R, Matlab, python, etc.), are now combined within this single package. Amongst others, this package contains feature sets, such as *ELA*, *Information Content*, *Dispersion*, *(General) Cell Mapping* or *Barrier Trees*.\n\nFurthermore, the package provides a unified interface for all features -- using a so-called *feature object* and (if required) *control* arguments. In total, the current release (1.8) consists of 17 different feature sets, which sum up to approximately 300 features.\n\nIn addition to the features themselves, this package also provides visualizations, e.g., of the cell mappings, barrier trees or information content:\n\n- 3D-Barrier Tree:\n\n![Examplary Barrier Tree](https://raw.githubusercontent.com/kerschke/flacco/master/images/example_bt_3d.png)\n\n\n- Cell Mapping:\n\n![Examplary Cell Mapping](https://raw.githubusercontent.com/kerschke/flacco/master/images/example_cm.png)\n\n- Information Content Plot:\n\n![Examplary Info Content](https://raw.githubusercontent.com/kerschke/flacco/master/images/example_info.png)\n\n\nQuickstart\n----------\n\nIf you want to get started quickly, have a look at the [flacco tutorial](http://kerschke.github.io/flacco-tutorial/site/) or at the accompanying [publication on flacco](https://link.springer.com/chapter/10.1007/978-3-030-25147-5_7).\n\n```splus\nlibrary(flacco)\n\n## (1) Create some example-data\nX = createInitialSample(n.obs = 500, dim = 2)\nf = function(x) sum(sin(x) * x^2 + (x - 0.5)^3)\ny = apply(X, 1, f)\n\n## (2) Compute the feature object\nfeat.object = createFeatureObject(X = X, y = y)\n\n## (3) Have a look at feat.object\nprint(feat.object)\n\n## (4) Check, which feature sets are available\nlistAvailableFeatureSets()\n\n## (5) Calculate a specific feature set, e.g. the ELA meta model\nfeatureSet = calculateFeatureSet(feat.object, set = \"ela_meta\")\n```\n\nInstallation Instructions\n-------------------------\n\n* If you want to use the version from CRAN, you should download it from [here](https://cran.r-project.org/package=flacco) and ideally install it along with all its dependencies:\n    ```splus\n    install.packages(\"flacco\", dependencies = TRUE)\n    ```\n\n* However, if you want to use the development version, you can download it with the following command:\n\n    ```splus\n    devtools::install_github(\"kerschke/flacco\")\n    ```\n\n\nflacco-GUI\n----------\n\nWe have started to implement a graphical user interface (GUI) for our package. Its online-version is hosted [here](https://flacco.shinyapps.io/flacco/).\n\nAlternatively, you can start it from within R:\n\n```splus\nlibrary(flacco)\nrunFlaccoGUI()\n```\n\n## Citation\n\nTo cite **flacco** please use:\n\u003e Kerschke, P. \u0026 Trautmann, H. (2019). Comprehensive Feature-Based Landscape Analysis of Continuous\n\u003e and Constrained Optimization Problems Using the R-package flacco.\n\u003e In: Bauer N., Ickstadt K., Lübke K., Szepannek G., Trautmann H., Vichi M. (eds.) Applications in\n\u003e Statistical Computing -- From Music Data Analysis to Industrial Quality Improvement, pp. 93-123,\n\u003e Studies in Classification, Data Analysis, and Knowledge Organization, Springer.\n\u003e URL: https://link.springer.com/chapter/10.1007/978-3-030-25147-5_7\n\nIf you want to cite the corresponding GUI please use:\n\u003e Hanster, C. \u0026 Kerschke, P. (2018). flaccogui: Exploratory Landscape Analysis for Everyone.\n\u003e In: Proceedings of the 19th Annual Conference on Genetic and Evolutionary Computation (GECCO)\n\u003e Companion, pp. 1215-1222, Berlin, Germany, ACM.\n\u003e URL http://dl.acm.org/citation.cfm?doid=3067695.3082477\n\n\nBibTeX entries for LaTeX users:\n```\n@InCollection{KerschkeT2019flacco,\n  Author    = {Kerschke, Pascal and Trautmann, Heike},\n  Title     = {Comprehensive Feature-Based Landscape Analysis of Continuous and Constrained Optimization Problems Using the R-package flacco},\n  Year      = {2019},\n  Booktitle = {Applications in Statistical Computing -- From Music Data Analysis to Industrial Quality Improvement},\n  URL       = {https://link.springer.com/chapter/10.1007/978-3-030-25147-5_7},\n  DOI       = {10.1007/978-3-030-25147-5_7},\n  Series    = {Studies in Classification, Data Analysis, and Knowledge Organization},\n  Editor    = {Bauer, Nadja and Ickstadt, Katja and L{\\\"u}bke, Karsten and Szepannek, Gero and Trautmann, Heike and Vichi, Maurizio},\n  Pages     = {93~--~123},\n  Publisher = {Springer},\n}\n\n@InProceedings{HansterK2017flaccogui,\n  Author    = {Hanster, Christian and Kerschke, Pascal},\n  Title     = {flaccogui: Exploratory Landscape Analysis for Everyone},\n  Booktitle = {Proceedings of the 19th Annual Conference on Genetic and Evolutionary Computation (GECCO) Companion},\n  Location  = {Berlin, Germany},\n  Series    = {GECCO '17},\n  Year      = {2017},\n  Month     = {July},\n  Pages     = {1215~--~1222},\n  Publisher = {ACM},\n  URL       = {http://dl.acm.org/citation.cfm?doid=3067695.3082477},\n  DOI       = {10.1145/3067695.3082477}\n}\n```\n\n\nNews\n----\n\n* October 11, 2019: The [bookchapter on flacco](https://link.springer.com/chapter/10.1007/978-3-030-25147-5_7) has been published.\n* September 25, 2019: [Reiyan](https://github.com/Reiyan) provided a [python-interface](https://github.com/Reiyan/pflacco) for flacco.\n* July 14, 2019: Presented flacco as part of the tutorial on \"Exploratory Landscape Analysis\" at [GECCO 2019 in Prague, Czech Republic](https://gecco-2019.sigevo.org/index.html/HomePage)\n* September 8, 2018: Presented flacco as part of the tutorial on \"Exploratory Landscape Analysis\" at [PPSN 2018 in Coimbra, Portugal](http://ppsn2018.dei.uc.pt)\n* July 15, 2017: Presented flacco (including the GUI) twice at [GECCO 2017 @ Berlin](http://gecco-2017.sigevo.org/index.html/HomePage):\n    * [\"flaccogui: Exploratory Landscape Analysis for Everyone\"](http://dl.acm.org/citation.cfm?doid=3067695.3082477) at the [EvoSoft Workshop](http://dev.heuristiclab.com/trac.fcgi/wiki/EvoSoft) AND\n    * within the Advanced Tutorial on [\"Exploratory Landscape Analysis\"](http://dl.acm.org/citation.cfm?doid=3067695.3067696).\n* June 14, 2017: flacco 1.7 has been submitted to CRAN.\n* June 09, 2017: started using [pkgdown](https://github.com/hadley/pkgdown) and [depsy](https://github.com/Impactstory/depsy).\n* May 11, 2017: flacco 1.6 has been submitted to CRAN.\n* April 28, 2017: flacco 1.5 (including its GUI) has been submitted to CRAN.\n* February 27, 2017: flacco 1.4 has been submitted to CRAN.\n* July 29, 2016: Presented [\"The R-Package FLACCO for Exploratory Landscape Analysis with Applications to Multi-Objective Optimization Problems\"](http://ieeexplore.ieee.org/document/7748359/) at the [IEEE WCCI / CEC in Vancouver, Canada](http://www.wcci2016.org/).\n* April 15, 2016: flacco 1.3 has been submitted to CRAN.\n* January 22, 2016: flacco 1.2 has been submitted to CRAN.\n* November 26, 2015: flacco 1.1 has been submitted to CRAN.\n* October 28, 2015: It is done! flacco 1.0 is released on CRAN!\n* September 2015: Fixing the last minor issues before submitting version 1.0 to CRAN.\n\n\nContact\n-------\n\nIf you have any suggestions or ideas (e.g. for new features), or if you encounter any problems while running the code, please use the issue tracker or send me an e-mail (kerschke@uni-muenster.de).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkerschke%2Fflacco","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkerschke%2Fflacco","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkerschke%2Fflacco/lists"}