opsci-toolbox 0.0.6__py3-none-any.whl → 0.0.8__py3-none-any.whl

opsci_toolbox/helpers/dataviz.py

@@ -373,7 +373,7 @@ def get_convex_hull_coord(points: np.array, interpolate_curve: bool = True) -> t
 
 #     return fig
 
-def create_scatter_plot(df: pd.DataFrame, col_x: str, col_y: str, col_category: str, color_palette: dict, col_color: str, col_size: str, col_text: str, col_legend: list = [], title: str = "Scatter Plot", x_axis_label: str = "X-axis", y_axis_label: str = "Y-axis", width: int = 1000, height: int = 1000, xaxis_range: list =None, yaxis_range: list =None, size_value: int = 4, opacity: float = 0.8, maxdisplayed: int = 0, mode: str = "markers", textposition: str = "bottom center", plot_bgcolor: str = None, paper_bgcolor: str = None, yaxis_showgrid: bool = False, xaxis_showgrid: bool = False, color: str = "indianred", line_width: float = 0.5, line_color: str = "white", colorscale: str = 'Viridis', showscale: bool = True, template: str = "plotly") -> go.Figure:
+def create_scatter_plot(df: pd.DataFrame, col_x: str, col_y: str, col_category: str, color_palette: dict, col_color: str, col_size: str, col_text: str, col_legend: list = [], title: str = "Scatter Plot", x_axis_label: str = "X-axis", y_axis_label: str = "Y-axis", width: int = 1000, height: int = 1000, xaxis_range: list =None, yaxis_range: list =None, size_value: int = 4, opacity: float = 0.8, maxdisplayed: int = 0, mode: str = "markers", textposition: str = "bottom center", plot_bgcolor: str = None, paper_bgcolor: str = None, yaxis_showgrid: bool = False, xaxis_showgrid: bool = False, color: str = "indianred", line_width: float = 0.5, line_color: str = "white", colorscale: str = 'Viridis', showscale: bool = True, template: str = "plotly", font_size:int =16) -> go.Figure:
     """
     Create a scatter plot.
 
@@ -522,7 +522,8 @@ def create_scatter_plot(df: pd.DataFrame, col_x: str, col_y: str, col_category:
         template=template,
         plot_bgcolor=plot_bgcolor,    #background color (plot)
         paper_bgcolor=paper_bgcolor,   #background color (around plot)
-        font_family="Segoe UI Semibold",           # font
+        font_family="Inria Sans",           # font
+        font_size=font_size
 
     )
     return fig
@@ -557,7 +558,7 @@ def add_annotations(fig: go.Figure, df: pd.DataFrame, col_x: str, col_y: str, co
             showarrow=True,
             arrowhead=1,
             font=dict(
-                family="Helvetica, Sans-serif",
+                family="Inria Sans",
                 size=width / label_size_ratio,
                 color=font_color
             ),
@@ -571,7 +572,7 @@ def add_annotations(fig: go.Figure, df: pd.DataFrame, col_x: str, col_y: str, co
 
     return fig
 
-def scatter3D(df: pd.DataFrame, col_x: str, col_y: str, col_z: str, col_category: str, color_palette: dict, col_size: str, col_text: str, title: str = "3D Scatter Plot", x_axis_label: str = "X-axis", y_axis_label: str = "Y-axis", z_axis_label: str = "Z-axis", width: int = 1000, height: int = 1000, xaxis_range: list = None, yaxis_range: list = None, zaxis_range: list = None, size_value: int = 4, opacity: float = 0.8, plot_bgcolor: str = None, paper_bgcolor: str = None, color: str = "indianred", line_width: float = 0.5, line_color: str = "white", template: str = "plotly") -> go.Figure:
+def scatter3D(df: pd.DataFrame, col_x: str, col_y: str, col_z: str, col_category: str, color_palette: dict, col_size: str, col_text: str, title: str = "3D Scatter Plot", x_axis_label: str = "X-axis", y_axis_label: str = "Y-axis", z_axis_label: str = "Z-axis", width: int = 1000, height: int = 1000, xaxis_range: list = None, yaxis_range: list = None, zaxis_range: list = None, size_value: int = 4, opacity: float = 0.8, plot_bgcolor: str = None, paper_bgcolor: str = None, color: str = "indianred", line_width: float = 0.5, line_color: str = "white", template: str = "plotly", font_size:int =16) -> go.Figure:
     """
     Create a 3D scatter plot.
 
@@ -677,7 +678,8 @@ def scatter3D(df: pd.DataFrame, col_x: str, col_y: str, col_z: str, col_category
         zaxis_range = [df[col_z].min()-0.1,df[col_z].max()+0.1]
     fig.update_layout(
         
-        font_family="Segoe UI Semibold",           # font
+        font_family="Inria Sans",           # font
+        font_size = font_size,
         title=title,                  #graph title
         xaxis_title=x_axis_label,     #xaxis title
         yaxis_title=y_axis_label,     #yaxis title
@@ -723,7 +725,7 @@ def scatter3D(df: pd.DataFrame, col_x: str, col_y: str, col_z: str, col_category
     return fig
     
 
-def fig_bar_trend(df: pd.DataFrame, col_x: str, bar_measure: str, trend_measure: str, x_name: str = "X", bar_name: str = "metric1", trend_name: str = "metric2", marker_color: str = 'lightpink', line_color: str = 'indianred', title_text: str = "Couverture & Résonance", width: int = 1500, height: int = 700, xaxis_tickangle: int = 0, opacity: float = 0.8, plot_bgcolor: str = None, paper_bgcolor: str = None, template: str = "plotly") -> go.Figure:
+def fig_bar_trend(df: pd.DataFrame, col_x: str, bar_measure: str, trend_measure: str, x_name: str = "X", bar_name: str = "metric1", trend_name: str = "metric2", marker_color: str = '#d399ff', line_color: str = '#bd66ff', title_text: str = "Couverture & Résonance", width: int = 1500, height: int = 700, xaxis_tickangle: int = 0, opacity: float = 0.8, plot_bgcolor: str = None, paper_bgcolor: str = None, template: str = "plotly", font_size:int =16) -> go.Figure:
     """
     Display a graph that combines bar and trend chart to compare 2 metrics.
 
@@ -800,7 +802,8 @@ def fig_bar_trend(df: pd.DataFrame, col_x: str, bar_measure: str, trend_measure:
         xaxis_showgrid=False,
         yaxis_showline=False,
         yaxis_showgrid=False,
-        font_family="Segoe UI Semibold",
+        font_family="Inria Sans",
+        font_size = font_size,
         template=template,
         plot_bgcolor=plot_bgcolor,    #background color (plot)
         paper_bgcolor=paper_bgcolor,   #background color (around plot)
@@ -932,7 +935,8 @@ def density_map(df_posts: pd.DataFrame,
                 opacity: float = 0.3,
                 plot_bgcolor: str = None,
                 paper_bgcolor: str = None,
-                template: str = "plotly") -> go.Figure:
+                template: str = "plotly",
+                font_size:int = 16) -> go.Figure:
     """
     Display a 2D histogram with contours and scattered dots.
 
@@ -944,7 +948,7 @@ def density_map(df_posts: pd.DataFrame,
         col_engagement (str): Column name corresponding to a metric.
         col_text (str): Column name corresponding to a text separated by |.
         col_text_dots (str): Column name corresponding to the text for dots.
-        colorscale (str, optional): Possible values are https://plotly.com/python/builtin-colorscales/. Defaults to "Portland".
+        colorscale (str, optional): Possible values are 'https://plotly.com/python/builtin-colorscales/'. Defaults to "Portland".
         marker_color (str, optional): Dots color value. Defaults to "#ff7f0e".
         arrow_color (str, optional): Arrow pointing to topic centroid color value. Defaults to "#ff7f0e".
         width (int, optional): Width of the plot. Defaults to 1000.
@@ -996,15 +1000,16 @@ def density_map(df_posts: pd.DataFrame,
 
     #paramètres cosmetiques
     fig_density.update_layout(
-                font_size=25,
+                font_family="Inria Sans",           # font
+                font_size = font_size,
                 width=width,
                 height=height,
-                margin=dict(
-                    t=width / 15,
-                    b=width / 25,
-                    r=width / 25,
-                    l=width / 25,
-                ),
+                # margin=dict(
+                #     t=width / 15,
+                #     b=width / 25,
+                #     r=width / 25,
+                #     l=width / 25,
+                # ),
                 title=dict(text=title_text, font=dict(size=width / 40)),
                 xaxis=dict(showline=False, zeroline=False, showgrid=False, showticklabels=False),
                 yaxis=dict(showline=False, zeroline=False, showgrid=False, showticklabels=False),
@@ -1045,7 +1050,7 @@ def density_map(df_posts: pd.DataFrame,
                 showarrow=True,
                 arrowhead=1,
                 font=dict(
-                    family="Segoe UI Semibold",
+                    family="Inria Sans",
                     size=width / label_size_ratio,
                     color="blue",
                 ),
@@ -1089,7 +1094,8 @@ def topic_heatmap(df: pd.DataFrame,
                   col_y: str = "topic_y",
                   col_topic: str = "soft_topic",
                   color_continuous_scale: str = 'GnBu',
-                  title: str = "Similarity between topics") -> go.Figure:
+                  title: str = "Similarity between topics", 
+                  font_size:int = 16) -> go.Figure:
     """
     Display a heatmap representing the similarity between topics.
 
@@ -1115,6 +1121,8 @@ def topic_heatmap(df: pd.DataFrame,
                         )
 
     fig.update_layout(
+        font_family="Inria Sans",           # font
+        font_size = font_size,
         title={
             'text': title,
             'y': .95,
@@ -1129,8 +1137,8 @@ def topic_heatmap(df: pd.DataFrame,
         height=1000,
         hoverlabel=dict(
             bgcolor="white",
-            font_size=16,
-            font_family="Rockwell"
+            font_family="Inria Sans",           # font
+            font_size = font_size,
         ),
     )
     fig.update_layout(showlegend=True)
@@ -1144,7 +1152,7 @@ def generate_wordcloud(df: pd.DataFrame,
                        height: int = 1500,
                        dpi: int = 300,
                        background_color: str = 'white',
-                       font_path: str = "font/SEGUIEMJ.TTF",
+                       font_path: str = "font/InriaSans-Bold.ttf",
                        colormap: str = "Viridis",
                        show: bool = False) -> WordCloud:
     """
@@ -1186,7 +1194,8 @@ def create_radar(df: pd.DataFrame,
                  height: int = 1000,
                  template: str = "ggplot2",
                  plot_bgcolor: str = None,
-                 paper_bgcolor: str = None) -> go.Figure:
+                 paper_bgcolor: str = None,
+                 font_size:int = 16) -> go.Figure:
     """
     Create a radar chart.
 
@@ -1241,7 +1250,8 @@ def create_radar(df: pd.DataFrame,
                 # bgcolor="white",
                 ),
         showlegend=True,
-        font_family="Segoe UI Semibold",
+        font_family="Inria Sans",
+        font_size = 16,
         font_color="SlateGrey",
         title=title,             
         width=width,                  #plot size
@@ -1271,7 +1281,8 @@ def bar_subplots(df: pd.DataFrame,
                  height: int = 35,
                  plot_bgcolor: str = None,
                  paper_bgcolor: str = None,
-                 showlegend: bool = True) -> go.Figure:
+                 showlegend: bool = True,
+                 font_size:int=16) -> go.Figure:
     """
     Create subplots of horizontal bar charts.
 
@@ -1373,7 +1384,8 @@ def bar_subplots(df: pd.DataFrame,
         uniformtext_minsize=7,                     # Adjust the minimum size of text to avoid overlap
         margin=dict(l=75, r=75, t=75, b=50),       # margins around the plot
         showlegend=showlegend,                     # legend display
-        font_family="Segoe UI Semibold",           # font
+        font_family="Inria Sans",           # font
+        font_size=font_size,
         template=template,                         # template, possible values : plotly, plotly_white, plotly_dark, ggplot2, seaborn, simple_white, none
         plot_bgcolor=plot_bgcolor,                 # background color (plot)
         paper_bgcolor=paper_bgcolor,               # background color (around plot)
@@ -1407,7 +1419,8 @@ def pie_subplots(df: pd.DataFrame,
                  height: int = 150,
                  plot_bgcolor: str = None,
                  paper_bgcolor: str = None,
-                 showlegend: bool = True) -> go.Figure:
+                 showlegend: bool = True,
+                 font_size=16) -> go.Figure:
     """
     Create subplots of pie charts.
 
@@ -1476,7 +1489,8 @@ def pie_subplots(df: pd.DataFrame,
         uniformtext_minsize=7,
         margin=dict(l=75, r=75, t=75, b=50),
         showlegend=showlegend,
-        font_family="Segoe UI Semibold",
+        font_family="Inria Sans",
+        font_size=font_size,
         template=template,
         plot_bgcolor=plot_bgcolor,
         paper_bgcolor=paper_bgcolor,
@@ -1510,7 +1524,8 @@ def horizontal_stacked_bars(df: pd.DataFrame,
                              vertical_spacing: float = 0.08,
                              plot_bgcolor: str = None,
                              paper_bgcolor: str = None,
-                             template: str = "plotly") -> go.Figure:
+                             template: str = "plotly",
+                             font_size: int = 16) -> go.Figure:
     """
     Create horizontal stacked bar plots.
 
@@ -1597,7 +1612,8 @@ def horizontal_stacked_bars(df: pd.DataFrame,
             yaxis_showgrid=False,
             uniformtext_minsize=8,
             uniformtext_mode='hide',
-            font_family="Segoe UI Semibold",
+            font_family="Inria Sans",
+            font_size=font_size,
             template=template,
             plot_bgcolor=plot_bgcolor,    #background color (plot)
             paper_bgcolor=paper_bgcolor,   #background color (around plot)
@@ -1624,7 +1640,8 @@ def bar_trend_per_day(df: pd.DataFrame,
                       line_color: str = "#273746", 
                       plot_bgcolor: str = None, 
                       paper_bgcolor: str = None, 
-                      template: str = "plotly") -> go.Figure:
+                      template: str = "plotly",
+                      font_size: int = 16) -> go.Figure:
     """
     Creates a Plotly stacked bar chart with a secondary line plot for two metrics over time.
 
@@ -1694,7 +1711,8 @@ def bar_trend_per_day(df: pd.DataFrame,
         yaxis_showgrid=False,
         uniformtext_minsize=8,
         uniformtext_mode='hide',
-        font_family="Segoe UI Semibold",
+        font_family="Inria Sans",
+        font_size=font_size,
         template=template,
         plot_bgcolor=plot_bgcolor,    #background color (plot)
         paper_bgcolor=paper_bgcolor,   #background color (around plot)
@@ -1731,30 +1749,31 @@ def bar_trend_per_day_per_cat(df: pd.DataFrame,
                               height: int = 700, 
                               plot_bgcolor: str = None, 
                               paper_bgcolor: str = None, 
-                              template: str = "plotly") -> go.Figure:
+                              template: str = "plotly",
+                              font_size: int = 16) -> go.Figure:
     """
     Creates a Plotly stacked bar chart with multiple categories, each represented as a separate subplot.
 
-    Parameters:
-    - df (pd.DataFrame): The DataFrame containing the data.
-    - col_date (str): The name of the column containing dates.
-    - col_cat (str): The name of the column containing categories.
-    - col_metric1 (str): The name of the column containing the first metric values.
-    - col_metric2 (str): The name of the column containing the second metric values.
-    - col_color (str): The name of the column containing the color codes for each category.
-    - xaxis_title (str, optional): The title for the x-axis. Defaults to "Date".
-    - y1_axis_title (str, optional): The title for the primary y-axis. Defaults to "Verbatims".
-    - y2_axis_title (str, optional): The title for the secondary y-axis. Defaults to "Engagements".
-    - title_text (str, optional): The title text for the chart. Defaults to "Trend - couverture & résonance".
-    - vertical_spacing (float, optional): The space between subplots. Defaults to 0.1.
-    - width (int, optional): The width of the chart. Defaults to 1500.
-    - height (int, optional): The height of the chart. Defaults to 700.
-    - plot_bgcolor (str, optional): The background color of the plot area. Defaults to None.
-    - paper_bgcolor (str, optional): The background color of the paper area. Defaults to None.
-    - template (str, optional): The template of the chart. Defaults to "plotly".
+    Args:
+        df (pd.DataFrame): The DataFrame containing the data.
+        col_date (str): The name of the column containing dates.
+        col_cat (str): The name of the column containing categories.
+        col_metric1 (str): The name of the column containing the first metric values.
+        col_metric2 (str): The name of the column containing the second metric values.
+        col_color (str): The name of the column containing the color codes for each category.
+        xaxis_title (str, optional): The title for the x-axis. Defaults to "Date".
+        y1_axis_title (str, optional): The title for the primary y-axis. Defaults to "Verbatims".
+        y2_axis_title (str, optional): The title for the secondary y-axis. Defaults to "Engagements".
+        title_text (str, optional): The title text for the chart. Defaults to "Trend - couverture & résonance".
+        vertical_spacing (float, optional): The space between subplots. Defaults to 0.1.
+        width (int, optional): The width of the chart. Defaults to 1500.
+        height (int, optional): The height of the chart. Defaults to 700.
+        plot_bgcolor (str, optional): The background color of the plot area. Defaults to None.
+        paper_bgcolor (str, optional): The background color of the paper area. Defaults to None.
+        template (str, optional): The template of the chart. Defaults to "plotly".
 
     Returns:
-    - fig (go.Figure): The Plotly Figure object representing the stacked bar chart with subplots for each category.
+        fig (go.Figure): The Plotly Figure object representing the stacked bar chart with subplots for each category.
     """
     fig = make_subplots(
         rows = 2,                           # number of rows
@@ -1812,7 +1831,8 @@ def bar_trend_per_day_per_cat(df: pd.DataFrame,
             yaxis_showgrid=False,
             uniformtext_minsize=8,
             uniformtext_mode='hide',
-            font_family="Segoe UI Semibold",
+            font_family="Inria Sans",
+            font_size=font_size,
             template=template,
             plot_bgcolor=plot_bgcolor,    #background color (plot)
             paper_bgcolor=paper_bgcolor,   #background color (around plot)
@@ -1846,25 +1866,26 @@ def pie(df: pd.DataFrame,
         height: int = 1000, 
         plot_bgcolor: str = None, 
         paper_bgcolor: str = None, 
-        showlegend: bool = True) -> go.Figure:
+        showlegend: bool = True,
+        font_size: int = 16) -> go.Figure:
     """
     Creates a Plotly pie chart.
 
-    Parameters:
-    - df (pd.DataFrame): The DataFrame containing the data.
-    - col_x (str): The name of the column containing the labels for the pie chart slices.
-    - col_y (str): The name of the column containing the values for the pie chart slices.
-    - col_color (str): The name of the column containing the colors for the pie chart slices.
-    - title (str, optional): The title for the pie chart. Defaults to "Sentiment".
-    - template (str, optional): The template of the chart. Defaults to "plotly".
-    - width (int, optional): The width of the chart. Defaults to 1000.
-    - height (int, optional): The height of the chart. Defaults to 1000.
-    - plot_bgcolor (str, optional): The background color of the plot area. Defaults to None.
-    - paper_bgcolor (str, optional): The background color of the paper area. Defaults to None.
-    - showlegend (bool, optional): Whether to show the legend. Defaults to True.
+    Args:
+        df (pd.DataFrame): The DataFrame containing the data.
+        col_x (str): The name of the column containing the labels for the pie chart slices.
+        col_y (str): The name of the column containing the values for the pie chart slices.
+        col_color (str): The name of the column containing the colors for the pie chart slices.
+        title (str, optional): The title for the pie chart. Defaults to "Sentiment".
+        template (str, optional): The template of the chart. Defaults to "plotly".
+        width (int, optional): The width of the chart. Defaults to 1000.
+        height (int, optional): The height of the chart. Defaults to 1000.
+        plot_bgcolor (str, optional): The background color of the plot area. Defaults to None.
+        paper_bgcolor (str, optional): The background color of the paper area. Defaults to None.
+        showlegend (bool, optional): Whether to show the legend. Defaults to True.
 
     Returns:
-    - fig (go.Figure): The Plotly Figure object representing the pie chart.
+        fig (go.Figure): The Plotly Figure object representing the pie chart.
     """    
     fig = go.Figure()
     fig.add_trace(go.Pie(
@@ -1886,7 +1907,8 @@ def pie(df: pd.DataFrame,
         uniformtext_minsize=7,
         margin=dict(l=75, r=75, t=75, b=50),
         showlegend=showlegend,
-        font_family="Segoe UI Semibold",
+        font_family="Inria Sans",
+        font_size=font_size,
         template=template,
         plot_bgcolor=plot_bgcolor,
         paper_bgcolor=paper_bgcolor,
@@ -1916,27 +1938,30 @@ def bar(df: pd.DataFrame,
         plot_bgcolor: str = None, 
         paper_bgcolor: str = None, 
         template: str = "plotly", 
-        showlegend: bool = True) -> go.Figure:
+        showlegend: bool = True,
+        font_size: int = 16,
+        xaxis_tickangle:int=0) -> go.Figure:
     """
     Creates a Plotly vertical bar chart.
 
-    Parameters:
-    - df (pd.DataFrame): The DataFrame containing the data.
-    - x (str): The name of the column containing the x-axis values.
-    - y (str): The name of the column containing the y-axis values.
-    - color (str, optional): The color of the bars. Defaults to "indianred".
-    - xaxis_title (str, optional): The title for the x-axis. Defaults to "x".
-    - yaxis_title (str, optional): The title for the y-axis. Defaults to "y".
-    - width (int, optional): The width of the chart. Defaults to 1200.
-    - height (int, optional): The height of the chart. Defaults to 700.
-    - title_text (str, optional): The title text for the chart. Defaults to "".
-    - plot_bgcolor (str, optional): The background color of the plot area. Defaults to None.
-    - paper_bgcolor (str, optional): The background color of the paper area. Defaults to None.
-    - template (str, optional): The template of the chart. Defaults to "plotly".
-    - showlegend (bool, optional): Whether to show the legend. Defaults to True.
+    Args:
+        df (pd.DataFrame): The DataFrame containing the data.
+        x (str): The name of the column containing the x-axis values.
+        y (str): The name of the column containing the y-axis values.
+        color (str, optional): The color of the bars. Defaults to "indianred".
+        xaxis_title (str, optional): The title for the x-axis. Defaults to "x".
+        yaxis_title (str, optional): The title for the y-axis. Defaults to "y".
+        width (int, optional): The width of the chart. Defaults to 1200.
+        height (int, optional): The height of the chart. Defaults to 700.
+        title_text (str, optional): The title text for the chart. Defaults to "".
+        plot_bgcolor (str, optional): The background color of the plot area. Defaults to None.
+        paper_bgcolor (str, optional): The background color of the paper area. Defaults to None.
+        template (str, optional): The template of the chart. Defaults to "plotly".
+        showlegend (bool, optional): Whether to show the legend. Defaults to True.
+        xaxis_tickangle (int, optional) : label angle on x axis
 
     Returns:
-    - fig (go.Figure): The Plotly Figure object representing the vertical bar chart.
+        fig (go.Figure): The Plotly Figure object representing the vertical bar chart.
     """
     fig = go.Figure()
     fig.add_trace(
@@ -1959,14 +1984,15 @@ def bar(df: pd.DataFrame,
         showlegend=showlegend,
         width = width,
         height= height,
-        xaxis_tickangle=0,
+        xaxis_tickangle=xaxis_tickangle,
         xaxis_showline=False,
         xaxis_showgrid=False,
         yaxis_showline=False,
         yaxis_showgrid=False,
         uniformtext_minsize=8,
         uniformtext_mode='hide',
-        font_family="Segoe UI Semibold",
+        font_family="Inria Sans",
+        font_size = font_size,
         template=template,
         plot_bgcolor=plot_bgcolor,    #background color (plot)
         paper_bgcolor=paper_bgcolor,   #background color (around plot)
@@ -1984,17 +2010,17 @@ def add_horizontal_line(fig: go.Figure,
     """
     Adds a horizontal line to a Plotly Figure object.
 
-    Parameters:
-    - fig (go.Figure): The Plotly Figure object to which the horizontal line will be added.
-    - y (float): The y-coordinate of the horizontal line.
-    - line_color (str, optional): The color of the horizontal line. Defaults to "gray".
-    - line_width (float, optional): The width of the horizontal line. Defaults to 1.5.
-    - line_dash (str, optional): The dash style of the horizontal line. Defaults to "dash".
-    - annotation_text (str, optional): The text annotation associated with the horizontal line. Defaults to "Longueur moyenne des textes".
-    - annotation_position (str, optional): The position of the annotation relative to the horizontal line. Defaults to "top right".
+    Args:
+        fig (go.Figure): The Plotly Figure object to which the horizontal line will be added.
+        y (float): The y-coordinate of the horizontal line.
+        line_color (str, optional): The color of the horizontal line. Defaults to "gray".
+        line_width (float, optional): The width of the horizontal line. Defaults to 1.5.
+        line_dash (str, optional): The dash style of the horizontal line. Defaults to "dash".
+        annotation_text (str, optional): The text annotation associated with the horizontal line. Defaults to "Longueur moyenne des textes".
+        annotation_position (str, optional): The position of the annotation relative to the horizontal line. Defaults to "top right".
 
     Returns:
-    - fig (go.Figure): The Plotly Figure object with the horizontal line added.
+        fig (go.Figure): The Plotly Figure object with the horizontal line added.
     """    
     fig.add_hline(
         y=y, 
@@ -2016,17 +2042,17 @@ def add_vertical_line(fig: go.Figure,
     """
     Adds a vertical line to a Plotly Figure object.
 
-    Parameters:
-    - fig (go.Figure): The Plotly Figure object to which the vertical line will be added.
-    - x (float): The x-coordinate of the vertical line.
-    - line_color (str, optional): The color of the vertical line. Defaults to "gray".
-    - line_width (float, optional): The width of the vertical line. Defaults to 1.5.
-    - line_dash (str, optional): The dash style of the vertical line. Defaults to "dash".
-    - annotation_text (str, optional): The text annotation associated with the vertical line. Defaults to "Longueur moyenne des textes".
-    - annotation_position (str, optional): The position of the annotation relative to the vertical line. Defaults to "top right".
+    Args:
+        fig (go.Figure): The Plotly Figure object to which the vertical line will be added.
+        x (float): The x-coordinate of the vertical line.
+        line_color (str, optional): The color of the vertical line. Defaults to "gray".
+        line_width (float, optional): The width of the vertical line. Defaults to 1.5.
+        line_dash (str, optional): The dash style of the vertical line. Defaults to "dash".
+        annotation_text (str, optional): The text annotation associated with the vertical line. Defaults to "Longueur moyenne des textes".
+        annotation_position (str, optional): The position of the annotation relative to the vertical line. Defaults to "top right".
 
     Returns:
-    - fig (go.Figure): The Plotly Figure object with the vertical line added.
+        fig (go.Figure): The Plotly Figure object with the vertical line added.
     """
     fig.add_vline(
         x=x, 
@@ -2059,28 +2085,28 @@ def network_graph(T: nx.Graph,
     """
     Creates a network graph visualization using Plotly.
 
-    Parameters:
-    - T (nx.Graph): The NetworkX graph object.
-    - col_size (str, optional): The column name for node size. Defaults to "scaled_size".
-    - col_color (str, optional): The column name for node color. Defaults to "modularity_color".
-    - title_text (str, optional): The title for the graph. Defaults to "Analyse de similitudes".
-    - sample_nodes (float, optional): The proportion of nodes to sample for displaying labels. Defaults to 0.15.
-    - show_edges (bool, optional): Whether to display edges. Defaults to True.
-    - show_halo (bool, optional): Whether to display halo around nodes. Defaults to False.
-    - textposition (str, optional): The position of node labels. Defaults to None.
-    - line_color (str, optional): The color of edges. Defaults to "#B7B7B7".
-    - line_dash (str, optional): The dash style of edges. Defaults to "dot".
-    - edge_mode (str, optional): The mode for displaying edges. Defaults to "lines+markers".
-    - node_mode (str, optional): The mode for displaying nodes. Defaults to "markers+text".
-    - opacity (float, optional): The opacity of nodes. Defaults to 0.2.
-    - width (int, optional): The width of the plot. Defaults to 1600.
-    - height (int, optional): The height of the plot. Defaults to 1200.
-    - plot_bgcolor (str, optional): The background color of the plot area. Defaults to None.
-    - paper_bgcolor (str, optional): The background color of the paper area. Defaults to None.
-    - template (str, optional): The template of the plot. Defaults to "plotly".
+    Args:
+        T (nx.Graph): The NetworkX graph object.
+        col_size (str, optional): The column name for node size. Defaults to "scaled_size".
+        col_color (str, optional): The column name for node color. Defaults to "modularity_color".
+        title_text (str, optional): The title for the graph. Defaults to "Analyse de similitudes".
+        sample_nodes (float, optional): The proportion of nodes to sample for displaying labels. Defaults to 0.15.
+        show_edges (bool, optional): Whether to display edges. Defaults to True.
+        show_halo (bool, optional): Whether to display halo around nodes. Defaults to False.
+        textposition (str, optional): The position of node labels. Defaults to None.
+        line_color (str, optional): The color of edges. Defaults to "#B7B7B7".
+        line_dash (str, optional): The dash style of edges. Defaults to "dot".
+        edge_mode (str, optional): The mode for displaying edges. Defaults to "lines+markers".
+        node_mode (str, optional): The mode for displaying nodes. Defaults to "markers+text".
+        opacity (float, optional): The opacity of nodes. Defaults to 0.2.
+        width (int, optional): The width of the plot. Defaults to 1600.
+        height (int, optional): The height of the plot. Defaults to 1200.
+        plot_bgcolor (str, optional): The background color of the plot area. Defaults to None.
+        paper_bgcolor (str, optional): The background color of the paper area. Defaults to None.
+        template (str, optional): The template of the plot. Defaults to "plotly".
 
     Returns:
-    - fig (go.Figure): The Plotly Figure object representing the network graph visualization.
+        fig (go.Figure): The Plotly Figure object representing the network graph visualization.
     """    
     # on construit un dataframe des noeuds à partir des données du graphe pour plus de simplicité
     df_nodes=pd.DataFrame()
@@ -2170,7 +2196,7 @@ def network_graph(T: nx.Graph,
             hovermode='closest',
             title=title_text,
             titlefont_size=18,
-            font_family="Segoe UI Semibold",
+            font_family="Inria Sans",
             # font_size = 12,
             # uniformtext_minsize=8,
             template=template,
@@ -2198,19 +2224,20 @@ def richesse_lexicale(df: pd.DataFrame,
                       title: str = "Richesse lexicale", 
                       width: int = 1200, 
                       height: int = 1000, 
-                      template: str = "plotly") -> go.Figure:
+                      template: str = "plotly",
+                      font_size: int = 16) -> go.Figure:
     """
     Creates a lexical richness visualization using Plotly.
 
-    Parameters:
-    - df (pd.DataFrame): The DataFrame containing word frequency data.
-    - title (str, optional): The title for the plot. Defaults to "Richesse lexicale".
-    - width (int, optional): The width of the plot. Defaults to 1200.
-    - height (int, optional): The height of the plot. Defaults to 1000.
-    - template (str, optional): The template of the plot. Defaults to "plotly".
+    Args:
+        df (pd.DataFrame): The DataFrame containing word frequency data.
+        title (str, optional): The title for the plot. Defaults to "Richesse lexicale".
+        width (int, optional): The width of the plot. Defaults to 1200.
+        height (int, optional): The height of the plot. Defaults to 1000.
+        template (str, optional): The template of the plot. Defaults to "plotly".
 
     Returns:
-    - fig_richesse (go.Figure): The Plotly Figure object representing the lexical richness visualization.
+        fig_richesse (go.Figure): The Plotly Figure object representing the lexical richness visualization.
     """
     df = create_frequency_table(df, "freq")
     fig_richesse = go.Figure()
@@ -2225,6 +2252,8 @@ def richesse_lexicale(df: pd.DataFrame,
             ) 
     fig_richesse.update_layout(title=title, 
                             xaxis_title="Rank", 
+                            font_family="Inria Sans",
+                            font_size = font_size,
                             width=width, 
                             height=height,
                             template=template)    
@@ -2237,20 +2266,21 @@ def richesse_lexicale_per_topic(df: pd.DataFrame,
                                 title: str = "Richesse lexicale par topic", 
                                 width: int = 1200, 
                                 height: int = 1000, 
-                                template: str = "plotly") -> go.Figure:
+                                template: str = "plotly",
+                                font_size: int = 16) -> go.Figure:
     """
     Creates a lexical richness visualization per topic using Plotly.
 
-    Parameters:
-    - df (pd.DataFrame): The DataFrame containing word frequency data.
-    - col_topic (str): The name of the column representing topics.
-    - title (str, optional): The title for the plot. Defaults to "Richesse lexicale par topic".
-    - width (int, optional): The width of the plot. Defaults to 1200.
-    - height (int, optional): The height of the plot. Defaults to 1000.
-    - template (str, optional): The template of the plot. Defaults to "plotly".
+    Args:
+        df (pd.DataFrame): The DataFrame containing word frequency data.
+        col_topic (str): The name of the column representing topics.
+        title (str, optional): The title for the plot. Defaults to "Richesse lexicale par topic".
+        width (int, optional): The width of the plot. Defaults to 1200.
+        height (int, optional): The height of the plot. Defaults to 1000.
+        template (str, optional): The template of the plot. Defaults to "plotly".
 
     Returns:
-    - fig_richesse (go.Figure): The Plotly Figure object representing the lexical richness visualization per topic.
+        fig_richesse (go.Figure): The Plotly Figure object representing the lexical richness visualization per topic.
     """
     fig_richesse = go.Figure()
     for topic in list(df[col_topic].unique()):
@@ -2266,6 +2296,8 @@ def richesse_lexicale_per_topic(df: pd.DataFrame,
                 ) 
         fig_richesse.update_layout(title=title, 
                                 xaxis_title="Rank", 
+                                font_family="Inria Sans",
+                                font_size = font_size,
                                 width=width, 
                                 height=height,
                                 template=template)    
@@ -2286,28 +2318,29 @@ def subplots_bar_per_day_per_cat(df: pd.DataFrame,
                                  height: int = 700, 
                                  plot_bgcolor: str = None, 
                                  paper_bgcolor: str = None, 
-                                 template: str = "plotly") -> go.Figure:
+                                 template: str = "plotly",
+                                 font_size: int = 16) -> go.Figure:
     """
     Creates subplots of stacked bar charts per day and category using Plotly.
 
-    Parameters:
-    - df (pd.DataFrame): The DataFrame containing the data.
-    - col_date (str): The name of the column representing dates.
-    - col_cat (str): The name of the column representing categories.
-    - metrics (List[str]): A list of column names representing metrics to be plotted.
-    - col_color (str): The name of the column representing colors for bars.
-    - y_axis_titles (List[str]): A list of titles for the y-axes of subplots.
-    - xaxis_title (str, optional): The title for the x-axis. Defaults to "Date".
-    - title_text (str, optional): The title for the entire plot. Defaults to "Trend - couverture & résonance".
-    - vertical_spacing (float, optional): The space between subplots. Defaults to 0.1.
-    - width (int, optional): The width of the entire plot. Defaults to 1500.
-    - height (int, optional): The height of each subplot. Defaults to 700.
-    - plot_bgcolor (str, optional): The background color for the plot area. Defaults to None.
-    - paper_bgcolor (str, optional): The background color for the paper area. Defaults to None.
-    - template (str, optional): The template of the plot. Defaults to "plotly".
+    Args:
+        df (pd.DataFrame): The DataFrame containing the data.
+        col_date (str): The name of the column representing dates.
+        col_cat (str): The name of the column representing categories.
+        metrics (List[str]): A list of column names representing metrics to be plotted.
+        col_color (str): The name of the column representing colors for bars.
+        y_axis_titles (List[str]): A list of titles for the y-axes of subplots.
+        xaxis_title (str, optional): The title for the x-axis. Defaults to "Date".
+        title_text (str, optional): The title for the entire plot. Defaults to "Trend - couverture & résonance".
+        vertical_spacing (float, optional): The space between subplots. Defaults to 0.1.
+        width (int, optional): The width of the entire plot. Defaults to 1500.
+        height (int, optional): The height of each subplot. Defaults to 700.
+        plot_bgcolor (str, optional): The background color for the plot area. Defaults to None.
+        paper_bgcolor (str, optional): The background color for the paper area. Defaults to None.
+        template (str, optional): The template of the plot. Defaults to "plotly".
 
     Returns:
-    - fig (go.Figure): The Plotly Figure object representing the subplots of stacked bar charts.
+        fig (go.Figure): The Plotly Figure object representing the subplots of stacked bar charts.
     """
     fig = make_subplots(
         rows = len(metrics),                           # number of rows
@@ -2357,7 +2390,8 @@ def subplots_bar_per_day_per_cat(df: pd.DataFrame,
             yaxis_showgrid=False,
             uniformtext_minsize=8,
             uniformtext_mode='hide',
-            font_family="Segoe UI Semibold",
+            font_family="Inria Sans",
+            font_size=font_size,
             template=template,
             plot_bgcolor=plot_bgcolor,    #background color (plot)
             paper_bgcolor=paper_bgcolor,   #background color (around plot)
@@ -2399,22 +2433,22 @@ def add_shape(fig: go.Figure,
     """
     Adds a shape to a Plotly figure.
 
-    Parameters:
-    - fig (go.Figure): The Plotly Figure object.
-    - shape_type (str, optional): The type of shape to add. Defaults to "rect".
-    - x0 (float, optional): The x-coordinate of the lower left corner of the shape. Defaults to -1.
-    - y0 (float, optional): The y-coordinate of the lower left corner of the shape. Defaults to -1.
-    - x1 (float, optional): The x-coordinate of the upper right corner of the shape. Defaults to 0.
-    - y1 (float, optional): The y-coordinate of the upper right corner of the shape. Defaults to 0.
-    - fillcolor (str, optional): The fill color of the shape. Defaults to 'Silver'.
-    - opacity (float, optional): The opacity of the shape. Defaults to 0.1.
-    - line_width (float, optional): The width of the shape's outline. Defaults to 0.
-    - line_color (str, optional): The color of the shape's outline. Defaults to 'white'.
-    - dash (str, optional): The dash style of the shape's outline. Defaults to None.
-    - layer (str, optional): The layer on which the shape is added, either 'below' or 'above' the data. Defaults to "below".
+    Args:
+        fig (go.Figure): The Plotly Figure object.
+        shape_type (str, optional): The type of shape to add. Defaults to "rect".
+        x0 (float, optional): The x-coordinate of the lower left corner of the shape. Defaults to -1.
+        y0 (float, optional): The y-coordinate of the lower left corner of the shape. Defaults to -1.
+        x1 (float, optional): The x-coordinate of the upper right corner of the shape. Defaults to 0.
+        y1 (float, optional): The y-coordinate of the upper right corner of the shape. Defaults to 0.
+        fillcolor (str, optional): The fill color of the shape. Defaults to 'Silver'.
+        opacity (float, optional): The opacity of the shape. Defaults to 0.1.
+        line_width (float, optional): The width of the shape's outline. Defaults to 0.
+        line_color (str, optional): The color of the shape's outline. Defaults to 'white'.
+        dash (str, optional): The dash style of the shape's outline. Defaults to None.
+        layer (str, optional): The layer on which the shape is added, either 'below' or 'above' the data. Defaults to "below".
 
     Returns:
-    - fig (go.Figure): The modified Plotly Figure object with the added shape.
+        fig (go.Figure): The modified Plotly Figure object with the added shape.
     """
     fig.add_shape(
             # Shape for the area between (-1, 0)
@@ -2450,20 +2484,20 @@ def add_image(fig: go.Figure,
     """
     Adds an image to a Plotly figure.
 
-    Parameters:
-    - fig (go.Figure): The Plotly Figure object.
-    - xref (str, optional): The x-coordinate reference point. Defaults to "paper".
-    - yref (str, optional): The y-coordinate reference point. Defaults to "paper".
-    - x (float, optional): The x-coordinate of the image position. Defaults to 0.
-    - y (float, optional): The y-coordinate of the image position. Defaults to 0.
-    - sizex (float, optional): The size of the image in the x-direction. Defaults to 0.08.
-    - sizey (float, optional): The size of the image in the y-direction. Defaults to 0.08.
-    - xanchor (str, optional): The x-coordinate anchor point. Defaults to "right".
-    - yanchor (str, optional): The y-coordinate anchor point. Defaults to "bottom".
-    - source (str, optional): The URL source of the image. Defaults to "https://www.example.com/image.jpg".
+    Args:
+        fig (go.Figure): The Plotly Figure object.
+        xref (str, optional): The x-coordinate reference point. Defaults to "paper".
+        yref (str, optional): The y-coordinate reference point. Defaults to "paper".
+        x (float, optional): The x-coordinate of the image position. Defaults to 0.
+        y (float, optional): The y-coordinate of the image position. Defaults to 0.
+        sizex (float, optional): The size of the image in the x-direction. Defaults to 0.08.
+        sizey (float, optional): The size of the image in the y-direction. Defaults to 0.08.
+        xanchor (str, optional): The x-coordinate anchor point. Defaults to "right".
+        yanchor (str, optional): The y-coordinate anchor point. Defaults to "bottom".
+        source (str, optional): The URL source of the image. Defaults to "https://www.example.com/image.jpg".
 
     Returns:
-    - fig (go.Figure): The modified Plotly Figure object with the added image.
+        fig (go.Figure): The modified Plotly Figure object with the added image.
     """
     fig.add_layout_image(
     dict(
@@ -2477,4 +2511,41 @@ def add_image(fig: go.Figure,
         yanchor=yanchor
         )
     )
+    return fig
+
+def boxplot(df : pd.DataFrame, col_y : str = "degrees" , title : str ="Distribution of Node Degrees", yaxis_title : str = 'Degrees', width : int =1000, height: int =1000, plot_bgcolor: str = None, paper_bgcolor: str = None, template: str = "plotly", font_size : int = 16) -> go.Figure:
+    """
+    Generates a box plot using Plotly Express with customization options.
+
+    Args:
+        df (pd.DataFrame): The DataFrame containing the data to plot.
+        col_y (str, optional): The column name in the DataFrame to plot on the y-axis. Default is "degrees".
+        title (str, optional): The title of the plot. Default is "Distribution of Node Degrees".
+        yaxis_title (str, optional): The label for the y-axis. Default is 'Degrees'.
+        width (int, optional): The width of the plot in pixels. Default is 1000.
+        height (int, optional): The height of the plot in pixels. Default is 1000.
+        plot_bgcolor (str, optional): The background color of the plot area. Default is None.
+        paper_bgcolor (str, optional): The background color of the paper (overall plot background). Default is None.
+        template (str, optional): The template for the plot. Default is "plotly".
+        font_size (int, optional): The font size for the plot text. Default is 16.
+
+    Returns:
+        fig (go.Figure): The Plotly Figure object for the box plot.
+    """
+    # Box plot using Plotly Express
+    fig = px.box(df, y = col_y, title=title)
+
+    # Customize the plot (optional)
+    fig.update_layout(
+        yaxis_title = yaxis_title,
+        xaxis_title='',
+        showlegend=False,
+        width=width,
+        height=height,
+        font_family="Inria Sans",
+        font_size=font_size,
+        template=template,
+        plot_bgcolor=plot_bgcolor,    #background color (plot)
+        paper_bgcolor=paper_bgcolor
+    )
     return fig