Source code for casatasks.information.browsetable

#
# stub function definition file for docstring parsing
#

[docs]def browsetable(tablename='', mightedit=False, sortlist='', taql='', skipcols=''): r""" Browse a table (MS, calibration table, image) [`Description`_] [`Examples`_] [`Development`_] [`Details`_] Parameters - tablename_ (string='') - Name of input table .. raw:: html <details><summary><i> tablename != '' </i></summary> - mightedit_ (bool=False) - Warning: the GUI seems to ignore whether the table tool is opened read-only. Just be careful, esp. if filtering. - sortlist_ ({string, stringArray}='') - Columns to sort by (ascending) - taql_ (string='') - TaQL query string for prefiltering the table. - skipcols_ ({string, stringArray}='') - Columns to omit .. raw:: html </details> .. _Description: Description Brings up a browser that can open and display any CASA table (MS, calibration table, image). The *tablename* can be specified at startup, or any table can be loaded after the browser comes up. It is possible to edit any table and its contents using the "Edit" tab on the top bar, but be careful with this, and make a backup copy of the table before editing! The tab "table keywords" on the left side of the table browser will allow you to look at sub-tables by left-clicking and then view the desired sub-table. Another useful feature is to make a 2D plot of the values in two table columns. Use the "Close Tables and Exit" option from the Files menu to quit the **casabrowser**. A detailed description on how to use the table browser can be found in the Chapter pages on `"Browsing through MeasurementSets and Calibration Tables" <../../notebooks/data_examination.ipynb#Browse-MS/Calibration-Tables>`__. .. warning:: **Warning:** the inp/go functionality does not work for browsetable in CASA 6. Use the argument browstable(tablename='filename.ms') to invoke browsetable. .. rubric:: Parameters *tablename* Name of table file on disk. For example *filename.ms*, *caltable.tbl*, *imagefile.image*, etc. *mightedit* If the default False is changed to True, this disables the filtering options and allows editing the table. .. warning:: **WARNING**: The GUI appears to ignore whether the table tool is opened read-only - just be aware that you should not edit filtered tables unless you know what you are doing! *sortlist* List of columns to sort by. *taql* TaQL query string for prefiltering the table (see "Examples" tab at the top-right) For more information about the Table Query Language (TaQL) string, see this note: https://casacore.github.io/casacore-notes/199.html *skipcols* Columns to NOT display. For example: *skipcols='feed1, feed2' .. figure:: ../../tasks/_apimedia/e7b82ce6a699178fe6f43360bef6c38bb9c431bb.png CASA table browser with an MS loaded. .. _Examples: Examples **Note:** a detailed description on how to use the table browser can be found in the Chapter pages on `"Browsing through MeasurementSets and Calibration Tables" <../../notebooks/data_examination.ipynb#Browse-MS/Calibration-Tables>`__ To open the table browser and display the contents of table *measurementset.ms*: :: browsetable(tablename='measurementset.ms') The following will open the table browser and displays only those data from *measurementset.ms* for which the column ANTENNA2 has a value below 6: :: browsetable(tablename='measurementset.ms',taql='ANTENNA2 < 6') To get a plot of two table values, click on tools, then click on plot 2D. Example 1: to get a u-v plot, in the Plotter Option Gui, | set Rows: 0 to <Large Number> | X Axis: UVW Slice (set 0) | Y Axis: UVW Slice (set 1) | click 'Clear and Plot' on right. Example 2: to get visibility plots (see Figure below) | X Axis: TIME | Y Axis: DATA Slice Amplitude | click 'Clear and Plot' on right. .. figure:: ../../tasks/_apimedia/0ebdba26cba84528a4fa6ab8f42ae176d635c739.png 2D plot in the table browser .. _Development: Development No additional development details .. _Details: Parameter Details Detailed descriptions of each function parameter .. _tablename: | ``tablename (string='')`` - Name of table file (vis, calibration table, image) | Default: none | | Example: tablename='ngc5921.ms' .. _mightedit: | ``mightedit (bool=False)`` - Disable the filtering options (below) and allow editing | the table. | Default: False | Options: False|True | Warning: the GUI seems to ignore whether the | table tool is opened read-only - just be careful, | esp. if filtering. .. _sortlist: | ``sortlist ({string, stringArray}='')`` - List of columns to sort by | Default: none .. _taql: | ``taql (string='')`` - TaQL query string for prefiltering the table. | Default: none | Example: taql="ANTENNA2 < 6 .. _skipcols: | ``skipcols ({string, stringArray}='')`` - Columns to NOT display. | Default: none | Example: skipcols='feed1, feed2' """ pass