Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vosonlab/vosondash
R Shiny application for interactive analysis of networks created by vosonSML.
https://github.com/vosonlab/vosondash
r r-package r-shiny rstats rstudio shiny social-network-analysis voson
Last synced: about 4 hours ago
JSON representation
R Shiny application for interactive analysis of networks created by vosonSML.
- Host: GitHub
- URL: https://github.com/vosonlab/vosondash
- Owner: vosonlab
- License: gpl-3.0
- Created: 2018-11-26T07:13:39.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-02-03T16:11:26.000Z (almost 2 years ago)
- Last Synced: 2024-10-01T18:16:13.674Z (about 1 month ago)
- Topics: r, r-package, r-shiny, rstats, rstudio, shiny, social-network-analysis, voson
- Language: R
- Homepage: https://vosonlab.github.io/VOSONDash/
- Size: 3.7 MB
- Stars: 55
- Watchers: 6
- Forks: 13
- Open Issues: 2
-
Metadata Files:
- Readme: README.Rmd
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
---
output: github_document
---
```{r setup, include=FALSE}
knitr::opts_chunk$set(echo = TRUE, collapse = TRUE)
pkg <- "VOSONDash"
```
# VOSONDash - Shiny Dashboard App
[](https://CRAN.R-project.org/package=`r pkg`)
[](https://CRAN.R-project.org/package=`r pkg`)
[](https://CRAN.R-project.org/package=`r pkg`)
[](https://github.com/vosonlab/`r pkg`/releases)
[`&logo=github)](https://github.com/vosonlab/`r pkg`)
[](https://github.com/vosonlab/`r pkg`/commits/master)
[](https://github.com/vosonlab/`r pkg`/actions)
`VOSONDash` is an interactive [R Shiny](https://shiny.rstudio.com/) web application for the visualisation and analysis
of social network data. The app has a dashboard layout with sections for visualising and manipulating network graphs,
performing text analysis, displaying network metrics and the collection of network data using the
[vosonSML](https://github.com/vosonlab/vosonSML) R package.
## Installation Options
Install the most recent CRAN release:
``` r
install.packages("`r pkg`")
```
```{r release, include=FALSE}
dl_url <- NULL
if (all(sapply(c("httr", "dplyr", "jsonlite", "tidyr"), require, character.only = TRUE))) {
rel_resp <- GET(paste0("https://api.github.com/repos/vosonlab/", pkg, "/releases"),
add_headers(Accept = "application/vnd.github.v3+json"))
if (rel_resp$status_code == 200) {
resp_content <- fromJSON(rawToChar(rel_resp$content))
if ("tag_name" %in% names(resp_content)) {
meta <- select(slice_head(resp_content), tag_name, tarball_url, assets)
assets <- meta |> select(assets) |> unnest(cols = c(assets)) |>
filter(grepl("tar\\.gz$", name))
dl_url <- assets |> pull(browser_download_url)
rel_inst <- paste0("Install the most recent release tag via GitHub:\n\n",
"``` r\n",
"install.packages(\n",
" \"", dl_url, "\",\n",
" repo = NULL, type = \"source\")\n",
"```\n")
}
}
}
```
`r if(!is.null(dl_url)) rel_inst`
Install the latest development version:
``` r
# library(remotes)
remotes::install_github("vosonlab/`r pkg`")
```
Once the VOSON Dashboard package is installed and loaded the Shiny web application can be run from the RStudio console
using the `runVOSONDash()` function.
```R
library(VOSONDash)
runVOSONDash()
```
### Running the app for the first time
When run the `VOSONDash` app will check that all of the R packages that are required to make it work are installed. It
is likely that some packages will be missing and the app will print a message indicating the missing packages and a
command that can be used to install them.
For example:
```r
runVOSONDash()
# =================================================
# VOSONDash v`r packageVersion(pkg)`
# ...
# Checking packages...
#
# Error: Required packages missing.
# - shinyjs
# - visNetwork
#
# Please install required packages before using VOSONDash:
# install.packages(c("shinyjs", "visNetwork"))
```
The missing packages can be installed using the above `install.packages` command.
After installing required packages and running again the `VOSONDash` Shiny app will open up in the default web browser.
## VOSON Dashboard
`VOSONDash` features an intuitive web interface with a section for 'Analysis' of graph data loaded from
[igraph](https://igraph.org/r/) objects and a section for the 'Collection' of social media data using
[vosonSML](https://github.com/vosonlab/vosonSML).
### Analysis
Network and text analysis of graph data.
* Network Graphs: Visualise and modify networks
* Network Metrics: Calculate node and network level metrics
* Text Analysis: Word frequency, word clouds and sentiment
* Assortativity: Calculate homogeneity and homophily indexes (if VOSON categorical node attributes present)
Figure 1. Environmental activist site hyperlink network loaded from a `graphml` file and plotted by the `visNetwork`
package.
### Collection and Network Creation
Graphical interfaces for collecting network data from social media API's.
* Collect: Twitter, youtube and reddit network data
* Create: different types of networks from the data such as activity, actor, twomode and semantic networks
Figure 2. Collection of recent `#auspol` tweets and generation of an actor network with the `vosonSML` package.
Figure 3. Create an actor network and add tweet text to the network.
### API Keys and Tokens
* API Keys: Enter, save, load API keys and create access tokens
Figure 4. Twitter API token creation and selection.
## Special thanks
This application would not be possible without key packages by other authors in the R community, particularly the [shiny](https://github.com/rstudio/shiny), [shinydashboard](https://github.com/rstudio/shinydashboard), [DT](https://github.com/rstudio/DT) and [shinyjs](https://github.com/daattali/shinyjs) packages. Graph visualisations created with [igraph](https://github.com/igraph/rigraph) and [visNetwork](https://github.com/datastorm-open/visNetwork), and text analysis with support from [tm](https://CRAN.R-project.org/package=tm), [SnowballC](https://CRAN.R-project.org/package=SnowballC), [wordcloud](https://CRAN.R-project.org/package=wordcloud) and [syuzhet](https://CRAN.R-project.org/package=syuzhet) packages.
## Code of Conduct
Please note that the VOSON Lab projects are released with a [Contributor Code of Conduct](https://contributor-covenant.org/version/2/0/CODE_OF_CONDUCT.html). By contributing to this project, you agree to abide by its terms.