Theil-Index-Rechner
Der Theil-Index-Rechner misst mit einem aus der Informationsentropie abgeleiteten Verfahren, wie ungleich Einkommen in einer Bevölkerung verteilt sind.
Im Browser ausführen – kostenlos
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.
Anwendungsfälle
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.
Häufige Fragen
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.
Für Entwickler — API-Zugang
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.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem Stack
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]}'const res = await fetch("https://api.kit.forhosting.com/stat/theil-index", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"incomes": [
10,
20,
30,
40
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/stat/theil-index",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"incomes": [
10,
20,
30,
40
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/stat/theil-index", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"incomes":[10,20,30,40]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"incomes":[10,20,30,40]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/stat/theil-index", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"incomes": [
10,
20,
30,
40
]
}Beispiel-Antwort
{
"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.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Limits
max_items | 100000 |
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |