Evaluator: Unterschied zwischen den Versionen
Keine Bearbeitungszusammenfassung |
|||
Zeile 2: | Zeile 2: | ||
Der Evaluator ist das Evaluierungswerkzeug, welches von JACK für Berechnungen aller Art (z.B. mathematische Berechnungen) verwendet wird. Der Evaluator wird daher sowohl für die Erzeugung von [[Variablen]] genutzt, als auch um die Prüfregeln für richtige Antworten bzw. Feedbacknachrichten in [[Fill In|Fill In Aufgaben]] auszuwerten. Er beherrscht eine Reihe von Funktionen, z.B. einfache arithmetische Operationen und Funktionen auf Zeichenketten, ist jedoch auch in der Lage, mit Computer Algebra Systemen zu sprechen und dort Auswertungen vornehmen zu lassen. Derzeit ist der Evaluator in der Lage, mit drei externen Systemen zu kommunizieren. Es handelt sich dabei um die Systeme ''Symja'', ''Sage'' und ''R''. Der Evaluator bietet neben den oben beschriebenen Basisfunktionen einige CAS-Funktionen an, welche bestimmte festgelegte Auswertungen in den externen Systemen vornehmen. So kann zum Beispiel mittels der Funktion ''isLinearlyIndependent'' geprüft werden, ob eine Menge von Vektoren linear unabhängig ist. Diese Funktion verwendet intern ''Sage'', um eine Entscheidung zu finden. Der Evaluator meldet das Ergebnis dann an den JACK Kern zurück, welcher dieses weiter verarbeitet. Zudem können mit dem Evaluator auch Funktionen logisch miteinander verknüpft werden, also durch "und", "oder" oder auch "nicht". Wird in einer Prüfregel einer [[Fill In|Fill In Aufgabe]] im Tag '''correctanwer''' oder '''feedback''' ein '''option'''-Tag verwendet, so wird der Ausdruck im Attribut ''result'' dem Evaluator übergeben: | Der Evaluator ist das Evaluierungswerkzeug, welches von JACK für Berechnungen aller Art (z.B. mathematische Berechnungen) verwendet wird. Der Evaluator wird daher sowohl für die Erzeugung von [[Variablen]] genutzt, als auch um die Prüfregeln für richtige Antworten bzw. Feedbacknachrichten in [[Fill In|Fill In Aufgaben]] auszuwerten. Er beherrscht eine Reihe von Funktionen, z.B. einfache arithmetische Operationen und Funktionen auf Zeichenketten, ist jedoch auch in der Lage, mit Computer Algebra Systemen zu sprechen und dort Auswertungen vornehmen zu lassen. Derzeit ist der Evaluator in der Lage, mit drei externen Systemen zu kommunizieren. Es handelt sich dabei um die Systeme ''Symja'', ''Sage'' und ''R''. Der Evaluator bietet neben den oben beschriebenen Basisfunktionen einige CAS-Funktionen an, welche bestimmte festgelegte Auswertungen in den externen Systemen vornehmen. So kann zum Beispiel mittels der Funktion ''isLinearlyIndependent'' geprüft werden, ob eine Menge von Vektoren linear unabhängig ist. Diese Funktion verwendet intern ''Sage'', um eine Entscheidung zu finden. Der Evaluator meldet das Ergebnis dann an den JACK Kern zurück, welcher dieses weiter verarbeitet. Zudem können mit dem Evaluator auch Funktionen logisch miteinander verknüpft werden, also durch "und", "oder" oder auch "nicht". Wird in einer Prüfregel einer [[Fill In|Fill In Aufgabe]] im Tag '''correctanwer''' oder '''feedback''' ein '''option'''-Tag verwendet, so wird der Ausdruck im Attribut ''result'' dem Evaluator übergeben: | ||
<option result="evaluatorfunktion">Feedback</option | <option result="evaluatorfunktion(...)">Feedback</option> | ||
Der Rückgabewert der verwendeten Funktion muss an dieser Stelle also zwingend ein Wahrheitswert sein. In den leeren Klammern müssen noch die Argumente der verwendeten Funktion ergänzt werden. Es können auch mehrere Funktionen folgendermaßen verknüpft werden: | |||
<option result="funktion1(...)&&funktion2(...)">Feedback</option> | |||
Die XML-Entity "&" steht für das ''&''-Zeichen. Zwei ''&''-Zeichen stehen wiederum für die logische "Und"-Verknüpfung. Der Ausdruck wird folglich als wahr ausgewertet, wenn beide verwendeten Funktionen wahr zurückgeben. Die "Oder"-Verknüpfung wird durch zwei senkrechte Striche ("||") erreicht und die "Nicht"-Verknüpfung durch das Ausrufungszeichen ("!"). | |||
=== Variablen erstellen === | === Variablen erstellen === |
Version vom 12. April 2017, 12:29 Uhr
Beschreibung
Der Evaluator ist das Evaluierungswerkzeug, welches von JACK für Berechnungen aller Art (z.B. mathematische Berechnungen) verwendet wird. Der Evaluator wird daher sowohl für die Erzeugung von Variablen genutzt, als auch um die Prüfregeln für richtige Antworten bzw. Feedbacknachrichten in Fill In Aufgaben auszuwerten. Er beherrscht eine Reihe von Funktionen, z.B. einfache arithmetische Operationen und Funktionen auf Zeichenketten, ist jedoch auch in der Lage, mit Computer Algebra Systemen zu sprechen und dort Auswertungen vornehmen zu lassen. Derzeit ist der Evaluator in der Lage, mit drei externen Systemen zu kommunizieren. Es handelt sich dabei um die Systeme Symja, Sage und R. Der Evaluator bietet neben den oben beschriebenen Basisfunktionen einige CAS-Funktionen an, welche bestimmte festgelegte Auswertungen in den externen Systemen vornehmen. So kann zum Beispiel mittels der Funktion isLinearlyIndependent geprüft werden, ob eine Menge von Vektoren linear unabhängig ist. Diese Funktion verwendet intern Sage, um eine Entscheidung zu finden. Der Evaluator meldet das Ergebnis dann an den JACK Kern zurück, welcher dieses weiter verarbeitet. Zudem können mit dem Evaluator auch Funktionen logisch miteinander verknüpft werden, also durch "und", "oder" oder auch "nicht". Wird in einer Prüfregel einer Fill In Aufgabe im Tag correctanwer oder feedback ein option-Tag verwendet, so wird der Ausdruck im Attribut result dem Evaluator übergeben:
<option result="evaluatorfunktion(...)">Feedback</option>
Der Rückgabewert der verwendeten Funktion muss an dieser Stelle also zwingend ein Wahrheitswert sein. In den leeren Klammern müssen noch die Argumente der verwendeten Funktion ergänzt werden. Es können auch mehrere Funktionen folgendermaßen verknüpft werden:
<option result="funktion1(...)&&funktion2(...)">Feedback</option>
Die XML-Entity "&" steht für das &-Zeichen. Zwei &-Zeichen stehen wiederum für die logische "Und"-Verknüpfung. Der Ausdruck wird folglich als wahr ausgewertet, wenn beide verwendeten Funktionen wahr zurückgeben. Die "Oder"-Verknüpfung wird durch zwei senkrechte Striche ("||") erreicht und die "Nicht"-Verknüpfung durch das Ausrufungszeichen ("!").
Variablen erstellen
Der Evaluator kann beim Erzeugen aufgabenbezogener Variablen innerhalb der ExerciseChain genutzt werden. Innerhalb des value-Attributs des <option>-Tags lassen sich Funktionen des Evaluators nutzen, um Aufgaben mit variablen Werten zu erstellen.
<variables> <option name="a" value="5"/> <option name="b" value="2"/> <option name="c" value="[var=a]*[var=b]"/> </variabls>
In diesem Beispiel werden die beiden Variablen a und b mit den Werten 5 bzw. 2 erstellt. Außerdem wird eine dritte Variable c erstellt, die das Produkt der beiden vorherigen Variablen bildet.
Neben den mathematischen Basisoperationen enthält der Evaluator diverse eigen-implementierte Funktionen, die teilweise auf externe Computer-Algebra-Systeme (Symja, Sage, R) zugreifen. Beim Benutzen einer solchen CAS-Funktion kann mittels des Attributs cas und den Werten symja, sage, R explizit angegeben werden, welches CAS verwendet werden soll.
<option name="b" value="factorial([var=a])" cas="R" />
In diesem Fall enthält die Variable b die Fakultät der Zahl, die in der Variablen a enthalten ist, berechnet mit Hilfe des CAS R.
Ergebnisauswertung
Der Evaluator wird ebenfalls bei der Auswertung von Aufgaben verwendet, konkreter bei dem result-Attribut innerhalb des <option>-Tags.
<correctanswer> <option result="[pos=1]==25*2"/> <message>Richtig! Das Ergebnis ist 50.</message> </correctanswer>
In diesem Beispiel wird überprüft, ob in dem ersten Fill In-Feld der Aufgabe der Wert 50 steht.
Hierbei versucht der Evaluator den Wert des result-Attributs, also den in Anführungszeichen stehenden Ausdruck, zu einem Boolean auszuwerten. Für eine korrekte Funktionsweise ist es deswegen wichtig, dass der dort stehende Ausdruck auch tatsächlich zu einem booleschen Ergebnis validiert werden kann. Auf diese Weise können viele mitunter sehr unterschiedliche Lösungs-Einreichungen von Aufgaben auf ihre Richtigkeit geprüft werden, ohne jede einzelne Möglichkeit explizit angeben zu müssen. Hierbei kann man genauso wie beim Erstellen von Variablen auf diverse Funktionen des Evaluators zurückgreifen.
Funktionen
Der Evaluator beinhaltet viele verschiedene Funktionen, die alle in JACK für die Aufgabendarstellung benutzt werden können. Hier geben wir eine vollständige Liste aller angebotenen Funktionen mit ihrer Funktionalität.
Hinweise
- Wenn man zwei oder mehr Funktionen miteinander verknüpft fallen die Anführungszeichen weg: equalsExpr(evalEq('5','5'),'0')