Table 1.

Troubleshooting Guide for Analyzing Large Connectome Graphs With BossDB Network Tools

Problem	Possible cause	Solution
DotMotif validation error	Conflicting edges or attributes	Simplify query; re-run with minimal motif and add constraints gradually
Zero matches returned	Overly strict constraints or case mismatch	Relax thresholds; use looser constraints; check attribute capitalization; often it is useful to remove attribute constraints to debug a query
Local search crashes or is slow	Graph too large for memory	Use Neo4j or Grand out-of-core backends
Neuroglancer view blank	Segment IDs do not match dataset segmentation	Load matching segmentation layer; verify dataset channel linkages from the BossDB management console; note that linkages declared in Motif Studio are already confirmed to work
Inconsistent results across tools	Mixed graph versions or directedness differences	Document dataset version; confirm directed versus undirected graph semantics