関数operate_single_pole2 マニュアル

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


◆機能・用途(Purpose)

フーリエスペクトルに1つのpoleのみを持つ伝達関数を掛ける。
Multiply a transfer function that has a single pole 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_0=0\), \(N_p=1\)とした伝達関数 \[\begin{equation} T(s)=\frac{1}{s-s_1^{(p)}} \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_0=0\), and \(N_p=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_pole2
(struct imsequence2 spectrum,const double complex pole)


◆引数(Arguments)

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


◆動作(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 imsequence2 spectrum;
operate_single_pole2(spectrum,1.2+3.45∗I);