Title:	Download Charitable Grants from the '360Giving' Platform
Version:	0.2.2
Description:	Access open data from https://www.threesixtygiving.org, a database of charitable grant giving in the UK operated by '360Giving'. The package provides functions to search and retrieve data on charitable grant giving, and process that data into tidy formats. It relies on the '360Giving' data standard, described at https://standard.threesixtygiving.org/.
URL:	https://docs.evanodell.com/threesixtygiving, https://github.com/evanodell/threesixtygiving,
BugReports:	https://github.com/evanodell/threesixtygiving/issues
License:	GPL-3
Encoding:	UTF-8
LazyData:	true
Imports:	dplyr, httr, readxl, readr, jsonlite, purrr, janitor, tidyr, tidyselect, anytime, tibble, curl
RoxygenNote:	7.1.1
Suggests:	covr, testthat (≥ 2.1.0), knitr, rmarkdown, ggplot2, scales, stringi, ggrepel, fixerapi
VignetteBuilder:	knitr
NeedsCompilation:	no
Packaged:	2020-11-29 10:45:27 UTC; evanodell
Author:	Evan Odell [aut, cre]
Maintainer:	Evan Odell <evanodell91@gmail.com>
Repository:	CRAN
Date/Publication:	2020-12-02 09:30:02 UTC

threesixtygiving package

Description

360Giving is a data standard for publishing information about charitable grant giving in the UK. threesixtygiving provides functions to retrieve and process charitable grant funding data from 360Giving.

Details

See the 360 Giving website for more information on the source of this data, and the 360Giving Standard page for details of the data standard this package relies on.

All grants

Description

Returns a list of data frames with details of all grants from funders returned by tsg_available().

Usage

tsg_all_grants(verbose = TRUE, timeout = 30, retries = 0, correct_names = TRUE)

Arguments

Details

Due to the structure of the 360 Giving data, the package will make multiple attempts to request data. This can cause issues with servers automatically blocking requests. You can use tsg_missing() to identify missing sets of grant data.

Value

A list of tibbles with grant data.

Examples

## Not run: 
all_grants <- tsg_all_grants()

## End(Not run)

Available datasets

Description

Returns a tibble with information on all datasets available through 360Giving. Some funders have multiple datasets

Usage

tsg_available()

Value

A tibble with details on all available datasets.

Examples

## Not run: 
available <- tsg_available()

## End(Not run)

Core Data

Description

Given a list returned by tsg_all_grants() or tsg_search_grants(), creates a tibble with the core variables required by the 360Giving open standard, as well as the publisher prefix and dataset identifier, which are useful for data processing, and the licence the data was published under.

Usage

tsg_core_data(x, verbose = TRUE)

Arguments

Value

A tibble with the core variables in the 360Giving standard.

See Also

tsg_process_data(), which does the same processing but returns all available variables.

Examples

## Not run: 
grants <- tsg_all_grants()

df <- tsg_core_data(grants)

## End(Not run)

Identify missing data sets

Description

Returns a tibble with details on any available data missing from a list of grants returned by tsg_all_grants().

Usage

tsg_missing(x)

Arguments

Value

A tibble with details on funders missing data from a list of tibbles passed to the function.

Examples

## Not run: 
all_grants <- tsg_all_grants()

missing_grants <- tsg_missing(all_grants)

## End(Not run)

Convert data to tibble

Description

Given a list returned by tsg_all_grants() or tsg_search_grants(), creates a tibble with all available variables. This tibble contains roughly 200 columns if all available grants are used (as of October 2019), due to differences in how grant data is labelled and structured.

Usage

tsg_process_data(x, min_coverage = 0, verbose = TRUE)

Arguments

Value

A tibble with all variables from all provided grants.

See Also

tsg_core_data(), which does the same processing but only returns the core variables in the 360Giving standard.

Examples

## Not run: 
grants <- tsg_all_grants()

df1 <- tsg_process_data(grants)

# Only return data from columns with more than 50% coverage
df2 <- tsg_process_data(grants, min_coverage = 0.5)

## End(Not run)

Search funders

Description

Return a tibble with information on all grant datasets where funder data matches one or more search strings.

Usage

tsg_search_funders(
  search,
  search_in = NULL,
  verbose = TRUE,
  ignore_case = TRUE,
  perl = FALSE,
  fixed = FALSE
)

Arguments

Value

A tibble with information on matching datasets

See Also

tsg_search_grants() for retrieving all grants from matching funders.

Examples

## Not run: 
search1 <- tsg_search_funders(search = c("bbc", "caBinet"))

## End(Not run)

Search for specific datasets

Description

Returns a list of tibbles with details of all grants from specific funders.

Usage

tsg_search_grants(
  search,
  search_in = NULL,
  verbose = TRUE,
  ignore_case = TRUE,
  perl = FALSE,
  fixed = FALSE,
  ...
)

Arguments

Details

tsg_search_grants retrieves grants where funder data matches one or more search strings. If only one dataset matches queries, returns a tibble of that dataset. Use tsg_specific_df() to pass a dataframe.

Value

A single tibble (if only one grant maker matches the queries) or a list of tibbles (if the query matches multiple datasets).

See Also

tsg_search_funders() for retrieving information on available datasets from matching funders. tsg_specific_df() to retrieve data contained with all or specific rows of a tibble returned by tsg_available() or tsg_missing().

Examples

## Not run: 
specific1 <- tsg_search_grants(search = c("bbc", "caBinet"))

## End(Not run)

Get specific datasets

Description

Retrieve data contained with all or specific rows of a tibble returned by tsg_available() or tsg_missing().

Usage

tsg_specific_df(x, verbose = TRUE, timeout = 30, retries = 0)

Arguments

Value

A list of tibbles with grant data.

See Also

tsg_search_grants()

tsg_available()

tsg_missing()

Examples

## Not run: 
all_grants <- tsg_all_grants()

missing_grants <- tsg_missing(all_grants)

more_grants <- tsg_specific_df(missing_grants)

## End(Not run)