fanc_cellid_from_segid: Convert between FANC cell ids and root ids

In flyconnectome/fanc: Support Access to the Female Adult Nerve Cord (FANC) Dataset

Convert between FANC cell ids and root ids

Description

Converts between FANC cell ids (should survive most edits) and root ids (guaranteed to match just one edit state). See details.

Usage

fanc_cellid_from_segid(
  rootids = NULL,
  timestamp = NULL,
  version = NULL,
  cellid_table = NULL,
  rval = c("ids", "data.frame")
)

fanc_segid_from_cellid(
  cellids = NULL,
  timestamp = NULL,
  version = NULL,
  rval = c("ids", "data.frame"),
  integer64 = FALSE,
  cellid_table = NULL
)

Arguments

rootids	FANC root ids in any form understood by fanc_ids. The default value of NULL will return all cell ids.
timestamp	An optional time stamp. You should give only one of version or timestamp. When both are missing, ids should match the live materialisation version including up to the second edits.
version	An optional integer CAVE materialisation version. You should give only one of version or timestamp. When both are missing, ids should match the live materialisation version including up to the second edits.
cellid_table	Optional name of cell id table (the default value of NULL should find the correct table).
rval	Whether to return the cell ids or the whole of the CAVE table with additional columns.
cellids	Integer cell ids between between 1 and around 20000 that should uniquely identify each cell in the dataset.
integer64	Whether to return ids as bit64::integer64 or character vectors. Default value of NA leaves the ids unmodified.

Details

CAVE/PyChunkedGraph assigns a 64 bit integer root id to all bodies in the segmentation. These root ids are persistent in a computer science sense, which is often the exact opposite of what neuroscientists might imagine. Specifically, a given root id is matched to a single edit state of a neuron. If the neuron is edited, then root id changes. In contrast, cell ids do not change even in the face of edits. However, it is important to understand that they correspond to a specific point on a neuron, commonly the nucleus. If the nucleus is edited away from a the rest of a neuron to which it previously belonged, then the cell id and any associated edits will effectively with move it.

For further details see FANC slack and FANC wiki.

Value

Either a vector of ids or a data.frame depending on rval. A cellid vector will be integer; for root ids (segment ids), a character vector or an bit64::integer64 vector depending on the integer64 argument.

See Also

Other fanc-ids: fanc_ids(), fanc_islatest(), fanc_latestid(), fanc_leaves(), fanc_rootid(), fanc_xyz2id()

Examples

fanc_cellid_from_segid(fanc_latestid("648518346486614449"))


fanc_segid_from_cellid(12967)

flyconnectome/fanc documentation built on Sept. 6, 2024, 9:56 a.m.