Failure Mode Analysis
Failure Mode Analysis is a test that allows users to deeply analyse their model's performance.
Failure Mode Analysis enables you to define rules on metrics by setting thresholds. Based on rules, get a sorted list of all clusters that are breaching the threshold and clusters that are within the threshold. RagaAI will create clusters using the embeddings of the Dataset. Clusters that underperform and breaches the threshold will be highlighted on the Issue Stats screen.
Execute Test
The following code snippet is designed to perform a Failure Mode Analysis test on a specified dataset within the RagaAI environment.
First, you define the rules that will be used to evaluate the model's performance. These rules are based on metrics such as F1 Score, Precision, and Recall (Refer Metric Glossary).
SDRules()
: Initialises the rules for the Failure Mode Analysis test.rules.add()
: Adds a new rule with specific parameters:metric
: The performance metric to evaluate (e.g., F1Score, Precision, Accuracy, Recall).label
: Specifies the label(s) these metrics apply to. "ALL" means all labels.metric_threshold
: The minimum acceptable value for the metric.
Next, you define the clustering parameters to group similar failure modes.
clustering()
: Sets the clustering method for grouping failure modes.method
: The clustering technique used, "k-means" in this case.embedding_col
: The column containing embedding vectors to be used for clustering.level
: The level at which clustering is applied, "image" here indicates that each image is treated as an individual data point.args
: Additional arguments for the clustering method, such as the number of clusters.force
: set as "True" if you wish to rerun clustering on the existing dataset rather than using cached clustering results.
Note: The clustering parameters are not required if the test is being run on metadata.
fma_structured_data()
: Configures the failure mode analysis test with the following parameters:test_session
: Defines the test session created by the user with the project name, access key, secret key and the host token.dataset_name
: Specifies the dataset to be used by the user for the test.test_name
: Identifies with the test the user is running.type
: Specifies the level (embedding for cluster level and metadata for metadata level) on which the test is being run.output_type
: Contains the usecase the test is being run on. For example: Object Detection, Semantic Segmentation and many more.embedding
: Specified the name of the embedding column in the dataset.model
: Contains the model inferences which are supposed to be evaluated.gt
: The groundtruth against which the model inferences are going to be compared across the diverse scenarios.rules
: The previously defined rules for failure mode analysis testclustering
: Specifies the clustering method defined by the user earlier. This is only required incase failure mode analysis is being run at a cluster level.
test_session.add()
: Registers the failure mode analysis test with the test session.test_session.run()
: Starts the execution of all the tests added to the session, including the FMA.
Following this guide, you've successfully set up and initiated a Failure Mode Analysis test on the RagaAI Testing Platform.
Analysing Test Results
Clustering (Embedding View)
Navigate to Embedding View: Find the interactive visualisation interface in RagaAI.
Visualise Clusters: Utilise the tool to visualise complex clustering, uncovering hidden patterns and structures in the data.
Select Data Points: Use the lasso tool to select specific data points of interest and analyse their results.
Visualising Data
Data Filtering: Use this feature to focus on specific subsets of your dataset that meet certain conditions, helping to extract meaningful patterns and trends.
![](https://docs.raga.ai/~gitbook/image?url=https%3A%2F%2F1811327582-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYbIiNdp1QbG4avl7VShw%252Fuploads%252FwjRqRWc1Ww5nQrHvJI0t%252FScreenshot%25202024-01-17%2520at%252016.29.53.png%3Falt%3Dmedia%26token%3D5c3f0ef8-dca9-4cdb-b4f9-0748cebac173&width=768&dpr=4&quality=100&sign=3424b4af&sv=1)
Understanding Clustering and Threshold Breaches
Cluster Analysis: RagaAI creates clusters using the embeddings of the dataset. These clusters group similar data points together.
Identifying Underperforming Clusters: Clusters that underperform (breaching the threshold) will be highlighted on the Issue Stats screen.
![](https://docs.raga.ai/~gitbook/image?url=https%3A%2F%2F1811327582-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYbIiNdp1QbG4avl7VShw%252Fuploads%252FV9nXaKi7M5yrlbJpwhQO%252FScreenshot%25202024-01-17%2520at%252016.30.34.png%3Falt%3Dmedia%26token%3D6e7d8558-fbe1-4d0c-980e-b87e29bc1dba&width=768&dpr=4&quality=100&sign=f023cdd&sv=1)
Navigating and Interpreting Results
Directly Look at Problematic Clusters: Users can quickly identify clusters responsible for underperformance and assess their impact on the overall model.
In-Depth Analysis: Dive deeper into specific clusters or data points to understand the root causes of underperformance.
Feature Level Analysis: Understand the divergence between the datapoints selected in the embeddings and the overall datapoints of the datasets.
![](https://docs.raga.ai/~gitbook/image?url=https%3A%2F%2F1811327582-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYbIiNdp1QbG4avl7VShw%252Fuploads%252FzjRo2JBOjPMoedg7ACmj%252FScreenshot%25202024-01-17%2520at%252016.33.29.png%3Falt%3Dmedia%26token%3D183eb80f-f74e-4cfa-ae8c-ed22009cb80a&width=768&dpr=4&quality=100&sign=6ddd1058&sv=1)
Data Analysis
Switch to Analysis Tab: To get a detailed performance report, go to the Analysis tab.
View Performance Metrics: Examine metrics like label-wise performance and temporal graphs.
Confusion Matrix: The class-based confusion matrix in Failure Mode Analysis provides a detailed breakdown of performance for each class.
![](https://docs.raga.ai/~gitbook/image?url=https%3A%2F%2F1811327582-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYbIiNdp1QbG4avl7VShw%252Fuploads%252FVHFLm5mKSGgcuPHq9o5u%252FScreenshot%25202024-01-17%2520at%252016.34.21.png%3Falt%3Dmedia%26token%3D5892ce65-b561-429a-896e-f0561bab69a5&width=768&dpr=4&quality=100&sign=4bf6e0ce&sv=1)
Practical Tips
Set Realistic Thresholds: Choose thresholds that reflect the expected performance of your model.
Leverage Visual Tools: Make full use of RagaAI’s visualisation capabilities to gain insights that might not be apparent from raw data alone.
Delve Deeper Into Features: Do a deeper root case analysis at a feature level and gain insights on model performance over datapoints across different features.
Data Level View: Get results at individual datapoint level
![](https://docs.raga.ai/~gitbook/image?url=https%3A%2F%2F1811327582-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYbIiNdp1QbG4avl7VShw%252Fuploads%252FMdH6b80hC461a9UO4fsO%252FScreenshot%25202024-01-17%2520at%252016.43.52.png%3Falt%3Dmedia%26token%3Da8132b78-5592-4418-891d-e2af01ca2f34&width=768&dpr=4&quality=100&sign=77252cda&sv=1)
![](https://docs.raga.ai/~gitbook/image?url=https%3A%2F%2F1811327582-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYbIiNdp1QbG4avl7VShw%252Fuploads%252FHrGjSyngBVKiFE2PlZRd%252FScreenshot%25202024-01-17%2520at%252016.44.32.png%3Falt%3Dmedia%26token%3Dbb04df0d-dc85-4468-a506-3b8ce7b467bf&width=768&dpr=4&quality=100&sign=faca1de&sv=1)
By following these steps, users can efficiently leverage the Failure Mode Analysis test to gain a comprehensive understanding of their model's performance, identify key areas for improvement, and make data-driven decisions to enhance model accuracy and reliability.
Last updated