Input information for Phase_Doctor is
Phase_Doctor is for
Format of a definitions file:
Phase_Doctor parses definitions file, then reads both databases, then
read and parses all log-files. The program writes down an intermediary file in
the directory with names specified in the variable PHD_DIR defined in the
../src/solve/gsfcb.i file. The name of the intermediary file has the same main
part as the definitions file but extension phd. Then Phase_Doctor displays the
first user menu.
The next call of Phase_Doctor for this experiment may be done either by
specifying a definitions file or by specifying an experiment identifier, f.e.
A yellow-brown command box contains a brown letter code in the right upper
corner of the box and the text of the command. A user can execute a command
either by hitting a key with the letter code using keyboard or by positioning
the cursor to the command box and hitting either the left or the middle mouse
button. All DiaGI commands can be applied to the expanded graphic box,
f.e. changing boundary box, printing and etc.
A grey graphic box can be expanded to the entire screen if user position
the cursor on the box and hit either the left or the middle mouse button.
Right/mouse and a keyboard key X always means exit the current menu level
and return to the previous level of menu.
Many plots have argument Time in hours. Time tag 0 corresponds to the nominal
start of the session (first value of lcode INTERVAL recorded in the database).
Many plots admits to have two types of bounding boxes for plots: global
and local. Global bounding box is a bounding box between minimal and maximal
values of parameters and arguments among all displayed plots. Local bounding
box is a bounding box between minimal and maximal values of parameters and
arguments for each plot individually.
A hard copy of graphic boxes can be obtained. Refer to the
Multi_DiaGI manual.
Option (T) Plots of system temperatures is invoked from the main
Phase_Doctor menu: the menu which has a title Phase_Doctor, its version and
the identifier of the database. No plots will be shown if the station didn't
record system temperature in log-file or some channels were dropped in fringing.
Plots of system temperature menu allows to build plots of
Plots of dependence of zenith system temperature on time are shown
for the elevation when system temperature is minimal. The blue
points are Tsys/( To * B(e) ) and the
red line is a model: = To * A(t)
Simultaneously the table of statistics of system temperature of
this station for each channel is generated. It is written in
the current Web_dir under name
sts_<station_name>.txt .
Plots of dependence of zenith system temperature on elevation
angle are shown for the moment of time when system temperature is
minimal. The blue points are
Tsys/( To * A(t) ) and the
red line is a model: = To * B(e)
Simultaneously the table of statistics of system temperature of
this station for each channel is generated. It is written in
the current Web_dir under name
sts_<station_name>.txt .
Option (P) Plots of phase cal is invoked from the main
Phase_Doctor menu (the menu which has a title Phase_Doctor, its version and
the identifier of the database).
Plots of phase calmenu allows to build plots of
Listing of the solutions is written in the current Web_dir
under name sts_<station_name>.txt .
The main Phase clinic menu supports commands:
You can edit existing procedure file by calling an editor outside
Phase_Doctor, moreover, it is more convenient. However, it is
recommended to use a command "Edit procedure file" when
the experiment is analyzed the first time in order to create
a correct template file. See below
a description of syntax of the procedure file.
NB: Channels without system temperature are ignored and
and empty grey boxes will be shown in plots. If station didn't
record system temperature at all then the command evaluation of
spurious signals in phase-cal will do nothing.
Points of measured phase-cal amplitude are shown by green color.
A red line represents modeled phase-cal amplitudes.
This menus supports the following commands:
Example of a definitions file:
Graphic interface
Phase_Doctor uses graphic Multi_DiaGI
interface. Two kind of menus appear at the screen: purely command menus
and command-graphic menus. The menus of the first sort contain a set of
command yellow-brown boxes. The menu of the second type contains both a set
of command yellow-brown boxes in the right part of the screen and a set of
grey boxes with plots in the left part of the screen.
Analysis of system temperature
Normally each station measures system temperature before each scan and
records it in log-file. Phase_doctor parses log files: find a correspondence
between the index of the tsys arrays and a channels sequence, put the system
temperature to the correct slot and filters out false readings: it discards
system temperature values below 10K and higher than 900K as well as "values"
of system temperature $$$$$$$.
Analysis of phase-cal
Normally each station has a phase calibrating system. Phase-cal phases
and amplitudes for each channel for each scan are computed by a correlator and
are written into the database. However, if manual phase calibration was applied
during fringing then no information about measured phase-cal phase and phase-cal
amplitudes remains in the database for this station. If some channel(s) was
dropped during the final fringing then no information about phase-cal at that
channel at that station remains in the database. Boxes for phase-cal plots
for these channels will be empty.
Parameters of the model are obtained by LSQ fitting for each
channel independently and residual phases are obtained.
Then the amplitudes and phases of spurious signals are
computed by another LSQ fitting using residual phases.
The model of spurious signals is specified in the procedure
file. Contributions of spurious signals are subtracted from
the residual phases. Residual phases after applying this
model are presented at this kind of plots.
Phase clinic
Option (C) Phase clinic is invoked from the main
Phase_Doctor menu. It allows to run some procedures for evaluation of
phase and amplitude of spurious signals. Routines of computation of amplitudes
and phases of spurious signals at the specific station run under the control
of a so-called procedure file. Phase_doctor expects to find the procedure file
in the $PHD_DIR directory. The name of the procedure file is
<experiment_name>.prc , f.e. 00JAN10XH.prc .
Syntax of procedure file is described below.
Procedure file consists of records of variable length. Each record consist of
one or more words separated by one or more blanks. The first word is considered
as a keyword, other words are considered as values of the that keyword.
The order of records is fixed and cannot be changed. Empty lines and lines
which start from symbols * are considered as comments and ignored.
Procedure file consist of a preamble, a session section and station sections.
Each station section consists of channel subsections.
Preamble is the first line of the file, and it indicates that this file is
a valid Phase_Doctor procedure file. The first symbols of the preamble should
be a string "Phase_Doctor proc file".
Session section should precede any station sections.
Supported keywords of the session section:
Example: 1) station: CRIMEA
A station name keyword should be the first keyword of the station
section.
Spurs_code is an identifier of the type of spurious signal and is
one of
An action_code consist of 0, 1 or 2 letters: e,a. Action_code
is attached to the spur_code without delimiters. If the action code
is empty then amplitude and phase of spurious signal will not be
computed and only the averaged amplitude will be calculated.
If the action code contains a letter e then the amplitude and
phase of spurious signal is computed. If the action code contains
a letter a then the amplitude and phase of spurious
signal is computed and applied if the contribution of
spurious signals of phase-cal in group and phase delay is computed.
Format of a procedure file.
Procedure file describes operations to be performed under phases and
amplitudes at the channels at all stations.
A station section defines modes of treatment of each station participated in the
experiment. Phase_Doctor expects to find the station section for each station.
Supported keywords of the station section:
A channel subsection should follow a station name keyword. It defines actions
appropriate for the specific channel at this station. Phase_Doctor expects
to find the channel subsection for each station section for each channel.
Supported keywords of the channel subsection:
Example
of the valid procedure file.
The main Phase clinic menu supports commands:
This menus supports the following commands:
It recognizes the following commands:
Then you have to activate the settings defined in ~/.Xdefaults by the command
1260x800+0+90 means that the window will have 1260 pixels width, 800 in height, 0 -- shift to the right respectively to the left edge of the screen, 90 pixels shift down respectively to the top edge of the screen. Parameters window width and window heights are ignored. Line "pgxwin.Win.iconize: True" means that PGPLOT window will be iconize and go out from the screen after termination of DiaGI. This resource is MANDATORY, otherwise DiaGI will require confirmation from the text screen when it terminates.
The following command should be run before the first call of pgxwin_server:
Names of input and output files.
Notation:
Input files
Input files are listed here. Some files may not be used. Some files are
can be used as output files also.
Output files
Output files are listed here. Files with extension .gif are binary files
in GIF format, files with extension .ps are ASCII files in Postscript format,
files with extension .txt are text ASCII files.
References
Dialogue Graphic Interface. DiaGI.
Phase_Doctor was developed by Leonid Petrov.
This document was prepared by
Leonid Petrov
Last update: 24-MAR-2000 17:01:25