Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Simple Univariate Functions and Similar Expressions Should Not Be Treated as Implicit Multiplication in Terse Mode #336

Closed
NV-Codes opened this issue Jan 10, 2025 · 2 comments

Comments

@NV-Codes
Copy link
Contributor

NV-Codes commented Jan 10, 2025

MathCAT Version

MathCAT-0.6.7 (NVDA Add-On, Development Build Pre-Release)

Issue

Simple univariate functions, such as $f (r)$, and similar expressions, such as $f (\mathbf r)$, are respectively verbalized as "f r" and "f bold r" in MathCAT's terse mode for SimpleSpeak and ClearSpeak. Functions with more complex arguments (including $r'$ and $\vec{r}$) are verbalized with "open" and "close" to indicate parentheses. The current verbalization of functions with simple arguments is prone to misinterpretation and should likely be resolved by the addition of the word "of" (recognizing function notation) or the words "open" and "close" (recognizing the parentheses) to make the expressions clearer.

Although the expressions in concern could represent multiplication, it is better for a user to hear a false positive for function notation than a false negative for it; "f of r" or "f open r close" err on the side of too much information (though the user would be able to tell whether a function or implicit multiplication was intended), but "f r" would likely always be interpreted as a simple product, even when a function was intended.

It seems that using "open" and "close" would be more in line with the behavior of MathCAT's terse mode than using "of" for function notation. For instance, MathCAT reads $f(r + y)$ as "f of open paren r plus y close paren" using medium verbosity and "f open r plus y close" using terse verbosity. Thus, rather than adding the rule for function notation (and consequently the accompanying word "of") to terse verbosity, $f(r)$ should likely be verbalized as "f open r close" in terse verbosity, helping to avoid misleading listeners into thinking that the expression must not represent a function.

@NV-Codes NV-Codes changed the title Simple Univariate Functions Should Be Treated as Such in Terse Mode Simple Univariate Functions and Similar Expressions Should Not Be Treated as Implicit Multiplication in Terse Mode Jan 10, 2025
@NSoiffer
Copy link
Owner

The "f r" verbalization is a generalization of "sin x". I guess it is too general. I'll restrict it to trig/log functions.

@NSoiffer
Copy link
Owner

@NV-Codes: I have a build with this fix and the other fixes the github repo. The version with the fix is MathCAT-0.6.7-rc.5.nvda-addon.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants