updated citation info

Former-commit-id: 899108e

CITATION

@@ -4,35 +4,37 @@ Park, Jeong-Won; Korosov, Anton; Babiker, Mohamed; Sandven, Stein; and Won, Joon
 
 https://doi.org/10.1109/TGRS.2017.2765248
 
-
 In BibTeX format:
 
-@ARTICLE{8126233,
-	author={J. W. Park and A. A. Korosov and M. Babiker and S. Sandven and J. S. Won},
-	journal={IEEE Transactions on Geoscience and Remote Sensing},
-	title={Efficient Thermal Noise Removal for Sentinel-1 TOPSAR Cross-Polarization Channel},
-	year={2018},
-	volume={56},
-	number={3},
-	pages={1555-1565},
-	keywords={backscatter;calibration;geophysical image processing;image denoising;radar imaging;remote sensing by radar;synthetic aperture radar;thermal noise;European Space Agency;Progressive Scans synthetic aperture radar image;Sentinel-1 TOPSAR cross-polarization channel;Sentinel-1 Terrain Observation;additive thermal noise;azimuth descalloping;calibrated noise vectors;efficient thermal noise removal;interswath power balancing;local residual noise power compensation;noise power subtraction;noise reduction;noise scaling;noise-uncorrelated gentle backscatter profile;optimal correction coefficients;reconstructed noise field;relatively narrow backscattering distribution;residual noise contributions;three-step correction process;Additives;Antennas;Azimuth;Backscatter;Noise reduction;Synthetic aperture radar;Thermal noise;Cross polarization;Sentinel-1;Terrain Observation with Progressive Scans synthetic aperture radar (TOPSAR);denoising;scalloping;thermal noise},
-	doi={10.1109/TGRS.2017.2765248},
-	ISSN={0196-2892},
-	month={March}
-}
+@ARTICLE{8126233,
+author={J. {Park} and A. A. {Korosov} and M. {Babiker} and S. {Sandven} and J. {Won}},
+journal={IEEE Transactions on Geoscience and Remote Sensing},
+title={Efficient Thermal Noise Removal for Sentinel-1 TOPSAR Cross-Polarization Channel},
+year={2018},
+volume={56},
+number={3},
+pages={1555-1565},
+keywords={backscatter;calibration;geophysical image processing;image denoising;radar imaging;remote sensing by radar;synthetic aperture radar;thermal noise;noise power subtraction;residual noise contributions;relatively narrow backscattering distribution;noise reduction;noise scaling;interswath power balancing;local residual noise power compensation;reconstructed noise field;efficient thermal noise removal;Sentinel-1 TOPSAR cross-polarization channel;Sentinel-1 Terrain Observation;Progressive Scans synthetic aperture radar image;additive thermal noise;European Space Agency;calibrated noise vectors;three-step correction process;azimuth descalloping;optimal correction coefficients;noise-uncorrelated gentle backscatter profile;Thermal noise;Azimuth;Synthetic aperture radar;Noise reduction;Antennas;Backscatter;Additives;Cross polarization;denoising;scalloping;Sentinel-1;Terrain Observation with Progressive Scans synthetic aperture radar (TOPSAR);thermal noise},
+doi={10.1109/TGRS.2017.2765248},
+ISSN={0196-2892},
+month={March},}
+
 
 Park, Jeong-Won; Won, Joong-Sun; Korosov, Anton A.; Babiker, Mohamed; and Miranda, Nuno (2019), Textural Noise Correction for Sentinel-1 TOPSAR Cross-Polarization Channel Images, IEEE Transactions on Geoscience and Remote Sensing, doi:10.1109/TGRS.2018.2889381
-https://ieeexplore.ieee.org/stamp/stamp.jsp?tp=&arnumber=8630667
+
+https://doi.org/10.1109/TGRS.2018.2889381
+
+In BibTeX format:
 
 @ARTICLE{8630667,
-author={J. {Park} and J. {Won} and A. A. {Korosov} and M. {Babiker} and N. {Miranda}},
-journal={IEEE Transactions on Geoscience and Remote Sensing},
+    author={J. {Park} and J. {Won} and A. A. {Korosov} and M. {Babiker} and N. {Miranda}},
+    journal={IEEE Transactions on Geoscience and Remote Sensing},
 title={Textural Noise Correction for Sentinel-1 TOPSAR Cross-Polarization Channel Images},
 year={2019},
-volume={},
-number={},
-pages={1-10},
-keywords={Thermal noise;Synthetic aperture radar;Signal to noise ratio;Additives;Noise reduction;Image reconstruction;Distortion;Cross polarization;image texture;Sentinel-1;synthetic aperture radar (SAR);terrain observation with progressive scans SAR (TOPSAR);thermal noise.},
+volume={57},
+number={6},
+pages={4040-4049},
+keywords={Thermal noise;Synthetic aperture radar;Signal to noise ratio;Additives;Noise reduction;Image reconstruction;Distortion;Cross polarization;image texture;Sentinel-1;synthetic aperture radar (SAR);terrain observation with progressive scans SAR (TOPSAR);thermal noise},
 doi={10.1109/TGRS.2018.2889381},
 ISSN={0196-2892},
-month={},}
+month={June},}

README.md

@@ -5,9 +5,9 @@ Thermal noise subtraction, scalloping correction, angular correction
 
 If you use Sentinel1Denoised in any academic work then you *must* cite the following paper:
 
-Park, Jeong-Won; Korosov, Anton; Babiker, Mohamed; Sandven, Stein; and Won, Joong-Sun (2018): Efficient noise removal of Sentinel-1 TOPSAR cross-polarization channel, IEEE Transactions on Geoscience and Remote Sensing, doi:10.1109/TGRS.2017.2765248
+Park, Jeong-Won; Korosov, Anton; Babiker, Mohamed; Sandven, Stein; and Won, Joong-Sun (2018): Efficient noise removal of Sentinel-1 TOPSAR cross-polarization channel, IEEE Transactions on Geoscience and Remote Sensing, 56(3), 1555-1565, doi:10.1109/TGRS.2017.2765248
 
-Park, Jeong-Won; Won, Joong-Sun; Korosov, Anton A.; Babiker, Mohamed; and Miranda, Nuno (2019), Textural Noise Correction for Sentinel-1 TOPSAR Cross-Polarization Channel Images, IEEE Transactions on Geoscience and Remote Sensing, doi:10.1109/TGRS.2018.2889381
+Park, Jeong-Won; Won, Joong-Sun; Korosov, Anton A.; Babiker, Mohamed; and Miranda, Nuno (2019), Textural Noise Correction for Sentinel-1 TOPSAR Cross-Polarization Channel Images, IEEE Transactions on Geoscience and Remote Sensing, 57(6), 4040-4049, doi:10.1109/TGRS.2018.2889381
 
 
 See the CITATION file for more information.

s1denoise/S1_TOPS_GRD_NoiseCorrection.py

@@ -9,6 +9,8 @@
 # https://sentinel.esa.int/documents/247904/1877131/Sentinel-1-Level-1-Detailed-Algorithm-Definition
 # R3: Digital Processing of Synthetic Aperture Radar Data: Algorithms and Implementation
 #     Cumming and Wong, 2005, Artech House
+# R4: Textural Noise Correction for Sentinel-1 TOPSAR Cross-Polarization Channel Images
+#     Park et al., 2019, IEEE TGRS 57(6):4040-4049. doi:10.1109/TGRS.2018.2889381
 
 
 import os, sys, glob, warnings, zipfile, requests, subprocess
@@ -1494,6 +1496,7 @@ def texturalNoiseRemoval(self, polarization, preserveTotalPower=True, windowSize
             sigma0[subswathIndexMap==1] = sswS0[sswi==1]
             sigma0[nanMask] = np.nan
         elif polarization=='HV':
+            # see the reference paper R4
             # thermal noise removal
             noiseEquivalentSigma0, sigma0 = self.thermalNoiseRemoval(
                 polarization, algorithm='NERSC', localNoisePowerCompensation=False,
@@ -1522,7 +1525,7 @@ def texturalNoiseRemoval(self, polarization, preserveTotalPower=True, windowSize
                 SD = np.sqrt( uniform_filter(sswS0**2, windowSize) - sswS0m**2 )
                 # simulate noise equivalent standard deviation (NESD)
                 simSD = noiseVarianceParameters['%s%s' % (self.obsMode, iSW)] * sswN0m * (1./SNNR)
-                # NESD compensation. See Eq.9 of the reference paper.
+                # NESD compensation. See Eq.9 of the reference paper R4.
                 sswS0 = (sswS0 - sswS0m) * (1. - simSD / SD) + sswS0m
                 sigma0[subswathIndexMap==iSW] = sswS0[sswi==iSW]
             sigma0[nanMask] = np.nan