Tool to convert daily mean 0.25deg resolution OISST netcdf file to 1.0deg binary format


CREATED by Paolo Veglio and Eva Borbas  
           Space Science and Engineering Center
           University of Wisconsin-Madison

DATE: January 31, 2023


VERSION: 1.1 

Tool to convert the daily mean Optimum Interpolation SST provided by NCEI-NOAA 
at 0.25deg resolution in netcdf4 into 1.0deg resolution binary files compatible with the old 
weekly mean datafile format from NCEP that is used by the MODIS Cloud Products.


INPUT: 
       fnin :   Daily Reynolds OISST file in netcdf4 format at 0.25deg resolution
       source: https://www.ncei.noaa.gov/data/sea-surface-temperature-optimum-interpolation/v2.1/access/avhrr/
                   
OUTPUT: 
       fnout:   Filename of the 1.0deg resolution binary output
       dataformat description: ftp://ftp.emc.ncep.noaa.gov:/cmb/sst/oisst_v2/README

   
PACKAGE CONTAINS: 

   source dir   - includes the 'oisst_nc2bin.py'  python script to convert file	        
   test dir     - includes test script (run_oisst_nc2bin.sh) and input and control output datafiles 
                  in the inputs and outputs.save directories for code validation      
   REAME_oisst_nc2bin.txt - incudes software information
   build_env.sh  -  script to build the python environment to run the script
   HISTORY.txt   - history of the deliveries 


REQUIREMENT(S): python 3 (miniconda) numpy, xarray, netcdf4, bottleneck
                       The build_env.sh script installs in the env directory 
		       the python environment and all necessary modules to run the script
  
TEST: 
	
	1. tar xf OISST_nc2bin_01312023.tar.gz
	2. cd OISST_nc2bin_01312023
	3. ./build_env.sh  Note: no need to run it if the local system for python is used	
	4. cd test
	5. If local system python is used, edit the location of the python executable (pydir) 
	         in the test/run_oisst_nc2bin.sh script.
	6. run: ./run_oisst_nc2bin.sh  
	7. Compare the output files in the outputs directory to the provided test output files 
	        in the outputs.save directory.
	   (E.g. use: diff file1 file2; cmp -l file1 file2)
	

LIST OF FILES IN THE PACKAGE: 

build_env.sh
source/oisst_nc2bin.py
test/run_oisst_nc2bin.sh
test/inputs/oisst-avhrr-v02r01.20211201.nc
test/inputs/oisst-avhrr-v02r01.20211202.nc
test/outputs.save/oisst.20211201
test/outputs.save/oisst.20211202
test/outputs/
README_oisst_nc2bin.txt
HISTORY.txt