retrieve_treaty: Retrieve international treaties

In globalgov/qData: A Portal for Global Governance Data

Retrieve international treaties

Description

Some databases and datasets across the 'many* packages' (e.g. manyenviron) contain a myriad of information on international treaties governing an international domain. Researchers can, for example, use retrieve_bilaterals() to retrieve which countries have signed bilateral agreements in a respective year. Alternatively, researchers can use retrieve_multilaterals() to retrieve the titles of all multilateral agreements signed in the past 10 years. Alternatively, researchers can retrieve treaties that modify, amend, or expand other treaties with retrieve_links(). Or, even, researchers can retrieve membership lists of countries part to a certain treaty with retrieve_membership_list(). Finally, researchers can retrieve treaty texts available in 'many' datasets with retrieve_texts(). To retrieve information from several datasets in a database, researchers can consolidate() a database into one dataset with some combination of the rows, columns, and observations before getting the desired information.

Usage

retrieve_bilaterals(dataset)

retrieve_multilaterals(dataset)

retrieve_membership_list(dataset, actor = "StateID", treaty_type = NULL)

retrieve_links(dataset, treaty_type = NULL)

retrieve_texts(dataset, treaty_type = NULL)

Arguments

dataset	A dataset from one of the many packages.
actor	An actor variable. "StateID", by default.
treaty_type	The type of treaties to be returned. NULL, by default. Other options are "bilateral" or "multilateral".

Value

A tibble of bilateral agreements.

A tibble of multilateral agreements.

A tibble of manyIDs and countries part of the treaty.

A tibble of manyIDs and their links.

A tibble of manyIDs and their texts.

Examples

membs <- tibble::tibble(manyID = c("ROU-RUS[RFP]_1901A",
"ROU-RUS[RFP]_1901E", "GD16FI_1901A"),
Title = c("Convention Between Roumania And Russia Concerning Fishing
In The Danube And The Pruth",
"Convention Between Roumania And Russia Concerning Fishing
In The Danube And The Pruth",
"Convention Between The Governments Of Denmark And
The United Kingdom Of Great Britain
And Northern Ireland For Regulating The Fisheries
Of Their Respective Subjects Outside
Territorial Waters In The Ocean Surrounding The Faroe Islands"),
Beg = c("1901-02-22", "1901-02-22", "1901-06-24"))
retrieve_bilaterals(membs)
membs <- tibble::tibble( manyID = c("ROU-RUS[RFP]_1901A",
"ROU-RUS[RFP]_1901A", "GD16FI_1901A"),
Title = c("Convention Between Roumania And Russia Concerning Fishing
In The Danube And The Pruth",
"Convention Between Roumania And Russia Concerning Fishing
In The Danube And The Pruth",
"Convention Between The Governments Of Denmark And
The United Kingdom Of Great Britain
And Northern Ireland For Regulating The Fisheries
Of Their Respective Subjects Outside
Territorial Waters In The Ocean Surrounding The Faroe Islands"),
Beg = c("1901-02-22", "1901-02-22", "1901-06-24"))
retrieve_multilaterals(membs)
membs <- tibble::tibble(StateID = c("ROU", "RUS", "DNK"),
manyID = c("ROU-RUS[RFP]_1901A", "ROU-RUS[RFP]_1901A", "GD16FI_1901A"))
retrieve_membership_list(dataset = membs)
membs <- tibble::tibble(manyID = c("ROU-RUS[RFP]_1901A",
"ROU-RUS[RFP]_1901A:ROU-RUS[RFP]_1901A",
"GD16FI_1901A"))
retrieve_links(dataset = membs)
membs <- tibble::tibble(manyID = c("ROU-RUS[RFP]_1901A",
"ROU-RUS[RFP]_1901A:ROU-RUS[RFP]_1901A",
"GD16FI_1901A"),
Text = c("treaty 1", "treaty 2", "treaty 3"))
retrieve_texts(dataset = membs)
#retrieve_texts(dataset = manyenviron::agreements$HUGGO)

globalgov/qData documentation built on Nov. 17, 2022, 2:42 p.m.