MDLPL_PLUS 같같같같같 1. Overview MDLPL_PLUS is a utility which provides a graphic interface and displays plots of a) station dependent clock function modeled by linear spline; b) adjustments to atmosphere path delay; c) plot of high-frequency variations of the EOP; d) plot of postfit residuals for each baseline; e) plot of a sum of clock function and postfit residuals for each baseline. MDLPL_PLUS is integrated in SOLVE and is called from the main OPTIN menu by hitting / (slash). It is assumed that a SOLVE solution has been computed and ADJST created output files with adjustments of clock functions, atmosphere path delays, segmented EOP; CRES created residual file. MDLPL_PLUS uses graphic interface Multi_DiaGI which in turn is extension of DiaGI. MDLPL_PLUS displays from 0 to 25 plot boxes at the left part of a graphic window and displays from 3 to 8 command buttons at the right part of the window. A command can be executed either by positioning the cursor on a command button and then hitting or by hitting a letter code on the keyboard. Hitting or X on the keyboard always returns user the previous menu level or quit MDLPL being used at the root level. Hitting ? provides on-line help for the Multi_DiaGI interface. Positioning the cursor on a small plot box and consecutively hitting causes expansion of the small plot to the entire graphic window and the control is passed to the DiaGI interface. Control is passed back to the Multi_DiaGI after leaving the DiaGI by hitting or X twice. Hard-copy of the current window or a set of hardcopies of all plots may be produced by hitting or , respectively. The main menu of MDLPL_PLUS has the following command buttons: 2.1. T -- Plot of atmosphere path delay. Plots of evolution of atmosphere path delay for all stations are displayed. Argument is time in hours elapsed from the first observation of the session. Values are in picoseconds. Error bars are shown by a colored area. Plots of path delay for deselected stations are not shown but the station names are displayed on the screen and the place where the plots should appear is empty. Frames of plots may be set up as "global" -- with the same values of miminal and maximal arguments and values for all stations or as "local" -- with minimal and maximal arguments and values set up for each station individually. Commands available: a) -- it the cursor is positioned at the small plot box then the plot is magnified to occupy entire window. Control is passed to the DiaGI. To leave the DiaGI mode hit twice or X. Any changes made in DiaGI mode are saved while MDLPL is running. b) C -- Change directory for Web plots. Hardcopies are written in the some destination directory. The name of this directory is reset when the database or superfile is read to the scratch area in according with system default whcih can be override by specifing an envirnoment variable WEB_DIR. The current value can be changed. Eventual file name for hardcopy is a concatenation of the current value of Web destination directory and a suffix assigned by MDLPL_PLUS. NB: Web destination directory is not merely a directory name but it is rather a prefix which is prepended before the name. If user desires to specify Web the destination directory as a directory name then trailing / must be put. Value of the Web destination directory is saved until a new database or superfile is loaded. c) -- Make a hardcopy of the screen. MDLPL_PLUS asks user to select the format and then creates a file with hardcopy. Hardcopy doesn't contain right part of the window with command buttons. Filename is formed as WEB_DIR + "atm_all" + extension (".gif" or ".ps"). Examples: WEB_DIR = "/tmp/kk_" ==> /tmp/kk_atm_all.gif WEB_DIR = "/data2/plot" ==> /data2/plotatm_all.gif WEB_DIR = "/data2/plots/" ==> /data2/plots/atm_all.gif NB: Postscripts plots can be printed right after theirs creation if environment variable DIAGI_PRICOM specifies a UNIX command used for printing PostScript files. d) -- Make a set of hardcopies of the screen and of all individual plots. Hardcopy of the entire window is made exactly as if using command. Hardcopies of individual plots are made in DiaGI format. The filename of the individual plot is formed as Web_destination_directory + "station_name" + "_atm" + extension (".gif" or ".ps"). Station name is transformed in letters of lower case letters. If the station name contains blanks inside, blanks are replaced with underscores, while trailing blanks are truncated. Examples for NRAO85 3, MEDICINA, NOTO WEB_DIR = "/tmp/kk_" ==> /tmp/kk_nrao85_3_atm.gif WEB_DIR = "/data2/plot" ==> /data2/plotmedicina_atm.ps WEB_DIR = "/data2/plots/" ==> /data2/plots/noto_atm.gif All file names with hardcopies are printed in text screen. e) L -- set up local frame. f) G -- set up global frame. g) H -- get on-line help. h) X or -- leave "Plot of atmosphere path delay" menu level. 2.2. C -- Plot of clock function. Plots of evolution of clock function for all stations are displayed. Only a component of clock function modeled by linear spline is shown. Contribution to clock function due to clock breaks and second order global polynomial are not shown. Argument is time in hours elapsed from the first observation of the session. Values are in picoseconds. Error bars are shown by a colored area. Plots of clock function for deselected stations are not shown but the station names are displayed and the place for plots is reserved. Clock function for clock reference station(s) is shown as constant with zero value. Frames of plots may be set up as "global" -- with the same values of miminal and maximal arguments and values for all stations or as "local" -- with minimal and maximal arguments and values set up for each station individually. Commands available: a) Cursor positioned at the small plot box and -- the plot is magnified to occupy entire window. Control is passed to DiaGI. To leave DiaGI mode hit twice or X. Any changes made in DiaGI mode are saved while MDLPL is running. b) C -- Change directory for Web plots. Hardcopies are written in the directory kept in the variable WEB_DIR. The value of WEB_DIR is reset when the database or superfile is read to the scratch area. This value can be changed. Eventual file name for hardcopy is a concatenation of WEB_DIR plus a suffix assigned by MDLPL_PLUS. NB: WEB_DIR is not merely a directory name but it is rather a prefix which is prepended before the name. If user specifies WEB_DIR as a directory name then trailing / must be put. Value of WEB_DIR is saved until a new database or superfile is loaded. c) -- Make a hardcopy of the screen. MDLPL_PLUS asks user to select the format and then creates a file with hardcopy. Hardcopy doesn't contain right part of the window with command buttons. Filename is formed as WEB_DIR + "clo_all" + extension (".gif" or ".ps"). Examples: WEB_DIR = "/tmp/kk_" ==> /tmp/kk_clo_all.gif WEB_DIR = "/data2/plot" ==> /data2/plotclo_all.gif WEB_DIR = "/data2/plots/" ==> /data2/plots/clo_all.gif NB: Postscripts plots can be printed right after theirs creation if environment variable DIAGI_PRICOM specifies a UNIX command used for printing PostScript files. d) -- Make a set of hardcopies of the screen and of all individual plots. Hardcopy of the entire window is made exactly as if using command. Hardcopies of individual plots are made in DiaGI format. The filename of the individual plot is formed as Web_destination_directory + "station_name" + "_clo" + extension (".gif" or ".ps"). Station name is transformed in letters of lower case letters. If the station name contains blanks inside, blanks are replaced with underscores, while trailing blanks are truncated. Examples for NRAO85 3, MEDICINA, NOTO WEB_DIR = "/tmp/kk_" ==> /tmp/kk_nrao85_3_clo.gif WEB_DIR = "/data2/plot" ==> /data2/plotmedicina_clo.ps WEB_DIR = "/data2/plots/" ==> /data2/plots/noto_clo.gif All file names with hardcopies are printed in text screen. e) L -- set up local frame. f) G -- set up global frame. g) H -- get on-line help. h) X or -- leave "Plot of clock function" menu level. 2.3. E -- Plot of segmented EOP. Plots of evolution of X pole coordinates, Y pole coordinates and UT1 modeled by linear spline are displayed. Argument is time in hours elapsed from the first observation of the session. Values are in microarcseconds for pole coordinates and in microseconds of time for UT1. Error bar is shown by a colored area. Lines with high frequency EOP variations models used as a priori and as a comparison model may be shown unless this feature is switched off. Black line represents a high frequency model used for comparison, blue line represents a high frequency model used as a priori. A constant shift is added to both models in order to make a difference between modeled value and adjustments for the first time epoch zero. Commands available: a) Cursor positioned at the small plot box and -- the plot is magnified to occupy entire window. Control is passed to DiaGI. To leave DiaGI mode hit twice or X. Any changes made in DiaGI mode are saved while MDLPL is running. b) C -- Change directory for Web plots. Hardcopies are written in the directory kept in the variable WEB_DIR. The value of WEB_DIR is reset when the database or superfile is read to the scratch area. This value can be changed. Eventual file name for hardcopy is a concatenation of WEB_DIR plus a suffix assigned by MDLPL_PLUS. NB: WEB_DIR is not merely a directory name but it is rather a prefix which is prepended before the name. If user specifies WEB_DIR as a directory name then trailing / must be put. Value of WEB_DIR is saved until a new database or superfile is loaded. c) -- Make a hardcopy of the screen. MDLPL_PLUS asks user to select the format and then creates a file with hardcopy. Hardcopy doesn't contain right part of the window with command buttons. Filename is formed as WEB_DIR + "eop_all" + extension (".gif" or ".ps"). Examples: WEB_DIR = "/tmp/kk_" ==> /tmp/kk_eop_all.gif WEB_DIR = "/data2/plot" ==> /data2/ploteop_all.gif WEB_DIR = "/data2/plots/" ==> /data2/plots/eop_all.gif NB: Postscripts plots can be printed right after theirs creation if environment variable DIAGI_PRICOM specifies a UNIX command used for printing PostScript files. d) -- Make a set of hardcopies of the screen and of all individual plots. Hardcopy of the entire window is made exactly as if using command. Hardcopies of individual plots are made in DiaGI format. The filename of the individual plot is formed as Web_destination_directory + "station_name" + "parameter_name" + extension (".gif" or ".ps"). Parameter name is one of "xpl", "ypl", "ut1" WEB_DIR = "/data2/plots/" ==> /data2/plots/eop_all.gif /data2/plots/xpl.gif /data2/plots/ypl.gif /data2/plots/ut1.gif All file names with hardcopies are printed in text screen. e) N -- Model on. Plots of high frequency EOP variations models used for a priori and for comparison will be shown. Status of the model: on or off is defined by a global variable MDLPL_FL_EOPMOD which is reset when a new database or superfile is read. Status of the model is saved after quitting MDLPL. f) F -- Model off. Plots of high frequency EOP variations models used for a priori and for comparison will not be shown. g) H -- get on-line help. h) X or -- leave "Plot of segmented EOP" menu level. 2.4. P -- Plot of postfit residuals. Plots of postfit residuals for all selected baselines are displayed. Argument is time in hours elapsed from the first observation of the session. Values are in picoseconds. Error bars represents one-sigma a priori uncertainties used for solutions (with reweighting applied). Observations which were used in solution are shown by green. Recoverable observations which were not used in the solution are shown be read. Unrecoverable observations are not shown at all. Up to 25 plots are displayed at one page. If the session has more than 25 selected baselines than the plot is displayed in several pages. The number of the current page and the total number of pages is displayed at the common title in this case. User can move through pages consecutively in forward or back direction. Commands available: a) Cursor positioned at the small plot box and -- the plot is magnified to occupy entire window. Control is passed to DiaGI. To leave DiaGI mode hit twice or X. Any changes made in DiaGI mode are saved while MDLPL is running. b) C -- Change directory for Web plots. Hardcopies are written in the directory kept in the variable WEB_DIR. The value of WEB_DIR is reset when the database or superfile is read to the scratch area. This value can be changed. Eventual file name for hardcopy is a concatenation of WEB_DIR plus a suffix assigned by MDLPL_PLUS. NB: WEB_DIR is not merely a directory name but it is rather a prefix which is prepended before the name. If user specifies WEB_DIR as a directory name then trailing / must be put. Value of WEB_DIR is saved until a new database or superfile is loaded. c) -- Make a hardcopy of the screen. MDLPL_PLUS asks user to select the format and then creates a file with hardcopy. Hardcopy doesn't contain right part of the window with command buttons. Filename is formed as WEB_DIR + "psf_all" + extension (".gif" or ".ps") where WEB_DIR is a Web destination directory. Examples: WEB_DIR = "/tmp/kk_" ==> /tmp/kk_psf_all.gif WEB_DIR = "/data2/plot" ==> /data2/plotpsf_all.gif WEB_DIR = "/data2/plots/" ==> /data2/plots/psf_all.gif NB: Postscripts plots can be printed right after theirs creation if environment variable DIAGI_PRICOM specifies a UNIX command used for printing PostScript files. d) -- Make a set of hardcopies for the screen and for all individual plots. Hardcopy of the entire window is made exactly as by using command. Hardcopies of individual plots are made in DiaGI format. The filename of the individual plot is formed as WEB_DIR + "psf_" "station_name1" + "." + "station_name1" + extension (".gif" or ".ps"). Station name is transformed in letters of lower register. If the station name contains blanks inside, blanks are replaced with underscores, while trailing blanks are truncated. Examples for NRAO85 3, MEDICINA, NOTO WEB_DIR = "/tmp/kk_" ==> /tmp/kk_psf_nrao85_3.medicina.gif WEB_DIR = "/data2/plot" ==> /data2/plotpsf_nrao85_3.noto.gof WEB_DIR = "/data2/plots/" ==> /data2/plots/psf_medicina.noto.gif All file names with hardcopies are printed in text screen. e) N -- Next page (for multi-page plots) -- display the next page. The number of the current page is kept in the global variable MDLPL_IPS_PAG which is re-initialized when a new database or superfile is read. The number of the current page is saved after leaving MDLPL. f) P -- Previous page (for multi-page plots) -- display the previous page. The number of the current page is kept in the global variable MDLPL_IPS_PAG which is re-initialized when a new database or superfile is read. g) H -- get on-line help. h) X or -- leave "Plot of postfit residuals" menu level. 2.5. R -- Plot of a sum of clock function and postfit residuals Plots of postfit residuals plus a contribution to time delay due to estimates of segmented clock function for all selected baselines are displayed. Argument is time in hours elapsed from the first observation of the session. Values are in picoseconds. Error bars represents one-sigma a priori uncertainties used for solutions (with reweighting applied). Observations which were used in solution are shown by green. Recoverable observations which were not used in the solution are shown be read. Unrecoverable observations are not shown at all. Clock function with one sigma errors represented by a filled are is shown by blue color unless this feature is switched off. Up to 25 plots are displayed at one page. If the session has more than 25 selected baselines than the plot is displayed in several pages. The number of the current page and the total number of pages is displayed at the common title in this case. User can move through pages consecutively in forward or backward direction. Comments: 1) formal uncertainties of clock function are computed approximately, they shown only for demonstration purposes and should not be used for computations; 2) Only adjustments to clock function modeled by linear spline are taken into account. Contribution to clock function due to clock breaks and global polynomials of the second degree are ignored. Commands available: a) Cursor positioned at the small plot box and -- the plot is magnified to occupy entire window. Control is passed to DiaGI. To leave DiaGI mode hit twice or X. Any changes made in DiaGI mode are saved while MDLPL is running. b) C -- Change directory for Web plots. Hardcopies are written in the directory kept in the variable WEB_DIR. The value of WEB_DIR is reset when the database or superfile is read to the scratch area. This value can be changed. Eventual file name for hardcopy is a concatenation of WEB_DIR plus a suffix assigned by MDLPL_PLUS. NB: WEB_DIR is not merely a directory name but it is rather a prefix which is prepended before the name. If user specifies WEB_DIR as a directory name then trailing / must be put. Value of WEB_DIR is saved until a new database or superfile is loaded. c) -- Make a hardcopy of the screen. MDLPL_PLUS asks user to select the format and then creates a file with hardcopy. Hardcopy doesn't contain right part of the window with command buttons. Filename is formed as WEB_DIR + psc_all" + extension (".gif" or ".ps"). Examples: WEB_DIR = "/tmp/kk_" ==> /tmp/kk_psc_all.gif WEB_DIR = "/data2/plot" ==> /data2/plotpsc_all.gif WEB_DIR = "/data2/plots/" ==> /data2/plots/psc_all.gif NB: Postscripts plots can be printed right after theirs creation if environment variable DIAGI_PRICOM specifies a UNIX command used for printing PostScript files. d) -- Make a set of hardcopies for the screen and for all individual plots. Hardcopy of the entire window is made exactly as by using command. Hardcopies of individual plots are made in DiaGI format. The filename of the individual plot is formed as WEB_DIR + "psc_" "station_name1" + "." + "station_name1" + extension (".gif" or ".ps"). Station name is transformed in letters of lower register. If the station name contains blanks inside, blanks are replaced with underscores, while trailing blanks are truncated. Examples for NRAO85 3, MEDICINA, NOTO WEB_DIR = "/tmp/kk_" ==> /tmp/kk_psc_nrao85_3.medicina.gif WEB_DIR = "/data2/plot" ==> /data2/plotpsc_nrao85_3.noto.gof WEB_DIR = "/data2/plots/" ==> /data2/plots/psc_medicina.noto.gif All file names with hardcopies are printed in text screen. e) N -- Next page (for multi-page plots) -- display the next page. The number of the current page is kept in the global variable MDLPL_IPC_PAG which is re-initialized when a new database or superfile is read. THe number of the current page is saved after quitting MDLPL. f) P -- Previous page (for multi-page plots) -- display the previous page. The number of the current page is kept in the global variable MDLPL_IPC_PAG which is re-initialized when a new database or superfile is read. g) O -- Clock function on. Clock function will be shown by blue color. Status of this option is defined by a global variable MDLPL_FL_CLF which is reset when a new database or superfile is read. Status of this option is saved after quitting MDLPL. h) F -- clock function off. Clock function will not be shown. i) H -- get on-line help. j) X or -- leave "Plot of postfit residuals plus clock function" menu level. 2.6. O -- Old (pre-JUL99) style MDLPL. MDLPL_EXT is called. Refer to documentation for MDLPL_EXT. 2.7. $ -- Oldest (pre-NOV97) style MDLPL. Archaic MDLPL is called. Unfortunately, there is no documentation for that utility. 2.8. H -- get on-line help. 2.9. X or -- quit MDLPL. 3. Customization. Initial placement of the graphic window is determined in x-resource file. You should add the following line to the file ~/.Xdefaults pgxwin.Win.geometry: 1260x800+0+90 pgxwin.Win.maxColors: 69 pgxwin.Win.iconize: True 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. "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 text screen when it terminates. The following command should be run before the first call of pgxwin_server: xrdb -merge ~/.Xdefault NB: if pgxwin_server is running xrdb will be ignored! To change initial position of the graphic window pgxwin_server should be stopped before it. It is reasonable to put the command xrdb -merge ~/.Xdefault at your login script. The following environment variable affects at PGPLOT behavior: PGPLOT_DIR -- directory where files pgwin_server and libpgplot.sl are kept; HELP_DIR -- directory name where help files are kept; DIAGI_PRICOM -- contains the command for printing PostScript file. Example: "lp -onb -dlaser2" for printer which has built-in PostScript interpreter (don't use it if printer doesn't have such a capacity!) WEB_DIR -- Web destination directory. Initial Web destination directory is reset when a new database of superfile is loaded. If WEB_DIR environment variable is set then it becomes the Web destination directory, otherwise system default is used. MDLPL_PLUS v 1.01 17-AUG-99 12:59:33 Please send comments and bug reports to Leonid Petrov ( pet@leo.gsfc.nasa.gov )