---

name: data-quality description: Diagnose and fix data quality problems in datasets. Use when working with dirty data, finding duplicates, handling missing values, detecting outliers/anomalies, validating constraints (functional dependencies, referential integrity), profiling datasets, or cleaning data for analysis or ML. Covers the full data quality lifecycle - define, detect, clean, measure.

Data Quality Skill

Systematic approach to diagnosing and fixing data quality problems.

Data Quality Process

Define & Identify → Detect & Quantify → Clean & Rectify → Measure & Verify

1. Define: Understand data context, business rules, quality requirements
2. Detect: Profile data, find glitches (missing, duplicates, outliers, violations)
3. Clean: Apply appropriate repair strategies
4. Measure: Validate repairs, quantify improvement

Quick Reference

| Problem | Script | Key Function | |---------|--------|--------------| | Data overview | data_profiling.py | profile_dataframe(df) | | Find quality issues | data_profiling.py | detect_glitches(df) | | Missing values | missing_data.py | analyze_missing(df) | | Imputation | missing_data.py | impute_mean/median/regression() | | Duplicates | duplicate_detection.py | find_duplicates(df, cols) | | Deduplication | duplicate_detection.py | deduplicate(df, cols) | | Outliers | anomaly_detection.py | detect_anomalies(df) | | Constraint check | constraint_checking.py | validate_constraints(df, rules) | | String matching | similarity_metrics.py | jaro_winkler_similarity() |

Workflow

Step 1: Profile the Data

from scripts.data_profiling import profile_dataframe, detect_glitches, generate_quality_report

# Quick overview
print(generate_quality_report(df))

# Detailed profile
profile = profile_dataframe(df)

# Find issues
glitches = detect_glitches(df)

Step 2: Analyze Specific Issues

Missing Data:

from scripts.missing_data import analyze_missing, test_mcar

analysis = analyze_missing(df)
# Check if safe to delete rows
mcar_test = test_mcar(df, 'column_with_missing', ['other_cols'])

Duplicates:

from scripts.duplicate_detection import find_duplicates, cluster_duplicates

matches = find_duplicates(df, ['name', 'email'], threshold=0.85)
clusters = cluster_duplicates(matches)

Outliers:

from scripts.anomaly_detection import detect_anomalies, iqr_outliers

# Multi-column summary
anomalies = detect_anomalies(df, method='iqr')

# Single column detail
result = iqr_outliers(df, 'price', multiplier=1.5)

Constraints:

from scripts.constraint_checking import validate_constraints

constraints = [
    {'type': 'unique', 'columns': ['id']},
    {'type': 'not_null', 'columns': ['name', 'email']},
    {'type': 'fd', 'determinant': ['id'], 'dependent': ['name']},
    {'type': 'domain', 'column': 'age', 'min_value': 0, 'max_value': 150},
]
results = validate_constraints(df, constraints)

Step 3: Clean the Data

Handle Missing:

from scripts.missing_data import impute_median, impute_regression, listwise_deletion

# Simple: median for numeric
df_clean = impute_median(df, 'age')

# Better: regression-based
df_clean = impute_regression(df, 'income', ['age', 'education'])

# If MCAR confirmed
df_clean = listwise_deletion(df)

Remove Duplicates:

from scripts.duplicate_detection import deduplicate

df_clean, summary = deduplicate(
    df, 
    columns=['name', 'email', 'address'],
    threshold=0.8,
    merge_strategy='most_complete'
)
print(f"Reduced from {summary['original_rows']} to {summary['final_rows']} rows")

Handle Outliers:

# Cap extreme values
q01, q99 = df['col'].quantile([0.01, 0.99])
df['col'] = df['col'].clip(q01, q99)

# Or remove
df_clean = df[~detect_anomalies(df)['col']['outlier_indices']]

Step 4: Validate

Re-run profiling and constraint checks on cleaned data to verify improvements.

References

For deeper understanding:

• references/dimensions.md: Data quality dimensions (accuracy, completeness, etc.)
• references/glitch_taxonomy.md: Types of data glitches and detection approaches
• references/repair_strategies.md: Detailed repair and cleaning strategies

Key Concepts

Data Quality = Fit for Use

• Free of defects
• Has features needed for the task
• Right information, right place, right time

Missing Data Mechanisms:

• MCAR: Missing Completely At Random (safe to delete)
• MAR: Missing At Random (imputation may work)
• MNAR: Missing Not At Random (most problematic)

Constraints:

• Functional Dependency: X → Y means X uniquely determines Y
• Referential Integrity: foreign keys reference valid primary keys
• Domain Constraints: values within allowed set/range

Entity Resolution:

• Blocking reduces O(n²) to O(n·window)
• Similarity metrics: Jaro-Winkler (names), Levenshtein (typos), Jaccard (sets)
• Cluster by transitive closure, merge by strategy

Similarity Metrics Comparison

| Metric | Best For | Example | |--------|----------|---------| | Jaro-Winkler | Names, short strings | "Robert" vs "Rupert" | | Levenshtein | Typos, edit distance | "recieve" vs "receive" | | Jaccard | Token/word comparison | "John Doe" vs "Doe, John" | | Q-gram | Fuzzy substring matching | Partial matches |