import os
os.environ['HDF5_USE_FILE_LOCKING'] = 'FALSE'
import h5py
import hdf5plugin
import matplotlib
import matplotlib.pyplot as plt
from matplotlib.ticker import FormatStrFormatter
import matplotlib.patches as mpatches
import matplotlib.gridspec as gridspec
import numpy as np
from pyuvdata import UVCal, UVData
import sys
import glob
import uvtools as uvt
from astropy.time import Time
from astropy.coordinates import EarthLocation, AltAz, Angle
from astropy.coordinates import SkyCoord as sc
import pandas
import warnings
import copy
from hera_notebook_templates import utils
import hera_qm
from hera_mc import cm_hookup
import importlib
from scipy import stats
from IPython.display import display, HTML
#warnings.filterwarnings('ignore')
%matplotlib inline
%config InlineBackend.figure_format = 'retina'
display(HTML("<style>.container { width:100% !important; }</style>"))
#get data location
data_path = os.environ['DATA_PATH']
print(f'DATA_PATH = "{data_path}"')
statuses = os.environ['APRIORI_STATUSES']
print(f'APRIORI_STATUSES = {statuses}')
JD = os.environ['JULIANDATE']
print(f'JULIANDATE = {JD}')
utc = Time(JD, format='jd').datetime
print(f'Date = {utc.month}-{utc.day}-{utc.year}')
DATA_PATH = "/mnt/sn1/data2/2460538" APRIORI_STATUSES = dish_maintenance,dish_ok,RF_maintenance,RF_ok,digital_ok,digital_maintenance,calibration_maintenance,calibration_triage,calibration_ok JULIANDATE = 2460538 Date = 8-15-2024
# Load in data
HHfiles, difffiles, HHautos, diffautos, uvdx, uvdy = utils.load_data(data_path,JD)
uvd = UVData()
unread = True
readInd=0
while unread and readInd<len(HHautos):
try:
uvd.read(HHautos[readInd])
unread = False
except:
readInd += 1
continue
use_ants = utils.get_use_ants(uvd,statuses,JD)
print(f'This day contains {len(use_ants)} antennas of the given status category.')
uvd.read(HHautos[::10], skip_bad_files=True, antenna_nums = use_ants)
lsts = uvd.lst_array
uvdx.select(antenna_nums=use_ants)
uvdy.select(antenna_nums=use_ants)
1571 sum files found between JDs 2460538.16922 and 2460538.52042 1571 diff files found between JDs 2460538.16922 and 2460538.52042 1571 sum auto files found between JDs 2460538.16922 and 2460538.52042 1571 diff auto files found between JDs 2460538.16922 and 2460538.52042
This day contains 252 antennas of the given status category.
Sky Coverage Map¶
Map of the sky (made using the Haslam 408MHz map). The RA/DEC range covered by this night of observation is shaded based on a 12 degree FWHM of the beam. Horizontal dashed lines represent the stripe that HERA can observe, while the shaded region is what was observed on this night. Vertical lines represent the beginning and ending LSTs of this observation. Selected sources are labelled, sources included are those in the GLEAM 4Jy catalog with a flux >10.9 Jy. Note that the map is clipped at the northern horizon.
sources = utils.gather_source_list()
utils.plot_sky_map(uvd,dec_pad=55,ra_pad=55,clip=False,sources=sources)
LST Coverage¶
Shows the LSTs (in hours) and JDs for which data is collected. Green represents data, red means no data.
utils.plot_lst_coverage(uvd)
Autocorrelations for a single file¶
This plot shows autocorrelations for one timestamp of each antenna that is active and each polarization. For each node, antennas are ordered by SNAP number, and within that by SNAP input number. The antenna number label color corresponds to the a priori status of that antenna.
### plot autos
utils.plot_autos(uvdx, uvdy)
--------------------------------------------------------------------------- ValueError Traceback (most recent call last) Cell In[6], line 2 1 ### plot autos ----> 2 utils.plot_autos(uvdx, uvdy) File ~/mambaforge/envs/RTP/lib/python3.12/site-packages/hera_notebook_templates/utils.py:540, in plot_autos(uvdx, uvdy) 537 xlim = (np.min(freqs), np.max(freqs)) 538 ylim = (55, 85) --> 540 fig, axes = plt.subplots(Yside, Nside, figsize=(16,Yside*3)) 542 ptitle = 1.92/(Yside*3) 543 fig.suptitle("JD = {0}, time = {1} UTC".format(jd, utc), fontsize=10,y=1+ptitle) File ~/mambaforge/envs/RTP/lib/python3.12/site-packages/matplotlib/pyplot.py:1614, in subplots(nrows, ncols, sharex, sharey, squeeze, width_ratios, height_ratios, subplot_kw, gridspec_kw, **fig_kw) 1470 """ 1471 Create a figure and a set of subplots. 1472 (...) 1611 1612 """ 1613 fig = figure(**fig_kw) -> 1614 axs = fig.subplots(nrows=nrows, ncols=ncols, sharex=sharex, sharey=sharey, 1615 squeeze=squeeze, subplot_kw=subplot_kw, 1616 gridspec_kw=gridspec_kw, height_ratios=height_ratios, 1617 width_ratios=width_ratios) 1618 return fig, axs File ~/mambaforge/envs/RTP/lib/python3.12/site-packages/matplotlib/figure.py:930, in FigureBase.subplots(self, nrows, ncols, sharex, sharey, squeeze, width_ratios, height_ratios, subplot_kw, gridspec_kw) 926 raise ValueError("'width_ratios' must not be defined both as " 927 "parameter and as key in 'gridspec_kw'") 928 gridspec_kw['width_ratios'] = width_ratios --> 930 gs = self.add_gridspec(nrows, ncols, figure=self, **gridspec_kw) 931 axs = gs.subplots(sharex=sharex, sharey=sharey, squeeze=squeeze, 932 subplot_kw=subplot_kw) 933 return axs File ~/mambaforge/envs/RTP/lib/python3.12/site-packages/matplotlib/figure.py:1542, in FigureBase.add_gridspec(self, nrows, ncols, **kwargs) 1503 """ 1504 Return a `.GridSpec` that has this figure as a parent. This allows 1505 complex layout of Axes in the figure. (...) 1538 1539 """ 1541 _ = kwargs.pop('figure', None) # pop in case user has added this... -> 1542 gs = GridSpec(nrows=nrows, ncols=ncols, figure=self, **kwargs) 1543 return gs File ~/mambaforge/envs/RTP/lib/python3.12/site-packages/matplotlib/gridspec.py:378, in GridSpec.__init__(self, nrows, ncols, figure, left, bottom, right, top, wspace, hspace, width_ratios, height_ratios) 375 self.hspace = hspace 376 self.figure = figure --> 378 super().__init__(nrows, ncols, 379 width_ratios=width_ratios, 380 height_ratios=height_ratios) File ~/mambaforge/envs/RTP/lib/python3.12/site-packages/matplotlib/gridspec.py:48, in GridSpecBase.__init__(self, nrows, ncols, height_ratios, width_ratios) 33 """ 34 Parameters 35 ---------- (...) 45 If not given, all rows will have the same height. 46 """ 47 if not isinstance(nrows, Integral) or nrows <= 0: ---> 48 raise ValueError( 49 f"Number of rows must be a positive integer, not {nrows!r}") 50 if not isinstance(ncols, Integral) or ncols <= 0: 51 raise ValueError( 52 f"Number of columns must be a positive integer, not {ncols!r}") ValueError: Number of rows must be a positive integer, not 0
<Figure size 1600x0 with 0 Axes>
Waterfalls of Autocorrelation Amplitudes for each Antenna and Each polarization¶
These plots show autocorrelation waterfalls of each antenna that is active and whose status qualifies for this notebook. For each node, antennas are ordered by SNAP number, and within that by SNAP input number. The antenna number label color corresponds to the a priori status of that antenna.
utils.plot_wfs(uvd, pol = 0)
--------------------------------------------------------------------------- ZeroDivisionError Traceback (most recent call last) Cell In[7], line 1 ----> 1 utils.plot_wfs(uvd, pol = 0) File ~/mambaforge/envs/RTP/lib/python3.12/site-packages/hera_notebook_templates/utils.py:608, in plot_wfs(uvd, pol, mean_sub, save, jd, auto_scale, vmin, vmax) 605 utc = Time(jd, format='jd').datetime 607 h = cm_active.get_active(at_date=jd, float_format="jd") --> 608 ptitle = 1.92/(Yside*3) 609 fig, axes = plt.subplots(Yside, Nside, figsize=(16,Yside*3)) 610 if pol == 0: ZeroDivisionError: float division by zero
utils.plot_wfs(uvd, pol = 1)
--------------------------------------------------------------------------- ZeroDivisionError Traceback (most recent call last) Cell In[8], line 1 ----> 1 utils.plot_wfs(uvd, pol = 1) File ~/mambaforge/envs/RTP/lib/python3.12/site-packages/hera_notebook_templates/utils.py:608, in plot_wfs(uvd, pol, mean_sub, save, jd, auto_scale, vmin, vmax) 605 utc = Time(jd, format='jd').datetime 607 h = cm_active.get_active(at_date=jd, float_format="jd") --> 608 ptitle = 1.92/(Yside*3) 609 fig, axes = plt.subplots(Yside, Nside, figsize=(16,Yside*3)) 610 if pol == 0: ZeroDivisionError: float division by zero
Correlation Metrics¶
The first plot shows the correlation metric (described below) for a set of baseline types, as calculated at several times throughout the night. It is expected that longer baselines (darker color) will exhibit lower values than the short baselines.
The matrices show the phase correlation between antennas. Using the even and odd visibilities, each pixel is calculated as (even/abs(even)) * (conj(odd)/abs(odd)), and then averaged across time and frequency. If the phases are noise-like, this value will average down to zero. If the antennas are well correlated, the phases should not be noise-like, and this value should average to 1. The lines denoting node boundaries are intended to help confirm that inter-node correlations are functioning - if they aren't, this plot will appear block-diagonal.
This metric has shown to be LST locked - when comparing to other nights, be sure to compare for the same LST. It is expected that some LSTs will look much better or worse than others.
Note: Within each node, the order of antennas is determined by snap, and within that by snap input number.
badAnts = []
badAnts = utils.plotNodeAveragedSummary(uvd,HHfiles,JD,use_ants,mat_pols=['xx','yy','xy','yx'])
WARNING:matplotlib.legend:No artists with labels found to put in legend. Note that artists whose label start with an underscore are ignored when legend() is called with no argument.
Visibility amplitude spectra for a set of redundant baselines, labeled by inter vs. intranode baselines. The red and blue should exhibit the same bandpass shape - if the red are consistently different from the blue, this indicates an issue with internode correlations.
Note: antennas that were identified as bad by the correlation matrix have been removed from this plot.
utils.plotVisibilitySpectra(HHfiles[len(HHfiles)//2+1], JD, use_ants, badAnts=[])
--------------------------------------------------------------------------- TypeError Traceback (most recent call last) Cell In[10], line 1 ----> 1 utils.plotVisibilitySpectra(HHfiles[len(HHfiles)//2+1], JD, use_ants, badAnts=[]) File ~/mambaforge/envs/RTP/lib/python3.12/site-packages/hera_notebook_templates/utils.py:908, in plotVisibilitySpectra(file, jd, use_ants, badAnts, pols) 906 if (ant1 in use_ants and ant2 in use_ants) or use_all == True: 907 key1 = get_ant_key(x,ant1) --> 908 n1 = x[key1].get_part_from_type('node')['E<ground'][1:] 909 key2 = get_ant_key(x,ant2) 910 n2 = x[key2].get_part_from_type('node')['E<ground'][1:] TypeError: 'NoneType' object is not subscriptable
<Figure size 640x480 with 0 Axes>
Even and Odd File Checks¶
A waterfall showing the ratio between the even and odd visibilities. The purpose of this is to highlight xengine failures, which will cause this value to fall to zero or go to infinity. If things are working properly, this value should be stable at 1. The boundaries between different x-engines are shown by the vertical white lines.
if len(HHautos) == len(diffautos):
uvd_diff = UVData()
uvd_diff.read(diffautos[::10], skip_bad_files=True, antenna_nums=use_ants)
rat = utils.plotEvenOddWaterfalls(uvd,uvd_diff)
else:
uvd_diff = UVData()
use_diffs = [f for f in diffautos if '%s/zen.%s.%s.sum.autos.uvh5' % (data_path,f.split('.')[1],f.split('.')[2]) in HHautos[::10]]
uvd_diff.read(use_diffs, skip_bad_files=True, antenna_nums = use_ants)
uvd_sum = uvd.select(times=np.unique(uvd_diff.time_array),inplace=False)
rat = utils.plotEvenOddWaterfalls(uvd_sum,uvd_diff)
Crossed Antenna Check¶
These are differences between different panels of the correlation matrices shown above (see panel titles for specifics). Antennas showing as consistently blue are ones which are correlating stronger in the cross pols than in the auto pols, indicating that the antenna polarizations are likely crossed.
crossedAnts = utils.plotNodeAveragedSummary(uvd,HHfiles,JD,use_ants,mat_pols=['xx','yy','xy','yx'],plotRatios=True,
plotSummary=False)
Antenna Positions¶
Antennas outlined in black here have been identified by the correlation matrix as bad antennas. Antennas with a colorful outline correspond to their status as identified by ant_metrics (see above plot). Faded antennas are those not meeting the apriori status requirement for this notebook run. Gold stars are node box locations.
uvd1 = UVData()
uvd1.read(HHfiles[readInd], skip_bad_files=True)
utils.plot_antenna_positions(uvd1, badAnts=badAnts,use_ants=use_ants)
WARNING:matplotlib.legend:No artists with labels found to put in legend. Note that artists whose label start with an underscore are ignored when legend() is called with no argument.
Observer Inspection Plots¶
Antennas of status digital_OK or better that are flagged as bad by any of the above metrics are plotted here so observers can inspect their failures in more detail. Additionally, a 'good' template has been used to identify outliers. The upper line plots are averages over the whole observation, and the lower line plots are slices of a single time in the middle of the observation. These plots are recommended diagnostics for demoting antennas to lower statuses or reporting issues. If the plots below look OK, check other plots in notebook to hunt why the antenna was flagged. NOTE: The colorbar/power scales in these plots are NOT locked between antennas OR polarizations so that the detail will be visible on all plots. Be sure to check for reasonable power levels, as this may be the reason the antenna was flagged for inspection.
d, tempAnts = utils.flag_by_template(uvd,HHautos,JD,use_ants=use_ants,pols=['XX','YY'],plotMap=False)
inspectAnts = utils.plot_inspect_ants(uvd,JD,badAnts=badAnts,use_ants=use_ants,
tempAnts=tempAnts,crossedAnts=crossedAnts)
Antennas that require further inspection are: []
Mean-Subtracted Waterfalls¶
Here the mean value in each frequency bin has been subtracted out. This effectively subtracts out the bandpass shape, making time variations more visible.
utils.plot_wfs(uvd,0,mean_sub=True,jd=JD)
utils.plot_wfs(uvd,1,mean_sub=True,jd=JD)
--------------------------------------------------------------------------- ZeroDivisionError Traceback (most recent call last) Cell In[16], line 1 ----> 1 utils.plot_wfs(uvd,0,mean_sub=True,jd=JD) 2 utils.plot_wfs(uvd,1,mean_sub=True,jd=JD) File ~/mambaforge/envs/RTP/lib/python3.12/site-packages/hera_notebook_templates/utils.py:608, in plot_wfs(uvd, pol, mean_sub, save, jd, auto_scale, vmin, vmax) 605 utc = Time(jd, format='jd').datetime 607 h = cm_active.get_active(at_date=jd, float_format="jd") --> 608 ptitle = 1.92/(Yside*3) 609 fig, axes = plt.subplots(Yside, Nside, figsize=(16,Yside*3)) 610 if pol == 0: ZeroDivisionError: float division by zero