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 #1

Open
wants to merge 109 commits into
base: develop
Choose a base branch
from

Conversation

liujake
Copy link
Owner

@liujake liujake commented Dec 27, 2023

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. 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:
wrf-model#1139
wrf-model#1173
wrf-model#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_minimisation/da_calculate_j.inc
	modified:   var/da/da_minimisation/da_sensitivity.inc
	modified:   var/da/da_minimisation/da_transform_vtoy.inc
	modified:   var/da/da_minimisation/da_transform_vtoy_adj.inc
	modified:   var/da/da_obs/da_transform_xtoy_adj.inc
	modified:   var/da/da_obs/da_transform_xtoy_adj.inc
	modified:   var/da/da_obs/da_transform_xtoy_adj.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_crtmk.inc
	modified:   var/da/da_radiance/da_get_innov_vector_rttov.inc
	new file:   var/da/da_radiance/da_get_satzen.inc
	modified:   var/da/da_radiance/da_initialize_rad_iv.inc
	modified:   var/da/da_radiance/da_qc_amsr2.inc
	modified:   var/da/da_radiance/da_qc_amsub.inc
	modified:   var/da/da_radiance/da_qc_goesimg.inc
	modified:   var/da/da_radiance/da_radiance1.f90
	modified:   var/da/da_radiance/da_read_obs_ncgoesimg.inc
	modified:   var/da/da_radiance/da_rttov.f90
	modified:   var/da/da_radiance/da_setup_radiance_structures.inc
	modified:   var/da/da_radiance/da_transform_xtoy_crtm.inc
	modified:   var/da/da_radiance/da_transform_xtoy_crtm_adj.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_setup_structures/da_setup_be_regional.inc
	modified:   var/da/da_setup_structures/da_setup_obs_structures.inc
	modified:   var/da/da_test/da_check_vtox_adjoint.inc
	modified:   var/da/da_test/da_check_vtoy_adjoint.inc
	modified:   var/da/da_test/da_check_xtoy_adjoint.inc
	modified:   var/da/da_test/da_setup_testfield.inc
	modified:   var/da/da_test/da_test_vtoy_transform.inc
	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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant