Experimental Tools

Scripts and utilities in active development. These tools work but may have bugs or rough edges. Use with caution and report issues.

fast_validate_ids.py

Experimental

Parallel ID validator using ThreadPoolExecutor. Processes 5,000+ root IDs in under 2 minutes by parallelizing supervoxel lookups, then batching root lookups in a single API call. Uses the accurate supervoxel tracking method (not get_latest_roots).

Usage

python tracer_tools/scripts/fast_validate_ids.py --input ids.txt python tracer_tools/scripts/fast_validate_ids.py --input ids.txt --output results.txt --workers 20
Location: tracer_tools/scripts/fast_validate_ids.py Default datastack: brain_and_nerve_cord Default workers: 20

Known Issues

  • No retry logic for transient API failures; a single thread error loses that ID
  • Progress reporting is coarse (every 500 IDs)
  • High worker count may trigger CAVE API rate limits on some networks

fast_get_coords.py

Experimental

Parallel coordinate fetcher. Gets viewer-resolution coordinates for thousands of root IDs by parallelizing L2 chunk lookups, then batching L2 coordinate fetches. Output is tab-separated (root_id, x, y, z) ready to paste into Google Sheets.

Usage

python tracer_tools/scripts/fast_get_coords.py --input ids.txt python tracer_tools/scripts/fast_get_coords.py --input ids.txt --output coords.tsv --workers 20
Location: tracer_tools/scripts/fast_get_coords.py Default datastack: brain_and_nerve_cord Default workers: 20

Known Issues

  • No retry logic for transient API failures; a single thread error loses that ID
  • Uses L2 representative coordinates only (not skeleton centroids)
  • L2 cache batches of 100 may still occasionally 504 on slow connections