These IDL, FORTRAN 90, Python, C++ and Matlab routines are available 
to aid in reading the RSS bytemap daily and time-averaged data files.  
The read routines have been tested and work correctly within 
our PC Windows 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.

We provide data from the AMSR-2 instrument on GCOM-W1, the 
AMSR instrument on Aqua (AMSR-E) and the AMSR instrument on 
ADEOS-II (which we refer to as AMSR-J).
These instruments, though similar, have different swath widths.
We process the data using v5 (AMSR-J) and V7.1 (AMSR-E) and V7.2 (AMSR-2) 
algorithms into ocean products of sea surface temperature, ocean surface 
winds (10 meters height), atmospheric water vapor, cloud liquid 
water, and rain rate.


The FORTRAN subroutines are located in read_amsr_subroutines_v7.f
read_amsr_day returns a 1440x720x7x2 real array called amsr_data.
A description of the data within this array is at the top of the 
subroutine.  read_amsr_averaged returns a 1440x720x6 real array
called amsr_data.  The 3-day, weekly and monthly binary files
can all be read with this one routine.  Just supply the correct
filename with path.  These routines have been tested with 
Intel Visual Fortran 90. Data files must be unzipped prior to 
using these routines. Use a file unzipper of your choice.


The IDL read_amsr_day_v7.pro routine requires a full path filename
and returns seven 1440x720x2 real arrays.  The time-averaged
data files are read using read_amsr_averaged_v7.pro.  This routine
returns six 1440x720 real arrays.  A description is provided 
within the routine.  These routines have been tested with IDL 8.4
Data files do not need to be unzipped when using the /compress keyword
in the read call.


Matlab read routines, read_amsr_day_v7.m and read_amsr_averaged_v7.m, 
function similar to the IDL routines listed above and have been tested 
with Matlab 7.1   Data files must be unzipped before using the matlab 
routines.


The Python code consists of amsr_daily_v7.py and amsr_averaged_v7.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.


C++ read routines consist of amsr2_daily.h, amsr2_daily.cpp and amsr2_example.usage.cpp
as well as averaged files for each.  Files are separated into AMSRE and AMSR2, but
either will work on the other.  The amsr2_example.usage.cpp and amsre_example.usage.cpp
both provide a main program that can be used to test the data or use as a starting
point to adapt to your needs.  A description of the file contents is provided
at the top of each routine.  dataset.h and dataset.cpp are required for programs to work.


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 our support desk at
at support@remss.com