apmtools 0.2.4__tar.gz → 0.2.6__tar.gz

{apmtools-0.2.4 → apmtools-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: apmtools
-Version: 0.2.004
+Version: 0.2.006
 Summary: A collection of tools for processing air pollution monitoring data
 Project-URL: Homepage, https://github.com/federlorenz/apmtools
 Author-email: Federico Lorenzetti <lorenzetti.federico@gmail.com>

{apmtools-0.2.4 → apmtools-0.2.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "apmtools"
-version = "0.2.004"
+version = "0.2.006"
 authors = [
   { name="Federico Lorenzetti", email="lorenzetti.federico@gmail.com" },
 ]

{apmtools-0.2.4 → apmtools-0.2.6}/src/apmtools/classes.py

@@ -970,7 +970,7 @@ class Summary(pd.DataFrame):
         if type(time_start) is str:
             time_start = parse(time_start).time()
         if type(time_end) is str:
-            time_start = parse(time_end).time()
+            time_end = parse(time_end).time()
         if type(date_start) is str:
             date_start = parse(date_start)
         if type(date_end) is str:
@@ -1526,7 +1526,7 @@ class Apm(pd.DataFrame):
         if type(time_start) is str:
             time_start = parse(time_start).time()
         if type(time_end) is str:
-            time_start = parse(time_end).time()
+            time_end = parse(time_end).time()
         if type(date_start) is str:
             date_start = parse(date_start)
         if type(date_end) is str:

apmtools-0.2.6/src/apmtools/shiny/summary.py

@@ -0,0 +1,435 @@
+"""Interactive Plotly/Shiny application for apmtools Summary objects."""
+
+from __future__ import annotations
+
+import threading
+from collections.abc import Sequence
+
+import pandas as pd
+
+
+PLOT_TYPES = {
+    "line": "Line",
+    "bar": "Bar",
+    "histogram": "Histogram",
+    "box": "Boxplot",
+}
+
+# ``None`` means row-level plotting.  The other values are passed directly to
+# Summary.group_stat(frequency=...).
+FREQUENCIES = {
+    "None (raw data)": None,
+    "Second": "second",
+    "Minute": "minute",
+    "Hour": "hour",
+    "Day": "day",
+    "Week": "week",
+    "Weekday": "weekday",
+}
+
+AGGREGATES = {
+    "Mean": "mean",
+    "Median": "median",
+    "Sum": "sum",
+    "Minimum": "min",
+    "Maximum": "max",
+    "Count": "count",
+    "Standard deviation": "std",
+}
+
+def _default_x(data: pd.DataFrame) -> str:
+    """Return the first datetime column, or otherwise the first column."""
+    datetime_columns = [
+        column
+        for column in data.columns
+        if pd.api.types.is_datetime64_any_dtype(data[column])
+    ]
+    return str(datetime_columns[0] if datetime_columns else data.columns[0])
+
+def _default_group(data: pd.DataFrame) -> str | None:
+    """Return ``identifier`` when available."""
+    return "identifier" if "identifier" in data.columns else None
+
+def _numeric_columns(data: pd.DataFrame) -> list[str]:
+    """Return numeric column names as strings."""
+    return [
+        str(column)
+        for column in data.columns
+        if pd.api.types.is_numeric_dtype(data[column])
+    ]
+
+
+def _normalise_y(data: pd.DataFrame, x: str, y: str | Sequence[str] | None) -> list[str]:
+    """Validate and normalise an initial Y selection."""
+    numeric = _numeric_columns(data)
+    if y is None:
+        return [column for column in numeric if column != x][:1]
+    values = [y] if isinstance(y, str) else list(y)
+    missing = [column for column in values if column not in data.columns]
+    if missing:
+        raise ValueError(f"Unknown y column(s): {missing}")
+    return [str(column) for column in values]
+
+
+def _subset_choices(data: pd.DataFrame, column: str) -> tuple[dict[str, str], dict[str, object]]:
+    """Build stable Shiny choices and their corresponding original values."""
+    values = pd.unique(data[column].dropna())
+    choices: dict[str, str] = {}
+    value_map: dict[str, object] = {}
+    for i, value in enumerate(values):
+        key = str(i)
+        choices[key] = str(value)
+        value_map[key] = value
+    return choices, value_map
+
+
+def _apply_filters(data, subset_column, subset_values, datetime_start, datetime_end):
+    """Apply Summary.subset() and Summary.dtfilter() in that order."""
+    filtered = data
+
+    if subset_column != "None" and subset_values:
+        choices, value_map = _subset_choices(filtered, subset_column)
+        values = [value_map[key] for key in subset_values if key in value_map]
+        if values:
+            filtered = filtered.subset({subset_column: values})
+
+    if datetime_start or datetime_end:
+        filtered = filtered.dtfilter(
+            date_start=datetime_start or None,
+            date_end=datetime_end or None,
+        )
+
+    return filtered
+
+
+def _aggregate(data, value_columns, frequency, grouping_by, aggregate):
+    """Aggregate through ``Summary.group_stat``.
+
+    ``group_by`` is a plotting/grouping choice for raw observations.  It only
+    becomes a statistical grouping when a frequency is selected.
+    """
+    if frequency is None:
+        return data
+
+    result = data.group_stat(
+        value_cols=value_columns,
+        frequency=frequency,
+        grouping_by=grouping_by,
+        aggregate=[aggregate],
+    )
+    if result is None:
+        raise ValueError(
+            "Summary.group_stat() returned None. Check the selected variables, "
+            "grouping columns, frequency, and completeness settings."
+        )
+    return result
+
+
+def _aggregated_value_columns(data, value_columns, aggregate):
+    """Return the columns produced by Summary.group_stat()."""
+    columns = []
+    for column in value_columns:
+        aggregated = f"{column}_{aggregate}"
+        if aggregated in data.columns:
+            columns.append(aggregated)
+    return columns
+
+
+def create_summary_app(
+    data: pd.DataFrame,
+    *,
+    x: str | None = None,
+    y: str | Sequence[str] | None = None,
+    group_by: str | Sequence[str] | None = None,
+    plot_type: str = "line",
+    title: str = "Summary plot",
+):
+    """Create, but do not start, an interactive Shiny app for a Summary."""
+    from shiny import App, reactive, render, ui
+    from shinywidgets import output_widget, render_plotly
+    import plotly.express as px
+
+    # Keep the Summary object intact: subset(), dtfilter() and group_stat()
+    # are methods on Summary and are intentionally used below.
+    summary = data.copy(deep=True)
+    if not isinstance(summary, pd.DataFrame):
+        raise TypeError("data must be a pandas DataFrame/Summary")
+    if summary.empty:
+        raise ValueError(
+            "Cannot create a Shiny application from an empty Summary.")
+
+    columns = [str(c) for c in summary.columns]
+    column_map = {str(c): c for c in summary.columns}
+    numeric_columns = _numeric_columns(summary)
+
+    x = _default_x(summary) if x is None else str(x)
+    if x not in column_map:
+        raise ValueError(f"Unknown x column: {x!r}")
+
+    initial_y = _normalise_y(summary, x, y)
+    if group_by is None:
+        initial_groups = [_default_group(summary)] if _default_group(
+            summary) is not None else []
+    elif isinstance(group_by, str):
+        initial_groups = [group_by]
+    else:
+        initial_groups = list(group_by)
+    unknown_groups = [c for c in initial_groups if c not in column_map]
+    if unknown_groups:
+        raise ValueError(f"Unknown group_by column(s): {unknown_groups!r}")
+
+    if plot_type not in PLOT_TYPES:
+        raise ValueError(
+            f"Unknown plot_type {plot_type!r}. Choose one of: {', '.join(PLOT_TYPES)}")
+
+    subset_columns = ["None", *columns]
+
+    app_ui = ui.page_sidebar(
+        ui.sidebar(
+            ui.h4("Plot controls"),
+            ui.input_select("plot_type", "Plot type",
+                            choices=PLOT_TYPES, selected=plot_type),
+            ui.input_select("x", "X-axis / category",
+                            choices=columns, selected=x),
+            ui.input_selectize(
+                "y", "Y-axis / variable", choices=numeric_columns,
+                selected=initial_y, multiple=True,
+            ),
+            ui.input_selectize(
+                "group_by", "Group by",
+                choices={c: c for c in columns},
+                selected=initial_groups,
+                multiple=True,
+                options={"placeholder": "Select one or more grouping columns"},
+            ),
+            ui.hr(),
+            ui.h5("Aggregation"),
+            ui.input_select(
+                "frequency", "Frequency", choices=FREQUENCIES,
+                selected="None (raw data)",
+            ),
+            ui.input_select(
+                "aggregate", "Statistic", choices=AGGREGATES,
+                selected="Mean",
+            ),
+            ui.hr(),
+            ui.h5("Subset"),
+            ui.input_select("subset_column", "Column",
+                            choices=subset_columns, selected="None"),
+            ui.input_selectize(
+                "subset_values", "Values", choices={}, selected=[], multiple=True,
+                options={"placeholder": "Select values"},
+            ),
+            ui.hr(),
+            ui.h5("Datetime filter"),
+            ui.input_text(
+                "datetime_start", "Start datetime",
+                value="", placeholder="YYYY-MM-DD or YYYY-MM-DD HH:MM:SS",
+            ),
+            ui.input_text(
+                "datetime_end", "End datetime",
+                value="", placeholder="YYYY-MM-DD or YYYY-MM-DD HH:MM:SS",
+            ),
+            ui.input_numeric("bins", "Histogram bins",
+                             value=30, min=1, max=200, step=1),
+            ui.input_text("title", "Plot title", value=title),
+            ui.help_text(
+                "Subset and datetime filters are applied before aggregation. "
+                "When a frequency is selected, aggregation is performed with "
+                "Summary.group_stat()."
+            ),
+        ),
+        ui.card(
+            ui.card_header("Interactive plot"),
+            output_widget("plot", height="75vh"),
+        ),
+    )
+
+    def server(input, output, session):
+        @reactive.effect
+        def _update_subset_values():
+            selected_column = input.subset_column()
+            if selected_column == "None":
+                choices = {}
+            else:
+                choices, _ = _subset_choices(
+                    summary, column_map[selected_column])
+            ui.update_selectize("subset_values", choices=choices, selected=[])
+
+        @reactive.calc
+        def filtered_summary():
+            subset_column = input.subset_column()
+            subset_values = list(input.subset_values())
+            start = input.datetime_start().strip()
+            end = input.datetime_end().strip()
+            return _apply_filters(
+                summary,
+                column_map[subset_column] if subset_column != "None" else "None",
+                subset_values,
+                start,
+                end,
+            )
+
+        @reactive.calc
+        def selected_data():
+            current = filtered_summary()
+            selected_y = list(input.y())
+            if not selected_y:
+                return pd.DataFrame()
+
+            y_columns = [column_map[c] for c in selected_y]
+            selected_groups = list(input.group_by())
+            grouping_by = [column_map[c] for c in selected_groups]
+            frequency = FREQUENCIES[input.frequency()]
+            aggregate = AGGREGATES[input.aggregate()]
+
+            # All selected grouping columns are passed directly to
+            # Summary.group_stat() when a frequency is selected.  With raw
+            # data they remain plotting-only grouping columns.
+            if frequency is not None:
+                current = _aggregate(current, y_columns,
+                                     frequency, grouping_by, aggregate)
+
+            return current
+
+        @render_plotly
+        def plot():
+            plot_df = selected_data()
+            selected_plot = input.plot_type()
+            selected_x = input.x()
+            selected_y = list(input.y())
+            selected_groups = list(input.group_by())
+            frequency = FREQUENCIES[input.frequency()]
+
+            if plot_df.empty or not selected_y:
+                return px.scatter(title="No data for the selected filters")
+
+            # Keep the original selected Y columns separate from the columns
+            # produced by group_stat().  For example, selecting ``pm25`` and
+            # hourly means produces ``pm25_mean`` in the aggregated result.
+            selected_y_columns = [column_map[c] for c in selected_y]
+
+            # Summary.group_stat() creates the frequency column itself.
+            # For example, frequency="hour" creates an ``hour`` column,
+            # while an aggregate such as mean creates ``pm25_mean``.
+            # Therefore the aggregated frequency column replaces the
+            # originally selected X-axis column.
+            if frequency is not None:
+                aggregate = AGGREGATES[input.aggregate()]
+                y_columns = _aggregated_value_columns(
+                    plot_df, selected_y_columns, aggregate
+                )
+                x_column = frequency
+
+                if x_column not in plot_df.columns:
+                    return px.scatter(
+                        title=(
+                            f"Aggregation did not produce the expected "
+                            f"'{x_column}' column"
+                        )
+                    )
+            else:
+                y_columns = [
+                    c for c in selected_y_columns if c in plot_df.columns
+                ]
+                x_column = column_map[selected_x]
+
+            if not y_columns:
+                return px.scatter(
+                    title="Selected variables are not available after aggregation"
+                )
+
+            # Multiple grouping columns are supported by group_stat(). For
+            # plotting, Plotly needs one color/category column, so combine the
+            # selected grouping columns into a readable composite label.
+            group_columns = [column_map[c] for c in selected_groups
+                             if column_map[c] in plot_df.columns]
+            if group_columns:
+                plot_df = plot_df.copy()
+                plot_df["__plot_group"] = (
+                    plot_df[group_columns].astype(str).agg(" | ".join, axis=1)
+                )
+
+            if selected_plot == "histogram":
+                long_df = plot_df[y_columns].melt(
+                    var_name="variable", value_name="value")
+                fig = px.histogram(
+                    long_df, x="value", color="variable", nbins=int(input.bins()),
+                    barmode="overlay" if len(y_columns) > 1 else "relative",
+                )
+            elif selected_plot == "box":
+                if not group_columns:
+                    long_df = plot_df[y_columns].melt(
+                        var_name="variable", value_name="value")
+                    fig = px.box(long_df, x="variable",
+                                 y="value", points="outliers")
+                else:
+                    group_column = "__plot_group"
+                    long_df = plot_df[[group_column, *y_columns]].melt(
+                        id_vars=[group_column], var_name="variable", value_name="value",
+                    )
+                    fig = px.box(long_df, x="variable", y="value",
+                                 color=group_column, points="outliers")
+            elif selected_plot == "bar":
+                if not group_columns:
+                    fig = px.bar(plot_df, x=x_column,
+                                 y=y_columns, barmode="group")
+                else:
+                    group_column = "__plot_group"
+                    long_df = plot_df[[x_column, group_column, *y_columns]].melt(
+                        id_vars=[x_column, group_column], var_name="variable", value_name="value",
+                    )
+                    fig = px.bar(
+                        long_df, x=x_column, y="value", color=group_column,
+                        facet_row="variable" if len(y_columns) > 1 else None, barmode="group",
+                    )
+            else:
+                if not group_columns:
+                    fig = px.line(plot_df, x=x_column, y=y_columns)
+                else:
+                    group_column = "__plot_group"
+                    long_df = plot_df[[x_column, group_column, *y_columns]].melt(
+                        id_vars=[x_column, group_column], var_name="variable", value_name="value",
+                    )
+                    fig = px.line(
+                        long_df, x=x_column, y="value", color=group_column,
+                        facet_row="variable" if len(y_columns) > 1 else None,
+                    )
+
+            fig.update_layout(
+                title=input.title(),
+                hovermode="x unified" if selected_plot == "line" else "closest",
+                margin=dict(l=60, r=30, t=70, b=60),
+            )
+            return fig
+
+    return App(app_ui, server)
+
+
+def run_summary_app(
+    data: pd.DataFrame,
+    *,
+    x: str | None = None,
+    y: str | Sequence[str] | None = None,
+    group_by: str | Sequence[str] | None = None,
+    plot_type: str = "line",
+    title: str = "Summary plot",
+    host: str = "127.0.0.1",
+    port: int = 0,
+    launch_browser: bool = True,
+    daemon: bool = True,
+):
+    """Create and start the Shiny app in a background thread."""
+    from shiny import run_app
+
+    app = create_summary_app(
+        data, x=x, y=y, group_by=group_by, plot_type=plot_type, title=title)
+
+    def _run() -> None:
+        run_app(app, host=host, port=port,
+                launch_browser=launch_browser, dev_mode=False)
+
+    thread = threading.Thread(
+        target=_run, name="apmtools-shiny-summary", daemon=daemon)
+    thread.start()
+    return thread

apmtools-0.2.4/src/apmtools/shiny/summary.py

@@ -1,353 +0,0 @@
-"""Interactive Plotly/Shiny application for apmtools Summary objects."""
-
-from __future__ import annotations
-
-import threading
-from collections.abc import Sequence
-
-import pandas as pd
-
-
-PLOT_TYPES = {
-    "line": "Line",
-    "bar": "Bar",
-    "histogram": "Histogram",
-    "box": "Boxplot",
-}
-
-
-def _default_x(data: pd.DataFrame) -> str:
-    """Return the first datetime column, or otherwise the first column."""
-    datetime_columns = [
-        column
-        for column in data.columns
-        if pd.api.types.is_datetime64_any_dtype(data[column])
-    ]
-    return str(datetime_columns[0] if datetime_columns else data.columns[0])
-
-
-def _numeric_columns(data: pd.DataFrame) -> list[str]:
-    """Return numeric column names as strings."""
-    return [
-        str(column)
-        for column in data.columns
-        if pd.api.types.is_numeric_dtype(data[column])
-    ]
-
-
-def _normalise_y(
-    data: pd.DataFrame,
-    x: str,
-    y: str | Sequence[str] | None,
-) -> list[str]:
-    """Validate and normalise an initial Y selection."""
-    if y is None:
-        return [column for column in _numeric_columns(data) if column != x][:1]
-
-    values = [y] if isinstance(y, str) else list(y)
-    missing = [column for column in values if column not in data.columns]
-    if missing:
-        raise ValueError(f"Unknown y column(s): {missing}")
-    return [str(column) for column in values]
-
-
-def create_summary_app(
-    data: pd.DataFrame,
-    *,
-    x: str | None = None,
-    y: str | Sequence[str] | None = None,
-    group_by: str | None = None,
-    plot_type: str = "line",
-    title: str = "Summary plot",
-):
-    """
-    Create, but do not start, a Shiny application for a Summary/DataFrame.
-
-    Supported plot types are ``line``, ``bar``, ``histogram`` and ``box``.
-    """
-    from shiny import App, reactive, render, ui
-    from shinywidgets import output_widget, render_plotly
-    import plotly.express as px
-
-    df = pd.DataFrame(data).copy()
-    if df.empty:
-        raise ValueError("Cannot create a Shiny application from an empty Summary.")
-
-    original_columns = list(df.columns)
-    column_map = {str(column): column for column in original_columns}
-    columns = list(column_map)
-    numeric_columns = _numeric_columns(df)
-
-    if x is None:
-        x = _default_x(df)
-    else:
-        x = str(x)
-    if x not in column_map:
-        raise ValueError(f"Unknown x column: {x!r}")
-
-    initial_y = _normalise_y(df, column_map[x], y)
-
-    if group_by is not None:
-        group_by = str(group_by)
-        if group_by not in column_map:
-            raise ValueError(f"Unknown group_by column: {group_by!r}")
-
-    if plot_type not in PLOT_TYPES:
-        raise ValueError(
-            f"Unknown plot_type {plot_type!r}. "
-            f"Choose one of: {', '.join(PLOT_TYPES)}"
-        )
-
-    app_ui = ui.page_sidebar(
-        ui.sidebar(
-            ui.h4("Plot controls"),
-
-            ui.input_select(
-                "plot_type",
-                "Plot type",
-                choices=PLOT_TYPES,
-                selected=plot_type,
-            ),
-
-            ui.input_select(
-                "x",
-                "X-axis / category",
-                choices=columns,
-                selected=x,
-            ),
-
-            ui.input_selectize(
-                "y",
-                "Y-axis / variable",
-                choices=numeric_columns,
-                selected=initial_y,
-                multiple=True,
-            ),
-
-            ui.input_select(
-                "group_by",
-                "Group by",
-                choices={"None": "None", **{c: c for c in columns}},
-                selected=group_by if group_by is not None else "None",
-            ),
-
-            ui.input_numeric(
-                "bins",
-                "Histogram bins",
-                value=30,
-                min=1,
-                max=200,
-                step=1,
-            ),
-
-            ui.input_text(
-                "title",
-                "Plot title",
-                value=title,
-            ),
-
-            ui.help_text(
-                "Line: ordered X values and one or more Y variables. "
-                "Bar: categorical X and numeric Y. "
-                "Histogram: distribution of numeric variables. "
-                "Boxplot: distribution of numeric variables, optionally grouped."
-            ),
-        ),
-
-        ui.card(
-            ui.card_header("Interactive plot"),
-            output_widget("plot", height="75vh"),
-        ),
-    )
-
-    def server(input, output, session):
-        @reactive.calc
-        def selected_data() -> pd.DataFrame:
-            selected_plot = input.plot_type()
-            selected_x = input.x()
-            selected_y = list(input.y())
-            selected_group = input.group_by()
-
-            if selected_plot == "histogram":
-                if not selected_y:
-                    return pd.DataFrame()
-                use_columns = [column_map[c] for c in selected_y]
-            else:
-                if not selected_y:
-                    return pd.DataFrame()
-                use_columns = [
-                    column_map[selected_x],
-                    *(column_map[c] for c in selected_y),
-                ]
-
-                if selected_group != "None":
-                    group_column = column_map[selected_group]
-                    if group_column not in use_columns:
-                        use_columns.append(group_column)
-
-            return df.loc[:, use_columns].copy()
-
-        @render_plotly
-        def plot():
-            plot_df = selected_data()
-            selected_plot = input.plot_type()
-            selected_x = input.x()
-            selected_y = list(input.y())
-            selected_group = input.group_by()
-
-            if plot_df.empty or not selected_y:
-                return px.scatter(title="Select at least one numeric variable")
-
-            y_columns = [column_map[c] for c in selected_y]
-
-            if selected_plot == "histogram":
-                # Plotly accepts multiple columns through y with a long-form
-                # transformation; melt gives consistent legends.
-                long_df = plot_df[y_columns].melt(
-                    var_name="variable",
-                    value_name="value",
-                )
-                fig = px.histogram(
-                    long_df,
-                    x="value",
-                    color="variable",
-                    nbins=int(input.bins()),
-                    barmode="overlay" if len(y_columns) > 1 else "relative",
-                )
-
-            elif selected_plot == "box":
-                if selected_group == "None":
-                    long_df = plot_df[y_columns].melt(
-                        var_name="variable",
-                        value_name="value",
-                    )
-                    fig = px.box(
-                        long_df,
-                        x="variable",
-                        y="value",
-                        points="outliers",
-                    )
-                else:
-                    group_column = column_map[selected_group]
-                    long_df = plot_df[
-                        [group_column, *y_columns]
-                    ].melt(
-                        id_vars=[group_column],
-                        var_name="variable",
-                        value_name="value",
-                    )
-                    fig = px.box(
-                        long_df,
-                        x="variable",
-                        y="value",
-                        color=group_column,
-                        points="outliers",
-                    )
-
-            elif selected_plot == "bar":
-                x_column = column_map[selected_x]
-                if selected_group == "None":
-                    fig = px.bar(
-                        plot_df,
-                        x=x_column,
-                        y=y_columns,
-                        barmode="group",
-                    )
-                else:
-                    group_column = column_map[selected_group]
-                    long_df = plot_df.melt(
-                        id_vars=[x_column, group_column],
-                        value_vars=y_columns,
-                        var_name="variable",
-                        value_name="value",
-                    )
-                    fig = px.bar(
-                        long_df,
-                        x=x_column,
-                        y="value",
-                        color=group_column,
-                        facet_row="variable" if len(y_columns) > 1 else None,
-                        barmode="group",
-                    )
-
-            else:  # line
-                x_column = column_map[selected_x]
-                if selected_group == "None":
-                    fig = px.line(
-                        plot_df,
-                        x=x_column,
-                        y=y_columns,
-                    )
-                else:
-                    group_column = column_map[selected_group]
-                    long_df = plot_df.melt(
-                        id_vars=[x_column, group_column],
-                        value_vars=y_columns,
-                        var_name="variable",
-                        value_name="value",
-                    )
-                    fig = px.line(
-                        long_df,
-                        x=x_column,
-                        y="value",
-                        color=group_column,
-                        facet_row="variable" if len(y_columns) > 1 else None,
-                    )
-
-            fig.update_layout(
-                title=input.title(),
-                hovermode="x unified"
-                if selected_plot == "line"
-                else "closest",
-                margin=dict(l=60, r=30, t=70, b=60),
-            )
-            return fig
-
-    return App(app_ui, server)
-
-
-def run_summary_app(
-    data: pd.DataFrame,
-    *,
-    x: str | None = None,
-    y: str | Sequence[str] | None = None,
-    group_by: str | None = None,
-    plot_type: str = "line",
-    title: str = "Summary plot",
-    host: str = "127.0.0.1",
-    port: int = 0,
-    launch_browser: bool = True,
-    daemon: bool = True,
-):
-    """
-    Create and start the Shiny app in a background thread.
-
-    ``port=0`` asks the operating system to select an available port.
-    """
-    from shiny import run_app
-
-    app = create_summary_app(
-        data,
-        x=x,
-        y=y,
-        group_by=group_by,
-        plot_type=plot_type,
-        title=title,
-    )
-
-    def _run() -> None:
-        run_app(
-            app,
-            host=host,
-            port=port,
-            launch_browser=launch_browser,
-            dev_mode=False,
-        )
-
-    thread = threading.Thread(
-        target=_run,
-        name="apmtools-shiny-summary",
-        daemon=daemon,
-    )
-    thread.start()
-    return thread