cloudbian-helper 0.1.0__py3-none-any.whl

cloudbian_helper/graphics.adoc

@@ -0,0 +1,337 @@
+= Graphics Module
+:toc:
+:authors: Cloudberry Pi Foundations
+
+A simple Python library that makes data visualization easier using Matplotlib with a clean API and built-in 2D + 3D graphs.
+
+== Example Usage
+
+[source,python]
+----
+from graphs import Graphs
+
+g = Graphs(
+    title="Animal Balance",
+    theme="ggplot"
+)
+
+g.pie_chart(
+    labels=["Humans", "Animals", "Insects"],
+    values=[80, 50, 40]
+)
+
+g.bar_graph(
+    labels=["Humans", "Animals", "Insects"],
+    values=[80, 50, 40]
+)
+
+g.horizontal_bar_graph(
+    labels=["Humans", "Animals", "Insects"],
+    values=[80, 50, 40]
+)
+----
+
+== Installation
+
+[source,bash]
+----
+pip install matplotlib numpy
+----
+
+== Creating a Graph Object
+
+[source,python]
+----
+from graphs import Graphs
+
+g = Graphs(
+    title="My Graph",
+    figsize=(8, 5),
+    theme="default",
+    grid=True
+)
+----
+
+=== Parameters
+
+* title → Graph title
+* figsize → Figure size
+* theme → Matplotlib style (e.g. ggplot, default)
+* grid → Enable grid (True/False)
+
+---
+
+== 2D GRAPHS
+
+=== Line Graph
+
+[source,python]
+----
+g.line_graph(
+    x=[1,2,3,4],
+    y=[10,20,30,40]
+)
+----
+
+=== Bar Graph
+
+[source,python]
+----
+g.bar_graph(
+    labels=["A","B","C"],
+    values=[10,20,30]
+)
+----
+
+=== Horizontal Bar Graph
+
+[source,python]
+----
+g.horizontal_bar_graph(
+    labels=["A","B","C"],
+    values=[10,20,30]
+)
+----
+
+=== Scatter Graph
+
+[source,python]
+----
+g.scatter_graph(
+    x=[1,2,3],
+    y=[4,5,6]
+)
+----
+
+=== Pie Chart
+
+[source,python]
+----
+g.pie_chart(
+    labels=["A","B","C"],
+    values=[50,30,20]
+)
+----
+
+=== Histogram
+
+[source,python]
+----
+g.histogram(
+    data=[1,2,2,3,4,5]
+)
+----
+
+=== Area Graph
+
+[source,python]
+----
+g.area_graph(
+    x=[1,2,3,4],
+    y=[10,20,30,40]
+)
+----
+
+=== Step Graph
+
+[source,python]
+----
+g.step_graph(
+    x=[1,2,3],
+    y=[10,20,30]
+)
+----
+
+=== Stem Graph
+
+[source,python]
+----
+g.stem_graph(
+    x=[1,2,3],
+    y=[10,20,30]
+)
+----
+
+=== Box Plot
+
+[source,python]
+----
+g.box_plot([1,2,3,4,5,6])
+----
+
+=== Violin Plot
+
+[source,python]
+----
+g.violin_plot([1,2,3,4,5,6])
+----
+
+=== Heatmap
+
+[source,python]
+----
+g.heatmap([
+    [1,2,3],
+    [4,5,6],
+    [7,8,9]
+])
+----
+
+---
+
+== REALTIME GRAPH
+
+[source,python]
+----
+import random
+
+def data():
+    return random.randint(1,100)
+
+g.realtime_graph(data)
+----
+
+---
+
+== SAVE GRAPH
+
+[source,python]
+----
+g.save("graph.png")
+----
+
+---
+
+== 3D GRAPHS (VALUE-ONLY API)
+
+All 3D graphs use ONLY values (no x/y/z required). The library generates structure automatically.
+
+---
+
+=== 3D Bar Graph
+
+[source,python]
+----
+g.bar_3d_graph(
+    labels=["A","B","C"],
+    values=[10,20,30]
+)
+----
+
+---
+
+=== 3D Line Graph (True 3D)
+
+[source,python]
+----
+g.line_3d_graph(
+    values=[5,10,15,20],
+    style="linear"
+)
+----
+
+==== Styles
+
+* linear
+* wave
+* spiral
+
+---
+
+=== 3D Scatter Graph
+
+[source,python]
+----
+g.scatter_3d_graph(
+    values=[1,2,3,4,5]
+)
+----
+
+---
+
+=== 3D Surface Graph
+
+[source,python]
+----
+g.surface_3d_graph(
+    values=[3,6,2,8,5]
+)
+----
+
+---
+
+=== 3D Wireframe Graph
+
+[source,python]
+----
+g.wireframe_3d_graph(
+    values=[3,6,2,8,5]
+)
+----
+
+---
+
+=== 3D Contour Graph
+
+[source,python]
+----
+g.contour_3d_graph(
+    values=[3,6,2,8,5]
+)
+----
+
+---
+
+=== 🌄 Mountain Graph (Terrain Style)
+
+A smooth 3D landscape-style graph.
+
+[source,python]
+----
+g.mountain_3d_graph(
+    values=[3,8,2,10,6,12]
+)
+----
+
+---
+
+== Themes
+
+Available Matplotlib themes:
+
+* default
+* ggplot
+* dark_background
+* seaborn-v0_8
+* classic
+* bmh
+
+---
+
+== Full Example
+
+[source,python]
+----
+from graphs import Graphs
+
+g = Graphs(
+    title="Sales Data",
+    theme="ggplot"
+)
+
+g.bar_graph(
+    labels=["India","USA","China"],
+    values=[100,200,300]
+)
+
+g.bar_3d_graph(
+    labels=["India","USA","China"],
+    values=[100,200,300]
+)
+
+g.mountain_3d_graph(
+    values=[5,10,3,12,7]
+)
+
+g.save("output.png")
+----

cloudbian_helper/graphics.py

@@ -0,0 +1,602 @@
+"""Generate graphs using matplotlib only by entering simple commands
+Example usage:
+
+```python
+
+from graphs import Graphs
+
+
+g = Graphs(
+    title="Animal Balance",
+
+    theme="ggplot"
+)
+
+g.pie_chart(
+    labels=["Humans", "Animals", "Insects"],
+
+    values=[80, 50, 40]
+)
+
+g.bar_graph(
+    labels=["Humans", "Animals", "Insects"],
+
+    values=[80, 50, 40]
+)
+
+g.horizontal_bar_graph(
+    labels=["Humans", "Animals", "Insects"],
+
+    values=[80, 50, 40]
+)
+
+```
+"""
+
+
+import matplotlib.pyplot as plt
+from matplotlib.animation import FuncAnimation
+from mpl_toolkits.mplot3d import Axes3D
+from matplotlib.colors import LinearSegmentedColormap
+from matplotlib.colors import LinearSegmentedColormap
+import numpy as np
+
+
+class Graphs:
+    def __init__(
+        self,
+        title="Graph",
+        figsize=(8, 5),
+        theme="default",
+        grid=True
+    ):
+        plt.style.use(theme)
+        self.figsize = figsize
+        self.title = title
+        self.grid = grid
+
+    # -------------------------
+    # LINE GRAPH
+    # -------------------------
+    def line_graph(
+        self,
+        x,
+        y,
+        color="blue",
+        marker="o",
+        linewidth=2,
+        xlabel="X",
+        ylabel="Y",
+        show=True
+    ):
+        """Draw a line graph."""
+        plt.figure(figsize=self.figsize)
+        plt.plot(
+            x,
+            y,
+            color=color,
+            marker=marker,
+            linewidth=linewidth
+        )
+        plt.title(self.title)
+        plt.xlabel(xlabel)
+        plt.ylabel(ylabel)
+        plt.grid(self.grid)
+
+        if show:
+            plt.show()
+
+    # -------------------------
+    # BAR GRAPH
+    # -------------------------
+    def bar_graph(
+        self,
+        labels,
+        values,
+        color="skyblue",
+        xlabel="Category",
+        ylabel="Value",
+        show=True
+    ):
+        """Draw a simple and basic bar graph."""
+        plt.figure(figsize=self.figsize)
+        plt.bar(labels, values, color=color)
+
+        plt.title(self.title)
+        plt.xlabel(xlabel)
+        plt.ylabel(ylabel)
+
+        if show:
+            plt.show()
+
+    # -------------------------
+    # HORIZONTAL BAR
+    # -------------------------
+    def horizontal_bar_graph(
+        self,
+        labels,
+        values,
+        color="green",
+        show=True
+    ):
+        """Draw a simple and basic horizontal bar graph."""
+        plt.figure(figsize=self.figsize)
+        plt.barh(labels, values, color=color)
+        plt.title(self.title)
+
+        if show:
+            plt.show()
+
+    # -------------------------
+    # SCATTER PLOT
+    # -------------------------
+    def scatter_graph(
+        self,
+        x,
+        y,
+        color="red",
+        size=50,
+        show=True
+    ):
+        """Draw a standard scatter graph using the x and y coordinates"""
+        plt.figure(figsize=self.figsize)
+
+        plt.scatter(
+            x,
+            y,
+            c=color,
+            s=size
+        )
+
+        plt.title(self.title)
+        plt.grid(self.grid)
+
+        if show:
+            plt.show()
+
+    # -------------------------
+    # PIE CHART
+    # -------------------------
+    def pie_chart(
+        self,
+        labels,
+        values,
+        autopct="%1.1f%%",
+        startangle=90,
+        show=True
+    ):
+        """Draw a color coded pie chart"""
+        plt.figure(figsize=self.figsize)
+
+        plt.pie(
+            values,
+            labels=labels,
+            autopct=autopct,
+            startangle=startangle
+        )
+
+        plt.title(self.title)
+
+        if show:
+            plt.show()
+
+    # -------------------------
+    # HISTOGRAM
+    # -------------------------
+    def histogram(
+        self,
+        data,
+        bins=10,
+        color="purple",
+        show=True
+    ):
+        """By using this command you can simly draw a histograph"""
+        plt.figure(figsize=self.figsize)
+
+        plt.hist(
+            data,
+            bins=bins,
+            color=color
+        )
+
+        plt.title(self.title)
+
+        if show:
+            plt.show()
+
+    # -------------------------
+    # AREA GRAPH
+    # -------------------------
+    def area_graph(
+        self,
+        x,
+        y,
+        color="cyan",
+        alpha=0.5,
+        show=True
+    ):
+        """Draw an area graph using this command. An example for usage is ```graph.area_graph(x=(12, 2), y=(1,12))```."""
+        plt.figure(figsize=self.figsize)
+
+        plt.fill_between(
+            x,
+            y,
+            color=color,
+            alpha=alpha
+        )
+
+        plt.title(self.title)
+
+        if show:
+            plt.show()
+
+    # -------------------------
+    # STEP GRAPH
+    # -------------------------
+    def step_graph(
+        self,
+        x,
+        y,
+        color="orange",
+        show=True
+    ):
+        """Draw a simple step graph"""
+        plt.figure(figsize=self.figsize)
+
+        plt.step(
+            x,
+            y,
+            color=color
+        )
+
+        plt.title(self.title)
+
+        if show:
+            plt.show()
+
+    # -------------------------
+    # STEM GRAPH
+    # -------------------------
+    def stem_graph(
+        self,
+        x,
+        y,
+        show=True
+    ):
+        """Draw a simple stem graph."""
+        plt.figure(figsize=self.figsize)
+
+        plt.stem(x, y)
+
+        plt.title(self.title)
+
+        if show:
+            plt.show()
+
+    # -------------------------
+    # BOX PLOT
+    # -------------------------
+    def box_plot(
+        self,
+        data,
+        show=True
+    ):
+        """Draw a simple box plot graph"""
+        plt.figure(figsize=self.figsize)
+
+        plt.boxplot(data)
+
+        plt.title(self.title)
+
+        if show:
+            plt.show()
+
+    # -------------------------
+    # VIOLIN PLOT
+    # -------------------------
+    def violin_plot(
+        self,
+        data,
+        show=True
+    ):
+        """Draw a violin graph"""
+        plt.figure(figsize=self.figsize)
+
+        plt.violinplot(data)
+
+        plt.title(self.title)
+
+        if show:
+            plt.show()
+
+    # -------------------------
+    # HEATMAP
+    # -------------------------
+    def heatmap(
+            self,
+            matrix,
+            cmap="viridis",
+            color=None,
+            show=True
+    ):
+        plt.figure(figsize=self.figsize)
+
+        heatmap_cmap = cmap
+
+        if color is not None:
+            heatmap_cmap = LinearSegmentedColormap.from_list(
+                f"{color}_heatmap",
+                ["white", color]
+            )
+
+        plt.imshow(matrix, cmap=heatmap_cmap)
+
+        plt.colorbar()
+        plt.title(self.title)
+
+        if show:
+            plt.show()
+    # -------------------------
+    # REALTIME LINE GRAPH
+    # -------------------------
+    def realtime_graph(
+        self,
+        data_function,
+        interval=100
+    ):
+        """Draw a realtime graph"""
+        fig, ax = plt.subplots()
+
+        x_data = []
+        y_data = []
+
+        line, = ax.plot([], [])
+
+        def animate(frame):
+            value = data_function()
+
+            x_data.append(len(x_data))
+            y_data.append(value)
+
+            line.set_data(x_data, y_data)
+
+            ax.relim()
+            ax.autoscale_view()
+
+            return line,
+
+        FuncAnimation(
+            fig,
+            animate,
+            interval=interval,
+            cache_frame_data=False
+        )
+
+        plt.show()
+
+    # -------------------------
+    # SAVE FIGURE
+    # -------------------------
+    def save(
+        self,
+        filename="graph.png",
+        dpi=300
+    ):
+        """Save the graph to a file"""
+        plt.savefig(
+            filename,
+            dpi=dpi,
+            bbox_inches="tight"
+        )
+
+    # -------------------------
+    # 3D BAR GRAPH
+    # -------------------------
+    def bar_3d_graph(
+            self,
+            labels,
+            values,
+            color="skyblue",
+            show=True
+    ):
+        """Draw a 3D bar graph using only values."""
+
+        fig = plt.figure(figsize=self.figsize)
+        ax = fig.add_subplot(111, projection="3d")
+
+        x = np.arange(len(values))
+        y = np.zeros(len(values))
+        z = np.zeros(len(values))
+
+        dx = np.ones(len(values)) * 0.6
+        dy = np.ones(len(values)) * 0.6
+        dz = values
+
+        ax.bar3d(x, y, z, dx, dy, dz, color=color, shade=True)
+
+        ax.set_title(self.title)
+        ax.set_xlabel("Index")
+        ax.set_ylabel("")
+        ax.set_zlabel("Value")
+
+        if show:
+            plt.show()
+
+    # -------------------------
+    # 3D LINE GRAPH
+    # -------------------------
+    def line_3d_graph(
+            self,
+            values,
+            color="blue",
+            linewidth=2,
+            style="linear",
+            show=True
+    ):
+        """True 3D line graph using only values."""
+
+        fig = plt.figure(figsize=self.figsize)
+        ax = fig.add_subplot(111, projection="3d")
+
+        x = np.arange(len(values))
+
+        if style == "linear":
+            y = np.arange(len(values))  # depth axis
+        elif style == "wave":
+            y = np.sin(x / 2)  # wave motion depth
+        elif style == "spiral":
+            y = np.cos(x / 2)  # spiral-like variation
+        else:
+            y = np.arange(len(values))
+
+        z = np.array(values)
+
+        ax.plot(x, y, z, color=color, linewidth=linewidth)
+
+        ax.set_title(self.title)
+        ax.set_xlabel("Index (X)")
+        ax.set_ylabel("Depth (Y)")
+        ax.set_zlabel("Value (Z)")
+
+        if show:
+            plt.show()
+    # -------------------------
+    # 3D SCATTER GRAPH
+    # -------------------------
+    def scatter_3d_graph(
+            self,
+            values,
+            color="red",
+            size=50,
+            show=True
+    ):
+        """Draw a 3D scatter graph using only values."""
+
+        fig = plt.figure(figsize=self.figsize)
+        ax = fig.add_subplot(111, projection="3d")
+
+        x = np.arange(len(values))
+        y = np.random.rand(len(values))
+        z = np.array(values)
+
+        ax.scatter(x, y, z, c=color, s=size)
+
+        ax.set_title(self.title)
+        ax.set_xlabel("Index")
+        ax.set_ylabel("Spread")
+        ax.set_zlabel("Value")
+
+        if show:
+            plt.show()
+
+    # -------------------------
+    # 3D SURFACE GRAPH
+    # -------------------------
+    def surface_3d_graph(
+            self,
+            values,
+            cmap="viridis",
+            show=True
+    ):
+        """Draw a 3D surface graph from values."""
+
+        fig = plt.figure(figsize=self.figsize)
+        ax = fig.add_subplot(111, projection="3d")
+
+        x = np.arange(len(values))
+        y = np.arange(len(values))
+
+        X, Y = np.meshgrid(x, y)
+        Z = np.outer(values, np.ones(len(values)))
+
+        ax.plot_surface(X, Y, Z, cmap=cmap)
+
+        ax.set_title(self.title)
+
+        if show:
+            plt.show()
+
+    # -------------------------
+    # 3D WIREFRAME GRAPH
+    # -------------------------
+    def wireframe_3d_graph(
+            self,
+            values,
+            color="black",
+            show=True
+    ):
+        """Draw a 3D wireframe graph."""
+
+        fig = plt.figure(figsize=self.figsize)
+        ax = fig.add_subplot(111, projection="3d")
+
+        x = np.arange(len(values))
+        y = np.arange(len(values))
+
+        X, Y = np.meshgrid(x, y)
+        Z = np.outer(values, np.ones(len(values)))
+
+        ax.plot_wireframe(X, Y, Z, color=color)
+
+        ax.set_title(self.title)
+
+        if show:
+            plt.show()
+
+    # -------------------------
+    # 3D CONTOUR GRAPH
+    # -------------------------
+    def contour_3d_graph(
+            self,
+            values,
+            cmap="terrain",
+            show=True
+    ):
+        """Draw a 3D contour graph."""
+
+        fig = plt.figure(figsize=self.figsize)
+        ax = fig.add_subplot(111, projection="3d")
+
+        x = np.arange(len(values))
+        y = np.arange(len(values))
+
+        X, Y = np.meshgrid(x, y)
+        Z = np.outer(values, np.ones(len(values)))
+
+        ax.contour3D(X, Y, Z, 50, cmap=cmap)
+
+        ax.set_title(self.title)
+
+        if show:
+            plt.show()
+
+    # -------------------------
+    # 3D MOUNTAIN GRAPH
+    # -------------------------
+    def mountain_3d_graph(
+            self,
+            values,
+            cmap="terrain",
+            show=True
+    ):
+        """Draw a mountain-style 3D terrain graph."""
+
+        fig = plt.figure(figsize=self.figsize)
+        ax = fig.add_subplot(111, projection="3d")
+
+        x = np.arange(len(values))
+        y = np.linspace(0, 1, len(values))
+
+        X, Y = np.meshgrid(x, y)
+
+        Z = np.tile(values, (len(values), 1)).astype(float)
+
+        # add terrain-like variation
+        Z += np.sin(X / 2) * 0.5
+
+        ax.plot_surface(X, Y, Z, cmap=cmap, edgecolor="none")
+
+        ax.set_title(self.title)
+
+        if show:
+            plt.show()

cloudbian_helper/password.py

@@ -0,0 +1,14 @@
+from tkinter import *
+def start_password_entry(required="abcd1234"):
+    root = Tk()
+    root.title("Enter your password")
+    password = Entry(root, show="*")
+    password.pack()
+    def submit():
+        passw = password.get()
+        if passw == required:
+            return True
+        else:
+            return False
+    Button(root, text="Submit", command=submit).pack()
+    root.mainloop()

cloudbian_helper/test.py

@@ -0,0 +1,10 @@
+from graphics import Graphs
+from tkinter import colorchooser
+clr = colorchooser.askcolor()
+g = Graphs(title="Alpha", theme="ggplot")
+temperatures = [[0, 12, 45, 23],
+                [1, 12, 15, 20],
+                [20, 15, 12, 1]]
+g.heatmap(temperatures
+          ,color=str(clr[1]))
+g.histogram(temperatures)

cloudbian_helper-0.1.0.dist-info/METADATA

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: cloudbian-helper
+Version: 0.1.0
+Summary: 
+Author: CloudberryPiTechnologies
+Author-email: cloudberrypi1@outlook.com
+Requires-Python: >=3.14
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: matplotlib (>=3.10.9,<4.0.0)
+Description-Content-Type: text/markdown
+
+# Oops! Project under development

cloudbian_helper-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+cloudbian_helper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cloudbian_helper/graphics.adoc,sha256=bKmKawhiQI2yXAKAlu66trzhDxhxXvlAjJJnHvPnDz4,3770
+cloudbian_helper/graphics.py,sha256=YAYFJV-PGn6tcfyPaHWA0Is_JBgpBdh1OF672CD2-P4,12848
+cloudbian_helper/password.py,sha256=1_08sGyQ8CH00zKlyCOkJTq7wFw5z-qdZ8Uu5-MvzJE,396
+cloudbian_helper/test.py,sha256=5VVtJR1v9DTx7vsgO0wXqFSWDiNxu6wB2URCTk-ga_0,310
+cloudbian_helper-0.1.0.dist-info/METADATA,sha256=e16MkIINRGlG73_JUgFXC6DIJvfTh7V0qFxTqs_ft3k,385
+cloudbian_helper-0.1.0.dist-info/WHEEL,sha256=EGEvSphFYqXKs23-kQBeyNoJP1nrT8ZJKQoi5p5DYL8,88
+cloudbian_helper-0.1.0.dist-info/RECORD,,

cloudbian_helper-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.4.0
+Root-Is-Purelib: true
+Tag: py3-none-any