sliceguard 0.0.7

A library for detecting critical data slices in structured and unstructured data based on features, metadata and model predictions.

sliceguard

Detect problematic data slices in unstructured and structured data fast.

🚀 Introduction

sliceguard is built to quickly discover problematic data segments in your data. It aims at supporting structured data as well as unstructured data like images, text or audio. However, it also tries to keep a simple interface hiding most of its functionality after one simple find_issues function.

It also allows for interactive reporting and exploration of found data issues using Renumics Spotlight.

⏱️ Quickstart

Install sliceguard by running pip install sliceguard.

Download the Example Dataset.

Install the jiwer package for computing the word error rate metric using pip install jiwer

Get started by loading your first dataset and let sliceguard do its work:

import pandas as pd
import numpy as np
from jiwer import wer
from sliceguard import SliceGuard

# Load the example data
df = pd.read_json("example_data.json")

# Define a metric function to evaluate your model
def wer_metric(y_true, y_pred):
    return np.mean([wer(s_y, s_pred) for s_y, s_pred in zip(y_true, y_pred)])

# Detect problematic data slices using the features age, gender and accent
sg = SliceGuard()
issue_df = sg.find_issues(
    df,
    ["age", "gender", "accent"],
    "sentence",
    "prediction",
    wer_metric,
    metric_mode="min"
)
sg.report()

🔧 Use case-specific examples

• Detecting issues in automatic speech recognition (ASR) models
• Detecting issues in audio datasets (condition monitoring)

Also check this post on Medium:

Evaluating automatic speech recognition models beyond global metrics — A tutorial using OpenAI’s Whisper as an example

🗺️ Public Roadmap

• Detection of problematic data slices
• Basic explanation of found issues via feature importances
• Limited embedding computation for images, audio, text
• Extended embedding support, e.g., more embedding models and allow precomputed embeddings
• Speed up embedding computation using datasets library
• Soft Dependencies for embedding computation as torch dependencies are large
• Improve Spotlight report with embeddings in simmap and histogram for univariate analysis
• Extensive documentation and examples for common cases
• Data connectors for faster application on common data formats
• Improved explanations for found issues, e.g., via SHAP
• Generation of a summary report doing predefined checks
• Allow for control features in order to account for expected variations when running checks
• Improved issue detection algorithm, avoiding duplicate detections of similar problems and outliers influencing the segment detection