analyze

Data Analysis Report Generator

Generate a comprehensive, structured data analysis report using the notebookmd library. The report should read like a professional analyst's notebook — with clear sections, key metrics, data tables, visualizations, and actionable insights.

Input

Analyze: $ARGUMENTS

Instructions

1. Setup

from notebookmd import nb, NotebookConfig
import pandas as pd

cfg = NotebookConfig(max_table_rows=30)
n = nb("dist/analysis.md", title="<descriptive title based on the data>", cfg=cfg)

2. Report Structure

Build the report with these sections (adapt to the data):

# Section 1: Data Overview
n.section("Data Overview")
n.kv({
    "Source": "<where the data came from>",
    "Records": f"{len(df):,}",
    "Columns": str(len(df.columns)),
    "Date Range": f"{df['date'].min()} to {df['date'].max()}",  # if applicable
}, title="Dataset Info")
n.summary(df, title="Statistical Summary")

# Section 2: Key Metrics
n.section("Key Metrics")
n.metric_row([
    {"label": "Total", "value": f"{total:,.0f}"},
    {"label": "Mean", "value": f"{mean:.2f}"},
    {"label": "Trend", "value": f"{trend:+.1f}%", "delta": f"{trend:+.1f}%"},
])

# Section 3: Data Sample
n.section("Data Preview")
n.dataframe(df.head(15), name="First 15 rows")

# Section 4: Analysis & Patterns
n.section("Analysis")
# Group by, aggregate, compute derived metrics
n.table(grouped_df, name="Aggregated Results")

# Section 5: Visualization (if matplotlib available)
try:
    import matplotlib
    matplotlib.use("Agg")
    import matplotlib.pyplot as plt

    n.section("Visualizations")
    n.line_chart(df, x="date_col", y="value_col", title="Trend Over Time")
    n.bar_chart(top_n, x="category", y="count", title="Top Categories")
except ImportError:
    n.note("Install matplotlib for chart generation: pip install notebookmd[plotting]")

# Section 6: Export
n.section("Export")
n.export_csv(df, "analysis_data.csv", name="Full dataset")

# Section 7: Findings & Recommendations
n.section("Key Findings")
n.write("""
- **Finding 1**: Description with supporting evidence
- **Finding 2**: Description with supporting evidence
- **Finding 3**: Description with supporting evidence
""")

n.section("Recommendations")
n.write("""
1. Action item based on findings
2. Action item based on findings
3. Action item based on findings
""")

n.success("Analysis complete!")
out = n.save()
print(f"Report saved to: {out}")