openVA
R package for openVA: a suite of tools for multiple VA methods
Science Score: 49.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 12 DOI reference(s) in README -
○Academic publication links
-
✓Committers with academic emails
2 of 8 committers (25.0%) from academic institutions -
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (15.6%) to scientific vocabulary
Keywords
Keywords from Contributors
Repository
R package for openVA: a suite of tools for multiple VA methods
Basic Info
Statistics
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 13
- Releases: 0
Topics
Metadata Files
README.md
openVA
The openVA package implements multiple existing open-source algorithms for coding cause of death from verbal autopsies. It also provides tools for data manipulation tasks commonly used in Verbal Autopsy analysis and implements easy graphical visualization of individual and population level statistics.
The VA methods implemented in the package include:
+ InterVA4 by Byass et al (2012), implemented using the R package InterVA4
+ InterVA5 by Byass at al (2019), implemented using the R package InterVA5
+ InSilicoVA by McCormick et al (2016), implemented using the R package InSilicoVA
+ NBC by Miasnikof et al (2015), implemented by the R package nbc4va on Github.
+ A replication of Tariff method implemented using the R package Tariff. The Tariff method is described in James et al (2011) and Serina, et al. (2015). Please note this package was not developed by authors affiliated with the Institute for Health Metrics and Evaluation (IHME) and thus unintentional discrepancies may exist in the implementation of the Tariff method. It also does not fully replicate the full implementations of the SmartVA-Analyze application distributed by IHME.
For more information, check out the package and team website for more details and documentations: openVA.net.
Examples
To get started using the openVA package, try the following example running InSilicoVA on a small synthetic WHO2016 dataset
library(openVA)
data(RandomVA5)
fit <- codeVA(RandomVA5, data.type = "WHO2016", model = "InSilicoVA",
Nsim = 1000, auto.length = FALSE)
summary(fit)
plotVA(fit)
For more examples, see the package vignette.
Installation instructions
This guide presents an overview for installing openVA package, with some common error reports and solutions at the end.
1. Overview of openVA package structure
Whenever the openVA package is loaded to R, it also requires four other core packages on CRAN for each of the VA coding methods, namely, InSilicoVA, InterVA4, Tariff, and nbc4va, and ggplot2 for visualization. Additionally, the InSilicoVA package further requires the dependency of coda and rJava for its computation.
Users typically need to take no specific action regarding the dependencies, since R takes care of them automatically. However, sometimes issues with installing openVA package can arise because of some of the dependencies, which may require additional configurations and re-installing the package. I find that most of the times, the errors stem from loading rJava, and thus is the main focus of this guide.
2. Pre-requisites
As the name suggests, to properly load the package rJava, you will need two key ingredients: R, and Java. Here is how you can make sure you have the right combination of the two:
Check R environment
- If you do not already have it, install from CRAN. Follow the instructions at the link to choose a mirror that will take you to the download page. After download, double click the file to install.
- Open R. On the welcome message, there is a line starting with “Platform” and ending with “(32-bit)” or “(64-bit)”. It is very important to know which version (32-bit or 64-bit) of R you use, since the Java JDK should have the same version.
- Sometimes multiple versions of R could be installed on the same machine, so you should check the version you wish to use for data analysis. For example, if you prefer using RStudio to run the codes, you should check the default R version of RStudio by reading the welcome message for RStudio, instead of, say, the R version when opening from command line.
Check Java installation
- To check if Java in installed on your Mac or Linux machine, open terminal if you use Mac or Linux and type in
java -version. If Java is installed, it will show the Java version number. Version number at least 1.7.x should be sufficient. - To check if Java is installed on your Windows machine, open Control Panel, select Programs, then select Programs and Features, and see if Java is listed.
- If no Java is installed (on Mac OSX, you will see a pop-up notice of installing Java JDK), or version too low, you should download and install a newer Java. The required download is JDK (Java Development Kit). Click on download link for JDK and choose the appropriate version. You should choose “x86” version if your R version is 32-bit, and “x64” if R is 64-bit. Then follow the instructions to finish download and install Java.
- After successfully installing Java, try again typing
java -versionon terminal or Command Prompt. It should show the correct version number just installed.
Owner
- Name: verbal-autopsy-software
- Login: verbal-autopsy-software
- Kind: organization
- Website: http://openva.net/
- Repositories: 21
- Profile: https://github.com/verbal-autopsy-software
Supported by the Bloomberg Philanthropies Data for Health Initiative, Vital Strategies and the National Institutes of Health
GitHub Events
Total
- Watch event: 2
- Push event: 3
- Public event: 1
Last Year
- Watch event: 2
- Push event: 3
- Public event: 1
Committers
Last synced: over 2 years ago
Top Committers
| Name | Commits | |
|---|---|---|
| Richard Li | l****g@g****m | 128 |
| Richard Li | l****g@u****u | 11 |
| Matt Boyas | m****s@m****g | 11 |
| jarathomas | t****2@o****u | 6 |
| mboyas-mitre | 4****e | 5 |
| jarathomas | j****s@g****m | 3 |
| Eleanor Bayles | e****s@m****g | 1 |
| Jacob Fiksel | j****l@g****m | 1 |
Issues and Pull Requests
Last synced: 7 months ago
All Time
- Total issues: 30
- Total pull requests: 4
- Average time to close issues: 3 months
- Average time to close pull requests: 11 days
- Total issue authors: 7
- Total pull request authors: 2
- Average comments per issue: 1.1
- Average comments per pull request: 0.5
- Merged pull requests: 4
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 0
- Pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- mboyas-mitre (18)
- richardli (5)
- rrwen (3)
- jarathomas (1)
- y-chu (1)
- sawontheboss4 (1)
- pkmitre (1)
Pull Request Authors
- mboyas-mitre (3)
- jfiksel (1)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- cran 410 last-month
- Total dependent packages: 2
- Total dependent repositories: 2
- Total versions: 19
- Total maintainers: 1
cran.r-project.org: openVA
Automated Method for Verbal Autopsy
- Homepage: https://github.com/verbal-autopsy-software/openVA
- Documentation: http://cran.r-project.org/web/packages/openVA/openVA.pdf
- License: GPL-2
-
Latest release: 1.1.2
published about 2 years ago
Rankings
Maintainers (1)
Dependencies
- R >= 3.1 depends
- InSilicoVA >= 1.1.3 imports
- InterVA4 >= 1.7.3 imports
- InterVA5 >= 1.0.1 imports
- Tariff >= 1.0.1 imports
- cli * imports
- crayon * imports
- ggplot2 * imports
- methods * imports
- nbc4va * suggests
- testthat * suggests
- actions/cache v2 composite
- actions/checkout v1 composite
- actions/setup-java v1 composite
- actions/upload-artifact main composite
- r-lib/actions/setup-pandoc v1 composite
- r-lib/actions/setup-r v1 composite
- actions/checkout v2 composite
- r-lib/actions/setup-r v2 composite
- r-lib/actions/setup-r-dependencies v2 composite