https://github.com/kbruncati/researchr

https://github.com/kbruncati/researchr

Last synced: about 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/kbruncati/researchr
• Owner: kbruncati
• License: other
• Created: 2022-03-28T23:25:43.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2022-05-02T20:42:23.000Z (over 2 years ago)
• Last Synced: 2024-08-13T07:11:44.026Z (5 months ago)
• Language: R
• Size: 839 KB
• Stars: 1
• Watchers: 1
• Forks: 3
• Open Issues: 3
• Metadata Files:
  • Readme: README.Rmd
  • License: LICENSE

Awesome Lists containing this project

• jimsghstars - kbruncati/researchr - (R)

README

        
---

output: github_document

---

```{r, include = FALSE}

knitr::opts_chunk$set(

  collapse = TRUE,

  comment = "#>",

  fig.path = "man/figures/README-",

  out.width = "100%"

)

library(researchr)

```

# researchr

[![Lifecycle: experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://lifecycle.r-lib.org/articles/stages.html#experimental)

[![CRAN status](https://www.r-pkg.org/badges/version/kbruncati)](https://CRAN.R-project.org/package=researchr)

The goal of researchr is to make finding information about funded research opportunities easier and more accessible. This package takes a year as an input and will return a dataframe of information on funded NIH research opportunities from that year. Details include PIs, location, department, and much more.  

## Installation

You can install researchr like so:

```

remotes::install_github('kbruncati/diviiproject')

```

## Getting the Data

With `nih_research`, the user can select a year between 1985 - 2021 and will receive a data frame with NIH funded research opportunities relevant to the selected year. From there, the user can make use of the other two functions, `median_total_cost` and `funding_frequency`, to take a closer look at the funding data for the selected year.

Here are the columns of the dataframe that `nih_research` returns to the user:

```{r}

colnames(nih_research(1999)) 

```

## ExPORTER Data Dictionary

If you need more information on a column in your NIH Research dataset, check out the [ExPORTER Data Dictionary](https://report.nih.gov/exporter-data-dictionary).

## Visualization Examples

With `median_total_cost`, the user gets an interactive plot posing number of support years against median total cost for a project. Median total cost refers to total project funding from all NIH Institute and Centers. You can use the function like so:

```

median_total_cost(data2)

```

Here is a sample screenshot of an interactive plot for 1999 data:

![1999 Sample Plot](sample plots/1999 median_total_cost.png) 

With `funding_frequency`, the user gets an interactive map plot of the United States that color codes based on frequency of NIH funding. The user can hover their mouse over each state for specific counts and adjust visual settings as needed. You can create one of these plots like so:

```

funding_frequency(data2)

```

Here is a sample screenshot of an interactive plot for 1999 data:

![1999 Sample Plot](sample plots/1999 funding frequency.png)

## Authors

Benjamin Bruncati and Hongtong Lin