Functions: Difference between revisions

From Seamly
Content added Content deleted
(Added a few use indications)
(Completed the basic functionality of the Functions list. All of the Functions in the dialog are entered, with basic usage notes.)
Line 11: Line 11:
'''*''' times (3*4=12)
'''*''' times (3*4=12)


'''/''' dividedby (3/4=.75)
'''/''' divided by (3/4=.75)


'''^''' to the power of (3^4=81)
'''^''' to the power of (3^4=81)
Line 17: Line 17:
== Advanced Functions ==
== Advanced Functions ==
Most of these functions are found in the table, however there are several which depend on your ability to construct an IF function in Seamly. As such, I will discuss the IF statement, (which is not in the list,) first, & then proceed in alphabetical order as the functions appear in the list. It may be better to list them by branch of mathematics, but for now the list, & thus the alphabet, has priority.
Most of these functions are found in the table, however there are several which depend on your ability to construct an IF function in Seamly. As such, I will discuss the IF statement, (which is not in the list,) first, & then proceed in alphabetical order as the functions appear in the list. It may be better to list them by branch of mathematics, but for now the list, & thus the alphabet, has priority.


Variables are always welcome to be equations, they do not need to be numerals.


==== IF function ====
==== IF function ====
Line 25: Line 28:


==== abs - absolute value ====
==== abs - absolute value ====
abs(3-4)=1<ref>[https://forum.seamly.net/t/negative-numbers/2043/2?u=pneumarian https://forum.seamly.net/t/negative-numbers/2043/2]</ref>
Use: '''abs(''N'')'''<ref>[https://forum.seamly.net/t/negative-numbers/2043/2?u=pneumarian https://forum.seamly.net/t/negative-numbers/2043/2]</ref> always returns a positive value


==== acos - arcus cosine function working with radians ====
==== acos - arcus cosine function working with radians ====
Line 55: Line 58:


==== avg - (average,) mean value of all arguments ====
==== avg - (average,) mean value of all arguments ====
Use: '''avg(''N1'';(''N2''))''' this does seem to be limited to two variables.
Use: '''avg(''N1'';''N2'';''N3'';…)'''


==== cos - cosine function working with radians ====
==== cos - cosine function working with radians ====
Line 69: Line 72:
Use: '''degTorad(''N'')'''
Use: '''degTorad(''N'')'''


==== exp - e raised to the power of x ====
==== exp - ''e'' raised to the power of x ====
Use: '''exp(''N'')''' If you have as much a clue what this is for as I do, may I suggest the Wikipedia article on the [https://en.wikipedia.org/wiki/E_(mathematical_constant) number ''e'']?
Use:


==== fmod - Returns the floating-point remainder of numer/denom (rounded towards zero) ====
==== fmod - Returns the floating-point remainder of numer/denom (rounded towards zero) ====
Use: '''fmod(''N'';''D'')'''


==== ln - logarithm to base e (2.71828…) ====
==== ln - logarithm to base e (2.71828…) ====
Use: '''ln(''N'')''' where N>0


==== log - logarithm to the base 10 ====
==== log - logarithm to the base 10 ====
Use: '''log(''N'')''' where N>0


==== log10 - logarithm to the base 10 ====
==== log10 - logarithm to the base 10 ====
Use: '''log10(''N'')''' where N>0


==== log2 - logarithm to the base 2 ====
==== log2 - logarithm to the base 2 ====
Use: '''log2(''N'')''' where N>0


====[[Max (function)|max]] - max of all arguments ====
====[[Max (function)|max]] - max of all arguments ====
Use: '''max(''N'';''N1'';''N2'';…)'''


====[[Min (function)|min]] - min of all arguments ====
====[[Min (function)|min]] - min of all arguments ====
Use: '''min(''N'';''N1'';''N2'';…)'''


==== radTodeg - converts radian to degrees ====
==== radTodeg - converts radian to degrees ====
Use: '''radTodeg(''N'')'''


==== rint - round to nearest integer ====
==== rint - round to nearest integer ====
Use: '''rint(''N'')'''


==== sign - sign function -1 if x<0; 1 if x>0 ====
==== sign - sign function -1 if x<0; 1 if x>0 ====
Use: '''sign(''N'')'''


==== sin - sine function working with radians ====
==== sin - sine function working with radians ====
Use: '''sin(''N'')'''


==== sinD - sine function working with degrees ====
==== sinD - sine function working with degrees ====
Use: '''sinD(''N'')'''


==== sinh - hyperbolic sine function ====
==== sinh - hyperbolic sine function ====
Use: '''sinh(''N'')'''


==== sqrt - square root of a value ====
==== sqrt - square root of a value ====
Use: '''sqrt(''N'')''' where N≥0


==== sum - sum of all arguments ====
==== sum - sum of all arguments ====
Use: '''sum(''N'';''N1'';''N2'';…)'''


==== tan - tangens function working with radians ====
==== tan - tangens function working with radians ====
Use: '''tan(''N'')'''


==== tanD - tangens function working with degrees ====
==== tanD - tangens function working with degrees ====
Use: '''tanD(''N'')'''


==== tanh - hyperbolic tangens function ====
==== tanh - hyperbolic tangens function ====
Use: '''tanh(''N'')'''


== Bibliography ==
== Bibliography ==

Revision as of 01:33, 14 May 2020

When writing out measurement equations in Seamly, there are many mathematical functions that one may use to make them work seamlessly. This is [to be] a list of the functions, with a one-line example of how to actually use them in equations. Functions are served by the muparser math library.[1]

The Functions table in the Measurement Dialog is an excellent place to find most of the available algebraic functions of Seamly.
A picture of the Functions table.

Basic Functions

These are functions which are so basic that they didn't get included in the list

+ plus (3+4=7)

- minus (3-4=-1)

* times (3*4=12)

/ divided by (3/4=.75)

^ to the power of (3^4=81)

Advanced Functions

Most of these functions are found in the table, however there are several which depend on your ability to construct an IF function in Seamly. As such, I will discuss the IF statement, (which is not in the list,) first, & then proceed in alphabetical order as the functions appear in the list. It may be better to list them by branch of mathematics, but for now the list, & thus the alphabet, has priority.


Variables are always welcome to be equations, they do not need to be numerals.

IF function

  • if a<b then c else d looks like ( a<b ? c : d) in Seamly2D formulas.
  • if e<f then f else g looks like (e<f ? f : g)
  • When d is another test, then it looks like: ( a<b ? c : (e<f ? f : g) )[2]

abs - absolute value

Use: abs(N)[3] always returns a positive value

acos - arcus cosine function working with radians

Use: acos(N) where -1≤N≤1

acosD - arcus cosine function working with degrees

Use: acosD(N) where -1≤N≤1

acosh - hyperbolic arcus cosine function

Use: acosh(N) where N≥1

asin - arcus sine function working with radians

Use: asin(N) where -1≤N≤1

asinD - arcus sine function working with degrees

Use: asinD(N) where -1≤N≤1

asinh - hyperbolic arcus sine function

Use: asinh(N)

atan - arcus tangens function working with radians

Use: atan(N)

atanD - arcus tangens function working with degrees

Use: atanD(N)

atanh - hyperbolic arcur tangens function

Use: atanh(N) where -1<N<1

avg - (average,) mean value of all arguments

Use: avg(N1;N2;N3;…)

cos - cosine function working with radians

Use: cos(N)

cosD - cosine function working with degrees

Use: cosD(N)

cosh - hyperbolic cosine

Use: cosh(N)

degTorad - converts degrees to radian

Use: degTorad(N)

exp - e raised to the power of x

Use: exp(N) If you have as much a clue what this is for as I do, may I suggest the Wikipedia article on the number e?

fmod - Returns the floating-point remainder of numer/denom (rounded towards zero)

Use: fmod(N;D)

ln - logarithm to base e (2.71828…)

Use: ln(N) where N>0

log - logarithm to the base 10

Use: log(N) where N>0

log10 - logarithm to the base 10

Use: log10(N) where N>0

log2 - logarithm to the base 2

Use: log2(N) where N>0

max - max of all arguments

Use: max(N;N1;N2;…)

min - min of all arguments

Use: min(N;N1;N2;…)

radTodeg - converts radian to degrees

Use: radTodeg(N)

rint - round to nearest integer

Use: rint(N)

sign - sign function -1 if x<0; 1 if x>0

Use: sign(N)

sin - sine function working with radians

Use: sin(N)

sinD - sine function working with degrees

Use: sinD(N)

sinh - hyperbolic sine function

Use: sinh(N)

sqrt - square root of a value

Use: sqrt(N) where N≥0

sum - sum of all arguments

Use: sum(N;N1;N2;…)

tan - tangens function working with radians

Use: tan(N)

tanD - tangens function working with degrees

Use: tanD(N)

tanh - hyperbolic tangens function

Use: tanh(N)

Bibliography