curves

curves ¶

Time-course visualization functions.

This module provides functions for visualizing time-course data, AIFs, and residue functions.

plot_time_course ¶

plot_time_course(
    time,
    signal,
    fitted=None,
    title="Time Course",
    xlabel="Time (s)",
    ylabel="Signal",
    label_measured="Measured",
    label_fitted="Fitted",
    ax=None,
    figsize=(10, 6),
)

Plot time-course data with optional fitted curve.

PARAMETER	DESCRIPTION
`time`	Time points. TYPE: `NDArray`
`signal`	Measured signal values. TYPE: `NDArray`
`fitted`	Fitted/predicted signal values. TYPE: `NDArray` DEFAULT: `None`
`title`	Plot title. TYPE: `str` DEFAULT: `'Time Course'`
`xlabel`	Axis labels. TYPE: `str` DEFAULT: `'Time (s)'`
`ylabel`	Axis labels. TYPE: `str` DEFAULT: `'Time (s)'`
`label_measured`	Legend labels. TYPE: `str` DEFAULT: `'Measured'`
`label_fitted`	Legend labels. TYPE: `str` DEFAULT: `'Measured'`
`ax`	Axes to plot on. TYPE: `Axes` DEFAULT: `None`
`figsize`	Figure size if creating new figure. TYPE: `tuple` DEFAULT: `(10, 6)`

RETURNS	DESCRIPTION
`Axes`	The axes with the plot.

plot_aif ¶

plot_aif(
    aif,
    time=None,
    population_aif=None,
    title="Arterial Input Function",
    xlabel="Time (s)",
    ylabel="Concentration (mM)",
    ax=None,
    figsize=(10, 6),
)

Plot arterial input function.

PARAMETER	DESCRIPTION
`aif`	AIF to plot (or measured AIF array if using time parameter). TYPE: `ArterialInputFunction or NDArray`
`time`	Time points (required if aif is an array). TYPE: `NDArray` DEFAULT: `None`
`population_aif`	Population-based AIF to compare. TYPE: `NDArray` DEFAULT: `None`
`title`	Plot title. TYPE: `str` DEFAULT: `'Arterial Input Function'`
`xlabel`	Axis labels. TYPE: `str` DEFAULT: `'Time (s)'`
`ylabel`	Axis labels. TYPE: `str` DEFAULT: `'Time (s)'`
`ax`	Axes to plot on. TYPE: `Axes` DEFAULT: `None`
`figsize`	Figure size. TYPE: `tuple` DEFAULT: `(10, 6)`

RETURNS	DESCRIPTION
`Figure or Axes`	The figure or axes with the plot.

plot_residue_function ¶

plot_residue_function(
    time,
    residue,
    title="Residue Function",
    xlabel="Time (s)",
    ylabel="R(t)",
    show_mtt=True,
    show_oscillation_warning=False,
    ax=None,
    figsize=(10, 6),
)

Plot residue function from deconvolution.

PARAMETER	DESCRIPTION
`time`	Time points. TYPE: `NDArray`
`residue`	Residue function values. TYPE: `NDArray`
`title`	Plot title. TYPE: `str` DEFAULT: `'Residue Function'`
`xlabel`	Axis labels. TYPE: `str` DEFAULT: `'Time (s)'`
`ylabel`	Axis labels. TYPE: `str` DEFAULT: `'Time (s)'`
`show_mtt`	Whether to mark MTT on the plot. TYPE: `bool` DEFAULT: `True`
`show_oscillation_warning`	Whether to check and warn about oscillations. TYPE: `bool` DEFAULT: `False`
`ax`	Axes to plot on. TYPE: `Axes` DEFAULT: `None`
`figsize`	Figure size. TYPE: `tuple` DEFAULT: `(10, 6)`

RETURNS	DESCRIPTION
`Figure or Axes`	The figure or axes with the plot.

plot_multi_curves ¶

plot_multi_curves(
    time,
    curves,
    labels=None,
    colors=None,
    title="Time Courses",
    xlabel="Time (s)",
    ylabel="Signal",
    ax=None,
    figsize=(10, 6),
)

Plot multiple time courses on the same axes.

PARAMETER	DESCRIPTION
`time`	Time points. TYPE: `NDArray`
`curves`	List of time courses to plot. TYPE: `list[NDArray]`
`labels`	Labels for each curve. TYPE: `list[str]` DEFAULT: `None`
`colors`	Colors for each curve. TYPE: `list[str]` DEFAULT: `None`
`title`	Plot title. TYPE: `str` DEFAULT: `'Time Courses'`
`xlabel`	Axis labels. TYPE: `str` DEFAULT: `'Time (s)'`
`ylabel`	Axis labels. TYPE: `str` DEFAULT: `'Time (s)'`
`ax`	Axes to plot on. TYPE: `Axes` DEFAULT: `None`
`figsize`	Figure size. TYPE: `tuple` DEFAULT: `(10, 6)`

RETURNS	DESCRIPTION
`Axes`	The axes with the plot.