MathCAT icon indicating copy to clipboard operation
MathCAT copied to clipboard

Parentheses are not announced for functions with only one term passed to them when configured for Blindness, ClearSpeak verbose

Open brichwin opened this issue 1 year ago • 1 comments

With MathCAT 0.3.0 configured to output for Blindness using ClearSpeak Verbose, the parentheses for functions with only one term passed to them are not announced. This seems to go against the pattern of producing speech that is explicit with notation and not being dependent on pauses. For example, when so configured the output for $\sin(3i)-2i$ is:

  sine of 3 i, minus 2 i

Would it be appropriate to output the parentheses as the following?

sine of, open paren, 3 i; close paren; minus 2 i

The mathML for the above expression is:

<math xmlns="http://www.w3.org/1998/Math/MathML">
  <mi>sin</mi>
  <mo>&#x2061;<!-- ⁡ --></mo>
  <mo stretchy="false">(</mo>
  <mn>3</mn>
  <mi>i</mi>
  <mo stretchy="false">)</mo>
  <mo>&#x2212;<!-- − --></mo>
  <mn>2</mn>
  <mi>i</mi>
</math>

brichwin avatar Jul 27 '23 01:07 brichwin

In a classroom, a teacher would very likely say it without parens and it is unambiguous for standard notation. ClearSpeak has a notion of "simple" and simple args do not require speaking the parens to be unambiguous.

Here's ClearSpeak's definition

Definition: Simple Expression In the rules and preferences, an expression is called simple if it is one of the following.• A number that is an integer, a decimal, or a fraction that is spoken as an ordinal* • A letter, two juxtaposed letters (e.g., x, y, z, xy, yz, etc.), the negative of a letter, or the negative of two juxtaposed letters (e.g., , , , , , etc.) • An integer, decimal, letter, or the negative of a letter that is followed by the degree sign (e.g., , , , ) • A number that is an integer, a decimal, or a fraction that is spoken as an ordinal* and is followed by a letter or pair of juxtaposed letters (e.g., 2x, , 4.1z, 2xy, ) • A function (including trigonometric and logarithmic functions) with an argument that is a simple expression (e.g., , , )

  • either by the Fraction_Ordinal preference or by the default fraction rules

Note: The fraction spoken as an ordinal is “one-third”, and the fraction spoken as an ordinal is “three-fourths”.

In general, the less extra words spoken, the more a student can understand without review.

If this explanation is satisfactory, please close the issue. Otherwise, feel free to give a counterargument.

NSoiffer avatar Jul 27 '23 04:07 NSoiffer