Bulk-update metadata for existing aedes neurons in FlyTable

Updates rows that already exist in the aedes_main FlyTable from a data.frame of per-row metadata. Update-only: every root_id must already be present (use aedes_add_neurons() to create rows).

Usage

aedes_set_meta(
  ids = NULL,
  df = NULL,
  dryrun = TRUE,
  update_roots = TRUE,
  annotator = TRUE,
  proofreader = FALSE,
  wipe = FALSE,
  ...
)

Arguments

ids

root_ids in any form understood by aedes_ids() (including a query string); or, when df is NULL, a data.frame of metadata that itself contains a root_id column.

df

an optional data.frame of metadata, recycled to match ids. When supplied together with ids, a root_id column is prepended from ids.

dryrun

logical: if TRUE (the default) return the update frame without writing to FlyTable.

update_roots

whether to bring root_ids to the pinned timestamp with fafbseg::flywire_latestid() before matching.

annotator

Multi-select annotator column write policy. TRUE (the default) appends getOption("aedes.initials") to the existing cell; FALSE leaves the column alone; a character vector (or comma-joined string) appends those tokens explicitly.

proofreader

Multi-select proofreader column write policy. Same accepted values as annotator; defaults to FALSE.

wipe

If TRUE, replace the target multi-select column(s) with just the new tokens instead of merging with existing cell contents. Default FALSE (append).

...

reserved (used to reject a mistaken dry_run argument).

Value

a data.frame of the rows written (or, on a dry run, that would be written), keyed by FlyTable _id.

Details

Rows with status bad_nucleus, duplicate or not_a_neuron are dropped before updating; any remaining root_id not found in aedes_main is an error (nothing is written). Writes go through the shared update engine, which pins a single timestamp so join-by-root_id is reliable.

See also

aedes_add_neurons(), aedes_set_group()