Programmer Guide/Command Reference/EVAL/asp2osp: Difference between revisions

From STX Wiki
Jump to navigationJump to search
m (1 revision: Initial import)
No edit summary
Line 1: Line 1:
{{DISPLAYTITLE:{{SUBPAGENAME}}}}
{{DISPLAYTITLE:{{SUBPAGENAME}}}}
=====asp2osp=====
Convert an amplitude spectrum to an order spectrum.
;Usage:
:<code>asp2osp(<var>a</var>, <var>df</var>, <var>f1</var>, <var>do</var>, <var>no</var>, <var>amin</var>)</code>
:;<var>a</var>:amplitude or power spectrum (vector)
:;<var>df</var>:frequency resolution of the spectrum in Hz (scalar); 0 < ''df'', ''f''[i]=i*df)
:;<var>f</var>:frequency scale of the spectrum in Hz (vector)
:;<var>f1</var>:frequency of the 1st order in Hz
:;<var>do</var>:resolution of the order spectrum; 0 < ''do'' (default=0.1)
:;<var>no</var>:length of the order spectrum; 2 < ''no'' (default=500)
:;<var>oini</var>:amplitude value for order spectrum initialization (default=0)
;Description 1: The function implements a fast algorithm to convert a frequency spectrum ''a''=f(''f'') into an order spectrum ao=f(''f1'',''do''). The algorithm uses interpolation (if ''a'' must be expanded) and maximum detection (if ''a'' must be compressed) to approximate the values of the order spectrum. The frequency range of the order spectrum is limited to 0 to <code>''f1''*''do''*''no''</code>. All bins of ''o'' outside the frequency range of ''a'' (<code>0..df*nrow(''a'')-1</code> or <code>''f''[0]..''f''[nrow(''a'')-1]</code> are set the value ''oini''.
;Result: The order spectrum ''o'' (vector with ''no'' elements).


=====Usage:=====
;See also: [[Programmer_Guide/Command_Reference/EVAL/ticks2f1|ticks2f1]], [[Programmer_Guide/Command_Reference/EVAL/sig2osp|sig2osp]], [[Programmer_Guide/Command_Reference/EVAL/otrack1|otrack1]]


<code>asp2osp(<var>a</var>, <var>df</var>, <var>f1</var>, <var>do</var>, <var>n</var>, <var>amin</var>)</code>
[[Programmer_Guide/Command_Reference/EVAL#Functions|<function list>]]
 
=====Function:=====
 
Converts an amplitude spectrum to an order spectrum.
 
=====Parameters:=====
 
;<var>a</var>
 
:An amplitude spectrum.
 
;<var>df</var>
 
:The frequency resolution of <var>a</var>.
 
;<var>f1</var>
 
:The first order frequency.
 
;<var>do</var>
 
:The order resolution of the result (<code>frequency resolution =</code> <var>do</var><code>*</code><var>f1</var>).
 
;<var>n</var>
 
:The number of order lines.
 
;<var>amin</var>
 
:The default amplitude for unassigned order lines.
 
=====Result:=====
 
An order spectrum with <var>n</var> elements.

Revision as of 14:25, 13 April 2011

Convert an amplitude spectrum to an order spectrum.

Usage
asp2osp(a, df, f1, do, no, amin)
a
amplitude or power spectrum (vector)
df
frequency resolution of the spectrum in Hz (scalar); 0 < df, f[i]=i*df)
f
frequency scale of the spectrum in Hz (vector)
f1
frequency of the 1st order in Hz
do
resolution of the order spectrum; 0 < do (default=0.1)
no
length of the order spectrum; 2 < no (default=500)
oini
amplitude value for order spectrum initialization (default=0)
Description 1
The function implements a fast algorithm to convert a frequency spectrum a=f(f) into an order spectrum ao=f(f1,do). The algorithm uses interpolation (if a must be expanded) and maximum detection (if a must be compressed) to approximate the values of the order spectrum. The frequency range of the order spectrum is limited to 0 to f1*do*no. All bins of o outside the frequency range of a (0..df*nrow(a)-1 or f[0]..f[nrow(a)-1] are set the value oini.
Result
The order spectrum o (vector with no elements).
See also
ticks2f1, sig2osp, otrack1

<function list>

Retrieved from "https://mediawiki.kfs.oeaw.ac.at/stx/docs/wiki/index.php?title=Programmer_Guide/Command_Reference/EVAL/asp2osp&oldid=3551"

Navigation menu

Personal tools