Extended IDL Help

This page was created by the IDL library routine mk_html_help. For more information on this routine, refer to the IDL Online Help Navigator or type:

     ? mk_html_help

at the IDL command line prompt.

Last modified: Wed Mar 31 06:40:37 1999.


List of Routines


Routine Descriptions

COMBINE_MVI

[Next Routine] [List of Routines]
 Project     : SOHO - LASCO/EIT

 Name        : COMBINE_MVI

 Purpose     : Insert frames from one mvi into another to create combined movie.

 Explanation : This procedure combines movies from different telescopes by inserting
		frames from mvi1 inside mvi2.  The cadence is determined by mvi1 (the
		inner field).  The nearest frame in time from mvi2 is found for each
		frame of mvi1.  The mvi1 frame is then CONGRID'd to the pixel size
		of mvi2 (the outer field) and inserted into the mvi2 frame.
               WRUNMOVIE is then called for animation.

 Use         : COMBINE_MVI, mvi1, mvi2, CUTOFF=cutoff, /PROMPT

      Example: IDL> COMBINE_MVI, 'c2.mvi', 'c3.mvi', CUTOFF=5.5

 Inputs      : mvi1 : Filename of mvi file for inner field.
               mvi2 : Filename of mvi file for outer field.

 Outputs     : None.

 Keywords    : /PROMPT	: Set this keyword to be prompted for centers and scale factors.
		      	  Otherwise they are read from .mvi files.
               CUTOFF=cutoff : Set this keyword to the boundary desired between the inner and
				outer fields (Units of Rsun).  Defaults are:
				IF EIT is inner image : cutoff is 1.3
				IF C1  is inner image : cutoff is 2.2
				IF C2  is inner image : cutoff is 5.5
		SPLIT_COLORS: Set this keyword to split color table in
		              output mvi between those in the input mvis.
               INNER : Setting this keyword will CONGRID the outer field image (mvi2) to the 
                       pixel size of the inner field image (mv1). It uses the portion of the
                       original image that corresponds to the new
                       field of view for speed.
               FOV    : Set this keyword to the desired size (in pixels)
               of the final movie. If the final dimensions are larger than 1024^2, the program
               prompts for values. (Default = size of mvi2 < 1024). FOV can either 1- or 
               2-element array.

 Calls       : WRUNMOVIE

 Category    : Image Processing/Display.

 Prev. Hist. : None.

 Written     : Scott Paswaters, NRL, Apr 1997.

 Modified    : SEP 03 Apr 97 - Released.
		SPP 10 Oct 97 - Added SPLIT_COLORS keyword and code to
                               allow splitting of color table.
               AV  16 Dec 97 - Added INNER & FOV keywords, shift_calc
                               proc (for clarity).
               SEP 17 Dec 97 - Modified to always include all frames from both movies.
 Version     :

 @(#)combine_mvi.pro	1.2 09/12/97 :NRL Solar Physics

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/combine_mvi.pro)


DAILY_MOVIE

[Previous Routine] [Next Routine] [List of Routines]
 NAME:
	DAILY_MOVIE

 PURPOSE:
	This procedure supplies a set of standard parameters for the MKMOVIE 
	procedure to easily make a movie for all of the images in a given date

 CATEGORY:
	LASCO DATA ANALYSIS

 CALLING SEQUENCE:
	DAILY_MOVIE, Tel, Dte

 INPUTS:
	Tel:	A string denoting the telescope: 'C1', 'C2', 'C3', 'EIT'
	Dte:	A string giving the date:  '960331'

 OPTIONAL INPUTS:
	Ndy:	The number of days to use in forming the movie.  The default
		is 1 day.

 KEYWORD PARAMETERS:
	DIFF:	If this keyword is set difference images will be generated
	UNSHARP:	If this keyword is set unsharp mask images will be 
		generated, in which the size of the box is set to the value.

 SIDE EFFECTS:
	If a list file in the image directory doesn't exist, one will be
	written in the user's home directory.

 PROCEDURE:
	Performs validity checks on dte and tel inputs.
	Determines if a filename of '*list*' exists in the image directory.

 EXAMPLE:
	To see a movie in difference images for telescope C3 for 1 Apr 96:

		DAILY_IMAGE,'C3','960401',/diff

	To see a movie in unsharp masked images for telescope C3 for 1 Apr 96:

		DAILY_IMAGE,'C3','960401',unsharp=15

 MODIFICATION HISTORY:
 	Written by:	RA Howard, 21 Apr 1996


	@(#)daily_movie.pro	1.3 09/12/97 LASCO IDL LIBRARY

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/daily_movie.pro)


EDITFRAME

[Previous Routine] [Next Routine] [List of Routines]
 Project	: SOHO -LASCO/EIT

 Name		: EDITFRAME

 Purpose	: This tool allows the user to edit a particular image "on the
		  fly," while the WRUNMOVIE3 procedure is running.

 Use		: EDITFRAME, in, out, [moviev]

 Arguments	: in - The input, or original image
		  out - The output, or final image
		  moviev - a structure generated by the WRUNMOVIE3 program,
			containing information about the movie.  If moviev
			is not provided, then certain features of the program,
			such as referencing images by "Current frame", will
			not be supported.

 Calls		: LASCO_READFITS

 Comments	:

 Side effects	: None

 Category	: Image Processing

 Written	: Scott Hawley, NRL Jul 15, 1996

 Version	:

 See Also	: WRUNMOVIE3.PRO

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/editframe.pro)


GENERIC_MOVIE

[Previous Routine] [Next Routine] [List of Routines]
 Project     : SOHO - LASCO/EIT
                   
 Name        : GENERIC_MOVIE
               
 Purpose     : Load various data formats into pixmaps and call WRUNMOVIE for animation.
               
 Explanation : This procedure is a generic interface to converting data
		(image files or data cubes) into the LASCO MVI format.
		The user can then save the movie in MVI format and use
		routines such as wrunmovie.pro, combine_mvi.pro, mvi2mpg.pro, 
		put_mvi.pro etc. for MVI manipulation.
               
 Use         : GENERIC_MOVIE, data[, bmin, bmax], /SXT, /MK3

 Inputs      : data : can be:
		       - 3 dimensional byte array (nx,ny,len)
		       - name of file containing names of images
		       - strarr of names of images
		    	(images can be of type: .fits, .gif, .pict, .tiff)

 Optional Inputs: bmin, bmax : Minimum and maximum DN for BYTSCL.
               
 Outputs     : None.
               
 Keywords    : /SXT	: Data is YOHKOH/SXT FITS files.
		/MK3    : Data is Mauna-Loa Mark3 Coronagraph rpb files.

 Calls       : WRUNMOVIE

 Side effects: Creates multiple pixmaps.
               
 Category    : Image Display/Animation.
               
 See Also    : WMKMOVIE.PRO is a widget front-end to making LASCO/EIT movies.
               
 Prev. Hist. : None.

 Written     : Scott Paswaters, NRL, 1996.
               
 Modified    : SEP 16 Dec 97 - Added /SXT keyword
                             - Added /MK3 keyword
               SEP 06 Jan 98 - Added .pict, .tiff support
               DW  21 Jan 99 - Y2K Fix for Yohkoh date

 Version     : 

 SCCS variables for IDL use
 
 @(#)generic_movie.pro	1.5 01/21/99 :NRL Solar Physics

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/generic_movie.pro)


GIF2JPG24

[Previous Routine] [Next Routine] [List of Routines]
 NAME:
	GIF2JPG24

 PURPOSE:
	Change GIF format to 24 bit color JPEG

 CATEGORY:
	Image Processing

 CALLING SEQUENCE:

	GIF2JPG24, Gif_image,R,G,B,Jsize_x,Jsize_y,Jpg_image

 
 INPUTS:
        Gif_image 
        R           red color table
        G           green color table
        B           blue color table
        Jsize_x     desired horz size of jpg
        Jsize_y     desired vert size of jpg

 OPTIONAL INPUTS:
	
 KEYWORD PARAMETERS:

 OUTPUTS:
        Jpg_image   byte array (jsize_x,jsize_y,3) in 24 bit color with color info in 3rd dim

 OPTIONAL OUTPUTS:

 COMMON BLOCKS:

 SIDE EFFECTS:

 RESTRICTIONS:

 PROCEDURE:

 EXAMPLE:
 	To change a GIF to a 1024x1024 JPEG

	GIF2JPG24, Gif_image,R,G,B,1024,1024,Jpg_image

 MODIFICATION HISTORY:
 	Written by:	Dennis Wang, 18 Mar 1999

	@(#)gif2jpg24.pro	1.1 03/19/99 LASCO IDL LIBRARY

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/gif2jpg24.pro)


GIFDIR2JPG24

[Previous Routine] [Next Routine] [List of Routines]
 NAME:
	GIFDIR2JPG24

 PURPOSE:
 	Converts all the GIFS in gif_dir to 24 bit JPEGs in another directory 

 CATEGORY:
	Image Processing.

 CALLING SEQUENCE:

		GIFDIR2JPG24,Gif_dir,Jpg_dir,Jsize_x,Jsize_y

 INPUTS:
 	 	Gif_dir
         	Jpg_dir
		Jsize_x		horz size for JPEGS
		Jsize_y         vert size for JPEGS

 OPTIONAL INPUTS:
	
 KEYWORD PARAMETERS:

 OUTPUTS:
	Output directory contains a 24 bit color JPEG for each GIF in the input directory

 OPTIONAL OUTPUTS:

 COMMON BLOCKS:

 SIDE EFFECTS:

 RESTRICTIONS:

 PROCEDURE:

 EXAMPLE:

		GIFDIR2JPG24,'./gifs','./jpg24',1024,1024

 MODIFICATION HISTORY:
 	Written by:	Dennis Wang, 18 Mar 1999

	@(#)gifdir2jpg24.pro	1.1 03/19/99 LASCO IDL LIBRARY

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/gifdir2jpg24.pro)


HT_HEADER

[Previous Routine] [Next Routine] [List of Routines]
 NAME:
	HT_HEADER

 PURPOSE:
	This procedure writes out the header information for a height-time
	file.  It is used by the movie program and is not intended to be
	used in a standalone fashion.

 CATEGORY:
	MOVIE

 CALLING SEQUENCE:
	HT_HEADER,Moviev

 INPUTS:
	Moviev:	Structure containing the movie header information

 SIDE EFFECTS:
	Creates a height-time file and prints out the preamble

 MODIFICATION HISTORY:
 	Written by:	Scott Hawley, NRL summer student, July 1996

	@(#)ht_header.pro	1.1 09/12/97 LASCO IDL LIBRARY

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/ht_header.pro)


MAKE_VHS_GIF

[Previous Routine] [Next Routine] [List of Routines]
 NAME:
	MAKE_VHS_GIF

 PURPOSE:
	This procedure makes a series of gif files from a movie, 
	stored in mvi format for putting onto a VHS tape

 CATEGORY:
	Movie

 CALLING SEQUENCE:
	MAKE_VHS_GIF,Gif_file


 INPUTS:
	Gif_file:	A string giving the root file name of the gifs:
			It should be no more than 8 characters.  It is
			suggested that the name should end in gif, leaving
			5 characters for the useful information.  The
			files will then have an extension of 001, 002, etc.
			A path can be included at the beginning of the string.

 OPTIONAL INPUTS:
	Movie_file:	The name of the .mvi file.  If this is not present
			you will be allowed to select the file.
	
 KEYWORD PARAMETERS:
	Title:		An optional title to be added to the top of the image.

 OUTPUTS:
	A series of gif files will be written to disk.

 EXAMPLE:
	To create a series of gif files:

		MAKE_VHS_GIF,'c3j96gif',title='SOHO/LASCO  3.7 - 32 Rs'

 MODIFICATION HISTORY:
 	Written by:	R.A. Howard, NRL, 9/25/96

	@(#)make_vhs_gif.pro	1.2 09/12/97 LASCO IDL LIBRARY

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/make_vhs_gif.pro)


MKMOVIE

[Previous Routine] [Next Routine] [List of Routines]
 Project     : SOHO - LASCO/EIT
                   
 Name        : MKMOVIE
               
 Purpose     : Load FITS files into pixmaps and call WRUNMOVIE for animation.
               
 Explanation : This procedure sorts the images by time, reads them, and 
		normalizes to the exposure time of the first image.
		WRUNMOVIE is called to start a widget interface for the 
		animation sequence.  The on_off_diff keyword results in a movie
               where each on line image is displayed with a nearby offband image
               subtracted.
               
 Use         : MKMOVIE, list, bmin, bmax, /TIMES, /DIFF, /NO_NORMAL, /NO_SORT, $
                        UNSHARP=unsharp, PAN=pan, COORDS=coords, BOX=box, $
                        /RATIO, /USE_MODEL,/FLAT_FIELD,/ON_OFF_DIFF,/MASK_OCC,/LG_MASK_OCC
                        /RUNNING_DIFF, /RADIAL, /DEGRID, /FIXGAPS, /LOG_SCL, /SQRT_SCL, $
			 FILL_COL=fill_col, SAVE=save

      Example: IDL> MKMOVIE, 'list960123', -100, 100, /DIFF

      Example: If you want to display BYTARR images straight from the FITS files without
		any scaling use:
               IDL> MKMOVIE, 'list', 0, 255, /NO_NORMAL, /NO_SORT
    
 Inputs      : list : Name of file containing names of FITS files.
		       Or a STRARR of the image names.
               bmin, bmax : Minimum and maximum DN for BYTSCL.
               
 Outputs     : None.
               
 Keywords    : The following keywords apply to all telescopes (C1,C2,C3,EIT)

		/CREM	   : Remove cosmic rays using REMOVE_CR (2 image) procedure;
			     Set CREM = 2 if you wish to define an area not to do CR removal
		/LOGO	   ; Add LASCO logo to bottom right corner
		/AUTOMAX   : Compute bmin and bmax based on median
		/LEE_FILT   : Apply Leefilt function to filter noise.
               /TIMES     : Set this keyword to display date and time in images.
		/DIFF      : Set this keyword to make a difference movie.  The 
			     first image is subtracted from all subsequent images.
		/RUNNING_DIFF  : Make a difference movie, subracting the preceding image.
		/NO_NORMAL : Don't normalize exposure times to that of the first image.
		/NO_SORT   : Don't sort by time in header.
               UNSHARP    : Set this keyword to make a movie of unsharp masked images.
                            The value of the keyword if any is set to the size of the
                            unsharp mask, default=25
                            Example:  A value of 9 would form a 9x9 unsharp mask
		/RATIO     : If using diff or running_diff display data as ratio of image/reference frame
               /MASK_OCC  : applies a sun sized circle and removes the internal part of the image
               /LG_MASK_OCC:applies a sun sized circle and removes the part of the field to 1.2Rsun
                            for C1 (especially good for the longer 100s exposures).  
			     For C3 the pylon is masked
		/LOG_SCL   : Applies ALOG10() function to image before byte scaling
		/SQRT_SCL  : Applies SQRT() function to image before byte scaling
		/FIXGAPS   : Set to 1 to fill data gaps in image with color specified by FILL_COL
		             Set to 2 to fill data gaps in image with values from previous image
		FILL_COL   : Set this keyword to the color index to use for data gaps and occ masks.
		SAVE       : For use in batch mode.  Set this keyword to the name of the .mvi file
			     to save as.  Routine will save movie and then exit.
		PAN        : Default is to resize images to pixel size of the first image.  Set this
			     keyword to perform additional scaling.  Example: set to 0.5 for 2x2 rebinning.
		COORDS     : Set to 4 element array of image coordinates to use relative to 1024x1024 image.
			     Example: COORDS=[0,1023,128,895] for C2 Equatorial Field
		BOX        : Set to 4 element array of image coordinates to use for box normalization 
			     relative to 1024x1024 image. Images are scaled relative to average counts
			     in box of first image. Example: BOX=[461,560,641,740]
		REF_BOX    : Set to avg counts specified in BOX otherwise first image is used

             : The following keywords apply only to C1

               /ON_OFF_DIFF: differences each on line image with an image taken at a continuum wavelength
               /FLAT_FIELD : normalizes each image by a door closed image to remove the solar spectrum
               /RADIAL	    : applies a radial filter

             : The following keywords apply only to C2 and C3

		/USE_MODEL : If using diff or running_diff use background corona model
			     as base frame.  USE_MODEL=1 for overall yearly model
					     USE_MODEL=2 for closest monthly model
					     USE_MODEL=3 for closest average (any_year) monthly model

             : The following keywords apply only to EIT

               /DEGRID	    : applies the degridding algorithm

 Calls       : WRUNMOVIE

 Side effects: Creates multiple pixmaps.
               
 Category    : Image Display.
               
 See Also    : WMKMOVIE.PRO is a widget front-end to this procedure.
               GENERIC_MOVIE.PRO reads in bytescaled fits or gif files and creates a movie.
               
 Prev. Hist. : None.

 Written     : Scott Paswaters, NRL, Jan 1996.
               
 Modified    : SEP 29 May 96 - Place frames into multiple pixmaps instead of 1 large
				pixmap because of limitations on window size in IDL.
               SEP  9 Jul 96 - Read in img headers as structures and pass to wrunmovie
               SEP 18 Oct 96 - Add option to pass in STRARR of image names instead of filename.
               SEP 24 Oct 96 - added /RATIO and /USE_MODEL options
               RAH 13 Dec 96 - added check for daily median image which doesn't have bias
               CMK 16 Feb 97 - added all C1 related features and changed the procedure name to mkc1movie2
           RAH/SEP 14 Mar 97 - integrated mkc1movie2 features into mkmovie
               SEP 21 Mar 97 - corrected bias subtraction for LEB summed images
               SEP 01 Oct 97 - added /SUM keyword to OFFSET_BIAS call
               SEP 22 Oct 97 - fixed divide by zero error for /RATIO option
               SEP 31 Oct 97 - Binned images are scaled (/bin^2) for level_05 images only
               SEP 13 Nov 97 - Added /FLAT_FIELD for EIT, added /NEW flag to EIT_DEGRIDN
               RAH 02 Feb 98 - Now normalizes to calculated exposure time (if data exists).
		NBR 06 Nov 98 - Change default fillcol to median(image); change LG_MASK_OCC for c3 to use C3clearmask2.dat
		NBR 16 Dec 98 - Add LEEFILT keyword
		NBR  8 Feb 99 - Add AUTOMAX keyword
		NBR 11 Feb 99 - Move up first call of REDUCE_STD_SIZE
		NBR 17 Feb 99 - Do not divide by lebxsum^2 (done in REDUCE_STD_SIZE)
		NBR 10 Mar 99 - Update AUTOMAX keyword
		NBR 19 Mar 99 - Add LOGO keyword
		NBR 26 Mar 99 - Add DISTORT keyword, update LEE_FILT keyword, print time stats
		NBR 29 Mar 99 - Add CREM keyword

 Version     : 

 SCCS variables for IDL use
 
 @(#)mkmovie.pro	1.12 02/11/99 :NRL Solar Physics

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/mkmovie.pro)


MKMOVIEM

[Previous Routine] [Next Routine] [List of Routines]
 Project     : SOHO - LASCO/EIT
                   
 Name        : MKMOVIEM
               
 Purpose     : Load FITS files into pixmaps and call WRUNMOVIEM for animation.
               
 Explanation : This procedure sorts the images by time, reads them, and 
		normalizes to the exposure time of the first image.
		WRUNMOVIEM is called to start a widget interface for the 
		animation sequence.
               
 Use         : MKMOVIEM, list, bmin, bmax, /TIMES, /DIFF, /NO_NORMAL, /NO_SORT, $
                        IMG_REBIN=[nx,ny], IMG_COORDS='(x1:x2,y1:y2)', UNSHARP=unsharp

      Example: IDL> MKMOVIEM, 'list960123', -100, 200, /DIFF, IMG_REBIN=[512,512]
      Example: IDL> MKMOVIEM, 'list960123', 400, 13000, /TIMES, IMG_COORDS='(0:511,*)'

      Example: If you want to display BYTARR images straight from the FITS files without
		any scaling use:
               IDL> MKMOVIEM, 'list', 0, 255, /NO_NORMAL, /NO_SORT
    
 Inputs      : list : Name of file containing names of FITS files.
               bmin, bmax : Minimum and maximum DN for BYTSCL.
               
 Outputs     : None.
               
 Keywords    : /TIMES : Default is to display image names in widget,
			 set this keyword to display TIME_OBS.
		/DIFF  : Set this keyword to make a difference movie.  The 
			 first image is subtracted from all subsequent images.
		/RUNNING_DIFF  : Make a difference movie, subracting the preceding image.
		/NO_NORMAL : Don't normalize exposure times to that of the first image.
		/NO_SORT   : Don't by time in header.
		IMG_REBIN  : Set this keyword to the size you want to REBIN all images to.
			     Example: [512,512] would REBIN a full field, full resolution
			     image down to 512x512.
		IMG_COORDS : Set this keyword to select a partial field of all images.
			     Example: '(*,0:511)' would select the bottom 1/2 of a full
			     field full resolution (1024x1024) image.
               UNSHARP    : Set this keyword to make a movie of unsharp masked images.
                            The value of the keyword if any is set to the size of the
                            unsharp mask, default=25
                            Example:  A value of 9 would form a 9x9 unsharp mask
		DERIV      : Divide difference images by time difference 
			     between frames.  Set value to the number of hours,
			     on average, between frames.
               /NOSTARS   : Attemps to remove stars using POINT_FILTER by Mike Andrews
               /FIXGAPS   : Sets data gaps so they appear as neutral grey in difference images

 Calls       : WRUNMOVIEM, FIXEXP, POINT_FILTER

 Restrictions: IMG_REBIN is applied before IMG_COORDS if both are selected.
               
 Side effects: Creates multiple pixmaps.
               
 Category    : Image Display.
               
 Prev. Hist. : None.

 Written     : Scott Paswaters, NRL, Jan 1996.
               
 Modified    : SEP 29 May 96 - Place frames into multiple pixmaps instead of 1 large
				pixmap because of limitations on window size in IDL.
               SEP  9 Jul 96 - Read in img headers as structures and pass to wrunmovie
		SHH 12 Jul 96 - Display each frame after it's processed
				Use FIXEXP function rather than exposure times for image normalization
				Scale images absolutely, rather than using TVSCL
		SHH 23 Jul 96 - Added DERIV keyword 
               SEP 29 Sep 96 - Placed frames in 1024x1024 image window.

 Version     : 3.1

	@(#)mkmoviem.pro	1.1 10/12/96 LASCO IDL LIBRARY

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/mkmoviem.pro)


MKMOVIEWLC

[Previous Routine] [Next Routine] [List of Routines]
 Project     : SOHO - LASCO/EIT
                   
 Name        : MKMOVIEWLC
               
 Purpose     : Load FITS files into pixmaps and call WRUNMOVIE for animation.
               
 Explanation : This procedure sorts the images by time, reads them, and 
		normalizes to the exposure time of the first image.
		WRUNMOVIE is called to start a widget interface for the 
		animation sequence.
               
 Use         : MKMOVIEWLC, list, bmin, bmax, /TIMES, /DIFF, /NO_NORMAL, /NO_SORT, $
                        IMG_REBIN=[nx,ny], IMG_COORDS='(x1:x2,y1:y2)', UNSHARP=unsharp, $
                        /RATIO, /USE_MODEL, ROLL=roll, /MASK, /SUNMASK

      Example: IDL> MKMOVIEWLC, 'list960123', -100, 200, /DIFF, IMG_REBIN=[512,512]
      Example: IDL> MKMOVIEWLC, 'list960123', 400, 13000, /TIMES, IMG_COORDS='(0:511,*)'

      Example: If you want to display BYTARR images straight from the FITS files without
		any scaling use:
               IDL> MKMOVIEWLC, 'list', 0, 255, /NO_NORMAL, /NO_SORT
    
 Inputs      : list : Name of file containing names of FITS files.
		       Or a STRARR of the image names.
               bmin, bmax : Minimum and maximum DN for BYTSCL.
               
 Outputs     : None.
               
 Keywords    : /TIMES : Default is to display image names in widget,
			 set this keyword to display TIME_OBS.
		/DIFF  : Set this keyword to make a difference movie.  The 
			 first image is subtracted from all subsequent images.
		/RUNNING_DIFF  : Make a difference movie, subracting the preceding image.
		/NO_NORMAL : Don't normalize exposure times to that of the first image.
		/NO_SORT   : Don't by time in header.
		IMG_REBIN  : Set this keyword to the size you want to REBIN all images to.
			     Example: [512,512] would REBIN a full field, full resolution
			     image down to 512x512.
		IMG_COORDS : Set this keyword to select a partial field of all images.
			     Example: '(*,0:511)' would select the bottom 1/2 of a full
			     field full resolution (1024x1024) image.
               UNSHARP    : Set this keyword to make a movie of unsharp masked images.
                            The value of the keyword if any is set to the size of the
                            unsharp mask, default=25
                            Example:  A value of 9 would form a 9x9 unsharp mask
		/RATIO     : If using diff or running_diff display data as ratio
		/USE_MODEL : If using diff or running_diff use background corona model
			     as base frame.
		ROLL       : Set this keyword to rotate the image by the roll angle.  If
			     set to 1 then read in the roll angle from the date file
		/MASK      : Set this keyword to put a mask at the edge of the field
			     at 9 R (13.4 pixels per radius)
		/SUNMASK   : Set this keyword to put a circle where the sun should be


 Calls       : WRUNMOVIE

 Restrictions: IMG_REBIN is applied before IMG_COORDS if both are selected.
               
 Side effects: Creates multiple pixmaps.
               
 Category    : Image Display.
               
 Prev. Hist. : None.

 Written     : Scott Paswaters, NRL, Jan 1996.
               
 Modified    : SEP 29 May 96 - Place frames into multiple pixmaps instead of 1 large
				pixmap because of limitations on window size in IDL.
               SEP  9 Jul 96 - Read in img headers as structures and pass to wrunmovie
               SEP 18 Oct 96 - Add option to pass in STRARR of image names instead of filename.
               SEP 24 Oct 96 - added /RATIO and /USE_MODEL options
               SEP 14 Nov 96 - Modified to read in solwind wlc images
               RAH 14 May 98 - Modified to roll the image

 Version     : 

 @(#)mkmoviewlc.pro	1.7 06/09/98 :LASCO IDL LIBRARY

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/mkmoviewlc.pro)


MVI2DATA_CUBE

[Previous Routine] [Next Routine] [List of Routines]
 Project     : SOHO - LASCO/EIT

 Name        : MVI2DATA_CUBE

 Purpose     : Convert .mvi movie to data cube and header array

 Use         : IDL> MVI2DATA_CUBE, mvifile, images, headers, /SAVE

 Inputs      : mvifile 	;** name of mvi movie file

 Outputs     : images 		;** 3 dimensional bytarr of images (nx,ny,len)
	        headers		;** array of header structures
** {mvihdr, filename:'',detector:'',time_obs:'',date_obs:'',filter:'',polar:'',sector:'',exptime:0.0}


 Keywords    : /SAVE  ;** saves images, headers, and r,g,b color vectors to IDL saveset (idlsave.dat)

 Category    : Image Conversion.

 Written     : Scott Paswaters, NRL May 1998.

 Modified    : 

 Version     : 1.0

       @(#)mvi2data_cube.pro 1.1 10/12/96 LASCO IDL LIBRARY

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/mvi2data_cube.pro)


MVI2FRAMES

[Previous Routine] [Next Routine] [List of Routines]
 Project     : SOHO - LASCO/EIT

 Name        : MVI2FRAMES

 Purpose     : Convert .mvi movie to GIF, TIFF, or PICT frames.

 Use         : IDL> MVI2FRAMES, mvifile, type, /LOGO, /TIMES, /VIDEO, FITS_HDR=fits_hdr

 Inputs      : mvifile 	;** name of mvi movie file
             : type: 0 = gif
              	      1 = tiff
              	      2 = pict
              	      3 = fits

 Keywords    : /LOGO 		;** add the LASCO logo in lower right corner
               /TIMES 		;** to have the date & time displayed
               /VIDEO 		;** to reduce to video resolution 640x480 or:
               VIDEO=2 	;** to reduce to video resolution 480x480
                FITS_HDR	;** strarr fits hdr of additional keyword/value pairs 
				;** to include with fits files.
               /NAME 		;** default is to name images date_time.ext, set this
				;** keyword to 1 them after the mvi filename001.ext (etc)
				;** or set it to a string to be named string001.ext (etc)

 Side effects: Image files are written to current directory.
               Be sure to have the color table loaded before calling.

 Category    : Image Conversion.

 Written     : Scott Paswaters, NRL Dec. 1997.

 Modified    : SEP  05 Feb 1997 - Mods for mvi version 1 format.
             : SEP  14 Mar 1997 - Name images date_time.ext

 Version     : 2.0

       @(#)mvi2frames.pro 1.1 10/12/96 LASCO IDL LIBRARY

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/mvi2frames.pro)


MVIPLAY[1]

[Previous Routine] [Next Routine] [List of Routines]
 Project     : SOHO - LASCO/EIT
                   
 Name        : MVIPLAY
               
 Purpose     : Widget tool to display animation sequence.
               
 Explanation : This tool allows the user to view a series of images as
		an animation sequence.  The user can control the direction,
		speed, and number of frames with widget controls.
		Click any mouse button inside draw window to bring forward/hide
		control widget.
               
 Use         : IDL> MVIPLAY [, mvifile, /DISK, /FITSCREEN, START=start, SKIP=skip, LENGTH=length]

		Without any inputs, program will prompt user to select an existing .mvi file.
    Example  : IDL> MVIPLAY

               Or you could have one argument, the .mvi file you want to load.
    Example  : IDL> MVIPLAY, 'mymovie.mvi'

		Use keyword /DISK to play movie from disk instead of loading into RAM.
		This option is useful for viewing large movies on systems with a limited
		amount of RAM.  The maximum speed of the movie will depend on the transfer
		speed of the hard drive or CD-ROM and will be slower than loading into RAM.
    Example  : IDL> MVIPLAY, 'mymovie.mvi', /DISK
    
		Use keyword /FITSCREEN to redimension image to 640x480 (does not work with /DISK)
    Example  : IDL> MVIPLAY, 'mymovie.mvi', /FITSCREEN
    
               Use the keyword SKIP to skip every n frames (good for large movies).
    Example  : IDL> MVIPLAY, SKIP=1         ;* to skip every other frame

               Use the keyword START to start reading movie at frame n (good for large movies).
    Example  : IDL> MVIPLAY, START=100              ;* frame 100 becomes 1st frame of movie

               Use the keyword LENGTH to specify number of frames to read in (good for large movies).
    Example  : IDL> MVIPLAY, START=100, LENGTH=60   ;* to load frames 100-159
    
               Use the keyword TIMES to display date & time on frames (if not already there).
    Example  : IDL> MVIPLAY, /TIMES 	   ; does not work with /DISK keyword. 

 Calls       : BREAK_FILE

 Side effects: None.
               
 Category    : Image Display.  Animation.
               
 Written     : Scott Paswaters, NRL Dec. 2 1996.

 Modified    : SEP  10 Jan 1997 - Added SKIP,START,LENGTH,TIMES keywords.
               SEP  05 Feb 1997 - Mods for mvi version 1 format.
               SEP  04 Apr 1997 - Fixed swapflag for .mvi files written on big_endian workstations
               SEP  22 Sep 1997 - Added current frame scrolling widget.
               SEP  27 Jan 1998 - Added /DISK option for playing from disk.
               
 Version     : 2.0

 See Also    : MKMOVIE.PRO
	@(#)mviplay.pro	1.1 10/12/96 LASCO IDL LIBRARY

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/mviplay.pro)


MVIPLAY[2]

[Previous Routine] [Next Routine] [List of Routines]
 Project     : SOHO - CDS

 Name        : 
	BREAK_FILE
 Purpose     : 
	Break a filename into its component parts.
 Explanation : 
	Given a file name, break the filename into the parts
	of disk/logical, the directory, the filename, the
	extension, and the file version (for VMS)
 Use         : 
	BREAK_FILE, FILE, DISK_LOG, DIR, FILNAM, EXT, FVERSION, NODE
 Inputs      : 
	file	- The file name
 Opt. Inputs : 
	None.
 Outputs     : 
	disk_log- The disk or logical (looks for a ":")
		  This is generally only valid on VMS machines
	dir	- The directory
	filnam	- The filename (excluding the ".")
	ext	- The filename extension (including the ".")
	fversion- The file version (only VMS)
	node	- The Node name (only VMS)
 Opt. Outputs: 
	None.
 Keywords    : 
	None.
 Calls       : 
	None.
 Common      : 
	None.
 Restrictions: 
	VMS:
		Assumes that : always precedes []
	ULTRIX:
		Right now it has trouble with the ultrix option of use
		of "." or ".."
 Side effects: 
	None.
 Category    : 
	Utilities, Operating_system.
 Prev. Hist. : 
	Written 1988 by M.Morrison
	   Aug-91 (MDM) Changed to handle Unix filename convensions
	28-Feb-92 (MDM) * Adjusted to handle arrays
	11-Mar-92 (MDM) - Perform a STRTRIM(x,2) on input string before
			  doing the "break-up"
	 1-Dec-92 (MDM) - Moved code to do filename, extension and version
			  number for both VMS and Unix (previously it
			  did not do version number code for Unix)
	29-Jan-93 (DMZ/MDM) - checked for node in file name
 Written     : 
	M. Morrison, August 1991.
 Modified    : 
	Version 1, William Thompson, GSFC, 23 April 1993.
		Incorporated into CDS library.
	Version 1.1, William Thompson, GSFC, 7 May 1993.
		Added IDL for Windows compatibility.
 Version     : 
	Version 1.1, 7 May 1993.

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/mviplay.pro)


PLOT_HT

[Previous Routine] [Next Routine] [List of Routines]
 NAME:
	PLOT_HT

 PURPOSE:
	This procedure is used to display height-time curves. It reads in a
       height-time file created by one of the movie programs and generates
       a plot.

 CATEGORY:
	MOVIE

 CALLING SEQUENCE:
	PLOT_HT

 INPUTS:

 OPTIONAL INPUT PARAMETERS:
	Filename:	If filename is present then it is used immediately

 OUTPUTS:
	A plot is generated on the screen, and optionally a print file is
	generated of the form idlplot.psnnn, where nnn is a sequential
	number.

 OPTIONAL OUTPUT PARAMETERS:

 COMMON BLOCKS:
	com_xplot_ht

 SIDE EFFECTS:
	Initiates the XMANAGER if it is not already running.

 RESTRICTIONS:

 PROCEDURE:
	The various widgets are set up and registered.  The user selects the
	height-time file to be processed.  The file is read in and the data
	points plotted.  The user is then able to fit the data to polynomial
	functions of degree 1,2, or 3.  The plot can be printed.  The speeds
	can be saved to a file.

 MODIFICATION HISTORY:
 	Written by:	Scott Hawley, NRL Summer Student, June 1996
	Version 2	RA Howard, NRL, Modified plot calls to use utplot
	15 Oct 96	RAH, widgetized
       27 Oct 96       RAH, Corrected overplots of interpolated values
                            Set new window number before plotting
       08 Nov 96       RAH, Corrected situation if called without argument
       10 Nov 96       RAH, Corrected Acceleration = 2*fit_coeff
       11 Nov 96       RAH, Added plot of position angles

	@(#)plot_ht.pro	1.6 09/12/97 LASCO IDL LIBRARY

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/plot_ht.pro)


READ_HT

[Previous Routine] [Next Routine] [List of Routines]
 NAME:
	READ_HT

 PURPOSE:
	This procedure is used to read height-time files.

 CATEGORY:
	MOVIE

 CALLING SEQUENCE:
	READ_HT,Filename,

 INPUTS:
	Filename:	If filename is present then it is used immediately

 OUTPUTS:
	The procedure returns the contents of the height time file in the
	common block.

 COMMON BLOCKS:
	None

 RESTRICTIONS:
	The file should not have any blank lines.

 PROCEDURE:
   	Reads in the height-time file, stores the height, time and position
	angle into arrays.  Time is converted to tai.

 MODIFICATION HISTORY:
 	Written by:	Scott H. Hawley, NRL Summer Student, June 1996
       02 May 97       RAH, Made into a separate file
	30 Sep 97	RAH, Mods for version 2
	 3 Feb 98	RAH, Correct read of feature description, add array to comments

 @(#)read_ht.pro	1.7 03/03/98 :LASCO IDL LIBRARY


(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/read_ht.pro)


RTMOVIE

[Previous Routine] [Next Routine] [List of Routines]
 Project     : SOHO - LASCO/EIT
                   
 Name        : RTMOVIE
               
 Purpose     : Display movie of images as they are received in real time at the EOF.
               
 Explanation : Starts a movie of the previous 48 (~2 days) images.  As new images
		are received at the EOF they are added to the movie in time order.
               
 Use         : IDL> RTMOVIE [, telescope, num_frames, /MPEG ]

 Optional Inputs:
	        telescope   ;string 'c2' or 'c3'  -  default is 'c2'
	        num_frames  ;integer number of images to load  -  default is 48

 Keywords    : /MPEG ;will write out new .mvis and mpeg movies every time a new image is received.

 Calls       : 

 Comments    : Must be running IDL on a machine at the EOF or have /net/lasco6/data mounted.
               
 Side effects: None.
               
 Category    : Image Display.  Animation.
               
 Written     : Scott Paswaters, NRL Dec. 2 1996.
               
 Version     : RAH, NRL, 2/18/97  Mods for computation of center
               SEP, NRL, 3/25/97  Save .mvi files

	@(#)rtmovie.pro	1.5 09/12/97 LASCO IDL LIBRARY

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/rtmovie.pro)


RTMVI

[Previous Routine] [Next Routine] [List of Routines]
 Project     : SOHO - LASCO/EIT
                   
 Name        : RTMVI
               
 Purpose     : Write GIF images as they are received in real time.
               
 Use         : IDL> RTMVI

 Calls       : 

 Comments    : Must be running IDL on a machine at the EOF or have /net/lasco6/data mounted.
               
 Side effects: None.
               
 Category    : Image Display.  Animation.
               
 Written     : Scott Paswaters, NRL Dec. 2 1996.
               
 Version     : RAH, NRL, 2/18/97  Mods for computation of center
               SEP, NRL, 3/25/97  Save .mvi files
               RAH, NRL, 2/04/98  EIT normalization box changed to bottom of image, and AL +1 filter
				   added as a valid option for the filter wheel (in addition to clear)
               SEP, NRL, 4/06/98  Changed to write GIF images instead of MVI files
		NBR, NRL, 3/22/99  Write JPEG images also


 @(#)rtmvi.pro	1.9 03/23/99 :LASCO IDL LIBRARY

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/rtmvi.pro)


RTMVIPLAY

[Previous Routine] [Next Routine] [List of Routines]
 Project     : SOHO - LASCO/EIT

 Name        : RTMVIPLAY

 Purpose     : Widget tool to display animation sequence from gif files.

 Explanation : This tool allows the user to view a series of gif images as
               an animation sequence.  The user can control the direction,
               speed, and number of frames with widget controls.  A directory
		is monitored for new images and they are added to the movie
		in time order.

 Use         : IDL> RTMVIPLAY, match, LENGTH=length, GIF_DIR=gif_dir, IMG_REBIN=img_rebin, 
 			RUNNING_DIFF=running_diff

 Inputs      : match : string to use to match gif files to load.
	           ex : RTMVIPLAY, 'c1_fexiv'
	           ex : RTMVIPLAY, 'c2'
	           ex : RTMVIPLAY, 'c3'
	           ex : RTMVIPLAY, 'eit_195'
	           ex : RTMVIPLAY, 'eit_304'
	           ex : RTMVIPLAY, 'eit_171'
	           ex : RTMVIPLAY, 'eit_284'

 Outputs     : None.

 Keywords    : 
               LENGTH=length     : maximum number of frames to load (default is all).
               GIF_DIR=gif_dir   : directory to read gif images from (default is $MVIS/rtmovie/gifs/ 
                                   or current directory if $MVIS doesn't exist)
               IMG_REBIN=img_rebin  : set to dimensions to rebin (or congrid) images to
				     : ex. IMG_REBIN=[512,512]
               /RUNNING_DIFF     : set this flag for a running difference movie

 Calls       :

 Side effects: None.

 Category    : Image Display.  Animation.

 Written     : Scott Paswaters, NRL Apr. 8 1998.

 See Also    : MKMOVIE.PRO
       @(#)rtmviplay.pro       1.1 10/12/96 LASCO IDL LIBRARY

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/rtmviplay.pro)


WMKMOVIE

[Previous Routine] [Next Routine] [List of Routines]
 Project     : SOHO - LASCO/EIT
                   
 Name        : WMKMOVIE
               
 Purpose     : Widget front end to MKMOVIE.PRO
               
 Explanation : This tool allows the user to select mkmovie options with
		a widget interface.
               
 Use         : IDL> WMKMOVIE [, arg1]


    Example  : IDL> WMKMOVIE		 ;Without any inputs, program will call wlister.pro

               Or you could have one argument, a STRARR of filenames for the movie.
		(such as that returned by wlister)
    Example  : IDL> WMKMOVIE, file_arr

               Or if you have image filenames saved into a single file pass the name of that file:
    Example  : IDL> WMKMOVIE, 'filename'
    
    
 Calls       : MKMOVIE.PRO, WLISTER.PRO

 Side effects: None.
               
 Category    : Image Display.  Animation.
               
 Written     : Scott Paswaters, NRL Oct. 18 1996.
               
 Modified    : SEP  29 May 1996 
               SEP  17 Mar 1997 	;mods for new options to MKMOVIE.PRO

 Version     : 

 See Also    : MKMOVIE.PRO
	@(#)wmkmovie.pro	1.0 10/18/96 LASCO IDL LIBRARY

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/wmkmovie.pro)


WRITE_DISK_MOVIE

[Previous Routine] [Next Routine] [List of Routines]
 NAME:
	WRITE_DISK_MOVIE

 PURPOSE:
	This procedure adds an image to a file in the disk movie format.

 CATEGORY:
	LASCO MOVIE

 CALLING SEQUENCE:
	WRITE_DISK_MOVIE, Fname, Img, Hdr

 INPUTS:
	Fname:	File name of the movie disk file, with full path

	Img:	2D image to be added to the file

	Hdr:	FITS header

 KEYWORD PARAMETERS:
	NEW:	If set this keyword indicates that a new file is to be created.
		The default is to write to an existing file

	MAXNUM:	If set, this keyword specifies the maximum number of files to
		be loaded into the file.  The default value is 128

	/REPLACE:  Flag to replace an image rather than append
	REPLACE_INDEX:Set to index of frame to replace in .mvi file

 PROCEDURE:
	The disk movie format is:

	file header:	# images in the file
			# columns in each image
			# rows in each image
			# maximum number of images in file
			# bytes in image header
			# version number

	for version 1:	# bytes in file header
	for version 1:	# sunxcen * 10
	for version 1:	# sunycen * 10
	for version 1:	# arc sec per pixel * 100
	for version 1:	# red color vector BYTARR(256)
	for version 1:	# green color vector BYTARR(256)
	for version 1:	# blue color vector BYTARR(256)

	img hdr #1:	date of image, string (15)
			time of image, string (15)
			file name, string (15)
			filter wheel, string (10)
			polarizer wheel, string (10)
			detector, string (10)
	img hdr #2
		...
	img #1
	img #2
		...

 EXAMPLE:

	Create a new movie file with img being the first image in the file:

		DISK_MOVIE_FILE, '~/mymovie.mvi', img , hdr, /new, maxnum=20

	Add to an existing movie file:

		DISK_MOVIE_FILE, '~/mymovie.mvi', img , hdr

 MODIFICATION HISTORY:
 	Written by:	RA Howard, NRL, 16 Mar 1996

 Modified    : SEP  05 Feb 1997 - Mods for mvi version 1 format.
               SEP  08 Sep 1997 - Added REPLACE option.

	@(#)write_disk_movie.pro	1.1 10/12/96 LASCO IDL LIBRARY

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/write_disk_movie.pro)


WRITE_HT

[Previous Routine] [Next Routine] [List of Routines]
 NAME:
	WRITE_HT

 PURPOSE:
	This procedure writes out the height-time
	file.  It is used by the movie program and is not intended to be
	used in a standalone fashion.

 CATEGORY:
	MOVIE

 CALLING SEQUENCE:
	WRITE_HT,Callt,Htfile,Hdr,R,Pa,Feat,X,Y

 INPUTS:
	Callt:	Parameter indicating whether header or observation 
		information is being written
		0 = header, 1 = observation
	Htfile:	String containing the file name to be written to
	Hdr:	Structure containing the image header information
	R:	Radius of observation in units of solar radii (float)
	Pa:	Position angle of observation in degrees (float)
	X:	Column of observation (pixels)
	Y:	Row of observation (pixels)

 SIDE EFFECTS:
	Appends information to height-time file if existing or opens a new
	one if none exists.

 MODIFICATION HISTORY:
 	Written by:	Scott Hawley, NRL summer student, July 1996
	V2  5/3/97	RAHoward,NRL	Combined all writes to ht-file
	V3  9/30/97	RAHoward,NRL	Defined Version 2 for HT file
 
 @(#)write_ht.pro	1.8 10/03/97 :NRL Solar Physics

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/write_ht.pro)


WRUNMOVIE

[Previous Routine] [Next Routine] [List of Routines]
 Project     : SOHO - LASCO/EIT
                   
 Name        : WRUNMOVIE
               
 Purpose     : Widget tool to display animation sequence.
               
 Explanation : This tool allows the user to view a series of images as
		an animation sequence.  The user can control the direction,
		speed, and number of frames with widget controls.
               
 Use         : IDL> WRUNMOVIE [, arg1 [, NAMES=names [,SKIP=skip]]]

		Without any inputs, program will prompt user to select an existing .mvi file.
    Example  : IDL> WRUNMOVIE

               Or you could have one argument, the .mvi file you want to load.
    Example  : IDL> WRUNMOVIE, 'mymovie.mvi'

               Or if you have pre-loaded images into pixmaps (like MKMOVIE.PRO does) call:
		Where win_index is an array of the window numbers and names is optionally
		a STRARR() containing names of each frame.
    Example  : IDL> WRUNMOVIE, win_index, NAMES=names
    
		Use the keyword SKIP to skip every n frames (good for large movies).
    Example  : IDL> WRUNMOVIE, SKIP=1		;* to skip every other frame

		Use the keyword START to start reading movie at frame n (good for large movies).
    Example  : IDL> WRUNMOVIE, START=100		;* frame 100 becomes 1st frame of movie

		Use the keyword LENGTH to specify number of frames to read in (good for large movies).
    Example  : IDL> WRUNMOVIE, START=100, LENGTH=60	;* to load frames 100-159

		Use the keyword TIMES to display date & time on frames (if not already there).
    Example  : IDL> WRUNMOVIE, /TIMES

		Use the keyword COORDS to display subframe of movie images. [x1,x2,y1,y2]
		Note: COORDS is applied before IMG_REBIN if both are selected.
		OR just use /COORDS to select coordinates interactively
    Example  : IDL> WRUNMOVIE, 'mymovie.mvi', COORDS=[256,256+511,175,175+255]

		Use the keyword IMG_REBIN to resize movie.  If shrinking by integer factor REBIN 
		is used otherwise CONGRID with linear interpolation is used.
    Example  : IDL> WRUNMOVIE, 'mymovie.mvi', IMG_REBIN=[512,512]

		Use the keyword SAVE to just save the movie and exit (for use in batch mode).
    Example  : IDL> WRUNMOVIE, win_index, SAVE='mymovie.mvi'

		Use the keyword DIFF to subtract a base frame from all frames in the movie.
		The base frame is the first frame.  Or you can use the keyword START to set it.
    Example  : IDL> WRUNMOVIE, 'mymovie.mvi', /DIFF

		Use the keyword RUNNING_DIFF to create a running difference movie.
		The default is to subtract the previous frame.  Use RUNNING_DIFF=2 to subtract
		2 frames prior from each image.
    Example  : IDL> WRUNMOVIE, 'mymovie.mvi', /RUNNING_DIFF

		Use the keyword /COSMIC to removie cosmic rays.
    Example  : IDL> WRUNMOVIE, 'mymovie.mvi', /COSMIC

		Use the keyword /FIXGAPS to replace data gaps with data from previous frame
		The default is to assume missing blocks are 32x32, 
		For 1/2 resolution images use BLOCK_SIZE=16 for example
    Example  : IDL> WRUNMOVIE, 'mymovie.mvi', /FIXGAPS

		Use the keyword /DRAW_LIMB to draw a circle at the solar limb
    Example  : IDL> WRUNMOVIE, 'mymovie.mvi', /DRAW_LIMB

 Calls       : 

 Comments    : Use MKMOVIE.PRO to load into pixmaps.
               
 Side effects: None.
               
 Category    : Image Display.  Animation.
               
 Written     : Scott Paswaters, NRL Feb. 13 1996.
               
 Modified    : SEP  29 May 1996 - Changed to multiple pixmaps for images.
				   Added buttons to save and load movie files (.mvi).
				   Seperated control buttons from display window.
               SEP   9 Jul 1996 - Added keyword to pass image headers.
               SEP   7 Jan 1997 - Added skip keyword.
               SEP   9 Jan 1997 - Added START, LENGTH keywords.
               SEP  05 Feb 1997 - Mods for mvi version 1 format.
               SEP  18 Apr 1997 - Added .mpg output option with 1/2 resolution.
               SEP  16 May 1997 - Added save option and IMG_REBIN option.
               SEP  19 May 1997 - Added COORDS option.
               SEP  27 Jun 1997 - Added permission checks for output.
               SEP  22 Sep 1997 - Added current frame scrolling widget.
               SEP  02 Oct 1997 - Added ability to interactively select subimage coords.
               SEP  18 Nov 1997 - Added /COSMIC  /FIXGAPS and /DRAW_LIMB keywords.
               SEP  11 Dec 1997 - Added button to call WRUNMOVIEM, only save frames first->last
               SEP  08 May 1998 - Added BLOCK_SIZE keyword
               SP   02 Mar 1999 - Added Scroll bars for large images
		NBR  26 Mar 1999 - Added LOGO keyword; Add Save-movie-as-GIFS button

 Version     : 

 See Also    : MKMOVIE.PRO
	@(#)wrunmovie.pro	1.11 03/02/99 LASCO IDL LIBRARY

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/wrunmovie.pro)


WRUNMOVIEM

[Previous Routine] [Next Routine] [List of Routines]
 Project     : SOHO - LASCO/EIT
                   
 Name        : WRUNMOVIEM
               
 Purpose     : Widget tool to display animation sequence.
               
 Explanation : This tool allows the user to view a series of images as
		an animation sequence.  The user can control the direction,
		speed, and number of frames with widget controls.
               
 Use         : IDL> WRUNMOVIEM [, arg1 [, NAMES=names [,/PREVIOUS]]]

		Without any inputs, program will prompt user to select an existing .mvi file.
    Example  : IDL> WRUNMOVIEM

               Or you could have one argument, the .mvi file you want to load.
    Example  : IDL> WRUNMOVIEM, 'mymovie.mvi'

               Or if you have pre-loaded images into pixmaps (like MKMOVIEM.PRO does) call:
		Where win_index is an array of the window numbers and names is optionally
		a STRARR() containing names of each frame.
    Example  : IDL> WRUNMOVIEM, win_index, NAMES=names
    
		If after exiting WRUNMOVIEM you want to re-load the movie call:
    Example  : IDL> WRUNMOVIEM, /PREVIOUS
    
 Calls       : 

 Comments    : Use MKMOVIEM.PRO to load into pixmaps.
               
 Side effects: None.
               
 Category    : Image Display.  Animation.
               
 Written     : Scott Paswaters, NRL Feb. 13 1996.
               
 Modified    : SEP  29 May 1996 - Changed to multiple pixmaps for images.
				   Added buttons to save and load movie files (.mvi).
				   Seperated control buttons from display window.
               SEP   9 Jul 1996 - Added keyword to pass image headers.

		SHH  12 Jul 1996 - Enabled display of cursor position in draw window
			 	   Added height-time plotting capability
				   Added Edit Frame option	  
				   Modified effects of mouse buttons
				   Added buttons above draw window
				   Modified display of Control window

               SEP  29 Sep 1996 - Added routines from DAB for applying C3 geometric distortion and
                                  calculating solar radius as function of time.
               SEP  01 Oct 1996 - Added call to C3_DISTORTION for applying C3 geometric distortion

               RAH  01 Nov 1996 - Prior to PLOT_HT call, don't ask for filename

		SHH  09 Jan 1997 - Added "Start H-T" button
				   Calls XEDITFRAME
               SEP  05 Feb 1997 - Mods for mvi version 1 format.
               SEP  21 Mar 1997 - use sun center and arc_sec/pixel if saved in .mvi file.
               SEP  16 May 1997 - added DN output to window, added button to update center.
               SEP  23 Sep 1997 - added active slider widget for current frame.
		NBR  06 Jan 1999 - changed sec_pix check in file_hdr
		DW   11 Jan 1999 - added C2_DISTORTION and roll angle
		NBR  02 Mar 1999 - eliminated sec_pix check for getting sun center 

 Version     : 3.1


 See Also    : MKMOVIEM.PRO

 @(#)wrunmoviem.pro	1.19 01/12/99 :LASCO IDL LIBRARY


(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/wrunmoviem.pro)


XEDITFRAME

[Previous Routine] [Next Routine] [List of Routines]
 Project       : SOHO -LASCO/EIT

 Name          : XEDITFRAME

 Purpose       : This tool allows the user to edit a particular image "on the
                 fly," while the WRUNMOVIEM procedure is running, using a widget
		  interface.

 Use           : XEDITFRAME, in, out, [moviev]

 Arguments     : InImg - The input, or original image
                 FinalImg - The output, or final image
                 moviev - a structure generated by the WRUNMOVIE3 program,
                       containing information about the movie.  If moviev
                       is not provided, then certain features of the program,
                       such as referencing images by "Current frame", will
                       not be supported.

 Calls         : LASCO_READFITS, POINT_FILTER, GET_FILENAME
	    	  GETSUPERBASENAME   (currently included in xeditframe.pro)	

 Comments      : 
		  The field widgets require the user to press RETURN in order for changes
		  to take effect.
		  Much of the "overhead" in this program is for the "Undo" feature,
		  which necessitates extra bookkeeping.

	 	 The resulting image is = (Primary)*Normalization - (Base), which is then
		  clipped at saturation points (cutoffs) provided by the user.

		"Super Base Frame" should probably be changed to a term easily
		  recognized by LASCO team members.  Procedure GETSUPERBASENAME
		 needs to be extended significantly.

		 "Remove Stars" currently operates on both primage & base images
		 simultaneously, and only does so when the "Remove Stars" button is
		 pressed.  For example, if primary and base images are loaded and
		 "remove stars" is selected, and then a different primary image is loaded,
	 	 remove stars will need to be run again -- but then the base image will
		 have been operated on TWICE.

		 On the "Primary Image" and "Base Image" buttons: If you want to 
		 "re-select" a given button (i.e. load the original image again even
		 though "Original Image" is already selected), you need to click
		 on a different option (e.g. "None") and then click back to the selection
		 you want.

 Side effects  : XEDITFRAME disables all other widgets (e.g. WRUNMOVIEM's interface)
		  until it is finished.

 Category      : Image Processing

 Written       : Scott Hawley, NRL Jan 09, 1996 (from editframe.pro, SHH Jul 12, 1996)

 Modified	: N. Rich	971211	Change EDIT_GETFILENAME function to use
					GET_FILENAME procedure--retrieves final data
					if it exists
 Version       : 

 See Also      : WRUNMOVIEM.PRO
 
 @(#)xeditframe.pro	1.3 09/12/97 :NRL Solar Physics

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/xeditframe.pro)


XPLOT_HT

[Previous Routine] [Next Routine] [List of Routines]
 NAME:
	XPLOT_HT

 PURPOSE:
	This procedure is used to display height-time curves. It reads in a
       height-time file created by one of the movie programs and generates
       a plot.

 CATEGORY:
	MOVIE

 CALLING SEQUENCE:
	XPLOT_HT

 INPUTS:

 OPTIONAL INPUT PARAMETERS:
	Filename:	If filename is present then it is used immediately

 OUTPUTS:
	A plot is generated on the screen, and optionally a print file is
	generated of the form idlplot.psnnn, where nnn is a sequential
	number.

 OPTIONAL OUTPUT PARAMETERS:

 COMMON BLOCKS:
	com_xplot_ht

 SIDE EFFECTS:
	Initiates the XMANAGER if it is not already running.

 RESTRICTIONS:

 PROCEDURE:
	The various widgets are set up and registered.  The user selects the
	height-time file to be processed.  The file is read in and the data
	points plotted.  The user is then able to fit the data to polynomial
	functions of degree 1,2, or 3.  The plot can be printed.  The speeds
	can be saved to a file.

 MODIFICATION HISTORY:
 	Written by:	Scott H. Hawley, NRL Summer Student, June 1996
	Version 2	RA Howard, NRL, Modified plot calls to use utplot
	15 Oct 96	RAH, widgetized
       27 Oct 96       RAH, Corrected overplots of interpolated values
                            Set new window number before plotting
       08 Nov 96       RAH, Corrected situation if called without argument
       10 Nov 96       RAH, Corrected Acceleration = 2*fit_coeff
       11 Nov 96       RAH, Added plot of position angles
       04 Apr 97       RAH, Force first smoothed time to be at least first observed time
	10 Jan 96	SHH, Added custom curve fit
			     Protected against null filenames 
       10 Apr 97       RAH, Permit negative velocities to be plotted
       30 Sep 97       RAH, Modified call to READ_HT
       03 Oct 97       SEP, added ability to save to .ps file
       10 Dec 97       SEP, added user & timestamp to .ps file and hardcopy
       24 Dec 97       RAH, Plot time start includes the extrapolated time to limb
       03 Feb 98       RAH, Plot individual feature codes
       10 Aug 98       RAH, Add path name to file name

 %W% %H% :LASCO IDL LIBRARY

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/xplot_ht.pro)


XSTARTHT

[Previous Routine] [List of Routines]
 NAME:
	XSTARTHT

 PURPOSE:
	This procedure is used to start the CME measurements

 CATEGORY:
	CME

 CALLING SEQUENCE:
	XSTARTHT

 INPUTS:

 OPTIONAL INPUT PARAMETERS:

 OUTPUTS:

 OPTIONAL OUTPUT PARAMETERS:

 COMMON BLOCKS:
	com_xstartht
	com_height_time

 SIDE EFFECTS:
	Initiates the XMANAGER if it is not already running.

 RESTRICTIONS:

 PROCEDURE:

 MODIFICATION HISTORY:
 	Written by:	RA Howard, NRL, 7 May 1997

 @(#)xstartht.pro	1.2 09/12/97 :NRL Solar Physics

(See /net/cronus/opt/local/idl_nrl_lib/lasco/movie/xstartht.pro)