direl-ts-tool-kit 0.7.0__tar.gz → 0.8.0__tar.gz

{direl_ts_tool_kit-0.7.0 → direl_ts_tool_kit-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: direl-ts-tool-kit
-Version: 0.7.0
+Version: 0.8.0
 Summary: A toolbox for time series analysis and visualization.
 Home-page: https://gitlab.com/direl/direl_tool_kit
 Author: Diego Restrepo-Leal

{direl_ts_tool_kit-0.7.0 → direl_ts_tool_kit-0.8.0}/direl_ts_tool_kit/plot/plot_ts.py

@@ -471,3 +471,80 @@ def plot_histogram(df, variable, units="", density=True, color="BLUE_BARS", bins
     ax.grid(alpha=0.8, linestyle="--")
 
     return fig
+
+
+def plot_data_boxplot(
+    df, variable=None, x_label="", y_label="", grid=False, notch=False
+):
+    """
+    Generates a boxplot visualization, either for all numerical columns in the
+    DataFrame or for a single specified variable.
+
+    The function applies consistent styling for the boxes, outliers, and median
+    lines using predefined colors from 'paper_colors'.
+
+    Parameters
+    ----------
+    df : pd.DataFrame
+        The input DataFrame containing the data to be plotted.
+    variable : str, optional
+        The column name of the variable to plot.
+        - If None (default), boxplots for all numerical columns in the DataFrame
+          are generated side-by-side.
+        - If a string, a single boxplot for that column is generated.
+    x_label : str, optional
+        The label for the X-axis. Defaults to "".
+    y_label : str, optional
+        The label for the Y-axis. Defaults to "".
+    grid : bool, optional
+        If True, display the grid lines on the plot. This parameter is only
+        effective when plotting **all** variables (when `variable` is None).
+        Defaults to False.
+    notch : bool, optional
+        If True, draw a notch around the median. This parameter is only
+        effective when plotting **all** variables (when `variable` is None).
+        Defaults to False.
+
+    Returns
+    -------
+    matplotlib.figure.Figure
+        The generated Matplotlib Figure object containing the boxplot(s).
+
+    Notes
+    -----
+    The boxplot uses the following fixed style parameters:
+    - **Box Line Color:** BLUE_LINES
+    - **Outlier Marker:** 'o' (marker size 12)
+    - **Median Line Color:** GREEN_LINES
+
+    When plotting a single variable (`variable` is set), the `grid` and
+    `notch` parameters are internally forced to **False**.
+    """
+    boxprops = dict(linewidth=4, color=paper_colors["BLUE_LINES"])
+    flierprops = dict(marker="o", markersize=12)
+    medianprops = dict(linewidth=4, color=paper_colors["GREEN_LINES"])
+
+    fig, ax = plt.subplots()
+
+    if not variable:
+        ax = df.boxplot(
+            grid=grid,
+            notch=notch,
+            boxprops=boxprops,
+            flierprops=flierprops,
+            medianprops=medianprops,
+        )
+    else:
+        ax = df[[variable]].boxplot(
+            grid=False,
+            notch=False,
+            boxprops=boxprops,
+            flierprops=flierprops,
+            medianprops=medianprops,
+        )
+
+    ax.set_xlabel(f"{x_label}")
+    ax.set_ylabel(f"{y_label}")
+    ax.tick_params(axis="x")
+
+    return fig

{direl_ts_tool_kit-0.7.0 → direl_ts_tool_kit-0.8.0}/direl_ts_tool_kit.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: direl-ts-tool-kit
-Version: 0.7.0
+Version: 0.8.0
 Summary: A toolbox for time series analysis and visualization.
 Home-page: https://gitlab.com/direl/direl_tool_kit
 Author: Diego Restrepo-Leal

{direl_ts_tool_kit-0.7.0 → direl_ts_tool_kit-0.8.0}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="direl-ts-tool-kit",
-    version="0.7.0",
+    version="0.8.0",
     description="A toolbox for time series analysis and visualization.",
     long_description=open("README.md", encoding="utf-8").read(),
     long_description_content_type="text/markdown",