What's the difference between Antenna1 and Antenna2? Axis definitions in plotms: Difference between revisions

From CASA Guides
Jump to navigationJump to search
No edit summary
 
(13 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Plotms]] is a powerful tool for visualizing your measurement set, and provides you with lots of choices for X- and Y- Axes. It's not always clear what the choices mean, so below are some explanations.
[[Category: Interactive Tools]]
 
{{Interactive Tools Intro}}
 
{{Plotms}} is a powerful tool for visualizing your measurement set, and provides you with lots of choices for X- and Y- Axes. It's not always clear what the choices mean, so below are some explanations.


== Scan ==
== Scan ==
The scan number, as listed by [[listobs]].
The scan number, as listed by {{listobs}}.


== Field ==
== Field ==
The field number, as listed by [[listobs]]. Typically, each source should have a different field number.  
The field number, as listed by {{listobs}}. Typically, each source/pointing should have a different field number.


== Time ==
== Time ==
Line 14: Line 18:


== Spw ==
== Spw ==
The spectral window number (analogous to what VLA users know as an IF). The characteristics of each spectral window are listed in [[listobs]].
The spectral window number (analogous to what VLA users know as an IF). The characteristics of each spectral window are listed in {{listobs}}.


== Channel ==
== Channel ==
Line 20: Line 24:


== Frequency ==
== Frequency ==
Frequency in units of GHz. The frame for the frequency (e.g., topocentric, barycentric, LSRK) can be set in the '''Trans''' tab of [[plotms]].
Frequency in units of GHz. The frame for the frequency (e.g., topocentric, barycentric, LSRK) can be set in the '''Trans''' tab of {{plotms}}.
 
== Velocity ==
Velocity in units of km/s. Velocity is defined by parameters in the '''Trans''' tab of {{plotms}}, namely:
* the reference frame (barycentric, topocentric, etc.)
* the velocity definition (radio, optical, true, etc.)
* the rest frequency of the spectral line.


== Corr ==
== Corr ==
Correlations which have been assigned integer IDs:
Correlations which have been assigned integer IDs:
<pre>
* 5: RR
5: RR
* 6: RL
6: RL
* 7: LR
7: LR
* 8: LL
8: LL
</pre>


== Antenna1, Antenna2 ==
== Antenna1, Antenna2 ==
Antenna1 is the first antenna in a baseline pair; for example, for baseline 2-4, Antenna1 = 2. Antenna2 is the second antenna in a baseline pair; so for baseline 2-4, Antenna2 = 4. Antennae are numbered according to the antenna IDs listed in [[listobs]].
Antenna1 is the first antenna in a baseline pair; for example, for baseline 2-4, Antenna1 = 2. Antenna2 is the second antenna in a baseline pair; so for baseline 2-4, Antenna2 = 4. Antennae are numbered according to the antenna IDs listed in {{listobs}}.


== Antenna ==
== Antenna ==
For plotting antenna-based quantities like elevation, use just plain Antenna. Antennae are numbered according to the antenna IDs listed in [[listobs]].
For plotting antenna-based quantities like elevation, use just plain Antenna. Antennae are numbered according to the antenna IDs listed in {{listobs}}.


== Baseline ==
== Baseline ==
Line 49: Line 57:
'''Beta Alert:''' Some day soon there will be U_L, V_L, and W_L, which will be in units of observing wavelength. Like UVDist_L, these quantities are functions of frequency and will change across your bandwidth.
'''Beta Alert:''' Some day soon there will be U_L, V_L, and W_L, which will be in units of observing wavelength. Like UVDist_L, these quantities are functions of frequency and will change across your bandwidth.
</div>
</div>
== Velocity ==
Velocity in units of km/s. Velocity is defined by parameters in the '''Trans''' tab of [[plotms]], namely:
* the reference frame (barycentric, topocentric, etc.)
* the velocity definition (radio, optical, true, etc.)
* the rest frequency of the line.


== Amp ==
== Amp ==
Data amplitudes in units of Jansky.
Data amplitudes in units which are proportional to Jansky (for data which are fully calibrated, the units should be Jy).


== Phase ==
== Phase ==
Line 63: Line 65:


== Real, Imag ==
== Real, Imag ==
The real and imaginary parts of the visibility in units of Jansky.
The real and imaginary parts of the visibility in units which are proportional to Jansky (for data which are fully calibrated, the units should be Jy).


== Flag ==
== Flag ==
Line 69: Line 71:


== Azimuth, Ant-Azimuth ==
== Azimuth, Ant-Azimuth ==
Antenna azimuth in units of degrees. Azimuth is the baseline-based version, while Ant-Azimuth is the antenna-based version.
Azimuth in units of degrees. 'Azimuth' plots a fiducial value for the entire array, while 'Ant-Azimuth' plots the azimuth for each individual antenna (their azimuths will differ by small amounts, because each antenna is located at a slightly different longitude, latitude, and elevation).


== Elevation, Ant-Elevation ==
== Elevation, Ant-Elevation ==
Antenna elevation in units of degrees. Elevation is the baseline-based version, while Ant-Elevation is the antenna-based version.
Elevation in units of degrees. 'Elevation' is a representative value for the entire array, while 'Ant-Elevation' is the elevation for each individual antenna (their elevations will differ by small amounts, because each antenna is located at a slightly different longitude, latitude, and elevation).


== HourAngle ==
== HourAngle ==
Hour Angle in units of hours. This is a baseline-based quantity.  
Hour Angle in units of hours. This is a fiducial value for the entire array.
 
<div style="background-color: #dddddd;">
'''Beta Alert:''' Some day soon, Ant-HourAngle will be added.
</div>


== ParAngle, Ant-ParAng ==
== ParAngle, Ant-ParAng ==
Parallactic angle in units of degrees (???)
Parallactic angle in units of degrees.'ParAngle' is the fiducial parallactic angle for all antennae in the array, while 'Ant-ParAng' plots the parallactic ange for each individual antenna (their parallactic angles will differ by small amounts, because each antenna is located at a slightly different longitude, latitude, and elevation).
 
???
 
It appears that Ant-ParAng is in reasonable units to be in degrees, whereas ParAng gives totally different numbers, which are too small to be in degrees.  
 
???


== Row ==
== Row ==
Data row number.
Data row number. A row number corresponds to a unique time, baseline, and spectral window in the measurement set.
 
???
 
For each time integration, is there a new row created?
 
???


== FlagRow ==
== FlagRow ==
In some tasks, if a whole data row is flagged, then FlagRow will be set to 1 for that row. Unflagged rows have FlagRow = 0. However, note that some tasks (like {{plotms}}) may flag a row, but ''not'' set FlagRow = 1. It's probably better to plot Flag than FlagRow for most applications.


???
== Data Column ==
For relevant data axes like Amp and Phase, you will have the option to plot the raw data or the calibrated data. This can be selected via a drop-down menu called 'Data Column', located directly under the drop-down menu for X or Y Axis selection. To plot raw data, select 'data'; to plot calibrated data, select 'corrected'. Note that this choice will only have an impact on your plot if you have applied a calibration table.


I would think this is the row number in the flag table for flagged data, but it appears that all data, even that which is flagged, has FlagRow = 0
If you have applied a data model, you can also plot this up by selecting 'model' from the 'Data Column' menu. Finally, you can plot the differences between the calibrated data and the model by selecting 'residual' from 'Data Column'.


???


Last checked in CASA Version 3.0.1 (r10380).
Last checked in CASA Version 3.0.1 (r10380).


--[[User:Lchomiuk|Laura Chomiuk]] 04:42, 19 February 2010 (UTC)
--[[User:Lchomiuk|Laura Chomiuk]] 19:51, 19 February 2010 (UTC)

Latest revision as of 18:01, 7 June 2010


Interactive Tools

plotms is a powerful tool for visualizing your measurement set, and provides you with lots of choices for X- and Y- Axes. It's not always clear what the choices mean, so below are some explanations.

Scan

The scan number, as listed by listobs.

Field

The field number, as listed by listobs. Typically, each source/pointing should have a different field number.

Time

The time at which the visibility was observed, given in terms of calendar year (yyyy/mm/dd/hh:mm:ss.ss)

Time_interval

The integration time in seconds.

Spw

The spectral window number (analogous to what VLA users know as an IF). The characteristics of each spectral window are listed in listobs.

Channel

The frequency channel number.

Frequency

Frequency in units of GHz. The frame for the frequency (e.g., topocentric, barycentric, LSRK) can be set in the Trans tab of plotms.

Velocity

Velocity in units of km/s. Velocity is defined by parameters in the Trans tab of plotms, namely:

  • the reference frame (barycentric, topocentric, etc.)
  • the velocity definition (radio, optical, true, etc.)
  • the rest frequency of the spectral line.

Corr

Correlations which have been assigned integer IDs:

  • 5: RR
  • 6: RL
  • 7: LR
  • 8: LL

Antenna1, Antenna2

Antenna1 is the first antenna in a baseline pair; for example, for baseline 2-4, Antenna1 = 2. Antenna2 is the second antenna in a baseline pair; so for baseline 2-4, Antenna2 = 4. Antennae are numbered according to the antenna IDs listed in listobs.

Antenna

For plotting antenna-based quantities like elevation, use just plain Antenna. Antennae are numbered according to the antenna IDs listed in listobs.

Baseline

The baseline number.

UVDist, UVDist_L

Projected baseline separations. UVDist is in units of meters, while UVDist_L is in units of the observing wavelength (lambda, not kilolambda). Note that UVDist_L is a function of frequency, while UVDist is not. Therefore, when plotting UVDist_L, there will be a different data point for each frequency channel.

U, V, W

u, v, and w in units of meters.

Beta Alert: Some day soon there will be U_L, V_L, and W_L, which will be in units of observing wavelength. Like UVDist_L, these quantities are functions of frequency and will change across your bandwidth.

Amp

Data amplitudes in units which are proportional to Jansky (for data which are fully calibrated, the units should be Jy).

Phase

Data phases in units of degrees.

Real, Imag

The real and imaginary parts of the visibility in units which are proportional to Jansky (for data which are fully calibrated, the units should be Jy).

Flag

Data which are flagged have Flag = 1, whereas unflagged data are set to Flag = 0. Note that, to display flagged data, you will have to click on the Display tab and choose a 'Flagged Points Symbol'.

Azimuth, Ant-Azimuth

Azimuth in units of degrees. 'Azimuth' plots a fiducial value for the entire array, while 'Ant-Azimuth' plots the azimuth for each individual antenna (their azimuths will differ by small amounts, because each antenna is located at a slightly different longitude, latitude, and elevation).

Elevation, Ant-Elevation

Elevation in units of degrees. 'Elevation' is a representative value for the entire array, while 'Ant-Elevation' is the elevation for each individual antenna (their elevations will differ by small amounts, because each antenna is located at a slightly different longitude, latitude, and elevation).

HourAngle

Hour Angle in units of hours. This is a fiducial value for the entire array.

Beta Alert: Some day soon, Ant-HourAngle will be added.

ParAngle, Ant-ParAng

Parallactic angle in units of degrees.'ParAngle' is the fiducial parallactic angle for all antennae in the array, while 'Ant-ParAng' plots the parallactic ange for each individual antenna (their parallactic angles will differ by small amounts, because each antenna is located at a slightly different longitude, latitude, and elevation).

Row

Data row number. A row number corresponds to a unique time, baseline, and spectral window in the measurement set.

FlagRow

In some tasks, if a whole data row is flagged, then FlagRow will be set to 1 for that row. Unflagged rows have FlagRow = 0. However, note that some tasks (like plotms) may flag a row, but not set FlagRow = 1. It's probably better to plot Flag than FlagRow for most applications.

Data Column

For relevant data axes like Amp and Phase, you will have the option to plot the raw data or the calibrated data. This can be selected via a drop-down menu called 'Data Column', located directly under the drop-down menu for X or Y Axis selection. To plot raw data, select 'data'; to plot calibrated data, select 'corrected'. Note that this choice will only have an impact on your plot if you have applied a calibration table.

If you have applied a data model, you can also plot this up by selecting 'model' from the 'Data Column' menu. Finally, you can plot the differences between the calibrated data and the model by selecting 'residual' from 'Data Column'.


Last checked in CASA Version 3.0.1 (r10380).

--Laura Chomiuk 19:51, 19 February 2010 (UTC)