dcdofeedoffsets.pro

NRAO GBTIDL
Produced by IDL 7.1.1
User Documentation

prev file | next file view single page | view frames | update routines

SUMMARY: fields | routine DETAILS: routine

./toolbox
dcdofeedoffsets.pro

Last modification date:: Wed Sep 28 13:27:10 2016

dcdofeedoffsets

procedure dcdofeedoffsets, dc, [/remove], [/reportonly], [status=variable]

Apply or remove the feed offsets in the supplied data container.

Note:The feed offsets need only be applied for old (fitsver earlier than 1.7) data written by gbtidl. Data produced by sdfits from fitsver 1.7 on has had the feed offsets applied by sdfits. In addition, GBTIDL applies all feed offsets by default when reading from SDFITS files having an SDFITSVER keyword (files produced by sdfits). Other old SDFITS file are likely produced by GBTIDL using KEEP or SAVE and it's impossible to tell whether any non-zero feed offsets found there have been applied to the positions and so GBTIDL does not automatically apply the feed offsets when reading that data.

This applies (default) or removes (when the /remove keyword is set) any non-zero feed offset values (feedxoff and feedeoff) found in the supplied data container. If /reportonly is used then information is printed about what the new coordinate values would have been but the data container remains unchanged.

Feed offsets can only be applied if the longitude and latitude coordinates can be converted to and from Azimuth and Elevation. Recognized coordinate systems are "RADEC","HADEC","GALACTIC",and "AZEL". If the offsets can not be applied (or removed) the status value will be set to 0. When successfull, the status value is 1.

This works with spectral line and continuum data containers.

Version: $Id$

Parameters

dc
in, required
data container The data container to be used. The longitude, latitude, azimuth, and elevation values are changed by this procedure unless /reportonly is set.

Keywords

remove
in, optional
boolean (def. 0) When set, remove the feed offsets from the positions. The default is to apply the feed offsets.

reportonly
in, optional
boolean (def. 0) When set, generate a report only. No values in dc are changed when that is set. For continuum data containers, the report is generated for a position near the middle integration.

status
out, optional
variable On success, this is set to 1. On failure it is set to 0.

Produced by IDLdoc 1.6 on Wed Sep 28 13:27:38 2016

Parameters
dc in, required data container	The data container to be used. The longitude, latitude, azimuth, and elevation values are changed by this procedure unless /reportonly is set.

Keywords
remove in, optional boolean (def. 0)	When set, remove the feed offsets from the positions. The default is to apply the feed offsets.
reportonly in, optional boolean (def. 0)	When set, generate a report only. No values in dc are changed when that is set. For continuum data containers, the report is generated for a position near the middle integration.
status out, optional variable	On success, this is set to 1. On failure it is set to 0.