get_office: Fetch 'Offices' table
In saschagobel/legislatoR: Interface to the Comparative Legislators Database

View source: R/get_office.R

get_office

R Documentation

Fetch 'Offices' table

Description

Fetches political and other offices of legislators for the specified legislature. Requires a working Internet connection.

Usage

get_office(legislature)

Arguments

legislature

A character string specifying the three-letter country code of the legislature for which data shall be fetched. Currently one of ‘aut’, ‘can’, ‘cze’, ‘esp’, ‘fra’, ‘deu’, ‘irl’, ‘sco’, ‘gbr’, ‘usa_house’, or ‘usa_senate’.

Format

Data frame in wide format with columns (varies by legislature):

wikidataid: Wikidata ID identifying a legislator's Wikidata entry (of class ‘character’).
office_1: political or other office held by a legislator (of class ‘logical’).
office_2: ... (of class ‘logical’).
...

Value

A data frame with columns as specified above.

Source

Wikidata API, https://www.wikidata.org/wiki/Wikidata:Main_Page

Examples

# Get entire 'Offices' table for the United States Senate
usa_offices <- get_office(legislature = "usa_senate")
tibble::glimpse(usa_offices)

# Get 'Offices' table for male members of the United States Senate
usa_offices_subset <- dplyr::semi_join(x = usa_offices,
                                       y = dplyr::filter(get_core(legislature = "usa_senate"),
                                                           sex == "female"),
                                         by = "wikidataid")
tibble::glimpse(usa_offices_subset)

saschagobel/legislatoR documentation built on Jan. 30, 2024, 7:52 p.m.