Recent changes to MFSWeighting

MFSWeighting modified by André Offringa

André Offringa — Tue, 14 Jul 2020 10:22:39 -0000

--- v13
+++ v14
@@ -1,6 +1,6 @@
-WSClean has a special weighting mode called 'MF weighting', which is turned on with the '`-mf-weighting`' or '`-join-channels`' parameter. This is a weighting mode that changes the way in which spectral imaging (making image cubes) is performed. MFS weighting is therefore only relevant when using a '`-channels-out`' parameter larger than 1. That parameter is explained on the '[Making image cubes](MakingImageCubes)' page.
+WSClean has a special weighting mode called 'MF weighting', which is turned on with the '`-mf-weighting`' or '`-join-channels`' parameter. This is a weighting mode that changes the way in which spectral imaging (making image cubes) is performed. MF weighting is therefore only relevant when using a '`-channels-out`' parameter larger than 1. That parameter is explained on the '[Making image cubes](MakingImageCubes)' page.

-MF weighting improves the frequency-integrated ("MFS") images. **When one is doing science using the spectral images instead, MF weighting is discouraged**! This is because MF weighting adjusts the weight of individual frequencies to make the integrated image look best. This however can create artificial spectral structure when the individual frequency images are inspected / used in science.
+MF weighting improves the frequency-integrated (multi-frequency, "MF") images. **For science using the spectral images, MF weighting is discouraged**. This is because MF weighting adjusts the weight of individual frequencies to make the integrated image look best. This however can create artificial spectral structure when the individual frequency images are inspected / used in science. It is still possible to use `-join-channels` for those science cases, but make sure MF weighting is turned off with `-no-mf-weighting`.

 If MF weighting is turned on, the weights of all imaged channels will be gridded on one grid. When turned off, the weights of each imaged channel are gridded on a separate grid.

MFSWeighting modified by André Offringa

André Offringa — Fri, 30 Aug 2019 07:40:48 -0000

--- v12
+++ v13
@@ -1,17 +1,19 @@
-WSClean has a special weighting mode called 'MFS weighting', which is turned on with the '`-mfs-weighting`' parameter. This is a weighting mode that changes the way in which spectral imaging (making image cubes) is performed. MFS weighting is therefore only relevant when using a '`-channels-out`' parameter larger than 1. That parameter is explained on the '[Making image cubes](MakingImageCubes)' page.
+WSClean has a special weighting mode called 'MF weighting', which is turned on with the '`-mf-weighting`' or '`-join-channels`' parameter. This is a weighting mode that changes the way in which spectral imaging (making image cubes) is performed. MFS weighting is therefore only relevant when using a '`-channels-out`' parameter larger than 1. That parameter is explained on the '[Making image cubes](MakingImageCubes)' page.

-If MFS weighting is turned on, the weights of all imaged channels will be gridded on one grid. When turned off, the weights of each imaged channel are gridded on a separate grid.
+MF weighting improves the frequency-integrated ("MFS") images. **When one is doing science using the spectral images instead, MF weighting is discouraged**! This is because MF weighting adjusts the weight of individual frequencies to make the integrated image look best. This however can create artificial spectral structure when the individual frequency images are inspected / used in science.

-Turning MFS weighting on can be useful for example to get uniformly weighted image cubes with the MWA. When not using MFS weighting, a single MWA channel creates such a fine track in uv space, that different tracks almost never share the same uv pixel, and hence all the weights tend to be closer to '1' in non-MFS, but uniform, weighting mode. The effect is that each image is weighted more towards natural weighting compared to MFS imaging. In this case, when all images are summed later on, the integrated image does not look like a uniform image, because each channel has been weighted separately.
+If MF weighting is turned on, the weights of all imaged channels will be gridded on one grid. When turned off, the weights of each imaged channel are gridded on a separate grid.

-So, this is resolved by using MFS weighting. In MFS weighting, all weights are gridded on the same grid, and hence the sum of the image cube equals a MFS image with the same weighting.
+Turning MF weighting on can be useful for example to get uniformly weighted image cubes with the MWA. When not using MF weighting, a single MWA channel creates such a fine track in uv space, that different tracks almost never share the same uv pixel, and hence all the weights tend to be closer to '1' in non-MF, but uniform, weighting mode. The effect is that each image is weighted more towards natural weighting compared to MFS imaging. In this case, when all images are summed later on, the integrated image does not look like a uniform image, because each channel has been weighted separately.

-Note that MFS weighting is off by default, but using the '`-join-channels`' automatically enables MFS weighting.
+So, this is resolved by using MF weighting. In MF weighting, all weights are gridded on the same grid, and hence the sum of the image cube equals a MF image with the same weighting.

-Example of using MFS weighting to make a briggs -1 image cube:
+Note that MF weighting is off by default, but using the '`-join-channels`' automatically enables MFS weighting.
+
+Example of using MF weighting to make a briggs -1 image cube:

     :::bash
-    wsclean -channels-out 768 -mfs-weighting -weight briggs -1 myobservation.ms
+    wsclean -channels-out 768 -mf-weighting -weight briggs -1 myobservation.ms

 A related option is the [weight rank filter](WeightRankFilter) that is enabled with the '`-weighting-rank-filter`' option. The weight rank filter prevents outlier weights that might increase the noise of the image.

MFSWeighting modified by André Offringa

André Offringa — Wed, 02 Jan 2019 10:09:16 -0000

--- v11
+++ v12
@@ -6,7 +6,7 @@

 So, this is resolved by using MFS weighting. In MFS weighting, all weights are gridded on the same grid, and hence the sum of the image cube equals a MFS image with the same weighting.

-Note that MFS weighting is off by default, but using the '`-join-channels`' turns on MFS weighting.
+Note that MFS weighting is off by default, but using the '`-join-channels`' automatically enables MFS weighting.

 Example of using MFS weighting to make a briggs -1 image cube:

MFSWeighting modified by André Offringa

André Offringa — Wed, 02 Jan 2019 10:07:50 -0000

--- v10
+++ v11
@@ -1,6 +1,6 @@
 WSClean has a special weighting mode called 'MFS weighting', which is turned on with the '`-mfs-weighting`' parameter. This is a weighting mode that changes the way in which spectral imaging (making image cubes) is performed. MFS weighting is therefore only relevant when using a '`-channels-out`' parameter larger than 1. That parameter is explained on the '[Making image cubes](MakingImageCubes)' page.

-If MFS weighting is turned on, the weights of all imaged channels will be gridded on one grid. When turned off, each imaged channel is gridded on a separate grid.
+If MFS weighting is turned on, the weights of all imaged channels will be gridded on one grid. When turned off, the weights of each imaged channel are gridded on a separate grid.

 Turning MFS weighting on can be useful for example to get uniformly weighted image cubes with the MWA. When not using MFS weighting, a single MWA channel creates such a fine track in uv space, that different tracks almost never share the same uv pixel, and hence all the weights tend to be closer to '1' in non-MFS, but uniform, weighting mode. The effect is that each image is weighted more towards natural weighting compared to MFS imaging. In this case, when all images are summed later on, the integrated image does not look like a uniform image, because each channel has been weighted separately.

MFSWeighting modified by André Offringa

André Offringa — Fri, 01 Dec 2017 12:11:05 -0000

--- v9
+++ v10
@@ -1,4 +1,4 @@
-WSClean has a special weighting mode called 'MFS weighting', which is turned on with the '`-mfsweighting`' parameter. This is a weighting mode that changes the way in which spectral imaging (making image cubes) is performed. MFS weighting is therefore only relevant when using a '`-channelsout`' parameter larger than 1. That parameter is explained on the '[Making image cubes](MakingImageCubes)' page.
+WSClean has a special weighting mode called 'MFS weighting', which is turned on with the '`-mfs-weighting`' parameter. This is a weighting mode that changes the way in which spectral imaging (making image cubes) is performed. MFS weighting is therefore only relevant when using a '`-channels-out`' parameter larger than 1. That parameter is explained on the '[Making image cubes](MakingImageCubes)' page.

 If MFS weighting is turned on, the weights of all imaged channels will be gridded on one grid. When turned off, each imaged channel is gridded on a separate grid.

@@ -6,12 +6,12 @@

 So, this is resolved by using MFS weighting. In MFS weighting, all weights are gridded on the same grid, and hence the sum of the image cube equals a MFS image with the same weighting.

-Note that MFS weighting is off by default, but using the '`-joinchannels`' turns on MFS weighting.
+Note that MFS weighting is off by default, but using the '`-join-channels`' turns on MFS weighting.

 Example of using MFS weighting to make a briggs -1 image cube:

     :::bash
-    wsclean -channelsout 768 -mfsweighting -weight briggs -1 myobservation.ms
+    wsclean -channels-out 768 -mfs-weighting -weight briggs -1 myobservation.ms

 A related option is the [weight rank filter](WeightRankFilter) that is enabled with the '`-weighting-rank-filter`' option. The weight rank filter prevents outlier weights that might increase the noise of the image.

MFSWeighting modified by André Offringa

André Offringa — Sat, 21 Jan 2017 10:06:07 -0000

--- v8
+++ v9
@@ -14,3 +14,5 @@
     wsclean -channelsout 768 -mfsweighting -weight briggs -1 myobservation.ms

 A related option is the [weight rank filter](WeightRankFilter) that is enabled with the '`-weighting-rank-filter`' option. The weight rank filter prevents outlier weights that might increase the noise of the image.
+
+**Next chapter: [Weight rank filter](WeightRankFilter)**

MFSWeighting modified by André Offringa

André Offringa — Fri, 20 May 2016 07:38:16 -0000

--- v7
+++ v8
@@ -6,7 +6,7 @@

 So, this is resolved by using MFS weighting. In MFS weighting, all weights are gridded on the same grid, and hence the sum of the image cube equals a MFS image with the same weighting.

-Note that MFS weighting is off by default, but the '`-joinchannels`' turns on MFS weighting.
+Note that MFS weighting is off by default, but using the '`-joinchannels`' turns on MFS weighting.

 Example of using MFS weighting to make a briggs -1 image cube:

MFSWeighting modified by André Offringa

André Offringa — Fri, 20 May 2016 07:36:51 -0000

--- v6
+++ v7
@@ -13,4 +13,4 @@
     :::bash
     wsclean -channelsout 768 -mfsweighting -weight briggs -1 myobservation.ms

-TODO describe/link to '`-weighting-rank-filter`', which is relevant here too.
+A related option is the [weight rank filter](WeightRankFilter) that is enabled with the '`-weighting-rank-filter`' option. The weight rank filter prevents outlier weights that might increase the noise of the image.

MFSWeighting modified by André Offringa

André Offringa — Fri, 20 May 2016 07:33:34 -0000

--- v5
+++ v6
@@ -1,4 +1,4 @@
-WSClean has a special weighting mode called 'MFS weighting', which is turned on with the '-mfsweighting' parameter. This is a weighting mode that changes the way in which spectral imaging (making image cubes) is performed. MFS weighting is therefore only relevant when using a '-channelsout' parameter larger than 1. That parameter is explained on the '[Making image cubes](MakingImageCubes)' page.
+WSClean has a special weighting mode called 'MFS weighting', which is turned on with the '`-mfsweighting`' parameter. This is a weighting mode that changes the way in which spectral imaging (making image cubes) is performed. MFS weighting is therefore only relevant when using a '`-channelsout`' parameter larger than 1. That parameter is explained on the '[Making image cubes](MakingImageCubes)' page.

 If MFS weighting is turned on, the weights of all imaged channels will be gridded on one grid. When turned off, each imaged channel is gridded on a separate grid.

@@ -6,11 +6,11 @@

 So, this is resolved by using MFS weighting. In MFS weighting, all weights are gridded on the same grid, and hence the sum of the image cube equals a MFS image with the same weighting.

-Note that MFS weighting is off by default, but the "-joinchannels" turns on MFS weighting.
+Note that MFS weighting is off by default, but the '`-joinchannels`' turns on MFS weighting.

 Example of using MFS weighting to make a briggs -1 image cube:

     :::bash
     wsclean -channelsout 768 -mfsweighting -weight briggs -1 myobservation.ms

-TODO describe/link to "-weighting-rank-filter", which is relevant here too.
+TODO describe/link to '`-weighting-rank-filter`', which is relevant here too.

MFSWeighting modified by André Offringa

André Offringa — Tue, 04 Aug 2015 10:07:57 -0000

--- v4
+++ v5
@@ -12,3 +12,5 @@

     :::bash
     wsclean -channelsout 768 -mfsweighting -weight briggs -1 myobservation.ms
+
+TODO describe/link to "-weighting-rank-filter", which is relevant here too.