Sometimes, you forget to extract one or more entities. In such cases, it can be more efficient to create a spreadsheet with the omitted entities and then add those into the existing full Rxs project object. For that purpose, the tabulated extraction spreadsheet (txs) format exists. This is a rectangular table with the following columns: source_identification_entity_id, source_identification_value, parent_entity_id, entity_id, and value.

  stopOnErrors = FALSE,
  explode_vector_to_values = FALSE,
  silent = metabefor::opts$get("silent")



The parsed full Rxs project object, containing a list of Rxs trees.


The txs specifications, as a link to a publicly readable Google spreadsheet, an Excel file (if you have openxlsx installed), an SPSS dataset (if you have haven installed), or a comma separated values file (which will be read with read.csv()).


Whether to throw an error or show a warning (or just use cat to show a message is silent = metabefor::opts$get("silent")) when encountering errors.


Whether to call explode_vector_to_values if there are vectors among the added values.


Whether to the chatty or silent.


Invisibly, the full Rxs project object. Note that the Rxs trees will be changed in place given data.tree's pass-by-reference logic; so you can discard the result.


If source_identification_entity_id is empty (i.e. does not contain any non-whitespace characters), source_identification_value will be assumed to be the name of the relevant Rxs tree in the full Rxs project object.