These IDL, FORTRAN 90, Python, C++ and Matlab routines are available 
to aid in reading the RSS scatterometer bytemap daily 
and time-averaged data files.  The read routines have been
tested and work correctly within our PC environment.
We do not guarantee that they work perfectly in a different
environment with different compilers.  If portability is a problem,
we suggest using the Python code.

The routines work on both QuikSCAT version-4 data 
(released April 2011) and SeaWinds version-3 data 
(released March 2005).  The QuikSCAT data use the Ku-2011
geophysical model function (GMF), the SeaWinds data use the Ku-2001 GMF.

There is a qscat_v4_daily_verify.txt file and associated
image (qscat_v4_daily_verify.png) to help you make sure
you are still reading the data correctly after you've 
adapted one of these programs to your needs.  The 
qscat_v4_averaged_verify.txt file can be used to check 
the 3-day, weekly and monthly data.

3-day files are an average of 3 days ending on file date
weekly files are an average of 7 days ending on Saturday of file date
monthly files are an average of all days in the calendar month

The FORTRAN subroutines get_scat_daily_v4.f and get_scat_averaged_v4.f
each contain a description of the data file at the top of the subroutine.  
The 3-day, weekly and monthly binary files can all be read with the
get_scat_averaged_v4.f routine by supplying the correct filename with 
path. These routines have been tested with Compaq Fortran90. Data files 
must be unzipped prior to using these routines. Use a file unzipper of your choice.


The IDL get_scat_daily_v4.pro routine requires a full path file name
and returns five 1440x720x2 real arrays.  The time-averaged
data files are read using get_scat_averaged_v4.pro.  This routine
returns four 1440x720 real arrays.  A description is provided 
within the routine.  These routines have been tested with IDL 8.1
Data files do not need to be unzipped when using the /compress keyword
in the read call.


We also provide Matlab read routines, get_scat_daily_v4.m and
get_scat_averaged.v4.m    These routines function like the IDL 
routines above and have been tested with Matlab 7.1  Data files 
must be unzipped before using the matlab routines.


The Python code consists of quikscat_daily_v4.py and quikscat_averaged_v4.py.  
Both require the use of bytemaps.py.  The example_usage.py code provides a main
program that you can use to test the data or adapt to your needs.
Description of file contents is provided at the top of each routine.

The C++ code consists of quikscat_daily.h and quikscat_dailly.cpp as well as
the averaged files.  To use, one needs the dataset.h and the dataset.cpp also.
The program quikscat_example_usage.cpp provides a main program that you can 
use to test the data or to adapt to your own needs.  Description of data 
contents is located in the comments at the top of each file.

Once you have further developed one of these skeleton programs
to suit your processing needs, you may wish to use the verify file 
to confirm that the data files are still being read correctly.
Please check that you have the correct verify file.

If you have any questions regarding these programs 
or the RSS binary data files, contact RSS support:
http://www.remss.com/support