function inqcdf(file)

% modified 6/92 to use the C version of mexcdf.  J. Allen
% 	> arrays must be indexed from 0 instead of 1 
%	> ncglobal is defined as -1 instead of 0.
% 
%--------------------------------------------------------------------
%     Copyright (C) J. V. Mansbridge, CSIRO, january 24 1992
% CHANGE   1.2 92/03/06
%
%  function inqcdf(file)
%
% DESCRIPTION:
%  inqcdf('file') is an interactive function that  returns information
%  about the NetCDF file 'file.cdf'.  If the file is in compressed form
%  then the user will be given an option for automatic uncompression.
% 
% INPUT:
%  file is the name of a netCDF file but without the .cdf extent.
%
% OUTPUT:
%  information is written to the user's terminal.
%
% EXAMPLE:
%
%
% CALLER:   general purpose
% CALLEE:   check_cdf.m, mexcdf.mexsg
%
% AUTHOR:   J. V. Mansbridge, CSIRO
%---------------------------------------------------------------------

% @(#)inqcdf.m   1.2   92/03/06
% 
% Note that the netcdf functions are accessed by reference to the mex
% function mexcdf.
%--------------------------------------------------------------------

% Check the number of arguments.

if nargin < 1
   help inqcdf
   return
end

% Check that the file is accessible and optionally uncompress it.

cdf = [ file '.cdf' ];
err = check_cdf(cdf);
if err ~= 0
   return;
end

% Do some initialisation.

blank = abs(' ');

% Open the netcdf file.

ncnowrit = 0;
[cdfid, rcode] = mexcdf('ncopen', cdf, ncnowrit);
if rcode ~= 0
   s = [ 'mexcdf: ncopen: rcode = ' int2str(rcode) ];
   disp (s)
   return
end

% Collect information about the cdf file.

[ndims, nvars, ngatts, recdim, rcode] =  mexcdf('ncinquire', cdfid);
if rcode ~= 0
   s = [ 'mexcdf: ncinquire: rcode = ' int2str(rcode) ];
   disp (s)
   return
end

% Find and print out the global attributes of the cdf file.

ncglobal = -1;

if ngatts > 0
   disp('                ---  Global attributes  ---')
   for i = 0:ngatts-1
      [attnam, rcode] = mexcdf('ncattname', cdfid, ncglobal, i);
      if rcode ~= 0
         s = [ 'mexcdf: ncattname: rcode = ' int2str(rcode) ];
         disp (s)
         return
      end
      [attype, attlen, rcode] = mexcdf('ncattinq', cdfid, ncglobal, attnam);
      if rcode ~= 0
         s = [ 'mexcdf: ncattinq: rcode = ' int2str(rcode) ];
         disp (s)
         return
      end
      [values, rcode] = mexcdf('ncattget', cdfid, ncglobal, attnam);
      if rcode ~= 0
         s = [ 'mexcdf: ncattget: rcode = ' int2str(rcode) ];
         disp (s)
         return
      end
   
      if attype == 2
         s = values;
      elseif attype == 3 | attype == 4
         s = [];
         for i = 0:length(values)-1
            s = [ s int2str(values(i)) '  ' ];
         end
      elseif attype == 5 | attype == 6
         s = [];
         for i = 0:length(values)-1
            s = [ s num2str(values(i)) '  ' ];
         end
      end
      s = [ attnam ': ' s ];
      disp(s)
   end
else
   disp('   ---  There are no Global attributes  ---')
end

% Get and print out information about the dimensions.

disp(' ')
s = [ 'The ' int2str(ndims) ' dimensions are' ];
for i = 0:ndims-1
   [dimnam, dimsiz, rcode] = mexcdf('ncdiminq', cdfid, i);
   if rcode ~= 0
      s = [ 'mexcdf: ncdiminq: rcode = ' int2str(rcode) ];
      disp (s)
      return
   end
   s = [ s '  ' int2str(i) ') ' dimnam ];
end
s = [ s '.'];

disp(s)
if recdim <= 0
   disp('None of the dimensions is unlimited')
else
   [dimnam, dimsiz, rcode] = mexcdf('ncdiminq', cdfid, recdim);
   if rcode ~= 0
      s = [ 'mexcdf: ncdiminq: rcode = ' int2str(rcode) ];
      disp (s)
      return
   end
   s = [ dimnam ' is unlimited in length'];
   disp(s)
end

% Print out the names of all of the variables so that the user may
% choose to 1) finish the inquiry, 2) print out information about all
% variables or 3) print out information about only one of them.

infinite = 1;
while infinite
   k = -2;
   while k <-1 | k > nvars
      disp(' ')
      s = [ '----- Get further information about the following variables -----'];
      disp(s)
      disp(' ')
      s = [ '  -1) None of them (no further information)' ];
      disp(s)
      s = [ '   0) All of the variables' ];
      disp(s)
      for i = 0:3:nvars-1
         stri = int2str(i+1);
         if length(stri) == 1
            stri = [ ' ' stri];
         end
         [varnam, vartyp, nvdims, vdims, nvatts, rcode] = ...
         mexcdf('ncvarinq', cdfid, i);
         s = [ '  ' stri ') ' varnam ];
         addit = 26 - length(s);
         for j =1:addit
            s = [ s ' '];
         end
   
         if i < nvars-1
            stri = int2str(i+1+1);
            if length(stri) == 1
               stri = [ ' ' stri];
            end
            [varnam, vartyp, nvdims, vdims, nvatts, rcode] = ...
            mexcdf('ncvarinq', cdfid, i+1);
            s = [ s '  ' stri ') ' varnam ];
            addit = 52 - length(s);
            for j =1:addit
               s = [ s ' '];
            end
         end 
   
         if i < nvars-1 - 1
            stri = int2str(i+1+2);
            if length(stri) == 1
               stri = [ ' ' stri];
            end
            [varnam, vartyp, nvdims, vdims, nvatts, rcode] = ...
            mexcdf('ncvarinq', cdfid, i+2);
            s = [ s '  ' stri ') ' varnam ];
         end 
         disp(s)
      end
      disp(' ')
      s = [ 'Select a menu number: '];
      k = input(s);
   end
   
% Get and print out information about as many variables as necessary.
   
   if k == -1
      return
   elseif k == 0
      klow = 1-1;
      kup = nvars-1;
   else
      klow = k-1;
      kup = k-1;
   end
   
   if nvars > 0
      for k = klow:kup
         [varnam, vartyp, nvdims, vdims, nvatts, rcode] = ...
                  mexcdf('ncvarinq', cdfid, k); 
         if rcode ~= 0
            s = [ 'mexcdf: ncvarinq: rcode = ' int2str(rcode) ];
            disp (s)
            return
         end
   
% Write out a message containing the dimensions of the variable.

         s = [ '   ---  Information about ' varnam '(' ];
         for j = 1:nvdims
            [dimnam, dimsiz, rcode] = mexcdf('ncdiminq', cdfid, vdims(j)); 
            if rcode ~= 0
               s = [ 'mexcdf: ncdiminq: rcode = ' int2str(rcode) ];
               disp (s)
               return
            end
   
            s = [ s dimnam ' ' ];
         end
         s = [ s ')  ---' ];
         disp(' ')
         disp(s)
   
% Find and print out the attributes of the variable.
   
         if nvatts > 0
            disp(' ')
            s = [ '   ---  ' varnam ' attributes  ---' ];
            left_side = 1;
            for j = 0:nvatts-1
               [attnam, rcode] = mexcdf('ncattname', cdfid, k, j); 
               if rcode ~= 0
                  s = [ 'mexcdf: ncattname: rcode = ' int2str(rcode) ];
                  disp (s)
                  return
               end
               [attype, attlen, rcode] = mexcdf('ncattinq', cdfid, ...
                        k, attnam); 
               if rcode ~= 0
                  s = [ 'mexcdf: ncattinq: rcode = ' int2str(rcode) ];
                  disp (s)
                  return
               end
               [values, rcode] = mexcdf('ncattget', cdfid, k, attnam);
               if rcode ~= 0
                  s = [ 'mexcdf: ncattget: rcode = ' int2str(rcode) ];
                  disp (s)
                  return
               end
   
               if attype == 2
                  s = values;
               elseif attype == 3 | attype == 4
                  s = [];
                  for ii = 1:length(values)
                     s = [ s int2str(values(ii)) '  ' ];
                  end
               elseif attype == 5 | attype == 6
                  s = [];
                  for ii = 1:length(values)
                     s = [ s num2str(values(ii)) '  ' ]; 
                  end
               end
   
% Go through convolutions to try to fit information about two attributes onto
% one line.
   
               le_att = length(attnam);
               le_s = length(s);
               le_sum = le_att + le_s;
               st = [ '*' attnam ': ' s ];
               if left_side == 1
                  if le_sum > 37
                     disp(st)
                  else
                     n_blanks = 37 - le_sum;
                     if n_blanks > 1
                        for ii = 1:n_blanks
                           st = [ st ' ' ];
                        end
                     end
                     temp = st;
                     left_side = 0;
                  end
               else
                  if le_sum > 37
                     disp(temp)
                  else
                     st = [ temp st ];
                  end
                  disp(st)
                  left_side = 1;
               end
            end
            if left_side == 0
               disp(temp)
            end
         else
            s = [ '   ---  ' varnam ' has no attributes  ---' ];
            disp(s)
         end
      end
   else
      disp(' ')
      disp('   ---  There are no variables  ---')
   end
end

%  Close the netcdf file

[rcode] = mexcdf('ncclose', cdfid);
if rcode ~= 0
   s = [ 'mexcdf: ncclose: rcode = ' int2str(rcode) ];
   disp (s)
   return
end
%clear functions
%clear