DynamicRChecker (Jack2): Unterschied zwischen den Versionen

Aus JACK Wiki
Zur Navigation springen Zur Suche springen
Keine Bearbeitungszusammenfassung
K (Mschypula verschob die Seite DynamicRChecker nach DynamicRChecker (Jack2))
 
(33 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
== Beschreibung ==
== Beschreibung ==
Der DynamicRChecker dient dazu, den vom Studierenden erzeugten Output mit dem erwarteten Output zu vergleichen. Dazu wird innerhalb des Checkers ein Testfall definiert, in dem der Code hinterlegt wird, der den zu erwarteten richtigen Output generiert. Dieser wird dann nach der Einreichung des Studierenden mit dem, vom Code des Studierenden, generierten Output verglichen. Optional kann je nach Bedarf der vom Studierenden übergebene Output über eine sog. <syntaxhighlight inline lang="xml">postprocessingFunction</syntaxhighlight> modifiziert werden.
== Der Post Code ==
Grundsätzlich ist es möglich, benutzerdefinierten Post Code in Aufgaben zu hinterlegen. Über den Tag <syntaxhighlight inline lang="xml">postCode</syntaxhighlight> kann entsprechender Code übergeben werden. Die wichtigsten Anwendungsfelder zur Verwendung von Post Code sind dabei:
* Code über mehr als eine Zeile: Ist der Code im Tag <syntaxhighlight inline lang="xml">expectedOutput</syntaxhighlight> länger als eine Zeile, bedarf es einer eigenen
* Postprocess-Funktion: Soll der vom Studierenden übergebene Output modifiziert werden, muss eine sog. Postprocess-Funktion definiert werden. Dazu wird innerhalb des Tags <syntaxhighlight inline lang="xml">postCode</syntaxhighlight> eine Funktion mit dem Namen <syntaxhighlight inline lang="xml">postprocess</syntaxhighlight> definiert, in der die benötigte Modifikation deklariert wird. Zusätzlich muss im


== Die Tags der DynamicChecker-Datei ==
== Die Tags der DynamicChecker-Datei ==


* '''metaInf:'''  
* '''metaInf:'''  
** '''numberOfInputArgs:'''
** '''numberOfInputArgs:''' Anzahl an Input-Argumenten (in der Regel <syntaxhighlight inline lang="xml">1</syntaxhighlight>)
** '''outputType:'''
** '''outputType:''' Output-Typ (in der Regel <syntaxhighlight inline lang="xml">double</syntaxhighlight>)
** '''preCode:'''
** '''preCode:''' Hier steht immer <syntaxhighlight inline lang="xml">testFunc &lt;- function(){</syntaxhighlight>.
** '''postCode:'''
** '''postCode:''' Unter diesem Tag wird, wenn benötigt, der Post Code definiert. Dazu können hinter <syntaxhighlight inline lang="xml">}</syntaxhighlight> die benötigten Funktionen definiert werden.
* '''testcases:'''  
* '''testcases:''' Hier können verschiedene Testfälle definiert werden.
** '''testcase:'''
** '''testcase:''' Innerhalb dieses Tags ist der entsprechende Testfall zu definieren.
*** '''feedback:'''
*** '''feedback:'''
*** '''postprocessingFunction:'''
*** '''postprocessingFunction (optional):''' Wird eine postprocess-Funktion benötigt, so ist hier postprocess (= der Name der Funktion) einzutragen 
*** '''input:'''
*** '''input:'''
*** '''penalty:'''  
*** '''penalty:''' Die Anzahl an Punkten, die beim falschen Lösen der Aufgabe abgezogen werden sollen.
*** '''expectedOutput:'''  
*** '''expectedOutput:''' Hier sollte der R-Code hinterlegt werden, der genau den R-Output ausgibt, der vom Studierenden erwartet wird. Es können auch Zufallszahlen, die in der exercise-Datei definiert wurden, innerhalb dessen verwendet werden.
*** '''errorFeedback:''' Hier kann ggf. Feedback angegeben werden, wenn die eingereichte Lösung des Studierenden als falsch evaluiert wird.
*** '''errorFeedback:''' Hier kann ggf. Feedback angegeben werden, wenn die eingereichte Lösung des Studierenden als falsch evaluiert wird.
** '''...:''' Wenn nötig, können weitere Testfälle definiert werden.
== Beispiele ==


== Beispiel ==
=== Beispiel 1 ===


Im vorliegenden Beispiel wird exemplarisch eine postprocess-Funktion definiert. Diese wählt den ersten Eintrag des vom Studierenden übergebenden R-Objekts aus, wandelt es in die Klasse <syntaxhighlight lang="R">numeric</syntaxhighlight> um und rundet es auf den ganzzahligen Teil herunter.
Im vorliegenden Beispiel wird exemplarisch eine postprocess-Funktion definiert. Diese wählt den ersten Eintrag des vom Studierenden übergebenden R-Objekts aus, wandelt es in die Klasse <syntaxhighlight inline lang="r">numeric</syntaxhighlight> um und rundet es auf den ganzzahligen Teil herunter.


=== XML-Datei ===
==== XML-Datei ====


<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
Zeile 47: Zeile 58:
</checkerconfiguration>
</checkerconfiguration>
</syntaxhighlight>
</syntaxhighlight>
<!--Beispiel 2 fehlt-->
[[category:Unvollständige Seite]][[category:Checker]]

Aktuelle Version vom 7. Juni 2023, 12:44 Uhr

Beschreibung

Der DynamicRChecker dient dazu, den vom Studierenden erzeugten Output mit dem erwarteten Output zu vergleichen. Dazu wird innerhalb des Checkers ein Testfall definiert, in dem der Code hinterlegt wird, der den zu erwarteten richtigen Output generiert. Dieser wird dann nach der Einreichung des Studierenden mit dem, vom Code des Studierenden, generierten Output verglichen. Optional kann je nach Bedarf der vom Studierenden übergebene Output über eine sog. postprocessingFunction modifiziert werden.

Der Post Code

Grundsätzlich ist es möglich, benutzerdefinierten Post Code in Aufgaben zu hinterlegen. Über den Tag postCode kann entsprechender Code übergeben werden. Die wichtigsten Anwendungsfelder zur Verwendung von Post Code sind dabei:

  • Code über mehr als eine Zeile: Ist der Code im Tag expectedOutput länger als eine Zeile, bedarf es einer eigenen
  • Postprocess-Funktion: Soll der vom Studierenden übergebene Output modifiziert werden, muss eine sog. Postprocess-Funktion definiert werden. Dazu wird innerhalb des Tags postCode eine Funktion mit dem Namen postprocess definiert, in der die benötigte Modifikation deklariert wird. Zusätzlich muss im

Die Tags der DynamicChecker-Datei

  • metaInf:
    • numberOfInputArgs: Anzahl an Input-Argumenten (in der Regel 1)
    • outputType: Output-Typ (in der Regel double)
    • preCode: Hier steht immer testFunc &lt;- function(){.
    • postCode: Unter diesem Tag wird, wenn benötigt, der Post Code definiert. Dazu können hinter } die benötigten Funktionen definiert werden.
  • testcases: Hier können verschiedene Testfälle definiert werden.
    • testcase: Innerhalb dieses Tags ist der entsprechende Testfall zu definieren.
      • feedback:
      • postprocessingFunction (optional): Wird eine postprocess-Funktion benötigt, so ist hier postprocess (= der Name der Funktion) einzutragen
      • input:
      • penalty: Die Anzahl an Punkten, die beim falschen Lösen der Aufgabe abgezogen werden sollen.
      • expectedOutput: Hier sollte der R-Code hinterlegt werden, der genau den R-Output ausgibt, der vom Studierenden erwartet wird. Es können auch Zufallszahlen, die in der exercise-Datei definiert wurden, innerhalb dessen verwendet werden.
      • errorFeedback: Hier kann ggf. Feedback angegeben werden, wenn die eingereichte Lösung des Studierenden als falsch evaluiert wird.
    • ...: Wenn nötig, können weitere Testfälle definiert werden.

Beispiele

Beispiel 1

Im vorliegenden Beispiel wird exemplarisch eine postprocess-Funktion definiert. Diese wählt den ersten Eintrag des vom Studierenden übergebenden R-Objekts aus, wandelt es in die Klasse numeric um und rundet es auf den ganzzahligen Teil herunter.

XML-Datei

<?xml version="1.0" encoding="iso-8859-1"?>
<checkerconfiguration>
  <metaInf>
    <numberOfInputArgs>1</numberOfInputArgs>
    <outputType>double</outputType>
    <preCode>testFunc &lt;- function(){</preCode>
    <postCode>}
		postprocess &lt;- function(w){
                        round(as.numeric(w[1]))
		}</postCode>
  </metaInf>
  <testcases>
    <testcase>
      <feedback></feedback>
      <postprocessingFunction>postprocess</postprocessingFunction>
      <input></input>
      <penalty>100</penalty>
      <expectedOutput>1</expectedOutput>
      <errorFeedback>Leider nicht richtig!</errorFeedback>
    </testcase>
  </testcases>
</checkerconfiguration>