JACK Wiki - Benutzerbeiträge [de]

Dynamischer Python Checker (JACK3)

2026-04-28T06:40:58Z

LGlaser: Anleitung für statische Tests hinzugefügt

Der [[Python (JACK3)|Aufgabentyp Python]] lässt sich automatisiert bewerten, indem Testfälle ausgeführt werden. Diese können z. B. einen erwarteter Wert mit dem tatsächlichen Wert vergleichen. Der Python-Checker von JACK3 kann nicht nur Punktzahlen und Feedback zurückgeben, sondern auch Traces aufzeichnen (welche Zeilen ausgeführt wurden und wie die Variablenbelegung beim Testfall war). Es lassen sich beliebig komplexe Testfälle und auch zufallsbasierte Tests schreiben sowie passgenaues Feedback, programmiert in Python, erzeugen.

{{Hinweis|In diesem Artikel werden [https://docs.python.org/3/tutorial/index.html grundlegende Python-Kenntnisse] vorausgesetzt.}}

Der Checker arbeitet auf Python 3.11. Aktuell ist es nicht möglich, eigene Module zum Check hinzuzufügen oder Pakete aus dem Python Package Index (PyPI) (über <code>pip</code>) zu laden. Das Paket [https://pandas.pydata.org/docs/user_guide/index.html pandas] ist vorinstalliert und kann durch den Testtreiber geladen werden, ansonsten sind ausschließlich Pakete der [https://docs.python.org/3.11/library/index.html Python-Standardbibliothek] nutzbar.

== Unterstützte Aufgabenstellungen ==
Der dynamische Python-Checker ist darauf ausgelegt, Funktionsaufrufe aufzuzeichnen und ihre Rückgabewerte zu prüfen. Dies funktioniert am besten mit folgenden Aufgabenstellungen:

* Schreiben Sie eine parameterlose Funktion, die ... zurückgibt.
* Schreiben Sie eine Funktion, die ... erwartet und ... zurückgibt.
* Schreiben Sie eine Funktion mit x Parametern, die mit dem ersten Parameter ... macht. (Um die Funktion zu prüfen, muss der Typ des ersten Parameters mutierbar sein, z. B. eine Liste.)

'''Beispiel''': ''Definieren Sie eine Funktion add. Die Funktion soll zwei Parameter entgegennehmen und das Ergebnis der Addition zurückgeben.'' Die erwartete Musterlösung für diesen Fall wäre:<syntaxhighlight lang="python3">
def add(a, b):
return a + b
</syntaxhighlight>Testfälle (s.u.) können diese Funktion dann mit verschiedenen Werten aufrufen und das Ergebnis prüfen.

'''Statische Tests & Codeanalyse''': Derzeit gibt es für Python keinen statischen (GReQL-)Checker. Der eingereichte Code kann allerdings indirekt auf Syntaxelemente überprüft werden, indem er händisch geparst wird. Hierzu können die Python-Bordmittel, insbesondere das [https://docs.python.org/3.11/library/ast.html AST (Abstract Syntax Trees)]-Modul für Syntaxbäume genutzt werden.

==Testtreiber für den Checker==
Grundsätzlich ist ein Testtreiber ein einzelnes Modul mit einer oder mehreren [https://docs.python.org/3.11/tutorial/controlflow.html#defining-functions parameterlosen Funktionen] ('''Testfälle'''), die nacheinander ausgeführt werden. In der Regel importiert der Testtreiber dabei das Modul mit dem eingereichten (zu testenden) Code. Dessen Name [[Python (JACK3)|wird im UI als "Modul-Pfad für studentischen Code"]] festgelegt.

Damit die Traces der Testfälle korrekt aufgezeichnet werden, wird jeder Testfall mit dem [https://book.pythontips.com/en/latest/decorators.html Decorator] <code>decorator</code> aus dem vorgegebenen <code>Communicator</code>-Modul gekennzeichnet. Der folgende Code zeigt ein Beispiel mit zwei Testfällen, jeweils ohne Inhalt:<syntaxhighlight lang="python3" line="1">
import Communicator
import Trace
import studentcode as s

@Communicator.decorator
def testcase1():
# TODO so something with s ...
pass

@Communicator.decorator
def testcase2():
# TODO so something with s ...
pass

if __name__ == '__main__':
print('Running test case 1...')
testcase1()
print('Running test case 2 ...')
testcase2()
</syntaxhighlight>

===API zum Zurückmelden von Ergebnissen ===
Innerhalb eines Testfalls werden Ergebnisse über das Modul <code>Trace</code> zurückgeliefert. Dieses Modul sammelt alle Punktzahlen und Feedback auf und berichtet diese am Ende der Ausführung. Es bietet folgende Funktion:<syntaxhighlight lang="python3">
def printResult(result: int, feedback: str = None):
"""
Reports a result.

:param result: Points which are reported. Must be between 0 and 100 (both inclusive).
:param feedback: Optional Feedback presented to the user.
"""
pass
</syntaxhighlight>{{Wichtig|In jedem Testfall muss <code>printResult</code> genau ein Mal tatsächlich aufgerufen werden!}}

===Schreiben von Testfällen===
Der Checker nutzt für das Tracing eine spezielle Kontrollflussanalyse, basierend auf Pythons [https://docs.python.org/3.11/reference/simple_stmts.html#the-assert-statement <code>assert</code>-Schlüsselwort] und Exceptions. Mit <code>assert</code> lassen sich Ausdrücke testen, die resultierende Exception lässt sich anschließend fangen und in Feedback umwandeln.

Ein möglicher Testfall 1 für das obige Beispiel wäre dementsprechend:<syntaxhighlight lang="python3" line="1" start="5">
@Communicator.decorator
def testcase1():
try:
# Berechnen des Ergebnisses mit dem "studentcode":
result = s.add(1, 0)
# zu prüfender Ausdruck:
assert result == 1

# Bei Erfolg: +25 Punkte
Trace.printResult(25)
except Exception:
# Bei Misserfolg: +0 Punkte mit Feedback-Nachricht
Trace.printResult(0, f"Erwartete Summe: 1, tatsächlich: {result}.")
</syntaxhighlight>Das Tracing reagiert auf alle Arten von Exceptions und zeigt im Falle eines <code>AssertionError</code>s (entweder händisch geworfen oder über <code>assert</code>) eine generische Fehlermeldung an, die mitteilt, dass der Testfall nicht bestanden wurde, sofern kein benutzerdefiniertes Feedback (zweiter Parameter von <code>printResult</code>) vorgegeben wurde. Zusätzlich wird die Variablenbelegung angezeigt und die ausgeführten Zeilen.

Pro Testtreiber werden die Punkte aller Testfälle aufsummiert. Bei einer gleichen Gewichtung von vier Testfällen wird jeder Testfall also 25 Punkte im Erfolg zurückmelden. Die summierten Punkte müssen zwischen 0 und 100 (jeweils inklusiv) liegen.

In Situationen, bei denen die Punktevergabe von anderen Testfällen abhängig ist (z. B. wenn ausschließlich Punkte vergeben werden sollen, wenn statische Checks erfolgreich waren), kann diese Logik auch in einem einzigen Testfall untergebracht werden. Punktzahl und (ggf. konkatenierte) Feedback(s) müssen dann entsprechend vom Testfall zusammengesetzt werden.

=== Statische Tests===
Mithilfe des [https://docs.python.org/3.11/library/ast.html AST]-Moduls kann der eingereichte Code in einen Syntaxbaum geparst werden. Dieser Syntaxbaum lässt sich mithilfe von Python-Code prüfen. Der folgende Testfall prüft beispielsweise, ob im eingereichten Code Importe enthalten sind:<syntaxhighlight lang="python3" line="1">
import Communicator
import Trace
import studentcode
import math
import ast

@Communicator.decorator
def static_check():
# Parsen in Syntaxbaum
with open(studentcode.__file__, mode="r", encoding="utf-8") as f:
source_code = f.read()
tree = ast.parse(source_code)

# Über Syntaxbaum iterieren und Importe suchen
import_detected = None
for node in ast.walk(tree):
if isinstance(node, (ast.Import, ast.ImportFrom)):
import_detected = node.lineno
print(f"Import in line {import_detected}")

# Feedback erzeugen
error_feedback = None
if import_detected is not None:
error_feedback = f"In Zeile {import_detected} wurde ein Import erkannt. Die Lösung sollte ohne Importe auskommen."

# Rückmeldung
try:
assert (error_feedback is None)
Trace.printResult(40) # Statischer Test bestanden
except Exception:
Trace.printResult(0, error_feedback) # Statischer Test nicht bestanden

if __name__ == "__main__":
static_check()
</syntaxhighlight>Dieser Test könnte beliebig erweitert werden, z. B. for-/while-Schleifen suchen oder Rekursion prüfen, indem Funktionsaufrufe auf eine bestimmte Funktion gesucht werden. Es ist wichtig, dass Aufrufe von <code>ast.walk</code> nicht ineinander verschachtelt werden – stattdessen sollten Elemente, über die ein zweites Mal iteriert werden soll, zwischengespeichert werden.

==Ressourcen==
Um das Entwickeln von Testfällen zu vereinfachen, haben wir einen Dummy gebaut, der die Funktion des Checkers simuliert. [[Medium:Tracing-Python-Checker-Dummy.zip|Den Dummy können Sie hier herunterladen.]] Folgende Dateien sind enthalten:

*<code>Trace.py</code> und <code>Communicator.py</code> simulieren die Funktion des Checkers.
*<code>testdriver.py</code> enthält vier Testfälle aus dem Beispiel oben und kann beliebig angepasst werden.
*<code>studentcode.py</code> enthält eine studentische Einreichung mit einem "Fehler", bei dem einer der Testfälle nicht bestanden wird.
*<code>run.py</code> ist ein Skript, das den Testtreiber ausführt und ausgibt, wie viele Punkte die Lösung ergeben würde.

Der Dummy kann mit dem Befehl <code>python run.py</code> ausgeführt werden (auf Linux-Systemen kann der Befehl auch <code>python3</code> lauten, auf Windows auch <code>py</code>).
{{Hinweis|Der Dummy arbeitet nicht exakt wie der Checker. Es gibt keine Garantie, dass Testtreiber, die mit dem Dummy funktionieren, auch genau so in JACK funktionieren. Testen Sie die Aufgabe deshalb immer auch in JACK!}}
[[Kategorie:Benutzerhandbuch]]
[[Kategorie:Checker]]

Python (JACK3)

2026-04-27T12:15:09Z

LGlaser: Schnellverweis zum Checker

''Siehe auch: [[Dynamischer Python Checker (JACK3)]]''

===Aufgabeninhalt===
In dem Bereich Aufgabeninhalt wird der Aufgabentext erstellt und spezifische Eingaben für den jeweiligen Aufgabenteil gemacht.
[[File:Aufgabentext.jpg|center|thumb|800px|Editor für den Aufgabentext]]
* '''Titel:''' Hier kann optional der Name des Aufgabenteils eingetragen werden.
* '''Aufgabentext:''' Im Aufgabentext steht die Aufgabenstellung. Der Editor für den Aufgabetext lässt sich öffnen in dem man reinklickt. In dem Fließtext kann Latex-Code verwendet werden, indem man diesen mit $-Zeichen einspannt. Der Editor bietet einige Formatierungen an wie z.B. fett, kursiv und unterstrichen. Einfache Tabellen können auch mithilfe des Editors erstellt werden. Wenn man den Button ''source code'' [[File:Icon-source_code.jpg|35px]] verwendet kann man HTML-Code nutzen. Über den Button '''Ressource Einfügen''' lässt sich ein hochgeladenes Bild oder ein Link in den Aufgabentext einfügen.

===Feedback===
* '''Gewichtung des Aufgabenteils:''' Gewichtung der Punktzahl eines Aufgabenteils innerhalb der Aufgabe.
* '''Verhalten bei internen Fehlern während der Überprüfung:''' Während der Überprüfung der studentischen Lösung können Fehler auftreten. Hier muss angegeben werden ob die '''Bearbeitung markiert und abgebrochen''' wird oder ob eine '''Nachricht ausgegeben und Bearbeitung fortgesetzt''' wird.
* '''Bewertungsverfahren:''' Hier lassen sich Checks definieren, die den eingereichten Code automatisch prüfen. Aktuell ist nur der [[Dynamischer Python Checker (JACK3)|'''dynamische Python Checker''']] verfügbar. Dieser führt Testfälle aus und zeichnet Traces auf.
** '''Gewichtung dieses Checks:''' Ein Python-Aufgabenteil kann mehrere Checks haben. Die Ergebnisse der Checks können unterschiedlich stark in der Gesamtbewertung einfließen.
** '''Timeout:''' Nach wie vielen Sekunden ein Check abbrechen soll.
** '''Module-Pfad für den studentischen Code:''' Name des Python-Moduls, das den eingereichten Code enthält. Diese Information muss beim Schreiben des Testtreibers berücksichtigt werden, um den passenden Import zu wählen. Dieses Feld muss ausgefüllt werden.
** Unter dem Modul-Pfad wird der '''Testtreiber''' für den dynamischen Test geschrieben. Siehe [[Dynamischer Python Checker (JACK3)]] für weitere Informationen.
* '''Feedback beim Überspringen:''' Der Lehrende kann jeden Python Aufgabenteil zum Überspringen anbieten. Dazu muss zunächst der Haken gesetzt werden. Danach gibt es noch die Möglichkeit einen Text den Lernenden anzuzeigen, wenn dieser diesen Aufgabenteil übersprungen hat. Den Text kann man durch Klicken in das Textfeld oder über das Icon [[File:Icon-Pencil.jpg|22px]] hinzufügen.
[[File:Python_Checker.JPG|center|thumb|800px|Einstellungen eines dynamischen Python-Checks]]

{{JACK3:Hinweise}}

===Verknüpfungen===
* '''Nächster Aufgabenteil (Standard):''' In dem Drop-Down Feld wird der nächste Zustand ausgewählt, in die die Aufgabe sein soll, wenn der Lernende eine Lösung eingereicht hat. Dieses wird immer dann durchgeführt, wenn keine andere Aktion zutrifft. Es gibt die folgenden Möglichkeiten:
** '''Nächster oder Ende:''' Dies ist die default Einstellung. Nach der studentischen Einreichung dieses Aufgabenteils wird der nächste Aufgabenteil in der Reihe angezeigt. Wenn dies der letzte Aufgabenteil dieser Aufgabe ist, ist die Aufgabe beendet.
** '''Ende der Aufgabe:''' Die Aufgabe ist mit der Aktion des Lernenden beendet.
** '''Aufgabenteil wiederholen:''' Der Aufgabenteil wird wiederholt. Der Lernende kann ein weiteres Ergebnis einreichen. Diese Aktion kann man z.B. bei Übungsaufgaben benutzen, wenn der Lernende eine Aufgabe solange wiederholen soll, bis das richtige Ergebnis eingereicht wurde.
** '''#x (x ist dabei ein beliebiger Aufgabenteil dieser Aufgabe):''' Der entsprechende Aufgabenteil wird als nächstes angezeigt. Wenn man die Aufgabenteilnummer des aktuellen Aufgabenteils wählt wird dieser Aufgabenteil neu aufgerufen.
* '''Nicht auf Feedback warten und sofort zum nächsten Aufgabenteil weiterschalten:''' Da Python-Checks je nach Anzahl der Testfälle und ihrer Komplexität länger dauern können, besteht die Möglichkeit, das Warten auf die Ergebnisse zu überspringen.
[[File:Verknuepfung_Java.JPG|center|thumb|800px|Verknüpfung mit anderen Aufgabenteilen]]
* '''Weitere nächste Aufgabenteile (optional):''' Hier kann die nächste Aktion dynamisch eingestellt werden, d.h. sie kann abhängig von der Variablen Konstelation sein oder von der Eingabe des Lernenden.
* '''Nächster Aufgabenteil beim Überspringen (optional):''' Hier wird eingestellt welcher nächste Aufgabenteil angezeigt werden soll, wenn der Lernende den Aufgabenteil übersprungen hat. Diese Einstellungsmöglichkeit steht nur zur Verfügung, wenn der Haken im Tab Feedback fürs Überspringen gesetzt wurde.

{{JACK3:Variablenupdates}}

{{JACK3:Dateien für Studierende}}

=== Variablen ===
Die folgenden [[Variablen (JACK3)|JACK-Variablen]] stehen für diesen Aufgabentyp zur Verfügung:

{| class="wikitable"
|-
! Name !! Beschreibung
|-
| <code>[input=code]</code>|| Der eingereichte Python-Code
|}

[[category:Benutzerhandbuch]]

Formeleditor Paletten (JACK3)

2026-04-07T08:40:02Z

LGlaser: LaTeX korrigiert

Die verschiedenen Paletten des [[Formeleditor (JACK3)|JACK3-Formeleditors]] sind in allen [[Fill-In (JACK3)|Fill-In Aufgaben]] einsetzbar. Hier werden die einzelnen Varianten charakterisiert.

== Mathematik-Paletten ==
{| class="wikitable"
!Name!!Formeleditor!!Inhalt
|-
|'''Ohne (Mathematik)'''
|
| Es wird keine Palette angezeigt. Eingegebene Formeln werden aber automatisch in die Anzeigeform des Formeleditors umgewandelt.
|-
|'''Einfach'''|| style="width: 60%" |<center>[[File:Formeleditor-Basic.jpg|130px]]</center>||
*Wurzeln
*Brüche
*Potenzen
*Beträge
|-
|'''Standard'''||<center>[[File:Formeleditor-Palette.jpg|400px]]</center>||
*Vergleichsoperationen
*$\pi$, $e^{1}$, $i$ und $\infty$
*Division, Potenzen, Beträge, Fakultät und $e^{x}$
*trigonometrische Funktionen ''Sinus'', ''Kosinus'' und ''Tangens''
*Logarithmen
*Wurzeln
*Integrale
*Summen-und Produktzeichen
*Determinante
*Vektoren und Matrizen
*Intervalle
|-
|'''Vollständig'''||<center>[[File:Formeleditor-PaletteFull1.jpg|350px]][[File:Formeleditor-PaletteFull2.jpg|350px]]</center>||
*Vergleichsoperationen
*$\pi$, $e^{1}$, $i$ und $\infty$
*Division, Potenzen, Beträge, Fakultät und $e^{x}$
*trigonometrische Funktionen ''Sinus'', ''Kosinus'' und ''Tangens''
*Logarithmen
*Wurzeln
*Integrale
*Limes
*Summen-und Produktzeichen
*Determinante
*Vektoren und Matrizen
*sämtliche trigonometrische Funktionen
*Intervalle
|-
|'''UDE Mathematikdidaktik'''||<center>[[File:Formeleditor UdeMathDidactics1.jpg|300px]] [[File:Formeleditor UdeMathDidactics2.jpg|300px]]</center> <center>[[File:Formeleditor UdeMathDidactics3.jpg|300px]] [[File:Formeleditor UdeMathDidactics4.jpg|300px]]</center>||
*Grundrechenarten
*Vergleichsoperatoren
*Brüche
*Potenzen
*Wurzeln
*Betrag
* Summen- und Produktformel
* Fakultät
*Mengen
*Durchschnitt
*Vereinigung
*Differenz
*leere Menge
*Intervalle
*Exponentialfunktion
*Logarithmusfunktionen
*$\pi$
*$i$
*$\infty$
* Vektoren
*Matrizen
*Determinante
*trigonometrische Funktionen
|}

== Chemie-Paletten ==

Die Eingabemöglichkeiten im Chemie-Formeleditor sind wie folgt:

* Durch Tippen von Großbuchstaben (optional gefolgt von einem Kleinbuchstaben) können Atome angegeben werden, beispielsweise $H$ (Wasserstoff) oder $Li$ (Lithium).
* Durch <code>Shift + Pfeil unten</code> kann die Anzahl der Atome in einem Molekül erreicht werden, beispielsweise $H_{2}$.
* Durch <code>Shift + Pfeil oben</code> kann die Ladung des Moleküls angegeben werden, beispielsweise $Ca^{2+}$.
* Operatoren <code>+</code> und <code>*</code> stehen zur Verfügung.
* Ganzzahlen können verwendet werden

{| class="wikitable"
!Name!!Formeleditor!!Inhalt
|-
|'''Ohne (Chemie)'''
|
|Es wird keine Palette angezeigt. Eingegebene Reaktionsgleichungen werden aber automatisch umgewandelt.
|-
|'''Reaktionsgleichung'''||<center>[[File:Formeleditor-PaletteChemicalReactionEquation.jpg|130px]] ||Ermöglicht die Eingabe von Reaktionsgleichungen und Molekülen
|}

[[category:Benutzerhandbuch]]

Formeleditor Paletten (JACK3)

2026-04-07T08:39:09Z

LGlaser: Aktualisierung der Palettennamen; Ergänzungen zum Chemie-Formeleditor

Die verschiedenen Paletten des [[Formeleditor (JACK3)|JACK3-Formeleditors]] sind in allen [[Fill-In (JACK3)|Fill-In Aufgaben]] einsetzbar. Hier werden die einzelnen Varianten charakterisiert.

== Mathematik-Paletten ==
{| class="wikitable"
!Name!!Formeleditor!!Inhalt
|-
|'''Ohne (Mathematik)'''
|
| Es wird keine Palette angezeigt. Eingegebene Formeln werden aber automatisch in die Anzeigeform des Formeleditors umgewandelt.
|-
|'''Einfach'''|| style="width: 60%" |<center>[[File:Formeleditor-Basic.jpg|130px]]</center>||
*Wurzeln
*Brüche
*Potenzen
*Beträge
|-
|'''Standard'''||<center>[[File:Formeleditor-Palette.jpg|400px]]</center>||
*Vergleichsoperationen
*$\pi$, $e^{1}$, $i$ und $\infty$
*Division, Potenzen, Beträge, Fakultät und $e^{x}$
*trigonometrische Funktionen ''Sinus'', ''Kosinus'' und ''Tangens''
*Logarithmen
*Wurzeln
*Integrale
*Summen-und Produktzeichen
*Determinante
*Vektoren und Matrizen
*Intervalle
|-
|'''Vollständig'''||<center>[[File:Formeleditor-PaletteFull1.jpg|350px]][[File:Formeleditor-PaletteFull2.jpg|350px]]</center>||
*Vergleichsoperationen
*$\pi$, $e^{1}$, $i$ und $\infty$
*Division, Potenzen, Beträge, Fakultät und $e^{x}$
*trigonometrische Funktionen ''Sinus'', ''Kosinus'' und ''Tangens''
*Logarithmen
*Wurzeln
*Integrale
*Limes
*Summen-und Produktzeichen
*Determinante
*Vektoren und Matrizen
*sämtliche trigonometrische Funktionen
*Intervalle
|-
|'''UDE Mathematikdidaktik'''||<center>[[File:Formeleditor UdeMathDidactics1.jpg|300px]] [[File:Formeleditor UdeMathDidactics2.jpg|300px]]</center> <center>[[File:Formeleditor UdeMathDidactics3.jpg|300px]] [[File:Formeleditor UdeMathDidactics4.jpg|300px]]</center>||
*Grundrechenarten
*Vergleichsoperatoren
*Brüche
*Potenzen
*Wurzeln
*Betrag
* Summen- und Produktformel
* Fakultät
*Mengen
*Durchschnitt
*Vereinigung
*Differenz
*leere Menge
*Intervalle
*Exponentialfunktion
*Logarithmusfunktionen
*$\pi$
*$i$
*$\infty$
* Vektoren
*Matrizen
*Determinante
*trigonometrische Funktionen
|}

== Chemie-Paletten ==

Die Eingabemöglichkeiten im Chemie-Formeleditor sind wie folgt:

* Durch Tippen von Großbuchstaben (optional gefolgt von einem Kleinbuchstaben) können Atome angegeben werden, beispielsweise (\H\) (Wasserstoff) oder (\Li\) (Lithium).
* Durch <code>Shift + Pfeil unten</code> kann die Anzahl der Atome in einem Molekül erreicht werden, beispielsweise (\H_{2}\).
* Durch <code>Shift + Pfeil oben</code> kann die Ladung des Moleküls angegeben werden, beispielsweise (\Ca^{2+}\).
* Operatoren <code>+</code> und <code>*</code> stehen zur Verfügung.
* Ganzzahlen können verwendet werden

{| class="wikitable"
!Name!!Formeleditor!!Inhalt
|-
|'''Ohne (Chemie)'''
|
|Es wird keine Palette angezeigt. Eingegebene Reaktionsgleichungen werden aber automatisch umgewandelt.
|-
|'''Reaktionsgleichung'''||<center>[[File:Formeleditor-PaletteChemicalReactionEquation.jpg|130px]] ||Ermöglicht die Eingabe von Reaktionsgleichungen und Molekülen
|}

[[category:Benutzerhandbuch]]

Formeleditor

2026-04-07T08:32:15Z

LGlaser: /* Chemie Editor */ Tippfehler

JACK bietet die Möglichkeit, Fill-In-Aufgaben um einen Editor zu erweitern, der die Eingabe mathematischer und chemischer Ausdrücke vereinfacht.

=Mathematik Editor=
Zum Einbinden des mathematischen Editors in eine Aufgabe muss der <code>exercise</code>-Tag um das Attribut <code>editor</code> mit einem passenden Wert ergänzt werden. Der mathematische Editor bietet eine Palette mit einer Vielfalt an mathematischen Ausdrücken an, die außerdem erweitert werden kann. In JACK gibt es die Möglichkeit eigene Paletten ([[Templatepaletten]]) zu erstellen und vorgefertigte [[Standardpaletten]] zu nutzen.

Um [[Standardpaletten]] einzubinden genügt es den Namen der Palette wie oben beschrieben anzugeben.

Um [[Templatepaletten]] einzubinden, muss die selbsterstellte XML Datei der Aufgabe hinzugefügt werden. Zusätzlich muss in dem <code>editor</code>-Tag der Stage Datei der Name der Datei + Dateiendung übergeben werden. Bsp.: <code>editor="MyPalette.xml"</code>

==Beispiel==
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="iso-8859-1"?>
<exercise type="fillIn" editor="basic">
...
...
</exercise>
</syntaxhighlight>

In dem Beispiel hat <code>editor</code> den Wert <code>basic</code>.
==Hinweise zum mathematischen Editor==

=== Eingabe mit Multiplikationszeichen ===
Damit der Formeleditor Terme richtig erkennen kann, muss zwischen den Variablen ein Multiplikationszeichen stehen.
::*Bsp.:
:::*<code>a^4c</code> kann vom Editor nicht erkannt werden
:::*<code>a^4*c</code> dieser Ausdruck wird vom Editor korrekt erkannt

===Mehrere Buchstaben werden als eine Variable zusammengefasst===
Der Formeleditor erlaubt Variablen mit mehrere Buchstaben.

::*Beispiele:
:::*Für <code>ca^4</code> wird als die Variable "ca" hoch 4 interpretiert.
:::*<code>x*y^2</code> führt zu <code>x*y*y</code>
:::*<code>x*yz^2</code> wird als die Variable "x" multipliziert mit der Variablen "yz" hoch vier interpretiert.
:::*<code>ab*ab</code> führt zu <code>(ab)^2</code>, wobei <code>ab</code> wieder als eine Variable erkannt wird.
:::*<code>abc</code> wird als Variable <code>abc</code> erkannt. Schreibt man aber <code>a*b*c</code> werden alle drei Buchstaben als einzelne Variablen erkannt.

=== Keine Palette anzeigen===
Es gibt die Möglichkeit die FillIn Kästchen des Formeleditors zu nutzen, ohne eine Palette anzuzeigen. Hierzu kann <code>editor="invisible"</code> gesetzt werden.

===Besondere Zeichen===
* <code>%</code>: Wird in einem FillIn Kästchen ein <code>%</code> eingefügt, wird ein Bruch anstelle eines <code>%</code> erstellt.

=Chemie Editor=
[[file:Beispiel_Chem.PNG|thumb|Stimulierendes Beispiel mit der Palette "palette_chemical_reaction_equation"]]
Um den chemischen Editor für eine Aufgabe zu nutzen muss dem Tag <code>exercise</code> das Attribut <code>domain</code> mit dem Wert "chem" und das Attribut <code>editor</code> mit Wert "palette_chemical_reaction_equation" oder "invisibleChem".

Durch tippen von Großbuchstaben (optional gefolgt durch einen Kleinbuchstaben) können Atome angegeben werden.
* Durch <code>Shift + Pfeil unten</code> kann die Anzahl der Atome in einem Molekül erreicht werden.
* Durch <code>Shift + Pfeil oben</code> kann die Ladung des Moleküls angegeben werden.
* Operatoren <code>+</code> und <code>*</code> stehen zur Verfügung.
* Ganzzahlen können verwendet werden

Die Palette "palette_chemical_reaction_equation" beinhaltet Elemente um Oxidationszahlen anzugeben und die Elemente, die mit <code> Shift + Pfeiltaste </code> erzeugbar sind. Diese können mit einem Mausklick eingefügt werden.

==Beispiel zum chemischen Editor==
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="iso-8859-1"?>
<exercise type="fillIn" domain="chem" editor="palette_chemical_reaction_equation">
...
...
</exercise>
</syntaxhighlight>

In dem Beispiel hat <code>editor</code> den Wert <code>palette_chemical_reaction_equation</code>.

=Allgemeine Hinweise zum Editor=

=== Mischen vom mathematischen und chemischen Formeleditor===
*Eine Mischung der beiden Editoren ist in einer Stage nicht möglich.
*Eine Mischung in verschiedenen Stages einer Aufgabe ist zwar möglich, sollte aber vermieden werden. Die korrekte Anzeige aller gemachten Eingaben ist im Falle einer Mischung nicht möglich.

=== erweitertes Steuern des Editorfeldes===
Der Formeleditor wird nur für ein Inputfeld angezeigt, wenn
:*in der Stage, wie oben beschrieben, ein Editor eingefügt wurde und beim Inputfeld '''nicht''' <code>editor="false"</code> gesetzt wurde.
:*in der Stage, wie oben beschrieben, ein Editor eingefügt wurde und beim Inputfeld <code>editor="true"</code> gesetzt wurde.
:*in der Stage '''kein''' Editor eingefügt wurde und beim Inputfeld <code>editor="true"</code> gesetzt wurde. Hierbei wird die ''palette6'' des mathematischen Editors als Defaultpalette angezeigt.

Für alle Fälle gilt, dass das Inputfeld '''kein''' Dropdownfeld sein darf!

==Weiterführende Links==
* [[Templatepaletten]]
* [[Standardpaletten]]

[[Category:Formeleditor]]

Dynamischer Python Checker (JACK3)

2026-02-03T07:43:43Z

LGlaser:

Der [[Python (JACK3)|Aufgabentyp Python]] lässt sich automatisiert bewerten, indem Testfälle ausgeführt werden. Diese können z. B. einen erwarteter Wert mit dem tatsächlichen Wert vergleichen. Der Python-Checker von JACK3 kann nicht nur Punktzahlen und Feedback zurückgeben, sondern auch Traces aufzeichnen (welche Zeilen ausgeführt wurden und wie die Variablenbelegung beim Testfall war). Es lassen sich beliebig komplexe Testfälle und auch zufallsbasierte Tests schreiben sowie passgenaues Feedback, programmiert in Python, erzeugen.

{{Hinweis|In diesem Artikel werden [https://docs.python.org/3/tutorial/index.html grundlegende Python-Kenntnisse] vorausgesetzt.}}

Der Checker arbeitet auf Python 3.11. Aktuell ist es nicht möglich, eigene Module zum Check hinzuzufügen oder Pakete aus dem Python Package Index (PyPI) (über <code>pip</code>) zu laden. Das Paket [https://pandas.pydata.org/docs/user_guide/index.html pandas] ist vorinstalliert und kann durch den Testtreiber geladen werden, ansonsten sind ausschließlich Pakete der [https://docs.python.org/3.11/library/index.html Python-Standardbibliothek] nutzbar.

== Unterstützte Aufgabenstellungen ==
Der dynamische Python-Checker ist darauf ausgelegt, Funktionsaufrufe aufzuzeichnen und ihre Rückgabewerte zu prüfen. Dies funktioniert am besten mit folgenden Aufgabenstellungen:

* Schreiben Sie eine parameterlose Funktion, die ... zurückgibt.
* Schreiben Sie eine Funktion, die ... erwartet und ... zurückgibt.
* Schreiben Sie eine Funktion mit x Parametern, die mit dem ersten Parameter ... macht. (Um die Funktion zu prüfen, muss der Typ des ersten Parameters mutierbar sein, z. B. eine Liste.)

'''Beispiel''': ''Definieren Sie eine Funktion add. Die Funktion soll zwei Parameter entgegennehmen und das Ergebnis der Addition zurückgeben.'' Die erwartete Musterlösung für diesen Fall wäre:<syntaxhighlight lang="python3">
def add(a, b):
return a + b
</syntaxhighlight>Testfälle (s.u.) können diese Funktion dann mit verschiedenen Werten aufrufen und das Ergebnis prüfen.

=== Statische Tests & Codeanalyse ===
Derzeit gibt es für Python keinen statischen (GReQL-)Checker. Der eingereichte Code kann allerdings indirekt auf Syntaxelemente überprüft werden, indem er händisch geparst wird. Hierzu können die Python-Bordmittel, insbesondere das [https://docs.python.org/3.11/library/ast.html AST (Abstract Syntax Trees)]-Modul genutzt werden.

== Aufbau eines Testtreibers ==
Grundsätzlich ist ein Testtreiber ein einzelnes Modul mit einer oder mehreren [https://docs.python.org/3.11/tutorial/controlflow.html#defining-functions parameterlosen Funktionen] ('''Testfälle'''), die nacheinander ausgeführt werden. In der Regel importiert der Testtreiber dabei das Modul mit dem eingereichten (zu testenden) Code. Dessen Name [[Python (JACK3)|wird im UI als "Modul-Pfad für studentischen Code"]] festgelegt.

Damit die Traces der Testfälle korrekt aufgezeichnet werden, wird jeder Testfall mit dem [https://book.pythontips.com/en/latest/decorators.html Decorator] <code>decorator</code> aus dem vorgegebenen <code>Communicator</code>-Modul gekennzeichnet. Der folgende Code zeigt ein Beispiel mit zwei Testfällen, jeweils ohne Inhalt:<syntaxhighlight lang="python3" line="1">
import Communicator
import Trace
import studentcode as s

@Communicator.decorator
def testcase1():
# TODO so something with s ...
pass

@Communicator.decorator
def testcase2():
# TODO so something with s ...
pass

if __name__ == '__main__':
print('Running test case 1...')
testcase1()
print('Running test case 2 ...')
testcase2()
</syntaxhighlight>

===API zum Zurückmelden von Ergebnissen===
Innerhalb eines Testfalls werden Ergebnisse über das Modul <code>Trace</code> zurückgeliefert. Dieses Modul sammelt alle Punktzahlen und Feedback auf und berichtet diese am Ende der Ausführung. Es bietet folgende Funktion:<syntaxhighlight lang="python3">
def printResult(result: int, feedback: str = None):
"""
Reports a result.

:param result: Points which are reported. Must be between 0 and 100 (both inclusive).
:param feedback: Optional Feedback presented to the user.
"""
pass
</syntaxhighlight>{{Wichtig|In jedem Testfall muss <code>printResult</code> genau ein Mal tatsächlich aufgerufen werden!}}

=== Schreiben von Testfällen ===
Der Checker nutzt für das Tracing eine spezielle Kontrollflussanalyse, basierend auf Pythons [https://docs.python.org/3.11/reference/simple_stmts.html#the-assert-statement <code>assert</code>-Schlüsselwort] und Exceptions. Mit <code>assert</code> lassen sich Ausdrücke testen, die resultierende Exception lässt sich anschließend fangen und in Feedback umwandeln.

Ein möglicher Testfall 1 für das obige Beispiel wäre dementsprechend:<syntaxhighlight lang="python3" line="1" start="5">
@Communicator.decorator
def testcase1():
try:
# Berechnen des Ergebnisses mit dem "studentcode":
result = s.add(1, 0)
# zu prüfender Ausdruck:
assert result == 1

# Bei Erfolg: +25 Punkte
Trace.printResult(25)
except Exception:
# Bei Misserfolg: +0 Punkte mit Feedback-Nachricht
Trace.printResult(0, f"Erwartete Summe: 1, tatsächlich: {result}.")
</syntaxhighlight>Das Tracing reagiert auf alle Arten von Exceptions und zeigt im Falle eines <code>AssertionError</code>s (entweder händisch geworfen oder über <code>assert</code>) eine generische Fehlermeldung an, die mitteilt, dass der Testfall nicht bestanden wurde, sofern kein benutzerdefiniertes Feedback (zweiter Parameter von <code>printResult</code>) vorgegeben wurde. Zusätzlich wird die Variablenbelegung angezeigt und die ausgeführten Zeilen.

Pro Testtreiber werden die Punkte aller Testfälle aufsummiert. Bei einer gleichen Gewichtung von vier Testfällen wird jeder Testfall also 25 Punkte im Erfolg zurückmelden. Die summierten Punkte müssen zwischen 0 und 100 (jeweils inklusiv) liegen.

== Ressourcen ==
Um das Entwickeln von Testfällen zu vereinfachen, haben wir einen Dummy gebaut, der die Funktion des Checkers simuliert. [[Medium:Tracing-Python-Checker-Dummy.zip|Den Dummy können Sie hier herunterladen.]] Folgende Dateien sind enthalten:

* <code>Trace.py</code> und <code>Communicator.py</code> simulieren die Funktion des Checkers.
* <code>testdriver.py</code> enthält vier Testfälle aus dem Beispiel oben und kann beliebig angepasst werden.
* <code>studentcode.py</code> enthält eine studentische Einreichung mit einem "Fehler", bei dem einer der Testfälle nicht bestanden wird.
* <code>run.py</code> ist ein Skript, das den Testtreiber ausführt und ausgibt, wie viele Punkte die Lösung ergeben würde.

Der Dummy kann mit dem Befehl <code>python run.py</code> ausgeführt werden (auf Linux-Systemen kann der Befehl auch <code>python3</code> lauten, auf Windows auch <code>py</code>).
{{Hinweis|Der Dummy arbeitet nicht exakt wie der Checker. Es gibt keine Garantie, dass Testtreiber, die mit dem Dummy funktionieren, auch genau so in JACK funktionieren. Testen Sie die Aufgabe deshalb immer auch in JACK!}}
[[Kategorie:Benutzerhandbuch]]
[[Kategorie:Checker]]

Kategorie:Geometry

2026-02-02T17:06:33Z

LGlaser: Navigationsvorlage eingefügt

Eine Auflistung aller Funktionen die mit geometrischen Formen arbeiten.

{{Navigation/Geometriefunktionen}}
[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Evaluatorfunktionenkategorie]]

Vorlage:Navigation/Geometriefunktionen

2026-02-02T17:05:50Z

LGlaser: LGlaser verschob die Seite Vorlage:Navigation/Koordinatenfunktionen nach Vorlage:Navigation/Geometriefunktionen, ohne dabei eine Weiterleitung anzulegen

<onlyinclude>{{Navigation
| TITEL = Geometriefunktionen
| INHALT =
Geometrische Figuren:
[[Coordinate]] •
[[Circle]] •
[[Polygon]] •
[[Rectangle]]

Prüfen von Koordinaten:
[[IsCoordinateInCircle]] •
[[IsCoordinateInPolygon]] •
[[IsCoordinateInRectangle]]

Abrufen von Koordinaten:
[[GetXCoordinate]] •
[[GetYCoordinate]]
}}</onlyinclude>

[[Kategorie:Navigationsvorlagen|Koordinatenfunktionen]]

Vorlage:Navigation/Geometriefunktionen

2026-02-02T17:05:02Z

LGlaser: Vervollständigung der Vorlage

Vorlage:Navigation/Numberfunktionen

2026-02-02T17:00:51Z

LGlaser: IsNaN nachgetragen

<onlyinclude>{{Navigation
| TITEL = Numberfunktionen ([[Übersicht Numberfunktionen|Übersicht]])
| INHALT =
[[EvaluatesToNumber]] •
[[IsNumber]] •
[[IsIntegerNumber]] •
[[IsNaturalNumber]] •
[[IsRationalNumber]] •
[[IsRealNumber]] •
[[IsMathematikerRealNumber]] •
[[IsNaN]]
}}</onlyinclude>

[[Kategorie:Navigationsvorlagen|Numberfunktionen]]

Dynamischer Python Checker (JACK3)

2026-02-02T16:51:41Z

LGlaser: Hinweis auf statische Codeanalyse

Der [[Python (JACK3)|Aufgabentyp Python]] lässt sich automatisiert bewerten, indem Testfälle ausgeführt werden. Diese können z. B. einen erwarteter Wert mit dem tatsächlichen Wert vergleichen. Der Python-Checker von JACK3 kann nicht nur Punktzahlen und Feedback zurückgeben, sondern auch Traces aufzeichnen (welche Zeilen ausgeführt wurden und wie die Variablenbelegung beim Testfall war). Es lassen sich beliebig komplexe Testfälle und auch zufallsbasierte Tests schreiben sowie passgenaues Feedback, programmiert in Python, erzeugen.

{{Hinweis|In diesem Artikel werden [https://docs.python.org/3/tutorial/index.html grundlegende Python-Kenntnisse] vorausgesetzt.}}

Der Checker arbeitet auf Python 3.11. Aktuell ist es nicht möglich, eigene Module zum Check hinzuzufügen oder Pakete aus dem Python Package Index (PyPI) (über <code>pip</code>) zu laden. Das Paket [https://pandas.pydata.org/docs/user_guide/index.html pandas] ist vorinstalliert und kann durch den Testtreiber geladen werden, ansonsten sind ausschließlich Pakete der [https://docs.python.org/3.11/library/index.html Python-Standardbibliothek] nutzbar.

== Unterstützte Aufgabenstellungen ==
Der dynamische Python-Checker ist darauf ausgelegt, Funktionsaufrufe aufzuzeichnen und ihre Rückgabewerte zu prüfen. Dies funktioniert am besten mit folgenden Aufgabenstellungen:

* Schreiben Sie eine parameterlose Funktion, die ... zurückgibt.
* Schreiben Sie eine Funktion, die ... erwartet und ... zurückgibt.
* Schreiben Sie eine Funktion mit x Parametern, die mit dem ersten Parameter ... macht. (Um die Funktion zu prüfen, muss der Typ des ersten Parameters mutierbar sein, z. B. eine Liste.)

'''Beispiel''': ''Definieren Sie eine Funktion add. Die Funktion soll zwei Parameter entgegennehmen und das Ergebnis der Addition zurückgeben.'' Die erwartete Musterlösung für diesen Fall wäre:<syntaxhighlight lang="python3">
def add(a, b):
return a + b
</syntaxhighlight>Testfälle (s.u.) können diese Funktion dann mit verschiedenen Werten aufrufen und das Ergebnis prüfen.

=== Statische Tests & Codeanalyse ===
Derzeit gibt es für Python keinen statischen (GReQL-)Checker. Der eingereichte Code kann allerdings indirekt auf Syntaxelemente überprüft werden, indem er händisch geparst wird. Hierzu können die Python-Bordmittel, insbesondere das [https://docs.python.org/3.11/library/ast.html AST (Abstract Syntax Trees)]-Modul genutzt werden.

== Aufbau eines Testtreibers ==
Grundsätzlich ist ein Testtreiber ein einzelnes Modul mit einer oder mehreren [https://docs.python.org/3.11/tutorial/controlflow.html#defining-functions parameterlosen Funktionen] ('''Testfälle'''), die nacheinander ausgeführt werden. In der Regel importiert der Testtreiber dabei das Modul mit dem eingereichten (zu testenden) Code. Dessen Name [[Python (JACK3)|wird im UI als "Modul-Pfad für studentischen Code"]] festgelegt.

Damit die Traces der Testfälle korrekt aufgezeichnet werden, wird jeder Testfall mit dem [https://book.pythontips.com/en/latest/decorators.html Decorator] <code>decorator</code> aus dem vorgegebenen <code>Communicator</code>-Modul gekennzeichnet. Der folgende Code zeigt ein Beispiel mit zwei Testfällen, jeweils ohne Inhalt:<syntaxhighlight lang="python3" line="1">
import Communicator
import Trace
import studentcode as s

@Communicator.decorator
def testcase1():
# TODO so something with s ...
pass

@Communicator.decorator
def testcase2():
# TODO so something with s ...
pass

if __name__ == '__main__':
print('Running test case 1...')
testcase1()
print('Running test case 2 ...')
testcase2()
</syntaxhighlight>

===API zum Zurückmelden von Ergebnissen===
Innerhalb eines Testfalls werden Ergebnisse über das Modul <code>Trace</code> zurückgeliefert. Dieses Modul sammelt alle Punktzahlen und Feedback auf und berichtet diese am Ende der Ausführung. Es bietet folgende Funktion:<syntaxhighlight lang="python3">
def printResult(result: int, feedback: str = None):
"""
Reports a result.

:param result: Points which are reported. Must be between 0 and 100 (both inclusive).
:param feedback: Optional Feedback presented to the user.
"""
pass
</syntaxhighlight>{{Wichtig|In jedem Testfall muss <code>printResult</code> genau ein Mal tatsächlich aufgerufen werden!}}

=== Schreiben von Testfällen ===
Der Checker nutzt für das Tracing eine spezielle Kontrollflussanalyse, basierend auf Pythons [https://docs.python.org/3.11/reference/simple_stmts.html#the-assert-statement <code>assert</code>-Schlüsselwort] und Exceptions. Mit <code>assert</code> lassen sich Ausdrücke testen, die resultierende Exception lässt sich anschließend fangen und in Feedback umwandeln.

Ein möglicher Testfall 1 für das obige Beispiel wäre dementsprechend:<syntaxhighlight lang="python3" line="1" start="5">
@Communicator.decorator
def testcase1():
try:
# Berechnen des Ergebnisses mit dem "studentcode":
result = s.add(1, 0)
# zu prüfender Ausdruck:
assert result == 1

# Bei Erfolg: +25 Punkte
Trace.printResult(25)
except Exception:
# Bei Misserfolg: +0 Punkte mit Feedback-Nachricht
Trace.printResult(0, f"Erwartete Summe: 1, tatsächlich: {result}.")
</syntaxhighlight>Das Tracing reagiert auf alle Arten von Exceptions und zeigt im Falle eines <code>AssertionError</code>s (entweder händisch geworfen oder über <code>assert</code>) eine generische Fehlermeldung an, die mitteilt, dass der Testfall nicht bestanden wurde, sofern kein benutzerdefiniertes Feedback (zweiter Parameter von <code>printResult</code>) vorgegeben wurde. Zusätzlich wird die Variablenbelegung angezeigt und die ausgeführten Zeilen.

Pro Testtreiber werden die Punkte aller Testfälle aufsummiert. Bei einer gleichen Gewichtung von vier Testfällen wird jeder Testfall also 25 Punkte im Erfolg zurückmelden. Die summierten Punkte müssen zwischen 0 und 100 (jeweils inklusiv) liegen.

== Ressourcen ==
Um das Entwickeln von Testfällen zu vereinfachen, haben wir einen Dummy gebaut, der die Funktion des Checkers simuliert. [[index.php?title=Medium:Tracing-Python-Checker-Dummy.zip|Den Dummy können Sie hier herunterladen.]] Folgende Dateien sind enthalten:

* <code>Trace.py</code> und <code>Communicator.py</code> simulieren die Funktion des Checkers.
* <code>testdriver.py</code> enthält vier Testfälle aus dem Beispiel oben und kann beliebig angepasst werden.
* <code>studentcode.py</code> enthält eine studentische Einreichung mit einem "Fehler", bei dem einer der Testfälle nicht bestanden wird.
* <code>run.py</code> ist ein Skript, das den Testtreiber ausführt und ausgibt, wie viele Punkte die Lösung ergeben würde.

Der Dummy kann mit dem Befehl <code>python run.py</code> ausgeführt werden (auf Linux-Systemen kann der Befehl auch <code>python3</code> lauten, auf Windows auch <code>py</code>).
{{Hinweis|Der Dummy arbeitet nicht exakt wie der Checker. Es gibt keine Garantie, dass Testtreiber, die mit dem Dummy funktionieren, auch genau so in JACK funktionieren. Testen Sie die Aufgabe deshalb immer auch in JACK!}}
[[Kategorie:Benutzerhandbuch]]
[[Kategorie:Checker]]

Vorlage:Navigation

2025-06-06T07:54:04Z

LGlaser: Vorlagenkategorie

<includeonly><div style="background: #eaf3ff; border: solid 1px #a3caff; padding-left: 10px; padding-right: 10px; line-height: 1.0em; text-align: center;">
{{#if: {{{TITEL|}}} | <div style="font-weight: bold;">
{{{TITEL}}}
</div> | }}
<div style="margin-top: 10px;">
{{{INHALT}}}
</div>
</div></includeonly>
<noinclude>Diese Vorlage bildet eine Navigationsleiste, ähnlich zu der in der [https://de.wikipedia.org/wiki/Vorlage:Navigationsleiste Wikipedia].

'''Benutzung:'''

<pre><nowiki>
{{Navigation
| TITEL = Titel hier einfügen
| INHALT =
[[Erste Seite]]&nbsp;&bull;
[[Zweite Seite]]&nbsp;&bull;
[[Dritte Seite]]&nbsp;&bull;
[[Vierte Seite]]
}}
</nowiki></pre>

Der Parameter <code>TITEL</code> ist optional.

'''Ergibt:'''

{{Navigation
| TITEL = Titel hier einfügen
| INHALT =
Erste Seite • 
Zweite Seite •
Dritte Seite •
Vierte Seite
}}
[[:Kategorie:Navigationsvorlagen|Liste aller Navigationsvorlagen]].

[[Kategorie:Navigationsvorlagen| ]]</noinclude>

Checkliste für Prüfungen mit JACK 3

2025-03-11T08:11:54Z

LGlaser: Hinweis auf PC-Hall konkretisiert

Hier finden Sie eine Checkliste zur erfolgreichen Durchführung von Prüfungen mit JACK3. Um eine möglichst reibungslose Prüfungsdurchführung zu ermöglichen, bitten wir Sie, folgende Punkte abzuarbeiten:

Bis '''zwei Wochen''' vor der Klausur:

* Die Klausur wurde über die [mailto:jack@paluno.uni-due.de Funktionsmail] angemeldet.

* Falls die Prüfung in einer [https://www.uni-due.de/zim/services/pc-pruefungen/pc-hall PC-Hall der Universität Duisburg-Essen] stattfindet: Die Klausur wurde beim [https://www.uni-due.de/zim/klausuranmeldung ZIM] angemeldet.

* Lehrende haben Editierrechte und einen Ordner in [[Verfügbare Kurse (JACK3)|''Verfügbare Kurse'']] auf dem/den Prüfungsserver/n erhalten.

Bis '''eine Woche''' vor der Klausur:

* Die Klausuraufgaben wurden auf den/die Prüfungsserver importiert.

* Alle Bilder in den Aufgaben wurden erneut in der Aufgabe verlinkt.

* Es wurde ein Kurs erstellt, die Aufgaben dort eingefügt und die Punkte für die Aufgaben angepasst.

* Es wurde ein Kursangebot erstellt, der Kurs eingebunden und das Kursangebot konfiguriert.

* Die Klausur wurde aus Studierendensicht auf technische Korrektheit geprüft.

* Die Klausur wurde aus Studierendensicht auf inhaltliche Korrektheit geprüft.

=== Weitere Hinweise ===
* Das JACK-Team übernimmt keine Verantwortung für die Korrektheit der Aufgaben, Kurse und Kursangebote.

* Für neue Kunden wird einmalig ein Mitarbeiter vor Ort für die Betreuung der Klausur in der PC-Hall bereitgestellt.

* Das JACK-Team steht im Zeitraum ''vor'' diesen zwei Wochen stets gerne für Beratungen und Schulungen zu allen Themen zur Verfügung, um eine störungsfreie und erfolgreiche Durchführung der Prüfungen zu gewährleisten.

IsNaN

2025-03-11T08:08:13Z

LGlaser: typo

{{Navigation/Numberfunktionen}}

=== Zugehörige Evaluatoren ===
*'''MathEvaluator'''

=== Beschreibung ===
Die Funktion ''IsNaN'' prüft nach dem IEEE-Standard 754, ob eine Fließkommazahl "[https://de.wikipedia.org/wiki/NaN Not a Number]" ist.

Siehe auch [[Übersicht Numberfunktionen]].

=== Syntax ===
isNaN(a)

=== Parameter ===
* '''a''' - [[Objekt]]

=== Return Value ===
*Gibt True (wahr) oder False (nicht wahr) zurück

=== Beispiele ===
==== Standardfälle ====
isNaN(4) --> returns ''true''

isNaN(-1245) --> returns ''true''

isNaN(2.5) --> returns ''false''

[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Testfunktionen]][[Kategorie:JACK3]]

Übersicht Numberfunktionen

2025-03-11T08:07:29Z

LGlaser: /* IsNaN */ typo

{{Navigation/Numberfunktionen}}

== Funktionsweise ==
Im Mathe-Evaluator gibt es sechs verschiedene Funktionen, mit denen getestet werden kann, ob die Eingabe zu einer bestimmten Zahlengruppe gehört:

=== [[IsNumber]] ===
* Gibt <code>true</code> zurück, wenn
** die Eingabe eine Zahl ist oder
** sich die Eingabe zu einer Zahl ausrechnen lässt.
* '''Gibt auch für komplexe Zahlen true zurück.'''
=== [[IsIntegerNumber]] ===
* Gibt <code>true</code> zurück, wenn
** die Eingabe ein Integer ist.
* '''Die Eingabe wird nicht ausgerechnet.'''
=== [[IsNaturalNumber]] ===
* Gibt <code>true</code> zurück, wenn
** die Eingabe eine natürliche Zahl oder
** Null ist.
* '''Die Eingabe wird nicht ausgerechnet.'''
=== [[IsRationalNumber]] ===
* Gibt <code>true</code> zurück, wenn
** die Eingabe eine rationale Zahl ist.
* '''Die Eingabe wird nicht ausgerechnet.'''
=== [[IsRealNumber]] ===
* Gibt <code>true</code> zurück, wenn sich die Eingabe zu einer reellen Zahl ausrechnen lässt und
** es sich um eine ganze oder Fließkomma-Zahl handelt,
** es sich um <code>+/- e</code> oder <code>+/- pi</code> handelt,
** es sich um einen Bruch handelt, bei dem Zähler und Nenner eine ganze Zahl/Fließkommazahl/<code>e</code>/<code>pi</code> sind oder
** es sich um eine Wurzel handelt und der Term unter der Wurzel obigen Kriterien entspricht.
=== [[IsMathematikerRealNumber]] ===
* Gibt <code>true</code> zurück, wenn
** die Eingabe sich nicht zu Unendlich ausrechnen lässt,
** die Eingabe sich zu einer reellen Zahl ausrechnen lässt und
** die Eingabe nicht weiter vereinfacht werden kann.
* Die Eingabe ist vereinfachbar, wenn
** sie mindesten einen Operanten enthält (<code>+, -, *, /, ^, sqrt</code>) und
** sie sich zu einer Ganzzahl ausrechnen lässt.
=== [[IsNaN]] ===
* Gibt <code>true</code> zurück, wenn
** es sich bei der Eingabe um '''keine''' Zahl des [https://de.wikipedia.org/wiki/NaN IEEE-Standard 754] handelt

== Vergleich ==
In folgender Tabelle wird verglichen, welche Rückgabe die Funktionen für verschiedene Eingaben liefern:
{| class="wikitable"
|+ Ausgaben der Funktionen bei verschiedenen Eingaben
|-
! !! $2$ !! $0$ !! $-4$ !! $4.6$ !! $\frac{2}{3}$ !! $\sqrt{\frac{4}{4}}$ !! $1+3$ !! $i$ !! $\infty$
|-
| IsNumber || True || True || True || True || True || True || True || True || style="background-color: silver;" |False
|-
| IsIntegerNumber || True || True || True || style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False
|-
| IsNaturalNumber || True || True || style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False
|-
| IsRationalNumber || True || True || True || True || True || style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False
|-
| IsRealNumber || True || True || True || True || True || True || style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False
|-
| IsMathematikerRealNumber || True || True || True || True || True || style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False
|}

[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Testfunktionen]][[Kategorie:JACK2]][[Kategorie:JACK3]]

Formeleditor (JACK3)

2025-03-06T13:37:24Z

LGlaser: Kleine Korrekturen, '/' zu besonderen Zeichen hinzugefügt

JACK3 bietet die Möglichkeit, [[Fill-In (JACK3)|Fill-In Aufgaben]] um einen Formeleditor zu erweitern. Dieser unterstützt bei der Eingabe von mathematischen und chemischen Ausdrücken.

=== Allgemeine Informationen ===
Zum Einbinden des Formeleditors in einer Aufgabe muss in dem Aufgabenteil unter Formeleditor eine ''Palette'' ausgewählt werden und für das jeweilige Inputfeld in dem Drop-Down Feld ''Formeleditor''.

[[File:FillIn_Felder_Lehrender.JPG|center|thumb|800px|Einbinden des Formeleditors für Fill-In Felder]]{{Hinweis|In einer Aufgabe dürfen die beiden Formeleditoren Mathe und Chemie nicht gemischt werden.|Wichtig}}Der Formeleditor wird nur für ein Inputfeld angezeigt, wenn in dem Aufgabenteil ein Formeleditor ausgewählt wurde und bei dem Inputfeld ''Formeleditor'' gewählt wurde.

Bei beiden, Mathematik und Chemie, kann man sich auch keine Palette anzeigen lassen, aber trotzdem die Funktionen nutzen. Für Mathematik wählt man dafür <code>invisible</code> aus und für Chemie <code>invisibleChem</code>.

=== Mathematik Formeleditor ===
====Mehrere Buchstaben werden zu einer Variable zusammengefasst====
Der Formeleditor erlaubt Variablen mit mehreren Buchstaben. Beispiele:
* Für <code>ca^4</code> wird als die Variable ''ca'' hoch 4 interpretiert.
* <code>x*y^2</code> führt zu <code>x*y*y</code>
* <code>x*yz^2</code> wird als die Variable ''x'' multipliziert mit der Variable ''yz'' hoch 2 interpretiert.
* <code>ab*ab</code> führt zu <code>(ab)^2</code>, wobei <code>ab</code> wieder als '''eine''' Variable erkannt wird.
* <code>abc</code> wird als Variable ''abc'' erkannt. Schreibt man aber <code>a*b*c</code> werden alle drei Buchstaben als einzelne Variablen erkannt.

====Besondere Zeichen====
<code>%</code> und <code>/</code>: Fügt in einem Fill-In-Feld mit Formeleditor einen Bruch ein.

=== Chemie Formeleditor ===
[[File:Formeleditor-Chemie.jpg|thumb|Beispiel mit der Palette "palette_chemical_reaction_equation"]]
Für Chemie stehen die beiden Formeleditoren ''invisibleChem'' und ''palette_chemical_reaction_equation'' zur Verfügung.

Durch Tippen von Großbuchstaben (optional gefolgt durch einen Kleinbuchstaben) können Atome angegeben werden.
* Durch <code>Shift + Pfeil unten</code> kann die Anzahl der Atome in einem Molekül erreicht werden.
* Durch <code>Shift + Pfeil oben</code> kann die Ladung des Moleküls angegeben werden.
* Operatoren <code>+</code> und <code>*</code> stehen zur Verfügung.
* Ganzzahlen können verwendet werden.

Die Palette ''palette_chemical_reaction_equation'' beinhaltet Elemente um Oxidationszahlen anzugeben und die Elemente, die mit <code>Shift + Pfeiltaste</code> erzeugbar sind. Diese können mit einem Mausklick eingefügt werden.

===Weitere Links===
* [[Formeleditor Paletten (JACK3)|Formeleditor-Paletten]]
* [[Fill-In (JACK3)|Fill-In]]

[[Kategorie:Benutzerhandbuch]]

RandomUniqueIntegersBetween

2025-03-04T07:34:43Z

LGlaser: typo

{{Vorlage:Warnung|Warnung=Diese Seite ist beinhaltet eine Evaluatorfunktion für JACK3.}}

===Zugehörige Evaluatoren===
*'''MathEvaluator'''

===Beschreibung===
Die Funktion ''randomUniqueIntegersBetween'' zieht eine vorgegebene Anzahl an zufälligen und unterschiedlichen [[Ganzzahl|Ganzzahlen]] aus einem vorgegebenen Bereich. Es werden keine Zahlen doppelten gezogen. Die gezogenen [[Ganzzahl|Ganzzahlen]] sind dabei inklusiv der unteren Grenze und exklusiv der oberen Grenze. Die Anzahl zu ziehender Zahlen darf nicht größer als der Abstand zwischen der unteren und oberen Grenze sein.

===Syntax===
randomUniqueIntegersBetween(int anzahl, int untereGrenze, int obereGrenze)

===Parameter===
* '''anzahl''' - [[Ganzzahl]] Anzahl an Zufallszahlen
* '''untereGrenze''' - [[Ganzzahl]] untere Grenze (inklusiv)
* '''obereGrenze''' - [[Ganzzahl]] obere Grenze (exklusiv)

===Return Value===
* Gibt eine [[List|Liste]] zurück, welche aus [[Ganzzahl]]en besteht.

===Beispiele===
randomUniqueIntegersBetween(2, 2, 6) --> returns (zum Beispiel) 2, 4

randomUniqueIntegersBetween(3, 1, 10) --> returns (zum Beispiel) 3, 7, 8

randomUniqueIntegersBetween(1, 4, 10) --> returns (zum Beispiel) 9

===Hinweise===
* Weitere Funktionen die zufällig Zahlen ziehen sind: [[random]], [[randomBetween]], [[randomIntegerBetween]].

[[Kategorie:Math-Evaluatorfunktion]]

Vorlage:Navigation/Geometriefunktionen

2025-02-27T10:38:39Z

LGlaser: Reihenfolge geändert

<onlyinclude>{{Navigation
| TITEL = Funktionen mit Koordinaten
| INHALT =
Geometrische Figuren:
[[Coordinate]] •
[[Circle]] •
[[Polygon]] •
[[Rectangle]]

Prüfen von Koordinaten:
[[IsCoordinateInCircle]] •
[[IsCoordinateInPolygon]] •
[[IsCoordinateInRectangle]]
}}</onlyinclude>

[[Kategorie:Navigationsvorlagen|Koordinatenfunktionen]]

Benutzer:LGlaser/FAQ (JACK3)

2025-02-24T08:43:26Z

LGlaser: Funktionsaccount hinzugefügt

{{Hinweis|Diese Seite befindet sich noch im Aufbau}}

Auf dieser Seite finden Sie häufige Fragen zu JACK3.

==Allgemeines==

=== Kann unsere Arbeitsgruppe einen Funktionsaccount bekommen, damit mehrere Personen an den Inhalten arbeiten können? ===
Das ist in JACK3 nicht vorgesehen. Nutzen Sie stattdessen die [[Rechte bearbeiten (JACK3)|Rechtevergabe]], um Inhalte mit anderen Personen zu teilen. Es gibt außerdem die Option, [[Benutzergruppe (JACK3)|Benutzergruppen]] anzulegen, über die Inhalte mit mehreren Benutzern gleichzeitig geteilt werden können.

=== Warum kann ich Aufgaben / Kurse nicht löschen?===
Aufgaben und Kurse können nur dann gelöscht werden, wenn ...

*sie nicht mehr in Benutzung sind, d.h. ein Kurs nicht in einem Kursangebot verwendet wird und eine Aufgabe nicht in einem Kurs.
*es keine Bearbeitungen von Studierenden mehr für die Aufgabe / den Kurs gibt.

Sollte aus einem der beiden Gründe ein Löschen nicht möglich sein, können die entsprechenden Aufgaben/Kurse jederzeit umorganisiert werden, z. B. in einen ''Papierkorb''-Ordner verschoben werden.

==Aufgaben ==

===Es ist ein Fehler aufgetreten und diese Aufgabe kann nicht mehr ordnungsgemäß angezeigt werden. - Wie erfahre ich, was den Fehler verursacht hat?===
In den Bearbeitungsdetails (Aufgabe bearbeiten → Details → über die Lupe gehen), anschließend wird der genaue Grund (z. B. fehlgeschlagenes Variablenupdate) im entsprechenden Aufgabenteil angezeigt. Auch im unteren Bereich unter "Verlauf der Bearbeitung" ist die genaue Fehlermeldung zu sehen.

== Kurse==

===Was ist der Unterschied zwischen Kursen und Kursangeboten?===
Siehe [[Glossar (JACK3)#Kursangebot|Glossar → Kursangebot]].

==Kursangebote==

=== Wie kann ich Anmeldedaten zu mehreren (parallelen) Kursangeboten exportieren?===
Gehen Sie zu den "Verfügbaren Kursen", öffnen Sie mittels eines Rechtsklicks das Kontextmenü des Ordners, in dem die Kursangebote liegen und wählen Sie anschließend "Teilnehmerdaten anzeigen" aus. Die nun angezeigte Tabelle zeigt eine Übersicht über Teilnehmer aller Kursangebote innerhalb des markierten Ordners. Über die "Download"-Schaltfläche können Sie die Daten exportieren.

===Warum ist mein Kursangebot für Studierende nicht sichtbar?===
Dies ist in der Regel auf die [[Kursangebot Einstellungen (JACK3)#Zugangsbeschränkung|Zugangsbeschränkungen]] zurückzuführen. Prüfen Sie den Sichtbarkeitszeitraum und die Filter-Einstellungen des Kursangebots. Stellen Sie zudem sicher, dass der Kurs über die korrekte URL (insb. die korrekte Serveradresse, z. B. <code>jack-server20.s3.uni-due.de</code>) besucht wird.

==Bearbeitungen==

===Warum kann ich Bearbeitungen nicht löschen?===
JACK3 beinhaltet ein komplexes [[Rechtekonzept (JACK3)|Rechtekonzept]], bei dem detailliert festgelegt ist, welcher Benutzer welche Aktionen durchführen darf. Da es beim Löschen von Bearbeitungen um Daten geht, die relevant für eine Bewertung sind, sind ''Bewertungsrechte'' erforderlich, um Bearbeitungen von Studierenden zu löschen. Zusätzlich ist der ''Zugriffsweg'' relevant: Reguläre Bearbeitungen zu einem Kursangebot können nur in der Teilnehmerübersicht aus dem Kursangebot heraus gelöscht werden. Testbearbeitungen zu einem Kurs können nur in der Teilnehmerübersicht aus dem Kurs heraus gelöscht werden.

===Warum kann ich kein manuelles Feedback setzen?===
Prüfen Sie, ob Sie [[Rechtekonzept (JACK3)#Bewertungsrecht (B)|Bewertungsrecht]] am aufgerufenen Inhalt besitzen ''und'' ob Sie vom Kursangebot, nicht aus einer Aufgabe heraus kommen. Den aktuellen Zugriffsweg sehen Sie im Header der Seite.

==Evaluator ==

===Welche Funktionen kann ich im Evaluator nutzen?===
Eine Auflistung der unterstützten Funktionen finden Sie unter [[:Kategorie:Math-Evaluatorfunktion|Math-Evaluatorfunktion]] bzw. [[:Kategorie:Chem-Evaluatorfunktion|Chem-Evaluatorfunktion]]. Für jede Funktion gibt es auch diverse Beispiele. Überall dort, wo Evaluatorausdrücke erwartet werden, kann mit diesen Funktionen und [[Variablen (JACK3)|JACK-Variablen]] gerechnet werden.

Benutzerhandbuch (JACK3)

2025-02-24T08:37:11Z

LGlaser: Schnelleinstieg prominenter verlinkt

Dies ist das Benutzerhandbuch der neuesten Version JACK3. Hier finden Sie alle wichtigen Information von "Wie erstelle ich eine Aufgabe?" über "Wie lasse ich meine Studierende die Aufgaben bearbeiten?" bis "Wie lässt sich in die studentische Abgaben einsehen?".
Bitte beachten Sie, dass dies noch in Arbeit ist und noch nicht vollständig ist. Es kommen noch weitere Abschnitte hinzu und andere werden noch ausgebaut.

==[[Schnelleinstieg (JACK3)|Schnelleinstieg]]==
[[Schnelleinstieg (JACK3)|Hier]] ist eine Anleitung für den Schnelleinstieg in JACK3. Mit dieser Anleitung lässt sich schnell eine Aufgabe erstellen und diese Studierenden zur Verfügung stellen. Dabei werden nur die wichtigsten Einstellungen betrachtet. Für weitere Details stehen die folgenden Seiten zur Verfügung.

Zum schnellen Finden einzelner Seiten kann auch die [[:Category:Benutzerhandbuch|A-Z]] Liste genutzt werden.

==Allgemeine Informationen und Hinweise zum Start==
Beschreibung der globalen Einstellungen, die ein Nutzer in JACK3 tätigen kann.
Nachdem Aufrufen von JACK3 erscheint zunächst die [[Login (JACK3)|Login]] Seite, auf der man sich in das e-Assessment System JACK3 einloggen können. JACK3 Terminologie kann im [[Glossar (JACK3)|Glossar]] nachgeschlagen werden.
* [[Hauptseite (JACK3)|Hauptseite]] - Erklärung der [[Hauptseite (JACK3)|Hauptseite]], die nach dem Einloggen in das E-Assessment System JACK erscheint.
* [[Mein Account (JACK3)|Mein Account]] - Einstellungsmöglichkeiten des eigenen Benutzerskontos.
* [[Verfügbare Kurse (JACK3)|Verfügbare Kurse]] - Unter [[Verfügbare Kurse (JACK3)|Verfügbare Kurse]] können Lehrende Kursangebote erstellen, die dann von den Studierenden bearbeitet werden. Studierende sehen hier alle [[Kursangebot (Studierendensicht)|Kursangebote]], die sie bearbeiten können.
* [[Meine Teilnahmen (JACK3)|Meine Teilnahmen]] - Hier erscheinen die aktuell laufenden Kurse.
* [[Mein Arbeitsbereich (JACK3)|Mein Arbeitsbereich]] - Kurse und Aufgaben werden in diesem Bereich erstellt.
* [[Spracheinstellung (JACK3)|Spracheinstellung]] - Die Spracheinstellung wirkt sich nur global auf die Seiten aus und nicht auf die Aufgaben selber.
* [[Glossar (JACK3)|Grundlegende Konzepte / Glossar]] - Erklärung der Grundlegenden Konzepte in JACK3, die zum Teil für die Benutzung sehr wichtig sind.
* [[Variablen (JACK3)|Variablen]] - Variablentypen von JACK3 (insb. Aufgaben-Variablen) und die Verwendung

==Aufgaben erstellen / testen==
In diesem Abschnitt wird alles beschrieben, was sich mit einer einzelnen Aufgabe beschäftigt. Es beginnt mit globalen Einstellungen für eine Aufgabe, die Erstellung der verschiedenen Aufgabentypen, bis zum Testen der erstellten Aufgabe.
* [[Aufgaben Konfiguration (JACK3)|Aufgaben Konfigurationen / Einstellungen]]
** [[Aufgaben Einstellungen (JACK3)|Einstellungen]] - globalen Einstellungen der Aufgabe
** [[Variablenkonfiguration (JACK3)|Variablenkonfiguration]]
** [[JSXGraph (JACK3)|Dynamische, grafische Inhalte]]
** [[Aufgabenteile (JACK3)|Aufgabenteile]] - alle möglichen Aufgabenformate in JACK3 werden hier beschrieben
*** [[Atomorbitale (JACK3)|Atomorbitale]] - Erstellen von Atomorbitalschemas
*** [[Dateiupload (JACK3)|Dateiupload]] - Hochladen von Datei(en)
*** [[Fill-In (JACK3)|Fill-In / Drop-Down/ Molekül]] - Lückentext, Eingabefelder, Drop-Down und Molekül Felder
*** [[Freitext (JACK3)|Freitext]] - Textfeld für die Eingabe von Texten, ohne Checker
*** [[Gatterschaltung (JACK3)|Gatterschaltung]]
*** [[Java (JACK3)|Java]] - Programmieraufgaben in Java
*** [[Molekül (JACK3)|Molekül]]
*** [[Multiple-Choice (JACK3)|Multiple-Choice]] - Multiple-Choice und Single-Choice möglich
*** [[MC-Table (JACK3)|Multiple-Choice Tabelle]]
*** [[Nomenklaturen (JACK3)|Nomenklaturen]] - Abfrage von Fachterminologie mit manueller oder automatischer Überprüfung
*** [[Python (JACK3)|Python]] - Programmieraufgaben in Python
*** [[R (JACK3)|R]]
*** [[UML (JACK3)|UML]]
** [[Grafische Darstellung (JACK3)|Grafische Darstellung der Aufgabenteile]] - Ansicht wie die verschiedenen Aufgabenteile miteinander verbunden sind.
** [[Dateien (JACK3)|Dateien]]
** [[Aufgaben Statistik (JACK3)|Statistik]]
* [[Aufgaben testen (JACK3)|Aufgabe testen]] - Beschreibung wie eine Aufgabe getestet werden kann, bevor sie Studierenden gezeigt wird.

==Kurse / Kursangebote erstellen==
In diesem Abschnitt werden Kurse und Kursangebote beschrieben. Wichtig hier ist auch das Zusammespiel der beiden.
* [[Kurs Einstellungen (JACK3)|Kurs Einstellungen]] - Im Kurs werden die Aufgaben zusammengestellt.
* [[Kursangebot Einstellungen (JACK3)|Kursangebot Einstellungen]] - Im Kursangebot werden die Sichtbarkeiten eingestellt.
'''Mögliche Szenarien''': Kursangebote können für verschiedene Zwecke eingesetzt werden. Auf den folgenden Seiten werden gängige Einsatzszenarien mit Schritt-für-Schritt-Anleitungen erläutert. Es ist jedoch zu beachten, dass Einstellungen ggf. individuell angepasst und getestet werden müssen
*[[Kursanmeldung (JACK3)|Kursanmeldung]] - Reines Anmeldesystem ohne Aufgaben, z.B. für die Anmeldung zu einer mündlichen Prüfung.
*[[Übungskurs erstellen (JACK3)|Übungskurs]] - Übungsaufgaben, um Inhalte aus der Vorlesung zu üben.
*[[Prüfung erstellen (JACK3)|Prüfung]] - Prüfung oder Klausur mit JACK3 erstellen.

==Statistiken / Prüfungsergebnisse==
Beschreibung der Einsicht in die Bearbeitungen von den Studierenden.
*[[Einsicht in Ergebnisse in Aufgaben (JACK3)|Ergebnisse ansehen in Aufgaben]]
*[[Manuelles Feedback (JACK3)|Manuelles Feedback]] - An jeder Einreichung einer Aufgabe und einer Kursbearbeitung kann das automatische Feedback von JACK und die vergebene Punktzahl überschrieben werden.
*[[Einsicht in Ergebnisse in Kursangeboten (JACK3)|Ergebnisse ansehen in Kursangeboten]]

==Anmeldeoptionen / Nutzer Verwaltung / Rechte Konzept==
*[[Kursangebot Einstellungen (JACK3)#Zugangsbeschränkung|Verlinkung von Kursen über den öffentlichen Link]]
* [[LTI Anbindung (JACK3)|Moodle Anbindung]] - Erklärung wie sich ein Kursangebot in JACK3 in einen Moodle Kurs einbinden lässt.
*[[Rechtekonzept (JACK3)|Rechtekonzept]] und [[Rechte bearbeiten (JACK3)|Rechte bearbeiten]] - Erklärung der verschiedenen Rechte in JACK3.
*[[Verwaltung (JACK3)|Verwaltung]] - Verwaltungsmöglichkeiten eines Admins.

==Import / Export==
*[[Inhalte exportieren (JACK3)|Inhalte exportieren]] - Es können nur Inhalte von [[Mein Arbeitsbereich (JACK3)|Mein Arbeitsbereich]] heruntergeladen werden.
*[[Aufgaben aus Jack2 importieren (JACK3)|Aufgaben aus JACK2 importieren]]
**[[Evaluator-Änderungen von JACK2 nach JACK3]]
*[[Inhalte importieren (JACK3)|Inhalte importieren]]
[[Kategorie:JACK3]]
[[Kategorie:Benutzerhandbuch]]
[[Kategorie:Hauptseiten]]

Vorlage:Navigation

2025-02-24T08:22:04Z

LGlaser: Hinweis auf optionalen Parameter

IsMathematikerRealNumber

2025-02-24T08:18:58Z

LGlaser: Navigationsvorlage eingefügt

{{Navigation/Numberfunktionen}}

{{Vorlage:Warnung|Warnung=Diese Seite beinhaltet eine Evaluator-Funktion im JACK3 System.}}

===Zugehörige Evaluatoren===
*'''MathEvaluator'''

=== Beschreibung ===
Die Funktion ''isMathematikerRealNumber'' prüft, ob es sich bei einem gegebenen [[Objekt]] um eine reelle Zahl handelt '''und''' der eingegebene Term nicht weiter vereinfachbar ist. Die Funktion gibt einen Boolean zurück.

'''Hinweis:''' Nicht zu verwechseln mit [[isRealNumber|IsRealNumber]]. Siehe [[Übersicht Numberfunktionen]].

'''Für diese Funktion ist die Eingabe dann eine reelle Zahl, wenn die folgenden Kriterien erfüllt sind:'''
* Die Eingabe lässt sich nicht zu Unendlich ausrechnen,
* Die Eingabe lässt sich zu einer reellen Zahl ausrechnen,
* Die Eingabe kann nicht weiter vereinfacht werden und
* Die Eingabe ist kein Doppelbruch oder ein Bruch mit Fließkommazahlen.

Eine Eingabe ist weiter vereinfachbar, wenn
* sie mindestens einen Operanten enthält <code>(+, -, *, /, ^, sqrt)</code> '''und'''
* sich zu einer Ganzzahl ausrechnen lässt.

=== Syntax ===
isMathematikerRealNumber(Objekt objekt)

=== Parameter ===
* '''objekt''' - das zu überprüfende Objekt

=== Return Value ===
* Gibt einen [[Boolean]] zurück. <code>True</code>, wenn es sich um eine reelle Zahl nach obigen Kriterien handelt.

=== Beispiele ===
//Kein Operant
isMathematikerRealNumber(5.5) --> returns ''true''
isMathematikerRealNumber(5) --> returns ''true''
isMathematikerRealNumber(constE()) --> returns ''true''
isMathematikerRealNumber(constPi()) --> returns ''true''

isMathematikerRealNumber(infinity()) --> returns ''false'', da Unendlich nicht als Zahl definiert ist

// Ein Operant
isMathematikerRealNumber(sqrt(3)) --> returns ''true''
isMathematikerRealNumber(ln(4)) --> returns ''true''
isMathematikerRealNumber(cos(4)) --> returns ''true''
isMathematikerRealNumber(sin(2)) --> returns ''true''
isMathematikerRealNumber(tan(1)) --> returns ''true''
isMathematikerRealNumber(-6) --> returns ''true''
isMathematikerRealNumber(constE()^2) --> returns ''true''
isMathematikerRealNumber(constPi()/2) --> returns ''true''

isMathematikerRealNumber(2*3) --> returns ''false'', der Ausdruck lässt sich weiter vereinfachen
isMathematikerRealNumber(0.5/0.5) --> returns ''false'', der Ausdruck lässt sich weiter vereinfachen
isMathematikerRealNumber(sqrt(4)) --> returns ''false'', der Ausdruck lässt sich weiter vereinfachen
isMathematikerRealNumber(3^5) --> returns ''false'', der Ausdruck lässt sich weiter vereinfachen

// Zwei Operanden
isMathematikerRealNumber(-1/5) --> returns ''true''
isMathematikerRealNumber(1/-5) --> returns ''true''
isMathematikerRealNumber(-sqrt(3)) --> returns ''true''
isMathematikerRealNumber(sqrt(4/9)) --> returns ''true''
isMathematikerRealNumber(sqrt(3)/2) --> returns ''true''
isMathematikerRealNumber(sqrt(sqrt(3))) --> returns ''true''
isMathematikerRealNumber(((3)^0.5)^0.5) --> returns ''true''
isMathematikerRealNumber(2^(1/3)) --> returns ''true''
isMathematikerRealNumber(sqrt(2)*constPi()) --> returns ''true''
isMathematikerRealNumber(1+sqrt(3)) --> returns ''true''

isMathematikerRealNumber(sqrt(-1)) --> returns ''false'', es handelt sich um eine komplexe Zahl
isMathematikerRealNumber(sqrt(2^2)) --> returns ''false'', der Ausdruck lässt sich weiter vereinfachen
isMathematikerRealNumber(0.5/(1/2)) --> returns ''false'', der Ausdruck lässt sich weiter vereinfachen

// Drei Operanden
isMathematikerRealNumber(1/2*sqrt(3)) --> returns ''true''
isMathematikerRealNumber(sqrt(3^2+5)) --> returns ''false'', der Ausdruck lässt sich weiter vereinfachen
isMathematikerRealNumber((1/2)/(1/2)) --> returns ''false'', der Ausdruck lässt sich weiter vereinfachen

// Vier Operanden
isMathematikerRealNumber(-1/2*sqrt(3)) --> returns ''true''

==== Benutzung von Variablen ====
isMathematikerRealNumber([input=fillin1])

isMathematikerRealNumber([var=a])

=== Hinweise ===
Für die Überprüfung von Fill-In Feldern kann der ''[[Formeleditor (JACK3)|Formeleditor]]'' verwendet werden oder ''Number'' für das Fill-In Feld eingestellt werden. Beispiel: <code>isMathematikerRealNumber([input=fillin1])</code>
[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Testfunktionen]][[Kategorie:JACK3]]

IsRealNumber

2025-02-24T08:18:36Z

LGlaser: Navigationsvorlage eingefügt

{{Navigation/Numberfunktionen}}

===Zugehörige Evaluatoren===
*'''MathEvaluator'''

=== Beschreibung ===
Die Funktion ''isRealNumber'' prüft, ob es sich bei einem gegebenen [[Objekt]] um eine reelle Zahl handelt. Die Funktion gibt einen Boolean zurück.

'''Hinweis:''' [[IsNumber|''isNumber'']] ist nun eine eigenständige Funktion und daher '''kein Alias''' mehr für ''isRealNumber''. Siehe [[Übersicht Numberfunktionen]].

'''Für diese Funktion ist die Eingabe dann eine reelle Zahl, wenn sich das eingegebene Objekt zu einer reellen Zahl evaluieren lässt und die folgenden Kriterien erfüllt:'''
* Es handelt sich um eine ganze oder Fließkomma-Zahl '''oder'''
* es handelt sich um <code>+/- e</code> oder <code>+/- pi</code> '''oder'''
* es handelt sich um einen Bruch, bei dem Zähler und Nenner eine ganze Zahl/Fließkommazahl/e/pi sind '''oder'''
* es handelt sich um eine Wurzel und der Term unter der Wurzel entspricht den Kriterien.

Für alle anderen Objekte wird false zurückgeliefert. Dies schließt Exponenten, Logarithmus, trigonometrische Funktionen, Addition, Subtraktion und Multiplikation mit ein.

[[Übersicht Numberfunktionen|Hier]] findet sich eine Übersicht aller Number-Funktionen.

=== Syntax ===
isRealNumber(Objekt objekt)

=== Parameter ===
* '''objekt''' - das zu überprüfende Objekt

=== Return Value ===
* Gibt einen [[Boolean]] zurück

=== Beispiele ===
==== Standardfälle ====
isRealNumber(15.3) --> returns ''true''
isRealNumber(15) --> returns ''true''
isRealNumber(constE()) --> returns ''true''
isRealNumber(constPi()) --> returns ''true''
isRealNumber(1/2) --> returns ''true''
isRealNumber(sqrt(2)) --> returns ''true''
isRealNumber(sqrt(4)) --> returns ''true''

isRealNumber((1/2)/0.5) --> returns ''false'', der Zähler enthält einen Bruch und keine ganze oder Fließkommazahl
isRealNumber(sqrt(-1)) --> returns ''false'', da komplexe Zahl
isRealNumber(infinity()) --> returns ''false'', da Unendlich nicht als Zahl definiert ist
isRealNumber(2^(1/3)) --> returns ''false'', da Exponenten nicht unterstützt werden
isRealNumber(ln(3)) --> returns ''false'', da Logarithmus nicht unterstützt werden
isRealNumber(cos(4)) --> returns ''false'', da trigonometrische Funktionen nicht unterstützt werden
isRealNumber(3*3) --> returns ''false'', da Multiplikation nicht unterstützt wird
isRealNumber(3+5) --> returns ''false'', da Addition nicht unterstützt wird
isRealNumber(33-5) --> returns ''false'', da Subtraktion nicht unterstützt wird

==== Benutzung von Variablen ====
isRealNumber([input=fillin1])

isRealNumber([var=a])

=== Hinweise ===
'''JACK3:''' Für die Überprüfung von Fill-In Feldern kann der ''[[Formeleditor (JACK3)|Formeleditor]]'' verwendet werden oder ''Number'' für das Fill-In Feld eingestellt werden. Beispiel: <code>isRealNumber([input=fillin1])</code>

'''JACK2:''' Die Überprüfung mit Textfeldern funktioniert nur, wenn man den [[Formeleditor]] verwendet. Gibt man keinen Editor an, wird für ein Textfeld (<code>[pos=1] usw.</code>) ein OpenMath String zurückgegeben. Dadurch gibt <code>isRealNumber([pos=1])</code> sowie <code>isRealNumber('[pos=1]')</code> immer false zurück. Um ein richtiges Ergebnis zu erlangen, muss [[Matches]] genutzt werden.
[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Testfunktionen]][[Kategorie:JACK2]][[Kategorie:JACK3]]

IsRationalNumber

2025-02-24T08:18:24Z

LGlaser: Navigationsvorlage eingefügt

{{Navigation/Numberfunktionen}}

===Zugehörige Evaluatoren===
*'''MathEvaluator'''

=== Beschreibung ===
Die Funktion ''isRationalNumber'' prüft, ob es sich bei einem gegebenen [[Objekt]] um eine rationale Zahl handelt. Die Funktion gibt einen Boolean zurück.

Siehe auch [[Übersicht Numberfunktionen]].

=== Syntax ===
isRationalNumber(Objekt objekt)

=== Parameter ===
* '''objekt''' - das zu überprüfende Objekt

=== Return Value ===
* Gibt einen [[Boolean]] zurück

=== Beispiele ===
==== Standardfälle ====
isRationalNumber(15.3) --> returns ''true''

isRationalNumber(3/4) --> returns ''true''

isRationalNumber('zahl') --> returns ''false''

isRationalNumber(sqrt(2)) --> returns ''false''

'''JACK2:'''
isRationalNumber([var=E]) --> returns ''false''

'''Jack3:'''
isRationalNumber(constE()) --> returns ''false''

==== Benutzung mit Variablen ====
isRationalNumber([var=a])

==== Benutzung mit studentischen Eingaben ====
'''JACK2:'''
isRationalNumber([pos=1])

'''JACK3:'''
isRationalNumber([input=field1])

=== Hinweise ===
'''JACK3:''' Für die Überprüfung von Fill-In Feldern kann der ''[[Formeleditor (JACK3)|Formeleditor]]'' verwendet werden oder ''Number'' für das Fill-In Feld eingestellt werden. Beispiel: <code>isRationalNumber([input=fillin1])</code>

'''JACK2:''' Die Überprüfung mit Textfeldern funktioniert nur, wenn man den [[Formeleditor]] verwendet. Gibt man keinen Editor an, wird für ein Textfeld (<code>[pos=1] usw.</code>) ein OpenMath String zurückgegeben. Dadurch gibt <code>isRationalNumber([pos=1])</code> sowie <code>isRationalNumber('[pos=1]')</code> immer false zurück. Um ein richtiges Ergebnis zu erlangen, muss [[Matches#Benutzung von Textfeldern|Matches]] genutzt werden.
[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Testfunktionen]][[Kategorie:JACK2]][[Kategorie:JACK3]]

IsNaturalNumber

2025-02-24T08:18:17Z

LGlaser: Navigationsvorlage eingefügt

{{Navigation/Numberfunktionen}}

===Zugehörige Evaluatoren===
*'''MathEvaluator'''

=== Beschreibung ===
Die Funktion ''isNaturalNumber'' prüft, ob es sich bei einem gegeben Objekt um eine Natürliche Zahl handelt.
Die natürlichen Zahlen schließen dabei die Null mit ein.

Siehe auch [[Übersicht Numberfunktionen]].

=== Syntax ===
isNaturalNumber([[Objekt]] objekt)

=== Parameter ===
* '''objekt''' - das zu überprüfende [[Objekt]]

=== Return Value ===
* Gibt einen [[Boolean]] zurück

=== Beispiele ===
==== Standardfälle ====
isNaturalNumber(15) --> returns ''true''

isNaturalNumber(-1) --> returns ''false''

isNaturalNumber(1) --> returns ''true''

isNaturalNumber('Eins') --> returns ''false''

'''JACK2:'''
isNaturalNumber([var=E]) --> returns ''false''

'''JACK3:'''
isNaturalNumber(constE()) --> returns ''false''

==== Benutzung mit Variablen ====
isNaturalNumber([var=a])

==== Benutzung mit studentischen Eingaben ====
'''JACK2:'''
isNaturalNumber([pos=1])

'''JACK3:'''
isNaturalNumber([input=field1])

=== Hinweise ===
'''JACK3:''' Für die Überprüfung von Fill-In Feldern kann der ''[[Formeleditor (JACK3)|Formeleditor]]'' verwendet werden oder ''Number'' für das Fill-In Feld eingestellt werden. Beispiel: <code>isNaturalNumber([input=fillin1])</code>

'''JACK2:''' Die Überprüfung mit Textfeldern funktioniert nur, wenn man den [[:Formeleditor]] verwendet. Gibt man keinen Editor an, wird für ein Textfeld (<code>[pos=1] usw.</code>) ein OpenMath String zurückgegeben. Dadurch gibt <code>isNaturalNumber([pos=1])</code> sowie <code>isNaturalNumber('[pos=1]')</code> immer false zurück. Um ein richtiges Ergebnis zu erlangen, muss [[Matches#Benutzung von Textfeldern|Matches]] genutzt werden.
[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Testfunktionen]][[Kategorie:JACK2]][[Kategorie:JACK3]]

IsIntegerNumber

2025-02-24T08:18:00Z

LGlaser: Navigationsvorlage eingefügt

{{Navigation/Numberfunktionen}}

=== Zugehörige Evaluatoren ===
*'''MathEvaluator'''

=== Beschreibung ===
Die Funktion ''IsIntegerNumber'' gibt wahr aus falls die als Parameter eingegeben Zahl ein Integer ist.

Siehe auch [[Übersicht Numberfunktionen]].

=== Syntax ===
isIntegerNumber(a)

=== Parameter ===
* '''a''' - [[Objekt]]

=== Return Value ===
*Gibt True(wahr) oder False(nicht wahr) zurück

=== Beispiele ===
==== Standardfälle ====
isIntegerNumber(4) --> returns ''true''

isIntegerNumber(-1245) --> returns ''true''

isIntegerNumber(2.5) --> returns ''false''

==== Benutzung mit Variablen ====

isIntegerNumber([var=a]) --> returns ''true'', wenn a ein Integer ist, ''false'' sonst

===Hinweise===
'''JACK3:''' Für die Überprüfung von Fill-In Feldern kann der ''[[Formeleditor (JACK3)|Formeleditor]]'' verwendet werden oder ''Number'' für das Fill-In Feld eingestellt werden. Beispiel: <code>isIntegerNumber([input=fillin1])</code>

'''JACK2:''' Die Überprüfung mit Textfeldern funktioniert nur, wenn man den [[Formeleditor]] verwendet. Gibt man keinen Editor an, wird für ein Textfeld (<code>[pos=1] usw.</code>) ein OpenMath String zurückgegeben. Dadurch gibt <code>isIntegerNumber([pos=1])</code> sowie <code>isIntegerNumber('[pos=1]')</code> immer false zurück. Um ein richtiges Ergebnis zu erlangen, muss [[Matches#Benutzung von Textfeldern|Matches]] genutzt werden.
[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Testfunktionen]][[Kategorie:JACK2]][[Kategorie:JACK3]]

IsNumber

2025-02-24T08:17:17Z

LGlaser: Navigationsvorlage eingefügt

{{Navigation/Numberfunktionen}}

===Zugehörige Evaluatoren===
*'''MathEvaluator'''

=== Beschreibung ===
Die Funktion ''isNumber'' prüft, ob sich das übergebene [[Objekt]] zu einer Zahl evaluieren lässt. Die Funktion gibt einen Boolean zurück.

Ist das Objekt eine Zahl oder lässt sich das Objekt zu einer Zahl evaluieren, wird true zurückgegeben. '''Auch für komplexe Zahlen gibt die Funktion <code>true</code> zurück.'''

'''Hinweis:''' ''isNumber'' ist nun eine eigenständige Funktion und daher '''kein Alias''' mehr für [[IsRealNumber|''isRealNumber'']].

Siehe auch [[Übersicht Numberfunktionen]].

=== Syntax ===
isNumber(Objekt objekt)

=== Parameter ===
* '''objekt''' - das zu überprüfende Objekt

=== Return Value ===
* Gibt einen [[Boolean]] zurück

=== Beispiele ===
==== Standardfälle ====
isNumber(2) -> returns ''true''
isNumber(4.6) -> returns ''true''
isNumber(4/3) -> returns ''true''
isNumber(sqrt(3)) -> returns ''true''
isNumber(sqrt(-1)) -> returns ''true''
isNumber(3+5) -> returns ''true''
isNumber(4*88) -> returns ''true''
isNumber(6-8) -> returns ''true''
isNumber(ln(2)) -> returns ''true''
isNumber(cos(3)) -> returns ''true''
isNumber(2^7) -> returns ''true''
isNumber(1+imaginary()) -> returns ''true''

isNumber(infinity()) -> returns ''false'', da Unendlich nicht als Zahl gewertet wird
isNumber("text") -> returns ''false'', eine Zeichenkette kann nicht zu einer Zahl evaluiert werden
isNumber("1+1") -> returns ''false'', eine Zeichenkette kann nicht zu einer Zahl evaluiert werden
isNumber(x+y) -> returns ''false'', ein Term mit mathematischen Variablen kann nicht zu einer Zahl evaluiert werden
isNumber(2*x+5) -> returns ''false'', ein Term mit mathematischen Variablen kann nicht zu einer Zahl evaluiert werden
isNumber(6/y) -> returns ''false'', ein Term mit mathematischen Variablen kann nicht zu einer Zahl evaluiert werden

==== Benutzung von Variablen ====
isNumber([input=fillin1])

isNumber([var=a])

=== Hinweise ===
'''JACK3:''' Für die Überprüfung von Fill-In Feldern kann der ''[[Formeleditor (JACK3)|Formeleditor]]'' verwendet werden oder ''Number'' für das Fill-In Feld eingestellt werden. Beispiel: <code>isNumber([input=fillin1])</code>

'''JACK2:''' Die Überprüfung mit Textfeldern funktioniert nur, wenn man den [[Formeleditor]] verwendet. Gibt man keinen Editor an, wird für ein Textfeld (<code>[pos=1] usw.</code>) ein OpenMath String zurückgegeben. Dadurch gibt <code>isNumber([pos=1])</code> sowie <code>isNumber('[pos=1]')</code> immer false zurück. Um ein richtiges Ergebnis zu erlangen, muss [[Matches#Benutzung von Textfeldern|Matches]] genutzt werden.

[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Testfunktionen]][[Kategorie:JACK2]][[Kategorie:JACK3]]

Übersicht Numberfunktionen

2025-02-24T08:16:56Z

LGlaser: Navigationsvorlage eingefügt

{{Navigation/Numberfunktionen}}

== Funktionsweise ==
Im Mathe-Evaluator gibt es sechs verschiedene Funktionen, mit denen getestet werden kann, ob die Eingabe zu einer bestimmten Zahlengruppe gehört:

=== [[IsNumber]] ===
* Gibt <code>true</code> zurück, wenn
** die Eingabe eine Zahl ist oder
** sich die Eingabe zu einer Zahl ausrechnen lässt.
* '''Gibt auch für komplexe Zahlen true zurück.'''
=== [[IsIntegerNumber]] ===
* Gibt <code>true</code> zurück, wenn
** die Eingabe ein Integer ist.
* '''Die Eingabe wird nicht ausgerechnet.'''
=== [[IsNaturalNumber]] ===
* Gibt <code>true</code> zurück, wenn
** die Eingabe eine natürliche Zahl oder
** Null ist.
* '''Die Eingabe wird nicht ausgerechnet.'''
=== [[IsRationalNumber]] ===
* Gibt <code>true</code> zurück, wenn
** die Eingabe eine rationale Zahl ist.
* '''Die Eingabe wird nicht ausgerechnet.'''
=== [[IsRealNumber]] ===
* Gibt <code>true</code> zurück, wenn sich die Eingabe zu einer reellen Zahl ausrechnen lässt und
** es sich um eine ganze oder Fließkomma-Zahl handelt,
** es sich um <code>+/- e</code> oder <code>+/- pi</code> handelt,
** es sich um einen Bruch handelt, bei dem Zähler und Nenner eine ganze Zahl/Fließkommazahl/<code>e</code>/<code>pi</code> sind oder
** es sich um eine Wurzel handelt und der Term unter der Wurzel obigen Kriterien entspricht.
=== [[IsMathematikerRealNumber]] ===
* Gibt <code>true</code> zurück, wenn
** die Eingabe sich nicht zu Unendlich ausrechnen lässt,
** die Eingabe sich zu einer reellen Zahl ausrechnen lässt und
** die Eingabe nicht weiter vereinfacht werden kann.
* Die Eingabe ist vereinfachbar, wenn
** sie mindesten einen Operanten enthält (<code>+, -, *, /, ^, sqrt</code>) und
** sie sich zu einer Ganzzahl ausrechnen lässt.

== Vergleich ==
In folgender Tabelle wird verglichen, welche Rückgabe die Funktionen für verschiedene Eingaben liefern:
{| class="wikitable"
|+ Ausgaben der Funktionen bei verschiedenen Eingaben
|-
! !! $2$ !! $0$ !! $-4$ !! $4.6$ !! $\frac{2}{3}$ !! $\sqrt{\frac{4}{4}}$ !! $1+3$ !! $i$ !! $\infty$
|-
| IsNumber || True || True || True || True || True || True || True || True || style="background-color: silver;" |False
|-
| IsIntegerNumber || True || True || True || style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False
|-
| IsNaturalNumber || True || True || style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False
|-
| IsRationalNumber || True || True || True || True || True || style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False
|-
| IsRealNumber || True || True || True || True || True || True || style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False
|-
| IsMathematikerRealNumber || True || True || True || True || True || style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False
|}

[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Testfunktionen]][[Kategorie:JACK2]][[Kategorie:JACK3]]

Checkliste für Prüfungen mit JACK 3

2025-02-18T12:48:22Z

LGlaser: k

Hier finden Sie eine Checkliste zur erfolgreichen Durchführung von Prüfungen mit JACK3. Um eine möglichst reibungslose Prüfungsdurchführung zu ermöglichen bitten wir Sie folgende Punkte abzuarbeiten:

Bis '''zwei Wochen''' vor der Klausur:

* Die Klausur wurde über die [mailto:jack@paluno.uni-due.de Funktionsmail] angemeldet.

* Die Klausur wurde beim [https://www.uni-due.de/zim/klausuranmeldung ZIM] angemeldet. (Falls sie in der PC-Hall stattfindet)

* Lehrende haben Editierrechte und einen Ordner in [[Verfügbare Kurse (JACK3)|''Verfügbare Kurse'']] auf dem/den Prüfungsserver/n erhalten.

Bis '''eine Woche''' vor der Klausur:

* Die Klausuraufgaben wurden auf den/die Prüfungsserver importiert.

* Alle Bilder in den Aufgaben wurden erneut in der Aufgabe verlinkt.

* Es wurde ein Kurs erstellt, die Aufgaben dort eingefügt und die Punkte für die Aufgaben angepasst.

* Es wurde ein Kursangebot erstellt, der Kurs eingebunden und das Kursangebot konfiguriert.

* Die Klausur wurde aus Studierendensicht auf technische Korrektheit geprüft.

* Die Klausur wurde aus Studierendensicht auf inhaltliche Korrektheit geprüft.

=== Weitere Hinweise ===
* Das JACK-Team übernimmt keine Verantwortung für die Korrektheit der Aufgaben, Kurse und Kursangebote.

* Für neue Kunden wird einmalig ein Mitarbeiter vor Ort für die Betreuung der Klausur in der PC-Hall bereitgestellt.

* Das JACK-Team steht im Zeitraum ''vor'' diesen zwei Wochen stets gerne für Beratungen und Schulungen zu allen Themen zur Verfügung, um eine störungsfreie und erfolgreiche Durchführung der Prüfungen zu gewährleisten.

Vorlage:Navigation/Geometriefunktionen

2025-02-12T09:46:22Z

LGlaser: Polygon hinzugefügt

<onlyinclude>{{Navigation
| TITEL = Funktionen mit Koordinaten
| INHALT =
Geometrische Figuren:
[[Circle]] •
[[Coordinate]] •
[[Polygon]] •
[[Rectangle]]

Prüfen von Koordinaten:
[[IsCoordinateInCircle]] •
[[IsCoordinateInPolygon]] •
[[IsCoordinateInRectangle]]
}}</onlyinclude>

[[Kategorie:Navigationsvorlagen|Koordinatenfunktionen]]

Round

2025-02-11T13:50:37Z

LGlaser: Navigationsvorlage eingefügt

{{Navigation/Rundungsfunktionen}}

===Zugehörige Evaluatoren===
*'''MathEvaluator'''

=== Beschreibung ===
Die Funktion ''round'' rundet eine Gleitkommazahl zu einer Ganzzahl. Die Funktion erwartet eine Zahl und gibt die nächst gelegene Ganzzahl zurück.

Alternativ kann die Funktion ''round'' eine Gleitkommazahl auf eine bestimmt Nachkommastelle runden. Das zweite optionale Argument gibt die Nachkommastelle an. 0 entspricht einem Aufruf ohne zweitem Parameter.

=== Syntax ===
round([[Gleitkommazahl]] zahl, [ [[Ganzzahl]] index ])

=== Parameter ===
* '''zahl''' - die zu rundene Zahl
* '''index''' - die Nachkommastelle - optional (default = 0)

=== Return Value ===
*Gibt die gerundete [[Ganzzahl]] zurück

=== Beispiele ===
==== Standardfälle ====
round(12.4) --> returns 12

round(15.678) --> returns 16

round(15.678, 2) --> returns 15.68

round(3.21, 2) --> returns 3.21

round(3.1, 0) --> returns 3

round(27/4, 2) --> returns 6.75

==== Benutzung mit Variablen ====
round([var=a])

round([var=a], [var=b])

==== Benutzung mit studentischen Eingaben ====
'''JACK2:'''
round([pos=1])

'''JACK3:'''
round([input=field1])

=== Hinweise ===
* Die Funktion kann auch genutzt werden, um aus einem Bruch eine Dezimalzahl zu erzeugen.
* Weitere Funktionen zum Thema runden sind [[ceil]], [[floor]] und [[rint]].

[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Operator]][[Kategorie:JACK2]][[Kategorie:JACK3]]

Rint

2025-02-11T13:50:27Z

LGlaser: Navigationsvorlage eingefügt

{{Navigation/Rundungsfunktionen}}

=== Zugehörige Evaluatoren ===
*'''MathEvaluator'''

=== Beschreibung ===
Die Funktion ''rint'' ermittelt eine [[Ganzzahl]], die am nächsten an der übergebenen Zahl liegt. Die Funktion erwartet eine Zahl und gibt die nächst gelegenen [[Ganzzahl]] zurück

=== Syntax ===
rint([[Gleitkommazahl]] zahl)

=== Parameter ===
* '''zahl''' - die Zahl, zu der die naheliegenste [[Ganzzahl]] ermittelt werden soll

=== Return Value ===
* Gibt die naheliegenste [[Ganzzahl]] zurück

=== Beispiele ===
==== Standardfälle ====
rint(12.4) --> returns 12

rint(15.678) --> returns 16

==== Benutzung mit Variablen ====
rint([var=a])

==== Benutzung mit studentischen Eingaben ====
'''JACK2:'''
rint([pos=1])

'''JACK3:'''
rint([input=field1])

=== Hinweise ===
* Weitere Funktionen zum Thema runden sind [[ceil]], [[floor]] und [[round]].

[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Operator]][[Kategorie:JACK2]][[Kategorie:JACK3]]

Ceil

2025-02-11T13:50:25Z

LGlaser: Navigationsvorlage eingefügt

{{Navigation/Rundungsfunktionen}}

===Zugehörige Evaluatoren===
*'''MathEvaluator'''

=== Beschreibung ===

Die Funktion ''ceil'' rundet eine rationale Zahl auf die nächstgrößere ganze Zahl auf. Die Funktion erwartet eine Zahl als Parameter und gibt eine Zahl zurück.

=== Syntax ===
ceil([[Gleitkommazahl]] zahl)

=== Parameter ===
* '''zahl''' - eine aufzurundende rationale Zahl

=== Return Value ===
*Gibt eine Ganzzahl zurück

=== Beispiele ===
==== Standardfälle ====
ceil(7.3) --> returns 8

ceil(-2.4) --> returns -2

==== Benutzung mit Variablen ====

ceil([var=a])
ceil([var=b])

==== Benutzung mit studentischen Eingaben ====
'''Jack2:'''
ceil([pos=1])

'''Jack3:'''
ceil([input=field1])

=== Hinweise ===
* Weitere Funktionen zum Thema runden sind [[floor]], [[rint]] und [[round]].
* Wenn Variablen genutzt werden muss darauf geachtet werden, dass diese die Voraussetzung erfüllen.
* Wenn die Eingabe der Studierenden genutzt wird muss auch hier darauf geachtet werden, dass die Voraussetzungen erfüllt sind und ob diese an der Stelle genutzt werden können.

[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Operator]][[Kategorie:JACK2]][[Kategorie:JACK3]]

Floor

2025-02-11T13:50:22Z

LGlaser: Navigationsvorlage eingefügt

{{Navigation/Rundungsfunktionen}}

===Zugehörige Evaluatoren===
*'''MathEvaluator'''

=== Beschreibung ===
Die Funktion ''floor'' rundet eine rationale Zahl auf die nächstkleinere ganze Zahl ab. Die Funktion erwartet eine Zahl als Parameter und gibt eine Zahl zurück.

=== Syntax ===
floor([[Gleitkommazahl]] zahl)

=== Parameter ===
* '''zahl''' - eine abzurundende rationale Zahl

=== Return Value ===
*Gibt eine [[Ganzzahl]] zurück.

=== Beispiele ===
==== Standardfälle ====
floor(7.3) --> returns 7

floor(-2.4) --> returns -3

==== Benutzung mit Variablen ====
floor([var=a])

==== Benutzung mit studentischen Eingaben ====
'''Jack2:'''
floor([pos=1])

'''Jack3:'''
floor([input=fillin1])

=== Hinweise ===
* Weitere Funktionen zum Thema runden sind [[ceil]], [[rint]] und [[round]].
* Wenn Variablen genutzt werden muss darauf geachtet werden, dass diese die Voraussetzung erfüllen.
* Wenn die Eingabe der Studierenden genutzt wird muss auch hier darauf geachtet werden, dass die Voraussetzungen erfüllt sind und ob diese an der Stelle genutzt werden können.

[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Operator]][[Kategorie:JACK2]][[Kategorie:JACK3]]

Checkliste für Prüfungen mit JACK 3

2025-02-11T12:38:58Z

LGlaser: Kleinere stilistische Änderungen

Hier finden Sie eine Checkliste zur erfolgreichen Durchführung von Prüfungen mit JACK3. Um eine möglichst reibungslose Prüfungsdurchführung zu ermöglichen bitten wir Sie folgende Punkte abzuarbeiten:

Bis '''zwei Wochen''' vor der Klausur:

* Ich habe die Klausur über die [mailto:jack@paluno.uni-due.de Funktionsmail] angemeldet.

* Falls die Klausur in der PC-Hall stattfindet: Ich habe die Klausur beim [https://www.uni-due.de/zim/klausuranmeldung ZIM] angemeldet.

* Ich habe Editierrechte und einen Ordner in [[Verfügbare Kurse (JACK3)|''Verfügbare Kurse'']] auf dem/den Prüfungsserver/n erhalten.

Bis '''eine Woche''' vor der Klausur:

* Ich habe die Klausuraufgaben auf den/die Prüfungsserver importiert.

* Ich habe alle Bilder in den Aufgaben erneut in der Aufgabe verlinkt.

* Ich habe einen Kurs erstellt, die Aufgaben eingefügt und die Punkte für die Aufgaben angepasst.

* Ich habe ein Kursangebot erstellt, den Kurs eingebunden und das Kursangebot konfiguriert.

* Ich habe die Klausur aus Studierendensicht auf technische Korrektheit geprüft.

* Ich habe die Klausur aus Studierendensicht auf inhaltliche Korrektheit geprüft.

=== Weitere Hinweise ===
* Das JACK-Team übernimmt keine Verantwortung für die Korrektheit der Aufgaben, Kurse und Kursangebote.

* Für Neukunden wird einmalig ein Mitarbeiter vor Ort für die Klausur in der PC-Hall bereitgestellt.

* Das JACK-Team steht im Zeitraum ''vor'' diesen zwei Wochen stets gerne für Beratungen und Schulungen zu allen Themen zur Verfügung, um eine störungsfreie und erfolgreiche Durchführung der Prüfungen zu gewährleisten.

Vorlage:Navigation/Numberfunktionen

2025-02-04T09:08:32Z

LGlaser: Sortierschlüssel

<onlyinclude>{{Navigation
| TITEL = Numberfunktionen ([[Übersicht Numberfunktionen|Übersicht]])
| INHALT =
[[IsNumber]] •
[[IsIntegerNumber]] •
[[IsNaturalNumber]] •
[[IsRationalNumber]] •
[[IsRealNumber]] •
[[IsMathematikerRealNumber]]
}}</onlyinclude>

[[Kategorie:Navigationsvorlagen|Numberfunktionen]]

Vorlage:Navigation/Geometriefunktionen

2025-02-04T09:08:30Z

LGlaser: Sortierschlüssel

<onlyinclude>{{Navigation
| TITEL = Funktionen mit Koordinaten
| INHALT =
Geometrische Figuren:
[[Circle]] •
[[Coordinate]] •
[[Rectangle]]

Prüfen von Koordinaten:
[[IsCoordinateInCircle]] •
[[IsCoordinateInPolygon]] •
[[IsCoordinateInRectangle]]
}}</onlyinclude>

[[Kategorie:Navigationsvorlagen|Koordinatenfunktionen]]

Vorlage:Navigation/Rundungsfunktionen

2025-02-04T09:08:27Z

LGlaser: Sortierschlüssel

<onlyinclude>{{Navigation
| TITEL = Rundungsfunktionen
| INHALT =
[[Round]] •
[[Rint]] •
[[Ceil]] •
[[Floor]]
}}</onlyinclude>

[[Kategorie:Navigationsvorlagen|Rundungsfunktionen]]

Vorlage:Navigation/Rundungsfunktionen

2025-02-04T09:03:44Z

LGlaser: LGlaser verschob die Seite Vorlage:Vorlage:Navigation/Rundungsfunktionen nach Vorlage:Navigation/Rundungsfunktionen, ohne dabei eine Weiterleitung anzulegen

<onlyinclude>{{Navigation
| TITEL = Rundungsfunktionen
| INHALT =
[[Round]] •
[[Rint]] •
[[Ceil]] •
[[Floor]]
}}</onlyinclude>

[[Kategorie:Navigationsvorlagen]]

Vorlage:Navigation/Rundungsfunktionen

2025-02-04T09:03:25Z

LGlaser: LGlaser verschob die Seite Vorlage:Rundungsfunktionen nach Vorlage:Vorlage:Navigation/Rundungsfunktionen, ohne dabei eine Weiterleitung anzulegen

<onlyinclude>{{Navigation
| TITEL = Rundungsfunktionen
| INHALT =
[[Round]] •
[[Rint]] •
[[Ceil]] •
[[Floor]]
}}</onlyinclude>

[[Kategorie:Navigationsvorlagen]]

Vorlage:Navigation/Rundungsfunktionen

2025-02-04T08:59:40Z

LGlaser: Vorlage angelegt

<onlyinclude>{{Navigation
| TITEL = Rundungsfunktionen
| INHALT =
[[Round]] •
[[Rint]] •
[[Ceil]] •
[[Floor]]
}}</onlyinclude>

[[Kategorie:Navigationsvorlagen]]

Datei:TracingFramework.java

2025-02-03T12:10:36Z

LGlaser: Kategorie hinzugefügt

[[Kategorie:Werkzeuge (JACK3)]]

Vorlage:Navigation

2025-01-31T10:36:09Z

LGlaser: Schmalere Formatierung

<includeonly><div style="background: #eaf3ff; border: solid 1px #a3caff; padding-left: 10px; padding-right: 10px; line-height: 1.0em; text-align: center;">
{{#if: {{{TITEL|}}} | <div style="font-weight: bold;">
{{{TITEL}}}
</div> | }}
<div style="margin-top: 10px;">
{{{INHALT}}}
</div>
</div></includeonly>
<noinclude>Diese Vorlage bildet eine Navigationsleiste, ähnlich zu der in der [https://de.wikipedia.org/wiki/Vorlage:Navigationsleiste Wikipedia].

'''Benutzung:'''

<pre><nowiki>
{{Navigation
| TITEL = Titel hier einfügen
| INHALT =
[[Erste Seite]]&nbsp;&bull;
[[Zweite Seite]]&nbsp;&bull;
[[Dritte Seite]]&nbsp;&bull;
[[Vierte Seite]]
}}
</nowiki></pre>

'''Ergibt:'''

{{Navigation
| TITEL = Titel hier einfügen
| INHALT =
Erste Seite • 
Zweite Seite •
Dritte Seite •
Vierte Seite
}}
[[:Kategorie:Navigationsvorlagen|Liste aller Navigationsvorlagen]].

[[Kategorie:Vorlage]]</noinclude>

Vorlage:Navigation/Geometriefunktionen

2025-01-31T10:26:15Z

LGlaser: Vorlage angelegt

Vorlage:Navigation

2025-01-31T10:17:53Z

LGlaser: Link hinzugefügt

<includeonly><div style="background: #eaf3ff; border: solid 1px #a3caff; padding: 10px;">
{{#if: {{{TITEL|}}} | <div style="text-align: center;"><strong>
{{{TITEL}}}
</strong></div> | }}
<div style="text-align: center;">
{{{INHALT}}}
</div>
</div></includeonly>
<noinclude>Diese Vorlage bildet eine Navigationsleiste, ähnlich zu der in der [https://de.wikipedia.org/wiki/Vorlage:Navigationsleiste Wikipedia].

'''Benutzung:'''

<pre><nowiki>
{{Navigation
| TITEL = Titel hier einfügen
| INHALT =
[[Erste Seite]]&nbsp;&bull;
[[Zweite Seite]]&nbsp;&bull;
[[Dritte Seite]]&nbsp;&bull;
[[Vierte Seite]]
}}
</nowiki></pre>

'''Ergibt:'''

{{Navigation
| TITEL = Titel hier einfügen
| INHALT =
Erste Seite • 
Zweite Seite •
Dritte Seite •
Vierte Seite
}}
[[:Kategorie:Navigationsvorlagen|Liste aller Navigationsvorlagen]].

[[Kategorie:Vorlage]]</noinclude>

Vorlage:Navigation/Numberfunktionen

2025-01-31T10:15:07Z

LGlaser: Vorlage angelegt

Kategorie:Navigationsvorlagen

2025-01-31T10:14:18Z

LGlaser: Seite angelegt

Diese Kategorie enthält alle [[Vorlage:Navigation|Navigationsvorlagen]].

[[Kategorie:Interne Seiten]][[Kategorie:Vorlage]]

Vorlage:Navigation

2025-01-31T10:08:06Z

LGlaser: Die Seite wurde neu angelegt: „<includeonly><div style="background: #eaf3ff; border: solid 1px #a3caff; padding: 10px;"> {{#if: {{{TITEL|}}} | <div style="text-align: center;"><strong> {{{TITEL}}} </strong></div> | }} <div style="text-align: center;"> {{{INHALT}}} </div> </div></includeonly> <noinclude>Diese Vorlage bildet eine Navigationsleiste, ähnlich zu der in der [https://de.wikipedia.org/wiki/Vorlage:Navigationsleiste Wikipedia]. '''Benutzung:''' <pre><nowiki> {{Navigation | T…“

Concat

2025-01-20T12:28:15Z

LGlaser: Klarstellung bzgl. mehr Parametern

===Zugehörige Evaluatoren===
*'''MathEvaluator'''

=== Beschreibung ===
Die Funktion ''concat'' fügt Zeichenketten unmittelbar aneinander, so dass eine einzige Zeichenkette entsteht. Die Funktion erwartet mindestens zwei Zeichenketten und gibt eine Zeichenkette zurück.

=== Syntax ===
concat([[Zeichenkette]] zeichenkette1, [[Zeichenkette]] zeichenkette2, ...)

=== Parameter ===
* '''zeichenkette1''' - erste Zeichenkette
* '''zeichenkette2''' - zweite Zeichenkette, die der ersten angehängt werden soll
* Weitere Zeichenketten (optional)

=== Return Value ===
* Gibt einen String zurück

=== Beispiele ===
==== Standardfälle ====
concat('hallo','welt') --> returns 'hallowelt'

concat('hallo','welt','!') --> returns 'hallowelt!'

==== Benutzung mit Variablen ====

concat('anfang', [var=a])
concat([var=b], 'welt')

==== Benutzung mit studentischen Eingaben ====

'''Jack2:'''
concat([pos=1],'ende')
concat([var=b],[pos=2])

'''Jack3:'''
concat([input=field1],'ende')
concat([var=b],[input=field2])

=== Hinweise ===
* Wenn Variablen genutzt werden muss darauf geachtet werden, dass diese die Voraussetzung erfüllen.
* Wenn die Eingabe der Studierenden genutzt wird muss auch hier darauf geachtet werden, dass die Voraussetzungen erfüllt sind und ob diese an der Stelle genutzt werden können.

[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Zeichenkettenfunktionen]][[Kategorie:JACK2]][[Kategorie:JACK3]]

MergeLists

2025-01-14T18:46:54Z

LGlaser: Klarstellung bzgl. leerer Listen

{{Vorlage:Warnung|Warnung=Diese Seite beinhaltet eine Evaluator-Funktion im JACK3 System.}}

===Zugehörige Evaluatoren===
*'''MathEvaluator'''

===Beschreibung===
Die Funktion ''mergeLists'' fügt die Elemente mehrerer [[List|Listen]] zu einer [[List|Liste]] zusammen, wobei die ursprüngliche Reihenfolge beibehalten wird. Leere [[List|Listen]] werden entweder bei einem Parameterwert ''false'' ignoriert oder bei ''true'' durch ein leeres Element ersetzt.

Die Funktion erwartet, dass der erste Parameter ein Boolean ist, der angibt, ob leere [[List|Listen]] ignoriert werden sollen. Die nachfolgenden Parameter sind die [[List|Listen]], die zusammengefügt werden sollen.

===Syntax===
mergeLists(Boolean parameter, [[List]] list1, [[List]] list2...)

===Parameter===
* '''parameter''' - ein Boolean, der angibt, ob leere [[List|Listen]] mit dem leeren Element ausgewertet werden sollen
* '''list''' - die [[List|Listen]], welche zusammengefügt werden sollen

===Return Value===
* Gibt eine zusammengefügte [[List|Liste]] zurück, welche aus den eingegebenen [[List|Listen]] besteht.

===Beispiele===
==== Standardfälle ====
mergeLists(false(), list(1,3,4), list(2,3)) --> returns list(1,3,4,2,3)
mergeLists(false(), list(1,2), list(), list(4,6,7)) --> returns list(1,2,4,6,7)
mergeLists(true(), list(1,2), list(), list(4,6,7)) --> returns list(1,2,empty,4,6,7)

[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Testfunktionen]][[Kategorie:Listfunktionen]][[Kategorie:JACK3]]