Usage for timeOnSource
Return to directory of Todd's CASA extensions
For up-to-date documentation on this function, please see the casaguide page for this function!
It is useful to know how much time you spent integrating on source, not including the atmospheric calibration, pointing calibration and sideband ratio calibration. This function computes this value for all fields or each specified field. It then searches for the inter-subscan latency, corrects
for it, and prints revised values. It returns an extensive dictionary which includes an item ('minutes_on_science') for the total time spent on science targets, i.e. those scans with intent = OBSERVE_TARGET.
See also timeOnSourceSD.
CASA <2>: au.timeOnSource(help=True)
Usage: timeOnSource(ms,field='',includeLatency=False,verbose=True,help=False)
Returns a list of durations (in sec) on the fields specified, attempting
to detect and account for inter-subscan latency, unless includeLatency=T
in which case it will return the total time from start to end of scan.
Fields can be specified by a single name or ID, or a list of IDs: '2,3,4'.
Here is an example of running it with minimal output to the screen.
CASA <12>: mydict = au.timeOnSource('X3c1.ms',verbose=F)
Ignoring spectral window [0, 25, 26, 27, 28, 29, 30, 31, 32, 33] because it is WVR related
Total time = 71.3 min, science time = 48.4 min
Latency removed: Total time = 60.0 min, science time = 40.1 min
Here is an example of running it with full output to the screen:
CASA <13>: mydict = au.timeOnSource('X3c1.ms')
Running ValueMapping... (this may take a minute)
Ignoring spectral window [0, 25, 26, 27, 28, 29, 30, 31, 32, 33] because it is WVR related
Non-CalAtmosphere, Non-CalPointing, Non-CalSideband scans:
Total time on scan (including inter-subscan latency):
Source 0 = Field 0 = 3c279: 65.7 sec = 1.1 min (1 scan: [5], 2 subscans)
Source 1 = Field 1 = Titan: 66.8 sec = 1.1 min (1 scan: [4], 2 subscans)
Source 2 = Field 2 = TW Hya: 2903.0 sec = 48.4 min (7 scans: [9, 13, 18, 22, 27, 31, 36], 80 subscans)
Source 3 = Field 3 = J1147-382=QSO: 262.7 sec = 4.4 min (4 scans: [8, 16, 25, 34], 8 subscans)
Source 4 = Field 4 = J1037-295=QSO: 981.5 sec = 16.4 min (7 scans: [11, 15, 20, 24, 29, 33, 38], 28 subscans)
Total time = 71.3 min, science time = 48.4 min
My attempt to detect and account for inter-subscan latency:
Source 0 = Field 0 = 3c279: 58.7 sec = 1.0 min (1 scan: [5], 2 subscans)
Source 1 = Field 1 = Titan: 59.9 sec = 1.0 min (1 scan: [4], 2 subscans)
Source 2 = Field 2 = TW Hya: 2407.2 sec = 40.1 min (7 scans: [9, 13, 18, 22, 27, 31, 36], 80 subscans)
Source 3 = Field 3 = J1147-382=QSO: 234.9 sec = 3.9 min (4 scans: [8, 16, 25, 34], 8 subscans)
Source 4 = Field 4 = J1037-295=QSO: 839.2 sec = 14.0 min (7 scans: [11, 15, 20, 24, 29, 33, 38], 28 subscans)
Latency removed: Total time = 60.0 min, science time = 40.1 min
Here is the dictionary returned:
{0: {'field_ids': [0],
'minutes_on_source': 0.97860000928242996,
'minutes_on_source_with_latency': 1.0944000085194905,
'num_of_fields': 1,
'num_of_scans': 1,
'num_of_subscans': [2],
'scans': [5],
'source_name': '3c279'},
1: {'field_ids': [1],
'minutes_on_source': 0.99779998461405439,
'minutes_on_source_with_latency': 1.1135999997456869,
'num_of_fields': 1,
'num_of_scans': 1,
'num_of_subscans': [2],
'scans': [4],
'source_name': 'Titan'},
2: {'field_ids': [2],
'minutes_on_source': 40.119599183400474,
'minutes_on_source_with_latency': 48.384000015258792,
'num_of_fields': 1,
'num_of_scans': 7,
'num_of_subscans': [1, 16, 13, 16, 13, 16, 5],
'scans': [9, 13, 18, 22, 27, 31, 36],
'source_name': 'TW Hya'},
3: {'field_ids': [3],
'minutes_on_source': 3.9143999894460042,
'minutes_on_source_with_latency': 4.3776000022888182,
'num_of_fields': 1,
'num_of_scans': 4,
'num_of_subscans': [2, 2, 2, 2],
'scans': [8, 16, 25, 34],
'source_name': 'J1147-382=QSO'},
4: {'field_ids': [4],
'minutes_on_source': 13.985999981562296,
'minutes_on_source_with_latency': 16.358400026957195,
'num_of_fields': 1,
'num_of_scans': 7,
'num_of_subscans': [4, 4, 4, 4, 4, 4, 4],
'scans': [11, 15, 20, 24, 29, 33, 38],
'source_name': 'J1037-295=QSO'},
'minutes_on_science': 40.119599183400474,
'minutes_on_science_with_latency': 48.384000015258792,
'num_of_sources': 5,
'source_ids': [0, 1, 2, 3, 4]}
--
ToddHunter - 2011-10-24