Description of HIS Mfiles:

coastlin.mat
% Mat file containing low-resolution coast line data

create_his_cal_plots.m
%       function [] = create_his_cal_plots(print_flag,filedate)
%
%   ....This Matlab functions reads the HIS UME files and generates
%       radiance and brightness temperature plots of 10 spectra averages.

create_his_engineering_plots.m
%       function [] = create_his_engineering_plots(print_flag,filedate);
%
%   .....This Matlab function creates plots of engineering data for the HIS
%        instrument after reading several different files.
%
%        Example input: create_his_engineering_plots(0,980513);
%
%        Input:
%          print_flag   - Flag for printing hard copies (1 for yes, 0 for no hard copies).
%
%          filedate - This is a NUMBER that designates the date that the HIS
%                       data was taken, ie, 980513.
%
%                NOTE:  This routine requires the following files to be 
%                        in the following directory structure (assuming
%                        filedate = 980513):
%
%                        [direc]\ac980513\qc\hc1
%                        [direc]\ac980513\qc\hc3
%                        [direc]\ac980513\qc\hc5
%                        [direc]\ac980513\980513.BL1
%                        [direc]\ac980513\980513.BL2
%                        [direc]\ac980513\980513.BL3
%                        [direc]\ac980513\98-063.BAC
%

his_hk_plots.m
%       function [] = his_hk_plots(print_flag,filedate)
%
%   ....Creates plots of the HIS housekeeping data that are normally placed in the flight 
%       data log book.
%

his_noise_plots.m
%       function [] = his_noise_plots(filedate)
%
%   ....Plots the noise estimates from the HIS QC files.
%       print_flag = 1 for printing.
%

hisae.doc
% Documentation file for HIS data.

hisplot.m
% plots averaged spectra from hisdata_sim
% makes 4 plots to get idea of what data is doing
%

nav_plot.m
%       function [] = nav_plot(print_flag,filedate)
%
%   ....Makes a plot of the navigation data taken during HIS flight.
%
%        Example input: nav_plot(0,980513);
%
%        Input:
%          print_flag   - Flag for printing hard copies (1 for yes, 0 for no hard copies).
%
%          filedate - This is a NUMBER that designates the date that the HIS
%                       data was taken, ie, 980513.
%
%                NOTE:  This routine requires a NASA BAC NAVDATA file to be 
%                        in the following directory structure (assuming
%                        filedate = 980513 and flight_track = '98-063'):
%
%                        [direc]\ac980513\98-063.BAC
%
%                        where [direc] is hardwired in below.
%
%

plots_980518.m
% Creates plots of HIS data from 980518.

rad2bt.m
% Converts from radiance [mW m-2 sr-1 (cm-1)-1] to brightness temperature (K).

rd_cls.m
%       function [cls] = rd_cls(filename)
%
%   ....This Matlab function reads cloud boundary data files generated from NASA's Cloud
%       Lidar System (CLS).  More information can be obtained on this instrument from
%       Jim Spinhirne's web page at http://virl.gsfc.nasa.gov/er2cls.html.
%
%       Input:
%         filename - filename of CLS boundary file
%
%       Output:
%         cls      - structure containing the following variables:
%                      mtime             - Matlab serial date/time
%                      seconds           - time in seconds since midnight
%                      lat               - aircraft latitude
%                      lon               - aircraft longitude
%                      alt               - aircraft altitude
%                      roll              - aircraft roll
%                      cloud_boundary    - array containing top and bottom cloud boundaries
%                                            of up to 5 layers below aircraft (NaN represent
%                                            no data.)
%                                              cls.cloud_boundary(:,1) = top of 1st cloud layer
%                                              cls.cloud_boundary(:,2) = bottom of 1st cloud layer
%                                              cls.cloud_boundary(:,3) = top of 2nd cloud layer
%                                                ...
%                      surface_elevation - surface elevation as deduced by CLS
%                      hdr               - header lines of CLS file.
%

rd_navdata.m
%       function [YYMMDD,time,latitude,longitude,altitude,heading,pitch,roll,speed,pressure,temperature,hdr] = rd_navdata(filename);
%
%   ....Reads binary files (*.bac) containing ER-2 navigation data.
%

read_his_hk_files.m
%       function [hdr1,BL1,hdr2,BL2,hdr3,BL3] = read_his_hk_files(filename);
%
%   ....This Matlab function reads HIS housekeeping files and returns the data in the following structures:
%
%       NOTE THAT filename does NOT include the file extension!! (ie, 'e:\ac980518\980518')
%

read_his_record.m
%       function his_record = read_his_record(file,index);
%
%   ....This Matlab function reads one HIS record based on the file
%       pointer fp and the file index.
%

read_his_records.m
%       function his = read_HIS_records(file,beginning_index,ending_index)
%
%   ....This Matlab function using 'read_HIS_record.m' to read a sequence
%       of HIS records.
%
%       Input:
%         file - filename of HIS data file
%         beginning_index - Beginning HIS record index
%         ending_index    - Ending HIS record index
%
%       Output:
%         his - array of structures containing HIS data
%

readall.m
% function [data,header,freq,specrad,bt] = readall(file);
%       header is a matrix of all the headers (1 header per row)
%       specrad is a matrix of all the spectra (1 per row)