STACK Dokumentaatio
Dokumentaation juuri | Kategoriahakemisto | Sivukartta | English site map
GeoGebra in STACK
Author Tim Lutz - University of Edinburgh and University of Education Heidelberg, 2022-23.
STACK supports inclusion of dynamic graphics using GeoGebra: https://geogebra.org. This page is reference documentation when using GeoGebra applets both to display GeoGebra worksheets as part of a STACK question, and how to connect GeoGebra worksheets to a STACK input.
To help with assessment, STACK provides a number of geometry related maxima functions.
Please note that significant computation and calculation can be done within GeoGebra itself. In many cases it might be much better to establish mathematical properties within the GeoGebra applet, and link the results to STACK inputs. These results could be the distance between relevant objects, or boolean results.
A current restriction of the STACK design is that you cannot have a variable name in question variables which also matches the name of an input.
For example, you cannot randomly generate the initial position of a point \(A\) with the "set" instruction, and also link this GeoGebra object to the input input:A
with a "watch" instruction.
In this situation you will need to have dependent objects (probably hidden) in GeoGebra which match to inputs.
(This is hard-wired into the design of STACK and cannot be changed, sorry.)
A note on licenses: Please note that GeoGebra's license does not match the STACK licence. Users of STACK remain entirely responsible for complying with license for materials, and media embedded inside STACK questions.
Adding a GeoGebra question block using the material_id
To use GeoGebra in STACK an applet must be hosted at geogebra.org and the applet must be publicly available through a url.
To include a GeoGebra applet into a STACK castext field (e.g. the question text), first create or search for an existing GeoGebra applet at geogebra.org. To set things up we need the material_id
of an applet, we want to show.
For the material https://www.geogebra.org/m/seehz3km the material_id
is: seehz3km
An example [[geogebra]]
question block is shown below.
<p>You can show an applet:</p>
[[geogebra]]
params["material_id"]="seehz3km";
[[/geogebra]]
This illustrates how the material_id is used.
Using the sub-tags "set", "watch" and "remember"
The "set", "watch" and "remember" tags to the [[geogebra]]
question block link Maxima values to GeoGebra objects in various ways.
- "set" will set a GeoGebra object, point or value to a STACK-calculated value.
- "watch" enables a STACK input to listen to values and points in GeoGebra.
- "remember" is needed when you do not want to calculate feedback with some of the GeoGebra objects in an applet, but you do want to be able to save and restore the state of an applet when the student returns to the question later.
Naming conventions
To be able to make things consistent and easy for question authors, the following name conventions must be followed:
- Names of variables must be equal in both STACK and GeoGebra. However, no explicit checking is done.
- Value-names must start with lower case letters.
- Values must be
int
orfloat
STACK variables. - Angles are used like values, and so must be named lowercase letters in Latin-Alphabet, (not Greek unicode letters!) and values must be in radians. (If you want to show a Greek letter to the student, then have a parallel internal variable which is used by STACK. E.g. call the angle \(\alpha\) visibly in GGB, but have a hidden GGB variable \(a\) which you can watch.)
- Point-names must start with upper case letters.
- Points are represented as a list in STACK. For example
D:[2,3]
, means a point \(D\) with \(x=2, y=3\). (While STACK has an inertntuple
command which can be used for representing and displaying coordinates, we have chosen to use lists in this design.)
The value of the set
parameter must be a string of (unique), comma-separated, GeoGebra-objects with latin names.
For example, the sub-tag value could look like: set = "A,B,C,D,a2,E__fixed"
and would be placed in the block as
[[geogebra set = "A,B,C,D,a2,E__fixed"]]
[[/geogebra]]
Using the "set" sub-tag
With the "set" sub-tag you can set a GeoGebra object (currently a point or a value) to a STACK-calculated value when the applet is first loaded.
By default points are free to manipulate in the applet, unless you add __fixed
or other double-underscore-tags to the Point-name. A full list of available options see "set: double-underscore-tags in the "advanced use-cases"-section.
Notes
- No checking is done that the object in STACK matches one in GeoGebra. If it does not exist it will be created by GeoGebra.
Currently setting points and values are the only supported objects. Users can set objects, e.g. you could define
g:x^3
and set this in an applet.Angles cannot be set directly, set points instead!
A minimal example question with "set": can a student read (randomly) generated coordinates?
Set the question variables:
A:[2,3];
B:[1,2];
Set the question text:
[[geogebra set="A,B"]]
params["material_id"]="seehz3km";
[[/geogebra]]
Write the coordinates of \(A\): [[input:ans1]][[validation:ans1]]
Then complete the question as follows.
- In the input, make the model answer
A
. This is a list. - Make sure you set "forbid floats" option in the input to be false, if you want to!
- Complete the default potential response tree
prt1
asATAlgEquiv(ntupleify(ans1),ntupleify(A))
This should give a minimal working GGB question with "set".
The use of the STACK function ntupleify
ensures both the student's answer and teacher's answer is converted from a list to an ntuple
. STACK defines ntuple
as data type allowing an "n-tuple" such as \( (1,2) \) to be a different data type from a "list" \( [1,2] \). Internally in STACK/GGB lists are given preference in the design, but completing the PRT as above will allow student input of coordinates using traditional round brackets, which is interpreted by STACK as a data type ntuple
. See the docs on sets, lists, sequences and n-typles.
The question can readily be adapted by making A
a randomly generated object, if required.
Using the "watch" sub-tag
With the "watch" sub-tag someone can listen to values and points in GeoGebra. These values can then be used to calculate feedback in STACK. The values will be assigned to a STACK input. Note, inputs can be "hidden" from the student.
General notes for watched objects
- Points, e.g.
A
, must be an algebraic-input and you must allow floats! - You can access
A
in STACK for feedback as a list of values for pointsA[0]->x-value
,A[1]->y-value
- Numbers/angles e.g.
b
can be an algebraic or numerical input, and you must allow floats! - You can access
b
in STACK as value. Ifb
represents an angle thenb
is in radians.
Minimal example watching point A.
Set the question variables to be
ta1:[2,3];
Set the question text:
[[geogebra watch="A"]]
params["material_id"]="seehz3km";
[[/geogebra]]
Move \(A\) to be the point \({@ntupleify(ta1)@}\)
[[input:A]][[validation:A]]
Recall that since the object in watch="A"
is written in upper case it must be a point.
Then complete the question as follows.
- The question expects an input
A
. In this input, make the model answerta1
. This is a list, and has a different name from the watched point.. - Make sure you set "forbid floats" option in the input to be false, if you want to!
- Complete the default potential response tree
prt1
asATAlgEquiv(ntupleify(A), ntupleify(ta1))
Once the question is working you can hide the inputs from students, but for testing it is helpful to see the input boxes.
- Hide an input with CSS, e.g.
<p style="display:none">[[input:A]] [[validation:A]]</p>
(but probably not while you develop the question!) - Turn off the validation ("Show the validation") and verification ("Student must verify") of the input field.
Extensions to this basic question:
- The question can readily be adapted by making
ta1
a randomly generated object, if required. - The answer test requires exact positioning of point
A
on the required coordinates. In this GGB sheet we have "snap to grid" so it is reasonable to ask for exact positioning of the pointA
in this case. An alternative approximate positioning \( ||A-ta1||<0.1 \) can be established using the Num-GT answer test:ATGT(0.1, Distance(A,ta1))
. STACK provides a number of geometry related maxima functions, includingDistance
which is used here.
Using the "remember" sub-tag
If you do not want to calculate feedback with some of the GeoGebra objects in an applet, but you do want to be able to save and restore the state of an applet, you can use the "remember" tag.
You still need an input in the question to store these values. The only way STACK can store "state" is through inputs. This input must be of type "string" (because we store these values as a JSON-string internally). The name "remember" is hard-wired (for now).
Minimal example remember B,C
In the above example (watch), we want to remember the positions of \(B\) and \(C\)
Set the question text:
[[geogebra watch="A" remember="B,C"]]
params["material_id"]="seehz3km";
[[/geogebra]]
Move \(A\) to be the point \({@ntupleify(ta1)@}\)
[[input:A]][[validation:A]]
[[input:remember]][[validation:remember]]
- The
remember
input must be of type string, and can not be used to calculate values in STACK feedback. - For the "model answer" use the empty string
""
. - The name "remember" is hard-wired (in this version).
- We don't want to show the model answer of "remember" as part of the teacher's final answer (if available during the quiz) so hide the input from students with the STACK "extra option"
hideanswer
in the "remember" input. - Once working, hide the "remember" input with CSS, e.g.
<p style="display:none">[[input:remember]][[validation:remember]]</p>
(but probably not while you develop the question!)
Minimal example watching an indirect GGB object, e.g. angle k.
In the above example we have angle \(k\). To watch this value we can add k
to the list of watched variables. E.g.
[[geogebra watch="A,k" remember="B,C"]]
params["material_id"]="seehz3km";
[[/geogebra]]
Move \(A\) to be the point \({@ntupleify(ta1)@}\), and points \(B,C\) so that there is a right angle at \(B\).
[[input:A]][[validation:A]]
[[input:k]][[validation:k]]
[[input:remember]][[validation:remember]]
- Numbers/angles e.g. input
k
can be an algebraic or numerical input, and you must allow floats! - The value of \(k\) will come through as a float. Hence, you need to check if this is sufficiently close to \(\pi/2\) with a numerical test. You could add the test
ATNumAbsolute(k,%pi/2,0.01)
to check \(|k-\pi/2|<0.01\) as a check the angle is right.
An alternative would be to check this in GeoGebra and create a variable with a value of \(0\) or \(1\), and watch this proxy variable. The advantage of a numerical test is that you could give feedback which includes the angle.
Your angle is {@round(k*180/%pi)@} degrees, which is not a right angle!
Example: using some advanced features.
This example illustrates some of the advanced features
Set the question variables to be
A:[-2,0];
B:[1,0];
Set the question text to be
[[geogebra set="A,B" watch="a,b" remember="P"]]
params["material_id"]="rukrpcs5";
[[/geogebra]]
Move \(P\) so that the angle \(\alpha\) is a right angle.
[[input:a]][[validation:a]]
[[input:b]][[validation:b]]
[[input:remember]][[validation:remember]]
Notes
- This GGB sheet has a variable
a
(hidden) which stores the angle \(\alpha\) in a way STACK can access the Greek letter. - This GGB sheet has a boolean variable
b
. This will comes through to STACK as a number, \(0\) or \(1\). - The use of
"remember"
means we need an string input to store the state ofP
between attempts.
Advanced use-cases
set: double-underscore-tags
The set sub-tag allows more control over setting objects using double-underscore-tags.
"fixed" keyword
Using this keyword stops users from moving the point in GeoGebra. E.g. set = "A__fixed"
.
"preserve" keyword
If you want to preserve GeoGebra definitions of points or values when setting them add the __preserve
keyword to that object. For example, if a point \(P\) lies on a circle then setting P__preserve
keeps the point on the circle.
Common example: "Points on objects"
For example, assume "A" is a GeoGebra-Point on an object, like \(A\) is a point on the circle \(B\).
When you set A like: set ="A"
, the definition of \(A\) will be overwritten by default.
When you set A like: set="A__preserve"
then "A__preserve"
will preserve that A is a Point on B and tries to set A near to your STACK variable A but on the circle.
Common example: "Sliders"
"a" should be a GeoGebra-value controlled by a slider ranging from -5 to 5.
When you set a like: set = "a"
, the definition of a will be overwritten, e.g. if the STACK variable a is 10, after initialization a is 10 in GeoGebra.
When you set a like: set = "a__preserve"
then "a__preserve"
will preserve that a is in range -5 to 5. If you set a in STACK to 10, a in GeoGebra will be set to the nearest value, in this example a will be 5 in GeoGebra.
Hide and show keyword
If you want to set and hide a value in GeoGebra add the __hide or __show keyword.
set="a__hide"
-> set and hideset="a__show"
-> set and show
Multiple keywords
It is possible to use multiple keywords. E.g. both
A__hide__fixed
A__fixed__hide
will set \(A\) as a fixed point and hide it. Keyword order is not relevant.
Special keyword novalue
The GeoGebra object value should not be set, this keyword is helpful, if you just want to hide or show something, see "multiple keywords".
set="A__hide__novalue"
Hide A but do not set the value for \(A\)set="A__hide__novalue"
watch="A"` Watch \(A\), but hide it and do not set it.
Using commands inside [[geogebra]][[/geogebra]]
blocks
You can use the following commands inside the geogebra tag if the sub tags do not fit your task idea:
stack_geogebra_bind_point(args)
stack_geogebra_bind_value(args)
stack_geogebra_bind_value_to_remember_JSON(args)
stack_geogebra_bind_point_to_remember_JSON(args)
Example of using commands inside [[geogebra]][[/geogebra]]
blocks
[[geogebra input-ref-stateStore="stateRef" set="b" watch="B"]]
params["material_id"]="AEAVEqPy";
params["appletOnLoad"]=function(){stack_geogebra.bind_point_to_remember_JSON(stateRef,appletObject, 'A');
stack_geogebra.bind_value_to_remember_JSON(stateRef,appletObject, 'c')};
[[/geogebra]]
[[input:stateStore]]
[[validation:stateStore]]
[[input:B]][[validation:B]]
Advanced users might want to look at documentation for common app settings which can be addressed through params["nameOfSetting"] array, as shown in https://wiki.geogebra.org/en/Reference:GeoGebra_App_Parameters.
Example of using commands inside [[geogebra]][[/geogebra]]
blocks to define geogbra objects
It is possible to update existing objects, or indeed to create new objects inside GeoGebra. An example is below.
I want to display the function \(x^3\) in GeoGebra
[[geogebra]]
params["appletOnLoad"]=function(){appletObject.evalCommand("f(x):=x^3")};
[[/geogebra]]
[[input:ans1]] [[validation:ans1]]
Please note that the STACK and GeoGebra syntax do not match perfectly. For example, g:%pi*x^3
will throw an error in GeoGebra because %pi
in Maxima does not match pi
in GeoGebra. (Functionality to match syntax may be supported in the future but matching maxima syntax to GeoGebra syntax is a lot of work.)
Future plans
- GeoGebra boolean types should come through to STACK as just return true/false (not 0,1).
- Suppport set/watch of more complex objects.
Dokumentaation juuri | Kategoriahakemisto | Sivukartta | English site map
The STACK documentation is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.