Skip to contents

wordbankr 2.0.0

  • In a non-interactive session with no Redivis credentials (no REDIVIS_API_TOKEN, no cached sign-in), data functions now return NULL with a message immediately instead of waiting for a browser sign-in.
  • get_crossling_items() now fails gracefully (message + NULL) when the database is unreachable, like every other data-access function.
  • All get_* functions (and summarise_items(), wb_dataset()) gain a version argument for pinning a data release (e.g. version = "v2.0"; the default "current" is the most recent release).
  • The db_args argument is removed from all get_* functions.
  • In get_administration_data(), the race level "Other" is now "Other/Mixed" (for all dataset versions), and birth_order gains the levels "Ninth" to "Twelfth".
  • New functions get_aoa() and get_embeddings() return precomputed ages of acquisition and multilingual word embeddings for every word item.
  • All get_* functions now record the data’s dataset_version in a column of their output; when version = "current" (the default), this is resolved to the actual current version tag (e.g. "v1.5") rather than the literal string "current".
  • Breaking (with dataset v2.0+): in get_administration_data(), date_of_test is now a Date (previously a string), and the nested language_exposures column exposure_proportion is renamed exposure_percentage (its values were always percentages, 0-100). ASL CDITwo item ids are normalized from "Item_N" to "item_N".
  • The Redivis dataset (v2.0+) uses a normalized schema — child-level variables live in the children table and instrument-level variables in instruments — but get_administration_data() joins these back together, so its flat output shape is unchanged.
  • Data now come from the versioned Wordbank dataset on Redivis (https://stanford.redivis.com/datasets/627v-9ewzpdvz0) instead of the MySQL database. All get_* functions keep their signatures and return the same data.
  • get_administration_data(filter_age = FALSE) now returns administrations outside the instrument age range flagged by the source data (previously these were only reachable through the age filter’s absence).
  • connect_to_wordbank() and get_wordbank_args() are deprecated and ignored.
  • get_crossling_items() now returns a single uni_lemma column derived from item mappings; the internal database id column and uni-lemmas unattached to any item are no longer included.
  • The redivis client is a suggested (not imported) dependency, installable from https://langcog.r-universe.dev; wordbankr prompts with the install command if it is missing.
  • All network access retries transient failures and then fails gracefully (message + NULL), and no test or example requires network access on CRAN.