X_SPECT_COM_SHARE $SSW/soho/sumer/idl/newtki/tki/xspect_com_share.pro
[Previous] [Next]
 PROJECT:
       SOHO - SUMER

 NAME:
       X_SPECT_COM_SHARE

 PURPOSE: 
       Common Variables as interface to XSPECT

 CATEGORY:
       SUMER Util
 
 EXPLANATION:
       
 SYNTAX: 
       x_spect_com_share, 

 EXAMPLES:
       
 INPUTS:
       None.

 OPTIONAL INPUTS: 
       None.

 OUTPUTS:
       None.

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS: 
       None.

 COMMON:
       None.

 RESTRICTIONS: 
       None.

 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, July 3, 1997, Dietmar Germerott, MAPE Lindau. Written

 CONTACT:
       Dietmar Germerott, MAPE Lindau (germerott@linmpi.mpg.de)


XCAMP $SSW/soho/gen/idl/plan/science/xcamp.pro
[Previous] [Next]
 Project     : SOHO - CDS

 Name        : XCAMP

 Purpose     : widget interface to campaign database

 Category    : operations, widgets

 Explanation :

 Syntax      : IDL> XCAMP

 Inputs      : None

 Opt. Inputs : None

 Outputs     : ID = selected campaign ID

 Opt. Outputs: None

 Keywords    : TSTART,TEND = start/end times to list
               GROUP = widget ID of any calling widget
               STATUS = 1/0 if selection was made/not made
               LAST = set to use last times saved in COMMON
               SELECT = permit a selection
               FORCE = force a selection
               NOWARN = turn of warning for multiple XCAMP copies

 CALLED BY:
	MK_CDS_PLAN, XCAT
 Restrictions: None.

 CALLS: ***
	ANYTIM2TAI, ANYTIM2UTC [1], ANYTIM2UTC [2], ARR2STR [1], Arr2Str [2], CLEAR_STRUCT
	COPY_STRUCT [1], COPY_STRUCT [2], COPY_STRUCT [3], CW_FIELD, DATATYPE [1]
	DATATYPE [2], DATATYPE [3], DPRINT, EXIST, FIND_CAMPAIGN, FREE_POINTER, FSTRING
	GET_CALLER, GET_CAMPAIGN, GET_HANDLER_ID, GET_POINTER, GET_UTC, HAVE_WIDGETS [1]
	HAVE_WIDGETS [2], MAKE_POINTER, MATCH_STRUCT, MK_DFONT, MK_TEMP_FILE, PICKFILE
	PICK_TIMES, REP_TAG_NAME, REP_TAG_VALUE, REVERSE, SELECT_WINDOWS, SET_POINTER
	STR2FILE, STR2LINES, STRPAD, TAG_EXIST [1], TAG_EXIST [2], TRIM, UNIQ [1], UNIQ [2]
	UNIQ [3], UPDATE_CAMPAIGN, UTC2TAI, WHICH_INST, XACK, XALIVE, XANSWER, XCAMP_EVENT
	XCAMP_LABEL, XCAMP_LIST, XCAMP_OPTIONS, XCAMP_OPTIONS_EVENT, XHIDE, XKILL, XLIST
	XMAIL, XMANAGER, XMANAGER_RESET, XMENU2, XPRINT [1], XPRINT [2], XPRINT [3]
	XPRINT [4], XPRINT [5], XREALIZE, XREGISTERED, XSHOW, XTEXT, XTEXT_RESET, XVALIDATE
 Side effects: None.

 History     : Version 1,  21-Sept-1996,  D.M. Zarro.  Written
               Version 2, October 16, 1996, Liyun Wang, NASA/GSFC
                  Reverse sorted campaign list 

 Contact     : DZARRO@SOLAR.STANFORD.EDU


XCAT $SSW/soho/cds/idl/util/ops/planning/xcat.pro
[Previous] [Next]
 Project     : SOHO - CDS

 Name        : XCAT

 Purpose     : widget interface to CDS AS-RUN catalog

 Category    : operations, widgets

 Explanation :

 Syntax      : IDL> XCAT

 Inputs      : None

 Opt. Inputs : TSTART,TEND = start/end times to list (any UT format)

 Outputs     : 

 Opt. Outputs: QL = CDS quicklook structure

 Keywords    : GROUP = widget ID of any calling widget
               TSTART,TEND = start/end times to list (any UT format)
               LAST = use last times specified by user

 CALLS: ***
	ANYTIM2TAI, ANYTIM2UTC [1], ANYTIM2UTC [2], ARR2STR [1], Arr2Str [2]
	BREAK_FILE [1], BREAK_FILE [2], BREAK_FILE [3], CDS_STACK, CHKLOG [1], CHKLOG [2]
	CONCAT_DIR [1], CONCAT_DIR [2], CONCAT_DIR [3], COPY_STRUCT [1], COPY_STRUCT [2]
	COPY_STRUCT [3], CW_BSELECTOR2, CW_FIELD, DATATYPE [1], DATATYPE [2], DATATYPE [3]
	DELETE_QLDS, DELVARX [1], DELVARX [2], DELVARX [3], DELVARX [4], DEVICE2, DPRINT
	EXIST, FIND_COMPRESSED, FIND_WITH_DEF [1], FIND_WITH_DEF [2], FIND_WITH_DEF [3]
	FIND_ZDBASE, FIX_ZDBASE, FREE_POINTER, FSTRING, GET_CALLER, GET_HANDLER_ID
	GET_POINTER, GET_STUDY_PAR, GET_TAG_VALUE, GET_UTC, HAVE_PROC, HAVE_WIDGETS [1]
	HAVE_WIDGETS [2], IDL_RELEASE, IMAGE_TOOL, LIST_EXPER, LIST_EXP_COMM, LIST_MAIN
	MAKE_POINTER, MATCH_STRUCT, MK_DFONT, MK_POINT_STC, MK_TEMP_FILE, PB0R, PICKFILE
	PICK_TIMES, PRIV_ZDBASE, READCDSFITS, REP_TAG_VALUE, REVERSE, RM_FILE, SEC2DHMS
	SELECT_WINDOWS, SET_CDS_SDB, SET_POINTER, STR2ARR [1], STR2ARR [2], STR2FILE
	STR2LINES, STRPAD, TAI2UTC, TRIM, TRIM2, UTC2TAI, VALID_QL, WHERE_VECTOR, WIDG_TYPE, X2GIF
	XACK, XALIVE, XANSWER, XCAMP, XCAT_BUTTONS, XCAT_CHECK, XCAT_CLEANUP, XCAT_COMMENT
	XCAT_COMMENT_EVENT, XCAT_COMMENT_LIST, XCAT_DSP, XCAT_EDIT, XCAT_ELIST, XCAT_EVENT
	XCAT_HELP, XCAT_INIT, XCAT_MLIST, XCAT_OPTIONS, XCAT_RASTER, XCAT_RELIST, XCAT_SEQ
	XCAT_VIEW, XCDS_SNAPSHOT, XHIDE, XHOUR, XINPUT, XKILL, XMANAGER, XMANAGER_RESET
	XMENU [1], XMENU [2], XPRINT [1], XPRINT [2], XPRINT [3], XPRINT [4], XPRINT [5]
	XREALIZE, XREGISTERED, XSHOW, XSTRUCT, XSTUDY, XTEXT, XTEXT_RESET, XVALIDATE
	break_file [4], concat_dir [4], delvarx [5], dsp_menu
 CALLED BY:
	MK_CDS_PLAN, dsp_menu
 Common      : XCAT - last saved AS-RUN listing

 Restrictions: None.

 Side effects: None.

 History     : Version 1,  2-Feb-1996,  D.M. Zarro.  Written
               Version 2, 16-Jun-1996, Zarro, added call to CDS_SNAPSHOT
		Version 3, 18-Jun-1996, William Thompson, GSFC
			Added XACK if CDS_SNAPSHOT returns an error.
		Version 4, 18-Jul-1996, William Thompson, GSFC
			Call XCDS_SNAPSHOT instead of CDS_SNAPSHOT.
		Version 5, 18-Aug-1997, William Thompson, GSFC
			Modified to allow 5 digit program numbers.
               Version 6, 22-Jan-1998, SVH Haugan, UiO
                       Added call to readcdsfits(/header) to test for
                       compressed fits files when appropriate.
               Version 7, 10-March-1998, Zarro, SAC/GSFC
                       Allowed repeat calls to XCDS_SNAPSHOT
               Version 8, 2-June-1998, Zarro, SAC/GSFC
                       Allowed searching on solar radius
               Version 9, 1-Sept-1999, Zarro, SM&A/GSFC
                       Added call to CDS_STACK to save QL structures
                       in a pointer stack
               Version 10, 7-Nov-1999, Zarro, SM&A/GSFC
                       Fixed IDL V5 bug when calling DSP_MENU
               Version 11, 13-Feb-2000, Zarro, (SM&A/GSFC)
                       Added check for SDB and clean-up
               Version 12, 23-Mar-2000, Zarro, (SM&A/GSFC)
                       Added /NO_CACHE
               Version 13, 19-Jan-2001, Zarro, (EITI/GSFC)
                       Fixed long integer overflow
               Version 14, 15-Jun-2001, Zarro, (EITI/GSFC)
                       Improved database environment variable handling
		Version 15, 30-May-2002, William Thompson, GSFC
			Don't pass null string for USE_DIR to FIND_COMPRESSED
               Version 16, 7-June-2002, Zarro (GSFC) - fixed USE_DIR
               Version 17, 23-Aug-2002, Zarro (LAC/GSFC) - changed TRIM to
                           faster, vectorized TRIM2
               Modified, 6-Sep-05, Zarro (L-3Com/GSFC) - added call to DEVICE2
               Modified, 17-Sept-05, Zarro (L-3Com/GSFC) - prefixed all
                            environment variables with $ signs.

 Contact     : DZARRO@SOLAR.STANFORD.EDU


XCDS_ANALYSIS $SSW/soho/cds/idl/util/fitting/xcds_analysis.pro
[Previous] [Next]
 Project     : SOHO - CDS     
                   
 Name        : XCDS_ANALYSIS
               
 Purpose     : Widget interface to do analyses of CDS data.
               
 Explanation : This program defines CDS Analysis Definition (CDS ADEF)
               structures.
      
               The program is a front-end to the routine MK_CDS_ANALYSIS(),
               but with a few added features to allow (semi-)automatic
               handling of cosmic rays, automatic naming of analysis files,
               and multi-window analysis.
               
               An ADEF structure may be applied to all data sets with the
               same raster id/variation, although a specific data set (QLDS)
               must be present to enable editing of the ADEF.
               
               Here is a short description of the various sections:
               
               ANALYSIS FILE NAMES & COSMIC RAY TREATMENT
               
               The "Pattern for analysis file names" defines how to infer a
               file name for storing an analysis, given the ADEF file
               name/path and a specific data set (raster). Push the button to
               edit, and to get a more detailed description.
               
               The rules for how to deal with cosmic rays function similarly
               to the analysis file name pattern - push the button to edit
               and to get more detailed information.
               
               DATA TREATMENT - DEBIAS/CALIBRATION
               
               The next section (with e.g., DEBIAS:ON etc.) deals with how
               the data from the QLDS is to be treated before extracting the
               data block for analysis. All of these switches are keywords to
               MK_CDS_ANALYSIS().
               
               WINDOW LIST
               
               The section with the "Add this window" button is where you
               determine which data windows to include in the analysis. Use
               the pulldown menu to select a window, and then press
               "Add....", and it will appear in the window list below.
               
               You may add the same window more than one time if you like.
               
               The windows will be sorted in ascending wavelength order.
               
               You may also choose to intepret the data in the window as a
               second-order line (dividing the wavelengths by two) by
               pressing the button under the heading "GR_ORDER".
               
               To select a subset of the whole data window, press the "Crop"
               button.  This will start a program called XCROP_CUBE that
               allows you to define which part of the data window is to be
               included in the analysis.
               
               If you would like to delete a window from the window list,
               guess what you should do...
               
               APPLY ANALYSIS DEFINITION
               
               To apply the analysis definition to the current QLDS, select
               "Apply analysis : Generate analysis and edit in XCFIT_BLOCK"
               
               If you would like to load an existing analysis matching this
               analysis definition, press "Load analysis". This may be done
               even if no QLDS was passed to the program.
               
 Use         : XCDS_ANALYSIS,ADEF,ANALYSIS,QLDS=QLDS
    
 Inputs      : Both of these are input/output:

               ADEF : Analysis definition structure

               ANALYSIS : CFIT analysis structure generated from the analysis
                          definition.

 Opt. Inputs : QLDS : QuickLook Data Structure. If the qlds is managed by the
                      calling widget program, XCDS_ANALYSIS will fall
                      through, expecting that the QLDS will continue to be
                      available through the Quick Look memory management
                      system. 
               
 Outputs     : ADEF, ANALYSIS
               
 Opt. Outputs: None
               
 Keywords    : None

 Calls       : ***
	APPLY_CDS_ADEF, CDS_ADEF_PARSEFILE, CWQ_WINSEL [1], CW_CHECKBOX, CW_ENTERB
	CW_FLIPSWITCH, DATATYPE [1], DATATYPE [2], DATATYPE [3], DEFAULT, DELETE_ANALYSIS
	EXIST, GT_SPECTRUM, GT_WINDATA, HANDLE_KILLER_HOOKUP, MK_ANALYSIS, MK_CDS_ADEF_STC
	MK_CDS_ADEF_WIN_STC, QLDS_CHECKIN, QLDS_FETCH, QLDS_MANAGED, QLDS_REPORT, QLMGR
	RESTORE_ANALYSIS, RESTORE_CDS_ADEF, REVERSE, SAVE_CDS_ADEF, SINCE_VERSION [1]
	SINCE_VERSION [2], STR_SEP, TRIM, XACK, XALIVE, XCDS_ANALYSIS_ADDWIN
	XCDS_ANALYSIS_BUILDWIDGET, XCDS_ANALYSIS_CHECK_CROP, XCDS_ANALYSIS_CLEAN
	XCDS_ANALYSIS_CROPWIN, XCDS_ANALYSIS_CROP_OK, XCDS_ANALYSIS_EVENT
	XCDS_ANALYSIS_GENERATE, XCDS_ANALYSIS_HELP, XCDS_ANALYSIS_INSTRUCT
	XCDS_ANALYSIS_LOAD_ANALYSIS, XCDS_ANALYSIS_SHOW_FILENAMES
	XCDS_ANALYSIS_SHOW_STATUS, XCDS_ANALYSIS_SHOW_WINDOWS, XCDS_ANALYSIS_SORTWIN
	XCFIT_BLOCK, XCROP_CUBE, XMANAGER, XREALIZE, XTEXT, XUPDATE, cwq_winsel [2]
 CALLED BY:
	dsp_menu
 Common      : None
               
 Restrictions: Uses the quick look data storage system, see e.g.,
               QLDS_REPORT.
               
 Side effects: ...
               
 Category    : QuickLook, Analysis
               
 Prev. Hist. : None

 Written     : SVH Haugan, UiO, 25 September -- 17 October 1997
               
 Modified    : Version 2, SVHH, 15 December 1997
                       Circumventing IDL v 5 widget problems...

 Version     : 2, 15 December 1997


XCDS_BOOK $SSW/soho/cds/idl/util/ops/planning/xcds_book.pro
[Previous] [Next]
 Project     : SOHO - CDS

 Name        : XCDS_BOOK

 Purpose     : add or return CDS study from bookmark save file

 Category    : planning

 Explanation :

 Syntax      : IDL> xcds_book,book_study

 CALLED BY:
	MK_CDS_PLAN, XSTUDY
 Examples    :

 Inputs      : STUDY = study to add

 Opt. Inputs : None

 Outputs     : STUDY = selected study

 Opt. Outputs: None

 Keywords    : ERR   = error messages
               ADD   = set to add study to bookmark list

 CALLS: ***
	CONCAT_DIR [1], CONCAT_DIR [2], CONCAT_DIR [3], CONCAT_STRUCT, COPY_STRUCT [1]
	COPY_STRUCT [2], COPY_STRUCT [3], DATATYPE [1], DATATYPE [2], DATATYPE [3]
	DELVARX [1], DELVARX [2], DELVARX [3], DELVARX [4], EXIST, GET_CALLER, GET_CDS_STUDY
	LOC_FILE [1], LOC_FILE [2], LOC_FILE [3], REP_TAG_NAME, RM_FILE, TRIM, XACK, XKILL
	XLIST, concat_dir [4], delvarx [5], restgen [1], restgen [2], savegen [1]
	savegen [2]
 Common      : None

 Restrictions: None

 Side effects: None

 History     : Version 1,  17-Aug-1996,  D M Zarro.  Written

 Contact     : DZARRO@SOLAR.STANFORD.EDU


XCDS_COSMIC $SSW/soho/cds/idl/util/misc/xcds_cosmic.pro
[Previous] [Next]
 Project     : SOHO - CDS     
                   
 Name        : XCDS_COSMIC
               
 Purpose     : Cosmic ray removal - automatic and manual
               
 Explanation : This is a utility for cosmic ray removal from CDS NIS data.

               The recommended use is to:

               Read the data file, start xcds_cosmic - this will atomatically
               debias the data if it's not already done, and make a "working
               copy" of it as well.

               AUTOMATIC DETECTION
               
               Select one of the automatic methods for CR removal, and press
               the button labeled "Execute" to apply that method to the
               working copy. This will flag all suspected cosmic ray pixels
               as MISSING.

               MANUAL VERIFICATION
               
               To verify manually that all cosmic rays have been detected,
               use the Manual inspection, on all the windows ("Inspect all
               windows") or on single windows ("Inspect current window" - the
               current window may be selected from the pulldown menu labeled
               "Window: ...").

               The manual inspection (XCR_REMOVE) allows you to browse back
               and forth between the exposures of one line window at a time,
               viewing both the original data and the working copy. By
               zooming into the image the program switches into a "FLIP" mode
               (both the Mode status button and the mouse cursor will be
               changed to reflect this) and you may flip the status
               (MISSING/not MISSING) of individual pixels.

               Note that this allows un-flagging pixels marked MISSING by the
               automatic routines.

               SAVING/RETRIEVING A LIST OF FLAGGED PIXELS
               
               When you are satisfied with the flagging of cosmic ray pixels,
               you may save a list of the flagged pixels to a file by
               pressing the button labeled "Save list of flagged pixels".

               If you have set the environment variable CDS_ANALYSIS to point
               at at directory, this will be used as the default path to save
               the list of flagged pixels.

               For later sessions you may simply use the corresponding button
               "Read list of flagged pixels" to avoid the time-consuming task
               of manually inspecting all exposures.

               Do NOT fill in the bad pixels (see below) before saving the
               list of bad pixels (since the identity of the filled-in pixels
               will be lost when they are filled in). You may, however,
               save a list of bad pixels, fill them in, flag some more pixels
               as missing and then re-apply the first list of bad pixels.

               FILLING IN BAD PIXELS
               
               With all the cosmic ray pixels flagged as MISSING, you have
               the option of filling them in with data estimated from the
               local median around the missing pixels. If you are going to
               use the data for qualitative work, such as viewing images to
               identify features etc, it is OK to fill in the cosmic ray
               pixels. If you are doing line fits to the data, you ought to
               leave the cosmic ray pixels flagged as MISSING and simply
               leave those pixels out when doing the fitting.

               Selecting "Fill CR pixels only" will fill in only those pixels
               identified as cosmic rays *during this session* - pixels
               flagged as missing before starting XCDS_COSMIC will be left
               untouched.
               
               If you have small data gaps in your data set, you may also
               want to fill those as well, by selecting "Fill all MISSING
               pixels". If there are large data gaps, however, this is
               definitely not recommended.

               FINISHING UP

               When you exit this program, you may choose to discard any
               changes you have made to the working copy of your data, or you
               may replace the data with the working copy.

 Use         : XCDS_COSMIC,QLDS
    
 Inputs      : QLDS : Quick look data structure. Data should not be
                      flatfielded or calibrated, but they may be
                      debiased. Debiasing will be applied in case this has
                      not been done.
               
 Opt. Inputs : None.
               
 Outputs     : None.
               
 Opt. Outputs: None.
               
 Keywords    : WINDOW_IX,
 
               EXPOSURE_IX : Window/exposure index - set these to cause
                             automatic pop-up of XCR_REMOVE for that window
                             and exposure.
 
               FILE_MISS   : Default file for the list of flagged pixels.
                              

 Calls       : ***
	BREAK_FILE [1], BREAK_FILE [2], BREAK_FILE [3], CDS_CLEAN, CDS_CLEAN_EXP
	CDS_FILL_MISSING, CDS_NEW_SPIKE, CDS_READ_MISSING, CDS_SAVE_MISSING, CHK_DIR [1]
	CHK_DIR [2], CONCAT_DIR [1], CONCAT_DIR [2], CONCAT_DIR [3], COPY_QLDS
	CWQ_WINSEL [1], CW_PSELECT, DEFAULT, DELETE_QLDS, DSPEXP, FIND_WITH_DEF [1]
	FIND_WITH_DEF [2], FIND_WITH_DEF [3], GT_DIMENSION, GT_WINDATA, PARCHECK, PICKFILE
	QLMGR, SINCE_VERSION [1], SINCE_VERSION [2], ST_WINDATA, TEST_OPEN, TRIM, TYP
	VDS_DEBIAS, XACK, XCDS_COSMIC_EVENT, XCDS_COSMIC_HELP, XCDS_COSMIC_INSPECT
	XCR_REMOVE, XMANAGER, XMESSAGE, XTEXT, break_file [4], concat_dir [4]
	cwq_winsel [2]
 CALLED BY:
	dsp_menu
 Common      : None.
               
 Restrictions: Must have NIS unbinned data.
               
 Side effects: None.
               
 Category    : ?
               
 Prev. Hist. : None.

 Written     : S. V. H. Haugan, UiO, 6 January 1997
               
 Modified    : Version 2, SVHH, 22 January 1997
                       Added /NO_NEIGHBOUR choice for CDS_CLEAN_EXP
               Version 3, SVHH, 31 January 1997
                       Added use of CDS_ANALYSIS env. var. when present.
                       Fixed bug about adding directory to file name.
               Version 4, SVHH, 15 September 1997
                       Various small changes.
               Version 5, V. Andretta (NASA/GSFC), 19 March 1998
                       Added keyword FILE_MISS; if CDS_ANALYSIS is not set, 
                       uses current directory. 

               Version 6, Giulio Del Zanna, DAMTP, 1-Jun-2001
                       Added two extra options to the CDS_CLEAN_EXP 
                       call, that is the possibility to set the parameter
                       (keyword) max_factor_hi=2.2 or 2.5. 
                       By default, max_factor_hi=1.7. The new options are
                       better when cleaning data with strong brightenings in
                       the exposures.
                       ALso, added a button to call DSPEXP to inspect groups of
                       windows, at the same time. This considerably speeds up
                       the process of visually inspect a large number of
                       exposures and NIS extraction windows at the same time.
                       Once the exposures with problems are found, the standard
                       widget can then be used to manually correct the cosmic
                       ray corrections applied to the data.

               Version 7, Peter Young, RAL, 23-Sep-2005
                       substituted cds_new_spike for cds_clean_spike.


 Version     : 7, 23-Sep-2005


XCDS_SNAPSHOT $SSW/soho/cds/idl/util/display/xcds_snapshot.pro
[Previous] [Next]
 Project     :	SOHO - CDS

 Name        :	XCDS_SNAPSHOT

 Purpose     :	Widget interface to CDS_SNAPSHOT

 Category    :	CDS, Class3, Quicklook

 Explanation :	Puts up a small widget which allows one to control how
		CDS_SNAPSHOT is run.  Also, one can redirect the output to a
		PostScript file or printer.

 Syntax      :	XCDS_SNAPSHOT, FILENAME
		XCDS_SNAPSHOT, DATA

 CALLED BY:
	XCAT, dsp_menu
 Examples    :	XCDS_SNAPSHOT, 's3042r00.fits'

		A = READCDSFITS('s3042r00.fits')
		XCDS_SNAPSHOT, A

 Inputs      :	FILENAME = Name of CDS FITS file to read in.

 Opt. Inputs :	DATA	 = A quicklook data structure as returned by
			   READCDSFITS.

 Outputs     :	None.

 Opt. Outputs:	None.

 Keywords    :	REVERSE = If set, then plot is done in inverse video.  In other
			  words, white areas on the screen will appear dark,
			  and visa versa.  This saves toner on greyscale
			  printers.

		NOCLEAN = If set, then CDS_CLEAN_IMAGE is not called.

		WINDOWS = An array of windows to display.  The windows can be
			  passed as either the NUMBERS of the data windows
			  (NOTE: numbering from 0...N-1) or as text with the
			  LABELS of the desired spectral windows.  The windows
			  will be displayed in the order given by the WINDOWS
			  array, unless the WAVESORT keyword is passed.

		WAVESORT = If set, then the windows are displayed in wavelength
			   order.  (Note that second order lines will be
			   displayed according to their first order
			   equivalent.)

		QUASI_FIT= If set, then the routine CDS_QUASI_FIT is called to
			   extract the images.  See the documentation on that
			   routine for more information.

		SPECTRA	 = If set, then spectra are shown instead of images.
			   For some data sets, spectra are shown by default.

		LOG	 = If set, then spectra are plotted logarithmically.
			   Only used for line plots.

		MOSAIC	 = If set, then a mosaic is formed out of the
			   individual exposures.  This option is only used for
			   rasters made with slit #6, and is otherwise ignored.

		FRACTION = Fraction to pass to SIGRANGE function.  The default
			   is 0.99.

		OWN_WINDOW = If set, then XCDS_SNAPSHOT will always display
			     data in its own window, rather than the default
			     graphics window.

		ERRMSG = If defined and passed, then any error messages will be
			 returned to the user in this parameter rather than
			 depending on the MESSAGE routine in IDL.  If no errors
			 are encountered, then a null string is returned.  In
			 order to use this feature, ERRMSG must be defined
			 first, e.g.

				ERRMSG = ''
				XCDS_SNAPSHOT, INPUT, ERRMSG=ERRMSG
				IF ERRMSG NE '' THEN ...

		GROUP	= The widget ID of the widget that calls XCDS_SNAPSHOT.
			  When this ID is specified, a death of the caller
			  results in a death of XCDS_SNAPSHOT.

		In addition, XCDS_SNAPSHOT supports any keyword used by the
		XMANAGER routine, e.g. /MODAL, through the _EXTRA mechanism.

 Calls       : ***
	CDS_SNAPSHOT, CW_BGROUP, CW_FIELD, DATATYPE [1], DATATYPE [2], DATATYPE [3]
	FORM_FILENAME [1], FORM_FILENAME [2], POPUP_MSG, PS [1], PS [2], PSCLOSE [1]
	PSCLOSE [2], PSPLOT [1], PSPLOT [2], READCDSFITS, SETWINDOW [1], SETWINDOW [2], XACK
	XCDS_SNAPSHOT_EVENT, XCDS_SNAP_SEL, XCDS_SNAP_SEL_EVENT, XLOADCT [1]
	XLOADCT [2], XLOADCT [3], XMANAGER, XPS_SETUP, XREGISTERED
 Common      :	Uses the internal common block XCDS_SNAPSHOT.

 Restrictions:	Can only be used for rasters which build up images via mirror
		(and slit for GIS) movements.

 Side effects:	None.

 Prev. Hist. :	None.

 History     :	Version 1, 18-Jul-1996, William Thompson, GSFC
		Version 2, 21-Aug-1996, William Thompson, GSFC
			Added keywords SPECTRA and WO_CR
		Version 3, 28-Oct-1996, William Thompson, GSFC
			Added keyword FRACTION.
		Version 4, 22-Nov-1996, William Thompson, GSFC
			Make widget reflect keywords.
		Version 5, 14-Jan-1997, William Thompson, GSFC
			Added keyword QUASI_FIT
		Version 6, 21-Mar-1997, William Thompson, GSFC
			Added keyword OWN_WINDOW
		Version 7, 19-Mar-1999, William Thompson, GSFC
			Added keyword /LOG.
		Version 8, 02-Nov-1999, William Thompson, GSFC
			Added keyword /MOSAIC.
			Removed extremely slow WO_CR option.
			Make window numbering from 0,...,N-1
		Version 9, 24-Jul-2002, William Thompson, GSFC
			Create windows with RETAIN=2

 Contact     :	WTHOMPSON


xcheckip $SSW/soho/mdi/idl/egse/xcheckip.pro
[Previous] [Next]
NAME:
	xcheckip
PURPOSE:
	To check the IP processing of data products
SAMPLE CALLING SEQUENCE:
	xcheckip
	xcheckip, '/md60/log/sci160k/950118_232658'
	xcheckip, '950118_232658,950119_010819,950119_013006,950124_002715', indir='/md60/log/sci160k', /runall
METHOD:
	1. Telemeter the raw image down in 160K line, manufacture
	   the new IP data product, compare it to the data product
	   made and telemetered down in the 160K line.
	2. Same as above, but the IP data product is telemetered
	   down in the 5K line.
 CALLS: ***
	ARR2STR [1], Arr2Str [2], BREAK_FILE [1], BREAK_FILE [2], BREAK_FILE [3]
	CHECK1TEST, CHECKCROP, CHECKIP_AVAIL, CHKALIGN, CHKRBLR, CHKRWIMG, CHKTWAVG, CHKVLDC
	CONCAT_DIR [1], CONCAT_DIR [2], CONCAT_DIR [3], EVENT_NAME, FILE_EXIST [2]
	GET_WVALUE, MAKECROP, STR2ARR [1], STR2ARR [2], UNIQ [1], UNIQ [2], UNIQ [3], WDEF [1]
	WDEF [2], XCHECKIP_EVENT, XMANAGER, XMENU [1], XMENU [2], XMENU_SEL [1]
	XMENU_SEL [2], break_file [4], chkawimg, chkffscl, chkvwimg, concat_dir [4]
	file_exist [1], file_exist [3], file_list [1], file_list [2], get_logenv [1]
	get_logenv [2], get_xfont [1], get_xfont [2], input [1], input [2], list_tfi
	mapx [1], mapx [2], prstr [1], prstr [2], rd_tfile [1], rd_tfile [2], read_mdi
	tbeep [1], tbeep [2], tbeep [3], where_arr [1], where_arr [2]
HISTORY:
	Written 10-Apr-95 by M.Morrison
	11-Apr-95 (MDM) - Modified how to recognize test classes
			- Many changes/additions
	 1-May-95 (MDM) - Modified to use GET_XFONT rather than DEF_FONT


XCLONE_PLAN $SSW/soho/gen/idl/plan/science/xclone_plan.pro
[Previous] [Next]
 PROJECT:
       SOHO - CDS/SUMER

 NAME:
       XCLONE_PLAN 

 PURPOSE:
       Widget program for CLONE_PLAN.

 EXPLANATION:

 CALLING SEQUENCE:
       xclone_plan  [,date=date]

 INPUTS:
       None.

 OPTIONAL INPUTS:
       DATE - Date/Time in any CDS format, the default date for which
              a cloned plan is made

 OUTPUTS:
       None.

 OPTIONAL OUTPUTS:
       STATUS - A structure that has the following tags:
                STATUS  - 1 for success, 0 for failure
                CLONED  - A string scalar or vector indicating type
                          of plans being cloned
                CLONE_ERR - A string scalar or vector, error messages
                            passed back from CLONE_PLAN

 KEYWORD PARAMETERS:
       ERRMSG    - Error message returned
       GROUP     - widget id of calling widget program
       MODAL     - set freeze calling program
       SOHO_SCI  - Clone SOHO wide Science plans
       DEF_CLONE - Default plan type to be cloned

 CALLS: ***
	ANYTIM2UTC [1], ANYTIM2UTC [2], CW_FIELD, DATATYPE [1], DATATYPE [2], DATATYPE [3]
	FREE_POINTER, GET_POINTER, GET_SOHO_INST, GET_UTC, GREP, HAVE_WIDGETS [1]
	HAVE_WIDGETS [2], MAKE_POINTER, MK_DFONT, MK_PLAN_PRIV, NEXTDAY, REP_TAG_VALUE
	SET_POINTER, WHICH_INST, XACK, XALIVE, XANSWER, XCLONE_PLAN_EVENT, XKILL, XMANAGER
	XMANAGER_RESET, XMENU [1], XMENU [2], XREALIZE, XREGISTERED, XSHOW
 CALLED BY:
	MK_CDS_PLAN, MK_SOHO
 COMMON BLOCKS:
       None.

 RESTRICTIONS:
       None.

 SIDE EFFECTS:
       Plan entries in database may be modified.

 CATEGORY:
       Planning, widgets

 PREVIOUS HISTORY:
       Written May 2, 1995, Liyun Wang, GSFC/ARC

 MODIFICATION HISTORY:
       Version 1, created, Liyun Wang, GSFC/ARC, May 2, 1995
       Version 2, Liyun Wang, GSFC/ARC, May 11, 1995
          Added keyword ERRMSG and STATUS
       Version 3, Liyun Wang, GSFC/ARC, June 28, 1995
          Added privilege check
       Version 4, August 30, 1995, Liyun Wang, GSFC/ARC
          Added SOHO_SCI keyword for cloning SOHO wide SCI plans
          Added DEF_CLONE keyword
          Added a button to clone plans between two dates
          Took away FONT keyword

 VERSION:
       Version 4, August 30, 1995


XCME_MES $SSW/soho/lasco/idl/cme/xcme_mes.pro
[Previous] [Next]
 NAME:
	XCME_MES

 PURPOSE:
	This procedure is used to display CME measurements 

 CATEGORY:
	CME

 CALLING SEQUENCE:
	XCME_MES

 INPUTS:

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

 OUTPUTS:

 OPTIONAL OUTPUT PARAMETERS:

 CALLS: ***
	DISPLAY_TIME, PICKFILE, READ_HT, STR2UTC [1], STR2UTC [2], STR2UTC [3], STR_SEP
	TAI2UTC, UTC2STR, UTC2TAI, XMANAGER, XREGISTERED
 COMMON BLOCKS:
	com_xcme_mes

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

 RESTRICTIONS:

 PROCEDURE:

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

 @(#)xcme_mes.pro	1.2 03/03/98 :NRL Solar Physics


XCOLORS [4] $SSW/soho/lasco/idl/dfanning/xcolors.pro
[Previous] [Next]
 NAME:
       XCOLORS

 PURPOSE:

       The purpose of this routine is to interactively change color tables
       in a manner similar to XLOADCT. No common blocks are used so
       multiple copies of XCOLORS can be on the display at the same
       time (if each has a different TITLE). XCOLORS has the ability
       to notify a widget event handler, an object method, or an IDL
       procedure if and when a new color table has been loaded. The
       event handler, object method, or IDL procedure is then responsibe
       for updating the program's display on 16- or 24-bit display systems.

 AUTHOR:

       FANNING SOFTWARE CONSULTING
       David Fanning, Ph.D.
       1645 Sheely Drive
       Fort Collins, CO 80526 USA
       Phone: 970-221-0438
       E-mail: davidf@dfanning.com
       Coyote's Guide to IDL Programming: http://www.dfanning.com

 CATEGORY:

       Widgets, Object, Command line.

 CALLING SEQUENCE:

       XCOLORS

 INPUTS:

       None.

 KEYWORD PARAMETERS:

       BLOCK: If this keyword is set, the program will try to block the
          IDL command line. Note that this is only possible if no other
          widget program is currently blocking the IDL command line. It
          is much more reliable to make XCOLORS a modal widget (see the MODAL
          keyword), although this can generally only be done when XCOLORS
          is called from another widget program.

       BOTTOM: The lowest color index of the colors to be changed.

       COLORINFO: This output keyword will return either a pointer to
          a color information structure (if the program is called in
          a non-modal fashion) or a color information structure (if the program
          is called in modal or blocking fashion). The color information
          structure is an anonymous structure defined like this:

             struct = { R: BytArr(!D.Table_Size), $ ; The current R color vector.
                        G: BytArr(!D.Table_Size), $ ; The current G color vector.
                        B: BytArr(!D.Table_Size), $ ; The current B color vector.
                        NAME: "", $                 ; The name of the current color table.
                        INDEX: 0 }                  ; The index number of the current color table.

          If a pointer to the structure is obtained, you will be responsible
          for freeing it to prevent memory leakage:

             XColors, ColorInfo=colorInfoPtr
             Print, "Color Table Name: ", (*colorInfoPtr).Name
             Ptr_Free, colorInfoPtr

          Note that that Name field will be "Unknown" and the Index field will
          be -1 until a color table is actually selected by the user. You are
          responsible for checking this value before you use it.

          When called in modal or blocking fashion, you don't have to worry about freeing
          the pointer, since no pointer is involved:

             XColors, /Block, ColorInfo=colorInfoData
             Help, colorInfoData, /Structure
             Print, "Color Table Name: ", colorInfoData.Name

       DATA: This keyword can be set to any valid IDL variable. If
          the variable is defined, the specified object method or notify
          procedure will be passed this variable via a DATA keyword. This
          keyword is defined primarily so that Notify Procedures are compatible
          with the XLOADCT way of passing data. If is not strictly required,
          since the _EXTRA keyword inheritance mechanism will allow passing
          of *any* keyword parameter defined for the object or procedure that is
          to be notified.

       DRAG: Set this keyword if you want colors loaded as you drag
          the sliders. Default is to update colors only when you release
          the sliders.

       _EXTRA: This keyword inheritance mechanism will pick up and
          pass along to any method or procedure to be notified and keywords
          that are defined for that procedure. Note that you should be sure
          that keywords are spelled correctly. Any mis-spelled keyword will
          be ignored.

       FILE: A string variable pointing to a file that holds the
          color tables to load. The normal colors1.tbl file is used by default.

       GROUP_LEADER: The group leader for this program. When the group
          leader is destroyed, this program will be destroyed.

       MODAL: Set this keyword (along with the GROUP_LEADER keyword) to
          make the XCOLORS dialog a modal widget dialog. Note that NO
          other events can occur until the XCOLORS program is destroyed
          when in modal mode.

       NCOLORS: This is the number of colors to load when a color table
          is selected.

       NOTIFYID: A 2-column by n-row array that contains the IDs of widgets
          that should be notified when XCOLORS loads a color table. The first
          column of the array is the widgets that should be notified. The
          second column contains IDs of widgets that are at the top of the
          hierarchy in which the corresponding widgets in the first column
          are located. (The purpose of the top widget IDs is to make it
          possible for the widget in the first column to get the "info"
          structure of the widget program.) An XCOLORS_LOAD event will be
          sent to the widget identified in the first column. The event
          structure is defined like this:

          event = {XCOLORS_LOAD, ID:0L, TOP:0L, HANDLER:0L, $
             R:BytArr(!D.N_COLORS < 256), G:BytArr(!D.N_COLORS < 256), $
             B:BytArr(!D.N_COLORS < 256), INDEX:0, NAME:""}

          The ID field will be filled out with NOTIFYID[0, n] and the TOP
          field will be filled out with NOTIFYID[1, n]. The R, G, and B
          fields will have the current color table vectors, obtained by
          exectuing the command TVLCT, r, g, b, /Get. The INDEX field will
          have the index number of the just-loaded color table. The name
          field will have the name of the currently loaded color table.

          Note that XCOLORS can't initially tell *which* color table is
          loaded, since it just uses whatever colors are available when it
          is called. Thus, it stores a -1 in the INDEX field to indicate
          this "default" value. Programs that rely on the INDEX field of
          the event structure should normally do nothing if the value is
          set to -1. This value is also set to -1 if the user hits the
          CANCEL button. (Note the NAME field will initially be "Unknown").

          Typically the XCOLORS button will be defined like this:

             xcolorsID = Widget_Button(parentID, Value='Load New Color Table...', $
                Event_Pro='Program_Change_Colors_Event')

          The event handler will be written something like this:

             PRO Program_Change_Colors_Event, event

                ; Handles color table loading events. Allows colors be to changed.

             Widget_Control, event.top, Get_UValue=info, /No_Copy
             thisEvent = Tag_Names(event, /Structure_Name)
             CASE thisEvent OF

                'WIDGET_BUTTON': BEGIN

                     ; Color table tool.

                   XColors, NColors=info.ncolors, Bottom=info.bottom, $
                      Group_Leader=event.top, NotifyID=[event.id, event.top]
                   ENDCASE

                'XCOLORS_LOAD': BEGIN

                     ; Update the display for 24-bit displays.

                   Device, Get_Visual_Depth=thisDepth
                   IF thisDepth GT 8 THEN BEGIN
                   WSet, info.wid

                    ...Whatever display commands are required go here. For example...

                    TV, info.image

                 ENDIF
                 ENDCASE

              ENDCASE

              Widget_Control, event.top, Set_UValue=info, /No_Copy
              END

       NOTIFYOBJ: A vector of structures (or a single structure), with
          each element of the vector defined as follows:

             struct = {XCOLORS_NOTIFYOBJ, object:Obj_New(), method:''}

          where the Object field is an object reference, and the Method field
          is the name of the object method that should be called when XCOLORS
          loads its color tables.

             ainfo = {XCOLORS_NOTIFYOBJ, a, 'Draw'}
             binfo = {XCOLORS_NOTIFYOBJ, b, 'Display'}
             XColors, NotifyObj=[ainfo, binfo]

          Note that the XColors program must be compiled before these structures
          are used. Alternatively, you can put this program, named
          "xcolors_notifyobj__define.pro" (*three* underscore characters in this
          name!) in your PATH:

             PRO XCOLORS_NOTIFYOBJ__DEFINE
              struct = {XCOLORS_NOTIFYOBJ, OBJECT:Obj_New(), METHOD:''}
             END

          Or, you can simply define this structure as it is shown here in your code.

          "Extra" keywords added to the XCOLORS call are passed along to
          the object method, which makes this an alternative way to get information
          to your methods. If you expect such keywords, your methods should be defined
          with an _Extra keyword.

       NOTIFYPRO: The name of a procedure to notify or call when the color
          tables are loaded. If the DATA keyword is also defined, it will
          be passed to this program via an DATA keyword. But note that *any*
          keyword appropriate for the procedure can be used in the call to
          XCOLORS. For example, here is a procedure that re-displays and image
          in the current graphics window:

             PRO REFRESH_IMAGE, Image=image, _Extra=extra, WID=wid
             IF N_Elements(wid) NE 0 THEN WSet, wid
             TVIMAGE, image, _Extra=extra
             END

          This program can be invoked with this series of commands:

             IDL> Window, /Free
             IDL> fTVImage, image, Position=[0.2, 0.2, 0.8, 0.8]
             IDL> XColors, NotifyPro='Refresh_Image', Image=image, WID=!D.Window

          Note that "extra" keywords added to the XCOLORS call are passed along to
          your procedure, which makes this an alternative way to get information
          to your procedure. If you expect such keywords, your procedure should
          be defined with an _Extra keyword as illustrated above.

       TITLE: This is the window title. It is "Load Color Tables" by
          default. The program is registered with the name 'XCOLORS:' plus
          the TITLE string. The "register name" is checked before the widgets
          are defined. If a program with that name has already been registered
          you cannot register another with that name. This means that you can
          have several versions of XCOLORS open simultaneously as long as each
          has a unique title or name. For example, like this:

            IDL> XColors, NColors=100, Bottom=0, Title='First 100 Colors'
            IDL> XColors, NColors=100, Bottom=100, Title='Second 100 Colors'

       XOFFSET: This is the X offset of the program on the display. The
          program will be placed approximately in the middle of the display
          by default.

       YOFFSET: This is the Y offset of the program on the display. The
          program will be placed approximately in the middle of the display
          by default.

 CALLS: ***
	CONGRID [1], CONGRID [2], CONGRID [3], FILEPATH, LOADCT, REVERSE
	XCOLORS_BOTTOM_SLIDER, XCOLORS_CANCEL, XCOLORS_CLEANUP, XCOLORS_COLORTABLE
	XCOLORS_DISMISS, XCOLORS_GAMMA_SLIDER, XCOLORS_NOTIFYOBJ__DEFINE
	XCOLORS_PROTECT_COLORS, XCOLORS_SET, XCOLORS_TOP_SLIDER, XMANAGER, XREGISTERED
 CALLED BY:
	CIndex, EIS_IMAGE_TOOL_EVENT [1], EIS_IMAGE_TOOL_EVENT [2], FSC_SURFACE
	FSC_WINDOW, XDETECTOR [1], XIMOVIE [1], XIMOVIE [2], XIMOVIE [4], XMAP [1], XMAP [2]
	ZIMAGE, xwhisker [1], xwhisker [2]
 COMMON BLOCKS:

       None.

 SIDE EFFECTS:

       Colors are changed. Events are sent to widgets if the NOTIFYID
       keyword is used. Object methods are called if the NOTIFYOBJ keyword
       is used. This program is a non-blocking widget.

 RESTRICTIONS:

       None.

 EXAMPLE:

       To load a color table into 100 colors, starting at color index
       50 and send an event to the widget identified at info.drawID
       in the widget heirarchy of the top-level base event.top, type:

       XCOLORS, NCOLORS=100, BOTTOM=50, NOTIFYID=[info.drawID, event.top]

 MODIFICATION HISTORY:
       Written by:     David Fanning, 15 April 97. Extensive modification
         of an older XCOLORS program with excellent suggestions for
         improvement by Liam Gumley. Now works on 8-bit and 24-bit
         systems. Subroutines renamed to avoid ambiguity. Cancel
         button restores original color table.
       23 April 1997, added color protection for the program. DWF
       24 April 1997, fixed a window initialization bug. DWF
       18 June 1997, fixed a bug with the color protection handler. DWF
       18 June 1997, Turned tracking on for draw widget to fix a bug
         in TLB Tracking Events for WindowsNT machines in IDL 5.0. DWF
       20 Oct 1997, Changed GROUP keyword to GROUP_LEADER. DWF
       19 Dec 1997, Fixed bug with TOP/BOTTOM reversals and CANCEL. DWF.
        9 Jun 1998, Fixed bug when using BOTTOM keyword on 24-bit devices. DWF
        9 Jun 1998, Added Device, Decomposed=0 for TrueColor visual classes. DWF
        9 Jun 1998, Removed all IDL 4 compatibility.
       21 Oct 1998, Fixed problem with gamma not being reset on CANCEL. DWF
        5 Nov 1998. Added the NotifyObj keyword, so that XCOLORS would work
         interactively with objects. DWF.
        9 Nov 1998. Made slider reporting only at the end of the drag. If you
         want continuous updating, set the DRAG keyword. DWF.
        9 Nov 1998. Fixed problem with TOP and BOTTOM sliders not being reset
         on CANCEL. DWF.
       10 Nov 1998. Fixed fixes. Sigh... DWF.
        5 Dec 1998. Added INDEX field to the XCOLORS_LOAD event structure. This
         field holds the current color table index number. DWF.
        5 Dec 1998. Modified the way the colorbar image was created. Results in
         greatly improved display for low number of colors. DWF.
        6 Dec 1998. Added the ability to notify an unlimited number of objects. DWF.
       12 Dec 1998. Removed obsolete Just_Reg keyword and improved documetation. DWF.
       30 Dec 1998. Fixed the way the color table index was working. DWF.
        4 Jan 1999. Added slightly modified CONGRID program to fix floating divide
          by zero problem. DWF
        2 May 1999. Added code to work around a Macintosh bug in IDL through version
          5.2 that tries to redraw the graphics window after a TVLCT command. DWF.
        5 May 1999. Restore the current window index number after drawing graphics.
          Not supported on Macs. DWF.
        9 Jul 1999. Fixed a couple of bugs I introduced with the 5 May changes. Sigh... DWF.
       13 Jul 1999. Scheesh! That May 5th change was a BAD idea! Fixed more bugs. DWF.
       31 Jul 1999. Substituted !D.Table_Size for !D.N_Colors. DWF.
        1 Sep 1999. Got rid of the May 5th fixes and replaced with something MUCH simpler. DWF.
       14 Feb 2000. Removed the window index field from the object notify structure. DWF.
       14 Feb 2000. Added NOTIFYPRO, DATA, and _EXTRA keywords. DWF.
       20 Mar 2000. Added MODAL, BLOCK, and COLORINFO keywords. DWF
       20 Mar 2000. Fixed a slight problem with color protection events triggering
          notification events. DWF.
       31 Mar 2000. Fixed a problem with pointer leakage on Cancel events, and improved
          program documentation. DWF.
       17 Aug 2000. Fixed a problem with CANCEL that occurred only if you first
          changed the gamma settings before loading a color table. DWF.
       10 Sep 2000. Removed the requirement that procedures and object methods must
          be written with an _Extra keyword. DWF.
        5 Oct 2000. Added the File keyword to LOADCT command, as I was suppose to. DWF.
        5 Oct 2000. Now properly freeing program pointers upon early exit from program. DWF.


xcopy_chk [1] $SSW/soho/mdi/idl_old/gen/ys_util/xcopy_chk.pro
[Previous] [Next]
   Name: xcopy_chk 

   Purpose: determine source/destination parameters for device
	     procedure from input delta

   Input Parameters:
      delta - offset - convention:      
			delta < 0 
			delta >= 0


XCOR_CDS $SSW/soho/cds/idl/util/misc/xcor_cds.pro
[Previous] [Next]
 Project     :	SOHO - CDS

 Name        :	XCOR_CDS

 Purpose     :	Coalign CDS images with generic FITS images

 Category    :	Class1, CDS, Analysis, Coordinates

 Explanation :	Does a two dimensional cross-correlation between a CDS raster
		image and an image stored in a FITS file.  From this
		cross-correlation, the relative pointing is determined.

		The FITS file to correlate the CDS data to must meet the
		following conditions:

		* It must contain a simple 2D image in the main part of
		  the FITS file--not in an extension.

		* It must contain the time, either in the single keyword
		  DATE_OBS in ISO/CCSDS format (e.g. EIT), or in the two
		  keywords DATE-OBS and TIME-OBS (e.g. BBSO).

		* It must contain the absolute pointing of the image, using the
		  keywords CRPIX/CRVAL/CDELT.

		* It must encompass the entire field of view of the CDS raster
		  images, including a margin for pointing error.

		The primary application for this routine is to coalign CDS
		images with full disk images such as from EIT, MDI, Yohkoh, or
		ground-based observatories.  Not all such images will have
		valid CRPIX/CRVAL/CDELT keywords.  One way to add these
		keywords is to use the routine IMAGE_TOOL.  The procedure would
		be as follows:

		1.  Copy over the FITS image file to your local directory, e.g.

			cp $SYNOP_DATA/bbso/bbso_halph_fd_19960623_1622.fts .

		2.  Run IMAGE_TOOL.
		3.  Establish the coordinate system by fitting the limb.
		4.  Select "Update FITS header" from the "File" pull-down menu.


 Syntax      :	XCOR_CDS, CDSFILE, IMAGEFILE, WINDOW  [, SUBIMAGE ]

 Examples    :	XCOR_CDS, 's3258r00', 'bbso_halph_fd_19960623_1622.fts', 6

 Inputs      :	CDSFILE	  = The name of the CDS FITS binary table file.
			    Alternatively, it can be a quicklook data structure
			    from READCDSFITS.

		IMAGEFILE = The name of the FITS image file containing the data
			    to coalign to.

		WINDOW	  = The index of the CDS window to extract.  Valid
			    values are 0 to N-1.

 Opt. Inputs :	None.

 Outputs     :	There are no required output parameters.  However graphics are
		displayed during the processing, and information about the
		alignment is printed to the screen.

 Opt. Outputs:	SUBIMAGE  = If passed, then the part of the FITS image file
			    corresponding to the CDS raster image is extracted.
			    The image will have the same dimensions as the CDS
			    images.

 Keywords    :	OUTPUT	  = If passed, then contains the name of a file that
			    information about the coalignment is appended to.
			    The following information is written:

				* The OPS_L and _R value from the FITS header.
				* The X,Y pointing determined from the
				  cross-correlation.
				* The average OPS_L and _R values from the FITS
				  binary table.
				* The average sun sensor pitch and yaw values
				  from the FITS binary table.

			    The primary purpose of the OUTPUT keyword is to
			    assist in the determination of the calibration of
			    the OPS and sun sensor.

		NOASK	  = If set, then the user is not prompted as to whether
			    the data should be written to the OUTPUT file.

		NOROTATE  = If set, then don't attempt to take solar rotation
			    into account.  This feature is useful for aligning
			    data at the limb.  However, the data should be
			    taken very close in time if the fit is to be
			    relevant.

		NOLIMB	  = If set, and NOASK is also set, then images which go
			    over the limb are not processed.

		NOVIEW	  = If set, then the data windows are not displayed.

		XCOR	  = Returns the calculated cross-correlation function.

		PARAM	  = Returns the parameters of the fit to the
			    cross-correlation function.

		NCORR	  = Search size to use in calculating the cross
			    correlation function.  Can be 1 or 2 numbers.
			    Default is 20.

		SC_ROLL	  = Roll angle during the observation.  This should be
			    used when aligning data taken when the spacecraft
			    is at a significant roll.  There are a couple of
			    factors to keep in mind when using this keyword:

				1.  This should only be used when coaligning
				    with another SOHO dataset, such as EIT, so
				    that both datasets are rotated by the same
				    amount.

				2.  The alignment is done in the rotated
				    coordinate frame, rather than in the true
				    frame.  The spacecraft roll angle is only
				    used for determining the effects of solar
				    rotation.

		NOROLL	  = Keyword passed to READCDSFITS.  The default value
			    is 1--i.e. ignore the spacecraft roll angle.  It is
			    also set to 1 when the SC_ROLL keyword is used.

		PIXEL_RANGE = Set to range of pixels to use within the
			    subwindow to extract out the desired line.

 Calls       : ***
	ASK, AVERAGE, CDS_CLEAN_IMAGE, CONTV, CROSS_CORR2, DATATYPE [1], DATATYPE [2]
	DATATYPE [3], FILE_EXIST [2], FXPAR [1], FXPAR [2], FXREAD [1], FXREAD [2]
	GET_SOHO_ROLL, GT_WINDATA, LSTSQR, PB0R, PLOT_IMAGE, PUT, READCDSFITS, ROT_XY, SETFLAG
	SETIMAGE, SETWINDOW [1], SETWINDOW [2], SIGRANGE [1], SIGRANGE [2], STR2UTC [1]
	STR2UTC [2], STR2UTC [3], TRIM, TVDEVICE, UNSETFLAG, UTC2STR, UTC2TAI, XCOR_CDS_GAUSS
	file_exist [1], file_exist [3]
 Common      :	None.

 Restrictions:	None.

 Side effects:	Unless the /NOVIEW keyword is set, the two windows 0 and 2 are
		created.  The TVDEVICE routine is used to channel images to
		window 2.

 Prev. Hist. :	Based on an earlier unreleased version called XCOR_W_EIT.

 History     :	Version 1, 12-Dec-1996, William Thompson, GSFC
		Version 2, 28-Jan-1997, William Thompson, GSFC
			Corrected bug where contours were not plotted correctly
			Put up both contours.  Smooth contours.
			Added keywords XCOR and PARAM
		Version 3, 04-Mar-1997, William Thompson, GSFC
			Adjust correlation size to image size
		Version 4, 05-May-1997, William Thompson, GSFC
			Add print statement about pixel position.
		Version 5, 07-May-1997, William Thompson, GSFC
			Handle data that doesn't completely cover CDS field of
			view.  Add keyword NCORR, allow different search sizes
			in X and Y.
		Version 6, 08-May-1997, William Thompson, GSFC
			Make double pass through LSTSQR to improve fits.
		Version 7, 13-Aug-1997, William Thompson, GSFC
			Call TVDEVICE, /DISABLE before exiting
		Version 8, 05-Sep-1997, William Thompson, GSFC
			Allow either CDS filename or QLDS as input.
		Version 9, 22-Oct-1997, William Thompson, GSFC
			Fix display bug on wide windows.
		Version 10, 28-Oct-1997, William Thompson, GSFC
			Added keyword NOROTATE
		Version 11, 17-Dec-1997, William Thompson, GSFC
			Don't call UPD_CDS_POINT, as it is called automatically
			by READCDSFITS.
		Version 12, 29-Oct-1998, William Thompson, GSFC
			Fixed bug where average OPS values weren't properly
			calculated when some were missing.
		Version 13, 23-Apr-1999, William Thompson, GSFC
			Added keywords SC_ROLL and NOROLL.
		Version 14, 27-Jul-1999, William Thompson, GSFC
			Added keyword PIXEL_RANGE
               Version 15, 05-Aug-2003, William Thompson, GSFC
                       Take into account when SOHO is upside-down.

 Contact     :	WTHOMPSON


XCPT $SSW/soho/cds/idl/util/ops/planning/xcpt.pro
[Previous] [Next]
 Project     : SOHO - CDS

 Name        : XCPT

 Purpose     : widget interface to CPT

 Category    : planning

 Explanation : 

 Syntax      : IDL> XCPT

 Inputs      : None

 Opt. Inputs : TSTART,TEND = start/end times to process

 Outputs     : None

 Opt. Outputs: 

 Keywords    : GROUP = widget id of calling widget
               ERR = error string
               STATUS = 0/1 if user aborted/proceeded with CPT

 CALLS: ***
	ANYTIM2TAI, ANYTIM2UTC [1], ANYTIM2UTC [2], CDS_PLAN_BRIEF, CONCAT_DIR [1]
	CONCAT_DIR [2], CONCAT_DIR [3], CONCAT_STRUCT, COPY_STRUCT [1], COPY_STRUCT [2]
	COPY_STRUCT [3], CPT, CW_FIELD, DATATYPE [1], DATATYPE [2], DATATYPE [3]
	DCS_SEL_CLEAR, DPRINT, EXIST, GET_CALLER, GET_CDS_STATE, GET_SOHO_ROLL, GET_UTC
	HAVE_WIDGETS [1], HAVE_WIDGETS [2], LIST_DETAIL, LOC_FILE [1], LOC_FILE [2]
	LOC_FILE [3], MATCH_STRUCT, MKLOG, MK_DFONT, PICK_TIMES, PREPARE_FT, RM_FILE
	SELECT_WINDOWS, STR_FORMAT, SUBMIT_IAP, TAG_EXIST [1], TAG_EXIST [2], TAI2UTC
	TEST_OPEN, TRIM, UTC2STR, UTC2TAI, WIDG_HELP, WRITE_IAP, XACK, XALIVE, XANSWER, XCPT_EVENT
	XCPT_SET_ROLL, XKILL, XLIST, XMANAGER, XMANAGER_RESET, XPRINT [1], XPRINT [2]
	XPRINT [3], XPRINT [4], XPRINT [5], XREALIZE, XREGISTERED, XSHOW, XTEXT, XTEXT_RESET
	XVALIDATE, concat_dir [4], restgen [1], restgen [2], savegen [1], savegen [2]
 CALLED BY:
	MK_CDS_PLAN
 Common      : None

 Restrictions: Normally run after IAP file is created with XIAP

 Side effects: None

 History     : 26-Jan-1996,  D.M. Zarro.  Written
               09-Oct-1997.  Change use of adjust_allowed keyword.  CDP
               11-Feb-1999.  Fixed a typo introduced at some time in the recent past?! CDP
               28-Dec-1999.  Added pointing to preview option (DMZ)
               15-Sep-2002.  Used SAVEGEN/RESTGEN for log files (DMZ)
                7-Jul-2003.  Added SOHO_ORIENT label - Zarro (EER/GSFC)
                3-Dec-2003.  Added second check for SOHO_ORIENT - Zarro (L-3Com/GSFC)

 Contact     : DZARRO@SOLAR.STANFORD.EDU


XCR_REMOVE $SSW/soho/cds/idl/util/misc/xcr_remove.pro
[Previous] [Next]
 Project     : SOHO - CDS     
                   
 Name        : XCR_REMOVE
               
 Purpose     : Manual cosmic ray remover
               
 Explanation : This program allows the user to flag cosmic ray pixels in a
               dataset as MISSING, or to "unflag" pixels falsely identified
               as cosmic rays by an automatic routine.

               The user may browse through the data on exposure at a time,
               using the previous/next exposure buttons.

               The display consists of the original input data (top/left),
               and the "working copy/output data" (bottom/right). It is
               possible to supply a "suggestion" data set for the working
               copy. this is usually done when using automatic cosmic ray
               algorithms.

               When the widget is in "MOVE" mode, clicking the middle mouse
               button moves the "focus point", clicking the right mouse
               button zooms in (centering on the focus point), clicking the
               left mouse button zooms out.

               Zooming in (or clicking the "Mode:MOVE" button) switches to
               the "FLIP" mode, where clicking on an image pixel flips the
               status of that pixel (MISSING/original value) in the working
               copy data set. Zooming out (or clicking the "Mode:FLIP"
               button) switches to the MOVE mode.

               The default color scaling is designed to control the color of
               MISSING pixels. The user may choose the hightlighting color to
               be used by pressing the "HiLit:GREEN" button to select either
               RED, GREEN, BLUE or BLACK.
               
 Use         : XCR_REMOVE,IN_DATA,OUT_DATA,MISSING
    
 Inputs      : IN_DATA, OUT_DATA

               The input data is assumed to be 3 or 4-dimensional data with
               detector exposures in the "plane" spanned by dimensions 1 and
               3, i.e.:

                  exposure_image = reform(data_in(*,xix,*,tix))

               where xix and tix determines which exposure is looked at.

               The output data variable may contain a "suggestion" data set
               with some pixels already flagged as missing.

               MISSING : A scalar that determines the value used to represent
                         bad pixels.

 Opt. Inputs : None.
               
 Outputs     : OUT_DATA : The value of the working copy data set when the
                          user exits from the application.
               
 Opt. Outputs: None.
               
 Keywords    : EXPOSURE_IX : The index of the exposure to be displayed
                             initially. exposure_ix = xix + n_xix * tix

 Calls       : ***
	CW_FLIPSWITCH, CW_LOADCT, CW_MOUSE, CW_PZOOM [1], CW_TMOUSE, DEFAULT
	SINCE_VERSION [1], SINCE_VERSION [2], TRIM, XCR_REMOVE_CHANGEXP
	XCR_REMOVE_EVENT, XCR_REMOVE_FLIP_PIX, XCR_REMOVE_HELP, XCR_REMOVE_SWITCHMODE
	XCR_REMOVE_USEHILIT, XMANAGER, XREALIZE, XTEXT, XTVSCALE, cw_pzoom [2]
 CALLED BY:
	XCDS_COSMIC
 Common      : None.
               
 Restrictions: None.
               
 Side effects: Alters colortable
               
 Category    : ?
               
 Prev. Hist. : None.

 Written     : S. V. H. Haugan, UiO, 6 January 1997
               
 Modified    : Version 2, William Thompson, GSFC, 8 April 1998
			Changed !D.N_COLORS to !D.TABLE_SIZE for 24-bit displays

 Version     : Version 2, 8 April 1998


xdate [1] $SSW/soho/mdi/idl_old/gen/ys_util/xdate.pro
[Previous] [Next]
   Name: xdate

   Purpose: Time input widget for Yohkoh - uses sliders for date and time

   Input Parameters:
      
   Output Parameters:
      function returns widget ID of xdate widget

 CALLED BY:
	xsearch_obs
   Note: widget 'uvalue' of xdate WID is a structure including
         .time and .day fields which are updated by the event handler.

   Keyword Parameters:
      wid - optional widget_text WID from calling application - if present,
            the current xdate value is written to this text area
            (it follows that the calling application can read this via
             widget_control, get_value=last_xdate, WID)
  
      group_leader - leader/parent application (for auto-kill)
      register - if set, register this application (default lets parent do it)

   Calling Sequence:
      time_wid=xdate( [wid=wid] )

   History:
      24-mar-1995 (SLF) 
      26-mar-1995 (SLF) various - startup from text in WID, if supplied
                                  dont hard code start/stop times
      
 CALLS: ***
	GET_WUVALUE, GET_WVALUE, SLIDER_EVENT, STR2ARR [1], STR2ARR [2], TIMEBUT_EVENTS
	XDATE_EVENT, XDATE_SET2WID, XMANAGER, XMENU [1], XMENU [2], anytim2ints [1]
	anytim2ints [2], fmt_tim [1], fmt_tim [2], get_xfont [1], get_xfont [2]
	get_yo_dates [1], get_yo_dates [2], get_yo_dates [3], gt_day [1], gt_day [2]
	strsplit, timegrid, ut_time [1], ut_time [2]
   Restrictions:
      generally called by another widget application

   TODO: user supplied start and stop times.


XDEFROI $SSW/soho/sumer/idl/atest/xdefroi.pro
[Previous] [Next]

   NAME :
         XDEFROI
   PURPOSE :
        Define a region of interest in a given image
   CALLING SEQUENCE:
        Result = xdefroi(image, zoom=zoom)
   INPUTS:
       IMAGE     a two-dimensional array
                 It should be byte-type for better looking
                 since TV is used for displaying it.
   KEYWORDS:
       ZOOM     a two elements vector containning the expansion
                factor in X and Y.
   MODIFICATION HISTORY
       March 1997   Jongchul Chae
 
 CALLS:
 CALLED BY
	SUMER_TOOL_PD_EVENT


xdisp_sci5k $SSW/soho/mdi/idl/egse/xdisp_sci5k.pro
[Previous] [Next]
NAME:
	xdisp_sci5k
PURPOSE:
	To allow a user to select a file and image to be displayed
SAMPLE CALLING SEQUENCE:
	xdisp_sci5k
 CALLS: ***
	BREAK_FILE [1], BREAK_FILE [2], BREAK_FILE [3], CONCAT_DIR [1], CONCAT_DIR [2]
	CONCAT_DIR [3], CONGRID [1], CONGRID [2], CONGRID [3], EVENT_NAME, FILE_EXIST [2]
	FITS_SCI5K, GET_WVALUE, REVERSE, RFITS [1], RFITS [2], RFITS [3], SCI5K_DISP_IMG
	SCI5K_INFO_SUM, STDEV, UNIQ [1], UNIQ [2], UNIQ [3], WDEF [1], WDEF [2]
	XDISP_SCI5K_EVENT, XMANAGER, XMENU [1], XMENU [2], anytim2ints [1]
	anytim2ints [2], break_file [4], concat_dir [4], file_exist [1], file_exist [3]
	file_list [1], file_list [2], fmt_tim [1], fmt_tim [2], get_dpc_info
	get_xfont [1], get_xfont [2], mapx [1], mapx [2], mk_dpc_image, prstr [1], prstr [2]
	rd_tfile [1], rd_tfile [2], str_replace [1], str_replace [2], tbeep [1], tbeep [2]
	tbeep [3], tv2 [1], tv2 [2], xyouts2 [1], xyouts2 [2]
HISTORY:
	Created 26-Sep-95 by M.Morrison
	13-Oct-95 (MDM) - Removed code that built the image and replaced it
			  with a call to MK_DPC_IMAGE


xdisp_tfr $SSW/soho/mdi/idl/egse/xdisp_tfr.pro
[Previous] [Next]
NAME:
	xdisp_tfr
PURPOSE:
	To allow a user to select a file and image to be displayed
SAMPLE CALLING SEQUENCE:
	xdisp_tfr
 CALLS: ***
	BREAK_FILE [1], BREAK_FILE [2], BREAK_FILE [3], CONCAT_DIR [1], CONCAT_DIR [2]
	CONCAT_DIR [3], CONGRID [1], CONGRID [2], CONGRID [3], DRAW1_EVENT, EVENT_NAME
	FILE_EXIST [2], FORMSAVESINGIMG_SINGDESCFILE, GET_WVALUE, SXPAR [1], SXPAR [2]
	SXPAR [3], XDISP_TFR_EVENT, XLOADCT [1], XLOADCT [2], XLOADCT [3], XMANAGER
	XMENU [1], XMENU [2], break_file [4], ccd_hdr_info, concat_dir [4], file_exist [1]
	file_exist [3], file_list [1], file_list [2], get_xfont [1], get_xfont [2]
	list_tfi, mapx [1], mapx [2], mk_dpc_image, mk_mdi_fits, read_mdi, set_sci160k_dir
	str_replace [1], str_replace [2], tbeep [1], tbeep [2], tbeep [3]
HISTORY:
	Created 22-Sep-95 by M.Morrison
	25-Jan-96 (MDM) - Added option to set the directory
			- Allowed the image to be returned as a positional param
			- Changed calling sequence (positional param used to be
			  the input file name)
	30-Apr-96 (MDM) - Put protection for case where no files exist in default
			  directory
	15-Jan-97 (CED) - Added ASCII mode button and save-fits-file buttons

	29-Jan-97 (JFC) - Defaulted to ASCII readable form on start-up, converted displays to draw widgets,
			  added HR FOV overlay toggle button, display disk/CCD coordinates of mouse, removed
			  multiple window mutton (multiple draw widgets can be brought simultaneuosly

	08-May-97 (JFC) - replaced 
				fnames(i) = 'temp'+fug(i)+'.fits' with 
				fnames(i) = 'temp'+strtrim((i),2)+'.fits'
	28-Jul-97 (MDM) - Replaced WRT_FITS with MK_MDI_FITS calls for both
			  the single image write and the multiple image writes
	30-Jul-97 (MDM) - Corrected multiple image write case

common xdisp_tfr_blk3, infil, dir, files, images, img, h, img0, im_index, humanflag, info,ccdxylabelfd,ccdxylabelhr,diskxylabelfd,str_info,hsub,fdflag,diskxylabelhr,overflag,xoffset,yoffset,drawbase1,drawwidget1,quitting,drawnum

humanflag = not keyword_set(human)
overflag = 0
drawnum = 0
img=0
fdflag = 0
h = ''
if (n_elements(dir0) eq 0) then dir = getenv('MDI_SCI160K_LOG_DIR') else dir = dir0
if (n_elements(infil0) ne 0) then begin
    infil = infil0
    break_file, infil0, dsk_log, dir
end else begin
    infil = ''
end
files = ''
file_list00 = file_list(dir, '*_01.tfr', file=files)
infil = str_replace(infil, '.tfr', '')		;strip off the extension
if (n_elements(disp_size) eq 0) then disp_size = 512
if (!d.x_size ne disp_size) then wdef, xx, disp_size, /free

font = get_xfont(closest=12,/only_one,/fixed)
if (getenv('MDI_DEF_FONT') ne "") then font = getenv('MDI_DEF_FONT')
widget_control, default_font=font
device, font=font

base00=widget_base(/column,title='ZDISP_TFR', xoff=0, yoff=0)
xmenu, ['QUIT', 'Set Directory', 'List Directory', 'Reset TFRX File','Toggle ASCII','Save fits file','Save all files of this type'], $
	base00, $
	buttons=main_buts, /row

base0=widget_base(base00, /row)


XDL [1] $SSW/soho/mdi/idl_old/gen/ys_util/xdl.pro
[Previous] [Next]
 NAME:
	XDL
 PURPOSE:
	Provides a graphical user interface to the DOC_LIBRARY user
	library procedure.
 CATEGORY:
	Help, documentation, widgets .
 CALLING SEQUENCE:
	XDL [, Name]
 INPUTS:
	Name: The name of the initial routine for which help is desired.
		This argument should be a scalar string.
 KEYWORDS:
	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
 OUTPUTS:
	None. A widget interface is used to allow reading the help text.
 CALLS: ***
	DOC_LIB_UNIX [1], DOC_LIB_UNIX [2], DOC_LIB_VMS [1], DOC_LIB_VMS [2], UNIQ [1]
	UNIQ [2], UNIQ [3], XDL_EVENT, XDL_LIST, XDL_UPDATE, XMANAGER
 COMMON BLOCKS:
	None.
 RESTRICTIONS:
	- This routine does not support many of the keywords supported
	  by the DOC_LIBRARY procedure.
	- This routine uses DOC_LIBRARY to do much of the actual work
	  of finding the documentation text. The alternative would be
	  to duplicate much of DOC_LIBRARY which is undesirable. However,
	  the use of DOC_LIBRARY leads to messages sometimes being sent
	  to the terminal.
 MODIFICATION HISTORY:
	5 January 1991, AB
	30-Jun-92 (M.Morrison) - Modification so that it would work on SGI
	29-Jul-92 (S.Freeland) - Generalized above fix to include mips
				 (and allow extentions to new systems)


XEDITFRAME $SSW/soho/lasco/idl/movie/xeditframe.pro
[Previous] [Next]
 Project       : SOHO -LASCO/EIT

 Name          : XEDITFRAME

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

 Use           : XEDITFRAME, in, out, [moviev]

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

 Calls         : ***
	CROP_TO_EQ, CW_BGROUP, CW_FIELD, DIST, EDITFRAME_EV, EDIT_DEFINEWIDGETS
	EDIT_GETFILENAME, EDIT_GETSUPERBASENAME, EDIT_LOADIMG, EDIT_SHOWIMAGES
	EDIT_UPDATEWIDGETS, FLOAT2STR, GETSUPERBASENAME, GET_FILENAME
	LASCO_READFITS [1], LASCO_READFITS [2], OFFSET_BIAS, PICKFILE, STR_SEP, SWAP [1]
	SWAP [2], XMANAGER, XREGISTERED, point_filter
 CALLED BY:
	WRUNMOVIEM, WRUNMOVIEM3, WRUNMOVIEM_RT
 Side effects  : XEDITFRAME disables all other widgets (e.g. WRUNMOVIEM's interface)
		  until it is finished.

 Category      : Image Processing

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

 Modified	: N. Rich	971211	Change EDIT_GETFILENAME function to use
					GET_FILENAME procedure--retrieves final data
					if it exists
	03.09.23, NRich - If moviev.rect THEN rotate image

 Version       : 

 See Also      : WRUNMOVIEM.PRO
 @(#)xeditframe.pro	1.7 09/24/03 :NRL Solar Physics


XEVENT $SSW/soho/sumer/idl/contrib/germerott/sumer_head/xevent.pro
[Previous] [Next]
 PROJECT:
       SOHO - SUMER

 NAME:
       XEVENT()

 PURPOSE: 
       returns x detector events in cts/s including specific scale factor

 CATEGORY:
       
 
 EXPLANATION:
       
 SYNTAX: 
       Result = xevent()

 EXAMPLES:
       
 INPUTS:
       header - BYTARR(92) Image Header

 OPTIONAL INPUTS: 
       None.

 OUTPUTS:
       None.

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS: 
       None.

 CALLS: ***
	DETECTOR
 COMMON:
       None.

 RESTRICTIONS: 
       None.

 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, October 7, 1996, Dietmar Germerott, MAPE Lindau. Written

 CONTACT:
       Dietmar Germerott, MAPE Lindau (germerott@linax1.mpae.gwdg.de)


XGAUSSFIT $SSW/soho/sumer/idl/atest/xgaussfit.pro
[Previous] [Next]
   NAME : 
               XGAUSSFIT
   PURPOSE :
              Interactive Gaussian Fitting
   CALLING SEQUENCE :
             
             XGAUSSFIT, X, Y,  Par, Ncomp=Ncomp, Noise=Noise

   INPUTS:
             
           X      independent variables
           Y      dependent variables

   OUTPUT :   
 
          PAR   fitted gaussian parameters

              Y =   par(0) + par(1)*X + par(2)*X^2
                    + par(3)*exp(-0.5*((X-par(4))/par(5))^2)
                    + par(6)*exp(-0.5*((X-par(7))/par(8))^2) + ...
          under  the positive constraints, i.e.     par(3)>0,  par(6)>, ...

  KEYWORDS       
      
         XTITLE   x-axis title
         YTITLE   y-axis title 
         NCOMP     number of gaussian components (default=1)
         NOISE       a 3-element array  defining noise characteristics 
                           (default=[1,0 0])

                RMS NOISE = sqrt(NOISE(0)+NOISE(1)*SIGNAL
                       +NOISE*SIGNAL^2)
 CALLS: ***
	CONCAT_DIR [1], CONCAT_DIR [2], CONCAT_DIR [3], CW_BGROUP, CW_FIELD, CW_PDMENU
	MARK_ON_IMAGE, XGAUSSFIT_EVENT, XGAUSSFIT_PD_EVENT, XMANAGER, XPS_SETUP
	concat_dir [4], mgaussfit
 CALLED BY:
	SUMER_DISPLAY_W
  HISTORY:
          1998 December 2    J. Chae   updated hardcopy part.


xhkplot $SSW/soho/mdi/idl/egse/xhkplot.pro
[Previous] [Next]
NAME:
	xhkplot
PURPOSE:
	To plot the MDI and S/C HK data using a widget interface to
	specify which mnemonics and how to plot it
SAMPLE CALLING SEQUENCE:
	xhkplot
	xhkplot, '5-jan-95', '5-jan-95 3:00', mnem
 CALLS: ***
	ARR2STR [1], Arr2Str [2], CLEAR_UTPLOT [1], CLEAR_UTPLOT [2], CONCAT_DIR [1]
	CONCAT_DIR [2], CONCAT_DIR [3], EVENT_NAME, FILE_EXIST [2], GET_WVALUE, NEW_HKPLOT
	STR2ARR [1], STR2ARR [2], WDEF [1], WDEF [2], XHKPLOT_EVENT, XLOADCT [1]
	XLOADCT [2], XLOADCT [3], XMANAGER, XMENU [1], XMENU [2], XMENU_GEN_BUT [1]
	XMENU_GEN_BUT [2], XMENU_GEN_INPUT [1], XMENU_GEN_INPUT [2], XMENU_PSYM
	XMENU_SEL [1], XMENU_SEL [2], anytim2ex [1], anytim2ex [2], anytim2ints [1]
	anytim2ints [2], clearplot [1], clearplot [2], concat_dir [4], data_type [1]
	data_type [2], ex2fid [1], ex2fid [2], file_append [1], file_append [2]
	file_exist [1], file_exist [3], fmt_tim [1], fmt_tim [2], get_hk_info [1]
	get_hk_info [2], get_xfont [1], get_xfont [2], gt_day [1], gt_day [2], gt_time [1]
	gt_time [2], hkplot_info, mapx [1], mapx [2], prstr [1], prstr [2], rd_tfile [1]
	rd_tfile [2], rem_elem [1], rem_elem [2], set_printer [1], set_printer [2]
	set_printer [3], set_printer [4], set_printer [5], str2cols [1], str2cols [2]
	tbeep [1], tbeep [2], tbeep [3], ut_time [1], ut_time [2]
 CALLED BY:
	verify_gui
HISTORY:
	Created 26-Jan-95 by M.Morrison
	31-Jan-95 (MDM) - Various modifications
			- Added SET PRINTER button
			- Added SAVE INPUTS button and "infil" keyword input
	12-Jun-95 (MDM) - Added LAST_N_HOURS option
			- Added 1 sigma plotting option
	15-Sep-95 (MDM) - Added killing the window if it is window 32
			  because it doesn't create a window at the PLOT command
	21-Nov-96 (MDM) - Put XHKPLOT_EVENT into this file
			- Made the mnemonic selection not be exclusive-or
	26-Mar-97 (MDM) - Made the mnemonic 9 characters long (not 8)
     12-Jul-2000 (RIB) - Added "/fixed" to get_xfont call to remove str2number warning


XIAP $SSW/soho/gen/idl/plan/science/xiap.pro
[Previous] [Next]
 Project     :	SOHO - CDS

 Name        : XIAP

 Purpose     : widget interface to WRITE_IAP and WRITE_CAP

 Use         : XIAP

 Inputs      : None.

 Opt. Inputs : OPS_DAY1 = operational start day in any CDS UTC format.
               OPS_DAY2 = operational stop day in any CDS UTC format.

 Outputs     : STATUS = 1 if successful, 0 otherwise

 Opt. Outputs: None.

 Keywords    : 
               OBSERVER = observer name 
               COMMENT = optional comment
               CAP = set to write Composite Activity plan instead of 
                     Instrument plan
               TITLE = Title of widget; defaults to 'XIAP'
               
 Explanation : None.

 CALLS: ***
	ANYTIM2TAI, ANYTIM2UTC [1], ANYTIM2UTC [2], CW_FIELD, DATATYPE [1], DATATYPE [2]
	DATATYPE [3], EXIST, FIND_KAP_FILE, FREE_POINTER, GET_CALLER, GET_POINTER, GET_UTC
	HAVE_WIDGETS [1], HAVE_WIDGETS [2], MAKE_POINTER, MK_DFONT, PICK_TIMES
	RD_ASCII [1], RD_ASCII [2], REP_TAG_VALUE, SET_POINTER, TAI2UTC, TRIM, UTC2TAI
	WHICH_INST, XALIVE, XANSWER, XIAP_EVENT, XIAP_WRITE, XINPUT, XKILL, XMANAGER
	XMANAGER_RESET, XREALIZE, XSHOW, XTEXT, XTEXT_RESET, XVALIDATE
 CALLED BY:
	MK_CDS_PLAN, MK_SOHO
 Common      : None.

 Restrictions: None.

 Side effects: None.

 Category    : Help

 Prev. Hist. : None.

 Written     :	Zarro (ARC/GSFC) 27 March 1995

 Version     : 1


XLOADCT [1] $SSW/soho/lasco/idl/display/xloadctbp.pro
[Previous] [Next]
 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.
 CALLS: ***
	CW_BGROUP, FILEPATH, LOADCT, REVERSE, XDISPLAYFILE [1], XDISPLAYFILE [2]
	XLCT_DRAW_CPS, XLCT_PSAVE, XLCT_SHOW, XLCT_TRANSFER, XLOADCTBP, XLOADCTBP_EVENT
	XMANAGER, XREGISTERED
 CALLED BY:
	BREAK_FILE [2], C3_CME, C3_CME_FRONT, CDS_ENG_N1_VW, CME_MASSIMG2TOTAL
	COMBINE_IMG, CPMOVIE, CPMOVIE_DO, CPMOVIE_EV, CPONE, CPONE_EV, CT_Handling
	CW_ANIMATE2, EIT_DISPLAY, EIT_MKMOVIE, EIT_SUBFIELD, FCS, GDSPSPEC, GET_PT, GR_IMAGES
	HXISWIDGET, HXISWIDG_EV, IMAGE_REGISTER, LOCATE_FFCAL, MK_RASTER, MOVIE_MAKER
	MVIPLAY, MVIPLAY3, NDSPSPEC, NRH2_PROJECTION, NRH_ANIM, NRH_VISU_2D, PB_INVERTER
	RTMOVIE, RTMVIPLAY [1], RTMVIPLAY [2], RTMVIPLAYPNG, STEPPER [3], STEPPER [4]
	STEPPER [6], STEPPER [7], SUBFIELD_EV, SUMER_REFORMAT [2], SUMER_TOOL_PD_EVENT
	SUN_IMAGE, VIEW_RAW, WRITE_SUMMARIES [1], WRUNMOVIE [2], WRUNMOVIE4, WRUNMOVIEM
	WRUNMOVIEM3, WRUNMOVIEM_RT, XCDS_SNAPSHOT, XRASTER [1], XRASTER [2], XTV, XTVSCALE
	ar_prep, box_lc_plot, dsp_menu, gbo_obs_coord, polariz_display, qvu_loadct
	sa_gt_specrange, sel_region, show_pix [1], show_pix [2], show_pix_event [1]
	show_pix_event [2], show_pix_event [3], uvsp, wdefroi [1], wdefroi [2], xdisp_tfr
	xhkplot, xspr [1], xspr [2], xstepper_event, xsxt_prep_event, zmovie
 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.


XLOADCT [2] $SSW/soho/mdi/idl_old/gen/ys_util/xloadct2.pro
[Previous] [Next]
 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:
	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
	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.
	WHICH  - which predefined color tables to include
		 default is all (0-15)
	CUSTOM - if set, interactivly define WHICH

 OUTPUTS:
	None.
 CALLS: ***
	FILEPATH, LOADCT, STRETCH, XDISPLAYFILE [1], XDISPLAYFILE [2], XLOADCT2
	XLOADCT2_EVENT, XMANAGER, XREGISTERED, wmenu_sel [1], wmenu_sel [2]
 CALLED BY:
	BREAK_FILE [2], C3_CME, C3_CME_FRONT, CDS_ENG_N1_VW, CME_MASSIMG2TOTAL
	COMBINE_IMG, CPMOVIE, CPMOVIE_DO, CPMOVIE_EV, CPONE, CPONE_EV, CT_Handling
	CW_ANIMATE2, EIT_DISPLAY, EIT_MKMOVIE, EIT_SUBFIELD, FCS, GDSPSPEC, GET_PT, GR_IMAGES
	HXISWIDGET, HXISWIDG_EV, IMAGE_REGISTER, LOCATE_FFCAL, MK_RASTER, MOVIE_MAKER
	MVIPLAY, MVIPLAY3, NDSPSPEC, NRH2_PROJECTION, NRH_ANIM, NRH_VISU_2D, PB_INVERTER
	RTMOVIE, RTMVIPLAY [1], RTMVIPLAY [2], RTMVIPLAYPNG, STEPPER [3], STEPPER [4]
	STEPPER [6], STEPPER [7], SUBFIELD_EV, SUMER_REFORMAT [2], SUMER_TOOL_PD_EVENT
	SUN_IMAGE, VIEW_RAW, WRITE_SUMMARIES [1], WRUNMOVIE [2], WRUNMOVIE4, WRUNMOVIEM
	WRUNMOVIEM3, WRUNMOVIEM_RT, XCDS_SNAPSHOT, XRASTER [1], XRASTER [2], XTV, XTVSCALE
	ar_prep, box_lc_plot, dsp_menu, gbo_obs_coord, polariz_display, qvu_loadct
	sa_gt_specrange, sel_region, show_pix [1], show_pix [2], show_pix_event [1]
	show_pix_event [2], show_pix_event [3], uvsp, wdefroi [1], wdefroi [2], xdisp_tfr
	xhkplot, xspr [1], xspr [2], xstepper_event, xsxt_prep_event, zmovie
 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.
	2-JUN-1992, SLF, ADDED WHICH and CUSTOM KEYWORD PARAMETERS
		         also, private common, xloadct2_private


XMENU2 $SSW/soho/mdi/idl_old/gen/ys_util/xmenu2.pro
[Previous] [Next]
 NAME:
	XMENU2
 PURPOSE:
	Simplifies setting up widget menus. XMENU accepts a string
	array of menu labels, creates a widget base, and populates
	the base with buttons containing the specified labels.
 CALLING SEQUENCE:
	XMENU2, VALUES [, PARENT]
 INPUTS:
	VALUES - An array of labels for the butons. If VALUES is of
		type string, then it is a 1-D array of labels. If it
		is of type byte, it is a 3-D array of bitmaps, where
		the 1st 2 dimensions are the width and height of each
		bitmap.
	PARENT - Widget ID of parent base widget. If this argument is
		omitted, the menu base is a top-level base.
 KEYWORDS:
	BASE: A named variable to recieve the widget id of the created base.
	BUTTONS: A named variable to recieve the widget id of the created
		buttons. This return value is a longword array, with each
		element matching the corresponding element in VALUES.
	COLUMN: Specifies the buttons should be layed out in columns. The
		value specified gives the number of columns desired.
	EXCLUSIVE: Specifies that the buttons should have both selected
		and unselected states, and that only one button at a time
		is allowed to be selected.
	FRAME: A frame should be drawn around the base.
	NONEXCLUSIVE: Specifies that the buttons should have both selected
		and unselected states, and that more than one button at a time
		is allowed to be selected.
	NO_RELEASE: When set, the release events from buttons are ignored.
	ROW: Specifies the buttons should be layed out in rows. The
		value specified gives the number of rows desired.
	SCROLL: The base should have scrollbars to allow a large number
		of buttons to be viewed in a small region.
	SPACE: The space, in pixels, to be left around the edges of the base.
	TITLE: If PARENT is not specified, TITLE will specify the MENU title.
		IF PARENT is specified, a framed base will be created and a
		label with the value TITLE will be added before the menu. 
	XPAD: The horizontal space, in pixels, to be left between the buttons.
	YPAD: The vertical space, in pixels, to be left between the buttons.
	UVALUE: An array of user values to be set into the UVALUE of the
		buttons. This array must have the same number of elements
		as VALUES.
	X_SCROLL_SIZE: The width of the scrolling viewport. This keyword
		implies SCROLL.
	Y_SCROLL_SIZE: The height of the scrolling viewport. This keyword
		implies SCROLL.
	
 OUTPUTS:
	None.
 CALLED BY:
	MK_CDS_DBASE, SCANPATH, SHOW_SYNOP__DEFINE, SYNOP_DEFINE, XCAMP, XMENU [2]
	XPS_SETUP, goes_widget, xspr [1], xspr [2], xstepper [1], xstepper [2]
	xstepper_event
 COMMON BLOCKS:
	None.
 SIDE EFFECTS:
	A widget base containing buttons has been created, but not realized.
 MODIFICATION HISTORY:
	16 January 1991, AB, RSI
	5 September 1991, SMR, RSI   Fixed bug where titles were ignored when
				     no base specified.
	9-Jun-1992, slf, added font keyword - renamed xmenu2


XMENU_GEN_B_EV [2] $SSW/soho/mdi/idl_old/gen/ys_util/xmenu_gen_but.pro
[Previous] [Next]

 NAME: 
 	XMENU_GEN_B_EV

 PURPOSE:
       The event handler for XMENU_GEN_BUT


 CALLS: ***
	EVENT_NAME, GET_WVALUE, XMANAGER, XMENU [1], XMENU [2], XMENU_GEN_BUT [1]
	XMENU_GEN_BUT [2]
 CALLED BY:
	XMENU_GEN_BUT [1], XMENU_GEN_BUT [2]
 RESTRICTIONS:
	none

 HISTORY:
	Written 31-Jan-95 by M.Morrison 


XMENU_GEN_BUT [2] $SSW/soho/mdi/idl_old/gen/ys_util/xmenu_gen_but.pro
[Previous] [Next]

 NAME: 
	XMENU_GEN_BUT

 PURPOSE:
     	Allow user to pass an array of labels for buttons and allow user
	to click on them to select a single option/item

 CALLING SEQUENCE:
	result = xmenu_gen_but(array, group=group, tit=tit)
	result = xmenu_gen_but(['Continue', 'Abort'])

 INPUTS:
       ARRAY       A string or string array of values to be displayed for
		    selection
 CALLS: ***
	EVENT_NAME, GET_WVALUE, XMANAGER, XMENU [1], XMENU [2], XMENU_GEN_B_EV [1]
	XMENU_GEN_B_EV [2]
 CALLED BY:
	XMENU_GEN_B_EV [1], XMENU_GEN_B_EV [2], xhkplot, xyesno
 OPTIONAL KEYWORD INPUT:
	TIT	    The title of the widget
	GROUP	    The parent widget id (so that if the parent widget exits,
		    this widget is destroyed too)
	LOCATION    the location of the upper left corner relative to the
		    upper left corner of the screen
 RESTRICTIONS:
	Must have widgets available.

 HISTORY:
	Written 31-Jan-95 by M.Morrison 
	12-Jun-95 (MDM) - Added LOCATION keyword


XMENU_GEN_I_EV [2] $SSW/soho/mdi/idl_old/gen/ys_util/xmenu_gen_input.pro
[Previous] [Next]

 NAME: 
 	XMENU_GEN_I_EV

 PURPOSE:
       The event handler for XMENU_GEN_INPUT


 CALLS: ***
	EVENT_NAME, GET_WVALUE, XMANAGER, XMENU [1], XMENU [2], XMENU_GEN_INPUT [1]
	XMENU_GEN_INPUT [2]
 CALLED BY:
	XMENU_GEN_INPUT [1], XMENU_GEN_INPUT [2]
 RESTRICTIONS:
	none

 HISTORY:
	Written 30-Jan-95 by M.Morrison 


XMENU_GEN_INPUT [2] $SSW/soho/mdi/idl_old/gen/ys_util/xmenu_gen_input.pro
[Previous] [Next]

 NAME: 
	XMENU_GEN_INPUT

 PURPOSE:
     	Allow user to pass an array of labels and to allow users to 
	modify 1 to 5 fields

 CALLING SEQUENCE:
	xmenu_gen_input, array, out1, out2, out3, nchar=nchar, group=group, tit=tit
	xmenu_gen_input, mnem, ymin, ymax, labels=['YMIN: ','YMAX: ']

 INPUTS:
       ARRAY       A string or string array of values to be displayed for
		    selection
 CALLS: ***
	EVENT_NAME, GET_WVALUE, XMANAGER, XMENU [1], XMENU [2], XMENU_GEN_I_EV [1]
	XMENU_GEN_I_EV [2]
 CALLED BY:
	XMENU_GEN_I_EV [1], XMENU_GEN_I_EV [2], xdisp_fits, xdisp_trace [1]
	xdisp_trace2, xdisp_trace3, xhkplot, xread_hist
 OPTIONAL KEYWORD INPUT:
	TIT	    The title of the widget
	GROUP	    The parent widget id (so that if the parent widget exits,
		    this widget is destroyed too)

 INPUT/OUTPUT:
	out1	    The default input and the output for what the user entered
	out2	    The default input and the output for what the user entered
	out3	    The default input and the output for what the user entered

 RESTRICTIONS:
	Must have widgets available.

 HISTORY:
	Written 30-Jan-95 by M.Morrison 


XMENU_SEL [2] $SSW/soho/mdi/idl_old/gen/ys_util/xmenu_sel.pro
[Previous] [Next]

 NAME: 
	XMENU_SEL

 PURPOSE:
     	Allow user to select a set of items from a list.  Widget equivalent
	of WMENU_SEL

 CALLING SEQUENCE:
       ss = xmenu_sel(array)
       ss = xmenu_sel(array, /one)

 INPUTS:
       ARRAY       A string or string array of values to be displayed for
		    selection
 CALLS: ***
	EVENT_NAME, GET_WVALUE, XMANAGER, XMENU [1], XMENU [2], XMENU_SEL_EV, XMENU_SEL_LAB
	tbeep [1], tbeep [2], tbeep [3]
 CALLED BY:
	focus_trace_flt, full_graph_gif, get_hk_mnem, jitter_gif_xyimg, rd_dt_genx
	set_sci160k_dir, tr_scan_images, tr_switch_dirs, trace_uniq_movies, xcheckip
	xdisp_fits, xdisp_trace [1], xdisp_trace [2], xdisp_trace2, xdisp_trace3, xhkplot
	xrd_trace
 OPTIONAL KEYWORD INPUT:
	ONE	    If set then only one button may be turned on at a time.
	TIT	    The title of the widget
	GROUP	    The parent widget id (so that if the parent widget exits,
		    this widget is destroyed too)
	NLINES      How many lines to display.  Default is 20
 OUTPUTS:
	The result returns the select indices of the array ARRAY.

 RESTRICTIONS:
	Must have widgets available.

 HISTORY:
	Written 30-Jan-95 by M.Morrison using Elaine Einfalt
	YO_TAPE_WIDG as a starting point
	10-Jul-96 (MDM) - Ajustment to make the output scaler if it
			  is a single item
	 9-Jan-97 (MDM) - Added NLINES option


XMOVIE [2] $SSW/soho/mdi/idl_old/gen/ys_util/xmovie.pro
[Previous] [Next]
 NAME:
	XMOVIE
 PURPOSE:
	Display movie using X-Windows/Motif (front end for DMS routines)
 INPUTS:
	DATA - data cube (interpreted as 2D images x N frames)
 OPTIONAL INPUTS:
	factor	- The rebinning factor.  Default is 1.
 OPTIONAL KEYWORD PARAMETERS
	TITLE 	- Widget title for movie display
	ss	- the subscripts of the images to display.  The default
		  is to display them all
 MODIFICATION HISTORY
	SLF, 3/15/91
	21-Dec-93 (MDM) - Modified to perform a byte scaling on the
			  whole cube.  Do it one image at a time, and we
			  save memory.  Before, we had to do
				xmovie, bytscl(data)
			- Add SS option
	10-Jan-94 (MMD) - Added FACTOR option

 CALLS:
 CALLED BY
	DSP_MOVIE, FF_DEMO, XBLINK, show_pix [1], show_pix [2], show_pix_event [1]
	show_pix_event [2], show_pix_event [3]


XPLOT_HT $SSW/soho/lasco/idl/movie/xplot_ht.pro
[Previous] [Next]
 NAME:
	XPLOT_HT

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

 CATEGORY:
	MOVIE

 CALLING SEQUENCE:
	XPLOT_HT

 INPUTS:

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

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

 OPTIONAL OUTPUT PARAMETERS:

 CALLS: ***
	CURVEFIT, CUSTOM_PLOT, CW_BGROUP, CW_FIELD, DO_PLOT, GET_UTC, HT_PLOT, HT_PRINT, HT_SAVE
	OUTPLOT [1], OUTPLOT [2], OUTPLOT [3], PA_PLOT, PICKFILE, PLOT_HT_EV, POLY, POLY_FIT
	READ_HT, STR_SEP, TAI2UTC, UTC2STR, UTPLOT [1], UTPLOT [2], UTPLOT [3], UTPLOT [4]
	UTPLOT [5], UTPLOT [6], XMANAGER, XREGISTERED, ps_setup
 CALLED BY:
	WRUNMOVIEM, WRUNMOVIEM3, WRUNMOVIEM_RT
 COMMON BLOCKS:
	com_xplot_ht

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

 RESTRICTIONS:

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

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

 @(#)xplot_ht.pro	1.16 07/18/00 :LASCO IDL LIBRARY


XPORT $SSW/soho/cds/idl/util/ops/planning/xport.pro
[Previous] [Next]
 Project     : SOHO - CDS

 Name        : XPORT

 Purpose     : widget interface to EXPORT_PLAN

 Category    : planning

 Explanation : 

 Syntax      : IDL> XPORT

 Inputs      : None

 Opt. Inputs : None

 Outputs     : None

 Opt. Outputs: 

 Keywords    : GROUP = widget id of calling widget
               ERR = error string
               STATUS = 0/1 if user aborted/proceeded with XPORT

 CALLS: ***
	CDS_PLAN_BRIEF, CHK_DIR [1], CHK_DIR [2], COPY_STRUCT [1], COPY_STRUCT [2]
	COPY_STRUCT [3], CW_FIELD, DATATYPE [1], DATATYPE [2], DATATYPE [3], EXIST
	EXPORT_PLAN, GET_CALLER, GET_UTC, HAVE_WIDGETS [1], HAVE_WIDGETS [2], MATCH_STRUCT
	MK_DFONT, PICK_TIMES, SELECT_WINDOWS, TAG_EXIST [1], TAG_EXIST [2], TAI2UTC
	TEST_OPEN, TRIM, UTC2TAI, XACK, XALIVE, XINPUT, XKILL, XMANAGER, XMANAGER_RESET
	XPORT_EVENT, XPORT_PATH, XREALIZE, XREGISTERED, XSHOW, XTEXT, XTEXT_RESET, XVALIDATE
 CALLED BY:
	MK_CDS_PLAN
 Common      : None

 Restrictions: None

 Side effects: None

 History     : Version 1, 21-April-1997,  D.M. Zarro.  Written

 Contact     : DZARRO@SOLAR.STANFORD.EDU


XPROGRAM $SSW/soho/cds/idl/util/ops/planning/xprogram.pro
[Previous] [Next]
 Project     : SOHO - CDS

 Name        : XPROGRAM

 Purpose     : widget interface to program database

 Category    : operations, widgets

 Explanation :

 Syntax      : IDL> XPROGRAM,PROG_ID

 Inputs      : None

 Opt. Inputs : None

 Outputs     : PROG_ID

 Opt. Outputs: None

 Keywords    : GROUP = widget ID of any calling widget

 CALLS: ***
	DATATYPE [1], DATATYPE [2], DATATYPE [3], EXIST, FREE_POINTER, GET_CALLER
	GET_POINTER, HAVE_WIDGETS [1], HAVE_WIDGETS [2], LIST_PROGRAM, MAKE_POINTER
	MK_DFONT, SET_POINTER, STRPAD, XALIVE, XKILL, XMANAGER, XMANAGER_RESET, XPROGRAM_ADD
	XPROGRAM_EVENT, XPROGRAM_LIST, XREALIZE
 CALLED BY:
	MK_CDS_PLAN
 Common      : None

 Restrictions: None.

 Side effects: None.

 History     : Version 1,  6-Jan-1996,  D.M. Zarro.  Written

 Contact     : DZARRO@SOLAR.STANFORD.EDU


XPROGRAM_ADD $SSW/soho/cds/idl/util/ops/planning/xprogram_add.pro
[Previous] [Next]
 Project     : SOHO - CDS

 Name        : XPROGRAM_ADD

 Purpose     : widget interface to add program ID to database

 Category    : planning,operations,widgets

 Explanation : 

 Syntax      : IDL> XPROGRAM_ADD

 Inputs      : None

 Opt. Inputs : PROG_ID = if valid PROG_ID is entered, then it is displayed

 Outputs     : None

 Opt. Outputs: None

 Keywords    : GROUP = widget ID of any calling widget
               MODAL = set to freeze calling widget
               SAVED = 1 if program successfully added

 CALLS: ***
	ADD_PROGRAM, CW_FIELD, DATATYPE [1], DATATYPE [2], DATATYPE [3], DEF_PROGRAM, EXIST
	FREE_POINTER, GET_POINTER, GET_PROGRAM, HAVE_WIDGETS [1], HAVE_WIDGETS [2]
	MAKE_POINTER, MK_DFONT, REP_TAG_VALUE, SET_POINTER, WHICH_INST, XACK, XALIVE, XANSWER
	XKILL, XMANAGER, XPROGRAM_ADD_EVENT, XPROGRAM_SAVE, XREALIZE, XSHOW, XTEXT_RESET
 CALLED BY:
	XPROGRAM
 Common      : None

 Restrictions: None

 Side effects: None

 History     : Version 1,  4-Jan-1996,  D.M. Zarro.  Written

 Contact     : DZARRO@SOLAR.STANFORD.EDU


xread_hist $SSW/soho/mdi/idl/egse/xread_hist.pro
[Previous] [Next]
NAME:
	xread_hist
PURPOSE:
	To accept user specification for the start/end time and
	options to call the C READ_HIST module and to spawn the
	call
SAMPLE CALLING SEQUENCE:
	xread_hist
	xread_hist, '5-jan-95', '5-jan-95 3:00', mnem
 CALLS: ***
	ARR2STR [1], Arr2Str [2], BSORT [1], BSORT [2], BSORT [3], BSORT [4]
	CLEAR_UTPLOT [1], CLEAR_UTPLOT [2], CONCAT_DIR [1], CONCAT_DIR [2]
	CONCAT_DIR [3], DPRINT, EVENT_NAME, GET_WVALUE, XMANAGER, XMENU [1], XMENU [2]
	XMENU_GEN_INPUT [1], XMENU_GEN_INPUT [2], XREAD_HIST_EVENT, anytim2ex [1]
	anytim2ex [2], anytim2ints [1], anytim2ints [2], clearplot [1], clearplot [2]
	concat_dir [4], get_xfont [1], get_xfont [2], gt_day [1], gt_day [2], gt_time [1]
	gt_time [2], int2secarr [1], int2secarr [2], mapx [1], mapx [2], prstr [1]
	prstr [2], tbeep [1], tbeep [2], tbeep [3], ut_time [1], ut_time [2], wc_where [1]
	wc_where [2]
HISTORY:
	Created 3-May-95 by M.Morrison
	 5-May-95 (MDM) - Patch to work on FAULT (it was hanging
			  because of a WIDGET_CONTROL call before
			  the /realize command !?!?!?
			- Added /EOF switch 
	25-May-95 (MDM) - Added "-d", "-j", "-i" and "-a" options
			  through to read_hist
			- Coded the search option
	25-Jul-95 (MDM) - Added option to search and sort through
			  the Request ID items
			- Changed the results window to be 100 chars
			  instead of 80


XREGISTERED $SSW/soho/lasco/idl/util/xregistered2.pro
[Previous] [Next]
 NAME: 
	XREGISTERED

 PURPOSE:
	This function returns true if the widget named as its argument 
	is currently registered with the XMANAGER as an exclusive widget, 
	otherwise this routine returns false.

 CATEGORY:
	Widgets.

 CALLING SEQUENCE:
	Result = XREGISTERED(Name)

 INPUTS:
	Name:	A string containing the name of the widget in question.

 KEYWORD PARAMETERS:
	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.
	ID:	If the widget in question is registered, this named variable
               will contain the id of the first instance of the widget.

 OUTPUTS:
	If the named widget is registered, XREGISTERED returns the number
	of instances of that name in the list maintained by XMANAGER.  
	Otherwise, XREGISTERED returns 0.

 CALLS: ***
	XREGISTERED2
 CALLED BY:
	ACRIM, ACRIMHELP, ACRIMHELP_EV, ACRIM_EV, ACRIM_OUT, ATV, BCS, BIGPICKFILE, BLINK_MAP
	CATWIDHELP_EV, CDSLOG, CDSNOTIFY, CDSPICKFILE, CDS_ENG_N1, CDS_ENG_N1_VW, CDS_ENG_N4
	CD_SUMER, CHIANTI_NE, CHIANTI_TE, CH_GET_FILE, CP [2], CPHELP, CPHELP_EV [1]
	CPHELP_EV [2], CPMOVIE, CPMOVIE_DO, CPMOVIE_EV, CPONE, CPONE_EV, CP_CATHELP, CP_EVENT
	DSP_STRARR, EIS_CAT [1], EIS_CAT [2], EIS_IMAGE_TOOL_EVENT [1]
	EIS_IMAGE_TOOL_EVENT [2], EIT_SUB_TOOL, EIT_SUB_UTIL_MOVE, FCS, FIND_CDS_STUDIES
	FREEZE_RAS_DUR, FSC_PSCONFIG__DEFINE, GOES__DEFINE, HESSI, HESSI_DATA, HFLARE
	IMAGE_REGISTER, LISTBCS, LOCATE_FFCAL, MK_CDS_PLAN, MK_PLAN, MK_RASTER, MK_SOHO
	MK_STUDY, NRH, PB0R, PICKFILE, PICKFILES, PICKFITS, PICKFONT  use to be XFONT, PLOT_HT
	POPUP_MSG, QLHELP, QL_MENU, QUICK_LOOK, SCAN4FLARE, SCANPATH, SDAC, SDAC_CAT
	SEL_LINE_MENU, SHOW_SYNOP__DEFINE, SNU, ST_SUMER, TP_CLEAR_LINES, TP_CLEAR_STATE
	TP_DISPLAY_DEW, TP_DISPLAY_GP, TP_DISPLAY_VP, TP_DISP_IEF, TP_DISP_LLIST
	TP_DISP_RAST, TP_DRAW_RASDUR, TP_DRAW_VWIN, TP_PLOT_DEW, TP_PLOT_VDS, TP_RASDUR
	TP_RECALC_DEW, TWIDGET, UVSP_CATWIDHELP [2], WBDA [1], WBDA [2], WBSA [1], WBSA [2]
	WBSC [1], WBSC [2], WC2P, WCALCL, WCALCNEW, WCURRENT, WDMEMORY [1], WHIST, WIDG_HELP
	WIMG_INFO1, WIMG_INFO2, WIMG_INFO3, WIMG_INFO4, WINFO_ACTIV, WINUP [5], WLINES
	WLISTER, WLOAD, WLOADC, WLOADINFO, WLOADINFO1, WMESSAGE [1], WMESSAGE [2], WOBSDATE
	WREBIN, WRUNMOVIE [2], WRUNMOVIEM, WRUNMOVIEM3, WRUNMOVIEM_RT, WR_BEAM, WR_BEAM1
	WSAVE_PS [2], WSIZE, WTIME_HEIGHT, XCALENDAR, XCAMP, XCAT, XCDS_SNAPSHOT, XCLONE_PLAN
	XCME_MES, XCOLORS [1], XCOLORS [2], XCOLORS [4], XCPT, XEDITFRAME, XINTERANIMATE2
	XLOAD, XLOADCT [1], XLOADCT [2], XLOADCT [3], XPLOT_HT, XPORT, XRECORDER, XSPECT
	XSTARTHT, XSTUDY, XTV, XVAREDT, acknowledge [1], acknowledge [2], acknowledge [3]
	ch_ss, cp [1], cp_catwidget, hsi_ui_flarecat, hsi_ui_img, hsi_ui_lc, hsi_ui_mon
	hsi_ui_obs, hsi_ui_ql, hsi_ui_qlimage, hsi_ui_setlabels, hsi_ui_spec, mpeg_wid, qBar
	spex_image__define, uvsp, uvsp_catwidhelp [1], w_las_exp_norm, w_mk_stdim
	w_poly_diffim, w_stdim_list, winup [1], winup [2], winup [3], winup [4], wprint, wsave
	wsave1, wsave2, xpickfile, xspr [1], xspr [2], xstepper [1], xstepper [2]
 COMMON BLOCKS:
	MANAGED

 SIDE EFFECTS:
	Brings the widget to the front of the desktop if it finds one.

 RESTRICTIONS:
	None.

 PROCEDURE:
	Searches the list of exclusive widget names and if a match is found
	with the one in question, the return value is modified.

 MODIFICATION HISTORY:
	Written by Steve Richards, November, 1990
	Jan, 92 - SMR	Fixed a bug where an invalid widget
			was being referenced with 
			WIDGET_CONTROL and the /SHOW keyword.
	17 November 1993 - AB and SMR. Added ID validity checking to
			fix a bug where already dead widgets were being
			accessed.
	21 October 1994 - Scott Paswaters (NRL) added the ID optional param.

	@(#)xregistered2.pro	1.1 10/08/96 LASCO IDL LIBRARY


XREPORT $SSW/soho/gen/idl/util/xreport.pro
[Previous] [Next]
 Project     : SOHO - CDS

 Name        : XREPORT

 Purpose     : widget interface to anomaly database

 Category    : operations, widgets

 Explanation :

 Syntax      : IDL> XREPORT

 Inputs      : None

 Opt. Inputs : TSTART, TEND = start and end times to view (any format)

 Outputs     : 

 Opt. Outputs: None

 Keywords    : GROUP = widget ID of any calling widget
               MODAL = set to freeze calling widget

 CALLS: ***
	ANYTIM2TAI, ANYTIM2UTC [1], ANYTIM2UTC [2], CHECK_ANOMALY, CHKLOG [1], CHKLOG [2]
	CONCAT_DIR [1], CONCAT_DIR [2], CONCAT_DIR [3], CW_FIELD, DATATYPE [1]
	DATATYPE [2], DATATYPE [3], DEL_ANOMALY, DPRINT, EXIST, FREE_POINTER, GET_CALLER
	GET_ENVIRON, GET_POINTER, GET_SOHO_INST, GET_UTC, HAVE_WIDGETS [1]
	HAVE_WIDGETS [2], LIST_ANOMALY, MAKE_POINTER, MKLOG, MK_DFONT, PICKFILE, PICK_TIMES
	PRG_ANOMALY, REP_TAG_VALUE, SET_POINTER, STR2FILE, STRPAD, TAI2UTC, TEST_OPEN
	TEXT_ANOMALY, UTC2TAI, XACK, XALIVE, XANSWER, XKILL, XMAIL, XMANAGER, XMENU [1], XMENU [2]
	XPRINT [1], XPRINT [2], XPRINT [3], XPRINT [4], XPRINT [5], XREALIZE, XREPORT_CLEAN
	XREPORT_EDIT, XREPORT_EVENT, XREPORT_LIST, XSHOW, XTEXT_RESET, XVALIDATE
	concat_dir [4]
 Common      : XREPORT,CSTART,CEND -- last report times

 Restrictions: None.

 Side effects: None.

 History     : Version 1,  21-Dec-1995,  D.M. Zarro.  Written

 Contact     : DZARRO@SOLAR.STANFORD.EDU


XREPORT_EDIT $SSW/soho/gen/idl/util/xreport_edit.pro
[Previous] [Next]
 Project     : SOHO - CDS

 Name        : XREPORT_EDIT

 Purpose     : widget interface to add/edit entry in anomaly database

 Category    : operations,widgets

 Explanation : widget interface to add/edit entry in anomaly database

 Syntax      : IDL> XREPORT_EDIT,ID

 Inputs      : ID = anomaly ID to edit (-1 signals new ID to add)

 Opt. Inputs : 

 Outputs     : ID = new ID number (if added)

 Opt. Outputs: None

 Keywords    : GROUP = widget ID of any calling widget
               MODAL = set to freeze calling widget

 CALLS: ***
	ADD_ANOMALY, ANYTIM2UTC [1], ANYTIM2UTC [2], CHECK_ANOMALY, CONCAT_DIR [1]
	CONCAT_DIR [2], CONCAT_DIR [3], CW_BSELECTOR2, CW_FIELD, DATATYPE [1]
	DATATYPE [2], DATATYPE [3], DEF_ANOMALY, EXIST, FREE_POINTER, GET_ANOMALY
	GET_POINTER, GET_SOHO_INST, GET_UTC, HAVE_WIDGETS [1], HAVE_WIDGETS [2]
	MAKE_POINTER, MATCH_STRUCT, MK_DFONT, PICKFILE, REM_TAG [1], REM_TAG [2]
	REP_TAG_VALUE, SET_POINTER, STR2FILE, STR2LINES, STRPAD, TEXT_ANOMALY, TRIM, UTC2TAI
	XACK, XALIVE, XANSWER, XCALENDAR, XKILL, XMAIL, XMANAGER, XPRINT [1], XPRINT [2]
	XPRINT [3], XPRINT [4], XPRINT [5], XREALIZE, XREPORT_BUTT, XREPORT_CHECK
	XREPORT_EDIT_EVENT, XREPORT_FILL, XSHOW, XTEXT, XTEXT_RESET, concat_dir [4]
 CALLED BY:
	XREPORT
 Common      : None

 Restrictions: None

 Side effects: None

 History     : Version 1,  20-Dec-1995,  D.M. Zarro.  Written

 Contact     : DZARRO@SOLAR.STANFORD.EDU


XSEL_LIST [2] $SSW/soho/sumer/idl/newtki/tki/xsel_list.pro
[Previous] [Next]
 PROJECT:
       SOHO - CDS

 NAME:
       XSEL_LIST()

 PURPOSE:
       To select one item from a list.

 EXPLANATION:

 CALLING SEQUENCE:
       Result = XSEL_LIST(options)

 INPUTS:
       OPTIONS -- String array that contains the lists.

 OPTIONAL INPUTS:
       TITLE=TITLE, Title of the widget. Default: 'XSET_LIST'

 OUTPUTS:
       RESULT -- Selected item (one of elements from the LISTS
                 array). A null string is returned if no selection is
                 made.

 OPTIONAL OUTPUTS:
       None.

 KEYWORD PARAMETERS:
       INDEX   - Return index of the selected item
                 otherwise the content of the selected item.
       UPDATE  - Set this keyword to make selection widget editable and any
                 new entries will be added to the given OPTIONS upon exit
       INITIAL - Initial selection
       STATUS  - 1/0 if Accept/Cancel is chosen
       SENSITIVECASE - Set this keyword to treat the list case sensitive
       NO_REMOVE - Set this keyword will prevent the "Remove" button
                   from showing
       LFONT   - Name of font to be used in the list widget

 CALLS: ***
	DATATYPE [1], DATATYPE [2], DATATYPE [3], FREE_POINTER, GET_CALLER, GET_POINTER
	GREP, MAKE_POINTER, MK_DFONT, POPUP_MSG, REP_TAG_VALUE, SET_POINTER, STRPAD, TRIM
	UNIQ [1], UNIQ [2], UNIQ [3], XALIVE, XKILL, XMANAGER, XMANAGER_RESET, XREALIZE
	XSEL_GET_SELECT, XSEL_LIST_EVENT, XTEXT_RESET
 CALLED BY:
	EIS_IMAGE_TOOL [1], EIS_IMAGE_TOOL [2], FILE_SEARCHER [1], FILE_SEARCHER [2]
	IMAGE_TOOL, MK_CDS_PLAN, MK_SOHO, XSEL_PRINTER, XSPECT, hsi_ui_flarecat
 COMMON BLOCKS:
       None.

 RESTRICTIONS:
       None.

 SIDE EFFECTS:
       The given input parameter OPTIONS may be changed if UPDATE keyword is
       set

 CATEGORY:
       Utility, widget

 PREVIOUS HISTORY:
       Written September 20, 1994, by Liyun Wang, NASA/GSFC

 MODIFICATION HISTORY:
       Version 1, Liyun Wang, NASA/GSFC, September 20, 1994
       Version 2, Liyun Wang, NASA/GSFC, May 19, 1995
          Added UPDATE, INITIAL, and STATUS keywords
          Added a "Remove" button
          Got rid of common block
       Version 3, November 20, 1995, Liyun Wang, NASA/GSFC
          Fixed a bug that did not update the selected item to the list
       Version 4, December 5, 1995, Liyun Wang, NASA/GSFC
          Added SENSITIVECASE keyword
       Version 5, January 25, 1996, Liyun Wang, NASA/GSFC
          Added NO_REMOVE keyword
       Version 6, February 15, 1996, Liyun Wang, NASA/GSFC
          Xresource option disabled for IDL version 3.5 and earlier
       Version 7, February 22, 1996, Zarro, NASA/GSFC
          Changed to use of pointers
       Version 8, April 4, 1996, Liyun Wang, NASA/GSFC
          Added LFONT keyword
       Version 9, June 13, 1996, Liyun Wang, NASA/GSFC
          Fixed a bug caused by grepping string arrays
       Version 10, Jan 13, 1997, Zarro, NASA/GSFC
          Fixed a bug in which LFONT was not being passed
       Version 11, May 23, 1997, Liyun Wang, NASA/GSFC
          Fixed a bug which, when INDEX keyword is set and Cancel is
             selected, returns a string instead of a numerical -1
       Version 12, June 13, 1997, Zarro, NASA/GSFC
          Trimmed and sorted options list

 VERSION:
       Version 12


XSEL_MAIN_EVENT $SSW/soho/sumer/idl/contrib/chae/xsel_main_event.pro
[Previous] [Next]

                                        
   NAME:
     XSEL_MAIN_EVENT
   PURPOSE:
     Responses to main events in XSELECT_SUMER      
   CALLING SEQUENCE:
     XSEL_MAIN_EVENT, event
   INPUTS:
     EVENT = a structure variable for an event 
   OUTPUTS:
     None
 CALLS: ***
	XSEL_PD_EVENT
   COMMON BLOCKS:
     XSELECT_SUMER_BLOCK
   SIDE EFFECTS:
     Change parameters defined in common blocks 
   REQUIRED SUBROUTINES:
     None: 
   MODIFICATION HISTORY
     March 1997    Jongchul Chae   


XSEL_PD_EVENT $SSW/soho/sumer/idl/contrib/chae/xsel_pd_event.pro
[Previous] [Next]

                                        
   NAME:
     XSEL_PD_EVENT
   PURPOSE:
     Responses to pull-down events in XSELECT_SUMER      
   CALLING SEQUENCE:
     XSEL_PD_EVENT, event
   INPUTS:
     EVENT = a structure variable for an event 
   OUTPUTS:
     None
 CALLS: ***
	CONCAT_DIR [1], CONCAT_DIR [2], CONCAT_DIR [3], HEADFITS [1], HEADFITS [2]
	HEADFITS [3], MK_SUMER_CAT, PICKFILE, SUMER_FULL_FILENAME, XDISPLAYFILE [1]
	XDISPLAYFILE [2], XRASTER [1], XRASTER [2], concat_dir [4], slog_get_day [1]
	slog_get_day [2], slog_get_time [1], slog_get_time [2], slog_rdlog [1]
	slog_rdlog [2]
 CALLED BY:
	XSEL_MAIN_EVENT
   COMMON BLOCKS:
     XSELECT_SUMER_BLOCK
   SIDE EFFECTS:
     Change parameters defined in common blocks 
   REQUIRED NON-STADNARD SUBROUTINES:
     XRASTER           MK_SUMER_CAT  LOCATE_DIR
     HEADFITS          BREAK_PATH
     SLOG_RDLOG   SLOG_GET_DAY  SLOG_GET_TIME
   RESTRICTIONS :
     SUMER log files should exist in the specified directory   
   MODIFICATION HISTORY
     March 1997    Jongchul Chae   


XSELECT_EIT $SSW/soho/lasco/idl/nrleit/display/xselect_eit.pro
[Previous] [Next]
 Project     : SOHO - CDS / CHIANTI     
                   
 Name        : XSELECT_EIT
               
 Purpose     : Force the user to select from a list or abort.
               
 Explanation : A menu with the supplied options is generated, as
		well as a DONE-button (to signal completion of the selection)
		and a QUIT-button (to signal abortion of the selection).
               
		Menus can be either nonexclusive or exclusive.
		A default selection can be supplied.

 Use         : XSELECT,OPTIONS,STATUS,ABORT (all 3 parameters needed)
    
 Inputs      : OPTIONS:
			A text array containing the possible selections.

		STATUS:	An integer array containing the default selection,
			STATUS( i ) eq 1 signifies that OPTION( i ) is
			selected by default. Must have same dimensions as
                       OPTIONS parameter.
               
 Opt. Inputs : None.
               
 Outputs     : STATUS:	The resulting selection array. OPTION( i ) eq 1
			signifies selection of option no. i.

		ABORT:	Set to 1 if the user aborted the selection.
               
 Opt. Outputs: None.
               
 Keywords    : TITLE:	String with the title of the window with the menu.
			(default: 'Select options below')
		
		QUIT:	String with the text to go on the QUIT button.
			(default: 'Quit')

		DONE:	String with the text to go on the DONE button.
			(default: 'Done')

		GROUP_LEADER:
			Standard Xmanager/Widget meaning.

		X/YOFFSET: The position of the upper left corner of the
			new base.

		EXCLUSIVE/
		NONEXCLUSIVE:
			The type of base showing the selection buttons.
			Default: NONEXCLUSIVE

		MODAL:	Set to make the selection widget modal. 
			See Side effects.

 Calls       : ***
	DATATYPE [1], DATATYPE [2], DATATYPE [3], XMANAGER, XMENU [1], XMENU [2]
	XSELECT_EIT_EVENT
 Common      : XSELECT
               
 Restrictions: None.
               
 Side effects: The use of the MODAL keyword causes all widget
		DRAW windows to be blanked out.... Might be fixed
		in later versions of IDL...? (Depending on whether
		they see it as a bug or a feature :-)
               
 Category    : CDS, QuickLook, General
               
 Prev. Hist. : None.

 Written     : Stein Vidar Hagfors Haugan, 18 November 1993
               
 Modified    : SVHH, Version 1.5, 3 June 1994
			Added MODAL and X/YOFFSET keywords.
		PB,   Version 1.6, 24 Aug 1994  
		        Changed button 'Done' to 'Continue'
               CDP,  Upgraded header info and set default xoffset 
                     and yoffset.  14-Feb-95
               Ken Dere, made list scrollable  Sept 1996

 Version     : Version 2, 14-Feb-95


XSELECT_SUMER $SSW/soho/sumer/idl/contrib/chae/xselect_sumer.pro
[Previous] [Next]

   NAME :
          XSELECT_SUMER   
   PURPOSE:
          Widget-based Search for SUMER fits files
   CALLING SEQUENCE: 
          XSELECT_SUMER, filelist, catalog
   INPUTS :
          None
   OUTPUTS :
          FILELIST :  an array of file names
          CATALOG  :  an array of strings for basic information
         
   KEYWORDS :
          None
   COMMON BLOCKS
          XSELECT_SUMER_BLOCK
   RESTRICTICTION :
          SUMER log files should exist in the specified directory
   REQUIRED SUNBROUTINES:
          XSEL_MAIN_EVENT       XSEL_PD_EVENT
   MODIFICATION HISTORY
          March 1997     Jongchul Chae                 
 CALLS:


xselect_sumer_block $SSW/soho/sumer/idl/contrib/chae/xselect_sumer_block.pro
[Previous] [Next]

 
   common xselect_sumer_block,  $
        logdir,fits_kind, year, month, day1, day2, time1, time2, $ 
        xcen1, xcen2, ycen1, ycen2, wl1, wl2, $
        object, pop, seq_type, slit, detector, $
        exposure1, exposure2, catalog, $
        scientist,studyname, $
        files, file, text10,list20, done,logdir_field


xset_chain [1] $SSW/soho/mdi/idl/ops/xset_chains.pro
[Previous] [Next]
NAME:
	xset_chain
PURPOSE:
	To allow a user to build a "set_chain.src" file for MDI observing
SAMPLE CALLING SEQUENCE:
	xset_chains
	xset_chains, charsize=8
 CALLS: ***
	ARR2STR [1], Arr2Str [2], BREAK_FILE [1], BREAK_FILE [2], BREAK_FILE [3]
	CHECK_FILES_OK, CONCAT_DIR [1], CONCAT_DIR [2], CONCAT_DIR [3], CONGRID [1]
	CONGRID [2], CONGRID [3], CW_PDMENU, DECODE_TRANS_OBS, EVENT_NAME, FILE_EXIST [2]
	FMT_DURATION, GET_WVALUE, GO_MK_SIMP_CAM, OPSDB_ADD_ENTRY, OPSDB_CFL_UTIL
	OPSDB_CHECK_CODE, OPSDB_CONF_CHK, OPSDB_FIX_PROB1, OPSDB_FIX_PROB2
	OPSDB_FMT_REG_IPS, OPSDB_FUDGE_OBS, OPSDB_GET_ADDR, OPSDB_GET_ID, OPSDB_GET_INFO
	OPSDB_GET_STRUCT, OPSDB_INIT_SRC_FIL, OPSDB_LATEST_VER, OPSDB_MK_CAM_SRC
	OPSDB_MK_IPL_IN, OPSDB_MK_IPS_SRC, OPSDB_MK_IPVEC_SRC, OPSDB_MK_OBS_SRC
	OPSDB_MK_REG_IPS, OPSDB_MK_RELOAD, OPSDB_MK_SIMP_CAM, OPSDB_MK_TAB_SRC
	OPSDB_MOVE_FILE, OPSDB_NEW_TUNING, OPSDB_PATCHUP_INFO, OPSDB_PRINT
	OPSDB_PROBLEM_WRT, OPSDB_PROC_LST, OPSDB_RD_ADDR_FILE, OPSDB_RD_WRT
	OPSDB_RM_ENTRY, OPSDB_TEST_LST, SSW_FILE_DELETE, STR2ARR [1], STR2ARR [2]
	UNIQ [1], UNIQ [2], UNIQ [3], XMANAGER, XMENU [1], XMENU [2], XSET_CHAINS
	XSET_CHAINS_EVENT, anytim2ex [1], anytim2ex [2], anytim2ints [1]
	anytim2ints [2], break_file [4], concat_dir [4], curdir [1], curdir [2]
	data_type [1], data_type [2], ex2fid [1], ex2fid [2], file_append [1]
	file_append [2], file_exist [1], file_exist [3], file_list [1], file_list [2]
	fmt_tim [1], fmt_tim [2], get_host [1], get_host [2], get_user [1], get_user [2]
	get_xfont [1], get_xfont [2], int2secarr [1], int2secarr [2], list_tfi, mapx [1]
	mapx [2], mk_dpc_image, opsdb_uobs2obs, prstr [1], prstr [2], rd_tfile [1]
	rd_tfile [2], read_mdi, rem_elem [1], rem_elem [2], remtab [1], remtab [2]
	restgen [1], restgen [2], savegen [1], savegen [2], str2html [1], str2html [2]
	str2html [3], str_copy, str_replace [1], str_replace [2], tbeep [1], tbeep [2]
	tbeep [3], ut_time [1], ut_time [2], wc_where [1], wc_where [2], where_arr [1]
	where_arr [2], wmenu_sel [1], wmenu_sel [2]
HISTORY:
	Created 23-Aug-96 by M.Morrison
	26-Aug-96 (MDM) - Corrected the missing "0x" for the .src file
	28-Aug-96 (MDM) - Added offset setting option
			- Modified output filename to have the year/month
			- Showed the list of offset entries used 
	 2-Dec-96 (MDM) - Changed default font size from 12 to 6
	 4-Dec-96 (CED) - Split the chains menus in half; changed default
			  font size to 9.


xset_chain [2] $SSW/soho/mdi/idl/ops/xset_chainsandnew.pro
[Previous] [Next]
NAME:
	xset_chain
PURPOSE:
	To allow a user to build a "set_chain.src" file for MDI observing
SAMPLE CALLING SEQUENCE:
	xset_chains
	xset_chains, charsize=8
 CALLS: ***
	ARR2STR [1], Arr2Str [2], BREAK_FILE [1], BREAK_FILE [2], BREAK_FILE [3]
	CHECK_FILES_OK, CONCAT_DIR [1], CONCAT_DIR [2], CONCAT_DIR [3], CONGRID [1]
	CONGRID [2], CONGRID [3], CW_PDMENU, DECODE_TRANS_OBS, EVENT_NAME, FILE_EXIST [2]
	FMT_DURATION, GET_WVALUE, GO_MK_SIMP_CAM, OPSDB_ADD_ENTRY, OPSDB_CFL_UTIL
	OPSDB_CHECK_CODE, OPSDB_CONF_CHK, OPSDB_FIX_PROB1, OPSDB_FIX_PROB2
	OPSDB_FMT_REG_IPS, OPSDB_FUDGE_OBS, OPSDB_GET_ADDR, OPSDB_GET_ID, OPSDB_GET_INFO
	OPSDB_GET_STRUCT, OPSDB_INIT_SRC_FIL, OPSDB_LATEST_VER, OPSDB_MK_CAM_SRC
	OPSDB_MK_IPL_IN, OPSDB_MK_IPS_SRC, OPSDB_MK_IPVEC_SRC, OPSDB_MK_OBS_SRC
	OPSDB_MK_REG_IPS, OPSDB_MK_RELOAD, OPSDB_MK_SIMP_CAM, OPSDB_MK_TAB_SRC
	OPSDB_MOVE_FILE, OPSDB_NEW_TUNING, OPSDB_PATCHUP_INFO, OPSDB_PRINT
	OPSDB_PROBLEM_WRT, OPSDB_PROC_LST, OPSDB_RD_ADDR_FILE, OPSDB_RD_WRT
	OPSDB_RM_ENTRY, OPSDB_TEST_LST, SSW_FILE_DELETE, STR2ARR [1], STR2ARR [2]
	UNIQ [1], UNIQ [2], UNIQ [3], XMANAGER, XMENU [1], XMENU [2], XSET_CHAINSANDNEW
	XSET_CHAINS_EVENT, anytim2ex [1], anytim2ex [2], anytim2ints [1]
	anytim2ints [2], break_file [4], concat_dir [4], curdir [1], curdir [2]
	data_type [1], data_type [2], ex2fid [1], ex2fid [2], file_append [1]
	file_append [2], file_exist [1], file_exist [3], file_list [1], file_list [2]
	fmt_tim [1], fmt_tim [2], get_host [1], get_host [2], get_user [1], get_user [2]
	get_xfont [1], get_xfont [2], int2secarr [1], int2secarr [2], list_tfi, mapx [1]
	mapx [2], mk_dpc_image, opsdb_uobs2obs, prstr [1], prstr [2], rd_tfile [1]
	rd_tfile [2], read_mdi, rem_elem [1], rem_elem [2], remtab [1], remtab [2]
	restgen [1], restgen [2], savegen [1], savegen [2], str2html [1], str2html [2]
	str2html [3], str_copy, str_replace [1], str_replace [2], tbeep [1], tbeep [2]
	tbeep [3], ut_time [1], ut_time [2], wc_where [1], wc_where [2], where_arr [1]
	where_arr [2], wmenu_sel [1], wmenu_sel [2]
HISTORY:
	Created 23-Aug-96 by M.Morrison
	26-Aug-96 (MDM) - Corrected the missing "0x" for the .src file
	28-Aug-96 (MDM) - Added offset setting option
			- Modified output filename to have the year/month
			- Showed the list of offset entries used 
	 2-Dec-96 (MDM) - Changed default font size from 12 to 6
	 4-Dec-96 (CED) - Split the chains menus in half; changed default
			  font size to 9.


XSHOW_RASTER $SSW/soho/cds/idl/util/ops/planning/xshow_raster.pro
[Previous] [Next]
 Project     :	SOHO - CDS

 Name        :	XSHOW_RASTER

 Purpose     : Widget display of CDS rasters 

 Use         : xshow_raster,raster

 Inputs      : None.

 Opt. Inputs : None.

 Outputs     : RASTER = structure with primary raster information for
                        last selected primary raster.
               VRASTER = stucture with raster variation information for
                        last selected raster variation

 Opt. Outputs: None.

 Keywords    :
              GROUP    = event id of widget that calls xshow_raster
              DET      = 'N' or 'G' to filter out NIS or GIS detector rasters
              IRASTER  = input primary raster
 Explanation :
              Arranges structures in a matrix format with the tag
              name in label widget and the tag value in a text widget.
              If wbase and wtags exist, then widget is just updated
              with input field values.

 Calls       : ***
	DATATYPE [1], DATATYPE [2], DATATYPE [3], GET_CALLER, HAVE_WIDGETS [1]
	HAVE_WIDGETS [2], LIST_F_RASTER, LIST_V_RASTER, MK_DFONT, XALIVE, XHIDE, XKILL
	XMANAGER, XSHOW_RASTER_EVENT, XSTRUCT
 CALLED BY:
	FREEZE_RAS_DUR
 Common      : xshow_raster = contains private widget id's

 Restrictions: None.

 Side effects: None.

 Category    : Widgets

 Prev. Hist. : None.

 Written     :	Version 1, Zarro (ARC/GSFC) 23 August 1994

 Modified    : Version 1.1, Zarro (ARC/GSFC) 24 August 1994
               Added raster variation widget.
               Version 2 , Zarro (ARC/GSFC) 10 September 1994
               Added optional input primary raster IRASTER
		Version 3, William Thompson, GSFC, 5 July 1996
			Add RAS_ID to widget list

 Version     : Version 3, 5 July 1996


XSPECT $SSW/soho/sumer/idl/contrib/germerott/xspect/xspect.pro
[Previous] [Next]
 PROJECT:
       SOHO - CDS/SUMER

 NAME:
       XSPECT

 PURPOSE:
       Widget program to display SUMER spectrum and detector

 CATEGORY:
       Planning

 SYNTAX:
       xspect

 INPUTS:
       None required.

 OPTIONAL INPUTS:
       None.

 OUTPUTS:
       None.

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS:
       None.

 CALLS: ***
	CW_LOADCT, DELVARX [1], DELVARX [2], DELVARX [3], DELVARX [4], FIND_WITH_DEF [1]
	FIND_WITH_DEF [2], FIND_WITH_DEF [3], GREP, LOADCT, MK_DFONT, PCONVERT, PRESTORE
	PSTORE, SET_LINE_COLOR, STRPAD, SUM_GET_LINELIST, TKI_DET_RANGE, TKI_DISPERSE
	TKI_GRAPH_STC, TKI_LAMBDA11, TKI_NEXT_LAMBDA, WHICH_LINE [1], WHICH_LINE [2]
	XKILL, XMANAGER, XRECORDER, XREGISTERED, XSEL_LIST [1], XSEL_LIST [2], XSPECT_EVENT
	XSPECT_IMG, XSPECT_SETSUMPAR, XSPECT_SET_REF, XSPECT_SET_WAVEL, delvarx [5]
 COMMON:
       @tki_common_share

 RESTRICTIONS:
       None.

 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, May 20, 1997, Liyun Wang, NASA/GSFC. Written
       Version 1.1, June 4, 1997, Liyun Wang, NASA/GSFC
          Added feature of positioning an identified line at any
             place on the detector
          Added indicator of the reference pixel position
          Displayed the iluminated part of the detector for a given slit
       Version 1.2, June 12, 1997, Liyun Wang, NASA/GSFC
          Speed up the plot of spectrum image on the detector
       Version 1.3, July 3, 1997, Liyun Wang, NASA/GSFC
          Added display of the 2nd order spectral region and
             identified lines
          Display limits set appropriately for selected detector
       Version 2.0, February 11, 1998, Dietmar Germerott, MPAE Lindau
          Modified Variable WAVEL to WAVEL_VAL - name conflict
          on SUMER machines in Lindau 

 CONTACT:
       Liyun Wang, NASA/GSFC (Liyun.Wang.1@gsfc.nasa.gov)


XSPECT_SETSUMPAR $SSW/soho/sumer/idl/newtki/tki/xspect_setsumpar.pro
[Previous] [Next]
 PROJECT:
       SOHO - SUMER

 NAME:
       XSPECT_SETSUMPAR

 PURPOSE: 
       Setup SUMER Parameters in sum_spec_com COMMON Block

 CATEGORY:
       SUMER/Simulator
 
 EXPLANATION:
       This Procedure reads in the SUMER Global Parameters
       out of TKI_GLOBAL/globalparam_act.dat
       and sets up some Values of them for global scope in
       sum_spec_com COMMON Block
       
 SYNTAX: 
       xspect_setsumpar 

 CALLED BY:
	XSPECT
 EXAMPLES:
       xspect_setsumpar 

 INPUTS:
       None.

 OPTIONAL INPUTS: 
       None.

 OUTPUTS:
       None.

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS: 
       show - display set variables in sum_spec_com

 CALLS: ***
	CONCAT_DIR [1], CONCAT_DIR [2], CONCAT_DIR [3], TEST_OPEN, TKI_READGLOPAR
	concat_dir [4]
 COMMON:
       @tki_common_priv
       @xspect_com_share
   
 RESTRICTIONS: 
       Uses TKI_READGLOPAR
       Environment Vairable (LOGICAL) TKI_GLOBAL
       GLOBALPARAM_ACT.DAT has to be in Directory TKI_GLOBAL

 SIDE EFFECTS:
       Setup of @tki_common_priv to Default

 HISTORY:
       Version 1, July 2, 1997, Dietmar Germerott, MAPE Lindau. Written
       Version 2, November 11, 1998, Dietmar Germerott, MPAE Lindau
             added detector sensitive global parameter loading
 CONTACT:
       Dietmar Germerott, MAPE Lindau (germerott@linax1.mpae.gwdg.de)


XSTARTHT $SSW/soho/lasco/idl/movie/xstartht.pro
[Previous] [Next]
 NAME:
	XSTARTHT

 PURPOSE:
	This procedure is used to start the CME measurements

 CATEGORY:
	CME

 CALLING SEQUENCE:
	XSTARTHT

 INPUTS:

 OPTIONAL INPUT PARAMETERS:

 OUTPUTS:

 OPTIONAL OUTPUT PARAMETERS:

 CALLS: ***
	CW_FORM, PICKFILE, STR_SEP, XMANAGER, XREGISTERED, XSTARTHT_EV
 COMMON BLOCKS:
	com_xstartht
	com_height_time

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

 RESTRICTIONS:

 PROCEDURE:

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

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


xstep_uevent [2] $SSW/soho/mdi/idl_old/gen/ys_util/xstep_uevent.pro
[Previous] [Next]
   Name: xstep_uevent
   
   Purpose: handle events in xstepper utility window 

   History: slf - 30-April-92

 CALLS: ***
	EVENT_NAME, GET_WUVALUE, mapx [1], mapx [2]
   Common Blocks:
      xstepper_blk


xstepper [2] $SSW/soho/mdi/idl_old/gen/ys_util/xstepper.pro
[Previous] [Next]
 NAME:  xstepper

 PURPOSE: Widget interface/ X-Windows data cube reviewer  

 INPUT PARAMETERS (positional):
     	cube - image or image cube
	info - strarray of image information         

 OPTIONAL INPUT PARAMETERS (keyword):
	title 	    - widget title (default=XSTEPPER)
	xsize/ysize - if present, rebin will be done  
       noscale     - if set, turns off tvscl 
	subscripts   - indices of images to display (default=all)
	interp      - if set, rebin uses interp (default=sample)
	start       - Index of starting image	
	info_array  - strarray of image info (for stepper compatibility)
		      may be passed as optional 2nd positional param

 Calling Sequence:
   xstepper,data [,info_array , xsize=xsize, ysize=ysize, /interp ,
		   ,start=start, /noscale]

 Button Layout:

 ------------------------------------------------------------------------
| QUIT | FWRD>> | <<BWRD | Movie | Freeze | AZoom-OFF | Wrap | XLOADCT   | 
 ------------------------------------------------------------------------
| HELP | IMG->SS | IMG->PIX | DATA->PIX | SS->PIX | RST-SS | RST-PIX     |   
 ------------------------------------------------------------------------
| Display:  <>DATA  <>DATA(SS)  <>PIXMAP    Title-Image: <> OFF          | 
 ------------------------------------------------------------------------

Button Description:

   --------------------------------------------------------------------------
   QUIT 	- exits xstepper
   FWRD>>	- steps forward 1 image (sets movie direction to forward)
   <<BWRD	- steps backward 1 image (sets movie direction to backward)
   Movie	- starts movie mode 
   Freeze	- stops movie mode
   AZoom-OFF   - toggles between Auto Zoom Off and Auto Zoom On modes
   Wrap        - toggles between wrap around and auto reverse modes 
   XLOADCT 	- runx XLOADCT
   --------------------------------------------------------------------------
   HELP	- displays text information about currently selected images
   IMG->SS	- places current image into SS vector and advances display
   IMG->PIX	- places current image in a pixmap 
   DATA->PIX   - places entire data array into pixmap array (memory caution)
   SS->PIX     - places DATA(SS) into pixmap array
   RST-SS	- Reset (initialize) SS vector
   RST-PIX     - Reset (initialize) PIXMAP array
   --------------------------------------------------------------------------
   Display:      (select from three categories of image display)
      DATA	- Original data cube
      DATA(SS) _ Subset of data cube ( Data(*,*,ss))
      PIXMAP   - Offscreen Pixmaps (allows fast frame rates on most machines)
   Title-Image:- Toggles On/Off information written to window area
   --------------------------------------------------------------------------

   Other Features:
      clicking on image automatically opens a second window and displays
      a zoomed copy of the current image - this second window allows selection
      of zoom factors - clicking on zoom window will hide it.  If the display
      selection is DATA or DATA(SS), then the zoom window may automatically 
      track (single step or movie mode) and auto zoom if AZoom-ON is chosen
      (auto zoom does not work while in PIXMAP display mode)
      Image information is displayed to the text portion of the widget
   

 CALLED BY:
	SDC_VERIFY, eit_fulldisk, lasteit
 Side Effects: widget(s) is displayed to X terminal

 CALLS: ***
	MAKE_STR [1], MAKE_STR [2], XMANAGER, XMENU2, XREGISTERED, def_font [1]
	def_font [2], mapx [1], mapx [2], update_image
 Common Blocks: 
      xstepper_blk     - (xstepper parameters, direction,rebin,etc)
      sda_draw_private - (utility window info (zoom, etc)


 Restrictions: - only one instance may be run at a time due to common

 HISTORY: slf 30-Apr-92 (based on stepper/multi_draw (browse)
	   slf  5-Jun-92  (PIXMAP / SS features)
	   slf 18-Jun-92  (interface , wrap/autoreverse) 
	   slf 19-Oct-92  (documentation) 
          slf 22-Feb-93  (Version 3.0 mods, added backopt to common, cleanup)
	   slf 12-sep-93  (added curwind to common - xspr compatible)
	   slf 25-oct-93  (made internal slecected SS relative to input subscripts)


xstepper_event $SSW/soho/mdi/idl_old/gen/ys_util/xstepper_event.pro
[Previous] [Next]
   Name: xstepper_event

   Purpose: event handler for xstepper

   History: slf, 30-April-1992 - prototype
	     (based on sda_look.pro, circa oct,91)

 CALLS: ***
	EVENT_NAME, GET_WVALUE, UPDATE_PIXIMG, XBACKREGISTER, XLOADCT [1], XLOADCT [2]
	XLOADCT [3], XMANAGER, XMENU2, ZOOM_SINGLE [1], ZOOM_SINGLE [2], ZOOM_SINGLE [3]
	force_evt [1], force_evt [2], mapx [1], mapx [2], stepper_title [1]
	stepper_title [2], update_image, xstepper_status
   Common Blocks:
      sda_draw_private
      xstepper_blk

   History - 30-april-92 (see xtepper.pro documentation)
	      19-oct-92   (fixed IMG->SS bug)
             22-feb-93   (cleaned up backregister logic for V3.0)
	      29-Jun-93   (allow scale/noscale for pixmaps)
			  (reset pixmaps on QUIT (X-management))
	      13-Oct-93   fix zoom_single call bug
	      18-Nov-93 (SLF) Dont write title on PIXAP if title is off


xstepper_status $SSW/soho/mdi/idl_old/gen/ys_util/xstepper_status.pro
[Previous] [Next]
   Name: xstepper_status

   Purpose: provide text description of common area variables

   Keyword Parameters:
      file - if set, output to text file
 CALLED BY
	xspr [1], xspr [2], xstepper_event


XSTUDY $SSW/soho/cds/idl/util/ops/planning/xstudy.pro
[Previous] [Next]
 Project     :	SOHO - CDS

 Name        :	XSTUDY

 Purpose     : Widget interface to CDS database catalog

 Explanation : None

 Use         : XSTUDY

 Inputs      : None.

 Opt. Inputs : None.

 Outputs     : None.

 Opt. Outputs: STUDY = study selected from within widget

 Keywords    : GROUP = widget ID of calling program
               SELECT = permit selection of studies
               RELIST = relist fundamental study list each time
               NOWARN = turn of warning for multiple XCAMP copies

 Calls       : ***
	CHK_DIR [1], CHK_DIR [2], CW_BSELECTOR2, CW_FIELD, DATATYPE [1], DATATYPE [2]
	DATATYPE [3], DELVARX [1], DELVARX [2], DELVARX [3], DELVARX [4], EXIST
	EXPORT_STUDY, FIND_CDS_STUDY, FIND_ZDBASE, FIX_ZDBASE, GET_CALLER, GET_CDS_RASTER
	GET_CDS_STUDY, GET_DATAWIN, GET_HANDLER_ID, GET_LINELIST, HAVE_WIDGETS [1]
	HAVE_WIDGETS [2], IMPORT_STUDY, MK_DFONT, PICKFILE, RASTER_SIZE, REM_TAG [1]
	REM_TAG [2], REP_TAG_VALUE, SEC2DHMS, SELECT_WINDOWS, STRPAD, STUDY_BRIEF
	TAG_EXIST [1], TAG_EXIST [2], TEST_OPEN, TRIM, WHICH_ZDBASE, WIDG_HELP, XACK, XALIVE
	XCDS_BOOK, XHIDE, XINPUT, XKILL, XLIST, XMANAGER, XMANAGER_RESET, XMENU [1], XMENU [2]
	XREGISTERED, XSHOW, XSTRUCT, XSTUDY_EVENT, XSTUDY_FLIST, XSTUDY_FSEARCH
	XSTUDY_RESET, XSTUDY_RLIST, XSTUDY_UPDATE, XSTUDY_VLIST, XSTUDY_VSEARCH, XTEXT
	XTEXT_RESET, ZONE_DEF_LABEL, delvarx [5]
 CALLED BY:
	FREEZE_RAS_DUR, MK_CDS_PLAN, MK_STUDY, XCAT
 Common      : XSTUDY_COM

 Restrictions: None.

 Side effects: None.

 Category    : Widgets, planning

 Prev. Hist. : None.

 Written     :	August 1, 1994, DMZ (ARC)

 Version     : Version 1.0


xsw2tree $SSW/soho/mdi/idl_old/gen/ys_util/xsw2tree.pro
[Previous] [Next]
   Name: xsw2tree

   Purpose: generate script to move files within tree via widget

   Input Parameters:
      files - optional list of files to move (if no keyword input used)

   Optional Keyword Parameters:
      indir  - directory to use for input files 
      infile - file containing list of files  
      paths  - data path array (destination paths)
		if not defined, use !path array
		if 1 element, assume it is a rd_tfile compat file of paths
      outfile - name of script (default=$DIR_SITE_SCRIPT/xsw2tree.USER
	         (destination path list =$DIR_SITE_SCRIPT/xsw2tree.USER_dpaths 
      ucon    - if set, use ucon directory for input files
      older_than - in conjunction with indir, only files older than this many days
		    are considered for action (default=15 days)

   Calling Sequence:
      xsw2tree,indir=indir [,older=ndays]  ; input files from specified path
      xsw2tree, [/bcs,/sxt,/gen,/hxt,/wbs] ; input files from specified atest
      xsw2tree, /ucon			    ; input files from users ucon area

 CALLS: ***
	CONCAT_DIR [1], CONCAT_DIR [2], CONCAT_DIR [3], FILE_EXIST [2], GET_WUVALUE
	STR2ARR [1], STR2ARR [2], XMANAGER, XMENU [1], XMENU [2], concat_dir [4], dir_since
	file_append [1], file_append [2], file_exist [1], file_exist [3], get_host [1]
	get_host [2], get_user [1], get_user [2], mapx [1], mapx [2], rd_tfile [1]
	rd_tfile [2], tbeep [1], tbeep [2], tbeep [3], wc_where [1], wc_where [2]
	xswlist [1], xswlist [2]
 CALLED BY:
	xsw2tree_event, xswlist [2]
   History:
      27-Oct-1993 (SLF) Written (supplements atest2tree)
      31-Oct-1993 (SLF) Mods (document, file age, file delete, etc)


xswlist [1] $SSW/soho/mdi/idl_old/gen/ys_util/xswlist.pro
[Previous] [Next]
   Name: xswlist

   Purpose: 

 CALLS: ***
	XMENU [1], XMENU [2]
 CALLED BY:
	xsw2tree, xsw2tree_event
   History: 
      SLF - ~15-nov-93
      SLF -  19-Jul-94 - reduced fperpage


XTKI $SSW/soho/sumer/idl/newtki/tki/xtki.pro
[Previous] [Next]
 PROJECT:
       SOHO - SUMER

 NAME:
       XTKI

 PURPOSE: 
       Widget interface to TKI simulator

 CATEGORY:
       Widget, SUMER simulator
 
 SYNTAX: 
       xtki

 INPUTS:
       None.

 OPTIONAL INPUTS: 
       None.

 OUTPUTS:
       None.

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS: 
       None.

 CALLS: ***
	BREAK_FILE [1], BREAK_FILE [2], BREAK_FILE [3], CONCAT_DIR [1], CONCAT_DIR [2]
	CONCAT_DIR [3], DATATYPE [1], DATATYPE [2], DATATYPE [3], GET_COMPILED_TKI
	GET_UDP_HEAD, MK_DFONT, PICKFILE2, RD_ASCII2, SHOW_STRUCT, TAG_EXIST [1]
	TAG_EXIST [2], TEST_OPEN, TKI_CALL_PAR, TKI_CHKIT, TKI_CMD_FUNC, TKI_EVAL
	TKI_FIND_CMD, TKI_GRAPH_STC, TKI_LAMBDA11, TKI_MESSAGE, TKI_PHOTO_BASE
	TKI_SCAN_PAR, TKI_SCL2OBJ, TKI_TCMD, WIDG_HELP, XACK, XMANAGER, XTEXT, XTKI_CMD_EXE
	XTKI_EVENT, XTKI_WREFRESH, break_file [4], concat_dir [4]
 COMMON:
       @xtki_com

 RESTRICTIONS: 
       None.

 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, September 23, 1996, Liyun Wang, NASA/GSFC. Written
       Version 2, November 10, 1998, Dietmar Germerott, MPAE Lindau
           modified detection of current set detector
       Version 3, November 11, 1998, Dietmar Germerott, MPAE Lindau
           added detector sensitive global parameter loading
       Version 4, June 1, 1999, Dietmar Germerott, MPAE Lindau
           correct SendImage,GetImageMax
           added print for detector window
 CONTACT:
       Dietmar Germerott, MPAE Lindau (Germerott@linmpi.mpg.de)


XTKI_CMD_EXE $SSW/soho/sumer/idl/newtki/tki/xtki_cmd_exe.pro
[Previous] [Next]
 PROJECT:
       SOHO - SUMER

 NAME:
       XTKI_CMD_EXE

 PURPOSE: 
       Execute the Cmd String

 CATEGORY:
       
 
 EXPLANATION:
       
 SYNTAX: 
       xtki_cmd_exe, 

 CALLED BY:
	XTKI
 EXAMPLES:
       
 INPUTS:
       wid - Structure of Window IDs

 OPTIONAL INPUTS: 
       None.

 OUTPUTS:
       None.

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS: 
       None.

 CALLS: ***
	TKI_EVAL, TKI_LAMBDA11, TKI_PARSE, TKI_TCMD
 COMMON:
       @xtki_com   
       @tki_common_share

 RESTRICTIONS: 
       None.

 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, October 24, 1996, Dietmar Germerott, MAPE Lindau. Written
       Version 1.1, July 3, 1997, Dietmar Germerott, MAPE Lindau
           renamed tki_show_lam to tki_lambda11   

 CONTACT:
       Dietmar Germerott, MAPE Lindau (germerott@linax1.mpae.gwdg.de)


XTKI_COM $SSW/soho/sumer/idl/newtki/tki/xtki_com.pro
[Previous] [Next]
 PROJECT:
       SOHO - SUMER

 NAME:
       XTKI_COM

 PURPOSE: 
       Common Variables for XTKI

 CATEGORY:
       
 
 EXPLANATION:
       
 SYNTAX: 
       @xtki_com

 EXAMPLES:
       
 INPUTS:
       None.

 OPTIONAL INPUTS: 
       None.

 OUTPUTS:
       None.

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS: 
       None.

 COMMON:
       None.

 RESTRICTIONS: 
       None.

 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, November 2, 1996, Dietmar Germerott, MAPE Lindau. Written

 CONTACT:
       Dietmar Germerott, MAPE Lindau (germerott@linax1.mpae.gwdg.de)


XVALIDL $SSW/soho/lasco/idl/display/xvalidl.pro
[Previous] [Next]
 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)

 CALLED BY:
	WCALCL, WCURRENT, WIMG_INFO3
 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)


XVAREDT $SSW/soho/lasco/idl/display/xvaredt.pro
[Previous] [Next]
 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.
 CALLS: ***
	ADDEDTENTRY, XMANAGER, XPDMENU, XREGISTERED, XVAREDTFIELD, XVAREDT_EV
 CALLED BY:
	WIC, WIMG_INFO3, WTIME_HEIGHT
 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


XWIN [2] $SSW/soho/mdi/idl_old/gen/ssw_lib/xwin.pro
[Previous] [Next]
 Project     : SOHO - CDS

 Name        : XWIN

 Purpose     : Switch to X-windows mode.

 Explanation : SETPLOT is called to save and set the system variables.

 Use         : XWIN

 Inputs      : None.

 Opt. Inputs : None.

 Outputs     : A message is printed to the screen.

 Opt. Outputs: None.

 Keywords    : None.

 Calls       : ***
	SETPLOT [1], SETPLOT [2]
 CALLED BY:
	GET_OFF2, RIG_AL
 Common      : None.  But calls SETPLOT, which uses common block PLOTFILE.

 Restrictions: It is best if the routines TEK, REGIS, etc. (i.e.  those
		routines that use SETPLOT) are used to change the plotting
		device.

		In general, the SERTS graphics devices routines use the special
		system variables !BCOLOR and !ASPECT.  These system variables
		are defined in the procedure DEVICELIB.  It is suggested that
		the command DEVICELIB be placed in the user's IDL_STARTUP file.

 Side effects: If not the first time this routine is called, then system
		variables that affect plotting are reset to previous values.

 Category    : Utilities, Devices.

 Prev. Hist. : William Thompson

 Written     : William Thompson, GSFC.

 Modified    : Version 1, William Thompson, GSFC, 27 April 1993.
			Incorporated into CDS library.
		Version 2, William Thompson, GSFC, 21 October 1993.
			Renamed to XWIN.

 Version     : Version 2, 21 October 1993.


xwin [3] $SSW/soho/mdi/idl_old/gen/ys_util/xwin.pro
[Previous] [Next]
   Name: xwin

   Purpose: make X window  (interface to IDL window procedure)

   Input Parameters
      xsize - defaults to 512
      ysize - defaults to xsize
      
   Optional Keyword Parameters
      n - window number - defaults to 0
      r - retain keyword - defaults to 1 (see IDL reference for details)

 CALLS:
 CALLED BY
	GET_OFF2, RIG_AL


xwrite_hist $SSW/soho/mdi/idl/egse/xwrite_hist.pro
[Previous] [Next]
NAME:
	xwrite_hist
PURPOSE:
	To accept user inputs to be logged to the EGSE history file
SAMPLE CALLING SEQUENCE:
	xwrite_hist
 CALLS: ***
	CONCAT_DIR [1], CONCAT_DIR [2], CONCAT_DIR [3], EVENT_NAME, GET_WVALUE, XMANAGER
	XMENU [1], XMENU [2], XWRITE_HIST_EVENT, anytim2ex [1], anytim2ex [2]
	concat_dir [4], ex2fid [1], ex2fid [2], file_append [1], file_append [2]
	get_xfont [1], get_xfont [2]
HISTORY:
	Created 15-Sep-95 by M.Morrison
	 2-Dec-95 (MDM) - had a time stamp also placed in the ASCII temp file
	 2-Dec-95 (MDM) - Added a /NOHIST option to disable the writting to the
			  history file.


xy2pzt $SSW/soho/mdi/idl/cal/xy2pzt.pro
[Previous] [Next]
NAME:
       xy2pzt
PURPOSE:
       calculates necessary PZT offsets for desired image motion 
INPUT:
       [delta-X,delta-Y]= desired IMAGE motion (FD PIXELS)
OPTIONAL KEYWORD INPUT:
       calmode: values for calmode are calculated if this switch is set.
		NOTE: THIS FACTOR IS NOT CONFIRMED, THEREFORE IS APPROXIMATE!
OUTPUT:
       function returns [PZT-A,PZT-B,PZT-C] properly rounded; intarr(3)
SAMPLE CALLING SEQUENCE:
       offsets=xy2pzt([1.2,-0.5])
HISTORY:
       Written 16-Apr-96 by I.Zayer


XY_BILIN $SSW/soho/lasco/idl/display/xy_bilin.pro
[Previous] [Next]
 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
 CALLED BY:
	T_CARTES, T_POLAR
 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


xy_raster [2] $SSW/soho/mdi/idl_old/gen/ys_util/xy_raster.pro
[Previous] [Next]
 NAME:
       xy_raster 
 PURPOSE:
	To make a raster pattern of a time series of SXT images
	to display time evolution of something or other.
	The images start at upper left and go to lower right,
	and the formatted time is optionally written at the bottom of each
	image.
 CALLING SEQUENCE:
	xy_raster, index, data
	xy_raster, index, data, 3, ss=ss, /individual_scale
	xy_raster, index, data, 0.5, /notimes, /noscale
 INPUTS:
	index	- The index structure
	data	- The data array
 OPTIONAL INPUTS:
	factor	- The rebin factor (factor = 2 to double the size).  The
		  default is same size (=1)
 OPTIONAL KEYWORD INPUTS:
	noscale	- If set, do not scale the data cube (use TV 
		  instead of TVSCL)
		  Default is to auto scale on the whole cube, so that
		  the intensities relative to each image is maintained.
	individual_scale - If set, then use TVSCL on each individual image.
		  Default is to auto scale on the whole cube, so that
		  the intensities relative to each image is maintained.
	ss	- A list of the subscripts of the images to display
	notimes	- If set, then do not display the times
	xsiz	- The xsize of the window (default = 800).  This is only
		  used if the data cube requires multiple pages
	ysiz	- The ysize of the window (default = 800).  This is only
		  used if the data cube requires multiple pages.  If 
		  xsiz is specified, and ysiz is not, then xsiz is used.
	charsize- The character size for the time label
 COMMENTS:
	This routine opens IDL window 10 with the right size and 
	writes to it.
 CALLS: ***
	CONGRID [1], CONGRID [2], CONGRID [3], data_type [1], data_type [2], gt_time [1]
	gt_time [2]
 HISTORY:
	HSH, written some time in early 1992
	HSH, May 3, 1992, modified to handle odd-size images and 
	  to trap obese windows
	MDM,  3-Sep-93, Modified to calculate number of panels properly
	MDM, 20-Dec-93	- Modified significantly, more robust
			- Reverse data,index calling sequence
	MDM,  2-Sep-94  - Added conditional on when to print statement
			  "XY_RASTER: Cube will not fit on one page...."
	MDM,  6-Sep-94  - Corrected error which would not all "SS"
			  option to work.


XZOOM_PLAN $SSW/soho/gen/idl/plan/science/xzoom_plan.pro
[Previous] [Next]
 Project     :	SOHO - CDS

 Name        :	XZOOM_PLAN

 Purpose     :	zoom in on plot window

 Explanation : 

 Use         :	XZOOM_PLAN

 Inputs      : None.

 Opt. Inputs : None.

 Outputs     :	INFO =  {T1 : widget ID of start time widget
                        T2 : widget ID of end time widget
                        TSTART: start time
                        TSTOP : stop time
                        TDUR : duration of MOVE or COPY
                        TBASE: main base ID}
 Opt. Outputs:	None.

 Keywords    : GROUP=      group leader
               MESSENGER = widget ID to communicate with external event
                           handler (must have valid child)
               MOVE = ZOOM application to be used as a MOVE
               COPY = ZOOM application to be used as a COPY
               DEL =  ZOOM application to be used as a DELETE

 CALLS: ***
	ADD_TAG [1], ADD_TAG [2], ANYTIM2UTC [1], ANYTIM2UTC [2], CW_BSELECTOR2, CW_FIELD
	DATATYPE [1], DATATYPE [2], DATATYPE [3], EXIST, FREE_POINTER, GET_CALLER
	GET_POINTER, HAVE_WIDGETS [1], HAVE_WIDGETS [2], MAKE_POINTER, MK_DFONT
	SET_POINTER, STRPAD, TAI2UTC, TRIM, UTC2TAI, XACK, XALIVE, XKILL, XMANAGER, XMANAGER_RESET
	XSHOW, XTEXT_RESET, XVALIDATE, XZOOM_PLAN_EVENT
 CALLED BY:
	MK_CDS_PLAN
 Common      :	None.

 Restrictions:	None.

 Side effects:	None.

 Category    :	Planning

 Prev. Hist. :	None.

 Written     :	Dominic Zarro (ARC)

 Version     :	May 31, 1996