SolveFeedback - Maple Help

 SolveFeedback
 generate feedback for a step-by-step solution

 Calling Sequence SolveFeedback(solution,options)

Parameters

 solution - solution steps {canvas-string,table,rtable,list} options - (optional) equation(s) of the form option = value where option is one of variables, equations, or solutions

Options

 • variables = list, the variable(s) to solve for
 • equations = list, the initial expression
 • solutions = list, the solutions that are relevant

Description

 • The SolveFeedback command is the procedure behind the SolvePractice command.  It analyzes a step-by-step solution to the given problem and provides feedback for each step of the solution.  It can also be called directly, or used behind the scenes for other interactive applications of your own design.
 • The solution argument, when part of an interactive canvas-based application, is a XML-based string representing a canvas, or a table representing the embedded component name mapping.  In this case, the returned result is a DocumentTools:-Canvas:-Script.
 When called directly, solution can also be a list or array of expressions.  In this case, the returned result is a list of feedback strings.  The result has one extra string than the number of input steps, concluding with a (possibly empty) summary statement.
 • The variables = [x] option is useful to provide when the expression to solve for is multivariate.  This clarifies exactly which variable is to be solved for.   As of Maple 2020, the list must contain exactly one variable.
 • The solutions = [x=0] option allows you to specify which solutions are relevant to the given problem, in order to avoid feedback that prompts to solve for more solutions.
 • The equations = [...] option allows you to specify the initial expression, as opposed to showing it as the first expression in a canvas.  This way it is up to the user to come up with the equation themselves.

Examples

 > $\mathrm{with}\left(\mathrm{Grading}\right):$
 > $\mathrm{SolveFeedback}\left(\left[2x+3=4x-5,2x-4x=-5-3,-2x=-8,x=4\right]\right)$
 $\left[{""}{,}{"ok"}{,}{"ok"}{,}{"Good job, this is the correct solution"}{,}{""}\right]$ (1)
 > $\mathrm{SolveFeedback}\left(\left[2x+3=4x-5,2x-4x=-5+3,-2x=-2,x=1\right]\right)$
 $\left[{""}{,}{"Check this step..."}{,}{"consistent with previous step"}{,}{"consistent with previous step"}{,}{"no correct and fully simplified solution found; please try again"}\right]$ (2)
 > $\mathrm{SolveFeedback}\left(\left[2x+y=4y,2x=3y,y=\frac{2}{3}x\right],\mathrm{variables}=\left[y\right]\right)$
 $\left[{""}{,}{"ok"}{,}{"Good job, this is the correct solution"}{,}{""}\right]$ (3)

In this example we create an interactive canvas presenting a word problem.  The input equation is not shown.  Note that the t=-2 root is not part of the solutions list, as it does not make physical sense.

 > $\mathrm{with}\left(\mathrm{Grading}\right):$
 > $\mathrm{with}\left(\mathrm{DocumentTools}:-\mathrm{Canvas}\right):$
 > $\mathrm{cv}≔\mathrm{NewCanvas}\left(\left["An object is launched at 19.6 meters per second \left(m/s\right) from a 58.8-meter tall platform. The equation for the object\text{'}s height s at time t seconds after launch is",s\left(t\right)=3.4220022349×{10}^{9}{t}^{2}+19.6t+58.8,"where s is in meters. When does the object strike the ground?",\mathrm{ScriptButton}\left("Check Page","Grading\left[SolveFeedback\right]\left(_canvas,equations=\left[t^2-4*t-12=0\right],variables=\left[t\right],solutions=\left[t=6\right]\right);",\mathrm{position}=\left[800,90\right],\mathrm{encode}=\mathrm{false}\right)\right]\right):$
 > $\mathrm{ShowCanvas}\left(\mathrm{cv},\mathrm{input}=\left["0 = t^2 -4*t -12","0 = \left(t-6\right)*\left(t+2\right)","t=6"\right]\right)$

The feedback can be generated directly as follows:

 > $\mathrm{SolveFeedback}\left(\left["0 = t^2 -4*t -12","0 = \left(t-6\right)*\left(t+2\right)","t=6"\right],\mathrm{equations}=\left[{t}^{2}-4t-12=0\right],\mathrm{variables}=\left[t\right],\mathrm{solutions}=\left[t=6\right]\right)$
 $\left[{""}{,}{"ok"}{,}{"Good job, this is a correct solution"}{,}{"Good job, you found the correct solution"}\right]$ (4)

The canvas can also be shared via Maple Learn:

 > $\mathrm{ShareCanvas}\left(\mathrm{cv}\right)$

Compatibility

 • The Grading:-SolveFeedback command was introduced in Maple 2021.