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 Jan 20 10:27:28 1999.
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
(See ./chandle.pro)
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
(See ./chk_h4s.pro)
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:
(See ./cosmics.pro)
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
(See ./cut_img.pro)
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
(See ./cut_max.pro)
NAME: DATA_TYPE PURPOSE: To determine the data type of a variable CATEGORY: PICO CALLING SEQUENCE: result=DATA_TYPE(var) INPUTS: var: any variable OPTIONAL INPUTS: None KEYWORD PARAMETERS: None OUTPUTS: result: The data type (integer from 1...7 as diefined by the SIZE function) OPTIONAL OUTPUTS: None EXAMPLE: PRINT,DATA_TYPE(1) will return 2 (integer data type) COMMON BLOCKS: None SIDE EFFECTS: Unknown RESTRICTIONS: None PROCEDURE: Straightforward using the SIZE function MODIFICATION HISTORY: V1.0 Alexander Epple, MPAe Lindau, 25-APR-1996
(See ./data_type.pro)
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
(See ./dmemory.pro)
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 %W% %H% LASCO IDL LIBRARY
(See ./c1_iod.pro)
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 %W% %H% LASCO IDL LIBRARY
(See ./dmovie.pro)
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
(See ./dynimg.pro)
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
(See ./ephemeris.pro)
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
(See ./ephemerix.pro)
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
(See ./exsunc.pro)
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
(See ./fitshdr2struct.pro)
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
(See ./fparmodify.pro)
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
(See ./gammasca.pro)
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
(See ./gammascal.pro)
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
(See ./get_data.pro)
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 %W% %H% LASCO IDL LIBRARY
(See ./get_list.pro)
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 %W% %H% LASCO IDL LIBRARY
(See ./get_sun_cen.pro)
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 %W% %H% LASCO IDL LIBRARY
(See ./getsuncen.pro)
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
(See ./ghandle.pro)
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
(See ./h4s.pro)
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 :
(See ./headfits.pro)
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 :
(See ./headfitsl.pro)
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
(See ./hist_xy.pro)
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
(See ./imcalc.pro)
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
(See ./layout.pro)
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
(See ./ld_inst_def.pro)
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
(See ./load_message.pro)
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
(See ./make_mpeg.pro)
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
(See ./maske.pro)
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
(See ./mkdi_c1.pro)
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 %W% %H% LASCO IDL LIBRARY
(See ./mkquery.pro)
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
(See ./mk_image.pro)
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
(See ./mpeg_wid.pro)
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
(See ./pickfiles.pro)
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
(See ./plot_xy.pro)
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.
(See ./profile1.pro)
Project : Name : PROFILES Purpose : Interactively draw row or column profiles of an image in a : separate window. A new window is created and the mouse location in the original window is used to plot profiles in the new window. Pressing the left mouse button toggles between row and column profiles. The right mouse button exits. Category : Image analysis. Explanation : Syntax : PROFILES, Img [, SX = sx, SY = sy] Examples : Create and display an image and use the PROFILES routine on it. Create and display the image by entering: A = BYTSCL(DIST(256)) TV, A Run the PROFILES routine by entering: PROFILES, A The PROFILES window should appear. Move the cursor over the original image to see the profile at the cursor position. Press the left mouse button to toggle between row and column profiles. Press the right mouse button (with the cursor over the original image) to exit the routine. Inputs : Image: The variable that represents the image displayed in ;current window. This data need not be scaled into bytes. The profile graphs are made from this array. Opt. Inputs : Outputs : No explicit outputs OPT. OUTPUTS: Keywords : SX: Starting X position of the image in the window. If this keyword is omitted, 0 is assumed. SY: Starting Y position of the image in the window. If this keyword is omitted, 0 is assumed. WSIZE: The size of the PROFILES window as a fraction or multiple of 640 by 512. ORDER: Set this keyword param to 1 for images written top down or 0 for bottom up. Default is the current value of !ORDER. Common : None. Restrictions: None Side Effects: A new window is created and used for the profiles. When done, the new window is deleted. History : Nov 1988,DMS. Contact :
(See ./profiles.pro)
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
(See ./rd_asc.pro)
Project : Name : READFITS Purpose : Read a FITS file into IDL data and header variables. Category : Explanation : Syntax : Result = READFITS( 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 = READFITS( 'TEST.FITS', h, /NOSCALE) If the file contain a FITS extension, it could be read with IDL> tab = READFITS( 'TEST.FITS', htab, /EXTEN ) To read only rows 100-149 of the FITS extension, IDL> tab = READFITS( '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
(See ./readfits.pro)
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
(See ./readfitsl.pro)
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
(See ./read_img.pro)
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
(See ./gammasca.pro)
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
(See ./reconvert.pro)
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 %W% %H% LASCO IDL LIBRARY
(See ./reduce_img_hdr2.pro)
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
(See ./rescale.pro)
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
(See ./gammasca.pro)
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
(See ./scan4limb.pro)
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()
(See ./selectd.pro)
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
(See ./setup.pro)
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
(See ./shandle.pro)
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
(See ./sungrid.pro)
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 :
(See ./sun_ephem.pro)
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
(See ./textarray.pro)
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
(See ./tvscl_image.pro)
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
(See ./t_cartes.pro)
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
(See ./t_polar.pro)
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 :
(See ./undefine.pro)
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
(See ./var_in.pro)
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
(See ./wc2p.pro)
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
(See ./wcalcl.pro)
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
(See ./wcalcnew.pro)
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 :
(See ./wcancel.pro)
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
(See ./wcurrent.pro)
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
(See ./wcursor.pro)
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
(See ./wdef_load.pro)
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, 11-Feb-1997, B Podlipnik. Written Contact : BP, borut@lasco1.mpae.gwdg.de
(See ./wdir.pro)
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
(See ./wdmemory.pro)
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
(See ./wflimb.pro)
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
(See ./wheadinfo.pro)
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
(See ./whist.pro)
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
(See ./wic.pro)
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
(See ./wimg_info1.pro)
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
(See ./wimg_info2.pro)
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
(See ./wimg_info3.pro)
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
(See ./wimg_info4.pro)
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
(See ./winfo_activ.pro)
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
(See ./wlines.pro)
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 15Dec98, N Rich Changed default source to LZ_IMG Contact : BP, borut@lasco1.mpae.gwdg.de
(See ./wlister.pro)
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 Contact : BP, borut@lasco1.mpae.gwdg.de
(See ./wload.pro)
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
(See ./wloadc.pro)
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
(See ./wloadinfo.pro)
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
(See ./wloadinfo1.pro)
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
(See ./wmessage.pro)
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
(See ./wobsdate.pro)
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
(See ./wplot.pro)
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
(See ./wplot1.pro)
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
(See ./wprint.pro)
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
(See ./wrebin.pro)
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 ./write_disk_movie_test.pro)
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
(See ./write_last_c1.pro)
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
(See ./wrunmovie4.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 :
(See ./wr_beam.pro)
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 :
(See ./wr_beam1.pro)
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
(See ./wsave.pro)
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
(See ./wsave1.pro)
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
(See ./wsave2.pro)
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
(See ./wsave_ps.pro)
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 :
(See ./wsize.pro)
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
(See ./wsunprofile.pro)
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
(See ./wsw.pro)
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
(See ./wtime_height.pro)
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
(See ./wyes_no.pro)
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.
(See ./xloadctbp.pro)
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)
(See ./xvalidl.pro)
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
(See ./xvaredt.pro)
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
(See ./xy_bilin.pro)
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
(See ./yymmdd.pro)
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
(See ./zoom_it.pro)