SynapseCriteria¶
- class neuprint.queries.SynapseCriteria(matchvar='s', *, rois=None, type=None, confidence=None, primary_only=True, client=None)[source]¶
Synapse selection criteria.
Specifies which fields to filter by when searching for Synapses. This class does not send queries itself, but you use it to specify search criteria for various query functions.
Except for
matchvar
, all parameters must be passed as keyword arguments.- Parameters
matchvar (str) – An arbitrary cypher variable name to use when this
SynapseCriteria
is used to construct cypher queries.rois (str or list) – Optional. If provided, limit the results to synapses that reside within the given roi(s).
type – If provided, limit results to either ‘pre’ or ‘post’ synapses.
confidence (float, 0.0-1.0) – Limit results to synapses of at least this confidence rating. By default, use the dataset’s default synapse confidence threshold, which will include the same synapses that were counted in each neuron-neuron
weight
(as opposed toweightHP
orweightHR
).primary_only (boolean) –
If True, only include primary ROI names in the results. Disable this with caution.
Note
This parameter does NOT filter by ROI. (See the
rois
argument for that.) It merely determines whether or not each synapse should be associated with exactly one ROI in the query output, or with multiple ROIs (one for every non-primary ROI the synapse intersects).If you set
primary_only=False
, then the table will contain duplicate entries for each synapse – one per intersecting ROI.client – Used to validate ROI names. If not provided, the global default
Client
will be used.