RBAR Name
      
       RBAR Purpose
      
       Plot a color bars with defined ranges.
Category
Calling Sequence
      
       rbar, file Inputs
      
       file = color bar definition file name.   in 
      
       s = Instead a file may give a structure. in
                  s must contain the following items:
                  n: # colors
        
         clr: Array of n colors (24 bit values)
        
         tick_lab: n+1 Labels for ticks (some may be space)
        
         tick_flag: n+1 flags: 0=ignore, 1=show. 
      
       The bar will have labels at the top and bottom and
      
       at each color boundary between. Some labels may be blank.
Keyword Parameters
Keywords
        
         /vertical    Plot a vertical color bar (default).
        
         /horizontal  Plot a horizontal color bar.
        
         GET_STRUCT=s Read the structure from the file and return.
        
         /FILE_FORM   Show help on the file format.
                  ERROR=err    Error flag: 0=ok.
Outputs
Common Blocks
Notes
      
       Notes: Use plot keywords to position and control the bar.
Modification History
      
       R. Sterner, 2005 Jun 24 
      
       R. Sterner, 2005 Jun 28 --- Fixed to preserve existing map scaling.
  
 Copyright (C) 2005, Johns Hopkins University/Applied Physics Laboratory
  
 This software may be used, copied, or redistributed as long as it is not
  
 sold and this copyright notice is reproduced on each copy made.  This
  
 routine is provided as is without any express or implied warranties
  
 whatsoever.  Other limitations apply as described in the file disclaimer.txt.