musicflower.plotting.plot_time_traces

musicflower.plotting.plot_time_traces(x, y, z, colors, n_steps=None, times=None, group=None, **kwargs)[source]

Plot equally spaced traces from the top to the bottom of the triangle. These can be added to a figure and animated with a slider using the add_time_slider() function. The input arrays must have the same length compatible with a valid triangular map (i.e. a length of n(n+1)/2 for some integer n).

Parameters:

  • x (ndarray) – array with x-coordinates

  • y (ndarray) – array with y-coordinates

  • z (ndarray) – array with z-coordinates

  • colors (ndarray) – array with RGB colours

  • n_steps (Optional[int]) – see get_time_traces()

  • times (Optional[ndarray]) – see get_time_traces()

  • group (Optional[str]) – optional name of a group of traces in the legend (allows for switching the time traces on/off with together with the other traces in that legend group)

Return type:

List[Scatter3d]

Returns:

a list of n_steps + 1 Plotly Scatter3d plots