Programmer Guide/Command Reference/NUM - Revision history

Christian at 15:51, 25 April 2014

2014-04-25T15:51:27Z

← Older revision		Revision as of 17:51, 25 April 2014
Line 26:		Line 26:
	\|linear distributed pseudo random number ''r'' (0≤''r''<1)<BR>''seed'' is the start value (0≤''seed''&lt<1)		\|linear distributed pseudo random number ''r'' (0≤''r''<1)<BR>''seed'' is the start value (0≤''seed''&lt<1)
	\|-		\|-
	\|<code>sin(''x''), cos(''x''), tan(''x'')</code>		\|<code>sin(''x'')</code>, <code>cos(''x'')</code>, <code>tan(''x'')</code>
	\|sine, cosine or tangent of ''x''		\|sine, cosine or tangent of ''x''
	\|-		\|-
	\|<code>asin(''x''), acos(''x''), atan(''x'')</code>		\|<code>asin(''x'')</code>, <code>acos(''x'')</code>, <code>atan(''x'')</code>
	\|inverse sine, cosine or tangent of ''x''		\|inverse sine, cosine or tangent of ''x''
	\|-		\|-
Line 56:		Line 56:
	\|convert level to factor (<code>10<sup>''x''/20</sup></code>)		\|convert level to factor (<code>10<sup>''x''/20</sup></code>)
	\|-		\|-
	\|<code>sinc(''x''), sinx(''x'')</code>		\|<code>sinc(''x'')</code>, <code>sinx(''x'')</code>
	\|sinc function: <code>sin(''x'') / ''x''</code>		\|sinc function: <code>sin(''x'') / ''x''</code>
	\|-		\|-
Line 74:		Line 74:
	\|returns a floating-point value representing the largest integer that is less than or equal to ''x''<BR>(range of ''x'': 64bit float)		\|returns a floating-point value representing the largest integer that is less than or equal to ''x''<BR>(range of ''x'': 64bit float)
	\|-		\|-
	\|<code>iserr(''rc''), iserror(''rc'')</code>		\|<code>iserr(''rc'')</code>, <code>iserror(''rc'')</code>
	\|returns 1 if ''rc'' is a {{STX}} error code, otherwise 0<BR>this function can be used to test the completion code <code>RC</code> of a command		\|returns 1 if ''rc'' is a {{STX}} error code, otherwise 0<BR>this function can be used to test the completion code <code>RC</code> of a command
	\|-		\|-
	\|<code>iswarn(''rc''), iswarning(''rc'')</code>		\|<code>iswarn(''rc'')</code>, <code>iswarning(''rc'')</code>
	\|returns 1 if ''rc'' is a {{STX}} warning code, otherwise 0<BR>this function can be used to test the completion code <code>RC</code> of a command		\|returns 1 if ''rc'' is a {{STX}} warning code, otherwise 0<BR>this function can be used to test the completion code <code>RC</code> of a command
	\|-		\|-

Christian at 15:48, 25 April 2014

2014-04-25T15:48:45Z

← Older revision		Revision as of 17:48, 25 April 2014
Line 18:		Line 18:
	:<code>rand</code> (a linear distributed pseudo random number ''r''; -1≤''r''<1)		:<code>rand</code> (a linear distributed pseudo random number ''r''; -1≤''r''<1)
	:<code>lran</code> (a linear distributed pseudo random number ''r''; 0≤''r''<1)		:<code>lran</code> (a linear distributed pseudo random number ''r''; 0≤''r''<1)
	;numerical operators: <code>-''a''</code> (negate), <code>''a''+''b''</code> (add), <code>''a''-''b''</code> (subtract), <code>''a''*''b''</code> (multiply), <code>''a''/''b''</code> (divide), <code>''a''%''b''</code> (modulo), <code>''a''^''b'' ~~(power)~~</code>		;numerical operators: <code>-''a''</code> (negate), <code>''a''+''b''</code> (add), <code>''a''-''b''</code> (subtract), <code>''a''*''b''</code> (multiply), <code>''a''/''b''</code> (divide), <code>''a''%''b''</code> (modulo), <code>''a''^''b''</code> (power)
	;logical operators (bitwise): <code>!''a</code> (not), <code>''a''&''b''</code> (and), <code>''a''\|''b''</code> (or), <code>''a''^''b''</code> (exclusive or)		;logical operators (bitwise): <code>!''a</code> (not), <code>''a''&''b''</code> (and), <code>''a''\|''b''</code> (or), <code>''a''^''b''</code> (exclusive or)
	;brackets:<code>(''expression'')</code>		;brackets:<code>(''expression'')</code>

Christian at 15:48, 25 April 2014

2014-04-25T15:48:11Z

← Older revision		Revision as of 17:48, 25 April 2014
Line 13:		Line 13:

	The ''expression'' will be evaluated numerically, and the result (textual representation) will be returned. The ''expression'' may consist of the following parts:		The ''expression'' will be evaluated numerically, and the result (textual representation) will be returned. The ''expression'' may consist of the following parts:
	;decimal numbers: <code>123.456, 17.5e3, 100, -312.123, 1e-3</code>		;decimal numbers: <code>123.456</code>, <code>17.5e3</code>, <code>100</code>, <code>-312.123</code>, <code>1e-3</code>,…
	;hexa-decimal numbers:<code>0x1234, 0xabc, 0XabC</code>		;hexa-decimal numbers:<code>0x1234</code>, <code>0xabc</code>, <code>0XabC</code>, …
	;special constants:<code>pi</code> (=3.1415...), <code>e</code> (=2.71828...),		;special constants:<code>pi</code> (=3.1415...), <code>e</code> (=2.71828...),
	:<code>rand</code> (a linear distributed pseudo random number ''r''; -1≤''r''<1)		:<code>rand</code> (a linear distributed pseudo random number ''r''; -1≤''r''<1)
	:<code>lran</code> (a linear distributed pseudo random number ''r''; 0≤''r''<1)		:<code>lran</code> (a linear distributed pseudo random number ''r''; 0≤''r''<1)
	;numerical operators:<code>-''a''</code> (negate), <code>''a''+''b''</code> (add), <code>''a''-''b''</code> (subtract), <code>''a''*''b''</code> (multiply), <code>''a''/''b''</code> (divide), <code>''a''%''b''</code> (modulo), <code>''a''^''b'' (power)</code>		;numerical operators: <code>-''a''</code> (negate), <code>''a''+''b''</code> (add), <code>''a''-''b''</code> (subtract), <code>''a''*''b''</code> (multiply), <code>''a''/''b''</code> (divide), <code>''a''%''b''</code> (modulo), <code>''a''^''b'' (power)</code>
	;logical operators (bitwise): <code>!''a</code> (not), <code>''a''&''b''</code> (and), <code>''a''\|''b''</code> (or), <code>''a''^''b''</code> (exclusive or)		;logical operators (bitwise): <code>!''a</code> (not), <code>''a''&''b''</code> (and), <code>''a''\|''b''</code> (or), <code>''a''^''b''</code> (exclusive or)
	;brackets:<code>(''expression'')</code>		;brackets:<code>(''expression'')</code>

Christian at 15:46, 25 April 2014

2014-04-25T15:46:44Z

← Older revision		Revision as of 17:46, 25 April 2014
Line 11:		Line 11:
	\|0<BR>warning code		\|0<BR>warning code
	\|}		\|}
	~~;Description:~~ The ''expression'' will be evaluated numerically, and the result (textual representation) will be returned. The ''expression'' may consist of the following parts:
	::;decimal numbers: <code>123.456, 17.5e3, 100, -312.123, 1e-3</code>		The ''expression'' will be evaluated numerically, and the result (textual representation) will be returned. The ''expression'' may consist of the following parts:
	::;hexa-decimal numbers:<code>0x1234, 0xabc, 0XabC</code>		;decimal numbers: <code>123.456, 17.5e3, 100, -312.123, 1e-3</code>
	::;special constants:<code>pi</code> (=3.1415...), <code>e</code> (=2.71828...),		;hexa-decimal numbers:<code>0x1234, 0xabc, 0XabC</code>
	:::<code>rand</code> (a linear distributed pseudo random number ''r''; -1≤''r''<1)		;special constants:<code>pi</code> (=3.1415...), <code>e</code> (=2.71828...),
	:::<code>lran</code> (a linear distributed pseudo random number ''r''; 0≤''r''<1)		:<code>rand</code> (a linear distributed pseudo random number ''r''; -1≤''r''<1)
	::;numerical operators:<code>-''a''</code> (negate), <code>''a''+''b''</code> (add), <code>''a''-''b''</code> (subtract), <code>''a''*''b''</code> (multiply), <code>''a''/''b''</code> (divide), <code>''a''%''b''</code> (modulo), <code>''a''^''b'' (power)</code>		:<code>lran</code> (a linear distributed pseudo random number ''r''; 0≤''r''<1)
	::;logical operators (bitwise): <code>!''a</code> (not), <code>''a''&''b''</code> (and), <code>''a''\|''b''</code> (or), <code>''a''^''b''</code> (exclusive or)		;numerical operators:<code>-''a''</code> (negate), <code>''a''+''b''</code> (add), <code>''a''-''b''</code> (subtract), <code>''a''*''b''</code> (multiply), <code>''a''/''b''</code> (divide), <code>''a''%''b''</code> (modulo), <code>''a''^''b'' (power)</code>
	::;brackets:<code>(''expression'')</code>		;logical operators (bitwise): <code>!''a</code> (not), <code>''a''&''b''</code> (and), <code>''a''\|''b''</code> (or), <code>''a''^''b''</code> (exclusive or)
	::;functions:		;brackets:<code>(''expression'')</code>
	::{\|class="einrahmen"		;functions:
			:{\|class="einrahmen"
	\|<code>setlran(''seed'')</code>		\|<code>setlran(''seed'')</code>
	\|linear distributed pseudo random number ''r'' (0≤''r''<1)<BR>''seed'' is the start value (0≤''seed''&lt<1)		\|linear distributed pseudo random number ''r'' (0≤''r''<1)<BR>''seed'' is the start value (0≤''seed''&lt<1)
Line 83:		Line 84:
	\|}		\|}
	;Notes:		;Notes:
	:*In case of the expression being syntactically ill-formed, an error (<code>NUM</code>) or warning (<code>NUMCHECK</code>) is reported.		*In case of the expression being syntactically ill-formed, an error (<code>NUM</code>) or warning (<code>NUMCHECK</code>) is reported.
	:*The special numerical objects (vectors, matrices) available in [[../EVAL\|EVAL]]-expressions, can not be used in the <code>NUM</code> expressions. Only the use of numerical constants and variables is possible.		*The special numerical objects (vectors, matrices) available in [[../EVAL\|EVAL]]-expressions, can not be used in the <code>NUM</code> expressions. Only the use of numerical constants and variables is possible.
	:*The same expression syntax is used for the [[../INT\|INT and INTCHECK]], for the numerical expressions in [[Programmer_Guide/Introduction#Conditional_Expressions\|conditions]] (e.g. [[../IF\|IF]] or [[../WHILE\|WHILE]]) and for the evaluation of numerical arguments of commands.		*The same expression syntax is used for the [[../INT\|INT and INTCHECK]], for the numerical expressions in [[Programmer_Guide/Introduction#Conditional_Expressions\|conditions]] (e.g. [[../IF\|IF]] or [[../WHILE\|WHILE]]) and for the evaluation of numerical arguments of commands.
	:*Numerical expressions are evaluated in 64bit floating point precission.		*Numerical expressions are evaluated in 64bit floating point precission.
	:*For logical (operators <code>!, &, \|, ^</code>) and integer expressions (functions <code>round, int, bit</code>) 32bit signed integers are used.		*For logical (operators <code>!, &, \|, ^</code>) and integer expressions (functions <code>round, int, bit</code>) 32bit signed integers are used.

	;See also: [[../INT\|INT, INTCHECK]], [[../EVAL\|EVAL, EVALCHECK]], [[../SEGMENT\|SEGMENT]]		;See also: [[../INT\|INT, INTCHECK]], [[../EVAL\|EVAL, EVALCHECK]], [[../SEGMENT\|SEGMENT]]

	;Examples:		;Examples:
	// #wave = wave item		// #wave = wave item

Toni at 11:36, 26 April 2011

2011-04-26T11:36:37Z

← Older revision		Revision as of 13:36, 26 April 2011
Line 83:		Line 83:
	\|}		\|}
	;Notes:		;Notes:
	:*In case of the expression being syntactically ill-formed, an error (<code>~~INT~~</code>) or warning (<code>~~INTCHECK~~</code>) is reported.		:*In case of the expression being syntactically ill-formed, an error (<code>NUM</code>) or warning (<code>NUMCHECK</code>) is reported.
	:*The special numerical objects (vectors, matrices) available in [[../EVAL\|EVAL]]-expressions, can not be used in the <code>NUM</code> expressions. Only the use of numerical constants and variables is possible.		:*The special numerical objects (vectors, matrices) available in [[../EVAL\|EVAL]]-expressions, can not be used in the <code>NUM</code> expressions. Only the use of numerical constants and variables is possible.
	:*The same expression syntax is used for the [[../INT\|INT and INTCHECK]], for the numerical expressions in [[Programmer_Guide/Introduction#Conditional_Expressions\|conditions]] (e.g. [[../IF\|IF]] or [[../WHILE\|WHILE]]) and for the evaluation of numerical arguments of commands.		:*The same expression syntax is used for the [[../INT\|INT and INTCHECK]], for the numerical expressions in [[Programmer_Guide/Introduction#Conditional_Expressions\|conditions]] (e.g. [[../IF\|IF]] or [[../WHILE\|WHILE]]) and for the evaluation of numerical arguments of commands.
Line 97:		Line 97:
	#lfft := int npow2($#lfrm) // fft length		#lfft := int npow2($#lfrm) // fft length
	#df := num $#wave[!srate] / $#lfft // frequency resolution		#df := num $#wave[!srate] / $#lfft // frequency resolution

			// using expressions in a IF statement
			if 'db($#level)' > 1 then
			conlog 'level must be lower or equal 0dB'
			#level := 0
			end

Toni at 10:49, 26 April 2011

2011-04-26T10:49:10Z

← Older revision		Revision as of 12:49, 26 April 2011
Line 84:		Line 84:
	;Notes:		;Notes:
	:*In case of the expression being syntactically ill-formed, an error (<code>INT</code>) or warning (<code>INTCHECK</code>) is reported.		:*In case of the expression being syntactically ill-formed, an error (<code>INT</code>) or warning (<code>INTCHECK</code>) is reported.
	:*The special numerical objects (vectors, matrices) available in [[../EVAL\|EVAL]-expressions, can not be used in the <code>NUM</code> expressions. Only the use of numerical constants and variables is possible.		:*The special numerical objects (vectors, matrices) available in [[../EVAL\|EVAL]]-expressions, can not be used in the <code>NUM</code> expressions. Only the use of numerical constants and variables is possible.
	:*The same expression syntax is used for the [[../INT\|INT and INTCHECK]] ~~command and~~ for the numerical expressions in [[Programmer_Guide/Introduction#Conditional_Expressions\|conditions]] (e.g. [[../IF\|IF]] or [[../WHILE\|WHILE]]).		:*The same expression syntax is used for the [[../INT\|INT and INTCHECK]], for the numerical expressions in [[Programmer_Guide/Introduction#Conditional_Expressions\|conditions]] (e.g. [[../IF\|IF]] or [[../WHILE\|WHILE]]) and for the evaluation of numerical arguments of commands.
	:*Numerical expressions are evaluated in 64bit floating point precission.		:*Numerical expressions are evaluated in 64bit floating point precission.
	:*For logical (operators <code>!, &, \|, ^</code>) and integer expressions (functions <code>round, int, bit</code>) 32bit signed integers are used.		:*For logical (operators <code>!, &, \|, ^</code>) and integer expressions (functions <code>round, int, bit</code>) 32bit signed integers are used.
	;See also: [[../INT\|INT, INTCHECK]], [[../EVAL\|EVAL, EVALCHECK]], [[../SEGMENT\|SEGMENT]]		;See also: [[../INT\|INT, INTCHECK]], [[../EVAL\|EVAL, EVALCHECK]], [[../SEGMENT\|SEGMENT]]
	;Examples:		;Examples:
	~~#x := int 3.1~~ // #~~result is set to 3~~		// #wave = wave item
	#~~result~~ := ~~int 3.9~~ // #~~result is set to 3~~, ~~too~~		#t := num $#wave[!length] / $#wave[!srate] // duration in seconds
	#~~result~~ := int ~~3.9~~ * ~~3.9 //~~ #~~result is set to 15 (note that calculation~~		// #t = frame length in seconds, #o = overlap in percent
	// ~~is done in floating point, resulting~~ in ~~15.21,~~		#lfrm := int $#t * $#wave[!srate] // frame length in samples
	/~~/ and truncation occurs only on assigning~~		#lhop := int $#t * (1 - $#o / 100) * $#wave[!srate] // hopsize in samples
	// ~~compare the preceding example with the following one:~~		#lfft := int npow2($#lfrm) // fft length
	#~~result~~ := int ~~3 * int~~(~~3.9~~) // ~~here, #result will be assigned 9 - cool, isn't it?~~		#df := num $#wave[!srate] / $#lfft // frequency resolution

Toni at 10:16, 26 April 2011

2011-04-26T10:16:18Z

← Older revision		Revision as of 12:16, 26 April 2011
Line 84:		Line 84:
	;Notes:		;Notes:
	:*In case of the expression being syntactically ill-formed, an error (<code>INT</code>) or warning (<code>INTCHECK</code>) is reported.		:*In case of the expression being syntactically ill-formed, an error (<code>INT</code>) or warning (<code>INTCHECK</code>) is reported.
			:*The special numerical objects (vectors, matrices) available in [[../EVAL\|EVAL]-expressions, can not be used in the <code>NUM</code> expressions. Only the use of numerical constants and variables is possible.
	:*The same expression syntax is used for the [[../INT\|INT and INTCHECK]] command and for the numerical expressions in [[Programmer_Guide/Introduction#Conditional_Expressions\|conditions]] (e.g. [[../IF\|IF]] or [[../WHILE\|WHILE]]).		:*The same expression syntax is used for the [[../INT\|INT and INTCHECK]] command and for the numerical expressions in [[Programmer_Guide/Introduction#Conditional_Expressions\|conditions]] (e.g. [[../IF\|IF]] or [[../WHILE\|WHILE]]).
	:*Numerical expressions are evaluated in 64bit floating point precission.		:*Numerical expressions are evaluated in 64bit floating point precission.
Line 89:		Line 90:
	;See also: [[../INT\|INT, INTCHECK]], [[../EVAL\|EVAL, EVALCHECK]], [[../SEGMENT\|SEGMENT]]		;See also: [[../INT\|INT, INTCHECK]], [[../EVAL\|EVAL, EVALCHECK]], [[../SEGMENT\|SEGMENT]]
	;Examples:		;Examples:
	#~~result~~ := int 3.1 // #result is set to 3		#x := int 3.1 // #result is set to 3
	#result := int 3.9 // #result is set to 3, too		#result := int 3.9 // #result is set to 3, too
	#result := int 3.9 * 3.9 // #result is set to 15 (note that calculation		#result := int 3.9 * 3.9 // #result is set to 15 (note that calculation

Toni at 09:50, 26 April 2011

2011-04-26T09:50:22Z

← Older revision		Revision as of 11:50, 26 April 2011
Line 87:		Line 87:
	:*Numerical expressions are evaluated in 64bit floating point precission.		:*Numerical expressions are evaluated in 64bit floating point precission.
	:*For logical (operators <code>!, &, \|, ^</code>) and integer expressions (functions <code>round, int, bit</code>) 32bit signed integers are used.		:*For logical (operators <code>!, &, \|, ^</code>) and integer expressions (functions <code>round, int, bit</code>) 32bit signed integers are used.
			;See also: [[../INT\|INT, INTCHECK]], [[../EVAL\|EVAL, EVALCHECK]], [[../SEGMENT\|SEGMENT]]
	;Examples:		;Examples:
	#result := int 3.1 // #result is set to 3		#result := int 3.1 // #result is set to 3

Toni at 09:49, 26 April 2011

2011-04-26T09:49:08Z

← Older revision		Revision as of 11:49, 26 April 2011
Line 85:		Line 85:
	:*In case of the expression being syntactically ill-formed, an error (<code>INT</code>) or warning (<code>INTCHECK</code>) is reported.		:*In case of the expression being syntactically ill-formed, an error (<code>INT</code>) or warning (<code>INTCHECK</code>) is reported.
	:*The same expression syntax is used for the [[../INT\|INT and INTCHECK]] command and for the numerical expressions in [[Programmer_Guide/Introduction#Conditional_Expressions\|conditions]] (e.g. [[../IF\|IF]] or [[../WHILE\|WHILE]]).		:*The same expression syntax is used for the [[../INT\|INT and INTCHECK]] command and for the numerical expressions in [[Programmer_Guide/Introduction#Conditional_Expressions\|conditions]] (e.g. [[../IF\|IF]] or [[../WHILE\|WHILE]]).
			:*Numerical expressions are evaluated in 64bit floating point precission.
			:*For logical (operators <code>!, &, \|, ^</code>) and integer expressions (functions <code>round, int, bit</code>) 32bit signed integers are used.


	~~;Notes~~:
	:* ~~The~~ <code>~~INT~~</code> ~~command converts the result to an~~ integer ~~by ''truncating'' it. There is no rounding involved~~, ~~no rounding at all.~~
	~~;See also: [[..~~/~~NUM\|NUM, NUMCHECK]], [[.~~.~~/EVAL\|EVAL, EVALCHECK]]~~


	;Examples:		;Examples:
	#result := int 3.1 // #result is set to 3		#result := int 3.1 // #result is set to 3

Toni at 09:46, 26 April 2011

2011-04-26T09:46:16Z

← Older revision		Revision as of 11:46, 26 April 2011
Line 82:		Line 82:
	\|next power of 2; returns the smallest possible value <code>2<sup>m</sup> ≥ ''n''</code>		\|next power of 2; returns the smallest possible value <code>2<sup>m</sup> ≥ ''n''</code>
	\|}		\|}
			;Notes:
			:*In case of the expression being syntactically ill-formed, an error (<code>INT</code>) or warning (<code>INTCHECK</code>) is reported.
			:*The same expression syntax is used for the [[../INT\|INT and INTCHECK]] command and for the numerical expressions in [[Programmer_Guide/Introduction#Conditional_Expressions\|conditions]] (e.g. [[../IF\|IF]] or [[../WHILE\|WHILE]]).


Line 90:		Line 91:
	;Notes:		;Notes:
	:* The <code>INT</code> command converts the result to an integer by ''truncating'' it. There is no rounding involved, no rounding at all.		:* The <code>INT</code> command converts the result to an integer by ''truncating'' it. There is no rounding involved, no rounding at all.
	~~:* In case of the expression being syntactically ill-formed, an error (<code>INT</code>) or warning (<code>INTCHECK</code>) is reported.~~
	;See also: [[../NUM\|NUM, NUMCHECK]], [[../EVAL\|EVAL, EVALCHECK]]		;See also: [[../NUM\|NUM, NUMCHECK]], [[../EVAL\|EVAL, EVALCHECK]]