Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add the capability for assimilating GOES-ABI radiance data #1983

Merged
merged 109 commits into from
Jan 17, 2024

Conversation

liujake
Copy link
Contributor

@liujake liujake commented Jan 16, 2024

TYPE: new feature

KEYWORDS: ABI, cloud detection, all-sky obs error model

SOURCE: JJ Guerrette (NCAR/MMM, now at tomorrow.io), Deqin Li (Liaoning Meteorological Bureau of CMA), Jake Liu (NCAR/MMM)

DESCRIPTION OF CHANGES:
This PR addes the assimilation of GOES-16/17 ABI's 3 water vapor channels' radiance data. This includes reading of ABI's full-disk, CONUS, and meso1&2 data files, superobbing and thinning of ABI data, IR-based cloud detection scheme as part of quality control, and all-sky obs error model. Cloud detection scheme should be the same as for AHI in principle, but the actual code implementation is not the same. No attempt made to make ABI's cloud detection code consistent with AHI's when bringing the code originally developed back in 2019-2020 into the latest develop branch. Some technical information is provided below for the use of this new capability.

  1. Read ABI files:
    Raw netcdf ABI data files (one file for one channel) need to be listed in 4 list files:
    'file_list_GOES-16-ABI_C' for CONUS scan files
    'file_list_GOES-16-ABI_F' for full-disk scan files (e.g., OR_ABI-L1b-RadF-M6C08_G16_s20191211200263_e20191211209571_c20191211210021.nc)
    'file_list_GOES-16-ABI_M1' for meso1 scan files
    'file_list_GOES-16-ABI_M2' for meso2 scan files

ABI data reading code will automatically determine which file(s) to read in matching ABI file's time and analysis time.

  1. Cloud detection scheme needs to read in a terrain file OR_ABI-TERR_G16.nc or OR_ABI-TERR_G17.nc for GOES-16 ABI or GOES-17 ABI.

  2. Related namelist settings:

&wrfvar4
 use_goesabiobs  = true, ! read goes-16 and goes-17 ABI data
/
&wrfvar14
 rtminit_nsensor= 1,
 rtminit_platform=  4, ! goes
 rtminit_satid=  16,      ! goes-16
 rtminit_sensor=  44,  ! abi
 thinning= true,
 thinning_mesh= 30.0,
 qc_rad=true,
 write_iv_rad_ascii=true,
 write_oa_rad_ascii=true,
 rtm_option= 2,
 crtm_cloud= false,
 only_sea_rad=false,
 use_varbc=true,
 varbc_nobsmin=500,
 crtm_irland_coef= "IGBP.IRland.EmisCoeff.bin",
 use_clddet_zz=true, ! IR-based cloud detection
 abi_superob_halfwidth=3, ! this will do supperobbing with 7x7 pixels
 /

See also AHI DA related PRs:
#1139
#1173
#1774

LIST OF MODIFIED FILES: 41
M Registry/registry.var
M var/build/depend.txt
M var/da/da_define_structures/da_define_structures.f90
M var/da/da_monitor/da_rad_diags.f90
M var/da/da_radiance/da_allocate_rad_iv.inc
M var/da/da_radiance/da_deallocate_radiance.inc
M var/da/da_radiance/da_get_innov_vector_crtm.inc
M var/da/da_radiance/da_get_innov_vector_rttov.inc
A var/da/da_radiance/da_get_sat_angles.inc
A var/da/da_radiance/da_get_sat_angles_1d.inc
A var/da/da_radiance/da_get_solar_angles.inc
A var/da/da_radiance/da_get_solar_angles_1d.inc
M var/da/da_radiance/da_initialize_rad_iv.inc
A var/da/da_radiance/da_qc_goesabi.inc
M var/da/da_radiance/da_qc_rad.inc
M var/da/da_radiance/da_radiance.f90
M var/da/da_radiance/da_radiance1.f90
M var/da/da_radiance/da_radiance_init.inc
A var/da/da_radiance/da_read_obs_ncgoesabi.inc
M var/da/da_radiance/da_rttov.f90
M var/da/da_radiance/da_setup_radiance_structures.inc
M var/da/da_radiance/da_write_iv_rad_ascii.inc
M var/da/da_radiance/da_write_oa_rad_ascii.inc
M var/da/da_radiance/module_radiance.f90
M var/da/da_setup_structures/da_setup_obs_structures.inc
M var/da/da_setup_structures/da_setup_structures.f90
A var/da/da_tools/da_llxy_1d.inc
A var/da/da_tools/da_llxy_default_1d.inc
A var/da/da_tools/da_llxy_global_1d.inc
A var/da/da_tools/da_llxy_kma_global_1d.inc
A var/da/da_tools/da_llxy_latlon_1d.inc
A var/da/da_tools/da_llxy_lc_1d.inc
A var/da/da_tools/da_llxy_merc_1d.inc
A var/da/da_tools/da_llxy_ps_1d.inc
A var/da/da_tools/da_llxy_rotated_latlon_1d.inc
A var/da/da_tools/da_llxy_wrf_1d.inc
A var/da/da_tools/da_togrid_1d.inc
M var/da/da_tools/da_tools.f90
M var/run/VARBC.in
A var/run/radiance_info/goes-16-abi.info
A var/run/radiance_info/goes-17-abi.info

TESTS CONDUCTED:

  1. WRFDA regression test passed on Derecho.
  2. Clear-sky ABI DA is tested with a full-disk data file.
  3. the Jenkins tests all passing.

RELEASE NOTE: Add the capability for assimilating GOES-ABI radiance data

Jonathan Guerrette and others added 30 commits April 4, 2018 17:35
- code has been compiled with RTTOV12.1
- preliminary 3D-Var test w/ WRFDA arctic tutorial case
   + minimization appears successful
   + results differ from RTTOV11.3 due to RTTOV updates
   + quantitative analysis of results has not been performed
 Changes to be committed:
	modified:   compile
	modified:   var/da/da_radiance/da_get_innov_vector_rttov.inc
	modified:   var/da/da_radiance/da_radiance.f90
	modified:   var/da/da_radiance/da_rttov.f90
	modified:   var/da/da_radiance/da_rttov_ad.inc
	modified:   var/da/da_radiance/da_rttov_direct.inc
	modified:   var/da/da_radiance/da_rttov_init.inc
	modified:   var/da/da_radiance/da_rttov_k.inc
	modified:   var/da/da_radiance/da_rttov_tl.inc
	modified:   var/da/da_radiance/module_radiance.f90
Still need to add/fix/improve:
+ Clear-sky
   - Cloud detection/mask
   - QC
   - Bias Correction
+ All-sky
   - Cloud Scattering in RTTOV and CRTM
   - Symmetric Error
   - QC
   - Bias Correction

 Changes to be committed:

	modified:   ../../Registry/registry.var
	modified:   da_radiance/da_get_satzen.inc
	new file:   da_radiance/da_qc_goesabi.inc
	modified:   da_radiance/da_qc_rad.inc
	modified:   da_radiance/da_radiance.f90
	modified:   da_radiance/da_radiance1.f90
	modified:   da_radiance/da_radiance_init.inc
	new file:   da_radiance/da_read_obs_ncgoesabi.inc
	modified:   da_radiance/da_read_obs_ncgoesimg.inc
	modified:   da_radiance/da_setup_radiance_structures.inc
	modified:   da_setup_structures/da_setup_obs_structures.inc
	modified:   da_setup_structures/da_setup_structures.f90
	modified:   da_tools/da_get_julian_time.inc
	new file:   ../run/radiance_info/goes-16-abi.info
	new file:   ../run/radiance_info/goes-17-abi.info
…/distribution

 Changes to be committed:
	modified:   var/build/depend.txt
	modified:   var/da/da_radiance/da_radiance.f90
	modified:   var/da/da_radiance/da_read_obs_ncgoesabi.inc
+moved obs locations for each view to this_obslist linked list
+modified da_llxy to allow for determination of "outside" cheaply for large data sets and processor counts
Attempting to balance load by performing round-robin calculation of lat, lon, etc. across more than num_procs tasks
For example 10*num_procs tasks, each of which takes a variable amount of time.  Each process will complete a different number of tasks,
the result of which is assigned to a linked list member.  That linked list member includes fields of lat, lon, etc.
+"outside" test with new da_outside subroutine to generate domainmask_1d and patchmask_1d
+lat, lon calculation
+zenith angle calculation

 Changes to be committed:
	modified:   var/build/depend.txt
	new file:   var/da/da_radiance/da_get_satzen_1d.inc
	modified:   var/da/da_radiance/da_radiance.f90
	modified:   var/da/da_radiance/da_read_obs_ncgoesabi.inc
	modified:   var/da/da_tools/da_llxy.inc
	new file:   var/da/da_tools/da_outside.inc
	modified:   var/da/da_tools/da_tools.f90
+ ll to xy conversion in da_llxy_1d
+ rad to bt conversion in get_abil1b_bt
+ replaced loop over mpi_bcast with single mpi_allgatherv

Also many code cleanups to remove old implementations

 Changes to be committed:
	modified:   ../build/depend.txt
	modified:   da_radiance/da_radiance.f90
	modified:   da_radiance/da_read_obs_ncgoesabi.inc
	new file:   da_tools/da_llxy_1d.inc
	new file:   da_tools/da_llxy_default_1d.inc
	new file:   da_tools/da_llxy_global_1d.inc
	new file:   da_tools/da_llxy_kma_global_1d.inc
	new file:   da_tools/da_llxy_latlon_1d.inc
	new file:   da_tools/da_llxy_lc_1d.inc
	new file:   da_tools/da_llxy_merc_1d.inc
	new file:   da_tools/da_llxy_ps_1d.inc
	new file:   da_tools/da_llxy_rotated_latlon_1d.inc
	new file:   da_tools/da_llxy_wrf_1d.inc
	new file:   da_tools/da_togrid_1d.inc
	modified:   da_tools/da_tools.f90
	modified:   da_radiance/da_read_obs_ncgoesabi.inc
 Changes to be committed:
	modified:   da_radiance/da_read_obs_ncgoesabi.inc
Still required
 - test compilation
 - debug runtime errors
 - test correct functionality for 10 different cloud detection criteria

 Changes to be committed:
	modified:   Registry/registry.var
	modified:   var/build/depend.txt
	modified:   var/da/da_control/da_control.f90
	modified:   var/da/da_define_structures/da_define_structures.f90
	modified:   var/da/da_physics/da_physics.f90
	new file:   var/da/da_physics/da_trop_wmo.inc
	modified:   var/da/da_radiance/da_allocate_rad_iv.inc
	modified:   var/da/da_radiance/da_crtm.f90
	modified:   var/da/da_radiance/da_deallocate_radiance.inc
	modified:   var/da/da_radiance/da_get_innov_vector_crtm.inc
	modified:   var/da/da_radiance/da_get_innov_vector_rttov.inc
	new file:   var/da/da_radiance/da_get_sat_angles.inc
	new file:   var/da/da_radiance/da_get_sat_angles_1d.inc
	deleted:    var/da/da_radiance/da_get_satzen.inc
	deleted:    var/da/da_radiance/da_get_satzen_1d.inc
	new file:   var/da/da_radiance/da_get_solar_angles.inc
	new file:   var/da/da_radiance/da_get_solar_angles_1d.inc
	modified:   var/da/da_radiance/da_initialize_rad_iv.inc
	modified:   var/da/da_radiance/da_qc_goesabi.inc
	modified:   var/da/da_radiance/da_radiance.f90
	modified:   var/da/da_radiance/da_radiance1.f90
	modified:   var/da/da_radiance/da_read_obs_ncgoesabi.inc
	modified:   var/da/da_radiance/da_read_obs_ncgoesimg.inc
	modified:   var/da/da_radiance/da_rttov.f90
… from the GOES ABI Cloud Mask that were not described in the journal article. Also cleaned up the QC test code.

 Changes to be committed:
	modified:   da_define_structures/da_define_structures.f90
	modified:   da_radiance/da_deallocate_radiance.inc
	modified:   da_radiance/da_initialize_rad_iv.inc
	modified:   da_radiance/da_qc_goesabi.inc
	modified:   da_radiance/da_read_obs_ncgoesabi.inc
plus fixes for
a) solzen in crtm operator
b) i,j,dx,dy,dxm,dym for loc in ABI reading routine

 Changes to be committed:
	modified:   da_radiance/da_get_innov_vector_crtm.inc
	modified:   da_radiance/da_qc_goesabi.inc
	modified:   da_radiance/da_read_obs_ncgoesabi.inc
 Changes to be committed:
	modified:   da_radiance/da_read_obs_ncgoesabi.inc
 Changes to be committed:
	modified:   goes-16-abi.info
	modified:   goes-17-abi.info
 Changes to be committed:
	modified:   da_radiance/da_qc_goesabi.inc
 Changes to be committed:
	modified:   Registry/registry.var
	modified:   var/da/da_define_structures/da_define_structures.f90
	modified:   var/da/da_monitor/da_rad_diags.f90
	modified:   var/da/da_radiance/da_allocate_rad_iv.inc
	modified:   var/da/da_radiance/da_crtm.f90
	modified:   var/da/da_radiance/da_deallocate_radiance.inc
	modified:   var/da/da_radiance/da_get_innov_vector_crtm.inc
	modified:   var/da/da_radiance/da_qc_amsr2.inc
	modified:   var/da/da_radiance/da_qc_goesabi.inc
	modified:   var/da/da_radiance/da_radiance1.f90
	modified:   var/da/da_radiance/da_radiance_init.inc
	modified:   var/da/da_radiance/da_write_iv_rad_ascii.inc
	modified:   var/da/da_radiance/da_write_oa_rad_ascii.inc
	modified:   var/da/da_radiance/module_radiance.f90
	modified:   var/run/radiance_info/gcom-w-1-amsr2.info
	modified:   var/run/radiance_info/goes-16-abi.info
Conflicts:
	var/da/da_radiance/da_get_innov_vector_rttov.inc
	var/da/da_radiance/da_rttov_init.inc
	var/da/da_radiance/module_radiance.f90
 Changes to be committed:
	modified:   da_radiance/da_get_innov_vector_crtm.inc
	modified:   da_radiance/da_qc_goesabi.inc
	modified:   da_radiance/da_radiance_init.inc
	modified:   da_radiance/da_write_iv_rad_ascii.inc
	modified:   da_radiance/da_write_oa_rad_ascii.inc
This fix ensures that the metadata and grid for CONUS and Full Disk are only allocated and calculated once.  Otherwise a run-time error occurs in 4D HofX.
 Changes to be committed:
	modified:   da_radiance/da_read_obs_ncgoesabi.inc
1) QC for missing_r values of bt_p
2) find both link and file types for ABI nc files in any directory with goes-${view}* prefix
3) fix TEMPIR minimum time diff update
4) Handle case when no GOES ABI views have data for any FGAT times
5) Handle case when < 10 channels have low data quality flag (some channels good, some bad)
6) OMB and OMA reading/writing logic for ABI cloudy radiances
7) Set initial goes-16 and goes-17 variances to large values in order to calculate statistics on larger data set
8) Temporary ca_mean and BTlim calculation for gathering cloudy radiance statistics
	modified:   var/da/da_radiance/da_read_obs_ncgoesabi.inc
	modified:   var/da/da_radiance/da_allocate_rad_iv.inc
	modified:   var/da/da_radiance/da_deallocate_radiance.inc
	modified:   var/da/da_radiance/da_initialize_rad_iv.inc
	modified:   var/da/da_radiance/module_radiance.f90
	modified:   var/run/radiance_info/goes-16-abi.info
	modified:   var/run/radiance_info/goes-17-abi.info
	modified:   var/da/da_define_structures/da_define_structures.f90
	modified:   var/da/da_radiance/da_qc_goesabi.inc
	modified:   var/da/da_radiance/da_radiance1.f90
	modified:   var/da/da_radiance/da_read_obs_ncgoesabi.inc
	modified:   compile
	modified:   var/da/da_monitor/da_rad_diags.f90
	modified:   var/da/da_radiance/da_get_innov_vector_crtm.inc
	modified:   var/da/da_radiance/da_get_innov_vector_rttov.inc
	modified:   var/da/da_radiance/da_initialize_rad_iv.inc
	modified:   var/da/da_radiance/da_radiance_init.inc
	modified:   var/da/da_radiance/da_setup_radiance_structures.inc
	modified:   var/da/da_radiance/da_write_iv_rad_ascii.inc
	modified:   var/da/da_radiance/da_write_oa_rad_ascii.inc
	modified:   var/da/da_radiance/module_radiance.f90
	modified:   var/da/da_setup_structures/da_setup_obs_structures.inc
	modified:   var/da/da_tools/da_tools.f90
	modified:   var/run/radiance_info/goes-17-abi.info
	modified:   var/da/da_radiance/da_radiance_init.inc
	modified:   var/da/da_radiance/da_get_innov_vector_crtm.inc
	modified:   var/da/da_radiance/da_initialize_rad_iv.inc
	modified:   var/da/da_radiance/da_deallocate_radiance.inc
	modified:   var/da/da_radiance/da_get_innov_vector_crtm.inc
	modified:   var/da/da_radiance/da_radiance_init.inc
	modified:   var/run/VARBC.in
	modified:   var/da/da_radiance/da_get_innov_vector_crtm.inc
	modified:   var/da/da_radiance/da_initialize_rad_iv.inc
	modified:   var/da/da_radiance/da_read_obs_ncgoesabi.inc
@liujake liujake requested a review from a team as a code owner January 16, 2024 07:59
@liujake liujake requested review from xdmjolly and removed request for a team January 16, 2024 08:00
@liujake
Copy link
Contributor Author

liujake commented Jan 16, 2024

goes-16-abi_2019050100-48
goes-16-abi_2019050100-16
goes-16-abi_2019050100-21

@liujake
Copy link
Contributor Author

liujake commented Jan 16, 2024

Jenkins Regression test results:
Test Type | Expected | Received | Failed
= = = = = = = = = = = = = = = = = = = = = = = = = = = =
Number of Tests : 23 24
Number of Builds : 60 57
Number of Simulations : 158 150 0
Number of Comparisons : 95 86 0

Failed Simulations are: 
None
Which comparisons are not bit-for-bit: 
None

@liujake liujake requested a review from junmeiban January 16, 2024 16:34
@liujake liujake removed the request for review from xdmjolly January 16, 2024 21:49
@liujake liujake merged commit 32de5e4 into wrf-model:develop Jan 17, 2024
1 of 9 checks passed
@liujake liujake deleted the feature/goesabi branch January 17, 2024 16:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants