FILT_MAP (Mar95)                 suntrans                 FILT_MAP (Mar95)



NAME
    FILT_MAP  --  combined  tasks  APODIZE, REMAP, RUNMEAN, DETREND, and
    MASKDISK.  Disk images in camera or sky  coordinates  are  apodized,
    remapped  and  registered on a heliographic latitude-longitude grid.
    The images may be elliptical.  The residual mean may be removed  and
    the images masked after image registration.
    
    
USAGE
    filt_map inputl outfile trim_file apod (interp_kind maxrad demean op divzero toler
             npix1 npix2 filter_type corr_geom holes_allowed run_write nrmean 
             nimcenter filter_file )
    
    
PARAMETERS
    
    inputl
        input image or list of images
    
    outfile
        template for output image file names
    
    trim_file
        ASCII    file    containing    the    specifications   for   the  
        latitude-longitude grid and the corresponding  mode  coefficient
        trimming  limits.   This  required  input  file  is generated by
        PLM_TRIM and  may  be  reused  for  all  images  with  the  same
        latitude-longitude grid parameters and maximum l value.
    
    apod 
        fraction of solar disk radius to apodize.  0.00 filt_map @imagein j9gon jun250cm.dat 0.05 
    
    2.  Process the solar disk images  in  camera  coordinates  in  list
    imagein.lis.   Apodize using a cosine bell curve on the outer 10% of
    the disk.  Interpolate the disk image and register  the  disk  image
    on  the  solar  latitude-longitude  grid using the specifications in
    the trimming limit file,jun250cm.dat.  Use a block running  mean  of
    17  images  with  the ninth image as the center of the running mean.
    Write the folded images in the heliographic coordinate  system  into
    files begining with j9gon.
    
            su> filt_map @imagein.lis j9gon jun250cm.dat 0.10 
                nrmean=17 nimcenter=9
    
    3.   Process  the  sky  coordinate  images in list imagein.lis.  The
    input images are 1024 pixels by  1024  pixels.   No  apodization  is
    performed.    The  specifications  from  the  trimming  limit  file, 
    jul750cm.dat, are used to interpolate the data and remap  the  image
    on  the  latitude-longitude  grid  specified  in  the trimming limit
    file.  The cubic spline interpolator is  used.   The  specifications
    for  the  temporal  filter  are  found  in file filt.wgt.  Write the
    folded image  in  the  heliographic  coordinate  system  into  files
    begining with mtw4jul.
    
            su> filt_map @imagein.lis mtw4jul jul750cm.dat 0.00 
                interp_kind=spline3 filt_type=usupply npix1=1024 npix2=1024 
                filter_file=filt.wgt
    
    
    
TIME REQUIREMENTS
    The   time  requirements  for  the  ephemeris  computation  and  the 
    apodization are minimal.  On a per image basis,  the  interpolation,
    registration  to the latitude-longitude grid and detrending consumes
    about one third of the  cpu  time  required  between  the  processed
    images  and the time series.  Time on a per image basis for an input
    image  252x256  and  an  output  image  372x220  using   a   bicubic 
    interpolator  is  about  7  seconds  per image on a DECstation 3100.
    Use of a bicubic spline interpolator increases the time  requirement
    by about 10% on the DECstation 3100.
    
    
.ih
    MEMORY   REQUIREMENTS   This   stream-lined  code  works  ONLY  when 
    sufficient memory is available.  Make sure that you have  sufficient
    memory  (24  Mbytes for examples 1 and 2, much more for example 3!!)
    to try this.
    
    
BUGS
    None known.
    
    
SEE ALSO
    apodize, remap, plm_trim, runmean, detrend, maskdisk
    
    disk_image
    
    helio_image