Tools for the Female Adult Nerve Cord Drosophila EM dataset
Project description
FANC_auto_recon
FANC (pronounced "fancy") is the Female Adult Nerve Cord, a GridTape-TEM dataset of an adult Drosophila melanogaster's ventral nerve cord. The dataset was first published in Phelps, Hildebrand, Graham et al. 2021 Cell, after which we applied automated methods for reconstructing neurons, synapses, and nuclei to accelerate reconstruction of the ventral nerve cord connectome. This repository contains a python package for interacting with the connectome (see the folder fanc
) as well as other supporting files.
Have any questions? Please open an issue or contact Jasper Phelps (jasper.s.phelps@gmail.com).
Installing and configuring the fanc
python package
Before you start
As 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 directly from GitHub
pip install git+https://github.com/htem/FANC_auto_recon.git
Installation option 2: Clone then install
cd ~/repos # or wherever you keep your repos
git clone https://github.com/htem/FANC_auto_recon.git
cd FANC_auto_recon
pip install -e .
Provide credentials
Access to the latest reconstruction of FANC is restricted to authorized users. If you are a member of the FANC community (see Collaborative community on this repo's wiki) and have been granted access, you can generate an API key by visiting https://global.daf-apis.com/auth/api/v1/create_token and logging in with your FANC-authorized google account. Copy the key that is displayed, then run the following commands in python to save your key to the appropriate file:
import fanc
fanc.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.json
with these contents:
{
"token": "THE API KEY YOU COPIED",
"fanc_production_mar2021": "THE API KEY YOU COPIED"
}
You can verify that your API key has been saved successfully by running:
import fanc
client = fanc.get_caveclient()
Optional installation steps for additional functionality
Install Elastix to transform neurons into alignment with the VNC template
The mesh manipulation and coordinate transform code requires pytransformix
, which is itself a Python wrapper for Elastix. Therefore, Elastix must be installed and its lib and bin paths must be appended to the LD_LIBRARY_PATH
and PATH
environment variables. See pytransformix
documentation for specific instructions.
Provide CATMAID credentials to pull data from CATMAID
You can get your CATMAID API key by logging into https://radagast.hms.harvard.edu/catmaidvnc then hovering over "You are [Your Name]" in the top-right corner, then clicking "Get API token".
Save your CATMAID API key by running:
import fanc
fanc.catmaid.save_catmaid_credentials("YOUR CATMAID API KEY")
You can verify that your API key has been saved successfully by running:
import fanc
fanc.catmaid.connect()
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.