0%

Use Math App authoring guidelines

Use Math App authoring guidelines

A Math App question presents your interactive MapleTM document online using the Möbius math engine (MapleNetTM).

The Math App (that is, the Maple document that you uploaded to Möbius) is in read-only mode when presented with MapleNet, however students are still able to interact with the components in the document.

You can author a Math App question to include grading code built inside of the Math App itself (instead of inputting the grading code directly into Möbius).

Authoring guidelines are presented below to help you get the most out of your Math App questions.

Actions module and startup code

Möbius uses the following two processes for a Math App component in an activity:

  • A save state process in order to preserve the student's partial answer.

  • A restore process to load the save state when the student returns to that question.

As a result, you need to declare all variables and procedures for loading and reloading your Math App within an Actions module, defined in the Startup Code.

Möbius checks the Actions module for exported procedures:

  • InitParams — A procedure that runs when the Maple document is loaded in Möbius, and accepts the Initialization Parameters defined in the Math App question.

  • Grade — A procedure that runs when the Math App question is graded and returns a floating point number between 0.0 and 1.0.

  • Any other procedures that may be used by components in the worksheet.

Any variables should be captured inside the Actions module as one of the following so that Möbius can communicate with your Math App Maple worksheet:

  • An export or exported procedure which is used within the Math App itself, or is one of the previously listed exports.

  • A local variable for variables not called for by Möbius or Maple outside the Actions module.

  • A global variable for variables called for by Möbius or Maple outside the Actions module.

When viewing a Math App component in an activity for the first time, the Maple math engine will open and display the worksheet as it was saved, and then run the Startup Code to update the Math App.

This can result in students seeing visible changes when the worksheet is displayed; consider saving the worksheet in Maple in a default state.

Support of Maple features in MapleNet

Embedded components

Math Apps in Möbius are initialized using MapleNet.

The following table summarizes MapleNet support for different embedded components, as well as any limitations of those that are supported:

Component

Supported

Limitations

Button

Yes

fontcolor isn't supported

Check Box

Yes

fontcolor and fillcolor aren't supported

Combo Box

Yes

fontcolor isn't supported

Data Table

No

Dial

Yes

Label

Yes

fontcolor and fillcolor aren't supported

List Box

Yes

fontcolor and fillcolor aren't supported

Math Expression

Yes

fillcolor isn't supported

Meter

Yes

Microphone

No

Plot

Yes

fillcolor and mouseMode aren't supported

Radio Button

Yes

fillcolor and fontcolor aren't supported

Rotary Gauge

Yes

Shortcut

Yes

Slider

Yes

fontcolor and fillcolor aren't supported

Speaker

No

Text Area

Yes

fontcolor isn't supported

Toggle Button

Yes

Video

No

Volume Gauge

Yes

Plot types and plot options

Maple plots in Möbius can be defined using Maple code and the plotmaple algorithm command, and are then generated using MapleNet.

The following table summarizes limitations on the support for different plot types and plot options:

Plot Option/Type

Limitations

Polar Plot

Rendered as an image

Logarithmic Axis

Rendered as an image

Dual Axis

Rendered as an image

2D Grid Plot

Unsupported

2D Mesh Plot

Rendered as an image

Background Image for Plot

Rendered as an image

2D colorscheme

Uses one color from the scheme for the plot

Array Plots

Unsupported

smartplot

Unsupported

0%