pymaid.get_contributor_statistics

pymaid.get_contributor_statistics(x, separate=False, max_threads=500, remote_instance=None)[source]

Retrieve contributor statistics for given skeleton ids.

By default, stats are given over all neurons.

Parameters:
  • x

    Neurons to get contributor stats for. Can be either:

    1. list of skeleton ID(s) (int or str)

    2. list of neuron name(s) (str, exact match)

    3. an annotation: e.g. ‘annotation:PN right’

    4. CatmaidNeuron or CatmaidNeuronList object

  • separate (bool, optional) – If True, stats are given per neuron.

  • max_threads (int, optional) – Maximum parallel data requests. Overrides CatmaidInstance.max_threads.

  • remote_instance (CatmaidInstance, optional) – If not passed directly, will try using global.

Returns:

Series, if separate=False. DataFrame, if separate=True:

  skeleton_id  node_contributors  multiuser_review_minutes  ..
1
2
3
  post_contributors  construction_minutes  min_review_minutes  ..
1
2
3
  n_postsynapses  n_presynapses  pre_contributors  n_nodes  ..
1
2
3
  review_contributors
1
2
3

Return type:

pandas.DataFrame or pandas.Series

Examples

>>> # Plot contributions as pie chart
>>> import matplotlib.pyplot as plt
>>> cont = pymaid.get_contributor_statistics("annotation:uPN right")
>>> plt.subplot(131, aspect=1)
>>> ax1 = plt.pie(cont.node_contributors.values(),
...               labels=cont.node_contributors.keys(),
...               autopct='%.0f%%' )
>>> plt.subplot(132, aspect=1)
>>> ax2 = plt.pie(cont.pre_contributors.values(),
...               labels=cont.pre_contributors.keys(),
...               autopct='%.0f%%' )
>>> plt.subplot(133, aspect=1)
>>> ax3 = plt.pie(cont.post_contributors.values(),
...               labels=cont.post_contributors.keys(),
...               autopct='%.0f%%' )
>>> plt.show()