neurom.features.neurite

Neurite features.

Any public function from this namespace can be called via the features mechanism. If calling directly the function in this namespace can only accept a neurite as its input. If you want to apply it to anything other than neurite then you must use the features mechanism e.g. features.get.

>>> import neurom
>>> from neurom import features
>>> m = neurom.load_morphology('path/to/morphology')
>>> features.get('max_radial_distance', m.neurites[0])
>>> features.get('max_radial_distance', m)
>>> features.get('number_of_segments', m.neurites, neurite_type=neurom.AXON)

For more details see Features.

Functions

bifurcation_partitions(neurite)

Partition at bf points.

diameter_power_relations(neurite[, method])

Calculate the diameter power relation at a bf point.

local_bifurcation_angles(neurite)

Get a list of local bf angles.

max_radial_distance(neurite)

Get the maximum radial distances of the termination sections.

number_of_bifurcations(neurite)

Number of bf points.

number_of_forking_points(neurite)

Number of forking points.

number_of_leaves(neurite)

Number of leaves points.

number_of_sections(neurite[, iterator_type])

Number of sections.

number_of_segments(neurite)

Number of segments.

partition_asymmetry(neurite[, variant, method])

Partition asymmetry at bf points.

partition_asymmetry_length(neurite[, method])

'partition_asymmetry' feature with variant='length'.

partition_pairs(neurite)

Partition pairs at bf points.

principal_direction_extents(neurite[, direction])

Principal direction extent of neurites in morphologies.

remote_bifurcation_angles(neurite)

Get a list of remote bf angles.

section_areas(neurite)

Section areas.

section_bif_branch_orders(neurite)

Bifurcation section branch orders.

section_bif_lengths(neurite)

Bifurcation section lengths.

section_bif_radial_distances(neurite[, origin])

Get the radial distances of the bf sections.

section_branch_orders(neurite)

Section branch orders.

section_end_distances(neurite)

Section end to end distances.

section_lengths(neurite)

Section lengths.

section_path_distances(neurite)

Path lengths.

section_radial_distances(neurite[, origin, ...])

Section radial distances.

section_strahler_orders(neurite)

Inter-segment opening angles in a section.

section_taper_rates(neurite)

Diameter taper rates of the sections from root to tip.

section_term_branch_orders(neurite)

Termination section branch orders.

section_term_lengths(neurite)

Termination section lengths.

section_term_radial_distances(neurite[, origin])

Get the radial distances of the termination sections.

section_tortuosity(neurite)

Section tortuosities.

section_volumes(neurite)

Section volumes.

segment_areas(neurite)

Areas of the segments.

segment_lengths(neurite)

Lengths of the segments.

segment_meander_angles(neurite)

Inter-segment opening angles in a section.

segment_midpoints(neurite)

Return a list of segment mid-points.

segment_path_lengths(neurite)

Returns pathlengths between all non-root points and their root point.

segment_radial_distances(neurite[, origin])

Returns the list of distances between all segment mid points and origin.

segment_radii(neurite)

Arithmetic mean of the radii of the points in segments.

segment_taper_rates(neurite)

Diameters taper rates of the segments.

segment_volumes(neurite)

Volumes of the segments.

sibling_ratios(neurite[, method])

Sibling ratios at bf points.

terminal_path_lengths(neurite)

Get the path lengths to each terminal point.

total_area(neurite)

Neurite surface area.

total_length(neurite)

Neurite length.

total_volume(neurite)

Neurite volume.

volume_density(neurite)

Get the volume density.

neurom.features.neurite.bifurcation_partitions(neurite)

Partition at bf points.

neurom.features.neurite.diameter_power_relations(neurite, method='first')

Calculate the diameter power relation at a bf point.

Diameter power relation is defined in https://www.ncbi.nlm.nih.gov/pubmed/18568015

This quantity gives an indication of how far the branching is from the Rall ratio (when =1).

neurom.features.neurite.local_bifurcation_angles(neurite)

Get a list of local bf angles.

neurom.features.neurite.max_radial_distance(neurite)

Get the maximum radial distances of the termination sections.

neurom.features.neurite.number_of_bifurcations(neurite)

Number of bf points.

neurom.features.neurite.number_of_forking_points(neurite)

Number of forking points.

neurom.features.neurite.number_of_leaves(neurite)

Number of leaves points.

neurom.features.neurite.number_of_sections(neurite, iterator_type=<function Section.ipreorder>)

Number of sections. For a morphology it will be a sum of all neurites sections numbers.

neurom.features.neurite.number_of_segments(neurite)

Number of segments.

neurom.features.neurite.partition_asymmetry(neurite, variant='branch-order', method='petilla')

Partition asymmetry at bf points.

Variant: length is a different definition, as the absolute difference in downstream path lenghts, relative to the total neurite path length Method: ‘petilla’ or ‘uylings’. The former is default. The latter uses -2 shift. See neurom.features.bifurcationfunc.partition_asymmetry()

neurom.features.neurite.partition_asymmetry_length(neurite, method='petilla')

‘partition_asymmetry’ feature with variant=’length’.

Because it is often used, it has a dedicated feature.

neurom.features.neurite.partition_pairs(neurite)

Partition pairs at bf points.

Partition pair is defined as the number of bifurcations at the two daughters of the bifurcating section

neurom.features.neurite.principal_direction_extents(neurite, direction=0)

Principal direction extent of neurites in morphologies.

Note

Principal direction extents are always sorted in descending order. Therefore, by default the maximal principal direction extent is returned.

neurom.features.neurite.remote_bifurcation_angles(neurite)

Get a list of remote bf angles.

neurom.features.neurite.section_areas(neurite)

Section areas.

neurom.features.neurite.section_bif_branch_orders(neurite)

Bifurcation section branch orders.

neurom.features.neurite.section_bif_lengths(neurite)

Bifurcation section lengths.

neurom.features.neurite.section_bif_radial_distances(neurite, origin=None)

Get the radial distances of the bf sections.

neurom.features.neurite.section_branch_orders(neurite)

Section branch orders.

neurom.features.neurite.section_end_distances(neurite)

Section end to end distances.

neurom.features.neurite.section_lengths(neurite)

Section lengths.

neurom.features.neurite.section_path_distances(neurite)

Path lengths.

neurom.features.neurite.section_radial_distances(neurite, origin=None, iterator_type=<function Section.ipreorder>)

Section radial distances.

The iterator_type can be used to select only terminal sections (ileaf) or only bifurcations (ibifurcation_point).

neurom.features.neurite.section_strahler_orders(neurite)

Inter-segment opening angles in a section.

neurom.features.neurite.section_taper_rates(neurite)

Diameter taper rates of the sections from root to tip.

Taper rate is defined here as the linear fit along a section. It is expected to be negative for morphologies.

neurom.features.neurite.section_term_branch_orders(neurite)

Termination section branch orders.

neurom.features.neurite.section_term_lengths(neurite)

Termination section lengths.

neurom.features.neurite.section_term_radial_distances(neurite, origin=None)

Get the radial distances of the termination sections.

neurom.features.neurite.section_tortuosity(neurite)

Section tortuosities.

neurom.features.neurite.section_volumes(neurite)

Section volumes.

neurom.features.neurite.segment_areas(neurite)

Areas of the segments.

neurom.features.neurite.segment_lengths(neurite)

Lengths of the segments.

neurom.features.neurite.segment_meander_angles(neurite)

Inter-segment opening angles in a section.

neurom.features.neurite.segment_midpoints(neurite)

Return a list of segment mid-points.

neurom.features.neurite.segment_path_lengths(neurite)

Returns pathlengths between all non-root points and their root point.

neurom.features.neurite.segment_radial_distances(neurite, origin=None)

Returns the list of distances between all segment mid points and origin.

neurom.features.neurite.segment_radii(neurite)

Arithmetic mean of the radii of the points in segments.

neurom.features.neurite.segment_taper_rates(neurite)

Diameters taper rates of the segments.

The taper rate is defined as the absolute radii differences divided by length of the section

neurom.features.neurite.segment_volumes(neurite)

Volumes of the segments.

neurom.features.neurite.sibling_ratios(neurite, method='first')

Sibling ratios at bf points.

The sibling ratio is the ratio between the diameters of the smallest and the largest child. It is a real number between 0 and 1. Method argument allows one to consider mean diameters along the child section instead of diameter of the first point.

neurom.features.neurite.terminal_path_lengths(neurite)

Get the path lengths to each terminal point.

neurom.features.neurite.total_area(neurite)

Neurite surface area. For a morphology it will be a sum of all neurite areas.

The area is defined as the sum of the area of the sections.

neurom.features.neurite.total_length(neurite)

Neurite length. For a morphology it will be a sum of all neurite lengths.

neurom.features.neurite.total_volume(neurite)

Neurite volume. For a morphology it will be a sum of neurites volumes.

neurom.features.neurite.volume_density(neurite)

Get the volume density.

The volume density is defined as the ratio of the neurite volume and the volume of the neurite’s enclosing convex hull

TODO: convex hull fails on some morphologies, it may be good to instead use

bounding_box to compute the neurite enclosing volume

Note

Returns np.nan if the convex hull computation fails.