Calculated Fields - idea-labs/documentation GitHub Wiki

Mit Calculated Fields könnt Ihr eine Vielzahl von Berechnungen durchführen, die automatisch ausgeführt werden, sobald Daten eingegeben werden. Dafür wählt Ihr beim Anlegen der Variable als Field Type "Calculated Field" aus. Unter "Calculation Equation" könnt Ihr die Gleichung zur Berechnung eintragen. Unter 🔗 "How do I format the equation?" (Login erforderlich) findet Ihr Hilfestellung und eine Übersicht über Funktionen, die zur Erstellung der Gleichungen eingesetzt werden können. Im folgenden findet Ihr einige Beispiele zur Nutzung von Calculated Fields. Beachtet auch die Hinweise am Ende.

Rohwerte addieren

Mit den Calculated Fields könnt Ihr nicht nur mit eingetragenen Werten rechnen, sondern auch die Rohwerte aus Multiple-Choice-Feldern in Eure Rechnungen miteinbeziehen. Ein einfaches Beispiel:

In diesem Beispiel werden die Werte der Multiple-Choice-Aufgaben addiert. Dabei entsprechen die Labels "1-4" den Rohwerten "1-4". Die Gleichung des Calculated Fields sieht folgendermaßen aus:

Markierungen zählen

Neben den Berechnungen mit Rohwerten ist es auch möglich, die Anzahl der markierten Checkboxen zu zählen. Diese Art der Berechnung ist besonders bei Tests wie RAN oder SLRT II hilfreich, bei denen ausgelassene oder fehlerhafte Items am Ende addiert werden müssen.

Im Beispiel werden nicht die gegebenen Rohwerte addiert, sondern die Anzahl der Markierungen. Jeder markierte Wert wird dabei mit “1” gezählt, alle unmarkierten Werte mit “0”. Das Calculated Field für diese Berechnung sieht folgendermaßen aus:

Versuchspersonen-Codes mit Calculated Fields erstellen

Richtig angewendet ist es möglich, über Multiple-Choice-Felder und Calculated Fields Versuchspersonen-Codes zu generieren.

Im Beispiel wird der VP-Code aus Angaben der Versuchsperson generiert.

  • Erste Zahl: Geschlecht (zum Beispiel 1=weiblich, 2= männlich)

  • Zweite Zahl: Klasse (zum Beispiel: 1=1a, 2=1b, 3=1c,…)

  • Dritte Zahl: Schule (zum Beispiel: 1=Albert-Einstein-Schule, 2=Erich-Kästner-Schuler,…)

  • Vierte bis siebte Zahl: Alter der Versuchsperson in Tagen (zum Beispiel: 6323)

Wichtige Hinweise zur Nutzung von Calculated Fields

Da bei der Verwendung von Calculed Fields Bugs auftreten können, sollten diese nur für Ansichtszwecke, nicht aber als Basis für statistische Analysen genutzt werden. Generell solltet Ihr darauf achten, in Projekten möglichst wenige Calculated Fields mit möglichst einfachen Formeln zu verwenden.

Ein zentrales Problem ist, dass Calculated Fields nicht immer neu berechnet werden, wenn sich die zur Berechnung herangezogenen Daten geändert haben. Ein Beispiel: Ihr habt eine Berechnung in Variable X die auf einem Wert in Variable Y basiert. Dann wird das Ergebnis in Variable X nicht automatisch aktualisiert, sobald sich der Wert in Variable Y ändert. Wenn Ihr dann z.B. Daten exportiert, nachdem der Wert in Variable Y geändert wurde, ist der Wert in Variable X nicht mehr korrekt. Eine andere Fehlerquelle ist, dass Ihr Daten nicht im Formular eingegeben, sondern importiert habt. Auch dann werden Calculated Fields nicht immer automatisch berechnet.

Es gibt allerdings die Möglichkeit, mithilfe der Data-Quality-Rules die Werte in Calculated Fields zu überprüfen und gegebenenfalls zu korrigieren. Dafür geht ihr im linken Menü unter Applications auf "Data Quality" und führt dann die Data Quality Rule H "Incorrect values for calculated fields" aus.

Hier könnt Ihr ohne weiteres "Fix calcs now" anklicken, da es ja darum ging, Fehler in den Calculations zu entdecken, die aufgrund nachträglich eingegebener oder geänderter Werte entstanden sind.

Da während der Dateneingabe und bei der Ausführung der Data-Quality-Rules unterschiedliche Javascript-Algorithmen verwendet werden, kann es hier zu leichten Abweichungen kommen. Das ist für einfache Berechnungen vermutlich irrelevant. Alle Berechnungen die als Basis für statistische Analysen dienen, sollten jedoch sicherheitshalber in den entsprechenden Statistikprogrammen ausgeführt werden.

⚠️ **GitHub.com Fallback** ⚠️