IED IED allows you to interactively edit any MERGE-format data file. It will work on any interactive device supported by PGPLOT, including the following terminals: IMAGRAPH (/IMA), RETROGRAPHICS terminal (/RE), VT125 terminal (/VT). The program does nothing to the input data file; rather, it prepares a command procedure file to run the program VLBEDIT. Running the Program To run the program, type command IED (defined in the VLB login procedure). IED will then ask you a number of questions, as in the following example: $ IED IED: interactive editor for MERGE-format visibility files (Version 6.2 - 1987 Mar 23) Input data file: 80jul0710.a00 Source:0710+43 Output data file (def=80JUL0710.EDT): Output command file [default: IED.COM]: Parameters for VLBEDIT will go to file CITSCR:[TJP.0710]IED.COM;1 What device do you want to use for plotting? (Supply a PGPLOT device/type specification, eg, /GR for Grinnell, /RE for Retrographics, /VT for VT125, TXA2:/ID for an ID100.) Plot device/type: /GR Plot error bars? (Y or N; def=Y) Starting baseline or triangle? (e.g. 1,2,3; def=1,2): Will you be editing amplitudes OR baseline phases ? (A or P; def=A) In response to the '>' prompt, type one of the following: ( key is not necessary!) F [or ] ! FORWARD to next point B ! BACK to previous point D ! DELETE current point R ! RESTORE current point S ! SKIP ahead to start of next hour P ! move to PREVIOUS hour K ! delete all points below a cutoff level A ! invoke the AUTOMATIC editor O ! delete Outliers Z ! delete points using cursor U ! UNDELETE all points deleted so far W ! WRITE list of deleted points, and move to next plot E ! EXIT the program, and write list of deleted points. IED Page 2 Q ! QUIT, with no further output X ! erase text from terminal screen V ! VIEW current data subset (refresh screen after DELETING, CUTTING, or GLUING) I ! INQUIRE position of cursor (AMP/PHS,TIME) J ! JUMP to start of window or new data subset C ! CUT data into windows G ! GLUE cut data back together H ! HELP (prints this message) Commands After plotting the data on the screen, IED enters a command mode where single characters (without ) cause something to happen. The commands, and their meanings, are listed above, and can be displayed at any time with the H (help) command. Most commands are straightforward (at least once you've seen them used). Normally you use the F, P, D, R, S and P commands until you are satisfied with the current baseline; then type W to write the editing commands for this baseline in the output command file, and go on to the next baseline. After the last baseline has been saved, use E to exit from IED. For Grinnells and ID100s the type-ahead buffer is disabled during IED so that F, B, D, etc. will stop immediately when the terminal key is released. When editing amplitudes, a deleted point is not used to compute the limit on the vertical axis of the plot. The X command is useful when plotting on one's own terminal for erasing unwanted text while leaving the graphics intact. The V command is useful for refreshing the screen when: 1) unwanted graphics appears, 2) abnormally high amplitude points have been deleted, or 3) the data has been cut into two or more windows of UT or glued back together (see CUT and GLUE below). The J command can be used to jump to any window displayed on the screen or to a new baseline or triangle; one cannot jump to a baseline or triangle earlier in the sequence 12,13,14,...,123,124,... than the current one. To CUT the data into up to four (4) windows of UT type "C", move the cursor horizontally to the desired UT cut, and then type any character (except ). To see the effects of cutting use "V". GLUE ("G") can be used in a similar fashion to remove cuts, either before or after refreshing the screen. The A command invokes an automatic editor which is sometimes useful with global-fringe-fitting output. It deletes all data points that have an error bar greater than three times the median error bar. IED Page 3 The O command deletes points which are very discrepant from their neighbors. Sometimes it works well; more often, it does not. The behavior of this command may be improved in a later version of IED. The K command deletes all points below a level that you set with the cursor. It is very useful for detecting and removing points with zero or very small amplitude. The Z command enables the hardware cursor, and is helpful when editing extremely large data sets on devices with a joystick or mouse driven cursor. It works as follows: Type `Z' to enter a `sense cursor position/delete data' loop. After positioning the cursor near the point you wish to delete, typesany character (except `S'). The cursor then drives to the data point on the monitor, and the point is replotted in the appropriated color to mark it as deleted. The cursor then remains remains at the deleted data point. To return to the IED command level type 'S'. Color Coding On the full-color displays the data points are color coded as follows: WHITE -- undeleted point currently being edited MAGENTA -- deleted point currently being edited BLUE -- undeleted, unedited data GREEN -- undeleted, edited data RED -- deleted data On other devices, the display may be different. On a Retrographics terminal, the position of the point currently being edited is noted by the graphics cursor, and deleted points are plotted with zero intensity (i.e., they are invisible). Shortcomings When in cursor mode on a RETROGRAPHICS terminal, the previous command entered may repeat itself after 60 seconds if no other commands are typed; this is worst when the last command was "D" or "R". History Original program by Richard S. Simon. Version 2: 23-July-1982. Version 3: Add option of plotting on VT125 (/VT) and VT640 (/RE) terminals; add commands X (erase text), V (refresh plot), I (inquire), J (jump), C (cut data into windows), and G (glue windows); make D and R commands advance cursor; plot more than one window on screen (5-April-1983, David L. Meier). Version 5: Fold in Richard Simon's changes: (v3: 16-FEB-1983 Add IED Page 4 capability for ID100 terminal) (v4: 7-Mar-1983 Add baseline phase editing) (3-November-1983, David L. Meier). Version 6: T. J. Pearson, 1986 July 13: remove ZOOM and UNZOOM commands; add display of UT in Grinnell prompt; make S skip to the beginning of the next hour; add K, A, and U commands. Version 6.1: T. J. Pearson, 1986 Aug 28: increase from 15 to 20 stations. Version 6.2: J. Biretta, 1987 Mar 23: add Z command. Version 6.3: fix for Merge format 2 (TJP 1987 Apr 15). Version 6.4: update PGBBUF/PGEBUF/PGUPDT calls; remove dependence on PGPLOT internals [can now use shareable library]; change G command to remove all cuts and redraw screen (TJP 1987 Apr 27). Version 6.5: changes for VAX workstations; eliminate multiple PGBEGIN calls (TJP 1988 Feb 5). Version 7.0: changes for Convex (TJP 1988 Apr 19). Version 7.1: add end commands to output file on exit (TJP 1988 Oct 21). Version 7.2: detect whether VMS or Unix output required (TJP 1988 Oct 29). Version 7.3: use PGQCOL to find device capability (TJP 1989 May 31).