Programmer Guide/Command Reference/EVAL/ticks2f1: Difference between revisions
From STX Wiki
< Programmer Guide | Command Reference | EVAL
Jump to navigationJump to search
No edit summary |
No edit summary |
||
| (5 intermediate revisions by 2 users not shown) | |||
| Line 2: | Line 2: | ||
Extracts the ''rps'' (= the number of '''r'''otations '''p'''er '''s'''econd) value or track from the tick-signal <var>x</var>. | Extracts the ''rps'' (= the number of '''r'''otations '''p'''er '''s'''econd) value or track from the tick-signal <var>x</var>. | ||
---- | ---- | ||
;Usage:<code>ticks2f1(<var>x</var>, <var>sr | ;Usage 1:<code>ticks2f1(<var>x</var>, <var>sr</var>, <var>o</var>)</code> | ||
:;<var>x</var>:the tick signal vector | :;<var>x</var>:the tick signal vector | ||
:;<var>sr</var>:sampling rate of the tick signal in Hz | :;<var>sr</var>:sampling rate of the tick signal in Hz; must be >0 | ||
:;<var> | :;<var>o</var>:the order of the tick signal; must be an integer >0 | ||
;Description: The function counts the periods of the tick signal and computes the ''rps'' value according to the sampling rate ''sr'' and the order of the tick signal ''o''. The tick signal ''x'' must be a periodic signal (sine wave, triangle, rectangle, sawtooth or pulse) with | ;Description 1: The function counts the periods of the tick signal and computes the ''rps'' value according to the sampling rate ''sr'' and the order of the tick signal ''o''. The tick signal ''x'' must be a periodic signal (sine wave, triangle, rectangle, sawtooth or pulse) with ''o'' periods per rotation. | ||
::<code>''rps'' = ''sr'' / ''o'' * ''np'' / (''ilast''-''ifirst'')</code> | ::<code>''rps'' = ''sr'' / ''o'' * ''np'' / (''ilast''-''ifirst'')</code> | ||
::with: | ::with: | ||
| Line 16: | Line 16: | ||
|''ilast'' ||= || sample index of the end of the last periode | |''ilast'' ||= || sample index of the end of the last periode | ||
|} | |} | ||
;Result 1: The number of periods per second ''rps'' (scalar) | |||
---- | |||
;Usage 2:<code>ticks2f1(<var>x</var>, <var>sr</var>, <var>o</var> , <var>len</var>, <var>hop</var>)</code> | |||
:;<var>x, sr, o</var>:see '''Usage 1''' | |||
:;<var>len</var>:the frame length in samples; 2 ≤ ''len'' ≤ <code>nrow(''x'')/2</code> | |||
:;<var>hop</var>:the distance between frames in samples; 0 < ''hop'' ≤ ''len'' | |||
;Description 2: The tick signal is parted into frames with a length of ''len'' samples and a distance of ''hop'' samples. For each frame the ''rps'' value is computed as described above. | |||
;Result 2: A vector containing the ''rps'' values of the frames of the tick signal ''x''. | |||
;See also: [[../asp2osp|asp2osp]], [[../sig2osp|sig2osp]], [[../otrack1|otrack1]] | |||
[[../#Functions|<function list>]] | |||
Latest revision as of 19:05, 21 April 2011
Extracts the rps (= the number of rotations per second) value or track from the tick-signal x.
- Usage 1
ticks2f1(x, sr, o)- x
- the tick signal vector
- sr
- sampling rate of the tick signal in Hz; must be >0
- o
- the order of the tick signal; must be an integer >0
- Description 1
- The function counts the periods of the tick signal and computes the rps value according to the sampling rate sr and the order of the tick signal o. The tick signal x must be a periodic signal (sine wave, triangle, rectangle, sawtooth or pulse) with o periods per rotation.
rps = sr / o * np / (ilast-ifirst)- with:
np = number of detected periodes ifirst = sample index of the begin of the first periode ilast = sample index of the end of the last periode
- Result 1
- The number of periods per second rps (scalar)
- Usage 2
ticks2f1(x, sr, o , len, hop)- x, sr, o
- see Usage 1
- len
- the frame length in samples; 2 ≤ len ≤
nrow(x)/2 - hop
- the distance between frames in samples; 0 < hop ≤ len
