ForHosting KIT · Entwickler-Tools

Theil-Index-Rechner

Der Theil-Index-Rechner misst mit einem aus der Informationsentropie abgeleiteten Verfahren, wie ungleich Einkommen in einer Bevölkerung verteilt sind.

● BetaKostenlos · im Browser
Nutzen Sie es über WebAPIE-MailTelegramApp bald

Geben Sie für jede gleich gewichtete Person, jeden Haushalt, jede Region oder eine andere Einheit ein positives Einkommen ein. Ausgegeben werden der Theil-T-Index sowie Anzahl, Gesamteinkommen und Mittelwert der Berechnung. Null steht für vollkommene Gleichverteilung; höhere Werte zeigen stärkere Konzentration an. Die deterministische Berechnung eignet sich für Analysen, reproduzierbare Berichte, Datenpipelines und automatisierte Vergleiche.

Welche Aussage der Theil-Index liefert

Der Theil-Index fasst die Einkommensverteilung in einem nicht negativen Ungleichheitsmaß zusammen. Haben alle Beobachtungen genau dasselbe Einkommen, beträgt jedes Verhältnis zum Mittelwert eins, sämtliche logarithmischen Beiträge sind null und der endgültige Index ist ebenfalls null. Konzentriert sich Einkommen auf weniger Beobachtungen, steigt der Index. Anders als eine Geldsumme oder ein Durchschnitt besitzt das Ergebnis keine Einheit. Daher lassen sich Verteilungen in unterschiedlichen Währungen oder Größenordnungen vergleichen, sofern die Populationen einheitlich definiert sind. Das Maß reagiert auf Veränderungen in der gesamten Verteilung, einschließlich ihres oberen Randes. Es zeigt jedoch nicht, welche Haushalte arm oder reich sind; zudem können zwei sichtbar verschiedene Verteilungen denselben Index ergeben. Interpretieren Sie ihn deshalb zusammen mit Anzahlen, Mittelwerten, Quantilen und fachlichem Kontext. Dieser Rechner gibt Theil T aus, gelegentlich als mit relativem Einkommen gewichtete mittlere logarithmische Abweichung bezeichnet, nicht aber das separate Maß Theil L. Bei Veröffentlichungen und Vergleichen sollte diese Konvention ausdrücklich genannt werden.

So funktioniert die Berechnung

Bei n Einkommen ermittelt der Rechner zunächst das arithmetische Mittel. Danach teilt er jedes Einkommen durch diesen Mittelwert, bildet den natürlichen Logarithmus des Verhältnisses, multipliziert Verhältnis und Logarithmus, summiert alle Beiträge und teilt die Summe durch n. Theil T ist somit der Durchschnitt aus relativem Einkommen mal dessen natürlichem Logarithmus. Natürliche Logarithmen sind zwingend erforderlich; Logarithmen zur Basis zehn oder zwei verändern die numerische Skala. Jede Eingabe muss eine endliche Zahl sein, die strikt größer als null ist. Diese Vorgabe verhindert undefinierte Logarithmen und setzt den Vertrag eindeutig um: Nullwerte, negative, fehlende, unendliche oder nicht numerische Werte führen zu einem Eingabefehler und werden nicht stillschweigend verworfen. Jedes Array-Element erhält dasselbe Bevölkerungsgewicht. Repräsentiert ein Datensatz mehrere Personen, müssen Sie ihn in einzelne Beobachtungen aufteilen oder die Daten vorher mit geeigneten Häufigkeitsgewichten umformen. Gesamtsumme und Mittelwert helfen Ihnen zu prüfen, ob die Population richtig interpretiert wurde.

Gruppen vergleichen und Ergebnisse einordnen

Verwenden Sie bei allen Vergleichen dieselbe Definition der Population, denselben Abrechnungszeitraum, denselben Einkommensbegriff und dieselbe Behandlung von Steuern oder Transfers. Werden monatliche Haushaltseinkommen mit jährlichen persönlichen Einkommen vermischt, entsteht zwar eine Zahl, aber kein sinnvoller Vergleich. Die Theil-Familie ist besonders nützlich, weil sich die Gesamtungleichheit in Komponenten innerhalb und zwischen Gruppen zerlegen lässt. Diese Zerlegung benötigt jedoch Gruppengrößen und Gruppensummen und wird von diesem Rechner für ein einzelnes Array nicht durchgeführt. Sie können dennoch für jede konsistent definierte Gruppe einen separaten Index berechnen, sollten diese unabhängigen Ergebnisse aber nicht mit einer additiven Zerlegung verwechseln. Es gibt keinen universellen Grenzwert für einen guten oder schlechten Theil-Wert; seine Bedeutung hängt von Gesellschaft, Markt, Stichprobendesign und Fragestellung ab. Prüfen Sie außerdem den Einfluss weniger Extremwerte, einheitliche Inflationsbereinigungen und die Repräsentativität der Stichprobe. Bewahren Sie bei automatisierten Abläufen das genaue Eingabearray mit der Ausgabe auf.

Verteilungen im Zeitverlauf vergleichen

Messen Sie Ungleichheit anhand einheitlich definierter Jahreseinkommen und verfolgen Sie die Konzentration zwischen Berichtszeiträumen.

Regionale Ungleichheit untersuchen

Berechnen Sie Theil T je Region, wenn Einkommensbegriff, Bevölkerungseinheit, Währungsbasis und Zeitraum übereinstimmen.

Eine reproduzierbare Kennzahl einbinden

Berechnen Sie aus geprüften positiven Werten eine deterministische Kennzahl und speichern Sie Anzahl, Summe und Mittelwert zur Kontrolle.

Was bedeutet ein Theil-Index von null?

Alle übermittelten Beobachtungen besitzen dasselbe Einkommen; innerhalb der angegebenen Population herrscht somit vollkommene Gleichverteilung.

Darf ein Einkommen null oder negativ sein?

Nein. Jeder Wert muss endlich und strikt positiv sein. Null und negative Werte erzeugen einen Eingabefehler, weil die logarithmische Formel in diesem Vertrag nicht definiert ist.

Welche Variante des Theil-Index wird berechnet?

Der Rechner liefert Theil T: den Mittelwert aus dem Verhältnis jedes Einkommens zum Durchschnitt multipliziert mit dem natürlichen Logarithmus dieses Verhältnisses. Theil L wird nicht berechnet.

Verändert ein Währungswechsel das Ergebnis?

Wenn Sie alle Einkommen mit demselben positiven Umrechnungsfaktor multiplizieren, bleibt der Index bis auf übliche Gleitkommaeffekte unverändert.

Werden die Einkommensbeobachtungen gewichtet?

Jedes Array-Element hat dasselbe Gewicht. Datensätze für unterschiedlich große Bevölkerungsanteile müssen vor der Berechnung erweitert oder passend umgeformt werden.

Was kostet die Berechnung per API?

Der API-Preis beträgt $0.002 pro Anfrage. Dieselbe deterministische Berechnung kann im Browser auch kostenlos ausgeführt werden.

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

POSThttps://api.kit.forhosting.com/stat/theil-index

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

curl -X POST https://api.kit.forhosting.com/stat/theil-index \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"incomes":[10,20,30,40]}'
{
  "incomes": [
    10,
    20,
    30,
    40
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "stat.theil_index",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

max_items100000
HTTPCodeBedeutung
401unauthorizedDer API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
402insufficient_balanceIhr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
404unknown_typeUnbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
429rate_limitedZu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →