This IDL based software is designed to read GOES-16 Advanced Baseline Imager (ABI) CONUS (Continental US) scan.
The software comes with sample output files and other needed geolocation information files for one time step.  
The ABI file format is netCDF4.  Images can be saved in multiple formats.
Once implemented the software runs on the sample file provided to display interactively all the output parameters.
For routine use of the software, users have to download the GOES-16 ABI data from NOAA CLASS (https://www.class.ncdc.noaa.gov).
Search for GRABIPRD (short for GOES-R ABI Products).  Once the map and list of products show up, users have
to select AOD and ADP for Aerosol Optical Depth and Aerosol Detection PRoduct respectively.

The downloaded ABI CONUS data files should be placed inside "the abi-conus-vistool-save\DATA\" folder . 
In the DATA folder create a subfolder with the name YYYYMMDD_HHMM, where YYYY is the four-digit year, 
MM is the two-digit month, DD is the two-digit day of month, HH is the two-digit UTC hour, 
and MM is the two-digit of minutes (for example, YYYYMMDD_HHMM=20170808_1802 for 8/8/2017 18:02UTC),
and place the data files there. 

Inside the download software package, two sample data subfolders were created for August 8, 2017 18:02 UTC 
and August 2, 2017 18:02 UTC. The supplied sample data subfolders have following files for one CONUS retrieval:
 Aerosol optical depth retrieval output (AODC)
 Aerosol detection product output (ADPC)
 Cloud mask (ACMC)
 ABI auxilary data (AUXC2)
 ABI band cloud and moisture imagery products (CMIPC)
Note: using the software requires the AOD and ADP files being available, other data are optional for display

After decompressing the ZIP file, user should NOT move the IDL binary file "abi_conus" and the "DATA" 
folder to different places, they need to stay in the same folder ("abi-conus-vistool-save" by default, 
users can change the name of this folder), and remain on the user's local hard drive where the IDL virtual machine is
installed (not on cloud or other remote storage). 

Menus:
  'Time'
    ->'Select':
       Input the ABI CONUS starting UTC time: year, month, day, hour, minute
       It is the user's responsibility to make sure the ABI data corresponding to the input time are available
         in the DATA\YYYYMMDD_HHMM\ folder
  'File'
    ->'Save As...' 
       Save the plotted image to a figure file 
    ->'Quit'
       Quit the visualization tool

   'Display'
    ->'AodOutputs'
       Display AOD variables
    ->'AdpOutputs'
       Display ADP variables
    ->'RGB Images'
       Display (1) synthetic RGB (true color RGB with the green channel reflectance synthesized from the blue and 
                    red reflectance available from ABI), need to have ABI Channel 1 and 2 reflectance data available
                (2) Dust RGB, need to have ABI channel 11, 14 and 15 brightness temperature data available
                (3) Natural Color RGB, need to have ABI channel 2, 3, and 5 reflectance data available 
        Description of the Dust and Natural Color RGB can be found at the EUMETSAT training website
                (http://www.eumetrain.org/data/3/34/index.html)      
    ->'Inputs'
       Display the input cloud mask, geometry, and ABI channel reflectances
    ->'Combination Plot'
       Make the plot of AOD and ADP variables with the restriction of certain quality flags (can be a combination of several flags by AND/OR).
       For example, 'Select Variable'->'AOD at 550nm'
                    'Select Qulity Flag'->'AOD Retrieval Quality'->'Good'
                    'AND/OR'->'AND' 
                    'Select Qulity Flag'->'Smoke Flag'->'Yes'
                    'Submit'
       The retrieved AOD550 of (1) the good quality AND (2) identified as smoke by ADP will be displayed  
   
   'Options'
     ->'Colors'
       Change the color table and the individual colors for backgroud, missing data, continent boundary line, and quality flag values
     ->'Data Range' 
       Set the desired data range to be display (only for the non-discrete floating variable like AOD and reflectance)
       ->'Restrict': show the data only within the specified data range
       ->'Submit': without above restriction

   Zoom-in function is available once the image is displayed on the screen.
     Left click the mouse on the image and drag to select the domain to be zoomed in, a separate window will appear after releasing the mouse
     'Values'->"Show Values' 
       A panel will appear, by left clicking the mouse on the zoom-in image, the pixel values will appear on this panel.
       Note displayed are the variables having visited before (data have been read into the memory). 
      
Issues:
 Output 'tiff' figure file might be problematic if IDL 8.2 is used. IDL 8.2.1 has fixed this bug.
 
Contact:
 Hongqing Liu (Hongqing.Liu@noaa.gov)