Source
434
434
<description>
435
435
Apply parallactic angle correction
436
436
Default: False
437
437
If True, apply the parallactic angle correction
438
438
(required for polarization calibration)
439
439
</description>
440
440
<value>False</value>
441
441
</param>
442
442
443
443
<constraints>
444
-
<<<<<<< HEAD
445
444
<when param="selectdata">
446
-
=======
447
-
<when param="selectdata">
448
-
>>>>>>> master
449
445
<equals value="True" type="bool">
450
446
<default param="timerange"><value type="string"/></default>
451
447
<default param="antenna"><value type="string"/></default>
452
448
<default param="scan"><value type="string"/></default>
453
449
<default param="observation"><value type="string"/></default>
454
450
<default param="msselect"><value type="string"/></default>
455
451
</equals>
456
452
<equals value="False" type="bool"/>
457
453
</when>
458
454
<when param="docallib">
459
455
<equals value="False" type="bool">
460
-
<<<<<<< HEAD
461
456
<default param="gaintable"><value type="stringVec"/></default>
462
457
<default param="gainfield"><value type="stringVec"/></default>
463
458
<default param="interp"><value type="stringVec"/></default>
464
459
<default param="spwmap"><value type="intVec"/></default>
465
-
=======
466
-
<default param="gaintable"><value type="stringArray"/></default>
467
-
<default param="gainfield"><value type="stringArray"/></default>
468
-
<default param="interp"><value type="stringArray"/></default>
469
-
<default param="spwmap"><value type="intArray"/></default>
470
-
>>>>>>> master
471
460
</equals>
472
461
<equals value="True" type="bool">
473
462
<default param="callib"><value type="string"/></default>
474
463
</equals>
475
464
</when>
476
465
</constraints>
477
466
</input>
478
467
479
468
<example>
480
469
For more information, see the task pages of gaincal in CASA Docs:
481
470
482
-
<<<<<<< HEAD
483
471
https://casa.nrao.edu/casadocs/
484
472
minsnr -- Reject solutions below this SNR
485
473
default: 3.0
486
474
</example>
487
475
488
476
<returns>void</returns></task>
489
477
</casaxml>
490
-
=======
491
-
Previous calibrations (egs, bandpass, opacity, parallactic angle) can
492
-
be applied on the fly. At present with dual-polarized data, both
493
-
polarizations must be unflagged for any solution to be obtained.
494
-
495
-
Keyword arguments:
496
-
vis -- Name of input visibility file
497
-
default: none; example: vis='ngc5921.ms'
498
-
caltable -- Name of output fringefit calibration table
499
-
default: none; example: caltable='ngc5921.fringe'
500
-
501
-
--- Data Selection (see help par.selectdata for more detailed information)
502
-
503
-
field -- Select field using field id(s) or field name(s).
504
-
['go listobs' to obtain the list id's or names]
505
-
default: ''=all fields
506
-
If field string is a non-negative integer, it is assumed a
507
-
field index, otherwise, it is assumed a field name
508
-
field='0~2'; field ids 0,1,2
509
-
field='0,4,5~7'; field ids 0,4,5,6,7
510
-
field='3C286,3C295'; field named 3C286 and 3C295
511
-
field = '3,4C*'; field id 3, all names starting with 4C
512
-
DON'T FORGET TO INCLUDE THE FLUX DENSITY CALIBRATOR IF YOU HAVE ONE
513
-
spw -- Select spectral window/channels
514
-
type 'help par.selection' for more examples.
515
-
spw='0~2,4'; spectral windows 0,1,2,4 (all channels)
516
-
spw='<2'; spectral windows less than 2 (i.e. 0,1)
517
-
spw='0:5~61'; spw 0, channels 5 to 61, INCLUSIVE
518
-
spw='*:5~61'; all spw with channels 5 to 61
519
-
spw='0,10,3:3~45'; spw 0,10 all channels, spw 3, channels 3 to 45.
520
-
spw='0~2:2~6'; spw 0,1,2 with channels 2 through 6 in each.
521
-
spw='0:0~10;15~60'; spectral window 0 with channels 0-10,15-60
522
-
NOTE ';' to separate channel selections
523
-
spw='0:0~10^2,1:20~30^5'; spw 0, channels 0,2,4,6,8,10,
524
-
spw 1, channels 20,25,30
525
-
intent -- Select observing intent
526
-
default: '' (no selection by intent)
527
-
intent='*FRINGEFIT*' (selects data labelled with
528
-
FRINGEFIT intent)
529
-
selectdata -- Other data selection parameters
530
-
default: True
531
-
532
-
Must set selectdata=True to use the following selections:
533
-
534
-
timerange -- Select data based on time range:
535
-
default = '' (all); examples,
536
-
timerange = 'YYYY/MM/DD/hh:mm:ss~YYYY/MM/DD/hh:mm:ss'
537
-
Note: if YYYY/MM/DD is missing date defaults to first day in data set
538
-
timerange='09:14:0~09:54:0' picks 40 min on first day
539
-
timerange= '25:00:00~27:30:00' picks 1 hr to 3 hr 30min on NEXT day
540
-
timerange='09:44:00' pick data within one integration of time
541
-
timerange='>10:24:00' data after this time
542
-
uvrange -- Select data within uvrange (default units meters)
543
-
default: '' (all); example:
544
-
uvrange='0~1000klambda'; uvrange from 0-1000 kilo-lambda
545
-
uvrange='>4klambda';uvranges greater than 4 kilo lambda
546
-
antenna -- Select data based on antenna/baseline
547
-
default: '' (all)
548
-
If antenna string is a non-negative integer, it is assumed an
549
-
antenna index, otherwise, it is assumed as an antenna name
550
-
antenna='5&6'; baseline between antenna index 5 and index 6.
551
-
antenna='VA05&VA06'; baseline between VLA antenna 5 and 6.
552
-
antenna='5&6;7&8'; baselines with indices 5-6 and 7-8
553
-
antenna='5'; all baselines with antenna index 5
554
-
antenna='05'; all baselines with antenna number 05 (VLA old name)
555
-
antenna='5,6,10'; all baselines with antennas 5,6,10 index numbers
556
-
scan -- Scan number range.
557
-
Check 'go listobs' to insure the scan numbers are in order.
558
-
observation -- Observation ID(s).
559
-
default: '' = all
560
-
example: '0~2,4'
561
-
msselect -- Optional complex data selection (ignore for now)
562
-
563
-
solint -- Solution interval (units optional)
564
-
default: 'inf' (~infinite, up to boundaries controlled by combine);
565
-
Options: 'inf' (~infinite),
566
-
'int' (per integration)
567
-
any float or integer value with or without units
568
-
examples: solint='1min'; solint='60s'; solint=60 --> 1 minute
569
-
solint='0s'; solint=0; solint='int' --> per integration
570
-
solint-'-1s'; solint='inf' --> ~infinite, up to boundaries
571
-
interacts with combine
572
-
combine -- Data axes to combine for solving
573
-
default: '' --> solutions will break at obs, scan, field, and spw
574
-
boundaries
575
-
Options: '','obs','scan','spw',field', or any comma-separated
576
-
combination in a single string
577
-
For gaintype='K', if combine includes 'spw', multi-band
578
-
delays will be determined; otherwise, (per-spw)
579
-
single-band delays will be determined.
580
-
example: combine='scan,spw' --> extend solutions over scan boundaries
581
-
(up to the solint), and combine spws for solving
582
-
refant -- Reference antenna name(s); a prioritized list may be
583
-
specified for solving and for applying solutions. For
584
-
solving, the first reference antenna associated with
585
-
unflagged data is used for the solution.
586
-
default: '' => no refant applied
587
-
example: refant='4' (antenna with index 4)
588
-
refant='VA04' (VLA antenna #4)
589
-
refant='EA02,EA23,EA13' (EVLA antenna EA02, use
590
-
EA23 and EA13 as alternates if/when EA02
591
-
drops out)
592
-
Use taskname=listobs for antenna listing
593
-
minsnr -- Reject solutions below this SNR
594
-
default: 3.0
595
-
solnorm -- Normalize average solution amps to 1.0 after solution (G, T only)
596
-
default: False (no normalization)
597
-
append -- Append solutions to the (existing) table. Appended solutions
598
-
must be derived from the same MS as the existing
599
-
caltable, and solution spws must have the same
600
-
meta-info (according to spw selection and solint)
601
-
or be non-overlapping.
602
-
default: False; overwrite existing table or make new table
603
-
zerorates -- Write a solution table with delay-rates zeroed, for
604
-
the case of "manual phase calibration".
605
-
default: False
606
-
607
-
globalsolve -- Refine fringefit solutions with global least-squares solver.
608
-
default: False
609
-
610
-
611
-
delaywindow -- Constrain FFT delay search to a window
612
-
ratewindow -- Constrain FFT rate search to a window
613
-
614
-
--- Other calibrations to apply on the fly before determining
615
-
fringe fit solution
616
-
617
-
docallib -- Control means of specifying the caltables:
618
-
default: False ==> Use gaintable,gainfield,interp,spwmap,calwt
619
-
If True, specify a file containing cal library in callib
620
-
callib -- If docallib=True, specify a file containing cal
621
-
library directives
622
-
623
-
gaintable -- Gain calibration table(s) to apply
624
-
default: '' (none);
625
-
examples: gaintable='ngc5921.gcal'
626
-
gaintable=['ngc5921.ampcal','ngc5921.phcal']
627
-
gainfield -- Select a subset of calibrators from gaintable(s) to apply
628
-
default:'' ==> all sources in table;
629
-
'nearest' ==> nearest (on sky) available field in table
630
-
otherwise, same syntax as field
631
-
example: gainfield='0~2,5' means use fields 0,1,2,5 from gaintable
632
-
gainfield=['0~3','4~6'] means use field 0 through 3
633
-
from first gain file, field 4 through 6 for second.
634
-
interp -- Interpolation type (in time[,freq]) to use for each gaintable.
635
-
When frequency interpolation is relevant (B, Df, Xf),
636
-
separate time-dependent and freq-dependent interp
637
-
types with a comma (freq _after_ the comma).
638
-
Specifications for frequency are ignored when the
639
-
calibration table has no channel-dependence.
640
-
Time-dependent interp options ending in 'PD' enable a
641
-
"phase delay" correction per spw for non-channel-dependent
642
-
calibration types.
643
-
For multi-obsId datasets, 'perobs' can be appended to
644
-
the time-dependent interpolation specification to
645
-
enforce obsId boundaries when interpolating in time.
646
-
default: '' --> 'linear,linear' for all gaintable(s)
647
-
example: interp='nearest' (in time, freq-dep will be
648
-
linear, if relevant)
649
-
interp='linear,cubic' (linear in time, cubic
650
-
in freq)
651
-
interp='linearperobs,spline' (linear in time
652
-
per obsId,
653
-
spline in freq)
654
-
interp=',spline' (spline in freq; linear in
655
-
time by default)
656
-
interp=['nearest,spline','linear'] (for multiple gaintables)
657
-
Options: Time: 'nearest', 'linear'
658
-
Freq: 'nearest', 'linear', 'cubic', 'spline'
659
-
spwmap -- Spectral windows combinations to form for gaintable(s)
660
-
default: [] (apply solutions from each spw to that spw only)
661
-
Example: spwmap=[0,0,1,1] means apply the caltable solutions
662
-
from spw = 0 to the spw 0,1 and spw 1 to spw 2,3.
663
-
spwmap=[[0,0,1,1],[0,1,0,1]]
664
-
parang -- If True, apply the parallactic angle correction (required
665
-
for polarization calibration)
666
-
default: False
667
-
</example>
668
-
669
-
</task>
670
-
</casaxml>
671
-
>>>>>>> master