Package 'econdatasets'

Get a dataset from EconDataverse Hugging Face repositories

Description

Downloads and reads a Parquet file directly from the EconDataverse Hugging Face datasets using the arrow package.

Usage

ed_get(dataset, table, columns = NULL, quiet = FALSE)

Arguments

dataset	Character string naming the dataset repository on Hugging Face (e.g., "wbids" for World Bank Indicators).
table	Character string naming the table.
columns	Character vector naming the columns. Defaults to NULL.
quiet	Logical; suppress messages? Default: FALSE.

Value

A data.frame containing the requested dataset, or NULL if the download fails.

Examples

df <- ed_get("wbids", "counterparts")
head(df)

df <- ed_get(
  "wbids",
  "counterparts",
  columns = c("counterpart_id", "counterpart_name"))

---

List available datasets in the EconDataverse organization

Description

Retrieves a list of all datasets published under the EconDataverse organization on Hugging Face.

Usage

ed_get_datasets(quiet = FALSE)

Arguments

quiet

Logical; whether to suppress informational messages. Defaults to FALSE.

Value

A data frame with columns:

dataset

Dataset identifier on Hugging Face

total_downloads

Approximate download count

last_modified

Last update timestamp (UTC)

is_private

Logical; whether the dataset is private

is_gated

Logical; whether access is gated

Returns NULL if the request fails.

Examples

ed_get_datasets()

---

List Parquet tables for a specific EconDataverse dataset

Description

Queries the Hugging Face Hub and returns all .parquet files under a given dataset repository in the EconDataverse organization, including file sizes.

Usage

ed_get_tables(dataset, quiet = FALSE)

Arguments

dataset	Character; the dataset repository name (e.g., "wbids").
quiet	Logical; suppress messages? Default: FALSE.

Value

A data.frame with:

table

Basename without the .parquet extension

filename

Filename with extension

path

Path within the repo

size

File size

url

Direct resolve/main URL to the Parquet file

Returns NULL if the request fails.

Examples

ed_get_tables("wbids")

---