opsci-toolbox 0.0.10__py3-none-any.whl → 0.0.11__py3-none-any.whl

opsci_toolbox/helpers/common.py

@@ -1219,25 +1219,6 @@ def top_rows_per_category(df: pd.DataFrame,
                 )[cols_to_keep]
     return df_gb
 
-def format_number(number: int) -> str:
-    """
-    Format a number into a human-readable string with K, M, or B suffixes.
-
-    Args:
-        number (int): The number to format.
-
-    Returns:
-        str: The formatted number as a string with an appropriate suffix.
-    """
-    if number < 1000:
-        return str(number)
-    elif number < 1000000:
-        return f"{number / 1000:.1f}K"
-    elif number < 1000000000:
-        return f"{number / 1000000:.1f}M"
-    else:
-        return f"{number / 1000000000:.1f}B"
-
 
 
 def unrar_file(rar_file_path : str, output_dir : str) -> None:
@@ -1330,4 +1311,42 @@ def remove_empty_folders(path: str):
             # If the directory is empty, remove it
             if not os.listdir(dir_path):
                 os.rmdir(dir_path)
-                print(f"Removed empty folder: {dir_path}")
+                print(f"Removed empty folder: {dir_path}")
+
+
+def categorize_percentiles(percentile: float) -> str:
+    """
+    Categorizes a percentile value into a string representing its range.
+
+    Args:
+    - percentile (float): The percentile value (between 0 and 1).
+
+    Returns:
+    - str: The category of the percentile value.
+
+    Raises:
+    - ValueError: If the percentile value is outside the range [0, 1].
+    """
+    if not (0 <= percentile <= 1):
+        raise ValueError("Percentile must be between 0 and 1 inclusive.")
+    
+    if percentile <= 0.1:
+        return '0-10%'
+    elif percentile <= 0.2:
+        return '10-20%'
+    elif percentile <= 0.3:
+        return '20-30%'
+    elif percentile <= 0.4:
+        return '30-40%'
+    elif percentile <= 0.5:
+        return '40-50%'
+    elif percentile <= 0.6:
+        return '50-60%'
+    elif percentile <= 0.7:
+        return '60-70%'
+    elif percentile <= 0.8:
+        return '70-80%'
+    elif percentile <= 0.9:
+        return '80-90%'
+    else:
+        return '90-100%'