next up previous contents
Next: Function: Get_Duration() Up: GRASP Routines: Waveforms from Previous: Function: testmass_chirp()   Contents

Function: calculate_testmass_phase()

0 int calculate_testmass_phase(float fo, float M, float **Phi)
This function calculates the phase $\Phi(f_0,v)$ which is needed to get the wave form.
fo: Input. The orbital frequency in Hertz at which $\Phi$ should vanish. $f_0$ is related to $v_0$ by $v_0^3 = 2 \pi G M f_0 / c^3$.
M: Input. The total mass of the system in units of the solar mass. $M$ is only used to convert the orbital frequency $f_0$ into the orbital velocity $v_0$.
Phi: Input/Output. The array *Phi will contain the calculated phase $\Phi(f_0,v)$. It will contain the same number of points as the data read in from the stored files. If **Phi==NULL, memory will be allocated.

Return value: Output. Returns $0$ if there was no error, and an error code otherwise. These codes are described in Section [*].

Author: Serge Droz, droz@physics.uoguelph.ca
Comments: You will get an error if the required data files are not read into memory. You must call this routine at least once before you can use testmass_chirp().


next up previous contents
Next: Function: Get_Duration() Up: GRASP Routines: Waveforms from Previous: Function: testmass_chirp()   Contents
Bruce Allen 2000-11-19