Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung |
de:create:functions:statistic [05.09.2023 20:29] – [statistic()] swissel.uni-mannheim | de:create:functions:statistic [08.03.2024 10:57] (aktuell) – [Teildatensätze auswerten] admin |
---|
====== statistic() ====== | ====== statistic() ====== |
| |
''mixed **statistic**(string //statistics//, array|string //variables//, mixed //option//, [boolean //AllData//])'' | ''mixed **statistic**(string //Statistik//, array|string //Variablen//, mixed //Option//, [boolean //AlleDaten//])'' |
| |
The function statistic() can be used to determine univariate characteristic values from the data set (across all previous interviews). | Mit der Funktion statistic() kann man univariate Kennwerte aus dem Datensatz ermitteln (über alle bisherigen Interviews hinweg). |
| |
* //Statistic//\\ Which statistic should be determined? | * //Statistik//\\ Welche Statistik soll ermittelt werden? |
* ''%%'count'%%'' -- Count the frequency of the value given as ''//option//''. | * ''%%'count'%%'' -- Die Häufigkeit des Wertes auszählen, der als ''//Option//'' angegeben ist. |
* ''%%'percent'%%'' -- Percentage of the value specified as ''//Option//''. | * ''%%'percent'%%'' -- Prozentualer Anteil des Wertes, der als ''//Option//'' angegeben ist. |
* ''%%'frequencies'%%'' -- frequencies for all response codes in the dataset (as an array). | * ''%%'frequencies'%%'' -- Häufigkeiten für alle Antwortcodes im Datensatz (als Array). |
* '''crosscount''' -- Count the frequency of co-occurrence of two values in two variables. The two variables are to be specified as an array (or separated by a comma), as are their values specified as ''//option//''. | * '''crosscount''' -- Die Häufigkeit des gemeinsamen Auftretens von zwei Werten in zwei Variablen auszählen. Die beiden Variablen sind als Array (oder durch ein Komma getrennt) anzugeben, ebenso deren Werte, die als ''//Option//'' angegeben werden. |
* '''mode''' -- most frequently occurring value. | * '''mode''' -- Häufigster vorkommender Wert. |
* '''min''' -- Smallest value. | * '''min''' -- Kleinster Wert. |
* '''max''' -- Largest value. | * '''max''' -- Größter Wert. |
* '''mean''' -- Arithmetic mean of the values. | * '''mean''' -- Arithmetisches Mittel der Werte. |
* '''groupmean''' -- Arithmetic mean of the values of a subgroup defined by //Option//, specified as a string consisting of variable name and code for the cases to be counted '''AB01=2'''. | * '''groupmean''' -- Arithmetisches Mittel der Werte einer Teilgruppe, welche durch ''//Option//'' definiert wird, angegeben als Sting bestehend aus Variablenname und Code für die zu zählenden Fälle '''AB01=2'''. |
* '''filter''' -- Specifies which cases to use in further calls to the function ''statistic()'' (see [[#teildatensaetze_auswerten|bottom]] for details). | * '''filter''' -- Legt fest, welche Fälle bei weiteren Aufrufen der Funktion ''statistic()'' verwendet werden sollen (Details s. unten [[#teildatensaetze_auswerten|bottom]]). |
| |
* //Variables//\\ Specifies for which variable(s) the statistic is to be calculated. The identifiers of the individual variables can be found in the **Variables overview**. If the statistic requires several variables, these can be specified either as a comma-separated string or as an array. | * //Variablen//\\ Legt fest, für welche Variable(n) die Statistik berechnet werden soll. Die Kennungen der einzelnen Variablen findet man in der Variablen-Übersicht. Falls die Statistik mehrere Variabeln benötigt, können diese entweder als Komma-separierter String oder als Array angegeben werden. |
* //Option//\\ Some statistics require or allow a third specification, which is given with this parameter (see below). | * //Option//\\ Einige Statistiken benötigen oder erlauben eine dritte Angabe, die mit diesem Parameter angegeben wird (s. unten). |
* //AllData//\\ This optional specification determines that not only the completed interviews but all interviews are included in the statistics. | * //AlleDaten//\\ Diese optionale Angabe legt fest, dass nicht nur die abgeschlossenen Interviews, sondern alle Interviews in die Statistik einfließen. |
| |
| |
$n = statistic('filter', false, '(SD02==1) AND (SD03 >= 35) AND (LANGUAGE == "ger")'); | $n = statistic('filter', false, '(SD02==1) AND (SD03 >= 35) AND (LANGUAGE == "ger")'); |
</code> | </code> |
| |
| Für den Vergleich mit Texten müssen selbige in Anführungszeichen stehen. Folgender Code würde z.B. alle Fälle betrachten, welche dieselbe Referenz (REF) haben wie das aktuelle Interview. |
| |
| <code php> |
| $n = statistic('filter', false, 'REF=="'.reference().'"'); |
| </code> |
| |
| Der Punkt fügt hier das ''%%REF=="%%'' mit der aktuellen Referenz und einem schließenden Anführungszeichen zusammen. Wenn das aktuelle Inteview mit der Referenz ''ABC'' gestartet wurde, wird der dritte Parameter also zu ''%%REF="ABC"%%'' berechnet. |