Merge pull request #1421 from djhoese/feature-amsr-l2

Add reader for AMSR2 Level 2 data produced by GAASP software (amsr2_l2_gaasp)
pytroll · Dec 16, 2020 · def356c · def356c
2 parents 8427877 + 8ea80f3
commit def356c
Show file tree

Hide file tree

Showing 6 changed files with 733 additions and 2 deletions.
diff --git a/doc/source/index.rst b/doc/source/index.rst
@@ -263,11 +263,14 @@ the base Satpy installation.
       - `smos_l2_wind`
       - Beta
     * - AMSR2 level 2 wind data in HDF5 format
-      - `amsr_l2`
+      - `amsr2_l2`
       - Beta
     * - GPM IMERG level 3 precipitation data in HDF5 format
       - `gpm_imerg`
       - Nominal
+    * - AMSR2 level 2 GAASP in NetCDF4 format
+      - `amsr2_l2_gaasp`
+      - Beta
 
 Indices and tables
 ==================

diff --git a/satpy/etc/enhancements/amsr2.yaml b/satpy/etc/enhancements/amsr2.yaml
@@ -0,0 +1,88 @@
+enhancements:
+  # GAASP enhancements based on PNGs at:
+  # https://www.ospo.noaa.gov/Products/atmosphere/gpds/maps.html?GPRR#gpdsMaps
+  gaasp_clw:
+    name: CLW
+    sensor: amsr2
+    operations:
+      - name: linear_stretch
+        method: !!python/name:satpy.enhancements.stretch
+        kwargs: {stretch: 'crude', min_stretch: 0.0, max_stretch: 0.5}
+  gaasp_sst:
+    name: SST
+    sensor: amsr2
+    operations:
+      - name: linear_stretch
+        method: !!python/name:satpy.enhancements.stretch
+        kwargs: {stretch: 'crude', min_stretch: -5.0, max_stretch: 35}
+  gaasp_tpw:
+    name: TPW
+    sensor: amsr2
+    operations:
+      - name: linear_stretch
+        method: !!python/name:satpy.enhancements.stretch
+        kwargs: {stretch: 'crude', min_stretch: 0.0, max_stretch: 75.0}
+  gaasp_wspd:
+    name: WSPD
+    sensor: amsr2
+    operations:
+      - name: linear_stretch
+        method: !!python/name:satpy.enhancements.stretch
+        kwargs: {stretch: 'crude', min_stretch: 0.0, max_stretch: 100.0}
+  # Snow_Cover unscaled (category product)
+  gaasp_snow_depth:
+    name: Snow_Depth
+    sensor: amsr2
+    operations:
+      - name: linear_stretch
+        method: !!python/name:satpy.enhancements.stretch
+        kwargs: {stretch: 'crude', min_stretch: 0.0, max_stretch: 150.0}
+  gaasp_swe:
+    name: SWE
+    sensor: amsr2
+    operations:
+      - name: linear_stretch
+        method: !!python/name:satpy.enhancements.stretch
+        kwargs: {stretch: 'crude', min_stretch: 0.0, max_stretch: 16.0}
+  gaasp_soil_moisture:
+    name: Soil_Moisture
+    sensor: amsr2
+    operations:
+      - name: linear_stretch
+        method: !!python/name:satpy.enhancements.stretch
+        kwargs: {stretch: 'crude', min_stretch: 0.0, max_stretch: 100.0}
+  gaasp_ice_concentration_nh:
+    name: NASA_Team_2_Ice_Concentration_NH
+    sensor: amsr2
+    operations:
+      - name: linear_stretch
+        method: !!python/name:satpy.enhancements.stretch
+        kwargs: {stretch: 'crude', min_stretch: 0.0, max_stretch: 100.0}
+  gaasp_ice_concentration_sh:
+    name: NASA_Team_2_Ice_Concentration_SH
+    sensor: amsr2
+    operations:
+      - name: linear_stretch
+        method: !!python/name:satpy.enhancements.stretch
+        kwargs: {stretch: 'crude', min_stretch: 0.0, max_stretch: 100.0}
+#  gaasp_latency_nh:
+#    name: Latency_NH
+#    sensor: amsr2
+#    operations:
+#      - name: linear_stretch
+#        method: !!python/name:satpy.enhancements.stretch
+#        kwargs: {stretch: 'crude', min_stretch: 0.0, max_stretch: 100.0}
+#  gaasp_latency_sh:
+#    name: Latency_SH
+#    sensor: amsr2
+#    operations:
+#      - name: linear_stretch
+#        method: !!python/name:satpy.enhancements.stretch
+#        kwargs: {stretch: 'crude', min_stretch: 0.0, max_stretch: 100.0}
+  gaasp_rain_rate:
+    name: Rain_Rate
+    sensor: amsr2
+    operations:
+      - name: linear_stretch
+        method: !!python/name:satpy.enhancements.stretch
+        kwargs: {stretch: 'crude', min_stretch: 0.0, max_stretch: 65.}
diff --git a/satpy/etc/readers/amsr2_l2.yaml b/satpy/etc/readers/amsr2_l2.yaml
@@ -1,6 +1,11 @@
 reader:
   name: amsr2_l2
-  description: GCOM-W1 AMSR2 instrument HDF5 reader
+  short_name: AMSR2 Level 2
+  long_name: GCOM-W1 AMSR2 Level 2 (HDF5)
+  description: >
+    HDF5 reader for GCOM-W1 AMSR2 Level 2 files from JAXA. See
+    https://suzaku.eorc.jaxa.jp/GCOM_W/data/data_w_product-2.html for more
+    information.
   reader: !!python/name:satpy.readers.yaml_reader.FileYAMLReader
   sensors: [amsr2]
 

diff --git a/satpy/etc/readers/amsr2_l2_gaasp.yaml b/satpy/etc/readers/amsr2_l2_gaasp.yaml
@@ -0,0 +1,49 @@
+reader:
+  name: amsr2_l2_gaasp
+  short_name: AMSR2 Level 2 GAASP
+  long_name: GCOM-W1 AMSR2 Level 2 GAASP (NetCDF4)
+  description: >
+    NetCDF4 reader for GCOM-W1 AMSR2 Level 2 files processed using the GAASP
+    software distributed by NOAA. See
+    https://www.star.nesdis.noaa.gov/jpss/gcom.php for more information.
+  reader: !!python/name:satpy.readers.yaml_reader.FileYAMLReader
+  sensors: [amsr2]
+
+file_types:
+  amsr2_mbt:
+    # Microwave Brightness Temperatures
+    # Ex. AMSR2-MBT_v2r2_GW1_s202008120558310_e202008120607010_c202008120637340.nc
+    file_reader: !!python/name:satpy.readers.amsr2_l2_gaasp.GAASPFileHandler
+    file_patterns: ['AMSR2-MBT_v{software_version:d}r{revision_number:d}_{platform_shortname:3s}_s{start_time:%Y%m%d%H%M%S%f}_e{end_time:%Y%m%d%H%M%S%f}_c{creation_time:%Y%m%d%H%M%S%f}.nc']
+  amsr2_precip:
+    # Ex. AMSR2-OCEAN_v2r2_GW1_s202008120558310_e202008120607010_c202008120637340.nc
+    file_reader: !!python/name:satpy.readers.amsr2_l2_gaasp.GAASPFileHandler
+    file_patterns: ['AMSR2-PRECIP_v{software_version:d}r{revision_number:d}_{platform_shortname:3s}_s{start_time:%Y%m%d%H%M%S%f}_e{end_time:%Y%m%d%H%M%S%f}_c{creation_time:%Y%m%d%H%M%S%f}.nc']
+  amsr2_ocean:
+    # Ex. AMSR2-OCEAN_v2r2_GW1_s202008120558310_e202008120607010_c202008120637340.nc
+    file_reader: !!python/name:satpy.readers.amsr2_l2_gaasp.GAASPFileHandler
+    file_patterns: ['AMSR2-OCEAN_v{software_version:d}r{revision_number:d}_{platform_shortname:3s}_s{start_time:%Y%m%d%H%M%S%f}_e{end_time:%Y%m%d%H%M%S%f}_c{creation_time:%Y%m%d%H%M%S%f}.nc']
+  amsr2_seaice_nh:
+    var_suffix: "_NH"
+    grid_epsg: 6931
+    # Ex. AMSR2-SEAICE-NH_v2r2_GW1_s202008120558310_e202008120607010_c202008120637340.nc
+    file_reader: !!python/name:satpy.readers.amsr2_l2_gaasp.GAASPGriddedFileHandler
+    file_patterns:
+    - 'AMSR2-SEAICE-NH_v{software_version:d}r{revision_number:d}_{platform_shortname:3s}_s{start_time:%Y%m%d%H%M%S%f}_e{end_time:%Y%m%d%H%M%S%f}_c{creation_time:%Y%m%d%H%M%S%f}.nc'
+  amsr2_seaice_sh:
+    var_suffix: "_SH"
+    grid_epsg: 6932
+    # Ex. AMSR2-SEAICE-SH_v2r2_GW1_s202008120558310_e202008120607010_c202008120637340.nc
+    file_reader: !!python/name:satpy.readers.amsr2_l2_gaasp.GAASPGriddedFileHandler
+    file_patterns:
+      - 'AMSR2-SEAICE-SH_v{software_version:d}r{revision_number:d}_{platform_shortname:3s}_s{start_time:%Y%m%d%H%M%S%f}_e{end_time:%Y%m%d%H%M%S%f}_c{creation_time:%Y%m%d%H%M%S%f}.nc'
+  amsr2_snow:
+    # Ex. AMSR2-SNOW_v2r2_GW1_s202008120558310_e202008120607010_c202008120637340.nc
+    file_reader: !!python/name:satpy.readers.amsr2_l2_gaasp.GAASPLowResFileHandler
+    file_patterns: ['AMSR2-SNOW_v{software_version:d}r{revision_number:d}_{platform_shortname:3s}_s{start_time:%Y%m%d%H%M%S%f}_e{end_time:%Y%m%d%H%M%S%f}_c{creation_time:%Y%m%d%H%M%S%f}.nc']
+  amsr2_soil:
+    # Ex. AMSR2-SOIL_v2r2_GW1_s202008120558310_e202008120607010_c202008120637340.nc
+    file_reader: !!python/name:satpy.readers.amsr2_l2_gaasp.GAASPLowResFileHandler
+    file_patterns: ['AMSR2-SOIL_v{software_version:d}r{revision_number:d}_{platform_shortname:3s}_s{start_time:%Y%m%d%H%M%S%f}_e{end_time:%Y%m%d%H%M%S%f}_c{creation_time:%Y%m%d%H%M%S%f}.nc']
+
+datasets: {}