{"id":13401266,"url":"https://github.com/hms-dbmi/UpSetR","last_synced_at":"2025-03-14T07:31:28.676Z","repository":{"id":32725790,"uuid":"36315632","full_name":"hms-dbmi/UpSetR","owner":"hms-dbmi","description":"An R implementation of the UpSet set visualization technique published by Lex, Gehlenborg, et al..  ","archived":false,"fork":false,"pushed_at":"2024-08-04T02:45:52.000Z","size":31425,"stargazers_count":753,"open_issues_count":142,"forks_count":152,"subscribers_count":38,"default_branch":"master","last_synced_at":"2024-09-19T04:19:38.800Z","etag":null,"topics":["gehlenborglab","ggplot2","rstats","upset","upsetr","visualization"],"latest_commit_sha":null,"homepage":"https://cran.rstudio.com/web/packages/UpSetR","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/hms-dbmi.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS","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}},"created_at":"2015-05-26T18:29:34.000Z","updated_at":"2024-09-16T05:47:19.000Z","dependencies_parsed_at":"2022-08-21T06:20:45.693Z","dependency_job_id":"4ce7159b-bd3d-43f3-9cbe-84303c940ffa","html_url":"https://github.com/hms-dbmi/UpSetR","commit_stats":{"total_commits":346,"total_committers":16,"mean_commits":21.625,"dds":"0.18208092485549132","last_synced_commit":"b14854a1b066320afa913ec5560049143374a5bd"},"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hms-dbmi%2FUpSetR","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hms-dbmi%2FUpSetR/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hms-dbmi%2FUpSetR/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hms-dbmi%2FUpSetR/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hms-dbmi","download_url":"https://codeload.github.com/hms-dbmi/UpSetR/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243541837,"owners_count":20307768,"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":["gehlenborglab","ggplot2","rstats","upset","upsetr","visualization"],"created_at":"2024-07-30T19:01:00.643Z","updated_at":"2025-03-14T07:31:27.958Z","avatar_url":"https://github.com/hms-dbmi.png","language":"R","readme":"# UpSetR [![](http://www.r-pkg.org/badges/version/UpSetR)](https://cran.r-project.org/package=UpSetR) [![](http://cranlogs.r-pkg.org/badges/grand-total/UpSetR)](http://cranlogs.r-pkg.org/badges/grand-total/UpSetR)\n\n## Technique\n\nUpSetR generates static [UpSet](http://vcg.github.io/upset/) plots. The UpSet technique visualizes set intersections in a matrix layout and introduces aggregates based on groupings and queries. The matrix layout enables the effective representation of associated data, such as the number of elements in the aggregates and intersections, as well as additional summary statistics derived from subset or element attributes.\n\nFor further details about the original technique see the [UpSet website](http://vcg.github.io/upset/about/). You can also check out the [UpSetR shiny app](https://gehlenborglab.shinyapps.io/upsetr/). [Here is the source code](https://github.com/hms-dbmi/UpSetR-shiny) for the shiny wrapper. \n\nA [Python package](https://github.com/ImSoErgodic/py-upset) called [py-upset](https://github.com/ImSoErgodic/py-upset) to create UpSet plots has been created by GitHub user [ImSoErgodic](https://github.com/ImSoErgodic). \n\n## Citation\nIf you use UpSetR in a paper, please cite:\n\n\u003e Jake R Conway, Alexander Lex, Nils Gehlenborg\n\u003e UpSetR: An R Package for the Visualization of Intersecting Sets and their Properties\n\u003e doi: https://doi.org/10.1093/bioinformatics/btx364\n\nThe original technique and the interactive visualization tool implementing the approach are described here:\n\n\u003e Alexander Lex, Nils Gehlenborg, Hendrik Strobelt, Romain Vuillemot, Hanspeter Pfister,   \n\u003e UpSet: Visualization of Intersecting Sets,   \n\u003e IEEE Transactions on Visualization and Computer Graphics (InfoVis '14), vol. 20, no. 12, pp. 1983–1992, 2014.  \n\u003e doi: https://doi.org/10.1109/TVCG.2014.2346248\n\n\n## Sample Data\n\nSample data sets for UpSetR are included in the package and can be loaded like this:\n\n```R\nmovies \u003c- read.csv( system.file(\"extdata\", \"movies.csv\", package = \"UpSetR\"), header=T, sep=\";\" )\nmutations \u003c- read.csv( system.file(\"extdata\", \"mutations.csv\", package = \"UpSetR\"), header=T, sep = \",\")\n```\n\nThe movie data set created by the [GroupLens Lab](http://grouplens.org/datasets/movielens) and curated by [Bilal Alsallakh](https://github.com/bilalsal) and the mutations data set was originally created by the TCGA Consortium and represents mutations for the 100 most mutated genes in a glioblastoma multiforme cohort.\n\n## Examples\n\nIn addition to the examples shown here, we have included a range of UpSetR plots in the [paper about the R package](#citation), which can be found in a [separate GitHub repository](https://github.com/hms-dbmi/UpSetR-paper). \n\n### Vignettes\n\nThere are currently four vignettes that explain how to use the features included in the UpSetR package:\n* [Basic Usage](https://cran.r-project.org/package=UpSetR/vignettes/basic.usage.html)\n* [Queries](https://cran.r-project.org/package=UpSetR/vignettes/queries.html)\n* [Attribute Plots](https://cran.r-project.org/package=UpSetR/vignettes/attribute.plots.html)\n* [Set Metadata](https://cran.r-project.org/package=UpSetR/vignettes/set.metadata.plots.html)\n\n### Demo\n\nA view of the UpSet plot with additional plots based on elements in the intersections.\n\n![Image](https://cloud.githubusercontent.com/assets/12614369/8464958/2af1008c-2014-11e5-93d8-8d8442ec5631.png)\n\n```R\nupset(movies,attribute.plots=list(gridrows=60,plots=list(list(plot=scatter_plot, x=\"ReleaseDate\", y=\"AvgRating\"),\nlist(plot=scatter_plot, x=\"ReleaseDate\", y=\"Watches\"),list(plot=scatter_plot, x=\"Watches\", y=\"AvgRating\"),\nlist(plot=histogram, x=\"ReleaseDate\")), ncols = 2))\n```\nA view of UpSetR mimicking the plot published by Lex \u0026 Gehlenborg\nhttp://www.nature.com/nmeth/journal/v11/n8/abs/nmeth.3033.html\n\n![image](https://cloud.githubusercontent.com/assets/12614369/8468576/18d5ef52-203c-11e5-9f5d-e034ec41c538.png)\n\n```R\nupset(mutations, sets = c(\"PTEN\", \"TP53\", \"EGFR\", \"PIK3R1\", \"RB1\"), sets.bar.color = \"#56B4E9\",\norder.by = \"freq\", empty.intersections = \"on\")\n```\n\nAn example using two set queries (war movies and noir movies) along with attribute plots comparing the average rating (top) and average rating vs the number of times the movies have been watched (bottom).\n\n![image](https://cloud.githubusercontent.com/assets/1216518/8486663/2bc2bf44-20d4-11e5-9651-4b660a652b05.png)\n\n```R\nupset(movies, attribute.plots=list(gridrows = 100, ncols = 1, \nplots = list(list(plot=histogram, x=\"AvgRating\",queries=T),\nlist(plot = scatter_plot, y = \"AvgRating\", x = \"Watches\", queries = T))), \nsets = c(\"Action\", \"Adventure\", \"Children\", \"War\", \"Noir\"),\nqueries = list(list(query = intersects, params = list(\"War\"), active = T),\nlist(query = intersects, params = list(\"Noir\"))))\n```\n\n\n## Download\n\nInstall the latest released version from CRAN\n\n```R\ninstall.packages(\"UpSetR\")\n```\n\nDownload the latest development code of UpSetR from GitHub using [devtools](https://cran.r-project.org/package=devtools) with\n\n```R\ndevtools::install_github(\"hms-dbmi/UpSetR\")\n```\n","funding_links":[],"categories":["R","ggplot"],"sub_categories":["Additional Plot Types"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhms-dbmi%2FUpSetR","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhms-dbmi%2FUpSetR","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhms-dbmi%2FUpSetR/lists"}