# Portabilität: UNIVERSAL
# Version: 1.0.0
# Zuletzt validiert: 2026-05-17
# Nächste Prüfung: 2026-08-17

DATA ANALYSIS - BACH Datenanalyse-Befehle
==========================================

BACH bietet einfache Datenanalyse-Funktionen für CSV, Excel und JSON.

INSTALLATION
------------
Benötigt: pip install pandas matplotlib

BEFEHLE
-------

bach data list
  Zeigt alle Dateien im input/ Ordner an.

bach data load <pfad>
  Lädt Datei und zeigt Basisinfos (Zeilen, Spalten, Datentypen).
  Unterstützte Formate: CSV, Excel (.xlsx/.xls), JSON

bach data describe <pfad>
  Zeigt deskriptive Statistik (mean, std, min, max, quartile).
  Nur für numerische Spalten.

bach data head <pfad> [--rows N]
  Zeigt die ersten N Zeilen (Standard: 10).

bach data corr <pfad>
  Zeigt Korrelationsmatrix aller numerischen Spalten.

bach data chart <pfad> --type TYPE --x COL [--y COL] [--output NAME]
  Erstellt ein Diagramm und speichert es in charts/.
  X-Spalte erforderlich, Y-Spalte optional (wird automatisch gewaehlt).

  Chart-Typen:
    bar     - Balkendiagramm (benötigt X und Y)
    line    - Liniendiagramm (benötigt X und Y)
    pie     - Kreisdiagramm (benötigt X, Y optional für Werte)
    scatter - Streudiagramm (benötigt X und Y)
    hist    - Histogramm (benötigt nur X)

VERZEICHNISSE
-------------
user/data-analysis/
├── input/    # Quelldateien hier ablegen
├── output/   # Verarbeitete Ergebnisse
└── charts/   # Generierte Diagramme

BEISPIELE
---------

# Datei laden und analysieren
bach data load user/data-analysis/input/sales.csv
bach data describe user/data-analysis/input/sales.csv
bach data head user/data-analysis/input/sales.csv --rows 20

# Korrelation prüfen
bach data corr user/data-analysis/input/metrics.xlsx

# Charts erstellen
bach data chart input/sales.csv --type bar --x monat --y umsatz
bach data chart metrics.xlsx --type line --x date --y value --output trend
bach data chart input/survey.csv --type pie --x kategorie --y anzahl
bach data chart input/metrics.xlsx --type scatter --x x_wert --y y_wert
bach data chart input/data.csv --type hist --x alter

TIPPS
-----
- Dateien im input/ Ordner können mit kurzem Namen referenziert werden
- Charts werden automatisch in charts/ gespeichert (PNG, 150 DPI)
- Bei grossen Dateien: erst head, dann describe
- Chart-Befehle erfordern matplotlib: pip install matplotlib
- Y-Spalte wird bei bar/line/scatter automatisch gewaehlt wenn nicht angegeben

SIEHE AUCH
----------
bach --help tools     # Alle verfügbaren Tools
bach --help features  # BACH Features-Übersicht

VERSION
-------
Eingeführt in BACH v1.1.25 (2026-01-21)
Chart-Befehle vollständig implementiert (bar, line, pie, scatter, hist)
Handler: system/hub/data_analysis.py
