From 3d54ffb52615ae6893242f27d6f436647e896bcf Mon Sep 17 00:00:00 2001 From: "Christopher H. Jordan" Date: Tue, 11 Oct 2022 16:52:59 +0800 Subject: [PATCH] Update online documentation. Corrected information on polarisations. I forgot to update this page when I found that the Stokes pols weren't quite right in the code. Also add some more details. Fix a mistake and improve the hyperdrive-solutions-format page. Fix a broken Pawsey link. --- mdbook/src/defs/cal_sols_hyp.md | 8 ++++---- mdbook/src/defs/pols.md | 18 ++++++++++++------ mdbook/src/user/di_cal/garrawarla.md | 2 +- 3 files changed, 17 insertions(+), 11 deletions(-) diff --git a/mdbook/src/defs/cal_sols_hyp.md b/mdbook/src/defs/cal_sols_hyp.md index 66ac95cd..5ecc0684 100644 --- a/mdbook/src/defs/cal_sols_hyp.md +++ b/mdbook/src/defs/cal_sols_hyp.md @@ -144,7 +144,7 @@ the observation). Note that this is not necessarily the same as the total number of *channels* in the observation; channels may be averaged before calibration, making the number of chanblocks less than the number of channels. -`Flag` indicates whether calibration was attempted (1) or not (0) on a chanblock +`Flag` indicates whether calibration was attempted (0) or not (1) on a chanblock (boolean). `Freq` is the centroid frequency of the chanblock (as a double-precision float). @@ -194,10 +194,10 @@ obsid = f[0].header["OBSID"] pfb_flavour = f[0].header["PFB"] start_times = f[0].header["S_TIMES"] -tile_names = [tile[1] for tile in f["TILES"].data] -tile_flags = [tile[2] for tile in f["TILES"].data] +tile_names = [tile["TileName"] for tile in f["TILES"].data] +tile_flags = [tile["Flag"] for tile in f["TILES"].data] -freqs = [chan[1] for chan in f["CHANBLOCKS"].data] +freqs = [chan["FREQ"] for chan in f["CHANBLOCKS"].data] cal_precisions_for_timeblock_0 = f["RESULTS"].data[0] ``` diff --git a/mdbook/src/defs/pols.md b/mdbook/src/defs/pols.md index ea778724..50fba773 100644 --- a/mdbook/src/defs/pols.md +++ b/mdbook/src/defs/pols.md @@ -6,16 +6,22 @@ polarisation refers to the East-West dipoles and the Y refers to North-South. Note that this contrasts with the IAU definition of X and Y, which is opposite to this. However, this is consistent within the MWA. -MWA visibilities are ordered XX, XY, YX, YY (using the above definitions of X -and Y). +MWA visibilities in raw data products are ordered XX, XY, YX, YY where X is +East-West and Y is North-South. `Birli` and `cotter` also write pre-processed +visibilities this way. + +`wsclean` expects its input measurement sets to be in the IAU order, meaning +that, currently, `hyperdrive` outputs are (somewhat) inappropriate for usage +with `wsclean`. We are discussing how to move forward given the history of MWA +data processing and expectations in the community. # Stokes polarisations In `hyperdrive`: -- \\( \text{XX} = \text{I} + \text{Q} \\) -- \\( \text{XY} = \text{U} + i\text{V} \\) -- \\( \text{YX} = \text{U} - i\text{V} \\) -- \\( \text{YY} = \text{I} - \text{Q} \\) +- \\( \text{XX} = \text{I} - \text{Q} \\) +- \\( \text{XY} = \text{U} - i\text{V} \\) +- \\( \text{YX} = \text{U} + i\text{V} \\) +- \\( \text{YY} = \text{I} + \text{Q} \\) where \\( \text{I} \\), \\( \text{Q} \\), \\( \text{U} \\), \\( \text{V} \\) are Stokes polarisations and \\( i \\) is the imaginary unit. diff --git a/mdbook/src/user/di_cal/garrawarla.md b/mdbook/src/user/di_cal/garrawarla.md index b8e11933..b1dab781 100644 --- a/mdbook/src/user/di_cal/garrawarla.md +++ b/mdbook/src/user/di_cal/garrawarla.md @@ -1,6 +1,6 @@ # Usage on garrawarla -[garrawarla](https://support.pawsey.org.au/documentation/display/US/Garrawarla+Documentation) +[garrawarla](https://support.pawsey.org.au/documentation/display/US/Garrawarla+User+Guide) is a supercomputer dedicated to MWA activities hosted by the Pawsey Supercomputing Centre. [This MWA wiki page](https://wiki.mwatelescope.org/pages/viewpage.action?pageId=52068764)