Return level 2 supervoxel ids for neurons — flywire

Level 2 supervoxel ids are one step up from the terminal supervoxel ids (level 1) that are the finest resolution in the chunked graph. Like root ids, level 2 supervoxels can be edited: this results in the level 2 id being destroyed and two new ones being created. Unlike the root id after a merge or split, only the l2 ids at the edit location change, while most of the others remain the same.

Usage

flywire_l2ids(
  x,
  integer64 = TRUE,
  cache = TRUE,
  chunksize = 200L,
  datastack_name = getOption("fafbseg.cave.datastack_name", "flywire_fafb_production")
)

Arguments

x: root ids including as neuroglancer scene URLs
integer64: Whether to return ids as integer64 type (more compact but a little fragile) rather than character (default FALSE).
cache: Whether to cache the results on disk
chunksize: The number of root ids to send to the server in each request when fetching multiple ids or FALSE to make one request per id (see details).
datastack_name: defaults to the value selected by choose_segmentation and to "flywire_fafb_production" when that is missing. See https://global.daf-apis.com/info/ for other options.

Value

A vector of ids (usually as 64 bit integers); a named list of vectors when x has length >1.

Details

When x contains multiple ids, those not already in the disk cache are fetched in chunks of chunksize ids per request using the chunkedgraph leaves_many endpoint. This is much faster (~25x in tests) than one request per id, which you can still request with chunksize=FALSE. Cached results are reused in either case.

Examples

if (FALSE) { # \dontrun{
length(flywire_l2ids("720575940604351334"))
} # }