{"id":17961234,"url":"https://github.com/erictleung/shinydiversity","last_synced_at":"2025-03-25T03:31:35.692Z","repository":{"id":72464213,"uuid":"100752744","full_name":"erictleung/shinydiversity","owner":"erictleung","description":"Interactive application to explore various ecological diversity metrics","archived":false,"fork":false,"pushed_at":"2018-05-02T17:48:31.000Z","size":294,"stargazers_count":5,"open_issues_count":18,"forks_count":8,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-19T08:39:51.670Z","etag":null,"topics":["amplicon-sequencing","diversity","ecology","interactive-visualizations","metagenomics","microbiome","r","shiny"],"latest_commit_sha":null,"homepage":"https://erictleung.shinyapps.io/shinydiversity","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/erictleung.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-08-18T21:51:09.000Z","updated_at":"2021-08-05T07:22:59.000Z","dependencies_parsed_at":"2023-06-03T04:15:49.272Z","dependency_job_id":null,"html_url":"https://github.com/erictleung/shinydiversity","commit_stats":{"total_commits":71,"total_committers":9,"mean_commits":7.888888888888889,"dds":"0.46478873239436624","last_synced_commit":"ff1e8df0517e314dc43717aafe68d3e3eca630e0"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erictleung%2Fshinydiversity","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erictleung%2Fshinydiversity/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erictleung%2Fshinydiversity/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erictleung%2Fshinydiversity/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/erictleung","download_url":"https://codeload.github.com/erictleung/shinydiversity/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245394751,"owners_count":20608122,"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":["amplicon-sequencing","diversity","ecology","interactive-visualizations","metagenomics","microbiome","r","shiny"],"created_at":"2024-10-29T11:08:42.114Z","updated_at":"2025-03-25T03:31:35.655Z","avatar_url":"https://github.com/erictleung.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"# shinydiversity\n\n[![Build Status](https://travis-ci.org/erictleung/shinydiversity.svg?branch=master)](https://travis-ci.org/erictleung/shinydiversity)\n[![Join the chat at https://gitter.im/erictleung/shinydiversity](https://badges.gitter.im/erictleung/shinydiversity.svg)](https://gitter.im/erictleung/shinydiversity?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.1188304.svg)](https://doi.org/10.5281/zenodo.1188304)\n\nInteractive application to explore various ecological diversity metrics\n\n**Table of Contents**\n\n- [To Run](#to-run)\n- [Prerequisites for Local Development](#prerequisites-for-local-development)\n- [Problem](#problem)\n- [Proposed Project](#proposed-project)\n- [More Comprehensive Tools](#more-comprehensive-tools)\n- [Acknowledgements](#acknowledgements)\n\n\n## To Run\n\n```R\n# Install Shiny\ninstall.packages(\"shiny\")\n\n# Run application\nlibrary(shiny)\nrunGitHub(\"shinydiversity\", \"erictleung\")\n```\n\n\n## Prerequisites for Local Development\n\n**Development Environments**\n\n- R (https://www.r-project.org/)\n- RStudio (https://www.rstudio.com/)\n\n**R Packages**\n\n- `shiny` (http://shiny.rstudio.com/)\n- `phyloseq` (http://joey711.github.io/phyloseq/)\n- `ggplot2` (ggplot2.tidyverse.org)\n- `knitr` (https://yihui.name/knitr/)\n- `markdown` (https://cran.r-project.org/package=markdown)\n- `rmarkdown` (https://rmarkdown.rstudio.com/)\n- `plyr` (http://had.co.nz/plyr/)\n\n```R\n# Install prerequisite R packages\npkgs \u003c- c(\"shiny\", \"ggplot2\", \"knitr\", \"markdown\" , \"rmarkdown\", \"plyr\")\ninstall.packages(pkgs)\n\n# Try http:// if https:// URLs are not supported\nsource(\"https://bioconductor.org/biocLite.R\")\nbiocLite('phyloseq')\n```\n\n\n## Problem\n\nThere are many alpha and beta diversity metrics to analyze microbial ecological\nor microbiome data. Although there are other more comprehensive tools to\nanalyze microbial data, each of them assumes sufficient amount of knowledge on\nthe differences among the diversity indices and how underlying assumptions of\nthe indices may interpret your data in unexpected ways. Alpha diversity\ndescribes an estimate of the total number of species in a sample. Beta\ndiversity describes the differences between samples. Below are some example of\nthe number of metrics you can use.\n\n\u003cimg src=\"images/alpha_diversities.png\" alt=\"Drawing\" style=\"width: 100%;\"/\u003e\n\n###### Plot from \"Alpha diversity graphics\" page for phyloseq showing various alpha diversity metrics to choose from http://joey711.github.io/phyloseq/plot_richness-examples\n\nBelow are just a few beta diversity metrics to choose from\n\n```R\n\u003e library(phyloseq)\n\u003e unlist(distanceMethodList)\n    UniFrac1     UniFrac2        DPCoA          JSD     vegdist1     vegdist2\n   \"unifrac\"   \"wunifrac\"      \"dpcoa\"        \"jsd\"  \"manhattan\"  \"euclidean\"\n    vegdist3     vegdist4     vegdist5     vegdist6     vegdist7     vegdist8\n  \"canberra\"       \"bray\" \"kulczynski\"    \"jaccard\"      \"gower\"   \"altGower\"\n    vegdist9    vegdist10    vegdist11    vegdist12    vegdist13    vegdist14\n  \"morisita\"       \"horn\"  \"mountford\"       \"raup\"   \"binomial\"       \"chao\"\n   vegdist15   betadiver1   betadiver2   betadiver3   betadiver4   betadiver5\n       \"cao\"          \"w\"         \"-1\"          \"c\"         \"wb\"          \"r\"\n  betadiver6   betadiver7   betadiver8   betadiver9  betadiver10  betadiver11\n         \"I\"          \"e\"          \"t\"         \"me\"          \"j\"        \"sor\"\n betadiver12  betadiver13  betadiver14  betadiver15  betadiver16  betadiver17\n         \"m\"         \"-2\"         \"co\"         \"cc\"          \"g\"         \"-3\"\n betadiver18  betadiver19  betadiver20  betadiver21  betadiver22  betadiver23\n         \"l\"         \"19\"         \"hk\"        \"rlb\"        \"sim\"         \"gl\"\n betadiver24        dist1        dist2        dist3   designdist\n         \"z\"    \"maximum\"     \"binary\"  \"minkowski\"        \"ANY\"\n\u003e length(unlist(distanceMethodList))\n[1] 47\n```\n\nWith so many metrics to choose from, how do you know which is the \"best\" and\nhow will your data affect the calculation of these metrics?\n\n\n## Proposed Project\n\nCreate an interactive Shiny application to show changes in your chosen alpha or\nbeta diversity metrics to see how each changes based on simulated or real data.\nSome of these metrics are sensitive to single or double counts of species so\nthis will be good to see how different distributions of counts will change\nthese metrics and your interpretations of them. The project should be designed to give\nan intuitive understanding of how these metrics work.\n\n\n## More Comprehensive Tools\n\nFor more comprehensive microbiome data analysis that goes beyond the scope of\njust diversity indices and includes provenance of the analysis, we suggest\nlooking at these other tools:\n\n- [Shiny-phyloseq](http://joey711.github.io/shiny-phyloseq/)\n    - McMurdie and Holmes (2014). [Shiny-phyloseq: Web Application for\n      Interactive Microbiome Analysis with Provenance Tracking][shinyphyloseq].\n      Bioinformatics (Oxford, England) 31(2), 282–283.\n    - Comprehensive microbiome analysis and interactive web application using\n      phyloseq and Shiny with provenance tracking in order to reproduce\n      graphically performed analyses.\n- [Dynamic Assessment of Microbial Ecology\n  (DAME)](https://acnc-shinyapps.shinyapps.io/DAME/)\n    - Piccolo, Brian D., et al. [Dynamic Assessment of Microbial Ecology\n      (DAME): A web app for interactive analysis and visualization of microbial\n      sequencing data][dame]. Bioinformatics 1 (2017): 3.\n    - Comprehensive interactive web application to analyze microbial ecology\n      data specifically designed to work directly with output files from the\n      QIIME1 software suite with as minimal file processing as possible.\n- [MicrobiomeAnalyst](http://www.microbiomeanalyst.ca/)\n    - Dhariwal, Achal, et al. [MicrobiomeAnalyst: a web-based tool for\n      comprehensive statistical, visual and meta-analysis of microbiome\n      data][microbiomeanalyst]. Nucleic acids research (2017): gkx295.\n    - Comprehensive statistical, visual and meta-analysis of microbiome data of\n      various kinds: 16S rRNA, shotgun metagenomics, taxon set enrichment\n      analysis.\n\n[shinyphyloseq]: https://doi.org/10.1093/bioinformatics/btu616\n[dame]: https://doi.org/10.1093/bioinformatics/btx686\n[microbiomeanalyst]: https://doi.org/10.1093/nar/gkx295\n\n\n## Acknowledgements\n\nThis project was initiated as a selected project at genomics hackathon\n[hackseq](https://www.hackseq.com/) in 2017.\n\nKey developers in coding and brainstorming during the hackathon are:\n\n- [Eric Leung](https://github.com/erictleung)\n- [Roshan Noronha](https://github.com/roshannoronha)\n- [Ali Mirza](https://github.com/aimirza)\n- [Akiff Manji](https://github.com/amanji)\n- Reva Shenwai\n- [Stelios Batziakas](https://github.com/ampatzia)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferictleung%2Fshinydiversity","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ferictleung%2Fshinydiversity","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferictleung%2Fshinydiversity/lists"}