SigmundAI Copilot allows you to build and debug experiments with help from artificial intelligence. Install the Sigmund extension (public beta) and try it out now!

Gemeinsame Funktionen

Die folgenden Funktionen sind in inline_javascript-Elementen verfügbar:

## reset\_feedback() Setzt alle Feedback-Variablen auf ihren Anfangszustand zurück. **Beispiel**

reset_feedback()

<a name="set_subject_nr"></a> ## set\_subject\_nr(nr) Legt die Teilnehmernummer und Parität (gerade/ungerade) fest. Diese Funktion wird automatisch aufgerufen, wenn ein Experiment gestartet wird. Sie müssen sie also nur selbst aufrufen, wenn Sie die Teilnehmernummer überschreiben möchten, die beim Start des Experiments angegeben wurde. | Param | Typ | Beschreibung | | --- | --- | --- | | nr | <code>Number</code> | Die Teilnehmernummer | **Beispiel**

set_subject_nr(1)
console.log('Teilnehmernr. = ' + vars.subject_nr)
console.log('Teilnehmerparität = ' + vars.subject_parity)

<a name="sometimes"></a> ## sometimes([p]) Gibt mit einer bestimmten Wahrscheinlichkeit true zurück. (Für fortgeschrittene Zufallsverteilungen verwenden Sie das Paket `random-ext`, das als `random` verfügbar ist.) | Param | Typ | Default | Beschreibung | | --- | --- | --- | --- | | [p] | <code>Number</code> | <code>.5</code> | Die Wahrscheinlichkeit, dass true zurückgegeben wird | **Beispiel**

if (sometimes()) {
  console.log('Manchmal gewinnt man')
} else {
  console.log('Manchmal verliert man')
}

<a name="xy_from_polar"></a> ## xy\_from\_polar(rho, phi, [pole]) ⇒ <code>Array.<Number></code> Konvertiert Polarkoordinaten (Abstand, Winkel) in kartesische Koordinaten (x, y). **Gibt zurück**: <code>Array.<Number></code> - Ein [x, y] Array. | Param | Typ | Default | Beschreibung | | --- | --- | --- | --- | | rho | <code>Number</code> | | Die radiale Koordinate, auch Abstand oder Exzentrizität. | | phi | <code>Number</code> | | Die Winkelkoordinate. Dies entspricht einer Uhrzeigersinn-Drehung in Grad (also nicht in Radiant), wobei 0 gerade nach rechts zeigt. | | [pole] | <code>Array.<Number></code> | <code>[0, 0]</code> | Der Referenzpunkt. | **Beispiel**

// ECMA 5.1
var xy1 = xy_from_polar(100, 45)
var xy2 = xy_from_polar(100, -45)
var c = Canvas()
c.line({sx: xy1[0], sy: xy1[1], ex: -xy1[0], ey: -xy1[1]})
c.line({sx: xy2[0], sy: xy2[1], ex: -xy2[0], ey: -xy2[1]})
c.show()
// ECMA 6
let [x1, y1] = xy_from_polar(100, 45)
let [x2, y2] = xy_from_polar(100, -45)
let c = Canvas()
c.line({sx: x1, sy: y1, ex: -x1, ey: -y1})
c.line({sx: x2, sy: y2, ex: -x2, ey: -y2})
c.show()

<a name="xy_to_polar"></a> ## xy\_to\_polar(x, y, [pole]) ⇒ <code>Array.<Number></code> Konvertiert kartesische Koordinaten (x, y) in Polarkoordinaten (Abstand, Winkel). **Gibt zurück**: <code>Array.<Number></code> - Ein [rho, phi] Array. Hier ist `rho` die radiale Koordinate, auch Abstand oder Exzentrizität. `phi` ist die Winkelkoordinate in Grad (also nicht in Radiant) und spiegelt eine gegen den Uhrzeigersinn gerichtete Drehung wider, wobei 0 gerade nach rechts zeigt. | Param | Typ | Default | Beschreibung | | --- | --- | --- | --- | | x | <code>Number</code> | | Die X-Koordinate. | | y | <code>Number</code> | | Die Y-Koordinate | | [pole] | <code>Array.<Number></code> | <code>[0, 0]</code> | Der Referenzpunkt. | **Beispiel**

// ECMA 5.1 (browser + desktop)
var rho_phi = xy_to_polar(100, 100)
var rho = rho_phi[0]
var phi = rho_phi[1]
// ECMA 6 (browser only)
let [rho, phi] = xy_to_polar(100, 100)

<a name="xy_distance"></a> ## xy\_distance(x1, y1, x2, y2) ⇒ <code>Number</code> Gibt den Abstand zwischen zwei Punkten an. **Gibt zurück**: <code>Number</code> - Der Abstand zwischen den beiden Punkten. | Param | Typ | Beschreibung | | --- | --- | --- | | x1 | <code>Number</code> | Die x-Koordinate des ersten Punkts. | | y1 | <code>Number</code> | Die y-Koordinate des ersten Punkts. | | x2 | <code>Number</code> | Die x-Koordinate des zweiten Punkts. | | y2 | <code>Number</code> | Die y-Koordinate des zweiten Punkts. | <a name="xy_circle"></a> ## xy\_circle(n, rho, [phi0], [pole]) ⇒ <code>Array.<Array.<Number>></code> Erstellt eine Liste von Punkten (x, y Koordinaten) in einem Kreis. Dies kann verwendet werden, um Reize in einer kreisförmigen Anordnung darzustellen. **Rückgabe**: <code>Array.<Array.<Number>></code> - Ein Array aus [x,y]-Koordinatenarrays. | Parameter | Typ | Standard | Beschreibung | | --- | --- | --- | --- | | n | <code>Number</code> | | Die Anzahl der zu generierenden x,y-Koordinaten. | | rho | <code>Number</code> | | Der radiale Koordinaten-, auch Abstands- oder Exzentrizitätswert, des ersten Punktes. | | [phi0] | <code>Number</code> | <code>0</code> | Der Winkelkoordinatenwert für die erste Koordinate. Dies ist eine Drehung gegen den Uhrzeigersinn in Grad (d.h. nicht im Bogenmaß), wobei 0 gerade rechts ist. | | [pol] | <code>Array.<Number></code> | <code>[0, 0]</code> | Der Bezugspunkt. | **Beispiel**

// Zeichne 8 Rechtecke um einen zentralen Fixationspunkt
// ECMA 5.1 (Browser + Desktop)
var c = Canvas()
c.fixdot()
var points = xy_circle(8, 100)
for (var i in points) {
  var x = points[i][0]
  var y = points[i][1]
  c.rect({x: x - 10, y: y - 10, w: 20, h: 20})
}
c.show()
// ECMA 6 (nur Browser)
let c = Canvas()
c.fixdot()
for (let [x, y] of xy_circle(8, 100)) {
  c.rect({x: x - 10, y: y - 10, w: 20, h: 20})
}
c.show()

<a name="xy_grid"></a> ## xy\_grid(n, abstand, [pol]) ⇒ <code>Array.<Array.<Number>></code> Erzeugt eine Liste von Punkten (x,y-Koordinaten) in einem Raster. Dies kann verwendet werden, um Reize in einer Rasteranordnung darzustellen. **Rückgabe**: <code>Array.<Array.<Number>></code> - Ein Array aus [x,y]-Koordinatenarrays. | Parameter | Typ | Standard | Beschreibung | | --- | --- | --- | --- | | n | <code>Number</code> \| <code>Array.<Number></code> | | Eine Zahl, die die Anzahl der Spalten und Zeilen angibt, so dass `n=2` ein 2x2-Raster anzeigt, oder ein [n_col, n_row] Array, so dass `n=[2,3]` ein 2x3-Raster anzeigt. | | abstand | <code>Number</code> \| <code>Array.<Number></code> | | Ein numerischer Wert, der den Abstand zwischen den Zellen angibt, oder ein [col_spacing, row_spacing]-Array. | | [pol] | <code>Array.<Number></code> | <code>[0, 0]</code> | Der Bezugspunkt. | **Beispiel**

// Zeichne ein 4x4 Raster von Rechtecken
// ECMA 5 (Desktop + Browser)
var c = Canvas()
c.fixdot()
var points = xy_grid(4, 100)
for (var i in points) {
  var x = points[i][0]
  var y = points[i][1]
  c.rect({x: x - 10, y: y - 10, w: 20, h: 20})
}
c.show()
// ECMA 6 (nur Browser)
let c = Canvas()
c.fixdot()
for (let [x, y] of xy_grid(4, 100)) {
  c.rect({x: x-10, y: y-10, w: 20, h: 20})
}
c.show()

<a name="xy_random"></a> ## xy\_random(n, breite, höhe, [min_abstand], [pol]) ⇒ <code>Array.<Array.<Number>></code> Erzeugt eine Liste von zufälligen Punkten (x,y-Koordinaten) mit einem Minimum Abstand zwischen jedem Punktepaar. Diese Funktion wirft einen Fehler aus wenn die Koordinatenliste nicht generiert werden kann, üblicherweise, weil es zu viele Punkte gibt, der min_dist zu hoch eingestellt ist oder die Breite oder Höhe zu niedrig eingestellt sind. **Rückgabe**: <code>Array.<Array.<Number>></code> - Ein Array aus [x,y]-Koordinatenarrays. | Parameter | Typ | Standard | Beschreibung | | --- | --- | --- | --- | | n | <code>Number</code> | | Die Anzahl der zu generierenden Punkte. | | breite | <code>Number</code> | | Die Breite des Feldes mit zufälligen Punkten. | | höhe | <code>Number</code> | | Die Höhe des Feldes mit zufälligen Punkten. | | [min_abstand] | <code>Number</code> | <code>0</code> | Der minimale Abstand zwischen den Punkten. | | [pol] | <code>Array.<Number></code> | <code>[0, 0]</code> | Der Bezugspunkt. | **Beispiel**

// Zeichne 50 Rechtecke in einem Zufallsgitter
// ECMA 5 (Desktop + Browser)
var c = Canvas()
c.fixdot()
var points = xy_random(50, 500, 500, 40)
for (var i in points) {
  var x = points[i][0]
  var y = points[i][1]
  c.rect({x: x - 10, y: y - 10, w: 20, h: 20})
}
c.show()   
// ECMA 6 (nur Browser)
let c = Canvas()
c.fixdot()
for (let [x, y] of xy_random(50, 500, 500, 40)) {
  c.rect({x: x-10, y: y-10, w: 20, h: 20})
}
c.show()