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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: direl-ts-tool-kit
-Version: 0.6.0
+Version: 0.7.0
 Summary: A toolbox for time series analysis and visualization.
 Home-page: https://gitlab.com/direl/direl_tool_kit
 Author: Diego Restrepo-Leal
@@ -125,6 +125,14 @@ It focuses on the lower triangular part (corner=True) and includes a
 regression line for trend visualization.
 
 
+#### plot_histogram
+`plot_histogram(df, variable, units="", density=True, color="BLUE_BARS", bins=30)`
+
+Generates a histogram plot for a specified numerical variable.
+
+The plot visualizes the distribution of the data, with the Y-axis dynamically
+labeled as 'Density' or 'Count' based on the `density` parameter.
+
 # Examples
 - [Example 1](https://gitlab.com/direl/direl_tool_kit/-/blob/main/example/example_01.md?ref_type=heads)
 - [Example 2](https://gitlab.com/direl/direl_tool_kit/-/blob/main/example/example_02.md?ref_type=heads)

{direl_ts_tool_kit-0.6.0 → direl_ts_tool_kit-0.7.0}/README.md

@@ -92,6 +92,14 @@ It focuses on the lower triangular part (corner=True) and includes a
 regression line for trend visualization.
 
 
+#### plot_histogram
+`plot_histogram(df, variable, units="", density=True, color="BLUE_BARS", bins=30)`
+
+Generates a histogram plot for a specified numerical variable.
+
+The plot visualizes the distribution of the data, with the Y-axis dynamically
+labeled as 'Density' or 'Count' based on the `density` parameter.
+
 # Examples
 - [Example 1](https://gitlab.com/direl/direl_tool_kit/-/blob/main/example/example_01.md?ref_type=heads)
 - [Example 2](https://gitlab.com/direl/direl_tool_kit/-/blob/main/example/example_02.md?ref_type=heads)

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

@@ -412,3 +412,62 @@ def pair_plot(X, y):
     fig = svm.fig
 
     return fig
+
+
+def plot_histogram(df, variable, units="", density=True, color="BLUE_BARS", bins=30):
+    """
+    Generates a histogram plot for a specified numerical variable.
+
+    The plot visualizes the distribution of the data, with the Y-axis dynamically
+    labeled as 'Density' or 'Count' based on the `density` parameter.
+
+    Parameters
+    ----------
+    df : pd.DataFrame
+        The DataFrame containing the data to be plotted.
+    variable : str
+        The name of the column in 'df' whose distribution will be plotted.
+    units : str, optional
+        Units to display next to the variable name on the X-axis. Defaults to "".
+    density : bool, optional
+        If True (default), the Y-axis is scaled to a Probability Density,
+        meaning the area under the bars sums to 1. If False, the Y-axis
+        displays the raw count of observations per bin.
+    color : str, optional
+        Key corresponding to the bar color in the global 'paper_colors' dictionary
+        (e.g., "BLUE_BARS"). Defaults to "BLUE_LINES".
+    bins : int or sequence, optional
+        The number of equal-width bins in the range to divide the data.
+        Can be an integer (default is 30) or a sequence specifying the bin edges.
+
+    Returns
+    -------
+    matplotlib.figure.Figure
+        The generated Matplotlib Figure object containing the histogram.
+
+    Notes
+    -----
+    The plot applies a fixed style (alpha=0.7, white edge-color) and grid
+    for visual consistency.
+    """
+    fig, ax = plt.subplots()
+
+    ax.hist(
+        df[variable],
+        bins=bins,
+        density=density,
+        alpha=0.7,
+        color=paper_colors[color],
+        edgecolor="white",
+    )
+
+    ax.set_xlabel(f"{variable} {units}")
+
+    if density:
+        ax.set_ylabel("Density")
+    else:
+        ax.set_ylabel("Count")
+
+    ax.grid(alpha=0.8, linestyle="--")
+
+    return fig

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: direl-ts-tool-kit
-Version: 0.6.0
+Version: 0.7.0
 Summary: A toolbox for time series analysis and visualization.
 Home-page: https://gitlab.com/direl/direl_tool_kit
 Author: Diego Restrepo-Leal
@@ -125,6 +125,14 @@ It focuses on the lower triangular part (corner=True) and includes a
 regression line for trend visualization.
 
 
+#### plot_histogram
+`plot_histogram(df, variable, units="", density=True, color="BLUE_BARS", bins=30)`
+
+Generates a histogram plot for a specified numerical variable.
+
+The plot visualizes the distribution of the data, with the Y-axis dynamically
+labeled as 'Density' or 'Count' based on the `density` parameter.
+
 # Examples
 - [Example 1](https://gitlab.com/direl/direl_tool_kit/-/blob/main/example/example_01.md?ref_type=heads)
 - [Example 2](https://gitlab.com/direl/direl_tool_kit/-/blob/main/example/example_02.md?ref_type=heads)

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

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="direl-ts-tool-kit",
-    version="0.6.0",
+    version="0.7.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",