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
Topic revision: r5 - 2013-09-30, ToddHunter
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding NRAO Public Wiki? Send feedback