{"id":32201062,"url":"https://github.com/mmedl94/lionfish","last_synced_at":"2025-10-22T03:59:35.814Z","repository":{"id":267293487,"uuid":"811366306","full_name":"mmedl94/lionfish","owner":"mmedl94","description":"Interactive python integration of the tourr R-package","archived":false,"fork":false,"pushed_at":"2025-09-01T09:40:07.000Z","size":18115,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-10-22T03:59:07.082Z","etag":null,"topics":["data-sience","data-visualization","dimensionality-reduction","exploratory-data-analysis","interactive","interactive-visualizations","tourr"],"latest_commit_sha":null,"homepage":"https://mmedl94.github.io/lionfish/","language":"Python","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/mmedl94.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-06-06T13:07:36.000Z","updated_at":"2025-09-01T09:33:05.000Z","dependencies_parsed_at":"2024-12-09T14:46:56.015Z","dependency_job_id":"0e491995-1dea-4687-b490-e8cdfa3e657f","html_url":"https://github.com/mmedl94/lionfish","commit_stats":null,"previous_names":["mmedl94/lionfish"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/mmedl94/lionfish","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmedl94%2Flionfish","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmedl94%2Flionfish/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmedl94%2Flionfish/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmedl94%2Flionfish/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mmedl94","download_url":"https://codeload.github.com/mmedl94/lionfish/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmedl94%2Flionfish/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280376547,"owners_count":26320275,"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","status":"online","status_checked_at":"2025-10-22T02:00:06.515Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["data-sience","data-visualization","dimensionality-reduction","exploratory-data-analysis","interactive","interactive-visualizations","tourr"],"created_at":"2025-10-22T03:59:32.380Z","updated_at":"2025-10-22T03:59:35.803Z","avatar_url":"https://github.com/mmedl94.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# lionfish: an expLoratory Interactive tOol for dyNamic visualization and identiFicatIon multidimenSional mecHanisms\n\nThis package is an extension of the [tourr](https://github.com/ggobi/tourr) R-package. For a general overview of the tourr package please refer to the [tourr documentation](https://ggobi.github.io/tourr/). lionfish adds interactive displays to the functionality of tourr allowing users to direct the path of the tours.\n\n## lionfish documentation\n\nFor an overview of the functionality of lionfish please visit the [documentation](https://mmedl94.github.io/lionfish/)!\n\n## Installation\n\nComplications may arise when installing and accessing the Python backend of this package. If you run into any, please don't refrain from opening an issue!\n\n## Known issues\n\nFor an unknown reason, the GUI sometimes appears empty at the initial launch.\nRestarting R and launching the GUI again seems to resolve this.\n\n## Example\n\nIn this introductory example we will launch the lionfish GUI with the 'flea'\ndatset and a selection of interactive display types. For more information about\nthe 'flea' dataset visit the\n[tourr documentation](https://ggobi.github.io/tourr/reference/Flea-measurements.html).\nIn brief, the dataset contains six numeric variables with measurements of the fleas'\nappendages and a factor variable with the flea species (Concinna, Heptapot. or \nHeikert.).\nFor more information on how to use the GUI visit the\n[lionfish documentation](https://mmedl94.github.io/lionfish/).\n\nFirst, we have to load the package and initialize the 'python' backend with:\n\n``` r\nlibrary(lionfish)\ninit_env()\n```\n\nWe first fetch the flea dataset from 'tourr', save the species column separately,\nand get the unique species names as well as the feature names of our dataset.\nThen we run and store a 'guided_tour' with the 'holes' index and a 'grand_tour'.\nMore information on tours can be found [here](https://ggobi.github.io/tourr/).\n\n``` r\nlibrary(tourr)\ndata(\"flea\")\ndata \u003c- flea[1:6]\nclusters \u003c- as.numeric(flea$species)\nflea_subspecies \u003c- unique(flea$species)\nfeature_names \u003c- colnames(data)\n\nguided_tour_history \u003c- save_history(data,\n                                    tour_path = guided_tour(holes()))\ngrand_tour_history_1d \u003c- save_history(data,\n                                      tour_path = grand_tour(d=1))\n```\n\nNow we have to specify which display types we want to load into the GUI. In this\nexample, we want to display a two-dimensional tour, a one-dimensional tour, a\nscatterplot, and a histogram. For each display type, we have to further specify\nsome settings as part of the so called plot objects. For the tours, these are\nthe stored tour histories, and for the scatterplot and histogram, we have to\ndefine which features we want to plot. A detailed description of the plot\nobjects can be found [here](https://mmedl94.github.io/lionfish/articles/Plot-objects.html).\n\n``` r\nobj1 \u003c- list(type=\"2d_tour\", obj=guided_tour_history)\nobj2 \u003c- list(type=\"1d_tour\", obj=grand_tour_history_1d)\nobj3 \u003c- list(type=\"scatter\", obj=c(\"tars1\", \"tars2\"))\nobj4 \u003c- list(type=\"hist\", obj=\"head\")\n```\n\nFinally, we launch the GUI with the 'interactive_tour' function. Details on the\ninteractive functions of the displays can be found\n[here](https://mmedl94.github.io/lionfish/articles/General-interactivity.html).\n\n``` r\ninteractive_tour(data=data,\n                 plot_objects=list(obj1, obj2, obj3, obj4),\n                 feature_names=feature_names,\n                 n_plot_cols=2,\n                 preselection=clusters,\n                 preselection_names=flea_subspecies,\n                 n_subsets=5,\n                 display_size=5)\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmmedl94%2Flionfish","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmmedl94%2Flionfish","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmmedl94%2Flionfish/lists"}