Using The ASAP Toolkit Within CASA

NRAO Home > CASA > CASA Cookbook and User Reference Manual

8.3 Using The ASAP Toolkit Within CASA

ASAP is included with the CASA installation/build. It is loaded upon start-up, and the ASAP functionality is under the Python ’sd’ tool. Note: This means that if you are following the ASAP cookbook or documentation, all of the commands should be invoked with a ’sd.’ before the native ASAP command.

The ASAP interface is essentially the same as that of the CASA toolkit, that is, there are groups of functionality (aka tools) which have the ability to operate on your data. Type:

  CASA <4>: sd.<TAB>
  sd.__builtins__            sd._validate_bool          sd.list_scans
  sd.__class__               sd._validate_int           sd.mask_and
  sd.__date__                sd.asapfitter              sd.mask_not
  sd.__delattr__             sd.asaplinefind            sd.mask_or
  sd.__dict__                sd.asaplog                 sd.merge
  sd.__doc__                 sd.asaplotbase             sd.os
  sd.__file__                sd.asaplotgui              sd.plf
  sd.__getattribute__        sd.asapmath                sd.plotter
  sd.__hash__                sd.asapplotter             sd.print_log
  sd.__init__                sd.asapreader              sd.quotient
  sd.__name__                sd.average_time            sd.rc
  sd.__new__                 sd.calfs                   sd.rcParams
  sd.__path__                sd.calnod                  sd.rcParamsDefault
  sd.__reduce__              sd.calps                   sd.rc_params
  sd.__reduce_ex__           sd.casapath                sd.rcdefaults
  sd.__repr__                sd.commands                sd.reader
  sd.__revision__            sd.defaultParams           sd.revinfo
  sd.__setattr__             sd.dosigref                sd.scantable
  sd.__str__                 sd.dototalpower            sd.selector
  sd.__version__             sd.fitter                  sd.simple_math
  sd._asap                   sd.interactivemask         sd.sys
  sd._asap_fname             sd.is_ipython              sd.unique
  sd._asaplog                sd.linecatalog             sd.version
  sd._is_sequence_or_number  sd.linefinder              sd.welcome
  sd._n_bools                sd.list_files              sd.xyplotter

...to see the list of tools.

In particular, the following are essential for most reduction sessions:

sd.scantable - the data structure for ASAP and the core methods for manipulating the data; allows importing data, making data selections, basic operations (averaging, baselines, etc) and setting data characteristics (e.g., frequencies, etc).
sd.selector - selects a subset of data for subsequent operations
sd.fitter - fit data
sd.plotter - plotting facilities (uses matplotlib)

The scantable functions are used most often and can be applied to both the initial scantable and to any spectrum from that scan table. Type

sd.scantable.<TAB>

(using TAB completion) to see the full list.

R3.4 New Features
The single dish package (ASAP) is now loaded at the start-up of CASA. It is not necessary to load ASAP explicitly by invoking asap_init anymore.

  8.3.1 Environment Variables
  8.3.2 Import
   8.3.2.1 General descriptions
   8.3.2.2 Handling ALMA data
  8.3.3 Scantable Manipulation
   8.3.3.1 Data Selection
   8.3.3.2 State Information
   8.3.3.3 Masks
   8.3.3.4 Scantable Management
   8.3.3.5 Scantable Mathematics
   8.3.3.6 Scantable Save and Export
  8.3.4 Calibration
   8.3.4.1 Tsys scaling
   8.3.4.2 Flux and Temperature Unit Conversion
   8.3.4.3 Gain-Elevation and Atmospheric Optical Depth Corrections
   8.3.4.4 Calibration of GBT data
   8.3.4.5 Comprehensive calibration function
  8.3.5 Averaging
  8.3.6 Spectral Smoothing
  8.3.7 Baseline Fitting
  8.3.8 Line Fitting
  8.3.9 Plotting
   8.3.9.1 ASAP plotter
   8.3.9.2 Line Catalog
  8.3.10 Setting/Getting Rest Frequencies
  8.3.11 Single Dish Spectral Analysis Use Case With ASAP Toolkit

[next] [prev] [prev-tail] [front] [up]

More information about CASA may be found at the CASA web page

This code is available under the terms of the GNU General Public Lincense