This page was created by IDL
lasco_mk_html_help.pro on
Wed Aug 17 12:21:35 2005.
Project : SOHO - LASCO Name : CHANDLE Purpose : Category : DISPLAY Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
NAME:
cosmics
PURPOSE:
bilder fuer tomographie von fehlstellen befreien
CATEGORY:
CALLING SEQUENCE:
INPUTS:
OPTIONAL INPUTS:
KEYWORD PARAMETERS:
OUTPUTS:
OPTIONAL OUTPUTS:
COMMON BLOCKS:
SIDE EFFECTS:
RESTRICTIONS:
PROCEDURE:
EXAMPLE:
MODIFICATION HISTORY:
NAME:
CUT_IMG
PURPOSE:
To cut an image at a certain value of its histogram.
This can be useful when a few 'hot' pixels (as they
might occur during flatfielding) might damage the
dynamical range of an image.
First the histogram of the image is calculated.
Then, the value is determinated for which a certain
fraction (default: 99%) lies below this level. All
values higher than this level are set to the pixel
value determined by this level.
CATEGORY:
LASCO
CALLING SEQUENCE:
CUT_IMG,image
INPUTS:
image: a two dimensional (image-)array.
OPTIONAL INPUTS:
None
KEYWORD PARAMETERS:
LEVEL: gives a user specified level at which the
histogram should be cut. If not specified,
the default value is 0.99
UPPER, LOWER: If either is set, the upper cutting
or lower cutting is performed at levels
LEVEL and (1-LEVEL)
VERBOSE: If set, additional information is given
OUTPUTS:
The image, limited in the dynamical range to the
(LEVEL) lower part.
OPTIONAL OUTPUTS:
None
EXAMPLE:
newimage=CUT_MAX(image,LEVEL=.99,/LOW,/UP)
The upper 1% of the image will be set to the value
of the former 99% level, the lower 1% to the value
of 1%;
COMMON BLOCKS:
None
SIDE EFFECTS:
None
RESTRICTIONS:
None
MODIFICATION HISTORY: V1.0 Alexander Epple 30-Jun-1994 : MPAe
LOWER and UPPER Keywords: AE 25-MAR-1997 MPAe
NAME:
CUT_MAX
PURPOSE:
To cut an image at a certain value of its histogram.
This can be useful when a few 'hot' pixels (as they
might occur during flatfielding) might damage the
dynamical range of an image.
First the histogram of the image is calculated.
Then, the value is determinated for which a certain
fraction (default: 99%) lies below this level. All
values higher than this level are set to the pixel
value determined by this level.
CATEGORY:
PICO
CALLING SEQUENCE:
CUT_MAX,image
INPUTS:
image: a two dimensional (image-)array.
OPTIONAL INPUTS:
None
KEYWORD PARAMETERS:
LEVEL: gives a user specified level at which the
histogram should be cut. If not specified,
the default value is 0.99
UPPER, LOWER: If either is set, the upper cutting
or lower cutting is performed at levels
LEVEL and (1-LEVEL)
VERBOSE: If set, additional information is given
OUTPUTS:
The image, limited in the dynamical range to the
(LEVEL) lower part.
OPTIONAL OUTPUTS:
None
EXAMPLE:
newimage=CUT_MAX(image,LEVEL=.99,/LOW,/UP)
The upper 1% of the image will be set to the value
of the former 99% level, the lower 1% to the value
of 1%;
COMMON BLOCKS:
None
SIDE EFFECTS:
None
RESTRICTIONS:
None
MODIFICATION HISTORY: V1.0 Alexander Epple 30-Jun-1994 : MPAe
LOWER and UPPER Keywords: AE 25-MAR-1997 MPAe
Project : SOHO - LASCO Name : DMEMORY Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
NAME:
DMOVIE
PURPOSE:
This procedure will generate a list of images for selected day, create
image reduce header catalog, sort images on date and time, write a list
of images on ../work/$USER/list with name of the last processed day:
960704.lst and write processed images on ../work/$USER/fits.
CATEGORY:
LASCO DATA ANALYSIS
CALLING SEQUENCE:
DMOVIE
INPUTS:
KEYWORD PARAMETERS:
INST: A string for instrument: 'C1' is default.
DAY: A string array: day = ['960703','960704']
FILTER: A string for the filter: filter = 'Fe XIV'
TSPAN: A float number, time span in sec. between C1 off and on
line image (default 700 sec).
LAYOUT: IF this keyword is set, no layout will be processed.
NO_PROCESS: If this keyword is set, images will not be processed,
only a list file will be written on disk.
SIDE EFFECTS:
A list file in the $WORK/$USER/list directory will be written.
PROCEDURE:
EXAMPLE:
DMOVIE,day='960704'
DMOVIE,day=['960703','960704'],inst='C1',filter='Fe XIV'
MODIFICATION HISTORY:
Written by: B Podlipnik, 04 Jul 1996
@(#)c1_iod.pro 1.1 11/02/01 LASCO IDL LIBRARY
NAME:
DMOVIE
PURPOSE:
This procedure will generate a list of images for selected day, create
image reduce header catalog, sort images on date and time, write a list
of images on ../work/$USER/list with name of the last processed day:
960704.lst and write processed images on ../work/$USER/fits.
CATEGORY:
LASCO DATA ANALYSIS
CALLING SEQUENCE:
DMOVIE
INPUTS:
KEYWORD PARAMETERS:
INST: A string for instrument: 'C1' is default.
DAY: A string array: day = ['960703','960704']
FILTER: A string for the filter: filter = 'Fe XIV'
TSPAN: A float number, time span in sec. between C1 off and on
line image (default 700 sec).
LAYOUT: IF this keyword is set, no layout will be processed.
NO_PROCESS: If this keyword is set, images will not be processed,
only a list file will be written on disk.
SIDE EFFECTS:
A list file in the $WORK/$USER/list directory will be written.
PROCEDURE:
EXAMPLE:
DMOVIE,day='960704'
DMOVIE,day=['960703','960704'],inst='C1',filter='Fe XIV'
MODIFICATION HISTORY:
Written by: B Podlipnik, 04 Jul 1996
@(#)dmovie.pro 1.1 11/02/01 LASCO IDL LIBRARY
aij are four images taken using the M1 dynamic imaging technique
this procedure inserts the four images aij into the appropriate
array positions in a 2x larger array.
the four images are
a0 original position
a1 shifted 1/2 pixel to the right
a2 shifted 1/2 pixel to the right and 1/2 down
a3 shifted 1/2 pixel down
[ 0 1 0 1 ...
[ 3 2 3 2 ...
result = [ 0 1 0 1 ...
[ 3 2 3 2 ...
[ . . . .
ra howard 10 mar 93
SCCS variables for IDL use
@(#)dynimg.pro 1.2 4/8/93 :NRL Solar Physics
NAME: EPHEMERIS PURPOSE: To do basic calculation of solar ephemeris. The Date for which the calculations should be performed can be entered by an input variable or they will be prompted by the program. The ephemeris are displayed on the screen if none of the various output keywords is specified, else the output of the procedure is given by keywords (see there). CATEGORY: PICO CALLING SEQUENCE: EPHEMERIS INPUTS: None OPTIONAL INPUTS: date: The date (in UT) for which the ephemeris are to be calculated. date is a string matching to the IDL time format; it has the same form as the result of SYSTIME(). See there for the correct format. KEYWORD PARAMETERS: There are quite a lot of Keywords to specify with which you can retrieve the calculated values. If no output keyword is specified, the result of the calculations will be displayed in the Log Window. INPUT KEYWORDS: =============== YEAR: gives the year (four digits requested, f.ex. 1994 instead of 94) MONTH: gives the month (1 for JAN, 12 for DEC etc.) DAY: gives the day. HOUR: gives the hour in UT (from 0 to 23) MINUTE: gives the respective minute NOW: If specified, the calculations are done for the systemtime given by SYSTIME(). HEADER: Date and time are taken out of an image header MODIFY_HEADER: If set, no output is given on the screen but the header on input is modified in a way that all the calculated results are written in. A header must be given. OUTPUT KEYWORDS: ================ AZ_SUN: The Azimut of the sun, measured from the south about the west. Azimut and height are calculated for Pic Du Midi. B0: The latitude of the solar disk center DEL_SUN: The declination of the sun in degrees HANGLE: The hourangle of the sun. H_SUN: The height above the horizon. Height and Azimut are calculated for Pic Du Midi. INCLINATION: Returns the inclination of the solar rotational axis. JULDAT: Named variable which returns the Julian day for that instant exact to 1/4 of a day. Up to now it is not known how to perform a better precision. L0: The longitude of the solar disk center LONGSUN: Returns the longitude of the sun in the ecliptical plane. NORTHANGLE: The angle between the solar rotational axis and the direction to the zenith. OBLIQUITY: Returns the obliquity of the ecliptic (angle between ecliptical plane and equator) RA_SUN: The right ascension of the sun (in degrees) SIDERIAL_TIME: The siderial time for the date SOLDIST: A named variable returning the distance of the earth to the sun in Astronomical units. OUTPUTS: The output of the results is mainly performed by named keywords. However, if no keywords are specified, the output is sent to the Log window. OPTIONAL OUTPUTS: None EXAMPLE: To get the basic ephemeris data about the sun for this instant enter at the prompt EPHEMERIS,SYSTIME() however, if you need the B0 and L0 values for any further treatment, call Ephemeris by EPHEMERIS, date, B0=clatitude, L0=clongitude COMMON BLOCKS: None SIDE EFFECTS: Unknown RESTRICTIONS: None PROCEDURE: This procedure has been transposed from a FORTRAN routine written by Jean Michel Niot, spring 1994. The numerical formulae are taken from Astronomical Algorithms, Jean Meeus. MODIFICATION HISTORY: written by Jean Michel Niot, spring 1994 adapted to IDL by Alexander Epple, 26-OCT-1994, Pic Du Midi
NAME: EPHEMERIS PURPOSE: To do basic calculation of solar ephemeris. The Date for which the calculations should be performed can be entered by an input variable or they will be prompted by the program. The ephemeris are displayed on the screen if none of the various output keywords is specified, else the output of the procedure is given by keywords (see there). CATEGORY: PICO CALLING SEQUENCE: EPHEMERIS INPUTS: None OPTIONAL INPUTS: date: The date (in UT) for which the ephemeris are to be calculated. date is a string matching to the IDL time format; it has the same form as the result of SYSTIME(). See there for the correct format. KEYWORD PARAMETERS: There are quite a lot of Keywords to specify with which you can retrieve the calculated values. If no output keyword is specified, the result of the calculations will be displayed in the Log Window. INPUT KEYWORDS: =============== YEAR: gives the year (four digits requested, f.ex. 1994 instead of 94) MONTH: gives the month (1 for JAN, 12 for DEC etc.) DAY: gives the day. HOUR: gives the hour in UT (from 0 to 23) MINUTE: gives the respective minute NOW: If specified, the calculations are done for the systemtime given by SYSTIME(). HEADER: Date and time are taken out of an image header MODIFY_HEADER: If set, no output is given on the screen but the header on input is modified in a way that all the calculated results are written in. A header must be given. OUTPUT KEYWORDS: ================ AZ_SUN: The Azimut of the sun, measured from the south about the west. Azimut and height are calculated for Pic Du Midi. B0: The latitude of the solar disk center DEL_SUN: The declination of the sun in degrees HANGLE: The hourangle of the sun. H_SUN: The height above the horizon. Height and Azimut are calculated for Pic Du Midi. INCLINATION: Returns the inclination of the solar rotational axis. JULDAT: Named variable which returns the Julian day for that instant exact to 1/4 of a day. Up to now it is not known how to perform a better precision. L0: The longitude of the solar disk center LONGSUN: Returns the longitude of the sun in the ecliptical plane. NORTHANGLE: The angle between the solar rotational axis and the direction to the zenith. OBLIQUITY: Returns the obliquity of the ecliptic (angle between ecliptical plane and equator) RA_SUN: The right ascension of the sun (in degrees) SIDERIAL_TIME: The siderial time for the date SOLDIST: A named variable returning the distance of the earth to the sun in Astronomical units. OUTPUTS: The output of the results is mainly performed by named keywords. However, if no keywords are specified, the output is sent to the Log window. OPTIONAL OUTPUTS: None EXAMPLE: To get the basic ephemeris data about the sun for this instant enter at the prompt EPHEMERIS,SYSTIME() however, if you need the B0 and L0 values for any further treatment, call Ephemeris by EPHEMERIS, date, B0=clatitude, L0=clongitude COMMON BLOCKS: None SIDE EFFECTS: Unknown RESTRICTIONS: None PROCEDURE: This procedure has been transposed from a FORTRAN routine written by Jean Michel Niot, spring 1994. The numerical formulae are taken from Astronomical Algorithms, Jean Meeus. MODIFICATION HISTORY: written by Jean Michel Niot, spring 1994 adapted to IDL by Alexander Epple, 26-OCT-1994, Pic Du Midi
Project : SOHO - LASCO Name : EXSUNC Purpose : Extract sun's x,y and radius from image header Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 03-Oct-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO
Name : FITSHDR2STRUCT
Purpose : Read a LASCO FITS file to obtain an image and header array.
Explanation : This routine calls the IDL Astronomy Library routine READFITS
to read the LASCO FITS file. It then fills in a LASCO header
structure with the header information.
Use : IDL> lasco_hdr = FITSHDR2STRUCT(fits_hdr)
Inputs : fits_hdr FITS header, STRARR
Outputs : lasco_hdr LASCO header structure.
Calls : FXPAR, GETTOK
Category : Data_Handling, I_O
Prev. Hist. : None.
Written : Borut Podlipnik, MPAe, Mar. 1996.
Modified : 03/07/96 lasco_fitshdr2struct written by S. Passwaters
10/21/98 nbr fix mysterious problem with blank keywords
Version : Version 0.2, 21 Oct 1998
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 22-Mar-1996, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
NAME:
GAMMASCAL
PURPOSE:
To modify images in order to account
for a certain gamma-factor WITHOUT
changing the IDL color table.
CATEGORY:
PICO
CALLING SEQUENCE:
result=GAMMASCAL(image,gamma)
INPUTS:
image: The image to be scaled
gamma: The gamma exponent to be used
OPTIONAL INPUTS:
None
KEYWORD PARAMETERS:
VERBOSE: Gives time indications about
needed time...
OUTPUTS:
result: The scaled image
OPTIONAL OUTPUTS:
None
EXAMPLE:
TVSCL,GAMMASCAL(image,.3)
The image will be displayed using a gamma
exponent of 0.3 without changing the IDL
color table
COMMON BLOCKS:
None
SIDE EFFECTS:
Unknown
RESTRICTIONS:
None
PROCEDURE:
A lookup table is created and then each
pixel value is replaced by the new one.
By efficient programming the procedure
could perhaps be speeded up slightly.
MODIFICATION HISTORY:
V1.0 Alexander Epple 14-FEB-1996 MPAe Lindau
NAME:
GAMMASCAL
PURPOSE:
To modify images in order to account
for a certain gamma-factor WITHOUT
changing the IDL color table.
CATEGORY:
PICO
CALLING SEQUENCE:
result=GAMMASCAL(image,gamma)
INPUTS:
image: The image to be scaled
gamma: The gamma exponent to be used
OPTIONAL INPUTS:
None
KEYWORD PARAMETERS:
VERBOSE: Gives time indications about
needed time...
OUTPUTS:
result: The scaled image
OPTIONAL OUTPUTS:
None
EXAMPLE:
TVSCL,GAMMASCAL(image,.3)
The image will be displayed using a gamma
exponent of 0.3 without changing the IDL
color table
COMMON BLOCKS:
None
SIDE EFFECTS:
Unknown
RESTRICTIONS:
None
PROCEDURE:
A lookup table is created and then each
pixel value is replaced by the new one.
By efficient programming the procedure
could perhaps be speeded up slightly.
MODIFICATION HISTORY:
V1.0 Alexander Epple 14-FEB-1996 MPAe Lindau
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 06-May-1996, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
NAME:
GET_LIST
PURPOSE:
This procedure will return a list of images for selected day(s) from
LASCO/EIT image tree (QL_IMG or LZ_IMG), create reduce image header
catalog, query images on selected keywords and sort images on time.
CATEGORY:
LASCO DATA ANALYSIS
CALLING SEQUENCE:
GET_LIST
INPUTS:
KEYWORD PARAMETERS:
INST: A string for instrument: 'C1' is default.
DAY: A string array: day = ['960703','960704']
ROWS: An integer value for # of rows
COLS: An integer value for # of cols
FILTER: A string for the filter: filter = 'Fe XIV'
POLAR: A string for the polarizer
WAVE: A float array for the wavelength: wave = [5309.2]
QL_IMG: Location of QuickLook images
LZ_IMG: Location of LZ images
SIDE EFFECTS:
PROCEDURE:
EXAMPLE:
list = GET_LIST(day='960704')
list = GET_LIST(day=['960703','960704'],inst='C1',filter='Fe XIV',/wave)
MODIFICATION HISTORY:
Written by: B Podlipnik, 13 March 1997
@(#)get_list.pro 1.1 11/02/01 LASCO IDL LIBRARY
NAME:
GET_SUN_CENTER
PURPOSE:
This function returns the center of the occulting disk as a 2
element array of the column and row numbers. The number starts
at 0. The definition in the FITS header is starting from 1.
CATEGORY:
LASCO_ANALYSIS
CALLING SEQUENCE:
Result = GET_SUN_CENTER (Hdr)
INPUTS:
Hdr: A LASCO header structure for the image that the center is desired
OPTIONAL INPUTS:
FULL=FULL: If the image has been placed in a square field. Ex:
Result = GET_SUN_CENTER (Hdr, FULL=1024)
Result = GET_SUN_CENTER (Hdr, FULL=512)
RAW: If set, no corrections are applied
OUTPUTS:
This function returns the occulter center as a two element array
in which the first element is the column center and the second
element is the row center.
RESTRICTIONS:
Returns the center for the readout port "C"
PROCEDURE:
Returns values that have been determined by other means and put
into a table here.
MODIFICATION HISTORY:
Written by: S.E. Paswaters, 30 August 1996
Updated:
96/10/04 SEP Changed FULL to allow different sizes.
97/01/08 SHH Added correction for cropped images.
97/02/11 RAH Added keyword to return raw center
@(#)get_sun_cen.pro 1.1 11/02/01 LASCO IDL LIBRARY
NAME:
GET_SUN_CENTER
PURPOSE:
This function returns the center of the occulting disk as a 2
element array of the column and row numbers. The number starts
at 0. The definition in the FITS header is starting from 1.
CATEGORY:
LASCO_ANALYSIS
CALLING SEQUENCE:
Result = GET_SUN_CENTER (Hdr)
INPUTS:
Hdr: A LASCO header structure for the image that the center is desired
OPTIONAL INPUTS:
FULL=FULL: If the image has been placed in a square field. Ex:
Result = GET_SUN_CENTER (Hdr, FULL=1024)
Result = GET_SUN_CENTER (Hdr, FULL=512)
RAW: If set, no corrections are applied
OUTPUTS:
This function returns the occulter center as a two element array
in which the first element is the column center and the second
element is the row center.
RESTRICTIONS:
Returns the center for the readout port "C"
PROCEDURE:
Returns values that have been determined by other means and put
into a table here.
MODIFICATION HISTORY:
Written by: S.E. Paswaters, 30 August 1996
Updated:
96/10/04 SEP Changed FULL to allow different sizes.
97/01/08 SHH Added correction for cropped images.
97/02/11 RAH Added keyword to return raw center
@(#)getsuncen.pro 1.1 11/02/01 LASCO IDL LIBRARY
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - CDS
Name : HEADFITS()
Purpose : Read a FITS file header record
Category :
Explanation : Reads a FITS file header record.
Syntax : Result = headfits( filename ,[ EXTEN = ])
Example : Read the FITS header of a file 'test.fits' into a
string variable, h
IDL> h = headfits( 'test.fits')
Inputs : FILENAME = String containing the name of the FITS file to be
read.
Opt. Inputs : None.
Outputs : Result of function = FITS header, string array
Opt. Outputs: None.
Keywords : EXTEN = integer scalar, specifying which FITS extension to
read. For example, to read the header of the first
extension set EXTEN = 1. Default is to read the
primary FITS header (EXTEN = 0).
Common : None.
Restrictions: None.
Side effects: None.
History :
adapted by Frank Varosi from READFITS by Jim Wofford, January, 24 1989
Keyword EXTEN added, K.Venkatakrishna, May 1992
Make sure first 8 characters are 'SIMPLE' W. Landsman October 1993
GSFC, 24 January 1989, Frank Varosi, Written
Modified Version 1, Liyun Wang, GSFC/ARC, September 19, 1994
Incorporated into CDS library
Version 2, William Thompson, GSFC/ARC, 9 January 1995
Incorporated following change:
Check PCOUNT and GCOUNT W. Landsman December 1994
Contact :
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT
Name : LAYOUT
Purpose : draw a layout to the image
Category : DISPLAY
Explanation :
Syntax : layout,image,name,head,hindex
Examples :
Inputs :
Opt. Inputs :
Outputs :
Opt. Outputs:
Keywords :
Common : wload.com
Restrictions:
Side effects:
MODIFICATION HISTORY:
Written by: Borut Podlipnik, 15-jan-1993, MPAe
Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
MAKE_MPEG
Usage:
make_mpeg, filename[, destdir]
Arguments:
filename string input The name of the MPEG file (if not
given, then use lasco.mpg).
destdir string input The name of the directory in which to
put the mpeg file. (If not given then
use: ${LASCO_WORK}/${USER}/gif)
Keywords:
times int input If set, then put the time on the
frames before dumping them. (1 -
bottom left, 2 - bottom right, 3 - top
left, 4 - bottom right)
scratchdir string in The directory to which to write the gif
files (default = destdir)
table int input The colour table to use
range float input The range of image values to display
(default min & max of first image)
ncolours int input The number of colours to use in each
frame (Default !d.table_size) N.B. if
this key is set, then TABLE must be
set as well.
names int input If set, put the names of the input
files on the files before dumping them
(same code as time and note it's not
clever enough to check if they are
going on top of each other)
rescale int input The rescaling factor (-n = increase by
2^n, +n = decrease by 2^n)
Method:
Saves the selected images as PPM (Portable PixMap) format
files and then spawns "mpeg_encode" to convert them to an MPEG
file (the PPM files are deleted after the operation)
Restrictions:
1) Can handle a maximum of 1000 frames
2) Must have MPEG_ENCODE available.
3) Any prexisting files called Lnnn.ppm or MPEG.PARAM will be
overwritten.
History:
Original: 23/7/96; SJT
Change from GIF to PPM: 25/7/96; SJT
NAME:
MASKE
PURPOSE:
Performs a unsharp mask treatment with an image
CATEGORY:
PICO
CALLING SEQUENCE:
result = MASKE(image, level, region)
INPUTS:
image: The two dimensional array containing the
image to be masked.
level: An integer specifying the level at which
the image should be treated. See procedure
for more explanations
region: The size of the averaging region for the
smoothed image. See below.
If both level and region are NOT set, a default
value of 3,8 is supposed.
OPTIONAL INPUTS:
None
KEYWORD PARAMETERS:
MEDIAN: If set, the median filter is used to smooth
the image instead of a simple averaging
mean value filter
NOAUTOLIMIT: The image will not be limited to the
same levels as the input image.
OUTPUTS:
result: The resulting image, treated by the unsharp
mask
OPTIONAL OUTPUTS:
None
EXAMPLE:
To treat an image with a 8x8 unsharp mask at a level
of 3 type
result=MASKE(image,3,8)
COMMON BLOCKS:
None
SIDE EFFECTS:
Unknown
RESTRICTIONS:
None
PROCEDURE:
From the original image, multiplied by (level+1),
the original image multiplied by level and
smoothed over region x region pixels is subtracted.
By default the IDL SMOOTH(image,region) function is
used. The MEDIAN functioon can be used by setting
the MEDIAN keyword.
MODIFICATION HISTORY:
Alexander Epple, AUG-1994
Project : SOHO - LASCO/EIT
Name : MKDI_C1
Purpose : Make C1 image of the day.
Explanation : This procedure will make C1 image of the day.For selected day
this routine will find the last pair of on-line and off-line
images and will process them to lasco 'level .99'.
Use : IDL> MKDI_C1 [,DAY=day [,/SCREEN [,/GIF ,....]]]
Without any inputs, program will use default values.
Keyword parameters:
DAY: Selected day: day='960703' (string)
FILTER: The filter: filter='Fe XIV' (string) , default value
POLAR: The polarizer: polar='Clear' (string) , default value
ROWS: The number of rows in image: rows=640 (integer), default value
COLS: The number of cols in image: cols=768 (integer), default value
LEBP: The LEB program: lebp = 'Sum/Diff' (string)
WAVE: The off-line and on-line wave length: wave=[5309.2,5302.4]
SCREEN: Display result to the X-Window: /screen
FITS: Write result as a FITS file: /fits
PS: Write result as a PostScript file: /ps
GIF: Write result as a GIF file: /gif
ARCHIVE:Write result as a GIF file in 'lastimage.gif' format
QL: Make daily C1 image from Quick Look data: /ql
LZ: Make daily C1 image from Lasco_lz data: /lz
COSMIC: Remove cosmic rays: /cosmic
OWNCT: Use own color table: ownct (structure: ownct.r,ownct.g,ownct.b)
LCT: Load IDL color table: lct=8 GREEN/WHITE LINEAR
GCT: Gamma_ct: gct=.25
UP: To cut an image at a certain upper value of its histogram: up =.9996
LOW: To cut an image at a certain lower value of its histogram: low=.01
MINBOX: To cut an image at the median minimum of the background: /minbox
TIME: Get closest image to this time: TIME='8:00' (string)
Example : IDL> MKDI_C1
Without any keywords program will use default values.
Or you can use keywords:
Example : IDL> MKDI_C1,DAY='971031',LEBP='Line Sca',/COSMIC
Calls :
Comments :
Side effects : None.
Category : Image Display. Data analysis.
Written : Borut Podlipnik, MPAe Oct. 15 1997.
Modified : BP 13 Jan 1998 - Added keyword TIME.
Version : 1.0 10/15/97 LASCO IDL LIBRARY
NAME:
MKQUERY
PURPOSE:
This procedure will generate a list of images for selected day, create
image reduce header catalog, sort images on date and time, write a list
of images in $HOME or ../work/$USER/list with name of the first
(first_last) processed day:
960704.lst (960704_960710.lst)
and write processed images on ../work/$USER/fits.
CATEGORY:
LASCO DATA ANALYSIS
CALLING SEQUENCE:
MKQUERY
INPUTS:
KEYWORD PARAMETERS:
INST: A string for instrument: 'C1' is default.
DAY: A string array: day = ['960703','960704']
FILTER: A string for the filter: filter = 'Fe XIV'
POLAR: A string for the polarizer: polar = 'Clear'
WAVE: A float array for the wavelength: wave = [5309.2,5302.4]
PROCESS: If this keyword is set, C1 images will be processed.
SIDE EFFECTS:
PROCEDURE:
EXAMPLE:
MKQUERY,day='960704'
MKQUERY,day=['960703','960704'],inst='C1',filter='Fe XIV'
MODIFICATION HISTORY:
Written by: B Podlipnik, 04 Jul 1996
Version: 1.0
@(#)mkquery.pro 1.1 11/02/01 LASCO IDL LIBRARY
Project : SOHO - LASCO/EIT
Name : MK_IMAGE
Purpose : Make C1 image.
Explanation : This procedure will make C1 image of the day.For selected day
this routine will find the last pair of on-line and off-line
images and will process them to lasco 'level .99'.
Use : IDL>mk_image
Keyword parameters:
IMG0:
IMG1:
FILTER: The filter: filter='Fe XIV' (string) , default value
POLAR: The polarizer: polar='Clear' (string) , default value
ROWS: The number of rows in image: rows=640 (integer), default value
COLS: The number of cols in image: cols=768 (integer), default value
LEBP: The LEB program: lebp = 'Sum/Diff' (string)
WAVE: The off-line and on-line wave length: wave=[5309.2,5302.4]
SCREEN: Display result to the X-Window: /screen
FITS: Write result as a FITS file: /fits
PS: Write result as a PostScript file: /ps
GIF: Write result as a GIF file: /gif
ARCHIVE:Write result as a GIF file in 'lastimage.gif' format
COSMIC: Remove cosmic rays: /cosmic
OWNCT: Use own color table: ownct (structure: ownct.r,ownct.g,ownct.b)
LCT: Load IDL color table: lct=8 GREEN/WHITE LINEAR
GCT: Gamma_ct: gct=.25
UP: To cut an image at a certain upper value of its histogram: up =.9996
LOW: To cut an image at a certain lower value of its histogram: low=.01
MINBOX: To cut an image at the median minimum of the background: /minbox
Example : IDL> MK_IMAGE,IMG0,HDR0,IMG1,HDR1
Without any keywords program will use default values.
;
Calls :
Comments :
Side effects : None.
Category : Image Display. Data analysis.
Written : Borut Podlipnik, MPAe Oct. 15 1997.
Modified : BP 13 Jan 1998 - Added keyword TIME
BP 05 May 1998 - Added keyword LOG
Version : 1.0 10/15/97 LASCO IDL LIBRARY
MPEG_WID Widget interface for make_mpeg. Usage: mpeg_wid[, group=group] Keyword: group long input The id of the group leader. History: Original: 24/7/96; SJT
Project : SOHO - LASCO/EIT
Name : PICKFILES
Purpose :
This function allows the user to interactively pick a files. A files
selection tool with a graphical user interface is created. Files
can be selected from the current directory or other directories.
Category : Widgets
Explanation :
Use : result = pickfiles()
Examples : result = pickfiles()
Inputs :
Opt. Inputs :
Outputs :
PICKFILES returns a string array that contains the names of the files selected.
If no file(s) is selected, PICKFILES returns a null string.
Opt. Outputs:
Keywords :
FILTER: A string value for filtering the files in the file list.
The user can modify the default filter value: "*.fts *.mvi".
PATH: The initial path to select files from. If this keyword is
not set, the current directory is used.
Common :
Restrictions: None.
Side effects: None.
History : 16-feb-1996,Borut Podlipnik, MPAe,Written
Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
NAME:
PROFILE
PURPOSE:
Extract a profile from an image.
CATEGORY:
Image processing.
CALLING SEQUENCE:
Result = PROFILE(Image, XX, YY)
INPUTS:
Image: The data array representing the image. This array can be
of any type except complex.
KEYWORD PARAMETERS:
XSTART: The starting X location of the lower-left corner of Image.
If this keyword is not specified, 0 is assumed.
YSTART: The starting Y location of the lower-left corner of Image.
If this keyword is not specified, 0 is assumed.
NONMARK: Set this keyword to inhibit marking the image with the
profile line.
OUTPUTS:
PROFILE returns a floating-point vector containing the values of
the image along the profile line marked by the user.
OPTIONAL OUTPUTS:
XX: After picking the end points, XX contains the X coordinates
of the points along the selected profile.
YY: After picking the end points, YY contains the Y coordinates
of the points along the selected profile.
COMMON BLOCKS:
None.
SIDE EFFECTS:
Cursor on image display is enabled.
RESTRICTIONS:
None.
PROCEDURE:
Allow the operator to mark two points on the
image display with the joystick. Extract and
return the points along the line. Optionally
return the X and Y values of each extracted point.
EXAMPLE:
Display an image, select a profile and plot that profile in a new
window. Create and display an image by entering:
A = BYTSCL(DIST(256))
TV, A
Extract a profile from the image. Enter the following command and
mark two points on the image with the mouse:
R = PROFILE(A)
Create a new plotting window and plot the profile by entering:
WINDOW, /FREE
PLOT, R
An interactive version of this routine is available with the User
Library procedure PROFILES.
MODIFICATION HISTORY:
Written, DMS, November, 1982.
Modified for Sun, march, 1988.
December 1991, KRC Made PROFILES return XX and YY.
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project :
Name : READFITSL
Purpose : Read a FITS file into IDL data and header variables.
Category :
Explanation :
Syntax : Result = READFITSL( Filename,[ Header, /NOSCALE, EXTEN_NO = ,
/SILENT , NaNVALUE = , STARTROW = , NUMROW = ] )
Example :
Read a FITS file TEST.FITS into an IDL image array, IM and FITS
header array, H. Do not scale the data with BSCALE and BZERO.
IDL> im = READFITSL( 'TEST.FITS', h, /NOSCALE)
If the file contain a FITS extension, it could be read with
IDL> tab = READFITSL( 'TEST.FITS', htab, /EXTEN )
To read only rows 100-149 of the FITS extension,
IDL> tab = READFITSL( 'TEST.FITS', htab, /EXTEN,
STARTR=100, NUMR = 50 )
Inputs : FILENAME = Scalar string containing the name of the FITS file
(including extension) to be read.
Opt.Inputs :
NOSCALE - If present and non-zero, then the ouput data will not be
scaled using the optional BSCALE and BZERO keywords in the
FITS header. Default is to scale.
SILENT - Normally, READFITS will display the size the array at the
terminal. The SILENT keyword will suppress this
NaNVALUE - This scalar is only needed on Vax architectures. It
specifies the value to translate any IEEE "not a number"
values in the FITS data array. It is needed because
the Vax does not recognize the "not a number" convention.
EXTEN_NO - scalar integer specify the FITS extension to read. For
example, specify EXTEN = 1 or /EXTEN to read the first
FITS extension. Extensions are read using recursive
calls to READFITS.
POINT_LUN - Position (in bytes) in the FITS file at which to start
reading. Useful if READFITS is called by another procedure
which needs to directly read a FITS extension. Should
always be a multiple of 2880.
STARTROW - This keyword only applies when reading a FITS extension
It specifies the row (scalar integer) of the extension table at
which to begin reading. Useful when one does not want to read
the entire table.
NUMROW - This keyword only applies when reading a FITS extension.
If specifies the number of rows (scalar integer) of the
extension table to read. Useful when one does not want to
read the entire table.
Outputs :
Result = FITS data array constructed from designated record.
Opt. Outputs:
Header = String array containing the header from the FITS file.
Keywords :
Common :
Restrictions:
Cannot handle random group FITS
The procedure FXREAD can be used as an alternative to READFITS.
FXREAD has the option of reading a subsection of the primary FITS data.
Procedures used:
Functions: SXPAR, WHERENAN
Procedures: IEEE_TO_HOST, SXADDPAR
History :
MODIFIED, Wayne Landsman October, 1991
Added call to TEMPORARY function to speed processing Feb-92
Added STARTROW and NUMROW keywords for FITS tables Jul-92
Close logical unit if EOF encountered
Make SILENT keyword work for tables Oct-92
Work under "windows" R. Isaacman Jan-93
Check for SIMPLE keyword in first 8 characters Feb-93
Removed EOF function for DECNET access Aug-93
Work under "alpha" Sep-93
Null array processing fixed: quotes in a message
properly nested, return added. Affected case when
readfits called from another procedure. R.S.Hill Jul-94
Added CONTINUE keyword in messages :
message, 'ERROR - EOF encountered while reading
FITS header',/CONTINUE
message,'ERROR - Header does not contain required
SIMPLE keyword',/CONT
and return,-1. B.Podlipnik Feb-95
Contact : BP, borut@lasco1.mpae.gwdg.de
NAME: READ_IMG
PURPOSE: reads a ccd image from disk
CATEGORY: C1
CALLING SEQUENCE: a = read_img(filename)
a = read_img(filename,hdr)
INPUTS: filen = string of the name of the file to read
OPTIONAL INPUT PARAMETERS: None
KEYWORD PARAMETERS: nx - number of rows
ny - number of coloumns
data_type - data type in bytes
OUTPUTS: a = array containing the image
OPTIONAL OUTPUT PARAMETERS: hdr = header to read from disk
COMMON BLOCKS: writes the header to ccd_header
SIDE EFFECTS:
RESTRICTIONS: None
PROCEDURE:
MODIFICATION HISTORY: bp 3/16/93
SCCS variables for IDL use
@(#)read_img.pro 1.0 3/16/93 : MPAe
NAME: RECONVERT PURPOSE: Converts data to a specified data type CATEGORY: PICO CALLING SEQUENCE: result = reconvert(image, data_type) INPUTS: image: array to be converted data_type: an integer between 0 and 7 specifying to which data_type the image should be converted. OPTIONAL INPUT PARAMETERS: None KEYWORD PARAMETERS: None OUTPUTS: result: the converted image of the new data type OPTIONAL OUTPUT PARAMETERS: None COMMON BLOCKS: None SIDE EFFECTS: Unknown RESTRICTIONS: None PROCEDURE: Straightfroward MODIFICATION HISTORY: ae 11-AUG-1994 Pic Du Midi
NAME: RECONVERT PURPOSE: Converts data to a specified data type CATEGORY: PICO CALLING SEQUENCE: result = reconvert(image, data_type) INPUTS: image: array to be converted data_type: an integer between 0 and 7 specifying to which data_type the image should be converted. OPTIONAL INPUT PARAMETERS: None KEYWORD PARAMETERS: None OUTPUTS: result: the converted image of the new data type OPTIONAL OUTPUT PARAMETERS: None COMMON BLOCKS: None SIDE EFFECTS: Unknown RESTRICTIONS: None PROCEDURE: Straightfroward MODIFICATION HISTORY: ae 11-AUG-1994 Pic Du Midi
NAME:
REDUCE_IMG_HDR2
PURPOSE:
This procedure appends information from the current image header to
the header files in $LAST_IMG and in the current image directory.
CATEGORY:
REDUCTION
CALLING SEQUENCE:
REDUCE_IMG_HDR2, Hdr
INPUTS:
Hdr = FITS header
OPTIONAL INPUTS:
None
KEYWORD PARAMETERS:
None
OUTPUTS:
None
OPTIONAL OUTPUTS:
None
MODIFICATION HISTORY:
Written, RA Howard, NRL
VERSION 1 rah 16 Dec 1995
2 rah 28 Dec 1995 Changed environment variable to LAST_IMG
3 rah 29 Mar 1996 Write info to date directory also
4 rah 4 Apr 1996 Modify filt/polar filed to be A6 from A5
@(#)reduce_img_hdr2.pro 1.1 11/02/01 LASCO IDL LIBRARY
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
NAME:
SC
PURPOSE:
To convert a numerical value in a string cutting all
trailing blanks (performed with STRCOMRESS)
CATEGORY:
PICO
CALLING SEQUENCE:
result=SC(value)
INPUTS:
value: The numerical value to be converted into a
string. This might also be a vector (one
dimensional array)
OPTIONAL INPUTS:
None
KEYWORD PARAMETERS:
DECIMALS: gives the number of decimals returned in
the string. Numbers are rounded.
SIGNIFICANT: gives the number of significant digits.
The number of decimals is automatically de-
termined.
FIELD: The number of characters in the output string
result. If the number can not be displayed
with the number of characters, asterisks are
returned (as in FORTRAN); If field is greater
than the number of characters, blanks are added
in front of the string so that the string
always ends with a character.
OUTPUTS:
result: The string without any leading or trailing
blank
OPTIONAL OUTPUTS:
None
EXAMPLE:
To print the result of a calculation execute
print,'The result is: '+SC(result,DEC=3)
Or: print a number with a width of 5 characters:
print, SC(13,FIELD=5) -> ' 13'
print, SC(100000,FIELD=3) -> '**'
COMMON BLOCKS:
None
SIDE EFFECTS:
Unknown
RESTRICTIONS:
None
PROCEDURE:
Straightforward. For Vectors recursive calls are
executed
MODIFICATION HISTORY:
Alo Epple, 31-AUG-1994
Extension for vectors 4-MAY-1995 MPAe Lindau
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT Name : SELECTD Purpose : Select images on date Category : Utils Explanation : From a list of FITS files header is read and a keyword DATE-OBS is checked . Syntax : result = selectd ( files, start_date, end_date ) Examples : Inputs : STRARR files : list with FITS files to be checked STRING start_date, end_date in form : "95-MAR-8" Opt. Inputs : None. Outputs : STRARR result with a list of FITS files found. Opt. Outputs: None. Keywords : None. Common : None. Restrictions: None. Side effects: None. History : 22 mar 1995,Borut Podlipnik,MPAe,Written Contact : BP, borut@lasco1.mpae.gwdg.de Calls : anytim2utc(), grep(), headfits()
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 14-May-1996, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
NAME:
SLIDE_IMAGEf
PURPOSE:
Create a scrolling graphics window for examining large images.
By default, 2 draw widgets are used. The left draw widget shows
a reduced version of the complete image, while the draw widget on
the right displays the actual image with scrollbars that allow sliding
the visible window.
CALLING SEQUENCE:
SLIDE_IMAGE [, Image]
INPUTS:
Image: The 2-dimensional image array to be displayed. If this
argument is not specified, no image is displayed. The
FULL_WINDOW and SCROLL_WINDOW keywords can be used to obtain
the window numbers of the 2 draw widgets so they can be drawn
into at a later time.
KEYWORDS:
CONGRID: Normally, the image is processed with the CONGRID
procedure before it is written to the fully visible
window on the left. Specifying CONGIRD=0 will force
the image to be drawn as is.
FULL_WINDOW: A named variable in which to store the IDL window number of \
the non-sliding window. This window number can be used with
the WSET procedure to draw to the scrolling window at a later
point.
GROUP: The widget ID of the widget that calls SLIDE_IMAGE. If this
keyword is specified, the death of the caller results in the
death of SLIDE_IMAGE.
ORDER: This keyword is passed directly to the TV procedure
to control the order in which the images are drawn. Usually,
images are drawn from the bottom up. Set this keyword to a
non-zero value to draw images from the top down.
REGISTER: Set this keyword to create a "Done" button for SLIDE_IMAGE
and register the widgets with the XMANAGER procedure.
The basic widgets used in this procedure do not generate
widget events, so it is not necessary to process events
in an event loop. The default is therefore to simply create
the widgets and return. Hence, when register is not set,
SLIDE_IMAGE can be displayed and the user can still type
commands at the "IDL>" prompt that use the widgets.
RETAIN: This keyword is passed directly to the WIDGET_DRAW
function, and controls the type of backing store
used for the draw windows. If not present, a value of
2 is used to make IDL handle backing store.
SLIDE_WINDOW: A named variable in which to store the IDL window number of
the sliding window. This window number can be used with the
WSET procedure to draw to the scrolling window at a later
time.
TITLE: The title to be used for the SLIDE_IMAGE widget. If this
keyword is not specified, "Slide Image" is used.
TOP_ID: A named variable in which to store the top widget ID of the
SLIDE_IMAGE hierarchy. This ID can be used to kill the
hierarchy as shown below:
SLIDE_IMAGE, TOP_ID=base, ...
.
.
.
WIDGET_CONTROL, /DESTROY, base
XSIZE: The maximum width of the image that can be displayed by
the scrolling window. This keyword should not be confused
with the visible size of the image, controlled by the XVISIBLE
keyword. If XSIZE is not specified, the width of Image is
used. If Image is not specified, 256 is used.
XVISIBLE: The width of the viewport on the scrolling window. If this
keyword is not specified, 256 is used.
YSIZE: The maximum height of the image that can be displayed by
the scrolling window. This keyword should not be confused
with the visible size of the image, controlled by the YVISIBLE
keyword. If YSIZE is not present the height of Image is used.
If Image is not specified, 256 is used.
YVISIBLE: The height of the viewport on the scrolling window. If
this keyword is not present, 256 is used.
OUTPUTS:
None.
COMMON BLOCKS:
None.
SIDE EFFECTS:
Widgets for displaying a very large image are created.
The user typically uses the window manager to destroy
the window, although the TOP_ID keyword can also be used to
obtain the widget ID to use in destroying it via WIDGET_CONTROL.
RESTRICTIONS:
Scrolling windows don't work correctly if backing store is not
provided. They work best with window-system-provided backing store
(RETAIN=1), but are also usable with IDL provided backing store
(RETAIN=2).
Various machines place different restrictions on the size of the
actual image that can be handled.
MODIFICATION HISTORY:
7 August, 1991, Written by AB, RSI.
10 March, 1993, ACY, Change default RETAIN=2
23 Sept., 1994 KDB, Fixed Typo in comments. Fixed error in
Congrid call. xvisible was used instead of yvisible.
14 June, 1999 NBR, Make full-image window always 256x256;
change name to SLIDE_IMAGEf
NAME:
SUNGRID
PURPOSE:
To plot an overlay on coronal images with
coordinate grids on the disk and in the
corona.
CATEGORY:
PICO
CALLING SEQUENCE:
SUNGRID, P, B0, L0
INPUTS:
P: Position angle of the solar axis
B0: Latitude of the sub-terrestrial point
L0: Longitude of the sub-terrestrial point
OPTIONAL INPUT PARAMETERS:
None
KEYWORD PARAMETERS:
CENTER: gives the [x,y] coorinates of the center of
the solar disk (on which the coordinate grid
should be centered) in the image. Default is
[512,512]
NOSUN: If set, no grid will be drawn on the sun
SUNRADIUS: Factor to multiply the radius of the sun.
Default is SUNRADIUS=1. Then the sun has a
diameter of 489 pixels (corresponding to PICO)
COLOR: Color index for both grids; if COLOR is set
SUNCOLOR and CORONACOLOR are ignored.
CHARSIZE: giving the charsize of the labelling. By
default the charsize is chosen automatically.
HEADER: If an imageheader (PICO-Format!!) is given,
the P, B0 and L0
as well as the apparent solar diameter
will be automatically calculated taking the
data of header.time_obs and header.date_obs
and the EPHEMERIS procedure. The center of
the grid will be either centered on header.hole
or, if present and not [0,0,0,0] on header.sun.
GRID: If a named and not undefined variable is spe-
cified with this keyword, the existing screen
is not overplotted but the grid is returned in
this variable (by passing to the 'Z' device).
SIZE: The size of the image in pixels. Default is
[1024,1024]. If size is scalar, the image is
assumed to be quadratic.
LABEL: If set, coordinate sytems will be labeled
LATLAB: An array indicating the latitudes to be labelled.
By default: latlab=[-60,-30,0,30,60].
LABEL must be set
LONLAB: Same as for latlab. Default: intervals of 30 deg.
LABEL must be set
LATITUDES: An array indicating which latitude circles
shall be drawn. By default: each 15 degrees.
LONGITUDES: Same as for latitudes. Default: 15 degree
spaces.
OUTPUTS:
None. If grid is not set, the image displayed on the
screen will be overplotted.
OPTIONAL OUTPUT PARAMETERS:
None
EXAMPLE:
grid=0
SUNGRID,26,3,155,GRID=grid,CENTER=[256,256],SIZE=512, $
PIXELDIAMETER=370
The named variable grid contains a (512,512) byte array
with the solar grid, centered on [256,256]. The solar disk
has a diameter of 370 Pixels.
COMMON BLOCKS:
None
SIDE EFFECTS:
A displayed image will be overplotted
RESTRICTIONS:
Up to now, the procedure only works for non-scalable
devices (X, WIN, Z etc.) and not yet for the PS-device.
However Parts of the solar disk can be drawn! The entire
grid has not to be drawn anymore.
PROCEDURE:
Straightforward using the map drawing facilities
MAP_SET and MAP_GRID of IDL. The procedure is highly
adapted to PICO instrumental parameters.
V2.0 Does not use the MAP functions anymore in order
to be able to draw the equator instead of the central
latitude circle on the disk
MODIFICATION HISTORY:
Written V1.0 16-OCT-1994 Pic Du Midi
V2.0 Completely self written without IDL-functions MAP_GRID
and MAP_SET: 10-APR-1996 Alexander Epple, MPAE Lindau
Project : SOHO - LASCO
Name : SUN_EPHEM()
Purpose : To calculate the solar ephemeris parameters: ecliptic
longitude, P, B0 angles and the semi-diameter.
Category : Util, Coords
Explanation : Allows for planetary and lunar perturbations in the
calculation of solar longitude and various other solar
positional parameters at date/time requested.
Uses semi-rigorous formulae to calculate the solar P (position
angle of pole) and B0 (latitude of point at disk centre) angles
and also the semi-diameter of the solar disk at the date/time
requested.
Syntax : IDL> ang = pb0r(date_time)
Examples :
Inputs : date_time - the date/time specified in any CDS format
Opt. Inputs : None
Outputs : Function returns a 6-element array with
ang(0) = nu_c (degrees)
ang(1) = nu_p (degrees)
ang(2) = P (degrees)
ang(3) = B0 (degrees)
ang(4) = R semi-diameter (arcmin)
ang(5) = Apparent longitude of
Sun (degrees).
Opt. Outputs: None
Keywords : None
Common : None
;
Side effects: None
History : Based on Fortran programs by Hohenkerk and Emerson (RGO)
16-May-94,CDS/IDL version PB0R.PRO, C D Pike, RAL,Written
Update semi-diameter calculation, CDP, 20-May-94
Version 3, William Thompson, GSFC, 14 November 1994
Modified .DAY to .MJD
Simon Plunkett, UofB, Adapted from CDS routine PB0R to
include solar longitude in output parameters, 10 May 1995.
Version 3, 14 November 1994
Contact :
NAME: TEXTARRAY PURPOSE: To create a two dimensional array containing text in vector font. CATEGORY: PICO CALLING SEQUENCE: result=TEXTARRAY(text) INPUTS: text: A string containing the text OPTIONAL INPUTS: None KEYWORD PARAMETERS: CHARSIZE, CHARTHICK: Normal signification as for other graphical output COLOR: The color index to be used. Default: 255 OUTPUTS: result: a two dimensional array. The background is 0 whereas the text is written in the specified color. The textarray can be inserted in an image using PUT_TEXT. OPTIONAL OUTPUTS: None COMMON BLOCKS: None SIDE EFFECTS: Unknown RESTRICTIONS: None PROCEDURE: Straightforward MODIFICATION HISTORY: V1.0 Alexander Epple, Pic Du Midi, 15-OCT-1995 Jun-2000, B. Podlipnik - Add BOLD, XP, YP keywords
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
NAME: T_CARTES PURPOSE: To convert polar co-ordinates into cartesians (reverse of T_POLAR) CATEGORY: Image manipulation. CALLING SEQUENCE: T_CARTES,IMAGE_IN,IMAGE_OUT,XC,YC,RAD1,RAD2,AZ1,AZ2,COL,LIN INPUTS: IMAGE_IN = input image XC,YC = centre of rotation RAD1,RAD2 = inner and outer radius AZ1,AZ2 = starting and finishing azimuth in degrees. COL,LIN = the number of columns and lines in the output OPTIONAL INPUT PARAMETERS: NONE OUTPUTS: IMAGE_OUT = output image OPTIONAL OUTPUT PARAMETERS: NONE COMMON BLOCKS: NONE SIDE EFFECTS: NONE RESTRICTIONS: NOTE THAT NO MASK IS APPLIED SO THERE WILL BE EDGE EFFECTS PROCEDURE: TRIVIAL MODIFICATION HISTORY: 5-12-89 NT 14-06-1993 NT Version 3.0
NAME: T_POLAR PURPOSE: Polar coordinate transform CATEGORY: Image manipulation. CALLING SEQUENCE: T_POLAR,P,P1,X,Y,RAD1,RAD2,AZ1,AZ2,COL,LIN INPUTS: P = input array X,Y = centre of rotation RAD1,RAD2 = inner and outer radius AZ1,AZ2 = starting and finishing azimuth in degrees. COL = number of samples in radius LIN = number of samples in azimuth OPTIONAL INPUT PARAMETERS: NONE KEYWORDS: NONE OUTPUTS: P1 = OUTPUT ARRAY OPTIONAL OUTPUT PARAMETERS: NONE COMMON BLOCKS: NONE SIDE EFFECTS: NONE RESTRICTIONS: NONE PROCEDURE: TRIVIAL MODIFICATION HISTORY: 10-JUN-1987 NT 5-12-1989 NT Modified to speed up but uses larger arrays!! 14-6-1993 NT Version 3.0 IDL
Project : SOHO - LASCO/EIT Name : UNDEFINE Purpose : Category : Utilities, Array Explanation : Syntax : undefine, a Examples : Inputs : Opt. Inputs : Outputs : Opt. Outputs : Keywords : Common : Restrictions : None. Side effects : None. History : 12 jun 1993,Alo Eple, MPAe,Written Contact :
Project :
Name : VAR_IN
Purpose :import image array and image header
in lasco_block
Category : LASCO
Explanation :
Syntax : var_in,a,h
Examples :
Inputs : array variable, structure for header
Opt. Inputs :
Outputs :
Opt. Outputs:
Keyword : None
Common :
Restrictions: None
Side Effects: lasco_block
History : 1/28/94, B. PODLIPNIK, Written
SCCS variables for IDL use
Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT Name : WC2P Purpose : Category : Widgets Explanation : Syntax : wc2p Examples : Inputs : Opt. Inputs : Outputs : Opt. Outputs: Keywords : Common : Restrictions: Side effects: None. History : 26-sep-1995,Borut Podlipnik, MPAe,Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT Name : WCALCL Purpose : Category : Widgets Explanation : Syntax : wcalcl Examples : Inputs : Opt. Inputs : Outputs : Opt. Outputs : Keywords : Common : Restrictions : None. Side effects : None. History : 12-jun-1994,Borut Podlipnik, MPAe, Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT Name : WCALCNEW Purpose : Category : Widgets Explanation : Syntax : wcalcnew Examples : Inputs : Opt. Inputs : Outputs : Opt. Outputs: Keywords : Common : Restrictions: None. Side effects: None. History : 12-jun-1994,Borut Podlipnik, MPAe,Written Contact : BP, borut@lasco1.mpae.gwdg.de
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, NAMES=names
Inputs : None.
Outputs : None.
Keywords : NAMES Labels to display for frames. STRARR()
Calls :
Restrictions: Data frames must be preloaded into pixmap 9, size(xsize,ysize*len).
Use mkmovie.pro to load into pixmap.
Side effects: None.
Category : Image Display. Animation.
Written : Scott Paswaters, NRL Feb. 13 1996.
Modified :
Version :
Project : SOHO - LASCO/EIT Name : WCURRENT Purpose : Category : Widgets Explanation : Syntax : wcurrent Examples : Inputs : Opt. Inputs : Outputs : Opt. Outputs : Keywords : Common : Restrictions : None. Side effects : None. History : 12-jun-1994,Borut Podlipnik, MPAe, Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT Name : WCURSOR Purpose : Widgets program for reading current cursor position from ;window. Category : Widgets Explanation : Syntax : wcursor,image,x,y,counts,win_id=win_id Examples : Inputs : image Opt. Inputs : x variable for cursor position y variable for cursor position counts variable Outputs : current x and y position if set as optional input parameter counts value at x,y if set as optional input parameter. Opt. Outputs : current x position current y position counts = image(x,y) Keywords : win_id, if not set then current window will be read and set. Common : Restrictions : No check for not valid windows yet ! Side effects : None. History :1-dec-1994, Borut Podlipnik, MPAe, Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT Name : WSAVE_PS Purpose : Category : Widgets Explanation : Syntax : wsave_ps Examples : Inputs : Opt. Inputs : Outputs : Opt. Outputs: Keywords : Common : Restrictions: set default PS keywords. Side effects: None. History : 20-jun-1995,Borut Podlipnik, MPAe,Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO Name : WDMEMORY Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
Program : WFLIMB.PRO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT
Name : WMESSAGE
Purpose :
Category : Widgets
Explanation :
Syntax :
Examples :
Inputs :
Opt. Inputs :
Outputs :
Opt. Outputs:
Keywords : TITLE (a string containing the title to be used for the widget)
LABEL (a string containing a message in WIDGET_LABEL)
TEXT (a string to display in WIDGET_TEXT)
Common :
Restrictions: None.
Side effects: None.
History : 15-nov-1995,Borut Podlipnik, MPAe,Written
Contact : BP, borut@lasco1.mpae.gwdg.de
Program : WHIST.PRO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT Name : WIC Purpose : widgets display countours Category : Widget Explanation : REBIN image and then TVSCL to output device. Syntax : wic Examples : Inputs : from wloadh Opt. Inputs : Outputs : Opt. Outputs: Keywords : Common : lasco.com Restrictions: None. Side effects: None. History : 21-jan-1993,Borut Podlipnik, MPAe, Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT Name : WIMG_INFO1 Purpose : Category : Widgets Explanation : Syntax : wimg_info1 Examples : Inputs : Opt. Inputs : Outputs : Opt. Outputs: Keywords : Common : Restrictions: None. Side effects: None. History : 12-jun-1994,Borut Podlipnik, MPAe,Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT Name : WIMG_INFO2 Purpose : Category : Widgets Explanation : Syntax : wimg_info2 Examples : Inputs : Opt. Inputs : Outputs : Opt. Outputs: Keywords : Common : Restrictions: None. Side effects: None. History : 12-jun-1994,Borut Podlipnik, MPAe,Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT Name : WIMG_INFO3 Purpose : Category : Widgets Explanation : Syntax : wimg_info3 Examples : Inputs : Opt. Inputs : Outputs : Opt. Outputs: Keywords : Common : Restrictions: None. Side effects: None. History : 12-jun-1994,Borut Podlipnik, MPAe,Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT Name : WIMG_INFO4 Purpose : Category : Widgets Explanation : Syntax : wimg_info4 Examples : Inputs : Opt. Inputs : Outputs : Opt. Outputs: Keywords : Common : Restrictions: None. Side effects: None. History : 12-jun-1994,Borut Podlipnik, MPAe,Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT Name : WINFO_ACTIV Purpose : Category : Widgets Explanation : Syntax : winfo_activ Examples : Inputs : Opt. Inputs : Outputs : Opt. Outputs: Keywords : Common : Restrictions: None. Side effects: None. History : 12-jun-1994,Borut Podlipnik, MPAe,Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT Name : WLINES Purpose : plot scan lines Category : Widgets Explanation : Syntax : wlines Examples : Inputs : Opt. Inputs : Outputs : Opt. Outputs: Keywords : Common : lasco.com, wload.com, wplot.com Restrictions: None. Side effects: None. History : 21-feb-1996,Borut Podlipnik, MPAe,Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO
Name : WLISTER
Purpose : Get a list of selected images.
Category : Widget
Explanation : This widget function will return a string array
with filenames and absolute path of selected images.
Use : IDL>list=wlister()
Examples : IDL>list=wlister()
Inputs : None
Opt. Inputs : None
Outputs : A string array.
Opt. Outputs: None
Keywords : None
Common : chandle.com, wload.com
Restrictions: Requires specification of enviroment variables
defined in file: instrument.def
Side effects: Not known
History : ; Version 2.5, 29-Sep-1997, bp
15 Dec 1998 N Rich Changed default source to LZ_IMG
10 Feb 1999 A. Vourlidas, removed MODAL keyword from
XMANAGER call to comply with IDL5.2
03 Jan 2000 D. Wang Y2K date fix
07 Jan 2000 DAB Another Y2K date fix
02 Mar 2001,NBR Do not search LZ directory for available dates; add
informational messages
19 Feb 2002, DAB - Quickpath Directory droplist fixed
28 Jan 2003, NBR - Change findfile path in module FIND; add /VERBOSE
Contact : BP, borut@lasco1.mpae.gwdg.de
Nathan Rich, nathan.rich@nrl.navy.mil
%H% %W% LASCO NRL IDL LIBRARY
Project : SOHO - LASCO
Name : WLOAD
Purpose : Load image(s) in FITS format.
Category : SU:IMAGE_TOOL ?
Explanation : This widget loader tool allows searching images
in your archiv and at the end load it.
Syntax : IDL>wload
Examples : IDL>wload
Inputs : None
Opt. Inputs : None
Outputs : None
Opt. Outputs: None
Keywords : None
Common : dirs_files, lasco.com, wload.com
Restrictions: Requires specification of enviroment variables
defined in file: instrument.def
Side effects: Not known
History : Version 2.0, 28-Sep-1996, B Podlipnik. Written
Version 2.1, 10-Oct-1996, bp
change: replace CW_BSELECTOR with WIDGET_DROPLIST
Version 2.2, 10-Oct-1996, bp
add: SET_DROPLIST_SELECT to widget ID w_d_e, w_d_b
Version 2.3, 29-Oct-1996, bp
change: bug fixed in loading from catalog
Jan-07-2000 bp removed MODAL keyword
Y2K date fixed
Jan 11, 2005 -- Updates (from J.Tappin) to add 2005 to date list
-- bug fix -- remove /utc keyword from systime() call
- Karl B, NRL
Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO
Name : WLOADC
Purpose : Load image(s) in FITS format.
Category : SU:IMAGE_TOOL ?
Explanation : This widget loader tool allows searching images
in your archiv and at the end load it.
Syntax : IDL>wloadc
Examples : IDL>wloadc
Inputs : None
Opt. Inputs : None
Outputs : None
Opt. Outputs: None
Keywords : None
Common : dirs_files, lasco.com, wload.com
Restrictions: Requires specification of enviroment variables
defined in file: instrument.def
Side effects: Not known
History : Version 1, 02-Sep-1995, B Podlipnik. Written
Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT Name : WLOADINFO Purpose : Category : Widgets Explanation : Syntax : wloadinfo Examples : Inputs : Opt. Inputs : Outputs : Opt. Outputs: Keywords : Common : Restrictions: None. Side effects: None. History : 12-jun-1994,Borut Podlipnik, MPAe,Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT Name : WLOADINFO1 Purpose : Category : Widgets Explanation : Syntax : wloadinfo1 Examples : Inputs : Opt. Inputs : Outputs : Opt. Outputs: Keywords : Common : Restrictions: None. Side effects: None. History : 12-jun-1994,Borut Podlipnik, MPAe,Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT
Name : WMESSAGE
Purpose :
Category : Widgets
Explanation :
Syntax :
Examples :
Inputs :
Opt. Inputs :
Outputs :
Opt. Outputs:
Keywords : TITLE (a string containing the title to be used for the widget)
LABEL (a string containing a message in WIDGET_LABEL)
TEXT (a string to display in WIDGET_TEXT)
Common :
Restrictions: None.
Side effects: None.
History : 15-nov-1995,Borut Podlipnik, MPAe,Written
Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO
Name : WOBSDATE*
Purpose :
Category : SU:IMAGE_TOOL ?
Explanation : This widget FITS search tool allows searching images
on specific observation date. Image header will be
scaned for keyword observation date.
Syntax : IDL>wobsdate, instruments, path, filter
Examples : IDL>wloada, " LASCO C1 ", "/data/lasco/c1", "*.fits"
Inputs : string array of instruments,
string array of directories,
string array of searcing filter.
Opt. Inputs : None
Outputs : string array of files,
string array of directories.
Opt. Outputs: None
Keywords : None
Common : dirs_files, date_block
Restrictions: None
Side effects: Not known
History : Version 1, 02-Sep-1995, B Podlipnik. Written
Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT Name : WPLOT Purpose : plot Category : Widgets Explanation : Syntax : wplot Examples : Inputs : Opt. Inputs : Outputs : Opt. Outputs: Keywords : Common : lasco.com, wload.com, wplot.com Restrictions: None. Side effects: None. History : 15-jan-1993,Borut Podlipnik, MPAe,Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT Name : WPLOT1 Purpose : plot Category : Widgets Explanation : Syntax : wplot1 Examples : Inputs : Opt. Inputs : Outputs : Opt. Outputs: Keywords : Common : lasco.com, wload.com, wplot.com Restrictions: None. Side effects: None. History : 15-jan-1993,Borut Podlipnik, MPAe,Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO Name : WREBIN Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 13-Nov-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
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
NAME: WRITE_LAST_IMG
PURPOSE: Create GIF image of the last real time image
processed so that xv can then read and display
it.
CATEGORY: REDUCTION
CALLING SEQUENCE: WRITE_LAST_IMG,Img,Hdr
INPUTS: Img = Input Image array
Hdr = FITS header
OPTIONAL INPUTS: None
KEYWORD PARAMETERS: None
OUTPUTS: None
OPTIONAL OUTPUTS: None
COMMON BLOCKS: None
SIDE EFFECTS: None
RESTRICTIONS: This must be done with IDL haveing an X window
display.
PROCEDURE: Scales the image to not larger than 512 x 512,
and creates a GIF image with annotation along
the side
EXAMPLE:
MODIFICATION HISTORY: Written, RA Howard, NRL
VERSION 1 rah 9 Nov 1995
VERSION 2 rah 16 Nov 1995 Conversions added
VERSION 3 rah 29 Nov 1995 Modified layout
VERSION 4 rah 11 Dec 1995 Modified Detector conversion
VERSION 5 rah 12 Jan 1996 Changed assumption to be !order = 0
Added R1 and R2 in place of P1, P2
VERSION 6 rah 19 Apr 1996 Modified scaling of EIT image
Corrected display of PIXSUM to include LEB
VERSION 7 rah 23 May 1996 Corrected handling of images outside of chip
VERSION 8 rah 22 Jul 1996 Corrected handling of cals > 1024 lines
VERSION 9 rah 8 Oct 1996 Added subtraction of background model
VERSION 10 sep 18 Jun 1997 Changed call for new OFFSET_BIAS()
@(#)write_last_img.pro 1.12 10/06/97 LASCO IDL LIBRARY
Project : SOHO - LASCO/EIT
Name : WRUNMOVIE4
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> WRUNMOVIE4 [, arg1 [, NAMES=names [,/PREVIOUS]]]
Without any inputs, program will prompt user to select an existing .mvi file.
Example : IDL> WRUNMOVIE4
Or you could have one argument, the .mvi file you want to load.
Example : IDL> WRUNMOVIE4, 'mymovie.mvi'
Or if you have pre-loaded images into pixmaps (like MKMOVIE2.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> WRUNMOVIE4, win_index, NAMES=names
If after exiting WRUNMOVIE4 you want to re-load the movie call:
Example : IDL> WRUNMOVIE4, /PREVIOUS
Calls :
Comments : Use MKMOVIE2.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.
Version :
See Also : MKMOVIE2.PRO
Project : SOHO - LASCO/EIT Name : WR_BEAM Purpose : Ploting radial beams Explanation : Use : wr_beam Inputs : Opt. Inputs : Outputs : Opt. Outputs : Keywords : Calls : Common : lasco.com, wload.com, wplot.com Restrictions : None. Side effects : None. Category : Widgets Prev. Hist. : None. Written : Borut Podlipnik, MPAe, 01-oct-1995 Modified : Version :
Project : SOHO - LASCO/EIT Name : WR_BEAM1 Purpose : Ploting radial beams Explanation : Use : wr_beam1 Inputs : Opt. Inputs : Outputs : Opt. Outputs : Keywords : Calls : Common : lasco.com, wload.com, wplot.com Restrictions : None. Side effects : None. Category : Widgets Prev. Hist. : None. Written : Borut Podlipnik, MPAe, 01-oct-1995 Modified : Version :
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT Name : WSAVE_PS Purpose : Category : Widgets Explanation : Syntax : wsave_ps Examples : Inputs : Opt. Inputs : Outputs : Opt. Outputs: Keywords : Common : Restrictions: set default PS keywords. Side effects: None. History : 20-jun-1995,Borut Podlipnik, MPAe,Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT Name : WSIZE Purpose : Explanation : Use : wsize Inputs : Opt. Inputs : Outputs : Opt. Outputs : Keywords : Calls : Common : Restrictions : None. Side effects : None. Category : Widgets Prev. Hist. : None. Written : Borut Podlipnik, MPAe, 07-mar-1995 Modified : Version :
Project : SOHO - LASCO/EIT Name : WSUNPROFILE Purpose : plot Category : Widgets Explanation : Syntax : wsunprofile Examples : Inputs : Opt. Inputs : Outputs : Opt. Outputs: Keywords : Common : lasco.com, wload.com, wplot.com Restrictions: None. Side effects: None. History : 15-jan-1993,Borut Podlipnik, MPAe,Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO Name : WDMEMORY Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT Name : WTIME_HEIGHT Purpose : plot time-height, time-speed, distance-speed diagrams. Category : Widgets Explanation : Syntax : wtime_height Examples : Inputs : Opt. Inputs : Outputs : Opt. Outputs: Keywords : Common : wsave_ps_block, lines_block, t2d_common Restrictions: None. Side effects: None. History : 11-dec-1996,Borut Podlipnik, MPAe,Written Version 1.0, 11-dec-96 Contact : BP, borut@lasco1.mpae.gwdg.de
Project : SOHO - LASCO/EIT
Name : WYES_NO
Purpose :
Category : Widgets
Explanation :
Syntax : Result=wyes_no()
Examples :
Inputs :
Opt. Inputs :
Outputs :
Opt. Outputs:
Keywords : TITLE (a string containing the title to be used for the widget)
LABEL (a string containing a message in WIDGET_LABEL)
TEXT (a string to display in WIDGET_TEXT)
Common :
Restrictions: None.
Side effects: None.
History : 20-oct-1995,Borut Podlipnik, MPAe,Written
Contact : BP, borut@lasco1.mpae.gwdg.de
NAME:
XLOADCT
PURPOSE:
A graphical interface to the LOADCT user library procedure.
XLOADCT displays the current color map and provides
an array of buttons, one per availible predefined color
table. Using the mouse to press these buttons causes
the corresponding color map to be loaded.
CATEGORY:
Widgets
CALLING SEQUENCE:
XLOADCT
INPUTS:
None.
KEYWORDS:
FILE: If this keyword is set, the file by the given name is used
instead of the file colors1.tbl in the IDL directory. This
allows multiple IDL users to have their own color table file.
GROUP = The widget ID of the widget that calls XLoadct. When
this ID is specified, a death of the caller results in a
death of XLoadct
NCOLORS = number of colors to use. Use color indices from BOTTOM
to the smaller of !D.TABLE_SIZE-1 and NCOLORS-1.
Default = !D.TABLE_SIZE = all available colors.
BOTTOM = first color index to use. Use color indices from BOTTOM to
BOTTOM+NCOLORS-1. Default = 0.
PICK_ONE - Normally, XLOADCT remains running until the user
presses the "QUIT" button. If PICK_ONE is present and
non-zero, the "QUIT" button is not displayed, and
XLOADCT quits after a single selection.
SILENT - Normally, no informational message is printed when
a color map is loaded. If this keyword is present and
zero, this message is printed.
USE_CURRENT: If set, use the current color tables, regardless of
the contents of the COMMON block COLORS.
OUTPUTS:
None.
COMMON BLOCKS:
None.
SIDE EFFECTS:
One of the predefined color maps may be loaded.
RESTRICTIONS:
This routine uses the LOADCT user library procedure to
do the actual work.
MODIFICATION HISTORY:
24, August, 1990, Written by AB, RSI.
March 1, 1992 Mark Rivers added Reverse Table to options menu.
7/92, DMS, Added new color tables (allows more than 16).
9/92, ACY, Add FILE keyword.
PROJECT:
SOHO - CDS/SUMER
NAME:
XVALIDL()
PURPOSE:
Determine if a named widget is registered with XMANAGER
CATEGORY:
Utility
EXPLANATION:
This is a widget utility program similar to xregistered (it is
actually modified from xregistered). It does one more thing
than xregistered: it returns the ID of the named widget as an
optional output keyword parameter. XREGISTERED should have had
this ID keyword (suggestion has been sent to RSI by LYW).
SYNTAX:
Result = xvalidl(name)
EXAMPLES:
IF xvalidl('image_tool', id=parent) THEN ...
INPUTS:
NAME - String, name of the widget program
OPTIONAL INPUTS:
None.
OUTPUTS:
RESULT - Integer with a value of 1 or 0, indicating if the
named widget is registered with XMANAGER
OPTIONAL OUTPUTS:
ID - ID of the top level widget which is registered with
XMANAGER. If the named widget is not registered with
XMANAGER, a -1 will be returned.
KEYWORDS:
NOSHOW - If the widget in question is registered, it is brought
to the front of all the other windows by default. Set this
keyword to keep the widget from being brought to the front.
COMMON:
MANAGED (defined in XMANAGER and XREGISTERED)
RESTRICTIONS:
XMANAGER and/or XREGISTERED must be called prior to calling
this routine to establish the MANAGED common block.
SIDE EFFECTS:
The named widget is brought to foreground id NOSHOW keyword is
not set.
HISTORY:
Version 1, January 4, 1996, Liyun Wang, GSFC/ARC. Modified
from XREGISTERED
CONTACT:
Liyun Wang, GSFC/ARC (Liyun.Wang.1@gsfc.nasa.gov)
NAME: XVAREDT PURPOSE: This routine provides an editor for any IDL variable. CATEGORY: Widgets CALLING SEQUENCE: XVAREDT, VAR INPUTS: VAR = The variable that is to be edited. KEYWORD PARAMETERS: NAME = The NAME of the variable. This keyword is overwritten with the structure name if the variable is a structure. GROUP = The widget ID of the widget that calls XVarEdit. When this ID is specified, a death of the caller results in a death of XVarEdit. OUTPUTS: VAR= The variable that has been edited, or the original when the user selects the "Cancel" button in the editor. COMMON BLOCKS: Xvarcom - stores the state of the variable that is being edited. SIDE EFFECTS: Initiates the XManager if it is not already running. RESTRICTIONS: If the variable is exceedingly large such as a giant structure or huge array, the editor will not fit on the screen and may not be able to create enough widget components to edit the whole variable. PROCEDURE: Create and register the widget and then exit. If the user selects "accept", the values in the editor are written to the variable passed in, otherwise, they are ignored. MODIFICATION HISTORY: Written by: Steve Richards, February, 1991
NAME: XY_BILIN PURPOSE: Bilinear interpolation routine for arrays. CATEGORY: Image analysis. CALLING SEQUENCE: XY_BILIN,P,X1,Y1,VAL INPUTS: P = array. X1,Y1 = required points. OPTIONAL INPUT PARAMETERS: NONE OUTPUTS: VAL = value at point. OPTIONAL OUTPUT PARAMETERS: NONE COMMON BLOCKS: NONE SIDE EFFECTS: NONE RESTRICTIONS: NONE PROCEDURE: TRIVIAL MODIFICATION HISTORY: 3-3-87 NT 10-6-1987 REVISED TO SET MISSING PIXELS TO -32768 NT 28-1-88 NT REVISED 11-3-88 revised because of possible errors caused by large array manipulation. NT
NAME:
YYMMDD
PURPOSE:
YYMMDD returns a list of "numerical" directories (e.g., '970803/')
It rejects other directories (e.g. assorted/, bad_dates/)
CALLING SEQUENCE:
yymmdd, ff
INPUTS:
ff -- a list of directories
OUTPUTS:
Returns only "numerical" directories
SIDE EFFECTS:
RESTRICTIONS:
Uses the CDS routine VALID_NUM to check for numerical directories
PROCEDURE:
MODIFICATION HISTORY:
Written by: A. Vourlidas 9/12/97
Project : SOHO - LASCO Name : Purpose : Category : Explanation : Syntax : Examples : Inputs : None Opt. Inputs : None Outputs : None Opt. Outputs: None Keywords : None Common : Restrictions: Side effects: Not known History : Version 1, 02-Sep-1995, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
lasco_mk_html_help.pro on
Wed Aug 17 12:21:35 2005.