[Scenes] Support a few additional Math.js functions

Feature requests
,
1

v4.58 added native handling of the Math.js ‹ random › function so it can be called directly in actions that calculate a value (and it’s particularly handy in the « Wait » action).

And it’s, of course, more intuitive than having to use the alternative with the « HTTP Request » action as described here.

I would need to use the math.js ‹ exp › function to define a watering duration that intensifies as follows when my tank is well filled:

Screenshot 2025-05-12 145623
Screenshot 2025-05-12 145623611×470 8.84 KB

I couldn’t find in the docs an existing list of mathjs functions supported natively (does one exist and I missed it?). From my tests, these functions are already supported:

  • abs
  • random
  • ceil, floor, round
  • compare, larger, largerEq (and so I suppose smaller, smallerEq… as well, but I haven’t tested)

Among everything Math.js offers, I would find it useful to add the following functions:

  • min, max, mean
  • log, exp, square, sqrt (and maybe cube and cbrt)

@pierre-gilles would you like a feature request per mathjs function?

2

No, in this case this one is sufficient :slight_smile:

Thanks for the request!

3

@pierre-gilles , where can we find the list of native functions usable in scenes ? thanks

4

Hi @Nagromdark,

You’re right, there’s no documentation on this. I’ve made a note to look into it.

In the meantime, here are the available functions:

  • add - Addition
  • divide - Division
  • larger - Comparison « greater than » (>)
  • smaller - Comparison « less than » (<)
  • largerEq - Comparison « greater than or equal to » (>=)
  • smallerEq - Comparison « less than or equal to » (<=)
  • mod - Modulo operation
  • round - Rounding numbers
  • random - Random number generation

To use these functions, I recommend the Mathjs documentation: https://mathjs.org/

I’ll keep you posted as soon as I’ve written clearer documentation with examples :slight_smile:

5

@pierre-gilles, based on some tests I ran, the functions ‹ compare ›, ‹ abs ›, ‹ ceil › and ‹ floor › also work.

6

@Nagromdark @StephaneB I added new documentation:

I updated the documentation of Wait and Condition on variables to mention this page about the available math functions!

I managed to use everything, except compare which doesn’t work for me, so I didn’t include it in the documentation. How did you do it?

7

Well, easy, I must have taken an illicit substance… :stuck_out_tongue_closed_eyes: Because I can’t reproduce what I thought I saw working either… Sorry for the false lead :smiling_face:

8

And thanks for this page, it will be very useful. Maybe the page could also describe the method via an HTTP request, for those who would like to use some slightly exotic mathjs methods?

9

Which more exotic methods are you talking about? I think it will take longer to write that documentation than to add the methods in Gladys :stuck_out_tongue:

10

Well, there are the ones I listed above. But unless you plan to add them soon:

  • min, max, mean
  • log, exp, square, sqrt (and maybe cube and cbrt)

And otherwise, a home automation enthusiast AND mathematician :wink: might want to use the mathematical functions fix(), mod(), gcd(), lcm(), the logical functions and(), not(), or(), xor(), the function randomInt(), the comparison functions compare(), equal(), unequal(), the text comparison functions compareText(), equalText(), the statistical function median(), some trigonometric functions, …
And I’m only picking the ones whose purpose I understand, but there are plenty of others that might also be useful, I don’t know… That’s why it would seem useful to explain that calling mathjs.org is also possible.

11

so that one is for me :stuck_out_tongue_winking_eye:

12

I figured you’d react :face_savoring_food:

13

Hi everyone!

This topic is now under development.

A PR has been opened to support more mathematical functions in scene formulas:

Don’t hesitate to follow the PR, test as soon as possible, and share your feedback here.