関数operate_single_zero マニュアル

(The documentation of function operate_single_zero)
Last Update: 2024/3/19


◆機能・用途(Purpose)

フーリエスペクトルに1つのzeroのみを持つ伝達関数を掛ける。
Multiply a transfer function that has a single zero to a Fourier spectrum.
一般に伝達関数は \[\begin{equation} T(s)=C \frac{\prod_{n=1}^{N_0}(s-s_n^{(0)})} {\prod_{n=1}^{N_p}(s-s_n^{(p)})} \label{eq.transfer.general} \end{equation}\] と表される(polezero.hのマニュアル参照)。 この関数で用いるのは(\ref{eq.transfer.general})式で \(C=1\), \(N_p=0\), \(N_0=1\)とした伝達関数 \[\begin{equation} T(s)=s-s_1^{(0)} \label{eq.transfer.use} \end{equation}\] である。 複素数\(s\)は角周波数\(\omega\)と\(s=i\omega\)により関係づけられるものとする。
A transfer function is, in general, expressed as Eq. (\ref{eq.transfer.general}); see the documentation of polezero.h. This function uses \(C=1\), \(N_p=0\), and \(N_0=1\) in Eq. (\ref{eq.transfer.general}); the result is explicitly written as (\ref{eq.transfer.use}). A complex number \(s\) is related to an angular frequency \(\omega\) through a relation \(s=i\omega\).

◆形式(Format)

#include <sequence/polezero.h>
inline void operate_single_zero(struct imsequence spectrum,struct im zero)


◆引数(Arguments)

spectrum 伝達関数を掛ける前のフーリエスペクトルを関数に渡す。 関数内で伝達関数を掛ける処理が行われ、その結果で上書きされる。
Give a Fourier spectrum before multiplying a transfer function. The function overwrites it with a Fourier spectrum multiplied by the transfer function.
zero 掛ける伝達関数のゼロ点\(s_1^{(0)}\)。
The zero of the transfer function to be multiplied (\(s_1^{(0)}\)).


◆動作(Behaviour)

引数spectrumで与えたフーリエスペクトルに (\ref{eq.transfer.use})式の伝達関数を掛け、 結果を引数spectrumに上書き代入する。
Multiply a transfer function of Eq. (\ref{eq.transfer.use}) to the Fourier spectrum given by argument spectrum, and overwrite this argument by the result.

◆使用例(Example)

struct imsequence spectrum;
struct im zero={1.2,3.45};
operate_single_zero(spectrum,zero);