Antenna Classification Daily Summary¶
by Josh Dillon last updated June 19, 2023
This notebook parses and summarizes the output of the file_calibration notebook to produce a report on per-antenna malfunctions on a daily basis.
Quick links:
⢠Summary of Per Antenna Issues¶
⢠Figure 1: Per File Overall Antenna Classification Summary¶
⢠Figure 2: Per Classifier Antenna Flagging Summary¶
⢠Figure 3: Array Visualization of Overall Daily Classification¶
import os
os.environ['HDF5_USE_FILE_LOCKING'] = 'FALSE'
import h5py
import hdf5plugin # REQUIRED to have the compression plugins available
import numpy as np
import pandas as pd
import glob
import os
import matplotlib.pyplot as plt
from hera_cal import io, utils
from hera_qm import ant_class
from uvtools.plot import plot_antpos, plot_antclass
%matplotlib inline
from IPython.display import display, HTML
display(HTML("<style>.container { width:100% !important; }</style>"))
_ = np.seterr(all='ignore') # get rid of red warnings
%config InlineBackend.figure_format = 'retina'
Settings¶
# Parse settings from environment
ANT_CLASS_FOLDER = os.environ.get("ANT_CLASS_FOLDER", "./")
SUM_FILE = os.environ.get("SUM_FILE", None)
# ANT_CLASS_FOLDER = "/mnt/sn1/2460330"
# SUM_FILE = "/mnt/sn1/2460330/zen.2460330.25463.sum.uvh5"
OC_SKIP_OUTRIGGERS = os.environ.get("OC_SKIP_OUTRIGGERS", "TRUE").upper() == "TRUE"
for param in ['ANT_CLASS_FOLDER', 'SUM_FILE', 'OC_SKIP_OUTRIGGERS']:
print(f"{param} = '{eval(param)}'")
ANT_CLASS_FOLDER = '/mnt/sn1/data2/2461156' SUM_FILE = '/mnt/sn1/data2/2461156/zen.2461156.42814.sum.uvh5' OC_SKIP_OUTRIGGERS = 'True'
if SUM_FILE is not None:
from astropy.time import Time, TimeDelta
utc = Time(float(SUM_FILE.split('zen.')[-1].split('.sum.uvh5')[0]), format='jd').datetime
print(f'Date: {utc.month}-{utc.day}-{utc.year}')
Date: 4-25-2026
# set thresholds for fraction of the day
overall_thresh = .1
all_zero_thresh = .1
eo_zeros_thresh = .1
xengine_diff_thresh = .1
cross_pol_thresh = .5
bad_fem_thresh = .1
high_power_thresh = .1
low_power_thresh = .1
low_corr_thresh = .1
bad_shape_thresh = .5
excess_rfi_thresh = .1
chisq_thresh = .25
Load classifications and other metadata¶
# Load csvs
csv_files = sorted(glob.glob(os.path.join(ANT_CLASS_FOLDER, '*.ant_class.csv')))
jds = [float(f.split('/')[-1].split('zen.')[-1].split('.sum')[0]) for f in csv_files]
tables = [pd.read_csv(f).dropna(axis=0, how='all') for f in csv_files]
table_cols = tables[0].columns[1::2]
class_cols = tables[0].columns[2::2]
print(f'Found {len(csv_files)} csv files starting with {csv_files[0]}')
Found 2130 csv files starting with /mnt/sn1/data2/2461156/zen.2461156.18990.sum.ant_class.csv
# parse ant_strings
ap_strs = np.array(tables[0]['Antenna'])
ants = sorted(set(int(a[:-1]) for a in ap_strs))
translator = ''.maketrans('e', 'n') | ''.maketrans('n', 'e')
# get node numbers
node_dict = {ant: 'Unknown' for ant in ants}
try:
from hera_mc import cm_hookup
hookup = cm_hookup.get_hookup('default')
for ant_name in hookup:
ant = int("".join(filter(str.isdigit, ant_name)))
if ant in node_dict:
if hookup[ant_name].get_part_from_type('node')['E<ground'] is not None:
node_dict[ant] = int(hookup[ant_name].get_part_from_type('node')['E<ground'][1:])
except:
pass
nodes = sorted(set(node_dict.values()))
def classification_array(col):
class_array = np.vstack([t[col] for t in tables])
class_array[class_array == 'good'] = 1.7
class_array[class_array == 'suspect'] = 1
class_array[class_array == 'bad'] = 0
return class_array.astype(float)
if SUM_FILE is not None:
hd = io.HERADataFastReader(SUM_FILE)
ap_tuples = [(int(ap[:-1]), {'e': 'Jee', 'n': 'Jnn'}[ap[-1]]) for ap in ap_strs]
bad_bools = np.mean(classification_array('Antenna Class') == 0, axis=0) > overall_thresh
bad_aps = [ap_tuples[i] for i in np.arange(len(ap_tuples))[bad_bools]]
suspect_bools = np.mean(classification_array('Antenna Class') == 1, axis=0) > overall_thresh
suspect_aps = [ap_tuples[i] for i in np.arange(len(ap_tuples))[suspect_bools] if ap_tuples[i] not in bad_aps]
good_aps = [ap for ap in ap_tuples if ap not in bad_aps and ap not in suspect_aps]
overall_class = ant_class.AntennaClassification(bad=bad_aps, suspect=suspect_aps, good=good_aps)
autos, _, _ = hd.read(bls=[bl for bl in hd.bls if utils.split_bl(bl)[0] == utils.split_bl(bl)[1]], read_flags=False, read_nsamples=False)
avg_unflagged_auto = {}
for pol in ['ee', 'nn']:
unflagged_autos = [autos[bl] for bl in autos if bl[2] == pol and overall_class[utils.split_bl(bl)[0]] != 'bad']
if len(unflagged_autos) > 0:
avg_unflagged_auto[pol] = np.mean(unflagged_autos, axis=(0, 1))
else:
avg_unflagged_auto[pol] = np.zeros(len(hd.freqs), dtype=complex)
Figure out and summarize per-antenna issues¶
def print_issue_summary(bad_ant_strs, title, notes='', plot=False):
'''Print report for list of bad antenna polarizations strings'''
unique_bad_antnums = [int(ap[:-1]) for ap in bad_ant_strs]
display(HTML(f'<h2>{title}: ({len(bad_ant_strs)} antpols across {len(set([ba[:-1] for ba in bad_ant_strs]))} antennas)</h2>'))
if len(notes) > 0:
display(HTML(f'<h4>{notes}</h4>'))
if len(bad_ant_strs) > 0:
print(f'All Bad Antpols: {", ".join(bad_ant_strs)}\n')
for node in nodes:
if np.any([node == node_dict[a] for a in unique_bad_antnums]):
aps = [ap for ap in bad_ant_strs if node_dict[int(ap[:-1])] == node]
whole_ants = [str(wa) for wa in set([int(ap[:-1]) for ap in aps if ap.translate(translator) in bad_ant_strs])]
single_pols = [ap for ap in aps if ap.translate(translator) not in bad_ant_strs]
print(f'Node {node}:')
print(f'\tAntpols ({len(aps)} total): {", ".join(aps)}')
print(f'\tWhole Ants ({len(whole_ants)} total): {", ".join(whole_ants)}')
print(f'\tSingle Pols ({len(single_pols)} total): {", ".join(single_pols)}')
if plot and SUM_FILE is not None:
fig, axes = plt.subplots(1, 2, figsize=(12,4), dpi=70, sharey=True, gridspec_kw={'wspace': 0})
for ax, pol in zip(axes, ['ee', 'nn']):
ax.semilogy(autos.freqs / 1e6, avg_unflagged_auto[pol], 'k--', label='Average\nUnflagged\nAuto')
for ap in aps:
ant = int(ap[:-1]), utils.comply_pol(ap[-1])
auto_bl = utils.join_bl(ant, ant)
if auto_bl[2] == pol:
ax.semilogy(autos.freqs / 1e6, np.mean(autos[auto_bl], axis=0), label=ap)
ax.legend()
ax.set_xlim([40, 299])
ax.set_title(f'{title} on Node {node} ({pol}-antennas)')
ax.set_xlabel('Frequency (MHz)')
axes[0].set_ylabel('Single File Raw Autocorrelation')
plt.tight_layout()
plt.show()
# precompute various helpful quantities
all_slopes = np.vstack([t['Autocorr Slope'] for t in tables])
median_slope = np.median(all_slopes)
bad_slopes = np.vstack([t['Autocorr Slope Class'] for t in tables]) == 'bad'
suspect_slopes = np.vstack([t['Autocorr Slope Class'] for t in tables]) == 'suspect'
bad_shapes = np.vstack([t['Autocorr Shape Class'] for t in tables]) == 'bad'
suspect_shapes = np.vstack([t['Autocorr Shape Class'] for t in tables]) == 'suspect'
all_powers = np.vstack([t['Autocorr Power'] for t in tables])
median_power = np.median(all_powers)
bad_powers = np.vstack([t['Autocorr Power Class'] for t in tables]) == 'bad'
suspect_powers = np.vstack([t['Autocorr Power Class'] for t in tables]) == 'suspect'
bad_rfi = np.vstack([t['Auto RFI RMS Class'] for t in tables]) == 'bad'
suspect_rfi = np.vstack([t['Auto RFI RMS Class'] for t in tables]) == 'suspect'
# find all zeros
all_zeros_strs = ap_strs[np.mean(np.vstack([t['Dead? Class'] for t in tables]) == 'bad', axis=0) > all_zero_thresh]
# find even/odd zeros
eo_zeros_strs = ap_strs[np.mean(np.vstack([t['Even/Odd Zeros Class'] for t in tables]) == 'bad', axis=0) > eo_zeros_thresh]
eo_zeros_strs = [ap for ap in eo_zeros_strs if ap not in all_zeros_strs]
# find cross-polarized antennas
cross_pol_strs = ap_strs[np.mean(np.vstack([t['Cross-Polarized Class'] for t in tables]) == 'bad', axis=0) > cross_pol_thresh]
cross_pol_strs = [ap for ap in cross_pol_strs if ap not in all_zeros_strs]
# find FEM power issues: must be low power, high slope, and bad or suspect in power, slope, rfi, and shape
fem_off_prod = (bad_powers + .5 * suspect_powers) * (bad_slopes + .5 * suspect_slopes)
fem_off_prod *= (bad_rfi + .5 * suspect_rfi) * (bad_shapes + .5 * suspect_shapes)
fem_off_strs = ap_strs[np.mean(fem_off_prod * (all_powers < median_power) * (all_slopes > median_slope), axis=0) > .1]
# find high power issues
high_power_strs = ap_strs[np.mean(bad_powers & (all_powers > median_power), axis=0) > high_power_thresh]
# find other low power issues
low_power_strs = ap_strs[np.mean(bad_powers & (all_powers < median_power), axis=0) > low_power_thresh]
low_power_strs = [ap for ap in low_power_strs if ap not in all_zeros_strs and ap not in fem_off_strs]
# find low correlation (but not low power)
low_corr_strs = ap_strs[np.mean(np.vstack([t['Low Correlation Class'] for t in tables]) == 'bad', axis=0) > low_corr_thresh]
low_corr_strs = [ap for ap in low_corr_strs if ap not in (set(low_power_strs) | set(all_zeros_strs) | set(fem_off_strs))]
# find bad bandpasses
bad_bandpass_strs = ap_strs[np.mean(bad_shapes, axis=0) > bad_shape_thresh]
bad_bandpass_strs = [ap for ap in bad_bandpass_strs if ap not in (set(low_power_strs) | set(all_zeros_strs) | set(high_power_strs) | set(fem_off_strs))]
# find antennas with excess RFI
excess_rfi_strs = ap_strs[np.mean(np.vstack([t['Auto RFI RMS Class'] for t in tables]) == 'bad', axis=0) > excess_rfi_thresh]
excess_rfi_strs = [ap for ap in excess_rfi_strs if ap not in (set(low_power_strs) | set(all_zeros_strs) | set(fem_off_strs) |
set(bad_bandpass_strs) | set(high_power_strs))]
# find bad x-engine diffs
xengine_diff_strs = ap_strs[np.mean(np.vstack([t['Bad Diff X-Engines Class'] for t in tables]) == 'bad', axis=0) > xengine_diff_thresh]
xengine_diff_strs = [ap for ap in xengine_diff_strs if ap not in (set(bad_bandpass_strs) | set(low_power_strs) | set(excess_rfi_strs) | set(low_corr_strs) |
set(all_zeros_strs) | set(high_power_strs) | set(fem_off_strs) | set(eo_zeros_strs))]
# find antennas with high redcal chi^2
chisq_strs = ap_strs[np.mean(np.vstack([t['Redcal chi^2 Class'] for t in tables]) == 'bad', axis=0) > chisq_thresh]
chisq_strs = [ap for ap in chisq_strs if ap not in (set(bad_bandpass_strs) | set(low_power_strs) | set(excess_rfi_strs) | set(low_corr_strs) |
set(all_zeros_strs) | set(high_power_strs) | set(fem_off_strs) | set(eo_zeros_strs) | set(xengine_diff_strs))]
if OC_SKIP_OUTRIGGERS:
chisq_strs = [ap for ap in chisq_strs if int(ap[:-1]) < 320]
# collect all results
to_print = [(all_zeros_strs, 'All-Zeros', 'These antennas have visibilities that are more than half zeros.'),
(eo_zeros_strs, 'Excess Zeros in Either Even or Odd Spectra',
'These antennas are showing evidence of packet loss or X-engine failure.', True),
(xengine_diff_strs, 'Excess Power in X-Engine Diffs',
'These antennas are showing evidence of mis-written packets in either the evens or the odds.', True),
(cross_pol_strs, 'Cross-Polarized', 'These antennas have their east and north cables swapped.'),
(fem_off_strs, 'Likely FEM Power Issue', 'These antennas have low power and anomolously high slopes.', True),
(high_power_strs, 'High Power', 'These antennas have high median power.', True),
(low_power_strs, 'Other Low Power Issues', 'These antennas have low power, but are not all-zeros and not FEM off.', True),
(low_corr_strs, 'Low Correlation, But Not Low Power', 'These antennas are low correlation, but their autocorrelation power levels look OK.'),
(bad_bandpass_strs, 'Bad Bandpass Shapes, But Not Bad Power',
'These antennas have unusual bandpass shapes, but are not all-zeros, high power, low power, or FEM off.', True),
(excess_rfi_strs, 'Excess RFI', 'These antennas have excess RMS after DPSS filtering (likely RFI), but not low or high power or a bad bandpass.', True),
(chisq_strs, 'Redcal chi^2', 'These antennas have been idenfied as not redundantly calibrating well, even after passing the above checks.')]
def print_high_level_summary():
for tp in sorted(to_print, key=lambda x: len(x[0]), reverse=True):
print(f'{len(tp[0])} antpols (on {len(set([ap[:-1] for ap in tp[0]]))} antennas) frequently flagged for {tp[1]}.')
def print_all_issue_summaries():
for tp in to_print:
print_issue_summary(*tp)
Summary of Per-Antenna Issues¶
print_high_level_summary()
100 antpols (on 50 antennas) frequently flagged for All-Zeros. 81 antpols (on 60 antennas) frequently flagged for Redcal chi^2. 76 antpols (on 47 antennas) frequently flagged for Low Correlation, But Not Low Power. 66 antpols (on 53 antennas) frequently flagged for Excess Power in X-Engine Diffs. 41 antpols (on 33 antennas) frequently flagged for High Power. 40 antpols (on 31 antennas) frequently flagged for Excess RFI. 38 antpols (on 28 antennas) frequently flagged for Likely FEM Power Issue. 16 antpols (on 10 antennas) frequently flagged for Other Low Power Issues. 9 antpols (on 8 antennas) frequently flagged for Bad Bandpass Shapes, But Not Bad Power. 6 antpols (on 3 antennas) frequently flagged for Cross-Polarized. 0 antpols (on 0 antennas) frequently flagged for Excess Zeros in Either Even or Odd Spectra.
print_all_issue_summaries()
All-Zeros: (100 antpols across 50 antennas)
These antennas have visibilities that are more than half zeros.
All Bad Antpols: 10e, 10n, 19e, 19n, 20e, 20n, 21e, 21n, 31e, 31n, 32e, 32n, 37e, 37n, 38e, 38n, 66e, 66n, 88e, 88n, 90e, 90n, 107e, 107n, 112e, 112n, 127e, 127n, 128e, 128n, 143e, 143n, 151e, 151n, 163e, 163n, 164e, 164n, 171e, 171n, 172e, 172n, 211e, 211n, 212e, 212n, 225e, 225n, 226e, 226n, 231e, 231n, 232e, 232n, 240e, 240n, 244e, 244n, 245e, 245n, 250e, 250n, 254e, 254n, 255e, 255n, 256e, 256n, 266e, 266n, 269e, 269n, 270e, 270n, 271e, 271n, 277e, 277n, 278e, 278n, 287e, 287n, 292e, 292n, 299e, 299n, 300e, 300n, 301e, 301n, 302e, 302n, 311e, 311n, 312e, 312n, 339e, 339n, 345e, 345n Node 2: Antpols (12 total): 10e, 10n, 19e, 19n, 20e, 20n, 21e, 21n, 31e, 31n, 32e, 32n Whole Ants (6 total): 32, 10, 19, 20, 21, 31 Single Pols (0 total): Node 3: Antpols (6 total): 37e, 37n, 38e, 38n, 66e, 66n Whole Ants (3 total): 66, 37, 38 Single Pols (0 total): Node 9: Antpols (6 total): 88e, 88n, 90e, 90n, 107e, 107n Whole Ants (3 total): 88, 90, 107 Single Pols (0 total): Node 10: Antpols (6 total): 112e, 112n, 127e, 127n, 128e, 128n Whole Ants (3 total): 112, 128, 127 Single Pols (0 total): Node 14: Antpols (6 total): 143e, 143n, 163e, 163n, 164e, 164n Whole Ants (3 total): 163, 164, 143 Single Pols (0 total): Node 16: Antpols (6 total): 151e, 151n, 171e, 171n, 172e, 172n Whole Ants (3 total): 171, 172, 151 Single Pols (0 total): Node 19: Antpols (6 total): 225e, 225n, 226e, 226n, 240e, 240n Whole Ants (3 total): 240, 225, 226 Single Pols (0 total): Node 20: Antpols (6 total): 211e, 211n, 244e, 244n, 245e, 245n Whole Ants (3 total): 211, 244, 245 Single Pols (0 total): Node 21: Antpols (6 total): 212e, 212n, 231e, 231n, 232e, 232n Whole Ants (3 total): 232, 212, 231 Single Pols (0 total): Node 22: Antpols (6 total): 250e, 250n, 266e, 266n, 269e, 269n Whole Ants (3 total): 250, 266, 269 Single Pols (0 total): Node 23: Antpols (12 total): 254e, 254n, 255e, 255n, 256e, 256n, 270e, 270n, 271e, 271n, 287e, 287n Whole Ants (6 total): 256, 287, 270, 271, 254, 255 Single Pols (0 total): Node 27: Antpols (12 total): 299e, 299n, 300e, 300n, 301e, 301n, 302e, 302n, 311e, 311n, 312e, 312n Whole Ants (6 total): 299, 300, 301, 302, 311, 312 Single Pols (0 total): Node 29: Antpols (10 total): 277e, 277n, 278e, 278n, 292e, 292n, 339e, 339n, 345e, 345n Whole Ants (5 total): 292, 339, 277, 278, 345 Single Pols (0 total):
Excess Zeros in Either Even or Odd Spectra: (0 antpols across 0 antennas)
These antennas are showing evidence of packet loss or X-engine failure.
Excess Power in X-Engine Diffs: (66 antpols across 53 antennas)
These antennas are showing evidence of mis-written packets in either the evens or the odds.
All Bad Antpols: 3e, 28e, 29n, 30e, 40e, 46n, 53e, 59e, 59n, 60e, 60n, 74e, 74n, 75n, 76n, 80n, 81n, 82e, 83e, 83n, 84e, 89n, 91n, 96e, 96n, 97e, 98e, 98n, 106n, 108n, 115n, 116e, 116n, 124e, 124n, 131e, 136n, 137e, 140n, 165e, 165n, 169e, 175e, 176n, 177e, 181e, 182e, 184e, 184n, 185e, 185n, 189n, 209n, 215n, 216n, 233e, 233n, 253e, 261e, 261n, 262e, 267n, 284e, 315n, 325e, 342e Node 1: Antpols (4 total): 3e, 28e, 29n, 30e Whole Ants (0 total): Single Pols (4 total): 3e, 28e, 29n, 30e
Casting complex values to real discards the imaginary part Casting complex values to real discards the imaginary part
Node 3: Antpols (1 total): 53e Whole Ants (0 total): Single Pols (1 total): 53e
Node 4: Antpols (1 total): 40e Whole Ants (0 total): Single Pols (1 total): 40e
Node 5: Antpols (9 total): 46n, 59e, 59n, 60e, 60n, 74e, 74n, 75n, 76n Whole Ants (3 total): 74, 59, 60 Single Pols (3 total): 46n, 75n, 76n
Node 7: Antpols (9 total): 81n, 82e, 83e, 83n, 98e, 98n, 116e, 116n, 137e Whole Ants (3 total): 98, 83, 116 Single Pols (3 total): 81n, 82e, 137e
Node 8: Antpols (1 total): 84e Whole Ants (0 total): Single Pols (1 total): 84e
Node 9: Antpols (7 total): 89n, 91n, 106n, 108n, 124e, 124n, 325e Whole Ants (1 total): 124 Single Pols (5 total): 89n, 91n, 106n, 108n, 325e
Node 11: Antpols (6 total): 80n, 96e, 96n, 97e, 115n, 131e Whole Ants (1 total): 96 Single Pols (4 total): 80n, 97e, 115n, 131e
Node 12: Antpols (3 total): 136n, 176n, 177e Whole Ants (0 total): Single Pols (3 total): 136n, 176n, 177e
Node 13: Antpols (3 total): 140n, 181e, 182e Whole Ants (0 total): Single Pols (3 total): 140n, 181e, 182e
Node 14: Antpols (6 total): 165e, 165n, 184e, 184n, 185e, 185n Whole Ants (3 total): 184, 185, 165 Single Pols (0 total):
Node 15: Antpols (2 total): 169e, 189n Whole Ants (0 total): Single Pols (2 total): 169e, 189n
Node 17: Antpols (4 total): 215n, 216n, 233e, 233n Whole Ants (1 total): 233 Single Pols (2 total): 215n, 216n
Node 20: Antpols (4 total): 209n, 261e, 261n, 262e Whole Ants (1 total): 261 Single Pols (2 total): 209n, 262e
Node 21: Antpols (1 total): 175e Whole Ants (0 total): Single Pols (1 total): 175e
Node 22: Antpols (2 total): 253e, 267n Whole Ants (0 total): Single Pols (2 total): 253e, 267n
Node 23: Antpols (1 total): 284e Whole Ants (0 total): Single Pols (1 total): 284e
Node 27: Antpols (1 total): 342e Whole Ants (0 total): Single Pols (1 total): 342e
Node 28: Antpols (1 total): 315n Whole Ants (0 total): Single Pols (1 total): 315n
Data has no positive values, and therefore cannot be log-scaled.
Cross-Polarized: (6 antpols across 3 antennas)
These antennas have their east and north cables swapped.
All Bad Antpols: 144e, 144n, 268e, 268n, 273e, 273n Node 14: Antpols (2 total): 144e, 144n Whole Ants (1 total): 144 Single Pols (0 total): Node 22: Antpols (2 total): 268e, 268n Whole Ants (1 total): 268 Single Pols (0 total): Node 23: Antpols (2 total): 273e, 273n Whole Ants (1 total): 273 Single Pols (0 total):
Likely FEM Power Issue: (38 antpols across 28 antennas)
These antennas have low power and anomolously high slopes.
All Bad Antpols: 4e, 5e, 28n, 44e, 44n, 46e, 101n, 126n, 147e, 159e, 170e, 196n, 200e, 238e, 285n, 317n, 320e, 320n, 322e, 323e, 323n, 326e, 326n, 329e, 329n, 332e, 332n, 333e, 333n, 340n, 343n, 344e, 344n, 346n, 347e, 347n, 348e, 348n Node 1: Antpols (3 total): 4e, 5e, 28n Whole Ants (0 total): Single Pols (3 total): 4e, 5e, 28n
Node 2: Antpols (2 total): 323e, 323n Whole Ants (1 total): 323 Single Pols (0 total):
Node 3: Antpols (2 total): 320e, 320n Whole Ants (1 total): 320 Single Pols (0 total):
Node 5: Antpols (4 total): 44e, 44n, 46e, 322e Whole Ants (1 total): 44 Single Pols (2 total): 46e, 322e
Node 8: Antpols (1 total): 101n Whole Ants (0 total): Single Pols (1 total): 101n
Node 9: Antpols (1 total): 126n Whole Ants (0 total): Single Pols (1 total): 126n
Node 12: Antpols (4 total): 329e, 329n, 333e, 333n Whole Ants (2 total): 329, 333 Single Pols (0 total):
Node 13: Antpols (1 total): 159e Whole Ants (0 total): Single Pols (1 total): 159e
Node 15: Antpols (2 total): 147e, 170e Whole Ants (0 total): Single Pols (2 total): 147e, 170e
Node 17: Antpols (1 total): 196n Whole Ants (0 total): Single Pols (1 total): 196n
Node 18: Antpols (2 total): 200e, 238e Whole Ants (0 total): Single Pols (2 total): 200e, 238e
Node 21: Antpols (5 total): 326e, 326n, 332e, 332n, 340n Whole Ants (2 total): 332, 326 Single Pols (1 total): 340n
Node 23: Antpols (1 total): 285n Whole Ants (0 total): Single Pols (1 total): 285n
Node 27: Antpols (4 total): 343n, 346n, 347e, 347n Whole Ants (1 total): 347 Single Pols (2 total): 343n, 346n
Node 28: Antpols (5 total): 317n, 344e, 344n, 348e, 348n Whole Ants (2 total): 344, 348 Single Pols (1 total): 317n
High Power: (41 antpols across 33 antennas)
These antennas have high median power.
All Bad Antpols: 8e, 8n, 30n, 89e, 99n, 103n, 118n, 120n, 122e, 153n, 167n, 176e, 178n, 183n, 187n, 198n, 208n, 215e, 218n, 224e, 224n, 243e, 257e, 273e, 273n, 282n, 284n, 286n, 290e, 290n, 291e, 313e, 313n, 314e, 314n, 318e, 318n, 336n, 342n, 349e, 349n Node 1: Antpols (1 total): 30n Whole Ants (0 total): Single Pols (1 total): 30n
Node 2: Antpols (2 total): 8e, 8n Whole Ants (1 total): 8 Single Pols (0 total):
Node 7: Antpols (2 total): 99n, 118n Whole Ants (0 total): Single Pols (2 total): 99n, 118n
Node 8: Antpols (3 total): 103n, 120n, 122e Whole Ants (0 total): Single Pols (3 total): 103n, 120n, 122e
Node 9: Antpols (1 total): 89e Whole Ants (0 total): Single Pols (1 total): 89e
Node 12: Antpols (2 total): 176e, 178n Whole Ants (0 total): Single Pols (2 total): 176e, 178n
Node 13: Antpols (1 total): 183n Whole Ants (0 total): Single Pols (1 total): 183n
Node 14: Antpols (1 total): 187n Whole Ants (0 total): Single Pols (1 total): 187n
Node 15: Antpols (1 total): 167n Whole Ants (0 total): Single Pols (1 total): 167n
Node 16: Antpols (1 total): 153n Whole Ants (0 total): Single Pols (1 total): 153n
Node 17: Antpols (3 total): 198n, 215e, 218n Whole Ants (0 total): Single Pols (3 total): 198n, 215e, 218n
Node 19: Antpols (3 total): 224e, 224n, 243e Whole Ants (1 total): 224 Single Pols (1 total): 243e
Node 20: Antpols (1 total): 208n Whole Ants (0 total): Single Pols (1 total): 208n
Node 21: Antpols (1 total): 336n Whole Ants (0 total): Single Pols (1 total): 336n
Node 22: Antpols (1 total): 282n Whole Ants (0 total): Single Pols (1 total): 282n
Node 23: Antpols (5 total): 257e, 273e, 273n, 284n, 286n Whole Ants (1 total): 273 Single Pols (3 total): 257e, 284n, 286n
Node 27: Antpols (5 total): 313e, 313n, 314e, 314n, 342n Whole Ants (2 total): 313, 314 Single Pols (1 total): 342n
Node 28: Antpols (7 total): 290e, 290n, 291e, 318e, 318n, 349e, 349n Whole Ants (3 total): 290, 349, 318 Single Pols (1 total): 291e
Other Low Power Issues: (16 antpols across 10 antennas)
These antennas have low power, but are not all-zeros and not FEM off.
All Bad Antpols: 57n, 81e, 104n, 291n, 293e, 293n, 294e, 294n, 295e, 295n, 306e, 306n, 307e, 307n, 319e, 319n Node 4: Antpols (1 total): 57n Whole Ants (0 total): Single Pols (1 total): 57n
Node 7: Antpols (1 total): 81e Whole Ants (0 total): Single Pols (1 total): 81e
Node 8: Antpols (1 total): 104n Whole Ants (0 total): Single Pols (1 total): 104n
Node 22: Antpols (2 total): 295e, 295n Whole Ants (1 total): 295 Single Pols (0 total):
Node 28: Antpols (1 total): 291n Whole Ants (0 total): Single Pols (1 total): 291n
Node 29: Antpols (10 total): 293e, 293n, 294e, 294n, 306e, 306n, 307e, 307n, 319e, 319n Whole Ants (5 total): 293, 294, 306, 307, 319 Single Pols (0 total):
Low Correlation, But Not Low Power: (76 antpols across 47 antennas)
These antennas are low correlation, but their autocorrelation power levels look OK.
All Bad Antpols: 4n, 18n, 27e, 27n, 33n, 92e, 92n, 93e, 93n, 94e, 94n, 109e, 109n, 110e, 110n, 111e, 111n, 129e, 129n, 130e, 130n, 135e, 144e, 144n, 195n, 196e, 197n, 200n, 201e, 201n, 202e, 202n, 203e, 203n, 219e, 219n, 220e, 220n, 221e, 221n, 222e, 222n, 234n, 237e, 237n, 238n, 239e, 239n, 251e, 251n, 268e, 268n, 273e, 273n, 281e, 285e, 321e, 321n, 322n, 324e, 324n, 325n, 327e, 327n, 328e, 328n, 331e, 331n, 336e, 336n, 340e, 342n, 343e, 346e, 349e, 349n Node 1: Antpols (4 total): 4n, 18n, 27e, 27n Whole Ants (1 total): 27 Single Pols (2 total): 4n, 18n Node 2: Antpols (3 total): 33n, 321e, 321n Whole Ants (1 total): 321 Single Pols (1 total): 33n Node 4: Antpols (2 total): 324e, 324n Whole Ants (1 total): 324 Single Pols (0 total): Node 5: Antpols (1 total): 322n Whole Ants (0 total): Single Pols (1 total): 322n Node 9: Antpols (1 total): 325n Whole Ants (0 total): Single Pols (1 total): 325n Node 10: Antpols (18 total): 92e, 92n, 93e, 93n, 94e, 94n, 109e, 109n, 110e, 110n, 111e, 111n, 129e, 129n, 130e, 130n, 328e, 328n Whole Ants (9 total): 129, 130, 328, 109, 110, 111, 92, 93, 94 Single Pols (0 total): Node 12: Antpols (1 total): 135e Whole Ants (0 total): Single Pols (1 total): 135e Node 14: Antpols (2 total): 144e, 144n Whole Ants (1 total): 144 Single Pols (0 total): Node 17: Antpols (3 total): 196e, 197n, 234n Whole Ants (0 total): Single Pols (3 total): 196e, 197n, 234n Node 18: Antpols (20 total): 200n, 201e, 201n, 202e, 202n, 203e, 203n, 219e, 219n, 220e, 220n, 221e, 221n, 222e, 222n, 237e, 237n, 238n, 239e, 239n Whole Ants (9 total): 201, 202, 203, 237, 239, 219, 220, 221, 222 Single Pols (2 total): 200n, 238n Node 21: Antpols (8 total): 195n, 327e, 327n, 331e, 331n, 336e, 336n, 340e Whole Ants (3 total): 336, 331, 327 Single Pols (2 total): 195n, 340e Node 22: Antpols (5 total): 251e, 251n, 268e, 268n, 281e Whole Ants (2 total): 251, 268 Single Pols (1 total): 281e Node 23: Antpols (3 total): 273e, 273n, 285e Whole Ants (1 total): 273 Single Pols (1 total): 285e Node 27: Antpols (3 total): 342n, 343e, 346e Whole Ants (0 total): Single Pols (3 total): 342n, 343e, 346e Node 28: Antpols (2 total): 349e, 349n Whole Ants (1 total): 349 Single Pols (0 total):
Bad Bandpass Shapes, But Not Bad Power: (9 antpols across 8 antennas)
These antennas have unusual bandpass shapes, but are not all-zeros, high power, low power, or FEM off.
All Bad Antpols: 4n, 27n, 71e, 71n, 87e, 135e, 142n, 161n, 180n Node 1: Antpols (2 total): 4n, 27n Whole Ants (0 total): Single Pols (2 total): 4n, 27n
Node 4: Antpols (2 total): 71e, 71n Whole Ants (1 total): 71 Single Pols (0 total):
Node 8: Antpols (1 total): 87e Whole Ants (0 total): Single Pols (1 total): 87e
Node 12: Antpols (1 total): 135e Whole Ants (0 total): Single Pols (1 total): 135e
Node 13: Antpols (3 total): 142n, 161n, 180n Whole Ants (0 total): Single Pols (3 total): 142n, 161n, 180n
Excess RFI: (40 antpols across 31 antennas)
These antennas have excess RMS after DPSS filtering (likely RFI), but not low or high power or a bad bandpass.
All Bad Antpols: 15e, 18e, 18n, 27e, 33n, 40n, 42n, 51e, 82n, 97n, 117e, 121e, 180e, 195n, 200n, 201e, 201n, 202e, 202n, 206n, 213e, 220e, 220n, 221e, 221n, 222e, 222n, 227e, 227n, 234n, 237e, 237n, 238n, 239e, 239n, 251e, 253n, 285e, 340e, 346e Node 1: Antpols (4 total): 15e, 18e, 18n, 27e Whole Ants (1 total): 18 Single Pols (2 total): 15e, 27e
Node 2: Antpols (1 total): 33n Whole Ants (0 total): Single Pols (1 total): 33n
Node 3: Antpols (1 total): 51e Whole Ants (0 total): Single Pols (1 total): 51e
Node 4: Antpols (2 total): 40n, 42n Whole Ants (0 total): Single Pols (2 total): 40n, 42n
Node 7: Antpols (2 total): 82n, 117e Whole Ants (0 total): Single Pols (2 total): 82n, 117e
Node 8: Antpols (1 total): 121e Whole Ants (0 total): Single Pols (1 total): 121e
Node 11: Antpols (1 total): 97n Whole Ants (0 total): Single Pols (1 total): 97n
Node 13: Antpols (1 total): 180e Whole Ants (0 total): Single Pols (1 total): 180e
Node 16: Antpols (1 total): 213e Whole Ants (0 total): Single Pols (1 total): 213e
Node 17: Antpols (1 total): 234n Whole Ants (0 total): Single Pols (1 total): 234n
Node 18: Antpols (16 total): 200n, 201e, 201n, 202e, 202n, 220e, 220n, 221e, 221n, 222e, 222n, 237e, 237n, 238n, 239e, 239n Whole Ants (7 total): 201, 202, 237, 239, 220, 221, 222 Single Pols (2 total): 200n, 238n
Node 19: Antpols (1 total): 206n Whole Ants (0 total): Single Pols (1 total): 206n
Node 20: Antpols (2 total): 227e, 227n Whole Ants (1 total): 227 Single Pols (0 total):
Node 21: Antpols (2 total): 195n, 340e Whole Ants (0 total): Single Pols (2 total): 195n, 340e
Node 22: Antpols (2 total): 251e, 253n Whole Ants (0 total): Single Pols (2 total): 251e, 253n
Node 23: Antpols (1 total): 285e Whole Ants (0 total): Single Pols (1 total): 285e
Node 27: Antpols (1 total): 346e Whole Ants (0 total): Single Pols (1 total): 346e
Redcal chi^2: (81 antpols across 60 antennas)
These antennas have been idenfied as not redundantly calibrating well, even after passing the above checks.
All Bad Antpols: 3n, 7e, 7n, 15n, 17n, 36e, 36n, 41e, 53n, 54e, 54n, 69e, 76e, 84n, 86e, 86n, 103e, 106e, 114e, 114n, 115e, 119e, 120e, 132e, 132n, 133n, 134e, 134n, 135n, 136e, 137n, 139e, 140e, 145n, 146e, 150n, 153e, 154e, 154n, 156e, 156n, 157e, 157n, 160e, 161e, 166e, 166n, 170n, 173e, 173n, 174e, 174n, 175n, 183e, 186e, 186n, 188e, 188n, 190e, 190n, 191e, 193e, 193n, 194e, 194n, 195e, 197e, 198e, 204e, 204n, 207n, 210n, 213n, 214e, 214n, 216e, 252e, 252n, 282e, 316e, 317e Node 1: Antpols (3 total): 3n, 15n, 17n Whole Ants (0 total): Single Pols (3 total): 3n, 15n, 17n Node 2: Antpols (2 total): 7e, 7n Whole Ants (1 total): 7 Single Pols (0 total): Node 3: Antpols (3 total): 36e, 36n, 53n Whole Ants (1 total): 36 Single Pols (1 total): 53n Node 4: Antpols (4 total): 41e, 54e, 54n, 69e Whole Ants (1 total): 54 Single Pols (2 total): 41e, 69e Node 5: Antpols (1 total): 76e Whole Ants (0 total): Single Pols (1 total): 76e Node 7: Antpols (2 total): 119e, 137n Whole Ants (0 total): Single Pols (2 total): 119e, 137n Node 8: Antpols (5 total): 84n, 86e, 86n, 103e, 120e Whole Ants (1 total): 86 Single Pols (3 total): 84n, 103e, 120e Node 9: Antpols (1 total): 106e Whole Ants (0 total): Single Pols (1 total): 106e Node 11: Antpols (8 total): 114e, 114n, 115e, 132e, 132n, 133n, 134e, 134n Whole Ants (3 total): 114, 132, 134 Single Pols (2 total): 115e, 133n Node 12: Antpols (6 total): 135n, 136e, 156e, 156n, 157e, 157n Whole Ants (2 total): 156, 157 Single Pols (2 total): 135n, 136e Node 13: Antpols (5 total): 139e, 140e, 160e, 161e, 183e Whole Ants (0 total): Single Pols (5 total): 139e, 140e, 160e, 161e, 183e Node 14: Antpols (6 total): 145n, 146e, 166e, 166n, 186e, 186n Whole Ants (2 total): 186, 166 Single Pols (2 total): 145n, 146e Node 15: Antpols (7 total): 150n, 170n, 188e, 188n, 190e, 190n, 191e Whole Ants (2 total): 188, 190 Single Pols (3 total): 150n, 170n, 191e Node 16: Antpols (12 total): 153e, 154e, 154n, 173e, 173n, 174e, 174n, 193e, 193n, 194e, 194n, 213n Whole Ants (5 total): 193, 194, 173, 174, 154 Single Pols (2 total): 153e, 213n Node 17: Antpols (3 total): 197e, 198e, 216e Whole Ants (0 total): Single Pols (3 total): 197e, 198e, 216e Node 19: Antpols (3 total): 204e, 204n, 207n Whole Ants (1 total): 204 Single Pols (1 total): 207n Node 20: Antpols (1 total): 210n Whole Ants (0 total): Single Pols (1 total): 210n Node 21: Antpols (4 total): 175n, 195e, 214e, 214n Whole Ants (1 total): 214 Single Pols (2 total): 175n, 195e Node 22: Antpols (3 total): 252e, 252n, 282e Whole Ants (1 total): 252 Single Pols (1 total): 282e Node 28: Antpols (2 total): 316e, 317e Whole Ants (0 total): Single Pols (2 total): 316e, 317e
Full-Day Visualizations¶
def classification_plot(col):
class_array = classification_array(col)
plt.figure(figsize=(12, len(ants) / 10), dpi=100)
plt.imshow(class_array.T, aspect='auto', interpolation='none', cmap='RdYlGn', vmin=0, vmax=2,
extent=[jds[0] - np.floor(jds[0]), jds[-1] - np.floor(jds[0]), len(ants), 0])
plt.xlabel(f'JD - {int(jds[0])}')
plt.yticks(ticks=np.arange(.5, len(ants)+.5), labels=[ant for ant in ants], fontsize=6)
plt.ylabel('Antenna Number (East First, Then North)')
plt.gca().tick_params(right=True, top=True, labelright=True, labeltop=True)
plt.tight_layout()
plt.title(f'{col}: Green is "good", Yellow is "suspect", Red is "bad"')
Figure 1: Per-File Overall Antenna Classification Summary¶
This "big green board" shows the overall (i.e. after redundant calibration) classification of antennas on a per-file basis. This is useful for looking at time-dependent effects across the array. While only antenna numbers are labeled, both polarizations are shown, first East then North going down, above and below the antenna's tick mark.
classification_plot('Antenna Class')
# compute flag fractions for all classifiers and antennas
frac_flagged = []
for col in class_cols[1:]:
class_array = np.vstack([t[col] for t in tables])
class_array[class_array == 'good'] = False
class_array[class_array == 'suspect'] = False
class_array[class_array == 'bad'] = True
frac_flagged.append(np.sum(class_array, axis=0))
def plot_flag_frac_all_classifiers():
ticks = []
for i, col in enumerate(list(class_cols[1:])):
ticks.append(f'{col} ({np.nanmean(np.array(frac_flagged).astype(float)[i]) / len(csv_files):.2%})')
plt.figure(figsize=(8, len(ants) / 10), dpi=100)
plt.imshow(np.array(frac_flagged).astype(float).T, aspect='auto', interpolation='none', cmap='viridis')
plt.xticks(ticks=np.arange(len(list(class_cols[1:]))), labels=ticks, rotation=-45, ha='left')
plt.yticks(ticks=np.arange(.5, len(ap_strs)+.5, 2), labels=[ant for ant in ants], fontsize=6)
plt.ylabel('Antenna Number (East First, Then North)')
plt.gca().tick_params(right=True, labelright=True,)
ax2 = plt.gca().twiny()
ax2.set_xticks(ticks=np.arange(len(list(class_cols[1:]))), labels=ticks, rotation=45, ha='left')
plt.colorbar(ax=plt.gca(), label=f'Number of Files Flagged Out of {len(csv_files)}', aspect=50)
plt.tight_layout()
Figure 2: Per-Classifier Antenna Flagging Summary¶
This plot shows the fraction of files flagged for each reason for each antenna. It's useful for seeing which problems are transitory and which ones are more common. Note that not all flags are independent and in particular redcal chi^2 takes an OR of other classifications as an input. Also note that only antenna numbers are labeled, both polarizations are shown, first East then North going down, above and below the antenna's tick mark.
plot_flag_frac_all_classifiers()
def array_class_plot():
fig, axes = plt.subplots(1, 2, figsize=(14, 6), dpi=100, gridspec_kw={'width_ratios': [2, 1]})
if len([ant for ant in hd.data_ants if ant < 320]) > 0:
plot_antclass(hd.antpos, overall_class, ax=axes[0], ants=[ant for ant in hd.data_ants if ant < 320], legend=False,
title=f'HERA Core: Overall Flagging Based on {overall_thresh:.1%} Daily Threshold')
if len([ant for ant in hd.data_ants if ant >= 320]) > 0:
plot_antclass(hd.antpos, overall_class, ax=axes[1], ants=[ant for ant in hd.data_ants if ant >= 320], radius=50, title='Outriggers')
Figure 3: Array Visualization of Overall Daily Classification¶
Overall classification of antenna-polarizations shown on the array layout. If any antenna is marked bad for any reason more than the threshold (default 10%), it is marked bad here. Likewise, if any antenna is marked suspect for more than 10% of the night (but not bad), it's suspect here.
if SUM_FILE is not None: array_class_plot()
WARNING:matplotlib.axes._base:Ignoring fixed x limits to fulfill fixed data aspect with adjustable data limits.
WARNING:matplotlib.axes._base:Ignoring fixed x limits to fulfill fixed data aspect with adjustable data limits.
WARNING:matplotlib.axes._base:Ignoring fixed y limits to fulfill fixed data aspect with adjustable data limits.
WARNING:matplotlib.axes._base:Ignoring fixed x limits to fulfill fixed data aspect with adjustable data limits.
WARNING:matplotlib.axes._base:Ignoring fixed x limits to fulfill fixed data aspect with adjustable data limits.
for repo in ['pyuvdata', 'hera_cal', 'hera_qm', 'hera_notebook_templates']:
exec(f'from {repo} import __version__')
print(f'{repo}: {__version__}')
pyuvdata: 3.2.5.dev1+g5a985ae31 hera_cal: 3.7.7.dev97+gc2668d3f7 hera_qm: 2.2.1.dev4+gf6d02113b
hera_notebook_templates: 0.0.1.dev1313+g92178a09c