(cap-from-aips)= # Coming from AIPS This page goes through the AIPS tasks that `visplot` takes the place of for inspecting and editing visibility data: TVFLG, SPFLG, FTFLG and EDITR for editing, and VPLOT, UVPLT, POSSM and LISTR's matrix listing for display. For each display mode, option and menu item it gives the `visplot` equivalent: the Python argument, the value, or the setting in the window. `visplot` does not copy the AIPS menus or keyboard use. It is designed for a web window, so one AIPS menu item may correspond to a setting plus a mouse action. :::{admonition} Review status :class: note This table was compiled on 2026-11-16 from AIPS Memo 127 (*Interactive flagging in AIPS*, 2025), the AIPS CookBook and the `visplot` source, and **no row has been reviewed yet**. When a tester confirms a row, the *Reviewed* column gets their initials and the date. Corrections are welcome, especially for rows marked *Different*. ::: **Status** means: - **Same**: works the same way. - **Different**: available, but works differently; the note says how. - **Partial**: some of it is available. - **Not yet**: not available. - **N/A**: does not apply to how `visplot` works. ## TVFLG: what is shown :::{container} crosswalk | AIPS | visplot | Status | Notes | See | Reviewed | |---|---|---|---|---|---| | Baseline × time display | `preset="vplot"`, or `raster_y="TIME"`, `raster_x="BASELINE"` | Same | Either axis can be on either side | {ref}`Plots ` | | | SORT BY LENGTH / SORT BY BASELINE | `baseline_order="length"` / `"number"` | Same | | {ref}`Plots ` | | | DPARM(3): show both n−m and m−n | | N/A | Each baseline is shown once | | | | ENTER CHANNEL, NCHAV (one channel, or channels averaged) | `spw` selection | Different | A Baseline × Time cell averages every selected channel; single channels cannot be selected yet | {ref}`Averaging ` | | | ENTER IF, LOAD NEXT IF/ST | `spw`, stepping through spectral windows | Same | | {ref}`Selection ` | | | DISPLAY STOKES | `raster_corr` | Partial | One correlation, or the parallel hands averaged; no conversion to Stokes | {ref}`Plots ` | | | AMPLITUDE, PHASE | `raster_qty="AMPLITUDE"`, `"PHASE"` | Same | Vector averaged by default; scalar available | {ref}`Quantities ` | | | RMS, RMS/MEAN (scalar amplitude) | | Not yet | Requested | {ref}`Phase stability ` | | | VECT RMS, VRMS/VAVG | `PHASE_RMS`, `COHERENCE` | Different | `visplot` measures the steadiness of *phase*: the RMS of phase, and vector over scalar amplitude | {ref}`Phase stability ` | | | AMP V DIFF | `raster_qty="AMP_VDIFF"` | Different | Compared with the mean of the *other* samples in the window (the sample itself is left out); the windows are fixed blocks | {ref}`Difference ` | | | PHASE DIFF | `raster_qty="PHASE_DIFF"` | Different | As for AMP V DIFF | {ref}`Difference ` | | | AMPL DIFF (scalar amplitude difference) | | Not yet | | {ref}`Difference ` | | | DPARM(4): divide by the source's flux density | | Not yet | | | | ::: ## TVFLG: averaging :::{container} crosswalk | AIPS | visplot | Status | Notes | See | Reviewed | |---|---|---|---|---|---| | DPARM(6): master grid interval | | N/A | Rasters are drawn at the data's own integrations | {ref}`Averaging ` | | | ENTER SMOOTH TIME (in multiples of DPARM(6)) | | Not yet | Requested: averaging by a number of integrations. Raster cells cannot yet be averaged in time | {ref}`Averaging ` | | | Averages weighted by the data weights | | Different | `visplot` does not use the weights: every unflagged sample counts equally | {ref}`Averaging ` | | | ENTER SCAN TIME (window for the DIFF displays) | `stat_time_window` | Different | A scan (the default) or a length in seconds, not in integrations | {ref}`Difference ` | | ::: ## TVFLG: flagging The *reaches* widen a box the way TVFLG's flagging switches do. The baseline, spectral-window, scan and field reaches apply to a raster box with the *All selected* filter; with other filters only the channel and correlation reaches apply (see {ref}`cap-flagging-calc`). :::{container} crosswalk | AIPS | visplot | Status | Notes | See | Reviewed | |---|---|---|---|---|---| | FLAG PIXEL, FLAG AREA, FLAG BASELINE-DT | flag box | Same | A box of any size | {ref}`Flagging ` | | | FLAG TIME, FLAG TIME RANGE (all baselines) | flag box with the *all baselines* reach, or a full-width box | Same | | {ref}`Flagging ` | | | FLAG ANTENNA-DT (all baselines to an antenna) | flag box with the *shared antenna* reach (`flag_reach="shared-antenna"`) | Same | Drag across two or more baselines of the antenna | {ref}`Flagging ` | | | FLAG BASELINE (all times) | full-height flag box | Same | | {ref}`Flagging ` | | | FLAG/CONFIRM | `flag_preview=True` | Different | Each box is shown as a proposal, with counts and highlighted samples, to accept or reject | {ref}`Flagging ` | | | CLIP BY SET #S, CLIP BY FORM | *Value range* flag filter | Partial | Only the samples within the box are clipped | {ref}`Flagging ` | | | CLIP INTERACTIV | | Not yet | | | | | SWITCH ALL-CH FLAG | `flag_reach="channels"` | Same | | {ref}`Flagging ` | | | SWITCH ALL-IF FLAG | `flag_reach="spw"` | Partial | All *selected* spectral windows; no IF range | {ref}`Flagging ` | | | SWITCH SOURCE FLAG | `flag_reach="fields"` | Same | | {ref}`Flagging ` | | | ENTER STOKES FLAG | `flag_reach="correlations"` | Partial | All correlations, or the one shown | {ref}`Flagging ` | | | | `flag_reach="scan"` | (more) | Every integration of the scans a box touches | {ref}`Flagging ` | | | LIST FLAGS | flag report | Same | | {ref}`Flagging ` | | | UNDO FLAGS, REDO FLAGS | undo, redo | Same | | {ref}`Flagging ` | | | SET REASON | `flag_reason` | Same | | {ref}`Flagging ` | | | FC table (work survives an interruption) | JSON export of pending flags | Different | Pending flags are kept in memory until written; export them to keep a record | {ref}`Flagging ` | | | EXIT: copy the FG table, then add flags | write to the MS | Same | A backup of the flags it changes is saved first | {ref}`Flagging ` | | | DPARM(5): extend flags in time | | N/A | Flags apply to exactly the samples selected | | | ::: ## TVFLG: display options :::{container} crosswalk | AIPS | visplot | Status | Notes | See | Reviewed | |---|---|---|---|---|---| | OFFCOLOR, TVPSEUDO, TVPHLAME, OFMCOLOR | `raster_cmap` | Partial | Seven colormaps. The circular (cyclic) scheme is used automatically for Phase and cannot be chosen by name | {ref}`Colormaps ` | | | Cookbook advice: circular pseudo-coloring for phase | | Same | Automatic for Phase | {ref}`Colormaps ` | | | TVTRANSF; LOAD LOG, SQRT, LOG2, LIN | color scaling | Same | Also histogram-equalized (the default), square, gamma or power, threshold | {ref}`Colormaps ` | | | ENTER AMP / PHS / RMS PIXRANGE | color range | Same | | {ref}`Colormaps ` | | | TVZOOM, AUTO Y ZOOM, ENTER BLC / TRC | zoom and pan | Same | Zoom re-samples the data already read | {ref}`Plots ` | | | LOAD NEXT / LAST PIECE | `timerange`, `scan` | Different | Narrow the selection; there is no piece-by-piece loading. A raster over 2 million cells skips rows and columns until the selection is narrowed | {ref}`Plots ` | | ::: ## SPFLG Everything above for TVFLG applies, with these differences: :::{container} crosswalk | AIPS | visplot | Status | Notes | See | Reviewed | |---|---|---|---|---|---| | Channel × time display, one baseline | `preset="waterfall"` (amplitude), `"phase-waterfall"` | Same | | {ref}`Standard views ` | | | ENTER BASELINE, LOAD NEXT / LAST BASELINE, LIST BASLS | stepping through baselines; baseline list | Same | Stepping skips baselines with no data | {ref}`Selection ` | | | ENTER CH SMOOTH (Gaussian, in channels) | | Not yet | Channel averaging is for scatter plots only | {ref}`Averaging ` | | | DPARM(2): cross, auto or both | `autocorr` | Same | `"exclude"`, `"include"` or `"only"` | {ref}`Selection ` | | | SWITCH BASLIN FLAG (n−m, n−\*, m−\*, \*−\*) | baselines reach | Same | As drawn, all baselines to the shared antenna, to every antenna drawn, or all | {ref}`Flagging ` | | | FLAG A CHANNEL, FLAG CHANNEL RANGE, FLAG CHANNEL-DT | flag box (full height for all times) | Same | | {ref}`Flagging ` | | | TVPSEUDO: rainbow, circular, step | | Partial | See the TVFLG display options | {ref}`Colormaps ` | | | DOCAT=2 / IN2SEQ: build the master grid now, use it later | | N/A | There is no master grid | | | ::: ## FTFLG :::{container} crosswalk | AIPS | visplot | Status | Notes | See | Reviewed | |---|---|---|---|---|---| | Channel × time, all baselines vector averaged | `preset="waterfall-all"` with `baseline_combine="coherent"` | Different | The preset combines baselines by *maximum*, so interference on a few baselines is not diluted. Mean, median and coherent (the FTFLG vector average) are also available | {ref}`Averaging ` | | | Each flag applies to all baselines | flag box | Same | A box on such a plot flags every selected baseline | {ref}`Flagging ` | | ::: ## EDITR :::{container} crosswalk | AIPS | visplot | Status | Notes | See | Reviewed | |---|---|---|---|---|---| | Baselines to one antenna against time | stepping through antennas, with a Baseline × Time raster or a time series | Different | | {ref}`Selection ` | | | Second data set, or second observable (DOTWO) | two panels | Partial | Two panels show two observables of the *same* data set | {ref}`Plots ` | | | SHOW COHERENCE | `COHERENCE` | Different | `visplot` gives vector over scalar amplitude, from 0 to 1 (1 is fully coherent) | {ref}`Phase stability ` | | ::: ## Display tasks :::{container} crosswalk | AIPS | visplot | Status | Notes | See | Reviewed | |---|---|---|---|---|---| | VPLOT: a quantity against time, one baseline per plot | `preset="timeseries"`; `layout="grid"`, `iterate_by="baseline"` | Same | | {ref}`Standard views ` | | | UVPLT / VPLOT axes: amplitude, phase, real, imaginary, time, u, v, uv distance, frequency, channel | scatter axes | Same | | {ref}`Plots ` | | | UVPLT / VPLOT axes: hour angle, elevation, azimuth, parallactic angle, position angle, w, log amplitude, weight | | Not yet | | {ref}`Plots ` | | | UVPLT: uv coverage | `scatter_x="U"`, `scatter_y="V"` | Same | | {ref}`Plots ` | | | SOLINT (time averaging, in minutes) | `scatter_avg_time` | Different | In seconds, or `"scan"` | {ref}`Averaging ` | | | XINC (plot every n-th sample) | | N/A | Every sample is drawn, as density | {ref}`Plots ` | | | DO3COL (separate IFs, channels, sources or times by color) | scatter layer coloring | Partial | By scan, field, antenna, baseline, spectral window or correlation; not by channel or time | {ref}`Plots ` | | | POSSM: spectra averaged in time | `preset="spectrum"` | Partial | Each scan averaged, per baseline. Spectra averaged over baselines are not yet available on scatter plots | {ref}`Standard views ` | | | POSSM: plot bandpass and other calibration tables | | Not yet | | {ref}`Data ` | | | LISTR OPTYPE='MATX': baseline matrix listing | `preset="antmatrix"` | Different | A raster image rather than a listing, averaged over the whole selection. Narrow by `scan` for one scan | {ref}`Standard views ` | | ::: ## Automatic flagging tasks :::{container} crosswalk | AIPS | visplot | Status | Notes | See | Reviewed | |---|---|---|---|---|---| | RFLAG (statistical flagging) | Z-Score; the *Z-Score*, *Outlier from neighbours* and *Amplitude outlier* flag filters | Different | Interactive: the filters act within a box that is drawn | {ref}`Flagging ` | | | CLIP (by limits) | *Value range* flag filter | Partial | Within a box | {ref}`Flagging ` | | | UVFLG (flags from a list) | | Not yet | Flags can be exported as JSON | {ref}`Flagging ` | | ::: ## Sources - E. W. Greisen, [*Interactive flagging in AIPS*](https://aips.nrao.edu/TEXT/PUBL/AIPSMEM127.PDF), AIPS Memo 127 (2025). - The AIPS CookBook: [More editing of uv data](https://aips.nrao.edu/CookHTML/CookBookse30.html), [Plotting](https://aips.nrao.edu/CookHTML/CookBookse35.html), [Tools for data examination](https://www.aips.nrao.edu/CookHTML/CookBookse58.html).