direl-ts-tool-kit 0.7.0__py3-none-any.whl → 0.8.0__py3-none-any.whl

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.dist-info → direl_ts_tool_kit-0.8.0.dist-info}/METADATA

@@ -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.dist-info → direl_ts_tool_kit-0.8.0.dist-info}/RECORD

@@ -1,11 +1,11 @@
 direl_ts_tool_kit/__init__.py,sha256=W99Wd3BeEFKOxT51TApURElbDJvqIjD8u_-qDoCYSJ0,94
 direl_ts_tool_kit/plot/__init__.py,sha256=CMwyv-kiE74nwr3MJPL7gWIJmcfZ8UQCRu7mBGGQ4rI,49
 direl_ts_tool_kit/plot/plot_style.py,sha256=5YxoLXlYvzleTnBEGPwCmHQIJ0S96KPJspq_n-qMvpw,1069
-direl_ts_tool_kit/plot/plot_ts.py,sha256=E8oswirgUyzojKRvUA39MiZqplCFMMmIJtYBDOOM4JM,14839
+direl_ts_tool_kit/plot/plot_ts.py,sha256=eyv7MLZNiZAPGHj7EJVwt1odsF9MOkBvbx731isB7Yc,17376
 direl_ts_tool_kit/utilities/__init__.py,sha256=jMtxYZUtwlhgI99sxe_8MMzsDnxtbTP7Ivh9tUOeIwQ,25
 direl_ts_tool_kit/utilities/data_prep.py,sha256=k3eOwQEEd5mxy2DtT_Gdo7BhkzEmSQqvMJ89y8mH5CQ,6024
-direl_ts_tool_kit-0.7.0.dist-info/licenses/LICENCE,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-direl_ts_tool_kit-0.7.0.dist-info/METADATA,sha256=UTxeb67A2nbjkUDpPd2tAP_7GgEc4KRmaawwDz2fzG4,5196
-direl_ts_tool_kit-0.7.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-direl_ts_tool_kit-0.7.0.dist-info/top_level.txt,sha256=vMCRudnGnsdRg_6fUftnG8PF2Y1m0bjBDMf3pCAp6bc,18
-direl_ts_tool_kit-0.7.0.dist-info/RECORD,,
+direl_ts_tool_kit-0.8.0.dist-info/licenses/LICENCE,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+direl_ts_tool_kit-0.8.0.dist-info/METADATA,sha256=oF75eBNRbt-j61YbbSAHtz2HfF6CizO2QCcYeSgLu-E,5196
+direl_ts_tool_kit-0.8.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+direl_ts_tool_kit-0.8.0.dist-info/top_level.txt,sha256=vMCRudnGnsdRg_6fUftnG8PF2Y1m0bjBDMf3pCAp6bc,18
+direl_ts_tool_kit-0.8.0.dist-info/RECORD,,