mcpField
D
Data Cleaning Pipeline

Data Cleaning Pipeline

github.com/aj-geddes数据与数据库373592 次安装34 周前更新
代码仓库

关于 Data Cleaning Pipeline

用于将原始数据集整理为适合分析或建模格式的数据清洗流水线技能。介绍缺失值、异常值、重复项和格式不一致的处理,并涵盖验证与变更记录。

主要功能

  1. 01缺失值填补或删除
  2. 02异常值检测与处理
  3. 03数据类型和格式标准化
  4. 04删除重复项
  5. 05归一化与缩放
  6. 06验证和清洗日志

适用场景

  1. 01为分析准备原始数据
  2. 02为建模预处理数据集
  3. 03构建自动化清洗工作流
  4. 04检查转换后的数据完整性

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/aj-geddes/useful-ai-prompts --skill data-cleaning-pipeline

安装后在 Claude Code 中输入/data-cleaning-pipeline确认已加载。

附带文件templates/notebook-template.pyscripts/scaffold-analysis.sh

详细介绍

数据清理管道

概述

数据清理管道通过系统地处理缺失值、异常值和数据质量问题,将原始、杂乱的数据转换为适合分析和建模的干净、标准化格式。

适用场景

  • 为分析或建模准备原始数据集
  • 处理缺失值和数据质量问题
  • 删除重复项并标准化格式
  • 检测并处理异常值
  • 构建自动化数据预处理工作流
  • 确保数据完整性和一致性

核心组件

  • 缺失值处理:插补和删除策略
  • 异常值检测与处理:识别并处理异常
  • 数据类型标准化:确保数据类型正确
  • 删除重复项:识别并删除重复项
  • 归一化与缩放:标准化数值范围
  • 文本清理:处理文本数据

清理策略

  • 删除:删除行或列
  • 插补:使用均值、中位数或预测模型填补
  • 转换:在不同格式之间转换
  • 验证:确保符合数据完整性规则

使用 Python 实现

import pandas as pd
import numpy as np
from sklearn.preprocessing import StandardScaler, MinMaxScaler
from sklearn.impute import SimpleImputer, KNNImputer

# Load raw data
df = pd.read_csv('raw_data.csv')

# Step 1: Identify and handle missing values
print("Missing values:\n", df.isnull().sum())

# Strategy 1: Delete rows with critical missing values
df = df.dropna(subset=['customer_id', 'transaction_date'])

# Strategy 2: Impute numerical columns with median
imputer = SimpleImputer(strategy='median')
df['age'] = imputer.fit_transform(df[['age']])

# Strategy 3: Use KNN imputation for related features
knn_imputer = KNNImputer(n_neighbors=5)
numeric_cols = df.select_dtypes(include=[np.number]).columns
df[numeric_cols] = knn_imputer.fit_transform(df[numeric_cols])

# Strategy 4: Fill categorical with mode
df['category'] = df['category'].fillna(df['category'].mode()[0])

# Step 2: Handle duplicates
print(f"Duplicate rows: {df.duplicated().sum()}")
df = df.drop_duplicates()

# Duplicate on specific columns
df = df.drop_duplicates(subset=['customer_id', 'transaction_date'])

# Step 3: Outlier detection and handling
Q1 = df['amount'].quantile(0.25)
Q3 = df['amount'].quantile(0.75)
IQR = Q3 - Q1
lower_bound = Q1 - 1.5 * IQR
upper_bound = Q3 + 1.5 * IQR

# Remove outliers
df = df[(df['amount'] >= lower_bound) & (df['amount'] <= upper_bound)]

# Alternative: Cap outliers
df['amount'] = df['amount'].clip(lower=lower_bound, upper=upper_bound)

# Step 4: Data type standardization
df['transaction_date'] = pd.to_datetime(df['transaction_date'])
df['customer_id'] = df['customer_id'].astype('int64')
df['amount'] = pd.to_numeric(df['amount'], errors='coerce')

# Step 5: Text cleaning
df['name'] = df['name'].str.strip().str.lower()
df['name'] = df['name'].str.replace('[^a-z0-9\s]', '', regex=True)

# Step 6: Normalization and scaling
scaler = StandardScaler()
df[['age', 'income']] = scaler.fit_transform(df[['age', 'income']])

# MinMax scaling for bounded range [0, 1]
minmax_scaler = MinMaxScaler()
df[['score']] = minmax_scaler.fit_transform(df[['score']])

# Step 7: Create data quality report
def create_quality_report(df_original, df_cleaned):
    report = {
        'Original rows': len(df_original),
        'Cleaned rows': len(df_cleaned),
        'Rows removed': len(df_original) - len(df_cleaned),
        'Removal percentage': ((len(df_original) - len(df_cleaned)) / len(df_original) * 100),
        'Original missing': df_original.isnull().sum().sum(),
        'Cleaned missing': df_cleaned.isnull().sum().sum(),
    }
    return pd.DataFrame(report, index=[0])

quality = create_quality_report(df, df)
print(quality)

# Step 8: Validation checks
assert df['age'].isnull().sum() == 0, "Age has missing values"
assert df['transaction_date'].dtype == 'datetime64[ns]', "Date not datetime"
assert (df['amount'] >= 0).all(), "Negative amounts detected"

print("Data cleaning pipeline completed successfully!")

管道架构

class DataCleaningPipeline:
    def __init__(self):
        self.cleaner_steps = []

    def add_step(self, func, description):
        self.cleaner_steps.append((func, description))
        return self

    def execute(self, df):
        for func, desc in self.cleaner_steps:
            print(f"Executing: {desc}")
            df = func(df)
        return df

# Usage
pipeline = DataCleaningPipeline()
pipeline.add_step(
    lambda df: df.dropna(subset=['customer_id']),
    "Remove rows with missing customer_id"
).add_step(
    lambda df: df.drop_duplicates(),
    "Remove duplicate rows"
).add_step(
    lambda df: df[(df['amount'] > 0) & (df['amount'] < 100000)],
    "Filter invalid amount ranges"
)

df_clean = pipeline.execute(df)

高级清理技术

# Step 9: Feature-specific cleaning
df['phone'] = df['phone'].str.replace(r'\D', '', regex=True)  # Remove non-digits

# Step 10: Datetime handling
df['created_date'] = pd.to_datetime(df['created_date'], errors='coerce')
df['days_since_creation'] = (pd.Timestamp.now() - df['created_date']).dt.days

# Step 11: Categorical standardization
df['status'] = df['status'].str.lower().str.strip()
df['status'] = df['status'].replace({
    'active': 'active',
    'inactive': 'inactive',
    'pending': 'pending',
})

# Step 12: Numeric constraint checking
df['age'] = df['age'].where((df['age'] >= 0) & (df['age'] <= 150), np.nan)
df['percentage'] = df['percentage'].where((df['percentage'] >= 0) & (df['percentage'] <= 100), np.nan)

# Step 13: Create data quality score
quality_score = {
    'Missing %': (df.isnull().sum() / len(df) * 100).mean(),
    'Duplicates %': (df.duplicated().sum() / len(df) * 100),
    'Complete Features': (df.notna().sum() / len(df)).mean() * 100,
}

# Step 14: Generate cleaning report
cleaning_report = f"""
DATA CLEANING REPORT
====================
Rows removed: {len(df) - len(df_clean)}
Columns: {len(df_clean.columns)}
Remaining rows: {len(df_clean)}
Completeness: {(df_clean.notna().sum().sum() / (len(df_clean) * len(df_clean.columns)) * 100):.1f}%
"""
print(cleaning_report)

关键决策

  • 如何处理缺失值(删除还是插补)?
  • 哪些异常值属于合理的业务情形?
  • 可接受的数值范围是什么?
  • 哪些重复项是真正的重复项?
  • 如何标准化类别值?

验证步骤

  • 检查数据类型是否一致
  • 验证数值范围是否合理
  • 确认没有意外的数据丢失
  • 记录所有已执行的转换
  • 创建变更审计跟踪记录

交付物

  • 附带质量指标的清理后数据集
  • 记录所有步骤的数据清理日志
  • 确认数据完整性的验证报告
  • 清理前后的对比统计数据
  • 清理代码和管道文档

评论

支持 Markdown