mcot.surface.track

Run deterministic tractography along the surface.

Functions

extract_ridge_values(surface, orientations, …)

Extract ridge values from to_extract

flatten_gradient(surface, orientations)

Redefine the orientations from 3D cartesian space to surface space.

surface_step(idx_triangle, pos1, pos2, …)

Takes a step across the given triangle to new position.

track_to_maximum(idx_triangle, pos1, pos2, …)

Keep tracking until a ridge is found in the gradient.

extract_ridge_values

mcot.surface.track.extract_ridge_values(surface: mcot.surface.mesh.Mesh2D, orientations, to_extract)[source]

Extract ridge values from to_extract

Parameters
  • surface – Mesh surface

  • orientations – (N, 3) array of orientations in 3D space (N = number of faces)

  • to_extract – (M, ) array of values to extract (M = number of vertices)

Returns

(M, ) array of extracted values

flatten_gradient

mcot.surface.track.flatten_gradient(surface: mcot.surface.mesh.Mesh2D, orientations)[source]

Redefine the orientations from 3D cartesian space to surface space.

Parameters
  • surface – Mesh surface

  • orientations – (N, 3) array of orientations in 3D space (N = number of faces)

Returns

(N, 2) orientations on triangular surface (N = number of faces)

surface_step

mcot.surface.track.surface_step(idx_triangle, pos1, pos2, triangles, directions)[source]

Takes a step across the given triangle to new position.

Location is defined by two vertices and the rel_pos between them

Parameters
  • idx_triangle – first vertex of current location

  • pos1 – position along first triangle axis

  • pos2 – position along second triangle axis

  • triangles – (M, 3) array of triangles indices

  • directions – (M, 2) array of gradients on the triangle surface

Returns

new triangle and relative position (int, float, float)

track_to_maximum

mcot.surface.track.track_to_maximum(idx_triangle, pos1, pos2, triangles, directions)[source]

Keep tracking until a ridge is found in the gradient.

Parameters
  • idx_triangle – first vertex of current location

  • pos1 – position along first triangle axis

  • pos2 – position along second triangle axis

  • triangles – (M, 3) array of triangles indices

  • directions – (M, 2) array of gradients on the triangle surface

Returns

new triangle and relative position (int, float, float)