Headers for LASCO IDL Library: LAS-C2

This page was created by IDL lasco_mk_html_help.pro on Wed Aug 17 12:21:56 2005.


List of Routines


Routine Descriptions

ALIGN1.PRO

[List of Routines] (See ./align1.pro)

 NAME:
	ALIGN1.PRO
 PURPOSE:
	Takes two images of EO frange, corrects it from the dark and
       sums both, loading the result into X_display 
 CATEGORY:
	??
 CALLING SEQUENCE:
	 ALIGN1, nom_image1,nom_image2,nom_dark,imas,itest
 INPUTS:
	nom_image1                  one of frange images
       nom_image2                  frange image in oposite side
       nom_dark                    dark image name
	itest                       'V' or 'H' horizontal or vert alignement
 KEYWORD PARAMETERS:               
                                   None
 OUTPUTS:
	imas                        resulting composite image
 COMMON BLOCKS:
	None.
 SIDE EFFECTS:
	None
 RESTRICTIONS:

 PROCEDURE:
	Straightforward.
 MODIFICATION HISTORY:
	Written by A.LL  v.1.0       LAS  08/25/93           


ALIGN1[1]

[List of Routines] (See ./align1.pro)

 NAME:                        dvpt_fra.pro
 PURPOSE:                     make a polar development of OE fringe or
                              of OI blocked fringe
 CATEGORY:                    Processing high level
 CALLING SEQUENCE:            dvpt_fra,ima_in,Xc,Yc,R,delta_R,ima_out
 INPUTS:                      ima_in                          reference's image
 OPTIONAL INPUT PARAMETERS:   Xc,Yc                           fringe's center
                              R                               internal radius
                              delta_R                         width of fringe
 KEYWORD PARAMETERS:          None
 OUTPUTS:                     ima_out                         result frame
 OPTIONAL OUTPUT PARAMETERS:  None
 COMMON BLOCKS:               None
 SIDE EFFECTS:                None
 RESTRICTIONS:                Applications limited to 512*512 frames
 PROCEDURE:
 MODIFICATION HISTORY:   defined by M.B 09/24/93
                         modified by M.B 02/17/94 : LAS

 SCCS variables for IDL use

 @(#)dvpt_fra.pro  1.0 09//93 :LAS


ALIGN1[2]

[List of Routines] (See ./align1.pro)

 NAME:                        ipolarfra.pro
 PURPOSE:                     make the inverse of polar transformation 
                              for OE developped fringe or for OI blocked 
                              developped fringe
 CATEGORY:                    Processing high level
 CALLING SEQUENCE:            ipolarfra,ima_in,Xc,Yc,R,delta_R,ima_out
 INPUTS:                      ima_in                          reference's image
 OPTIONAL INPUT PARAMETERS:   Xc,Yc                           fringe's center
                              R                               internal radius
                              delta_R                         width of fringe
 KEYWORD PARAMETERS:          None
 OUTPUTS:                     ima_out                         result frame
 OPTIONAL OUTPUT PARAMETERS:  None
 COMMON BLOCKS:               None
 SIDE EFFECTS:                None
 RESTRICTIONS:                Applications limited to 512*512 frames
 PROCEDURE:
 MODIFICATION HISTORY:    defined by M.B 02/17/94 : LAS

 SCCS variables for IDL use

 @(#)ipolarfra.pro  1.0 02/17/94 : LAS


ALIGN1[2]

[List of Routines] (See ./align1.pro)

 NAME:                        gener_mask.pro
 PURPOSE:                     make a circular mask for photometry's studies
 CATEGORY:                    Processing high level
 CALLING SEQUENCE:            gener_mask,ima_name,npix,Xc,Yc,R,intval,extval
 INPUTS:                      ima_name                         Name of mask
                              npix                             dimension
 OPTIONAL INPUT PARAMETERS:   Xc,Yc                            circle's coords
                              R                                radius of mask
                              intval                           value inside
                              extval                           value outside
 KEYWORD PARAMETERS:          None
 OUTPUTS:                     ima_name                         mask's frame
 OPTIONAL OUTPUT PARAMETERS:  None
 COMMON BLOCKS:               None
 SIDE EFFECTS:                None
 RESTRICTIONS:                None
 PROCEDURE:
 MODIFICATION HISTORY:   defined by M.B 09/10/93
                         modified by M.B 02/17/94 : LAS

 SCCS variables for IDL use

 @(#)gener_mask.pro  1.0 09/10/93 :LAS


ALIGN1[3]

[List of Routines] (See ./align1.pro)

 NAME:                        diafrai.pro
 PURPOSE:                     apply a circular mask for photometry's studies
                              to a selected frame 
                              (define a circular ROI or apply a diaphragm)
 CATEGORY:                    Processing high level
 CALLING SEQUENCE:            diafrai,ima_name,Xc,Yc,R,intval,extval
 INPUTS:                      ima_name                         Name of image
 OPTIONAL INPUT PARAMETERS:   Xc,Yc                            circle's coords
                              R                                radius of mask
                              intval      value inside to be multiplied
                              extval      value outside to be multiplied
 KEYWORD PARAMETERS:          None
 OUTPUTS:                     ima_name                        image with mask
 OPTIONAL OUTPUT PARAMETERS:  None
 COMMON BLOCKS:               None
 SIDE EFFECTS:                None
 RESTRICTIONS:                None
 PROCEDURE:
 MODIFICATION HISTORY:   defined by M.B 02/17/94 : LAS

 SCCS variables for IDL use

 @(#)diafrai.pro  1.0 02/17/94 :LAS


BUILD_FRAOE

[List of Routines] (See ./align1.pro)

ro build_fraoe, image1, image2, image3, image4, oefringe
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 NAME:
	BUILD_FRAOE
 PURPOSE:
	Takes four images of EO fringe, corrects them from the dark and
       builds composit frame, loading the result into X_display.

 CATEGORY:
	calibration, manipulation
 CALLING SEQUENCE:
	 BUILD_FRAOE, image1, image2, image3, image4, oefringe
 INPUTS:
	image1                      first arc of fringe (up)
       image2                      second & opposite arc of fringe (down)
       image3                      third arc of fringe (left)
       image4                      fourth & opposite arc of fringe (right)

 KEYWORD PARAMETERS:               
                                   None
 OUTPUTS:
	oefringe                    resulting composit image
 COMMON BLOCKS:
	None
 SIDE EFFECTS:
	None
 RESTRICTIONS:
       None
 PROCEDURE:
	Straightforward.
 MODIFICATION HISTORY:
	Written by M.B  v.1.0       LAS  03/03/94           


CALIB5[10]

[List of Routines] (See ./calib5.pro)

 NAME:                         WRITE_IMA
 PURPOSE:                      write image and header to disk file
 CATEGORY:                     BASIC_INTERFACE
 CALLING SEQUENCE:             WRITE_IMAGE,ima_name,image,hdr
 INPUTS:                       ima_name = string of header filename
                               image    = array containing the image
                               hdr      = header to write to disk
 OPTIONAL INPUT PARAMETERS:    None
 KEYWORD PARAMETERS:           None
 OUTPUTS:                      Writes to disk
 OPTIONAL OUTPUT PARAMETERS:   None
 COMMON BLOCKS:                None
 SIDE EFFECTS:                 Creates a new disk file
 RESTRICTIONS:                 Assumes file extensions of .img and .hdr
 PROCEDURE:
 MODIFICATION HISTORY:         RAH 7/2/90
                               M.BOUT 93/11/16  runs for the new structures
                               arrays and headers and saves them in two files

 NOTE: the procedure VISU_IMA is convenient for the displaying of the saved
 files. It's not the case of VISU_CAL.

 @(#)write_ima.pro     1.2 4/10/93 :NRL Solar Physics

common ccd_header,header,nt,tags       ; Modif. A.LL. 93/05/28


CALIB5[11]

[List of Routines] (See ./calib5.pro)

 NAME:                         write_hdr.pro
 PURPOSE:                      write image header to disk file
 CATEGORY:                     General tools low level routine
 CALLING SEQUENCE:             write_hdr,ima_name,hdr
 INPUTS:                       ima_name = string of header filename
                               hdr = header to write to disk
 OPTIONAL INPUT PARAMETERS:    None
 KEYWORD PARAMETERS:           None
 OUTPUTS:                      Writes to disk
 OPTIONAL OUTPUT PARAMETERS:   None
 COMMON BLOCKS:                None
 SIDE EFFECTS:                 Creates a new disk file
 RESTRICTIONS:                 Assumes a file extension of .hdr
 PROCEDURE:
 MODIFICATION HISTORY:         RAH 10/1/89
                               RAH 8/20/91 to use = as keyword delimiter
 SCCS variables for IDL use

 @(#)write_header.pro  1.2 4/10/93 :NRL Solar Physics


CALIB5[12]

[List of Routines] (See ./calib5.pro)

 NAME:                 show_hdr.pro
 PURPOSE:              visualize keywords in Calibration headers
 CATEGORY:             General tools high level routine
 CALLING SEQUENCE:     show_hdr    or    show_hdr,/FULL
 INPUTS:               None
 OPTIONAL INPUT PARAMETERS:   None
 KEYWORD PARAMETERS:   /FULL
 OUTPUTS:              A list of ima_header
 OPTIONAL OUTPUT PARAMETERS:
 COMMON BLOCKS:        None
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:
                               All 4/25/93 for VMS files in general
 SCCS variables for IDL use

 @(#)show_hdr.pro        1.3 4/25/93 :LAS


CALIB5[13]

[List of Routines] (See ./calib5.pro)

 NAME:                 show_ima_hdr.pro
 PURPOSE:              visualize keywords from file headers
 CATEGORY:             General tools high level routine
 CALLING SEQUENCE:     show_ima_hdr, hdr_name 
                       show_ima_hdr, hdr_name,/FULL
 INPUTS:               hdr_name                Name of header file
 OPTIONAL INPUT PARAMETERS:   None
 KEYWORD PARAMETERS:   /FULL
 OUTPUTS:              A list of ima_header
 OPTIONAL OUTPUT PARAMETERS:
 COMMON BLOCKS:        None
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:
                               All 4/25/93 for VMS files in general

		     corrected by M.B according to the new features of headers
		     11/03/93
 SCCS variables for IDL use

 @(#)show_ima_hdr.pro        1.3 4/25/93 :LAS


CALIB5[14]

[List of Routines] (See ./calib5.pro)

 NAME:                 set_cal_hdr.pro
 PURPOSE:              set some keywords in Calibration headers
 CATEGORY:             General tools low level routine
 CALLING SEQUENCE:     set_ima_hdr,ima_header,refpix_x,refpix_y
 INPUTS:               ima_header = structure
                       refpix_x = float, (position of reference 0.,0.)
                       refpix_y = float, (position of reference 0.,0.)
 OPTIONAL INPUT PARAMETERS:    None
 KEYWORD PARAMETERS:   None
 OUTPUTS:              ima_header
 OPTIONAL OUTPUT PARAMETERS:
 COMMON BLOCKS:        None
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:
                               All 4/25/93 for VMS files in general
 SCCS variables for IDL use

 @(#)set_ima_header.pro        1.3 4/10/93 :NRL Solar Physics


CALIB5[15]

[List of Routines] (See ./calib5.pro)

 NAME:                 copy_ima_hdr.pro
 PURPOSE:              procedure to copy a heder structure in other
                       header structure
 CATEGORY:             CCD
 CALLING SEQUENCE:     copy_ima_hdr,header_in,header_out
 INPUTS:               header_in = header input,
                       header_out = new header structure
 OPTIONAL INPUT PARAMETERS:    None
 KEYWORD PARAMETERS:   None
 OUTPUTS:              header_out = filled new header
 OPTIONAL OUTPUT PARAMETERS:
 SIDE EFFECTS:
 RESTRICTIONS: corresponding tags must be of same element type
 PROCEDURE:
 MODIFICATION HISTORY:         All 4/25/93 for VMS files from Fusion
 SCCS variables for IDL use

 @(#)copy_ima_hdr.pro  1.3 4/10/93 :NRL Solar Physics


CALIB5[16]

[List of Routines] (See ./calib5.pro)

 NAME:                  w512.pro
 PURPOSE:               create a 512*512 window
 CATEGORY:              General tools high level routine   
 CALLING SEQUENCE:      extract_ima2, iin, hin, x1, x2, y1, y2, iout, hout  
 INPUTS:                n          Window number
 OPTIONAL INPUT PARAMETERS:  None
 KEYWORD PARAMETERS:    None
 OUTPUTS:               A image Window in the screen
 OPTIONAL OUTPUT PARAMETERS: None
 COMMON BLOCKS:         None
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:   defined by ALL 6/24/93

 SCCS variables for IDL use

 @(#)extract_ima2.pro  1.0 25/6/93 :LAS


CALIB5[17]

[List of Routines] (See ./calib5.pro)

 NAME:                      LOAD_IMA.PRO
 PURPOSE:                   Visualize a image array yet in memory
 CATEGORY:                  General tools high level routine   
 CALLING SEQUENCE:          ima, lcut, hcut, kx, ky  
 INPUTS:                    ima                  image array
                            lcut,hcut            low and hight cut
                            kx, ky               zoom parameters
 OPTIONAL INPUT PARAMETERS: None
 KEYWORD PARAMETERS:        None
 OUTPUTS:                   image on screen
 OPTIONAL OUTPUT PARAMETERS:   None
 COMMON BLOCKS:             None
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:      defined by ALL 6/24/93

 SCCS variables for IDL use

 @(#)load_ima.pro  1.0 25/6/93 :LAS


CALIB5[18]

[List of Routines] (See ./calib5.pro)

 NAME:                       VISU_IMA.PRO
 PURPOSE:                   Put in virtual memory an image array & visualize it
 CATEGORY:                   Visualization high level routine   
 CALLING SEQUENCE:           VISU_IMA, ima_name, hima, ima, kx, ky, lcut, hcut
 INPUTS:                     ima_name                        image_name
                             hima,ima                        IDL assoc names
                             kx, ky                          zoom parameters
			      lcut, hcut		      cuts values
 OPTIONAL INPUT PARAMETERS:  None
 KEYWORD PARAMETERS:         None
 OUTPUTS:                    Image on screen 
 OPTIONAL OUTPUT PARAMETERS: None
 COMMON BLOCKS:              None
 SIDE EFFECTS:               None
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:       defined by ALL 6/24/93

			      modified by M.B 11/04/93
 SCCS variables for IDL use

 @(#)visu_ima.pro  1.0 25/6/93 :LAS


CALIB5[19]

[List of Routines] (See ./calib5.pro)

 NAME:                       LOAD_CAL.PRO
 PURPOSE:                    Visualizes a array image of calibration 
                             (in memory yet)
 CATEGORY:                   Preprocessing high level routine   
 CALLING SEQUENCE:           iout = LOAD_CAL ( ima, lcut, hcut, itest, 
                                              nx_out, ny_out )
 INPUTS:                     ima          image array
                             lcut,hcut    low an hight cuts
                             itest        operating mode for big images
                                          itest eq 1 not rebin
                                          itest ne 1 rebin by 2 if 1124 pix 
                                                     images                          ; OPTIONAL INPUT PARAMETERS:  None
 KEYWORD PARAMETERS:         None
 OUTPUTS:                    Image on screen
                             iout
                             nx_out
                             ny_out
 OPTIONAL OUTPUT PARAMETERS: None
 COMMON BLOCKS:              None
 SIDE EFFECTS:               None
 RESTRICTIONS:               None
 PROCEDURE:
 MODIFICATION HISTORY:   defined by ALL 6/24/93

 SCCS variables for IDL use

 @(#)load_cal.pro  1.0 25/6/93 :LAS


CALIB5[1]

[List of Routines] (See ./calib5.pro)

   CALIB5.PRO

        Upper level routines
        Stat
   Pro EXTRACT_IMA2, iin, hin, x1, x2, y1, y2, iout, hout
                                                   ; extracts a subimage
   Pro STAT_2D_FRM, ima, kx, ky, imb, imc          ;Gives local stats over all
                                                   ;image
   Pro STAT_IMA, ima, x1,y1,x2,y2,z                ;gives stas in a ROI
   Function MIN_2D_FRM, ima, kx,ky
   Function STATIMA, ima,  x1,y1,x2,y2             ;

        Visu

   Pro W512, n                                     ;Creates a 512*512 display
   Pro VISU_IMA, ima_name, hima, ima, kx, ky, lcut, hcut  ;Visualizes an image
   Function LOAD_IMA, ima, lcut, hcut, kx, ky      ;Visualizes a loaded ima;

        Calib. processing

   Pro VISU_CAL,ima_name, iout, hout               ;Gets a CAL ima, rectifies
                                                    and visu. it
   Pro VISU_CAL_CLEAN, ima_name, backg, iout, hout ;Gets a CAL ima, rectifies
                                                    subtracts and visu. it
   Pro READ_CAL,ima_name, itest, iout, hout        ;Gets a CAL ima. rectified
   Pro CLEAN_CAL, ima, hima, itest, iout, hout     ;rectifies a CAL image
   Function LOAD_CAL(ima,hima,lcut,hcut,itest,hout) ;rectifies a CAL image and
                                                     visu. it
   Pro SET_CAL_HDR, hdr, refpix_x, refpix_y        ;Sets cal parameters

        Catalogs of images

   Pro DARK_CATA                                    ; (CATA)
   Pro SHOW_CATALOG                                 ; (CATA)
   Pro CHOOSE_DARK, dark_new_name, drk, hdrk        ; (CATA)
   Pro PRO_CAL, ima_name, drk, hdrk, ima, hima      ;process a CAL with
                                                    catalogued darks (CATA) 
   Pro GET_DRK_NAME, ima_name, ass_name             ; (CATA)

   Pro SET_CATALOG, template, db_ima, nima, ima_name
   Pro FIND_IMA, hdr, ima_db, ima_name
   Pro IMA_LIST, template, ima_db, nfiles
   Function DEFINE_CATALOG( nfiles )

        Basic I/O

   Pro WRITE_IMA, ima_name, ima, hdr               ;Stores an image and a hdr
   Pro SHOW_HDR, ima_hdr, FULL = I                 ;Shows some hdr parameters
   Pro COPY_IMA_HDR, hdr_in, hdr_out               ;Copies a header
   Function READ_IMA( ima_name, hdr, ichoice )     ;opens an image from stor.

        Low level routines

   Function GETTOK(st,char)
   Function DATE_CAL( date, hour )
   Pro DATE_NUM_TEXT,year,month,day,hour
   Function DEFINE_IMA_HDR( dummy )
   Function DEFINE_CAL_HDR( dummy )
   Function DEFINE_BSC_HDR( dummy )
   Function DEFINE_C1_HDR( dummy )
   Function DEFINE_CCD_HDR( dummy )
   Function READ_IMA_HDR( ima_name, hdr, itest )
   Function READ_IMA_FRAME( ima_name, bitpix, nx, ny )
   Pro WRITE_HDR,ima_name, hdr
   Pro CHECK_IMGDIR, dummy
   Pro CHECK_FILENAME, filename, path, extension

   A.LL.


CALIB5[20]

[List of Routines] (See ./calib5.pro)

 NAME: visu_cal_clean.pro
 PURPOSE: Gets a calib. image from disk, subtracts dark, and visualizes it
 CATEGORY: Calibration high level routine   
 CALLING SEQUENCE: VISU_CAL_CLEAN, ima_name, backg, ima, hdr   
 INPUTS: ima_name                         image name of calibration
         backg                            background image array
 OPTIONAL INPUT PARAMETERS:               None
 KEYWORD PARAMETERS:                      None
 OUTPUTS:                                 Image on screen 
         ima                              image array 
         hdr                              header of image array
 OPTIONAL OUTPUT PARAMETERS:              None
 COMMON BLOCKS:                           None
 SIDE EFFECTS: hdr array is defined as DEFINE_IMA_HDR
 RESTRICTIONS: 
 PROCEDURE:
 MODIFICATION HISTORY:   defined by ALL 6/24/93

 SCCS variables for IDL use

 @(#)visu_cal_clean.pro  1.0 25/6/93 :LAS


CALIB5[21]

[List of Routines] (See ./calib5.pro)

 NAME: read_cal.pro
 PURPOSE: Gets a calibration image from disk and visualizes it 
 CATEGORY: Calibrations high level routine   
 CALLING SEQUENCE: READ_CAL, ima_name, itest, ima, hdr  
 INPUTS: ima_name                         image name of calibration
         itest                            =0 rebin si nx = 1124
                                          =1 no rebin pour nx = 1124  
 OPTIONAL INPUT PARAMETERS:               None
 KEYWORD PARAMETERS:                      None
 OUTPUTS:                                 Image on screen 
         ima                              image array 
         hdr                              header of image array
 OPTIONAL OUTPUT PARAMETERS:              None
 COMMON BLOCKS:                           None
 SIDE EFFECTS: hdr array is defined as DEFINE_IMA_HDR
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:   defined by ALL 6/24/93

 SCCS variables for IDL use

 @(#)read_cal.pro  1.0 25/6/93 :LAS


CALIB5[22]

[List of Routines] (See ./calib5.pro)

 NAME: visu_cal.pro
 PURPOSE: Gets a calibration image from disk and visualizes it 
 CATEGORY: Calibrations high level routine   
 CALLING SEQUENCE: VISU_CAL, ima_name, ima, hdr  
 INPUTS: ima_name                         image name of calibration
 OPTIONAL INPUT PARAMETERS:               None
 KEYWORD PARAMETERS:                      None
 OUTPUTS:                                 Image on screen 
         ima                              image array 
         hdr                              header of image array
 OPTIONAL OUTPUT PARAMETERS:              None
 COMMON BLOCKS:                           None
 SIDE EFFECTS: hdr array is defined as DEFINE_IMA_HDR
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:   defined by ALL 6/24/93

 SCCS variables for IDL use

 @(#)visu_cal.pro  1.0 25/6/93 :LAS


CALIB5[23]

[List of Routines] (See ./calib5.pro)

 NAME: CLEAN_CAL.PRO
 PURPOSE: Resizes and rotates a calibration image array
 CATEGORY: Calibrations high level routine   
 CALLING SEQUENCE: CLEAN_CAL, ima, hima, itest, iout, hout   
 INPUTS: ima                              image array of calibration
         hima                             header
         itest                            operating mode for big images
                                          itest eq 1 not rebin
                                          itest ne 1 rebin by 2 if 1124 pix 
                                                     images
 OPTIONAL INPUT PARAMETERS:               None
 KEYWORD PARAMETERS:                      None
 OUTPUTS:iout                             image array 
         hout                             header of image array
 OPTIONAL OUTPUT PARAMETERS:              None
 COMMON BLOCKS:                           None
 SIDE EFFECTS: hdr array is defined as DEFINE_IMA_HDR
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:   defined by ALL 6/24/93

 SCCS variables for IDL use

 @(#)clean_cal.pro  1.0 25/6/93 :LAS


CALIB5[24]

[List of Routines] (See ./calib5.pro)

 NAME: stat_2d_frm.pro
 PURPOSE: Build a image of means and a image of sd (standard deviations) 
 CATEGORY: General tools high level routines, Statistics.
 CALLING SEQUENCE: stat_2d_frm, ima,kx,ky,imb,imc
 INPUTS: ima                              image array
         kx                               step_size in x
         ky                               step_size in y
 OPTIONAL INPUT PARAMETERS:               None
 KEYWORD PARAMETERS:                      None
 OUTPUTS:imb                              image array of means
         imc                              image array of sd. deviations
 OPTIONAL OUTPUT PARAMETERS:              None
 COMMON BLOCKS:                           None
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:   defined by ALL 6/24/93

 SCCS variables for IDL use

 @(#)stat_2d_frm.pro  1.0 25/6/93 :LAS


CALIB5[25]

[List of Routines] (See ./calib5.pro)

 NAME: stat_ima.pro
 PURPOSE: local statistics in a image array (in memory)
 CATEGORY: General tools high level routine   
 CALLING SEQUENCE: stat_ima, ima, x1, x2, y1, y2, z  
 INPUTS: ima                              image array
         x1,x2                            x interval of rectangle
         y1,y2                            y interval of rectangle
 OPTIONAL INPUT PARAMETERS:               None
 KEYWORD PARAMETERS:                      None
 OUTPUTS:z                                array of values
                                          z(0) = ntot
                                          z(1) = sum
                                          z(2) = moy
                                          z(3) = std
 OPTIONAL OUTPUT PARAMETERS:              None
 COMMON BLOCKS:                           None
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:   defined by ALL 6/24/93

 SCCS variables for IDL use

 @(#)stat_ima.pro  1.0 25/6/93 :LAS


CALIB5[26]

[List of Routines] (See ./calib5.pro)

 NAME: MIN_2D_FRM.PRO
 PURPOSE: make an image of local minima
 CATEGORY: General tools high level routine
 CALLING SEQUENCE: ima_out = min_2d_frm( ima_in, kx, ky)
 INPUTS: ima_in                           image array
         kx                               step_size in x
         ky                               step_size in y
 OPTIONAL INPUT PARAMETERS:               None
 KEYWORD PARAMETERS:                      None
 OUTPUTS:ima_out                          mapping of local minima
 OPTIONAL OUTPUT PARAMETERS:              None
 COMMON BLOCKS:                           None
 SIDE EFFECTS:                            None
 RESTRICTIONS:                            None
 PROCEDURE:
 MODIFICATION HISTORY:   defined by M.B and A.LL 26/10/93

 SCCS variables for IDL use

 @(#)min_2d_frm.pro  1.0 26/10/93 :LAS


CALIB5[27]

[List of Routines] (See ./calib5.pro)

 NAME: statima.pro
 PURPOSE: extract a image from another
 CATEGORY: General tools high level routine   
 CALLING SEQUENCE: extract_ima2, iin, hin, x1, x2, y1, y2, iout, hout  
 INPUTS: iin                              image array
         hin                              header of image array
         x1,x2                            x interval of rectangle
         y1,y2                            y interval of rectangle
 OPTIONAL INPUT PARAMETERS:               None
 KEYWORD PARAMETERS:                      None
 OUTPUTS:iout                             extracted image array
         hout                             header for extracted image
 OPTIONAL OUTPUT PARAMETERS:              None
 COMMON BLOCKS:                           None
 SIDE EFFECTS: opens a catalog of darks
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:   defined by ALL 6/24/93

 SCCS variables for IDL use

 @(#)extract_ima2.pro  1.0 25/6/93 :LAS


CALIB5[28]

[List of Routines] (See ./calib5.pro)

 NAME: extract_ima2.pro
 PURPOSE: extract a image from another
 CATEGORY: General tools high level routine   
 CALLING SEQUENCE: extract_ima2, iin, hin, x1, x2, y1, y2, iout, hout  
 INPUTS: iin                              image array
         hin                              header of image array
         x1,x2                            x interval of rectangle
         y1,y2                            y interval of rectangle
 OPTIONAL INPUT PARAMETERS:               None
 KEYWORD PARAMETERS:                      None
 OUTPUTS:iout                             extracted image array
         hout                             header for extracted image
 OPTIONAL OUTPUT PARAMETERS:              None
 COMMON BLOCKS:                           None
 SIDE EFFECTS: opens a catalog of darks
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:   defined by ALL 6/24/93

			  corrected by M.B 11/03/93 for header's filling

 SCCS variables for IDL use

 @(#)extract_ima2.pro  1.0 25/6/93 :LAS


CALIB5[29]

[List of Routines] (See ./calib5.pro)

 NAME:DEFINE_CATALOG.pro
 PURPOSE Sets a array of structures for a image catalog
 CATEGORY: Preprocessing low level
 CALLING SEQUENCE: db = DEFINE_CATALOG(nfiles)
 INPUTS:  nfiles                          Nombre max of files in catalog
 OPTIONAL INPUT PARAMETERS:               None
 KEYWORD PARAMETERS:                      None
 OUTPUTS:                                 a array structure for catalog
 OPTIONAL OUTPUT PARAMETERS:              None
 COMMON BLOCKS:                           None
 SIDE EFFECTS:                            None
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:   defined by ALL 6/24/93

 SCCS variables for IDL use

 @(#)DEFINE_CATALOG.pro  1.0 25/6/93 :LAS


CALIB5[2]

[List of Routines] (See ./calib5.pro)

 NAME:                         define_ima_hdr
 PURPOSE:                      defines a image header structure
 CATEGORY:                     BASIC_INTERFACES
 CALLING SEQUENCE:             hdr = define_ima_hdr(0)
 INPUTS:                       None
 OPTIONAL INPUT PARAMETERS:    None
 KEYWORD PARAMETERS:           None
 OUTPUTS:                      structure array containing initialized an header
 OPTIONAL OUTPUT PARAMETERS:
 COMMON BLOCKS:                None
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:         RAH 10/1/89
                               RAH 8/20/91  Added AES BSBD camera keywords
                               ALL 04/27/93 takes only standard KEYWORDS

 SCCS variables for IDL use

 @(#)define_ima_hdr.pro        1.1 7/6/92 :NRL Solar Physics

;;common ccd_header,header,nt,tags


CALIB5[2]

[List of Routines] (See ./calib5.pro)

 NAME: DATE_NUM_TEXT.PRO
 PURPOSE: Gives a set of date strings, ex: 12, 09, 1994 (for the 12 Sep 1994)
 A.LL. 


CALIB5[30]

[List of Routines] (See ./calib5.pro)

 NAME: IMA_LIST.pro
 PURPOSE: list the catalog of images (corresp to a template) 
 CATEGORY: Preprocessing low level routine   
 CALLING SEQUENCE: DARK_LIST, template, ima_db, nfiles 
 INPUTS: template                         Template to define the list of images
 OPTIONAL INPUT PARAMETERS:               None
 KEYWORD PARAMETERS:                      None
 OUTPUTS:ima_db                           image catalog
         nfiles                           Number of images in catalog
 OPTIONAL OUTPUT PARAMETERS:              None
 COMMON BLOCKS:                           None
 SIDE EFFECTS: opens a catalog of darks
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:   defined by ALL 6/24/93

 SCCS variables for IDL use

 @(#)ima_list.pro  1.0 25/6/93 :LAS


CALIB5[31]

[List of Routines] (See ./calib5.pro)

 NAME: find_ima.pro
 PURPOSE: From the image header finds the asociate dark in dark catalog
 CATEGORY: Preprocessing low level   
 CALLING SEQUENCE: find_ima, hdr, ima_db, ima_name
 INPUTS: hdr                              image header
         ima_db                           image catalog
 OPTIONAL INPUT PARAMETERS:               None
 KEYWORD PARAMETERS:                      None
 OUTPUTS:ima_name                         name of associated image in catalog
 OPTIONAL OUTPUT PARAMETERS:              None
 COMMON BLOCKS:                           None
 SIDE EFFECTS:                            None
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:   defined by ALL 6/24/93

			  corrected by M.B 11/03/93 for darks without shutter

 SCCS variables for IDL use

 @(#)find_ima.pro  1.0 25/6/93 :LAS


CALIB5[32]

[List of Routines] (See ./calib5.pro)

 NAME:                        SET_CATALOG.PRO
 PURPOSE:                     Set a catalog of images in memory 
 CATEGORY:                    Preprocessing  high level routine  
 CALLING SEQUENCE:            SET_CATALOG
 INPUTS:                      template       Template For image names
                              db_dark        Liste of images
                              ndarks         Number of images in catalog
                              drk_name       Associate dark name
 OPTIONAL INPUT PARAMETERS:   None
 KEYWORD PARAMETERS:          None
 OUTPUTS:                     catalog list in the screen
 OPTIONAL OUTPUT PARAMETERS:  None
 COMMON BLOCKS:               None
 SIDE EFFECTS:                opens a catalog of darks if it don't exists
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:   defined by ALL 6/24/93

 SCCS variables for IDL use

 @(#)set_catalog.pro  1.0 25/6/93 :LAS


CALIB5[33]

[List of Routines] (See ./calib5.pro)

 NAME:                           show_catalog.pro
 PURPOSE:                        list the catalog in memory 
 CATEGORY:                       Preprocessing    
 CALLING SEQUENCE:               SHOW_CATALOG
 INPUTS:                         None
 OPTIONAL INPUT PARAMETERS:      None
 KEYWORD PARAMETERS:             None
 OUTPUTS:                        catalog list in the screen
 OPTIONAL OUTPUT PARAMETERS:     None
 COMMON BLOCKS:                  CATA, db_dark, ndarks, drk_name
 SIDE EFFECTS:                   opens a catalog of darks if this dont exists
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:           defined by ALL 6/24/93

 SCCS variables for IDL use

 @(#)show_catalog.pro  1.0 25/6/93 :LAS


CALIB5[34]

[List of Routines] (See ./calib5.pro)

 NAME:                            list_ima_param.pro
 PURPOSE:                         list the catalog in memory 
 CATEGORY:                        Preprocessing    
 CALLING SEQUENCE:                CHOOSE_DARK, drk_new_name, drk, hdrk
 INPUTS:                          template     Template of files names to list
 OPTIONAL INPUT PARAMETERS:       None
 KEYWORD PARAMETERS:              None
 OUTPUTS:                         catalog lis in the screen
 OPTIONAL OUTPUT PARAMETERS:      None
 COMMON BLOCKS:                   None
 SIDE EFFECTS:                    None
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:            defined by ALL 6/24/93

 SCCS variables for IDL use

 @(#)list_ima_param.pro  1.0 25/6/93 :LAS 


CALIB5[35]

[List of Routines] (See ./calib5.pro)

 NAME:                           choose_dark.pro
 PURPOSE:                        defines a dark frame as the active dark 
 CATEGORY:                       Preprocessing    
 CALLING SEQUENCE:               CHOOSE_DARK, drk_new_name, drk, hdrk
 INPUTS                          drk_new_name    Name of dark array
 OPTIONAL INPUT PARAMETERS:      None
 KEYWORD PARAMETERS:             None
 OUTPUTS:                        drk             array of data
                                 hdrh            header of data array
 OPTIONAL OUTPUT PARAMETERS:     None
 COMMON BLOCKS:                  CATA, db_dark, ndarks, drk_name
 SIDE EFFECTS:                   fullfills the dark catalog common
                                 if it don't exists
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:           defined by ALL 6/24/93

 SCCS variables for IDL use

 @(#)choose_dark.pro  1.0 25/6/93 :LAS


CALIB5[36]

[List of Routines] (See ./calib5.pro)

 NAME:                        get_drk_name.pro
 PURPOSE:                     founds de associate dark frame for 
                              a image and gets their name
 CATEGORY:                    Preprocessing high level    
 CALLING SEQUENCE:            get_drk_name, ima_name, drk_name
 INPUTS:                      ima_name                         Name of image
 OPTIONAL INPUT PARAMETERS:   None
 KEYWORD PARAMETERS:          None
 OUTPUTS: ass_name            Name of associate dark frame
 OPTIONAL OUTPUT PARAMETERS:  None
 COMMON BLOCKS:               CATA, db_dark, ndarks, drk_name
 SIDE EFFECTS:                1) defines de found dark as the active dark
                              2) fullfills the dark catalog common if it 
                                 don't exists
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:   defined by ALL 6/24/93

 SCCS variables for IDL use

 @(#)get_drk_name.pro  1.0 25/6/93 :LAS


CALIB5[37]

[List of Routines] (See ./calib5.pro)

 NAME:                        DARK_CATA.pro
 PURPOSE:                     Set a catalog of darks in memory 
 CATEGORY:                    Preprocessing  high level routine  
 CALLING SEQUENCE:            SET_CATALOG
 INPUTS:                      None
 OPTIONAL INPUT PARAMETERS:   None
 KEYWORD PARAMETERS:          None
 OUTPUTS:                     catalog list in the screen
                              Modifies CATA common
 OPTIONAL OUTPUT PARAMETERS:  None
 COMMON BLOCKS:               CATA, db_dark, ndarks, drk_name
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:   defined by ALL 6/24/93

 SCCS variables for IDL use

 @(#)set_catalog.pro  1.0 25/6/93 :LAS
 


CALIB5[38]

[List of Routines] (See ./calib5.pro)

 NAME:                        pro_cal.pro
 PURPOSE:                     get in memory an image and 
                              substracts the right dark 
 CATEGORY:                    Preprocessing high level routine   
 CALLING SEQUENCE:            PRO_CAL, ima_name, drk, hdrk, iout, hout
 INPUTS:                      ima_name       Name of image to process
 OPTIONAL INPUT PARAMETERS:   None
 KEYWORD PARAMETERS:          None
 OUTPUTS:                     drk            Associate dark array
                              hdrk           Associate header of dark
                              iout           Corrected image array
                              hout           Header for corrected image array
 OPTIONAL OUTPUT PARAMETERS:  None
 COMMON BLOCKS:               CATA, db_dark, ndarks, drk_name
 SIDE EFFECTS:                opens a catalog of darks if this doesn't exist
                              and associates a dark to frame
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:        defined by ALL 6/24/93
			       rewritted and corrected by M.B 11/04/93

 SCCS variables for IDL use

 @(#)pro_cal.pro  1.0 25/6/93 :LAS


CALIB5[3]

[List of Routines] (See ./calib5.pro)

 NAME:                    define_C1_Hdr
 PURPOSE:                 defines the C1 (PF) header structure
 CATEGORY:                General tools Low level routine 
 CALLING SEQUENCE:        h=define_C1_hdr (0)
 INPUTS:                  None
 OPTIONAL INPUT PARAMETERS:    None
 KEYWORD PARAMETERS:      None
 OUTPUTS:                 h    struct. array containing initialized an header
 OPTIONAL OUTPUT PARAMETERS:
 COMMON BLOCKS:           none
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:   define_ccd_hdr RAH 10/1/89
 RAH 8/20/91             define_ccd_hdr Added AES BSBD camera keywords
 ALL 6/24/93  Remove common, changes to define_C1_hdr

 SCCS variables for IDL use

 @(#)define_c1_hdr.pro  1.1 7/6/92 :NRL Solar Physics


CALIB5[4]

[List of Routines] (See ./calib5.pro)

 NAME:                  define_cal_hdr
 PURPOSE:               defines header structure for cal. images of C2 and C3
 CATEGORY:              General tools low level routines
 CALLING SEQUENCE:      h=define_cal_hdr (0)
 INPUTS:                None
 OPTIONAL INPUT PARAMETERS:    None
 KEYWORD PARAMETERS:    None
 OUTPUTS:               h struct. array containing initialized an header
 OPTIONAL OUTPUT PARAMETERS:
 COMMON BLOCKS:         none
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:   define_ccd_hdr RAH 10/1/89
 RAH 8/20/91             define_ccd_hdr Added AES BSBD camera keywords
 ALL 6/24/93  Remove common, changes to define_cal_hdr

 SCCS variables for IDL use

 @(#)define_ccd_hdr.pro  1.1 7/6/92 :NRL Solar Physics


CALIB5[5]

[List of Routines] (See ./calib5.pro)

 NAME:                   define_BSC_Hdr
 PURPOSE:                defines the basic header structure for lasco images
 CATEGORY:               General tools low level routine
 CALLING SEQUENCE:       h=define_bsc_hdr (0)
 INPUTS:                 None
 OPTIONAL INPUT PARAMETERS:    None
 KEYWORD PARAMETERS:     None
 OUTPUTS:                struct. array containing initialized an header
 OPTIONAL OUTPUT PARAMETERS:
 COMMON BLOCKS:          none
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:   RAH 10/1/89
 RAH 8/20/91  Added AES BSBD camera keywords
 ALL 6/24/93  Remove common, adapts for a basic set of KEYWORDS

 SCCS variables for IDL use

 @(#)define_bsc_hdr.pro  1.1 7/6/92 :NRL Solar Physics


CALIB5[6]

[List of Routines] (See ./calib5.pro)

 NAME:                         define_CCD_Hdr
 PURPOSE:                      defines the CCD header structure
 CATEGORY:                     CCD low level routine
 CALLING SEQUENCE:             h=define_CCD_hdr (0)
 INPUTS:                       None
 OPTIONAL INPUT PARAMETERS:    None
 KEYWORD PARAMETERS:           None
 OUTPUTS:                      struct. array containing initialized an header
 OPTIONAL OUTPUT PARAMETERS:
 COMMON BLOCKS:                ccd_header,header,nt,tags
                               header = the header structure
                               nt = number of elements in the header
                               tags = string array of names of header items
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:         RAH 10/1/89
                               RAH 8/20/91  Added AES BSBD camera keywords

 SCCS variables for IDL use

 @(#)define_ccd_hdr.pro        1.1 7/6/92 :NRL Solar Physics


CALIB5[7]

[List of Routines] (See ./calib5.pro)

 NAME:                 read_ima_hdr
 PURPOSE:              function procedure to read header from disk file, f
                       and store in a standard header structure type
 CATEGORY:             BASIC_INTERFACES
 CALLING SEQUENCE:     read_ima_hdr,ima_name,ima_header
 INPUTS:               ima_name = string containing the header filename
                       ima_header = structure
                       verbose = 1, print all absent variables
                       verbose = 0, print only a resumee
 OPTIONAL INPUT PARAMETERS:    None
 KEYWORD PARAMETERS:   None
 OUTPUTS:              ima_header = header structure from disk
 OPTIONAL OUTPUT PARAMETERS:
 COMMON BLOCKS:        None
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:         RAH 10/1/89, ACG 11/21/89, rah 1/9/91
                               rah 3/15/91 to account for unrecognized keyword
                               rah 8/20/91 to trim leading and trailing blanks
                               DW  8/27/91 change delimiter to '='
                               DW  2/26/93 put TEMP_FNG in TEMP as well
                               All 4/25/93 for VMS image files in general
                                           Common supression
 SCCS variables for IDL use

 @(#)read_ima_header.pro       1.3 4/10/93 :NRL Solar Physics


CALIB5[8]

[List of Routines] (See ./calib5.pro)

 NAME:                         READ_IMA_FRAME
 PURPOSE:                      reads a image frame from disk
 CATEGORY:                     BASIC_INTERFACE
 CALLING SEQUENCE:             a = read_ima_frame(name,bitpix,nx,ny)
 INPUTS:                       name = string of the name of the file to read
                               bitpix = nb of bits/pixel
                               nx =  nb de pixels en x
                               ny =  nb de pixels en y
 OPTIONAL INPUT PARAMETERS:    None
 KEYWORD PARAMETERS:           None
 OUTPUTS:                      a = array containing the image
 OPTIONAL OUTPUT PARAMETERS:   None
 COMMON BLOCKS:                None
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:         RAH 7/2/90
                               rah 3/21/90 to account for non-integer input fil
                               es
                               rah 3/33/90 to check for datamax & datamin
                               ALL 5/12/93
 SCCS variables for IDL use

 @(#)read_ima_frame.pro        1.3 4/10/93 :NRL Solar Physics


CALIB5[9]

[List of Routines] (See ./calib5.pro)

 NAME:                         read_ima
 PURPOSE:                      reads a image and their header
 CATEGORY:                     BASIC_INTERFACES
 CALLING SEQUENCE:             ima = read_ima(ima_name, hdrima, ichoice)
 INPUTS:                       ima_name  Name of image
                               hdrima    Header structure
                               ichoice   Type of header
                                         0 = IMA, 1 = BSC, 2=CAL, 3=C1
                                         4 = CCD. else external header
 OPTIONAL INPUT PARAMETERS:    None
 KEYWORD PARAMETERS:           None
 OUTPUTS:                      ima       Image frame
                               hdrima    Filled header structure
 OPTIONAL OUTPUT PARAMETERS:
 COMMON BLOCKS:                None
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:         RAH 10/1/89
                               RAH 8/20/91  Added AES BSBD camera keywords
                               ALL 04/27/93 takes only standard KEYWORDS

 SCCS variables for IDL use

 @(#)read_ima.pro      1.1 7/6/92 :NRL Solar Physics


CHECK_FILENAME

[List of Routines] (See ./calib5.pro)

 NAME:
                        check_filename
 PURPOSE:
                        Removes the extension and path from the filename
                        if present

 CALLING SEQUENCE:
                        check_filename,filename
                        check_filename,filename,path,extension

 INPUTS:
                        filename = string to be checked (may be a string array)

 OUTPUTS:
                        filename will be returned without extension and path

 OPTIONAL OUTPUTS:
                        path      = path name
                        extension = extension not including decimal point

 MODIFICATION HISTORY:
                        RAH 10/1/89
                        rah 3/28/91 added array input for filename
                        ALL 5/15/93 adapted to VMS
 SCCS variables for IDL use

 @(#)check_filename.pro        1.1 7/6/92 :NRL Solar Physics


CHECK_IMGDIR

[List of Routines] (See ./calib5.pro)

 NAME:
                               check_imgdir
 PURPOSE:
                               checks !imgdir for a / on the end
 CALLING SEQUENCE:
                               check_imgdir

 INPUTS:                       None
 OPTIONAL INPUT PARAMETERS:    None
 KEYWORD PARAMETERS:           None

 PROCEDURE:
                               if !imgdir does not end with / then puts one on

 MODIFICATION HISTORY:         RAH 3/26/91
                               ALL 5/15/93   adapted to VAX VMS
 SCCS variables for IDL use

 @(#)check_imgdir.pro  1.1 7/6/92 :NRL Solar Physics


CROSSCORR

[List of Routines] (See ./crosscorr.pro)

 NAME:                        crosscorr.pro
 PURPOSE:                     determination of  the function of crossing-
                              correlation between two frames and the off-
                              centering between these two frames.
 CATEGORY:                    Processing high level
 CALLING SEQUENCE:            crosscorr,ima1_in,ima2_in,x1,x2,y1,y2,ima_out,res
 INPUTS:                      ima1_in                  name of 1st frame
                              ima2_in                  name of 2nd frame
                              x1,x2,y1,y2              selected area
 OPTIONAL INPUT PARAMETERS:   None
 KEYWORD PARAMETERS:          None
 OUTPUTS:                     ima_out              cross-correlation frame
                              res                  maxima's area reinterpolated
 OPTIONAL OUTPUT PARAMETERS:  None
 COMMON BLOCKS:               None
 SIDE EFFECTS:                None
 RESTRICTIONS:                The cubic interpolation is maded by Rinter.pro 
                              who has to be compiled before applications.
                              This program runs well with even frames
                              (dimensions paires en X et en Y)
 PROCEDURE:
 MODIFICATION HISTORY:   defined by M.B 01/14/94

 SCCS variables for IDL use

 @(#)crosscorr.pro  1.0 01/17/94 :LAS


CROSSCORRBIS

[List of Routines] (See ./crosscorrbis.pro)

 NAME:                        crosscorrbis.pro
 PURPOSE:                     determination of  the function of crossing-
                              correlation between two frames and the off-
                              centering between these two frames.
 CATEGORY:                    Processing high level
 CALLING SEQUENCE:        crosscorrbis,ima1_in,ima2_in,x1,x2,y1,y2,ima_out,res
 INPUTS:                      ima1_in                  name of 1st frame
                              ima2_in                  name of 2nd frame
                              x1,x2,y1,y2              selected area
 OPTIONAL INPUT PARAMETERS:   None
 KEYWORD PARAMETERS:          None
 OUTPUTS:                     ima_out              cross-correlation frame
                              res                  maxima's area reinterpolated
 OPTIONAL OUTPUT PARAMETERS:  None
 COMMON BLOCKS:               None
 SIDE EFFECTS:                None
 RESTRICTIONS:                The sinc interpolation is maded by resample.pro
                              included in utilities.pro who has to be compiled
                              before applications.
                              This program runs well for even frames 
                              (dimensions paires en X et en Y)
 PROCEDURE:
 MODIFICATION HISTORY:   defined by M.B 01/20/94

 SCCS variables for IDL use

 @(#)crosscorrbis.pro  1.0 01/20/94 :LAS


DATE_CAL

[List of Routines] (See ./calib5.pro)

 NAME:
	DATE_CAL
 PURPOSE:
	Procedure to perform conversion of dates to decimal form

	format: string (ascii text) encoded as
		DD MON YEAR for date
               HH:MM:SS.SS for hour
		(eg.  14 JUL 1987 15:25:44.23)

 CALLING SEQUENCE
	jt = DATE_CAL( DATE, HOUR )

 INPUTS:
	DATE - input date in one of the three possible formats
 OUTPUTS:
	The converted date is returned as the function value.
 HISTORY:
	version 1  D. Lindler  July, 1987
       adapted for IDL version 2  J. Isensee  May, 1990
       adapted from DATE_CONV to lasco use A.LL. 
       990126 Ed Esfandiari   Fixed for Y2K problem.


DCURSOR.PRO

[List of Routines] (See ./dcursor.pro)

 NAME:
       DCURSOR.PRO
 PURPOSE:
       put the pixels coordinates & the pixels values selected with the
       cursor in a table that can be readed.
 CATEGORY:
       array manipulation
 CALLING SEQUENCE:
       DCURSOR, ima, tab_name, n_points
 INPUTS:
       ima                         image array (in memory)
       tab_name                    name of table that receives the values
       n_points                    number of points in the table
 KEYWORD PARAMETERS:
                                   None
 OUTPUTS:
       values writted in the table
 COMMON BLOCKS:
       None.
 SIDE EFFECTS:
       None
 RESTRICTIONS:

 PROCEDURE:
       Straightforward.
 MODIFICATION HISTORY:
       Written by M.B  v.1.0       : LAS  01/27/94


DRAWCIRCLE

[List of Routines] (See ./drawcircle.pro)

ro drawcircle, ima_in, x_cntr, y_cntr, radius, ptyp, psiz, color
; Draw a circle of given radius and given center on a frame
; Created by M.B on 31/01/94 : LAS  v1.0
; Modified by M.B on 17/02/94 : LAS
; inputs :
;         ima_in           image that receives the picture
;         x_cntr, y_cntr   center coordinates of the drawn circle
;         radius           radius of the drawn circle
;         ptyp             selected drawn points (0 --> 9)
;         psiz             heigth of the drawn points (scale*1.)
;         color            color of the drawn points (0(black) --> 255(white))
; outputs :
;         on the selected window, the picture appears


FILTGAUSS

[List of Routines] (See ./filtgauss.pro)

 NAME:                        filtgauss.pro
 PURPOSE:                     gaussian filtering applications
 CATEGORY:                    Processing high level
 CALLING SEQUENCE:            filtgauss,ima_in,width,ima_out
 INPUTS:                      ima_in                   name of frame
                              width                    width '1/e' of gaussian
 OPTIONAL INPUT PARAMETERS:   None
 KEYWORD PARAMETERS:          None
 OUTPUTS:                     ima_out                  resulting frame
 OPTIONAL OUTPUT PARAMETERS:  None
 COMMON BLOCKS:               None
 SIDE EFFECTS:                None
 RESTRICTIONS:                Applications limited to 512*512 frames
 PROCEDURE:
 MODIFICATION HISTORY:   defined by M.B 01/07/94

 SCCS variables for IDL use

 @(#)filtgauss.pro  1.0 01/07/94 :LAS


GCURSOR

[List of Routines] (See ./gcursor.pro)

RO GCURSOR,TABLE_NAME,N_POINTS
	created by M.BOUT, LAS, 931118
       the graphic cursor becomes enable and a group of points taken on the 
       plot are printed & writed into a given table.


GETTOK

[List of Routines] (See ./calib5.pro)

 NAME:
	GETTOK                                    
 PURPOSE:
	Function to retrieve the first part of the string
	until the character char is encountered.

 CALLING SEQUENCE:
	token = gettok( st, char )

 INPUT:
	char - character separating tokens, scalar string

 INPUT-OUTPUT:
	st - (scalar) string to get token from (on output token is removed)

 OUTPUT:
	token - scalar string value is returned 

 EXAMPLE:
	If ST is 'abc=999' then gettok(ST,'=') would return
	'abc' and ST would be left as '999' 

 HISTORY
	version 1  by D. Lindler APR,86
	Remove leading blanks    W. Landsman (from JKF)    Aug. 1991


LUX_DIFF

[List of Routines] (See ./lux_diff.pro)

 NAME:                        lux_diff.pro
 PURPOSE:                     make an image of the scattering function
 CATEGORY:                    Processing high level
 CALLING SEQUENCE:            lux_diff,ima_name,Xc,Yc,OPTION,A,B
 INPUTS:                      ima_name                       Name of result
 OPTIONAL INPUT PARAMETERS:   Xc,Yc                          center's coords
                              OPTION                         function's chars
 KEYWORD PARAMETERS:          None
 OUTPUTS:                     ima_name                       scattering funct
 OPTIONAL OUTPUT PARAMETERS:  None
 COMMON BLOCKS:               None
 SIDE EFFECTS:                None
 RESTRICTIONS:                Applications limited to 512*512 frames
 PROCEDURE:
 MODIFICATION HISTORY:   defined by M.B 10/11/93

 SCCS variables for IDL use

 @(#)lux_diff.pro  1.0 10/11/93 :LAS


PATTERN1[1]

[List of Routines] (See ./pattern1.pro)

 NAME: FILTMEDIAN.PRO
 PURPOSE: apply a median filter and rebin in the same time.
 CATEGORY: General tools high level routine
 CALLING SEQUENCE: filtmedian,ima_in,kx,ky,ima_out
 INPUTS: ima_in                           image array
         kx                               step_size in x
         ky                               step_size in y
 OPTIONAL INPUT PARAMETERS:               None
 KEYWORD PARAMETERS:                      None
 OUTPUTS:ima_out                          resulting frame
 OPTIONAL OUTPUT PARAMETERS:              None
 COMMON BLOCKS:                           None
 SIDE EFFECTS:                            None
 RESTRICTIONS:                            None
 PROCEDURE:
 MODIFICATION HISTORY:   defined by M.B 20/01/94

 SCCS variables for IDL use

 @(#)filtmedian.pro  1.0 20/01/94 :LAS


PATTERN1[2]

[List of Routines] (See ./pattern1.pro)

ro pattern1,ima1,ima2,ima3,ima4,difres
;; by M.B :LAS  21/01/94  extract & display the pattern of ccd


PATTERN1[2]

[List of Routines] (See ./pattern1.pro)

ro pattern2,difres1,difres2,difres_out
;; by M.B   :LAS 21/01/94  magnify the pattern (shunt aleatory peaks) & give
;;                         the signal/noise ratio


PCURSOR.PRO

[List of Routines] (See ./simcircle.pro)

 NAME:
       PCURSOR.PRO
 PURPOSE:
       Plot cursor position on display and
       put the pixels coordinates selected with the
       cursor in a table that can be readed.
 CATEGORY:
       array manipulation
 CALLING SEQUENCE:
       PCURSOR,IMA,TAB_NAME
 INPUTS: 
    		IMA	    : IMAGE INPUT
 KEYWORD PARAMETERS:
                                   None
 OUTPUTS:
  		TAB_NAME    : table des  coordonnees des points selectionnes		
	
 COMMON BLOCKS:
       None.
 SIDE EFFECTS:
       None
 RESTRICTIONS:

 PROCEDURE:
       Straightforward.
 MODIFICATION HISTORY:
       Written by JP.L & M.B  v.1.0       : LAS  01/27/94


POLM1M2[1]

[List of Routines] (See ./polm1m2.pro)

 NAME: MEAN_2D_FRM.PRO
 PURPOSE: make an image of local means and of standard deviation
 CATEGORY: General tools high level routine
 CALLING SEQUENCE: mean_2d_frm,ima_in,kx,ky,ima_moy,ima_std
 INPUTS: ima_in                           image array
         kx                               step_size in x
         ky                               step_size in y
 OPTIONAL INPUT PARAMETERS:               None
 KEYWORD PARAMETERS:                      None
 OUTPUTS:ima_moy                          mapping of local means
         ima_std                          mapping of local sigmas
 OPTIONAL OUTPUT PARAMETERS:              None
 COMMON BLOCKS:                           None
 SIDE EFFECTS:                            None
 RESTRICTIONS:                            None
 PROCEDURE:
 MODIFICATION HISTORY:   defined by M.B 07/12/93

 SCCS variables for IDL use

 @(#)mean_2d_frm.pro  1.0 07/12/93 :LAS


POLM1M2[2]

[List of Routines] (See ./polm1m2.pro)

 NAME: POLM1M2.PRO
 PURPOSE: make images of local means and of standard deviation for
          the Stokes parameters, the fractionnal polarization & direction of 
          polarization for the light of calib lamps after passing thru mirrors 
 CATEGORY: General tools high level routine
 CALLING SEQUENCE: polm1m2,I1p,I2p,I3p,kx,ky,P_moy,P_std,alpha_moy,alpha_std
 INPUTS: I1p                              image array of intensity with pol-60
         I2p                              image array of intensity with pol00
         I3p                              image array of intensity with pol+60
         kx                               step_size in x
         ky                               step_size in y
 OPTIONAL INPUT PARAMETERS:               None
 KEYWORD PARAMETERS:                      None
 OUTPUTS:P_moy                         mapping of local means for polarization
         P_std                         mapping of local sigmas for polarization
         alpha_moy                     mapping of local means for direction
         alpha_std                     mapping of local sigmas for direction
 OPTIONAL OUTPUT PARAMETERS:              None
 COMMON BLOCKS:                           None
 SIDE EFFECTS:                            None
 RESTRICTIONS:                            None
 PROCEDURE:
 MODIFICATION HISTORY:   defined by M.B 07/12/93

 SCCS variables for IDL use

 @(#)polm1m2.pro  1.0 07/12/93 :LAS


REPLACIMA.PRO

[List of Routines] (See ./align1.pro)

 NAME:
	REPLACIMA.PRO
 PURPOSE:
         Select an interval of pixels values and replace these one by another
 CATEGORY:
	??
 CALLING SEQUENCE:
	REPLACIMA, IMA, minval, maxval, selectval
 INPUTS:
	ima                          image array (in memory)
       minval                       lower cuts value selected
       maxval                       higher cuts value selected
       selectval                    new value of pixels between lcuts & hcuts
 KEYWORD PARAMETERS:               
                                   None
 OUTPUTS:
          ima with the selected intervals replaced
 COMMON BLOCKS:
	None.
 SIDE EFFECTS:
	None
 RESTRICTIONS:

 PROCEDURE:
	Straightforward.
 MODIFICATION HISTORY:
	Written by M.B  v.1.0       LAS  12/13/93           


RINTER

[List of Routines] (See ./crosscorr.pro)


UNCTION RINTER, P, X, Y, DFDX, DFDY
+
 NAME:
	RINTER
 PURPOSE:
	Cubic interpolation of an image at a set of reference points
	points.   Optionally obtain the X and Y derivatives at 
	these points.    Used by the DAOPHOT PSF sequence but can also
	be for general cubic interpolation.

 CALLING SEQUENCE:
	Z = RINTER( P, X, Y, [ DFDX, DFDY ] )

 INPUTS:                 
	P  - Two dimensional data array, 
	X  - Either an N element vector or an N x M element array,
		containing X subscripts where cubic interpolation is desired.
	Y -  Either an N element vector or an N x M element arra, 
		containing Y subscripts where cubic interpolation is desired.

 OUTPUT:
	Z -  Result = interpolated vector or array.  If X and Y are vectors,
		then so is Z, but if X and Y are arrays then Z will be also.
		If P is DOUBLE precision, then so is Z, otherwise Z is REAL.

 OPTIONAL OUTPUT:
	DFDX - Vector or Array, (same size and type as Z), containing the 
		derivatives with respect to X
	DFDY - Array containing derivatives with respect to Y

 EXAMPLE:
	suppose P is a 256 x 256 element array and X = FINDGEN(50)/2. + 100.
	and Y = X.  Then Z will be a 50 element array, containing the
	cubic interpolated points.

 SIDE EFFECTS:
	can be time consuming.

 RESTRICTION:
	Interpolation is not possible at positions outside the range of 
	the array (including all negative subscripts), or within 2 pixel
	units of the edge.  No error message is given but values of the 
	output array are meaningless at these positions.

 PROCEDURE:
	invokes CUBIC interpolation algorithm to evaluate each element
	in Z at virtual coordinates contained in X and Y with the data
	in P.                                                          

 COMMON BLOCKS:
	If repeated interpolation of the same array is to occur, then
	one can save time by initializing the common block RINTER
 REVISION HISTORY:
	March 1988 written W. Landsman STX Co.
	Checked for IDL Version 2, J. Isensee, September, 1990
	Corrected call to HISTOGRAM, W. Landsman November 1990


SIMCIRCLE

[List of Routines] (See ./simcircle.pro)

unction round1,var
 ;; by JP.L & M.B at LAS : 02/11/94
 ;;Arrondit la variable a la valeur la plus proche


STAT_CURSOR.PRO

[List of Routines] (See ./align1.pro)

 NAME:
	STAT_CURSOR.PRO
 PURPOSE:
	Draws a box in a image and does a statistic (mean and standard 
       deviation inside
 CATEGORY:
	??
 CALLING SEQUENCE:
	STAT_CURSOR, ima
 INPUTS:
	ima                          image array (in memory)
 KEYWORD PARAMETERS:               
                                   None
 OUTPUTS:
	Values
 COMMON BLOCKS:
	None.
 SIDE EFFECTS:
	None
 RESTRICTIONS:

 PROCEDURE:
	Straightforward.
 MODIFICATION HISTORY:
	Written by A.LL  v.1.0       LAS  08/25/93           


T_PARAM.PRO

[List of Routines] (See ./t_param.pro)

 PROJECT:
      SOHO - LASCO
 NAME:
     t_param.pro
 PURPOSE:
     Gets main telescope parameters
 CALLING SEQUENCE:
     value = t_param( detector, key )
 EXAMPLE
     pixsze = t_param('C2','PIXEL')
 INPUTS:
     detector   'C1','C2','C3'                       STRING
     key        parameter name                       STRING
                'PIXEL'   pixelsize  (in mm)
                'SCALE'   angular scale for pixel  (in deg)
                'FOCAL'   equivalent focal (in mm)
                'FIELD'   field (in deg)
                'DFIELD'  diagonal field (in deg)
                'BIAS'    electric bias of each amplifier (in ADU)
                            get byas from  offset_bias.pro (needs the header)
                'OCCULTER' radius of occlusion due to internal oculter
                           in 'CCD pixel units'
                'DISTORTION' set of coefs of distortion (to be used in mm)
                              NOTE: drho = a0*rho+a1*rho^3+a2*rho^5
                'DISCNTR' distortion center (in mm)
                'CENTER'  Sun center (in pixels)
                'OCCENTER' occulter center (in pixels)
 KEYWORD INPUT
     none
 OUTPUTS:
     value      searched value
 OUTPUTS INPUTS:
     none
 PROCEDURE:
     Gets parameters from a set of internal data 
 CALLED PROCEDURES:
     none

 HISTORY:
     Def. and code: A.Llebaria (LAS-CNRS)    Aug 1996 
     Corrected and modified by Dr. M.-V. Bout on March, 4th, 1998
 NOTA :

   Distortion parameters:               ; rho*(a0+a1*rho^2+a2*rho^4)
   history
           pm.distortion = [0.0060519645, -0.00014672423, 2.0899603e-07]
 list9604_1ora_00_g_ldist.dat
           pm.distortion = [0.0051344125, -0.00012233862, 1.0978595e-07]  
 list9603_1ora_00_a_ldist.dat
           pm.distortion = [0.0044836143, -0.00011276272, 5.9968042e-08]  
 list9602_2ora_00_a_ldist.dat
           pm.distortion = [0.0051344125, -0.00012233862, 1.0978595e-07]  
 list9603_1ora_00_a_ldist.dat
           pm.distortion = [0.0056511656, -0.00013827504, 1.6940201e-07]  
 list9604_1ora_00_h_ldist.dat


UTILITIES

[List of Routines] (See ./utilities.pro)

.NAME:
	utilities.pro

.PURPOSE:
	Define a bunch of handy IDL utilities.

.COMMENT:
	Compile with ".run utilities" from IDL V2.

.AUTHOR:
	Hans-Martin Adorf
	Space Telescope - European Coordinating Facility
	European Southern Observatory
	D-8046 Garching bei Muenchen
	Karl-Schwarzschild-Str. 2
	F.R. Germany
	Internet: adorf@eso.org		SPAN:  ESO::ADORF or adorf@eso.span

.MODIFICATION HISTORY:
	Jul 1990	HMA	Initial implementation
	Aug 1990	HMA	Further improvements
	Sep 1991	HMA	Some comments provided
       Oct 1991	HMA	Added new features
       Feb 1992        HMA     Added new utilities
       jan 1994        M.B     Truncated version for IDL v 3.1.1 <==> LASCO

.TO DO
	Introduce global variables to control, e.g. the verbosity of
	graphics and image display of intermediate results.


VIGNETTAGE[1]

[List of Routines] (See ./vignettage.pro)


unction vignettage,xc,yc
;  created by M.B on 02/02/94 at LAS
;  modified by M.B on 04/03/94 at LAS
;  construction of a normalized model of vignetting function for LASCO
;  This model can be used for vignetting of solar corona frames
;  inputs :
;
;          xc,yc   center coordinates of internal occultor
;
;  outputs :
;          model         name of the resultant image
;
;  restrictions :
;          the generated model is 512*512 pixels


VIGNETTAGE[2]

[List of Routines] (See ./vignettage.pro)

 NAME:                        crevig.pro
 PURPOSE:                     construction of the vignetting function for
                              LASCO/C2 coronagraph using the bidimensionnal
                              convolution filtering method
 CATEGORY:                    Processing high level
 CALLING SEQUENCE:            crevig,ima_name,off_x,off_y
 INPUTS:                      ima_name      name of the simulation result
                              off_x,off_y   off-centering of the occultor

 OPTIONAL INPUT PARAMETERS:   None
 KEYWORD PARAMETERS:          None
 OUTPUTS:                     image of given name

 OPTIONAL OUTPUT PARAMETERS:  None
 COMMON BLOCKS:               None
 SIDE EFFECTS:                None
 RESTRICTIONS:                This procedure is adapted to 512*512 frames
 PROCEDURE:
 MODIFICATION HISTORY:   defined by M.B 02/07/94

 SCCS variables for IDL use

 @(#)crevig.pro  v 1.0 02/07/94 :LAS


VIGNETTAGE[2]

[List of Routines] (See ./vignettage.pro)

unction lunule,R1,R2,d


VIGNETTAGE[3]

[List of Routines] (See ./vignettage.pro)


ro crevig,ima_name,off_x,off_y


WRITIMA.PRO

[List of Routines] (See ./align1.pro)

 NAME:
	WRITIMA.PRO
 PURPOSE:
	Draws a box in an image and replaces all pixels values inside
       the box by the given value
 CATEGORY:
	??
 CALLING SEQUENCE:
	WRITIMA, ima, val
 INPUTS:
	ima                          image array (in memory)
       val                          value to be written
 KEYWORD PARAMETERS:               
                                   None
 OUTPUTS:
	ima with the selected intervals replaced
 COMMON BLOCKS:
	None.
 SIDE EFFECTS:
	None
 RESTRICTIONS:

 PROCEDURE:
	Straightforward.
 MODIFICATION HISTORY:
	Written by M.B  v.1.0       LAS  12/13/93           


This page was created by IDL lasco_mk_html_help.pro on Wed Aug 17 12:21:56 2005.