pipeline.hsd.cli.hsd_imaging

hsd_imaging(mode: str | None = None, restfreq: str | None = None, infiles: list[str] | None = None, field: str | None = None, spw: str | None = None) → SDImagingResults[source]

Generate single dish images.

The hsd_imaging task generates single dish images per antenna as well as combined image over whole antennas for each field and spectral window. Image configuration (grid size, number of pixels, etc.) is automatically determined based on meta data such as antenna diameter, map extent, etc.

Generated images are either in REST frame (ephemeris sources) or in LSRK frame (others).

Parameters:

  • mode --

    Imaging mode controls imaging parameters in the task. Accepts either "line" (spectral line imaging) or "ampcal" (image settings for amplitude calibrator).

    Default: None (equivalent to 'line')

  • restfreq -- Rest frequency. Defaults to None, it executes without rest frequency.

  • infiles --

    List of data files. These must be a name of MeasurementSets that are registered to context via hsd_importdata or hsd_restoredata tasks.

    Example: vis=['uid___A002_X85c183_X36f.ms', 'uid___A002_X85c183_X60b.ms']

    Default: None (process all registered MeasurementSets)

  • field --

    Data selection by field names or ids.

    Example: "*Sgr*,M100"

    Default: None (process all science fields)

  • spw --

    Data selection by spw ids.

    Example: "3,4" (generate images for spw 3 and 4)

    Default: None (process all science spws)

Returns:

The results object for the pipeline task is returned.

Examples

  1. Generate images with default settings and context

>>> hsd_imaging()

  1. Generate images with amplitude calibrator and specific parameters

>>> hsd_imaging(mode='ampcal', field='*Sgr*,M100', spw='17,19')