GENERAL DESCRIPTION OF AEDIT ---------------------------- The program "aedit" is a general purpose A-file manipulation program. The information present in one or more A-files may be plotted, filtered, sorted and edited in a variety of ways, before being written out in the form of a new A-file. The user interface to the program is presently implemented only for ASCII terminals, but many functions of the program interact with the user via a graphical interface. 1. General "aedit" characteristics Commands are given to aedit by keyboard, and a full minimum match capability is supported for all aedit names. Multiple commands are allowed on one input line, the only requirement being that commands are separated by the semicolon ";" character. Commands typically consist of the command name followed by 0 or more arguments. The arguments are separated from the command name and each other by either spaces or commas. Aedit can handle long lines, but it is of course bad practice to wrap lines on terminals in general. Upwards of about 250 characters may start to cause problems even for aedit. In general, aedit is not case sensitive. Case sensitivity is needed for UNIX filenames and for certain quantities from A-files (station codes, frequency codes, source names). Aedit uses the concept of inputs. That is, you set up certain variables in the program that determine how the "action" commands will behave. Most of the commands that aedit understands are of the input-setting variety. Many are quite particular about syntax, and will complain if the user types nonsense (e.g. timerange). At any time, the current state of the input parameters can be listed on the screen with the command "inputs". When aedit reads data from an A-file, it parses the ascii information and stores it as binary data in memory. This allows very rapid manipulation of the data once read in, with seemingly complex tasks appearing to be instantaneous. There is a flag field associated with each A-file line in memory, and these flags are manipulated by the edit and unflag commands. A full description of the data currently in memory can be obtained with the "summary" command. This is essential when deciding on plotting and editing options. The "write" command ignores flagged data, permitting aedit to be used as a simple and efficient filtering program. A command "run" is available, which provides a flexible and general command file capability. Nesting of command files to a depth of 10 is allowed. The "run" command executes in batch mode, and cursor operations are therefore disabled. Aedit features a shell escape. By starting an input line with the character "!", you can access standard UNIX commands outside of aedit. You can escape to a complete new shell by typing "!csh" or "!sh", and when you have finished, return to aedit where you left off by typing cntl-D. This feature is useful for spooling plot files to a printer, preparing run files, running "alist" to prepare new data for aedit, and any other tasks that you wish to perform without terminating the aedit session. Plotting is implemented by using the PGPLOT package from CalTech. The output device may be specified with the "device" command, or you may leave "device" at the default value ("?"), which will cause PGPLOT to query you for a device at the time of plotting. Your response will then be automatically entered into the "device" input. A list of available device types can be obtained by responding with a query. For more information of devices, see "help device" Aedit comes with full on-line help. In general, the syntax is "help command", but just "help" will work. The command line for aedit is "aedit [-x] [-r filename] [-f filename]", where "-x","-r", and "-f" are optional. The "-x" option means start up the xwindow interface (not yet supported). The "-r" option means execute the specified run file on startup, and must be immediately followed by the name of a file containing valid aedit commands. The "-f" option means "read this(ese) data file(s) on startup", and must be immediately followed by a standard, wildcardable UNIX filename specifier or specifiers. In this way, you can read many files at once into aedit without going through a laborious one-at-a-time "read" cycle within the program. If specified, the "-f" flag must be the last flag. Below is a list of all current aedit commands: Action commands: ---------------- batch clear close edit exit fplot help inputs nobatch parameter plist plot pwrite read run setyear sort summary twrite unflag unsort write zoom Plot control commands: ---------------------- grid xscale yscale axis mode reference remote Data selection commands: ------------------------ baselines bsnrmin bsnrmax experiment fraction frequencies length nfreq prange procrange qcodes snrmax snrmin sources stations timerange triangles type Experiment overview commands/parameters --------------------------------------- schedread psplot psfile IO control commands: -------------------- device outversion For further information, see the individual help files for the above commands.