Downloading data

Allen Morphology
The AllenMorphology class is used to download data for this dataset. It can be used to specify neurons from a given species and brain regions, like in the example below:
1
from morphapi.api.allenmorphology import AllenMorphology
2
​
3
​
4
am = AllenMorphology()
5
​
6
​
7
# Select mouse neurons in the primary visual cortex
8
neurons = am.neurons.loc[
9
    (am.neurons.species == "Mus musculus")
10
    & (am.neurons.structure_area_abbrev == "VISp")
11
]
12
​
13
# Download some of these neurons
14
neurons = am.download_neurons(neurons[:5].id.values)
Copied!
Neuromorpho
Neuromorpho.org is a vast online repository of morphological data. The NeuroMorpOrgAPI class can be used to download data from it. Note that given the size of this huge dataset, it is not possible to download all metadata matching specific criteria at once.
1
from morphapi.api.neuromorphorg import NeuroMorpOrgAPI
2
​
3
api = NeuroMorpOrgAPI()
4
​
5
# ---------------------------- Downloading metadata --------------------------- #
6
# Get metadata for pyramidal neurons from the mouse cortex.
7
metadata, _ = api.get_neurons_metadata(
8
    size=10,  # Can get the metadata for up to 500 neurons at the time
9
    species="mouse",
10
    cell_type="pyramidal",
11
    brain_region="neocortex",
12
)
13
​
14
# To get a list of available query fields: print(api.fields)
15
# To get a list of valid values for a field: print(api.get_fields_values(field))
16
print("Neurons metadata:")
17
print(metadata[0])
18
​
19
# ---------------------------- Download morphology --------------------------- #
20
neurons = api.download_neurons(metadata[5])
21
​
Copied!
​
​
MouseLight
To download neurons morphologies from Janelia Campus' MouseLight project, you can use the MouseLightAPI class. 
1
from morphapi.api.mouselight import MouseLightAPI
2
​
3
​
4
# ---------------------------- Downloading neurons --------------------------- #
5
mlapi = MouseLightAPI()
6
​
7
# Fetch metadata for neurons with soma in the secondary motor cortex
8
neurons_metadata = mlapi.fetch_neurons_metadata(
9
    filterby="soma", filter_regions=["MOs"]
10
)
11
​
12
# Then we can download the files
13
neurons = mlapi.download_neurons(neurons_metadata[0])
14
​
Copied!
​
Mpin Zebrafish
To download neurons registered to a zebrafish atlas, you can use the MpinMorphologyAPI class.
1
from morphapi.api.mpin_celldb import MpinMorphologyAPI
2
​
3
​
4
api = MpinMorphologyAPI()
5
​
6
# ----------------------------- Download dataset ----------------------------- #
7
"""
8
    If it's the first time using this API, you'll have to download the dataset
9
    with all of the neurons' data.
10
"""
11
api.download_dataset()
12
# You can then inspect metadata about all neurons:
13
print(api.neurons_df.head())
14
​
15
​
16
# Get neurons for a given brain structure
17
neurons_ids = api.get_neurons_by_structure(837)
18
​
19
​
20
# and load the selected neurons
21
neurons = api.load_neurons(neurons_ids)
22
​
Copied!
​

morphapi - Previous

Usage

Rendering data

Last modified 1yr ago

Copy link

Contents