Package: banc
The Brain And Nerve Cord fly connectomeThe BANC (pronounced "bank") is the Brain And Nerve Cord, a GridTape-TEM dataset of an adultDrosophila melanogaster's entire central nervous system. This dataset was generated byJasper PhelpsandMinsu Kimin Wei-Chung Lee's lab at Harvard Medical School. A paper describing the dataset is currently in preparation.This repository contains:A python package for interacting with the connectome data (see the folderbanc/, and installation instructions below).Thebancpackage is a fork on thefanc(Female Adult Nerve Cord) package, which can be found at theupstream repository. Note that to make it easier to synchronize new features inbancandfancpackages, the folderbanc/in this repo is a link to the folderfanc/– but files in this repo's version of thefanc/folder have been adapted for use with the BANC.Other information about the dataset and about the community effort to proofread the connectome (see thewiki).Have any questions? Pleaseopen an issueor contactJasper Phelps (jasper.s.phelps@gmail.com).Installing and configuring thebancpython packageBefore you startAs is always the case in python, consider making a virtual environment (using your preference of virtualenv/virtualenvwrapper or conda) before installing.Installation option 1: pip install from PyPIpip install bancInstallation option 2: pip install directly from GitHubThe code on GitHub will sometimes be slightly more up to date than the version on PyPIpip install git+https://github.com/jasper-tms/BANC-fly-connectome.gitInstallation option 3: Clone then installThis is the best option if you want to make changes yourself to the codecd ~/repos  # or wherever you keep your repos
git clone https://github.com/jasper-tms/BANC-fly-connectome.git
cd BANC-fly-connectome
pip install -e .TroubleshootingDepending on your Python 3 version and your operating system, you may need to battle some bugs in order to get thepip installcommands above to succeed.If you get something that looks like.. ERROR:: Could not find a local HDF5 installation.
   You may need to explicitly state where your local HDF5 headers and
   library can be found by setting the ``HDF5_DIR`` environment
   variable or by using the ``--hdf5`` command-line option.and you're on a Mac, installbrew(https://brew.sh) if you haven't yet, then usebrewto install HDF5 withbrew install hdf5, then putHDF5_DIR=/opt/homebrew/opt/hdf5in front of yourpip installcommand (e.g.HDF5_DIR=/opt/homebrew/opt/hdf5 pip install banc).If you get an error that containsError compiling Cython file:
...
Cython.Compiler.Errors.CompileError: tables/utilsextension.pyxtry topip installthe latest version oftablesfrom GitHub by runningHDF5_DIR=/opt/homebrew/opt/hdf5 pip install git+https://github.com/PyTables/PyTables, or alternatively, use conda to install it (conda install tables). After you get this package installed successfully, try installingbancagain.Provide credentialsAccess to the latest reconstruction of BANC is restricted to authorized users. If you are a member of the BANC community (seeCollaborative communityon this repo's wiki) and have been granted access, you can generate an API key by visitinghttps://global.daf-apis.com/auth/api/v1/create_tokenand logging in with your BANC-authorized google account. Copy the key that is displayed, then run the following commands in python to save your key to the appropriate file:importbancbanc.save_cave_credentials("THE API KEY YOU COPIED")Alternatively, you can manually do what the command above accomplishes, which is to create a text file at~/.cloudvolume/secrets/cave-secret.jsonwith these contents:{
  "token": "THE API KEY YOU COPIED",
  "brain_and_nerve_cord": "THE API KEY YOU COPIED"
}You can verify that your API key has been saved successfully by running:importbancclient=banc.get_caveclient()Optional installation steps for additional functionalityInstall Elastix to transform neurons into alignment with the VNC templateThe mesh manipulation and coordinate transform code requirespytransformix, which is itself a Python wrapper for Elastix. Therefore, Elastix must be installed and its lib and bin paths must be appended to theLD_LIBRARY_PATHandPATHenvironment variables. Seepytransformixdocumentationfor specific instructions.DocumentationFirst go throughfanc_python_package_examples.ipynbThen check out other notebooks inexample_notebooks/Finally you canbrowse the code, check out modules that have names that interest you, and read the docstrings.