Use Birli 0.5.1 for PFB correction.

This commit adds two new PFB flavours (including the "Jake Jones"
flavour which should be the best) and replaces the PFB correction code
with Birli's correction code.

Cargo.toml

@@ -44,7 +44,7 @@ cuda-static = ["mwa_hyperdrive_common/cuda-static"]
 all-static = ["erfa-static", "hdf5-static", "cfitsio-static", "cuda-static"]
 
 [dependencies]
-birli = { version = "0.5.0", default_features = false }
+birli = { version = "0.5.1", default_features = false }
 console = "0.15.0"
 crossbeam-channel = "0.5.0"
 crossbeam-utils = "0.8.7"

src/calibrate/params/mod.rs

@@ -337,6 +337,8 @@ impl CalibrateParams {
                 info!("Using {} gpubox files", gpuboxes.len());
                 match pfb_flavour {
                     PfbFlavour::None => info!("Not doing any PFB correction"),
+                    PfbFlavour::Jake => info!("Using 'Jake Jones' PFB gains"),
+                    PfbFlavour::Cotter2014 => info!("Using 'Cotter 2014' PFB gains"),
                     PfbFlavour::Empirical => info!("Using 'RTS empirical' PFB gains"),
                     PfbFlavour::Levine => info!("Using 'Alan Levine' PFB gains"),
                 }

src/data_formats/error.rs

@@ -14,6 +14,13 @@ pub enum ReadInputDataError {
     #[error("The supplied mwaf files don't have flags for timestep {timestep} (GPS time {gps})")]
     MwafFlagsMissingForTimestep { timestep: usize, gps: f64 },
 
+    #[error("The specified PFB gains ('{pfb_flavour}') cannot be applied by Birli,\nprobably because this observation's frequency is incompatible ({freq_res_hz} Hz):\n{birli_error}")]
+    PfbRefuse {
+        pfb_flavour: String,
+        freq_res_hz: f64,
+        birli_error: BirliError,
+    },
+
     #[error("Output {array_type} array did not have expected {expected_len} elements on axis {axis_num}")]
     BadArraySize {
         array_type: &'static str,

src/data_formats/raw/error.rs

@@ -43,6 +43,9 @@ pub enum RawReadError {
     #[error("The raw MWA data contains no timesteps")]
     NoTimesteps,
 
+    #[error("Attempted to read in MWA VCS data; this is unsupported")]
+    Vcs,
+
     #[error("{0}")]
     MwafMerge(#[from] MwafMergeError),