Difference between revisions of "Plotms"

From CASA Guides
Jump to navigationJump to search
(Replaced content with "{{plotms}}")
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Help on plotms task:
+
{{plotms}}
<pre>
 
A plotter/interactive flagger for visibility data.
 
 
 
            Task for plotting and interacting with visibility data.  A variety
 
        of axes choices (including data column) along with MS selection and
 
        averaging options are provided for data selection.  Flag extension
 
        parameters are also available for flagging operations in the plotter.
 
       
 
            All of the provided parameters can also be set using the GUI once
 
        the application has been launched.  Additional and more specific
 
        operations are available through the GUI and/or through the plotms
 
        tool (pm).
 
       
 
 
 
    Keyword arguments:
 
    vis -- input visibility dataset
 
          default: ''
 
    xaxis, yaxis -- what to plot on the two axes
 
                    default: '' (uses PlotMS defaults/current set).
 
      >>> xaxis, yaxis expandable parameters
 
        xdatacolumn, ydatacolumn -- which data column to use for data axes
 
                                    default: '' (uses PlotMS default/current
 
                                    set).
 
   
 
    selectdata -- data selection parameters flag
 
                  (see help par.selectdata for more detailed information)
 
                  default: False
 
      >>> selectdata expandable parameters
 
        field -- select using field ID(s) or field name(s)
 
                default: '' (all).
 
        spw -- select using spectral window/channels
 
              default: '' (all)
 
        timerange -- select using time range
 
                    default: '' (all).
 
        uvrange -- select using uvrange
 
                  default: '' (all).
 
        antenna -- select using antenna/baseline
 
                  default: '' (all).
 
        scan -- select using scan number
 
                default: '' (all).
 
        correlation -- select using correlations
 
                      default: '' (all).
 
        array -- select using (sub)-array range
 
                default: '' (all).
 
        msselect -- TaQL selection expression
 
                    default: '' (all).
 
   
 
    averagedata -- data averaing parameters flag
 
                  default: False.
 
      >>> averagedata expandable parameters
 
        avgchannel -- average over channel?  either blank for none, or a value
 
                      in channels.
 
                      default: '' (none).
 
        avgtime -- average over time?  either blank for none, or a value in
 
                  seconds.
 
                  default: '' (none).
 
        avgscan -- average over scans?  only valid if time averaging is turned
 
                  on.
 
                  default: False.
 
        avgfield -- average over fields?  only valid if time averaging is
 
                    turned on.
 
                    default: False.
 
        avgbaseline -- average over all baselines?  mutually exclusive with
 
                      avgantenna.
 
                      default: False.
 
        avgantenna -- average by per-antenna?  mutually exclusive with
 
                      avgbaseline.
 
                      default: False.
 
        avgspw -- average over all spectral windows?
 
                  default: False.
 
   
 
    extendflag -- have flagging extend to other data points?
 
                  default: False.
 
      >>> extendflag expandable parameters
 
        extcorrelation -- extend flags based on correlation?  blank = none.
 
                          default: ''.
 
        extchannel -- extend flags based on channel?
 
                      default: False.
 
        extspw -- extend flags based on spw?
 
                  default: False.
 
        extantenna -- extend flags based on antenna?  should be either blank,
 
                      'all' for all baselines, or an antenna-based value.
 
                      default: ''.
 
        exttime -- extend flags based on time (within scans)?
 
                  default: False.
 
        extscans -- extend flags based on scans?  only valid if time extension
 
                    is turned on.
 
                    default: False.
 
        extfield -- extend flags based on field?  only valid if time extension
 
                    is turned on.
 
                    default: False.
 
   
 
    plotxycomp -- use plotxy compliance parameters?  WARNING: if used,
 
                  subparameters will override their corresponding plotms
 
                  parameter values.
 
                  default: False.
 
      >>> plotxycomp expandable parameters
 
        datacolumn -- maps to xdatacolumn and ydatacolumn.
 
                      default: 'data'.
 
        timebin -- maps to avgtime.
 
                  default: '0'.
 
        crossscans -- maps to avgscan.
 
                      default: False.
 
        crossbls -- maps to avgbaseline.
 
                    default: False.
 
        width -- maps to avgchannel and/or avgspw.  'all' is ignored, 'allspw'
 
                sets avgspw to true, any other value is set for avgchannel.
 
                default: '1'.
 
        extendcorr -- maps to extcorrelation.  'half' is mapped to 'poln-dep'.
 
                      default: ''.
 
        extendchan -- maps to extchannel.  '' means False, 'all' means True.
 
                      default: ''.
 
        extendspw -- maps to extspw.  '' means False, 'all' means True.
 
                    default: ''.
 
        extendant -- maps to extantenna.  '' means False, 'all' means True.
 
                    default: ''.
 
        extendtime -- maps to exttime and/or extscans and/or extfield.  ''
 
                      means False for all, 'all' means True for exttime, 'scan'
 
                      means True for exttime and extscans, 'field' means True
 
                      for exttime and extfield.
 
                      default: ''.
 
</pre>
 

Latest revision as of 16:30, 18 May 2015