Varosi code AstroContrib Library

The following is a listing of the entire contents of this library for IDL. Click on an individual procedure name to view its header and source code. This listing is a shortened form of the much longer entire library help file. This may be handy for text searchs, be beware that some of these are huge and may take a long time to load or even crash your browser.

[Go Back to Main Search Page]

List of Routines

• ADD_NEW_MOSAIC Add new averaged/spliced mosaic to the common block of mosaics, also creates a default entry in the mosaic_specs structure array.
• ALIGN_IMAGES select a group of images and align them at the points of selection. Frank Varosi NASA/GSFC 1989 F.V. 1991, added wait,0.1 in SELECT Loop to avoid duplicate cursor reads. F.V. 1991, added define_origin at alignment point.
• ALIGN_MOSAICS select mosaic images and align them at the points of selection.
• ALLOWED_TRANS Determine which bound-bound transitions between Levels of different energies are allowed (radiative), according to quantum LS rules.
• ANALYSIS_ADDMOS Add a mosaic image to the math-mosaic List structure, and apply any required rotation and/or geometric scaling.
• ANALYSIS_DUPMOS Frank Varosi NASA/Goddard 1992
• ANALYSIS_SELECT Select mosaic images for Math_mosaics & Analysis. Frank Varosi NASA/Goddard 1991.
• ANALYSIS_TASK Process button events which are user requests to display, analyze, store/Load, etc..., the image data aquired. This is the next event handler routine, called by Analyze_Event for additional generic processing.
• ANALYZE_CURSOR Check if cursor is in either the image or subimage window, and if so, display the cursor Location and pixel value. This routine is called in "timer" mode when the cursor-pixel label widget generates a timer event.
• ANALYZE_FLUXSET Set fluxes at 2 points in stack of mosaic images, for comparing (mosaic math) different wavelengths, or averaging mosaics of same wavelength.
• ANALYZE_IMAGE Create a widget to interactively control/execute the display & analysis of images obtained from MAMA or CCD detector integrations.
• ANALYZE_MARKSET Define marks in overlap of mosaic images. For use by the compute equation option of analyze mosaics (mosaic math). The defined marks will appear in computed image. Marks can also be transferred to/from the separate mosaic images.
• ANALYZE_MOSAICS Interactively create a mosaic of arbitrary size images (called "mosaic" images, which are created in pro mosaic) and: compute algebraic expression involving fluxes in overlayed pixels, (after appropriately scaling fluxes in the images), or compute average of the mosaic. Can also just arrange a collection of images for deconvolution of mosaic & PSF image pairs, or modeling the IR spectrum at each pixel with heated dust emission and line-of-sight absorption.
• APPLY_FACTORS Match image names and apply factors & offsets of old_images to new_images. CALLING EXAMPLE: apply_factors, old_images, new_images, /REDISPLAY
• APPROX_XSECS Create a widget to approximate a cross-section by interactively selecting points for piece-wise Linear interpolation. Events are handled by pro Approx_Xsecs_Ev. State of widget is stored in user value so multiple instances can be running simultaneously. Called by Build_BFree_Tr which is called by Modion_Event (pro modion).
• APPROX_XSEC_CUR Process cursor events of draw widget in Approx_Xsecs widget. Left button = insert a point into approximate cross-section, right button = delete nearest point. Called by pro Approx_Xsecs_Ev (in file approx_xsecs.pro).
• APXSEC_HARDCOPY Create hardcopy of the graph of currently selected cross-section with approximation points overplotted.
• AVERAGE_IMAGES Average the images in raw_mosaic and return the averaged_mosaic image.
• AVERAGE_MOSAICS Average a raw-mosaic of mosaics into one big mosaic image.
• BORDER_IMAGES Display border of selected images in respective window. Interactive mode: Left button to select images, middle/right button to quit. Automatic mode: image #'s specified by INUMS or /ALL are bordered.
• BORDER_NOISE Determine standard deviation and mean of border pixels in CCD image.
• BUILD_BB_TRANS Build the array of bound-bound transitions between selected Levels, between selected single energy Levels and SuperLevels, and between all SuperLevel combinations.
• BUILD_BFREE_TR Build bound-free transitions from selected energy Levels to the ionization continuum by creating an approximate/simplified photo-ionization cross-section for each selected Level. Accomplished interactively with the widget: Approx_Xsecs.
• BUILD_BFSUP_TR Build bound-free transitions for SuperLevels by first merging the photo-ionization cross-sections for Levels in each group (if not already done). Then an approximate/simplified photo-ionization cross-section is created/modified for each SuperLevel, interactively with the widget: Approx_Xsecs.
• CALC_EFFICS Compute efficiency of a grating using List of flux measurements.
• CALC_IM_STACK Compute an algebraic expression (entered by user) involving the intersection regions of a stack of mosaic images.
• CANCEL_XSEC Cancel the new approximate cross-section in the widget state structure. Stop events from the draw widget (x-sec plot) and start accepting events from the energy level list widget. Called by pro Approx_Xsecs_Ev (in file approx_xsecs.pro).
• CENTROID_IMAGES Select images containing the same star (maximum bright source), and automatically find the centroids of the maxima in selected images Align the images at centroids, if requested. Returns structure array containing centroid information.
• CHECK_IMSCALED check the scaled image if just central subset of image is to be displayed, (so unsmoothed borders are not displayed when image is smoothed). Frank Varosi NASA/GSFC 1991.
• CHECK_MAG_FACT code written by Frank Varosi NASA/GSFC 1989. F.V.1990, mod to handle case when image data is not in structure, just sizes. F.V.1991, mod to handle magnification < 1. F.V.1991, keyword /ALL_MAGS for when image data is not in structure. F.V.1992, keywords TAG_* to get flags about image data structure.
• CHECK_MENU_SIZE This is only needed for SunView on the Sun386i (when using Large wmenu font).
• CHECK_STRUCT Frank Varosi NASA/GSFC 1989.
• CHECK_SUBIMAGE Check for existence, save-status, or display of subimage. If needed, force appropriate event to occur. Called by Analyze_Event if EFFICIENCY/SCATTER measurement was selected.
• COMMIT_XSEC Copy the new approximate cross-section into the energy levels array. Interpolate/extrapolate the cross-section at the edge frequency. Stop events from the draw widget (x-sec plot) and start accepting events from the energy level list widget. Called by pro Approx_Xsecs_Ev.
• CONTOUR_AXES Draw the axes for pro contour_mosaic
• CONTOUR_CALIB Set fluxes at 2 points in mosaic image, then setting factor and offset fields in mosaic_spec structure.
• CONTOUR_COORDIN Setup up coordinate axes for contour/display of mosaic image. Called by pro contour_mosaic. CALLING EXAMPLE: contour_coordin, mosaic_spec, xcoor, xtit, xtickv, xticm, xtickLab, $ ycoor, ytit, ytickv, yticm, ytickLab
• CONTOUR_DRAW Draw the contours of image as requested in structure image_spec. (this is called by pro contour_mosaic)
• CONTOUR_INIT Setup constants and menu for pro contour_mosaic.
• CONTOUR_LEVELS Define contour Levels by calling function cursor_scale to get user input.
• CONTOUR_MARKS Draw the Marks (of sources) and Labels on contour-display of mosaic, as set interactively by pro contour_markset. CALLING EXAMPLE: contour_marks, posxy, identify, id2, IMAGE_SPEC=mosaic_spec
• CONTOUR_MARKSET Interactively set Marks (of sources) and Labels, which will appear on contour-display of image by pro contour_marks.
• CONTOUR_MARK_OP Perform sets and changes of source marks and Labels, for pro contour_markset.
• CONTOUR_MIN_MAX Frank Varosi NASA/GSFC 1992.
• CONTOUR_MOSAIC Display a mosaic-image with selectable/optional contours, coordinate axes (relative or absolute), titles, Labels, and marks. Options include: filtering, scaling, zooming, choosing Levels... Hardcopy in grey scale or pseudo-color (using PostScript).
• CONTOUR_OPTIONS Frank Varosi NASA/GSFC 1990. F.V.1992, separated contour specific options from pro display_options.
• CONTOUR_SCALING Frank Varosi NASA/GSFC 1991.
• CONTOUR_SETUP Setup mosaic image arrays for contour display.
• CONTOUR_TITLES Draw the Titles and subtitles for pro contour_mosaic
• CONV_ELEVS Convert energy levels from Rydberg units to wave-number/cm, and make them all positive relative to fundamental (minimum) level. Also returns structure with ionization energy and other info. Can be called just once after reading energy Levels from TOPBASE (routine will not apply converson twice).
• CONV_LOC_SLPE Convert cursor Location to SLP and Energy.
• COORDIN_RANGE Get the range of arc-sec coordinate system for raw mosaic structure. CALLING EXAMPLE: range = coordin_range( Raw_Mosaic, /IN_WINDOW )
• COPY_COORDIN Frank Varosi STX @ NASA/GSFC 1989. F.V. 1991, mod to use copy_struct_inx.
• CREATE_GROUP Frank Varosi STX @ NASA/GSFC 1989. F.V. 1991 put selection code into pick_images, and made into function returning group #.
• CREATE_MOSAIC Ask user about what & how to average/splice, then setup the call to function average_images( raw_mosaic, ... ) or function splice_images( raw_mosaic, ... ). and return mosaic_info: a record of what was averaged. CALLING EXAMPLE: mosaic = create_mosaic( raw_mosaic, mosaic_info, mtitle )
• CURSOR_COORDIN Display of coordinates as cursor is moved, and, when a mouse button is pressed, return cursor coordinates (curx,cury) (default is normalized), and also coordinates (cxscal,cyscal) shifted by CMIN & scaled by CSIZE, and rotated/zoomed if specified by ROTATE and ZOOM.
• CURSOR_INFO Display cursor Location in terms of SLP and Energy in status widget.
• DATE_TIME Convert integer day, month, year, hour, minutes, seconds, into strings.
• DECONV_IMAGES Interactively select image and PSF from a collection and then select and apply various deconvolution methods.
• DEFINE_ORIGIN Define origin of arc-second coordinate system for raw mosaic structure. Fields in structure giving relative arc-seconds are updated.
• DEFINE_STRUCT define all structures used in prep.pro and mosaic.pro , image_List1,2,3,4 , image_inven1,2 are same except for magnification factor of images to get scaled images for display. Frank Varosi NASA/GSFC 1989 F.V. 1991, added image_List0 for magnification 1/2.
• DEF_IMHD_STRUCT Define and return header structure containing info about MAMA image.
• DEF_STAT_STRUCT Define status block (structure) for receiving info. from -macq- To define short structure without the hot-spot array: mstat = def_stat_struct( ) To get FULL structure with hot-spot array, pass previously obtained status: mstat = def_stat_struct( mstat )
• DEVICE_AXES Return the device-axis structures for axes that are being used.
• DEV_POS_HEADER Copy device-axis information from structured array to FITS header.
• DEV_POS_STRUCT Recreate the device-axis structure array from FITS header info. Called by pro header_from_fits.
• DEV_SETUP_LOAD Restore from a file the saved structure variable(s) for particular GPIB device(s), and then command the device axes to move to the positions contained in structure.
• DEV_SETUP_SAVE Save the positions and all info contained in structure variable for a particular GPIB device, or devices, to a file. Filename always of form: "dev_setup." + dev_name.* , so that the last field identifies different setups for each device.
• DE_GULCH[1] Gulch effect caused by intense source in images will be removed by LLsq fitting of row thru source to rows away from source and subtracting fit to return flat fielded image. CALLING EXAMPLE: image_degulched = de_gulch( image, fit_coef, /INTER )
• DE_GULCH[2] Removal of stripes caused by channel gain differences, and interactive removal of gulch caused by intense point source in a mosaic image. Note: de-stripe should be performed first before de-gulch. BUG: must return & keep result of de-stripe before doing de-gulch.
• DE_GULCH_OLD Frank Varosi STX @ NASA/GSFC 1991 F.V. 1991, added interactive option (keyword /INT).
• DE_GULCH_SORT Estimate column pattern background in an image by sorting columns and then subtract the background to return flat fielded image. CALLING EXAMPLE: image_flat = de_gulch_sort( image, sky, MIN_SORT=9 )
• DE_STRIPE Reduce the even/odd channel amplifier variation (vertical stripes) by using Least squares fit to determine the 2nd order polynomial relation between adjacent channels. Frank Varosi STX @ NASA/GSFC 1991
• DE_STRIPE_1 Reduce the even/odd channel amplifier variation (vertical stripes) by using Least squares fit to determine the 2nd order polynomial relation between adjacent channels. Frank Varosi STX @ NASA/GSFC 1991
• DE_STRIPE_2 Eliminate the even/odd channel amplifier variation (vertical stripes) by averaging adjacent pixels (2x2 box-car smoothing), and then shifting image by -1/2 pixel to maintain original positions. Note that resolution is then degraded from 1x1 to 2x2 pixels. Frank Varosi STX @ NASA/GSFC 1992
• DE_STRIPE_3 Frank Varosi STX @ NASA/GSFC 1995
• DE_STRIPE_BIB Frank Varosi STX @ NASA/GSFC 1995
• DE_STRIPE_SPIRAC Frank Varosi STX @ NASA/GSFC 1995
• DISPLAY_ALL For the MODION widget: Display all energy levels, transitions and axes in draw widget windows. Usually called by pro Draw_Axes_Set_V of CW_Draw_Axes widget, when value is set by the Modion widget. Assumes that the draw widget windows are already erased.
• DISPLAY_ELEVS Display the Energy Levels obtained from TOPBASE (atomic database) as horizontal lines with color indicating status. Default is to display just Levels that have non-zero color.
• DISPLAY_IMAGES Display images from the List into specified window, with respective Locations as specified in structure, and stacked in the order given by their visibility Levels. CALLING EXAMPLE: display_images, image_List [ , image_pool, /RESIZE ]
• DISPLAY_INBAND Display the inband filter transmission & uniformity analysis results.
• DISPLAY_INBAND1 Display the inband filter transmission & uniformity analysis results.
• DISPLAY_MOSAIC display_mosaic, mosaic, mosaic_spec mosaic = 2D image array. mosaic_spec = structure with contour display specifications. Frank Varosi STX @ NASA/GSFC 1989.
• DISPLAY_MOSAICS Restore, Select, and Display mosaic images (or could be any images).
• DISPLAY_NEW For the MODION widget: Find the energy levels that are flagged as newly selected or modified and display them in the central draw widget window. Usually called by pro Draw_Axes_Set_V of CW_Draw_Axes widget, when value is set by the Modion widget.
• DISPLAY_OPTIONS Frank Varosi NASA/GSFC 1990.
• DISPLAY_REFRESH For the MODION widget: Refresh the display of energy levels and transitions in the main draw widget window. Usually called by pro Draw_Axes_Set_V of CW_Draw_Axes widget, when value is set by the Modion widget.
• DISPLAY_SUPLEVS Display the super-Levels created by user, as boxes around the merged energy Levels, and display group number at upper-right corner.
• DISPLAY_TRANS Display the allowed transitions between energy levels as selected.
• EDGE_IMSCALED check the scaled image if just central subset of image is to be displayed, (so unsmoothed edges are not displayed when image is smoothed), return the width of unsmoothed edge divided by Magnification, unless /MAGNIF. Frank Varosi NASA/GSFC 1991.
• EFFICIENCY Create a widget to control the analysis of grating efficiency data and then display/hardcopy the computed efficiency curves.
• ERROR_ANALYSIS Compute the expected relative error in tranmission images based on the estimated the error properties of original IN & OUT data.
• ERROR_INFO Define structure for storing error (noise) information and if image array is passed then estimate the error properties of image. Called by function headinfo to define the structures, and then used by function sig_ref.
• EXPORT_IMPORT Transfer (add/replace) images from PREProcess inventory structures to TOFU image_List (TUT_images) structures.
• FILTER_IMAGES Select and apply one of 4 filters to all or a subset of images in the collection (image_List, usually a raw mosaic). User has the option to replace images, or make new versions thereby keeping original images in the List.
• FILTER_MOSAIC Frank Varosi STX @ NASA/GSFC 1989. F.V.1991, modif to use mosaic_spec structure. F.V.1991, use filter_image to process ALL_PIXELS. F.V.1991, added "iterate" filter (applies smooth(3) iteratively). F.V.1992, use fields .maxF & .minF for min-max of filtered mosaic.
• FILTER_MOSAICS Select and apply one of 6 filters to all or a subset of images in the collection mosaic_List.
• FILT_RED reduce transmission data in IDL in loop above transreduc.pro revised: 14-june-96 TAN
• FILT_RED_ORIG reduce transmission data in IDL in loop above transreduc.pro revised: 14-june-96 TAN revised: 27 july 96 DAC -- bin to 129 by 129 hardwired
• FIND_DEVICES Clear and allocate the GPIB interface, get handles (for I/O) of the requested GPIB devices, and store handles and device names in a structured array (in common gpib, devices). If find_devices has been called previously, only the new devices are concatenated with the existing ones in common.
• FIND_IMAGES return image number(s) containing (x,y) in current window. Frank Varosi NASA/GSFC 1989 F.V. added option to require (x,y) to be interior of images, 1991.
• FIND_IMAGES_V return image number(s) containing (xv,yv) in current window, where (xv,yv) is an array of coordinates. Frank Varosi NASA/GSFC 1989
• FIND_LEVELS Find Levels within SLP and Energy values/range and return subscripts, if the Level colors are non-zero (if zero they are hidden).
• FIND_SUPLEV Find the nearest SuperLevel and if it is within distance specified by RESOLUTION keyword, return subscript.
• FIT_EFF The non-linear fitting procedure for the groove efficiency
• FLAT_FIELD Divide current extracted subimage by a flat-field image (normalized so that average = 1). Flat-field image is then kept in common for reuse.
• FOSC_APPROX Use Kramers semiclassical formula for hydrogenic atom to compute approximate oscillator strengths of atomic transitions. Note that the Gaunt factor is NOT included, but it is near unity for large quantum numbers and is 0.717 for the n = 2 -> 1 transition.
• GET_AXIS_NUM Get the number of an axis of GPIB device by specifying its name, i.e. the index in the array: devices(dev_num).axis
• GET_BY_ALIAS Get the device number and axis number of GPIB device, (i.e. the index in the array: devices(dev_num).axis(axis_num) ) by specifying the equivalent alias, which was defined by user.
• GET_CCD_IMAGE Copy the previously read CCD image from shared memory into IDL. All accomplished by calling shareable object C-code in ccdmem.so. Also check noise and offset in image borders, and place in header. Other relevant info, such as device positions, are returned in header.
• GET_CCD_STATUS Get the status info. from data acquisition program (ccdacq).
• GET_DEV_NUM Get the number of a GPIB device, the index in the array: devices.
• GET_EFFIC_DATA Compute the net flux (signal - background) per second in an image. Add the measurement and related info into array of structures which will be analyzed to determine efficiencies of gratings. Signal/Background region are first determined automatically, then user can accept the result or select new region & measurement.
• GET_IMAGE Get the image data from structures array or from array, when image_List points to it.
• GET_IMSCALED Get the scaled image for display from structures array or from array, when image_List points to it.
• GET_MACQ_STATUS Get the status info. from data-taking program (xmacq). get_macq_status, mstat mstat: the status structure variable.
• GET_MAMA_IMAGE Get the result of integration of data from the MAMA detector. This calls C-code to copy the image from shared memory, where the MAMA (x,y,t) data stream has been asynchronously collected and binned into pixels (by other C-code: xmacq). If image is only 16-bits, the "hot spot" (bad pixels of MAMA detector) is stored separately as 32-bits in status block by the xmacq process. If image is 32-bits, the "hot spot" is taken from the image and placed in the header. In either case, the hotspot in the image is set to zero first to get counts and maximum without hotspot, then is replaced with values limited to the thus obtained maximum.
• GET_SCAT_DATA Interactively extract scatter data from subimage. This routine creates the widgets, get_Scat_Event does the processing.
• GPIB_DEV_STRUCT Define and return the IDL structure array for GPIB devices.
• GROOV_EFF The theoretical function for fitting groove efficiency wave = wavelength in mm, it can be an array fltarr(n) rt(0) = maximum groove efficiency, fltarr(2) rt(1) = blazing angle in radius alpha0 = incident angle in radius wave0 = incident wavelength in mm
• HEADER_TO_FITS Copy info from structure header to FITS header
• HEADINFO Unpack additional items that were placed by CC200 pc control program from the numeric header left unused by Photometrics {see QuickBasic routine "Fillheader" in TUT}.
• HEAD_FROM_FITS Copy info from FITS header to structure header
• HEAD_PCNET head_pcnet Convert header records from DRO files (output of IROBSNET program) into IDL structure variable. header = head_pcnet( head_record, header ) head_record = Longword array, the image header record (128 longwords). header = structure variable to store header info, returned by func.
• HEAD_SIG_REF head_sig_ref Convert header records from DRO files (output of IROBS program) into IDL structure variable. header = head_sig_ref( head_record ) head_record = Longword array, the image header record (128 longwords). KEYWORDS:
• HISTOG_IMAGES Compute histograms of selected images and plot histograms on same scale. (results optionally returned in keywords: DENSITY= , VALUES= , INUMS= )
• IBCLEAR Calls the NI-488M program IBCLR to send selected device clear command.
• IBCMD Calls the NI-488M program IBCMD to send a command to a GPIB board.
• IBFIND Calls the NI-488M program IBFIND to get the device number of a particular GPIB device.
• IBPCT Calls the NI-488M program IBPCT to send the pass control signal.
• IBREAD Calls the NI-488M program IBRD to read data from a GPIB device.
• IBRSP Return the serial poll response byte from a GPIB device.
• IBSIC Calls the NI-488M program IBSIC to send the GPIB interface clear signal.
• IBWAIT Calls the NI-488M program IBWAIT.
• IBWRITE Calls the NI-488M program IBWRT to write data to a GPIB device.
• IB_ERROR_MESS Return the GPIB error message string.
• IMAGE_MATH_1 Subtract, add, multiply, or divide image_oper1.image into image_List(inums).image and return in new structured array. Called by prep/Sky_Sub_Gain.pro and lib/image_math_menu.pro.
• IMAGE_MATH_2 Subtract, add, multiply, or divide interpolated images into image_List(inums).image and return in new structured array. Interpolated images are computed between image_opers(0:1).image, using coordinates supplied by keywords TXIM= and TXOP= (it is assumed that TXIM coordinates are bracketed by TXOP). Called by prep/Sky_Sub_Gain.pro.
• IMAGE_MATH_MENU Menu and selection interface to function image_math_1. CALLING EXAMPLE: image_math_menu, image_List INPUT and OUTPUT: image_List = structured array containing images and specifications EXTERNAL CALLS: function image_math_1 function pick_images function select_image pro scale_images
• IMAGE_STRUCT Define and return an array of image structures, defined by size of image and function headinfo
• INBAND_AVSPEC Analyze a spectrum transmission vs. wavelength to produce specs Blue_50, Red_50, InBand_Transmission, Central_Wavelength, etc... Ringing is now calc. as max. abs. deviation from parabolic fit.
• INBAND_FSPECS Analyze a stack of transmission vs. wavelength images to produce specs Blue_50, Red_50, InBand_Transmission, Central_Wavelength, etc...
• INIT_DEVICES Clear GPIB and devices, initializes devices that require it, replicates the gpib handle to all other device structures.
• INTEGRATE_CCD Create widgets to interactively acquire the integration of data from the CCD detector. The integration time actually used can be set/changed. Assumes that the C-routines which read the CCD into shared memory are available. Pro Integ_CCD_Event processes the widget events, including reading the image from shared memory.
• INTEGRATE_MAMA Create widgets to interactively control (start/stop) the integration of data from the MAMA detector. The integration time can be selected by means of sliders, or entered. Assumes that the C-routines (xmacq) which asynchronously collect and bin the MAMA (x,y,t) data stream into shared memory image, are running. A status widget is set to generate events at regular intervals, then calling entries in external macmem.so to check the integration status. Pro IntegMama_event processes the widget events, including reading the image (binned data) from shared memory.
• INTEG_STATUS Check the progress of MAMA detector integration. If not finished, then reset the timer of the status (label) widget of the integrate MAMA widget to trigger another status check event for later.
• KAXIS_DISABLE Command a Klinger axis to disable/enable the holding torque.
• KLINGER_CONTROL Create widget interface (GUI) to control the Klinger device axes by means of sliders, text entry, and buttons.
• KLINGER_STATUS Get the status of a Klinger device & axis.
• KLINGER_WIDGET Create widget interface to control a particular Klinger device axis by means of sliders, text entry, and buttons.
• LASSO_IMAGES Allow user to pick images with rubber box to Lasso corners of images.
• LEVEL_INFO Called by pro Approx_Xsecs.
• LOAD_FITS_IMAGE Read an image from a FITS file by inquiring user via menu for which file to read, and then add it to the pool of mosaic images.
• LOAD_IMAGE Read header & image of MAMA data from a FITS file. The FITS type of header info is placed into structure header.
• LOOK_IMAGES Look at the average/total flux in a box/circular aperature interactively chosen by mouse, intersecting a stack/mosaic of images. Mean and st.dev. of fluxes in aperature are printed or plotted as a spectrum with optional error bars. Type and size of aperature is chosen from menus, press Left button to select box/circle, right button to quit, middle button can be pressed anytime to get menu again.
• LOOK_MOSAIC Select box interactively and print average flux of mosaic image in box.
• MAGNIFY_IMAGES Copy image_List to a new structure and magnify the byte-scaled images. Since IMSCALED is different size, must handle it separately: going from magnification 1 we can use IDL rebin, going from other magnification it is faster to rescale and rebin. Because of bug previous to IDL v.2.0.11 concerning sub-structure with strings, must handle INFO tag separately in such case on Sun386i.
• MAGNIFY_INVEN copy image_inven to new structure and magnify the scaled for display images. since IMSCALED is different size, must handle it separately: going from magnification 1 can use IDL rebin, going from other magnification it is faster to rescale and rebin. since INFO is a sub-structure with strings, must handle it separately (because of bug previous to IDL v.2.0.11)
• MAGNIFY_MOSAICS mosaic_List = structure array to keep track of it all (input/output). mosaic_images = original mosaic image data (input). mosaic_imscaled = mosaics scaled for displaying (output). Frank Varosi NASA/Goddard 1990-91.
• MAKE_RAW_MOSAIC To package a collection of images (all the same size) into a Raw_Mosaic structure, suitable for use in the MOSAIC system. This should be called at the main IDL level and must use the variable name "raw_mosaic" as in the calling example. Then the MOSAIC software will operate on this raw_mosaic variable. Note that once the raw_mosaic structure is created with given image size, you cannot change the image size of the structure without exiting and reentering IDL, and you cannot save/restore a mixture of structure sizes simultaneously (a limitation which may be eliminated soon).
• MAP_CCD_MEM Map to shared memory of ccdacq (CCD data-acquisition program)
• MAP_MACQ_MEM Map to shared memory of xmacq (MAMA data-acquisition program)
• MAP_SOURCE_MARKS Map the source marks to a particular mosaic image_spec using the relative arcsecond offsets in the source marks structure.
• MATCH_APPLY Frank Varosi STX @ NASA/GSFC 1989. F.V. 1991, mod to keep scaling type at current setting.
• MATCH_GROUPS match intensities of images in a group with those of another group. Frank Varosi NASA/GSFC 1989
• MATCH_GRP_LLSQ match intensities of images in groups using Linear Least-squares of overlapping pixels from the mosaic group averages. Frank Varosi NASA/GSFC 1989
• MATCH_HISTOGRAM Match intensities of images using Linear transformations obtained interactively by comparing Histograms of corresponding regions/overlap.
• MATCH_IMAGES Match intensities of overlapping images using Linear transformations.
• MATCH_INTERP match_interp match_interp, raw_mosaic, inums, Factors, Offsets raw_mosaic = KEYWORDS: /FACTOR_MATCH /OFFSET_MATCH
• MATCH_LEVELS Frank Varosi NASA/GSFC 1990.
• MATCH_LINEARLSQ match Levels of images using Linear Least-squares of overlapping pixels. Frank Varosi NASA/GSFC 1989 F.V.1991, mod to using smoothing before LLsq fit. F.V.1991, added option to Pop images while selecting image to fix. F.V.1991, changed smoothing to ALL_PIXELS using filter_image. F.V.1992, use /ITERATE (approx.gaussian) when smoothing using filter_image.
• MATCH_MEAN_VARI Match Levels of images by matching the means & variances of pixels in the overlapping part of images. User selects an image to keep fixed, the reference for matching others.
• MATCH_MOSAICS Match intensities of overlapping mosaics using Linear transformations.
• MATCH_MOS_APPLY Frank Varosi NASA/GSFC 1991 (adapted from match_undo images).
• MATCH_MOS_UNDO Frank Varosi STX @ NASA/GSFC 1991 (adapted from match_undo images).
• MATCH_SKY_IMAGE Frank Varosi NASA/GSFC 1990.
• MATCH_TWOPOINT Match intensities of images based on mean-values of pixels in boxes at 2 selected points. The 2 values are then used to define Linear/Affine transformations. Frank Varosi NASA/GSFC 1989 F.V. 1991, mod to using smoothing before LLsq fit. F.V. 1991, added option to Pop images while selecting image to fix.
• MATCH_UNDO Frank Varosi STX @ NASA/GSFC 1989. F.V. 1991, mod to keep scaling type at current setting.
• MERGE_IMAGES Merge two image List structure arrays, making them same magnification.
• MERGE_INVEN Merge two image inventory structure arrays, making them same magnification and organized in matrix display format.
• MERGE_XSECS Merge the photo-ionization cross-sections for Levels in given SuperLevel group. First x-secs are interpolated (in Log-Log space) onto common frequency grid and then summed using statistical weighting.
• MINMAX_IMAGES Compute mins & maxes using median and/or smooth filtered versions of images. Keyword INUMS=subscripts to select images. Frank Varosi NASA/GSFC 1992.
• MIN_MAX_SET Recompute mins & maxes using median and/or smooth filtered versions of images. Frank Varosi NASA/GSFC 1991. F.V. 1991, added arg. image_data so it works for {Mosaic_List} structures, as well as {Image_List} structures. F.V. 1991, added keyword INUMS=subscripts to select images. F.V. 1992, added /SIGMA_FILTER option.
• MODEL_EFFICS Fit measured grating groove efficiency as a function of wavelength to determine the blazing angle and maxmum groove efficiency. It uses a non-linear least-squares fitting procedure CURVEFIT. A reference for the fitting function can be found in "Echelle Efficiency and Blaze Characteristics" by M. Bottema, in SPIE Vol 240 page 171.
• MODION Create a widget to interactively model an ion/atom. Creates compound draw widgets for displaying the energy level diagram and its axes of SLP and Energy. Data can be read from TOPBASE files, energy levels are displayed, a subset of levels can be selected, transitions and info can be written to files for use in stellar radiative transfer models. Events are handled by pro Modion_Event.
• MODION_CURSOR Process cursor motion/button events of draw widget in modion widget. Called by pro Modion_Event. If selection mode is off, just display the SLP and Energy of cursor position. Otherwise, select/unselect the nearest energy level in diagram if mouse button is clicked, or if button is held down, draw a box in order to select an area of energy level diagram.
• MODION_HARDCOPY Create hardcopy of current ion/atom model Grotrian diagram.
• MODION_HOMEVIEW Erase the draw widgets, set view to (0,0), set zoom factor to unity and redisplay everything.
• MODION_RESTORE Restore work from an IDL-XDR file. User can pick file from a List. Called by pro Modion_Event.
• MODION_SAVE Save current work to an IDL-XDR file. User is prompted for filename.
• MODION_SETFILE Set the filename of the IDL-XDR file in which current modion structure variables are stored, and display the widget info label with filename.
• MODION_STATUS Display status informational message for the MODION widget, and also print the info in the IDL "message" style to standard output.
• MONOCHROM_CNTRL Create widget interface to control the MonoChromator & Filter-wheel by means of sliders and buttons.
• MOSAIC Create a Raw Mosaic out of collection of images (all same size).
• MOSAIC_COORDIN Select an image (LEFT button) and re-Locate it (LEFT or MIDDLE button) while displaying relative coordinates as cursor is moved: ( x-horizontal, y-vertical ) arcseconds offsets.
• MOSAIC_CORRELS Choose and call specific methods to automatically create raw mosaics of images by using maximal cross-correlation to determine optimal image offsets.
• MOSAIC_CORREL_1 Automatically create mosaic of images by computing cross-correlation functions and finding optimal position from maximum cross-correlation. User selects one image to be the start of mosaic (the anchor) to which other user selected images are cross-correlated and moved.
• MOSAIC_CORREL_2 Refine the mosaic of images by computing correlation functions. (not yet completly finished) Frank Varosi STX @ NASA/GSFC 1991
• MOSAIC_CORRTIME Automatically create mosaic of images by computing cross-correlation functions and finding optimal position from maximum cross-correlation for images which are adjacent in time ordering. If time info is not available in structure then ordered by sorting the name of images. User can select which images (or all) are to be correlated and moved.
• MOSAIC_IMAGES Select and drag an image to new location, then push behind all others. Frank Varosi NASA/GSFC 1989 F.V. Jan-91, added option to Pop images with middle button. F.V. Apr-91, mod to exclude unsmoothed border when displaying images. F.V. Apr-91, mod to keep cursor at point selected while moving image. F.V. Jul-91, mod to update arcsec coordinates of image after move.
• MOSAIC_MAIN Main program for calling: Prep
• MOSAIC_OFFSETS Specify new locations of images by entering (x,y) arcsec offsets. CALLING EXAMPLE: mosaic_offsets, image_List, FILE_OFFSETS="file_offs"
• MOSAIC_OPTIONS "ignore": BEGIN menu = ["Width of border to neglect ?",string(indgen(10))] sel = wmenu( menu, INIT=2, TITLE=0 ) > 1 border_ignore = sel-1 print," width of ignored border = ", strtrim( border_ignore,2 )
• MOSAIC_SETUP Do NOT modify this file! This file should be linked to: ~/mosaic/setup.pro so that it is automatically executed by ~/idl/idl_startup.pro (need: setenv IDL_STARTUP ~/idl/idl_startup.pro). Copy and put any desired modifications and variable settings in: ~/mosaic/setup_user.pro, which is invoked at end of this IDL script.
• MOSAIC_STRUCT Define structures used in MOSAIC routines (display_mosaics, contour_mosaic, analyze_mosaics, etc...) and return array have requested type of structure.
• MOSAIC_TASK Perform tasks commonly requested by MOSAIC & PREP & ANALYZE, by routing request to other procedures and function.
• MOVE_DEVICE Command a GPIB device-axis to move to new position.
• MOVE_FILTER Command the Filter Wheel (part of Acton MonoChromator) to move to a new position.
• MOVE_GROUP Interactively Move a group of images by specifying From & To cursor locations. (group is predefined in structure array image_List).
• MOVE_IMAGE Select and Drag an image (blinking) with mouse to a new Location. Select image by clicking LEFT button, drag by moving mouse, drop image at new location with LEFT or MIDDLE button, put back image to original location with RIGHT button. Otherwise, use MIDDLE button to pop images, or RIGHT button to quit.
• MOVE_KLINGER Command a Klinger axis to move to new position, or reset the origin to current position, or find the origin.
• MOVE_MONOCHROM Command a monochromator axis (part of Acton Vacuum MonoChromator) to move to new position.
• MOVE_UNIDEX Command a Unidex axis to move to new position, or reset the origin to current position, or find the origin.
• NEAREST_MARK Find the nearest mark (of sources or Labels) to the position input.
• OPTICON Main program to call the other widgets, such as Klinger and MonoChromator control, MAMA/CCD integration...
• OPTICON_SETUP ; Do NOT modify this file! ; Note: modifications will be erased upon installing new version of opticon. ; Copy and put user specific modifications in: ~/opticon/setup_user.pro ; which is invoked at the end of this IDL command file. ; FILE: ~/opticon/code/opticon_setup.pro ; Do NOT modify this file!
• ORDER_IMAGES Set the Levels of images to be ordered with wavelength or max value, so stack of images will be displayed in wavelength/max order.
• ORGANIZE_IMAGES Arrange image Locations to be in nice lined up rows and columns.
• OVERLAP_IMAGES Get coordinates of common overlap region within each image. Default is return exact (floating point) (xBot, xTop, yBot, yTop) coordinates, /ROUND causes round off to nearest integers. INTERIOR = # pixels width to ignore at edges of overlap. /BOX shows the overlap region on window (screen), /MARKS marks all images. Frank Varosi STX @ NASA/GSFC 1989.
• PATCH_IMAGES Create a new image by patching a region in an image using Vertical and/or Horizontal interpolation, with optional averaging and/or Gaussion noise added. Purpose, for example, is to create a synthetic sky image by cutting out the source region in a star image. The patched region and method is controlled interactively.
• PATCH_MOSAIC Create a new mosaic image by patching a region in the image using Vertical and/or Horizontal interpolation, with optional averaging and/or Gaussion noise added. The patched region and method is controlled interactively.
• PEAK_AVG_TRANS Compute peak Transmission (peak wavelength of avg. in circle) for increasing radii, plotting results while computing.
• PICK_IMAGES Pick images from collection by various methods of user selection.
• PLOT_CENTROIDS Frank Varosi STX @ NASA/GSFC 1991.
• PLOT_DIAGRAM Plot the Grotrain diagram of energy levels and allowed transitions. The graphics can go to either a window or to a file.
• PLOT_EFFICS Plot the results of efficiency calculation.
• PLOT_EFF_MEAS Plot the mirror and grating flux measurements, which are used to computed efficiencies of grating. Assumes there is one grating measurement at each wavelength, and up to two (2) mirror measurements at each wavelength.
• PLOT_HISTOGRAMS Plot up to 6 curves (histograms) on same graph, with different line types.
• PLOT_PEAK_TR Plot peak transmission versus radii of circles.
• PLOT_PROFILES Plot up to 6 profiles (cuts through images) on same graph, with different line types.
• PLOT_SPECTRUM Plot flux vs. wavelength (or time), with optional error bars (st.devs.). Called by Look_images.
• PLOT_TRANSPEC Plot Transmission vs. wavelength with optional error bars (st.devs.).
• PLOT_XSEC Plot the full and approximate photo-ionization cross-sections. Called by pro Approx_Xsecs_Ev and pro Approx_Xsec_Cur.
• PNOISE imc = imcm
• POLL_DEVICE Serial poll a GPIB device to decide its status.
• POP_GROUP Redislpay a group of images on top of others, adjust Levels in structure, Returns the indices of images in List belonging to the group. Frank Varosi NASA/GSFC 1989
• POP_GROUPS Select a group of images and Redislpay on top of others, , if top group is selected twice, start popping from bottom Level. Frank Varosi NASA/GSFC 1989
• POP_IMAGE Redislpay an image on top of all others and set Level accordingly. If im_num = previous_num then Pop from bottom Level.
• POP_IMAGES Interactively select an image and redislpay on top of all others. If top image is selected twice (image_num = inumsave) then start popping from bottom Level. Selection/pop process continues in a loop until users aborts.
• POP_MOSAICS Interactively select a mosaic image and Redislpay on top of all others, if top image is selected twice (image_num = inumsave) then start popping from bottom Level. Selection/pop process continues in a loop until users aborts.
• POP_PUSH_IMAGES Interactively select an image and pop it if left button was pressed (redislpay on top of all others), or push it if middle button was used. If top image is selected twice (im_num = inumsave) then start popping from bottom Level. Selection/pop/push process continues in a loop until users aborts with right mouse button.
• PREP Read TUT image files from CCD or MAMA obs and PreProcess the images.
• PROFILE_IMAGES Interactively chose two points defining a cut across overlaping images, then plot the flux in the pixels of each image intersecting the cut. The two points are chosen with Left then Left or Middle mouse button, or if the first button pressed is the Middle button then a menu is presented whereby the user can exclude/include images from/into the multi-profile graph, change the axes (arcsec/pixels, Linear/Log, etc.), normalize fluxes, or make a hardcopy to print. Another option is the mode in which an angle and range of profile cut can be defined so that selecting a single point will plot the profiles.
• PROFILE_MOSAIC Extract and Plot interactively specified profile cuts of mosaic image. Frank Varosi STX @ NASA/GSFC 1990. F.V. 1991, mod to use mosaic_spec structure, and to also work on Contoured mosaics.
• PURPOSE:[10] posxy = set_PostScript( mode, bitspix, nxpix, nypix ) KEYWORDS: EXTERNAL CALLS: COMMON BLOCKS: common PS_Layout, xoff, yoff, xpap, ypap, Left, Right, Top, Bottom PROCEDURE:
• PURPOSE:[11] CALLING SEQUENCE: shift_images, image_List, xshift,yshift, GROUP=group, WINDOW=window image_List xshift,yshift KEYWORDS: GROUP=group
• PURPOSE:[12] Construct sky image from of a stack of images, by sorting the stack and extracting the median or minimum image, or else just averaging the stack.
• PURPOSE:[13] Create a synthetic sky image by choosing from two methods: 1. cutting out the source region in a data image, and patching the hole using Vertical and/or Horizontal interpolation, with optional averaging and Gaussion noise. 2. Construct sky image from of a stack of images, by sorting the stack and extracting median or minimum, or else just using the average of stack.
• PURPOSE:[1] Edit_Eff_Meas, eff_meas eff_meas = eff_meas = EXTERNAL CALLS: pro print_struct function strconcat
• PURPOSE:[2] gscat_define, gs_widget Written: Frank Varosi NASA/GSFC 1994.
• PURPOSE:[2] gscat_box_draw, gs_widget Written: Frank Varosi NASA/GSFC 1994.
• PURPOSE:[3] gscat_extract, gs_widget, scattm, subimage Written: Frank Varosi NASA/GSFC 1994.
• PURPOSE:[4] gscat_plot, gs_widget, scattm Written: Frank Varosi NASA/GSFC 1994.
• PURPOSE:[5] Plot_Reflect, effics effics = array of structures, created by pro Calc_Effics. KEYWORDS: /HARDCOPY DIRECTORY = EXTERNAL CALLS:
• PURPOSE:[6] Print_Eff_Meas, eff_meas eff_meas = array of structures, created by pro get_Effic_Data. KEYWORDS: /HARDCOPY DIRECTORY = List of efficiency measurements is printed to screen or file.
• PURPOSE:[7] Print_Effics, effics effics = array of structures, created by pro Calc_Effics. KEYWORDS: /HARDCOPY DIRECTORY = List of calculated efficiencies is printed to screen or file.
• PURPOSE:[8] KEYWORDS: EXTERNAL CALLS: COMMON BLOCKS: PROCEDURE: Written: Frank Varosi NASA/GSFC 1994.
• PURPOSE:[9] Save_Effics, eff_calc eff_calc = array of structures, created by pro Calc_Effics. KEYWORDS: DIRECTORY = Variable eff_calc saved to an XDR file. EXTERNAL CALLS:
• PUSH_IMAGE Display an image behind all others by redisplaying intersections with all other images in stacking order.
• PUSH_IMAGES Interactively select an image and push it behind all others, i.e. redisplay intersections with all other images in stacking order. Selection/push process continues in a loop until users aborts.
• READ_CCD Cause the CCD to be read through amplifiers and A/D converters, and the data DMA transfered into shared memory on host computer. All accomplished by calling shareable object C-code in ccdmem.so. After read is initiated, the status is checked for completion, if not finished the timer is set on status (Label) widget to generate a read-check event in next second.
• READ_CCD_FILE Read a Photometrics CC200 CCD data file, return image and header info.
• READ_DEVICE Get the position or output of a GPIB device axis.
• READ_ELEVS Read the ASCII file of energy levels obtained from TOPBASE (atomic db).
• READ_FILTER Get the position of the Filter Wheel.
• READ_HPDAC Read a measurement from a channel on HP-DA/CU.
• READ_IMAGES Read filter In & Out images from CCD data files, perform first level of processing, by calling function sig_ref, and return images & scaled images in structured inventory List.
• READ_KEM Read the Keithly Electro-Meter (KEM).
• READ_KLINGER Get the position of a Klinger axis.
• READ_LWS_IMAGES Read Sig & Ref images from a LWS FITS file, perform first level of processing (optional), including 3 options for processing nodded observations, and return in structured inventory List.
• READ_MAMA_FILE Read a MAMA data FITS file, return image and header info.
• READ_MONOCHROM Get the position of the MonoChromator, possible axes are usually: wavelength, grating, and slit width.
• READ_OBS_DRO Read Sig & Ref images from DRO files, the output of IROBS program.
• READ_PE this procedure reads the raw data file written by the PerkinElmer reflectometer/tranmissometer into IDL. file filename, string wavelength x array of tested wavelengths transmittance y array of T(wavelength) text optional output, text info
• READ_PE_DATA this procedure reads the raw data file written by the PerkinElmer reflectometer/tranmissometer into IDL. file filename, string wavelength x array of tested wavelengths transmittance y array of T(wavelength) text optional output, text info
• READ_PHOTION Read the ASCII file of photo-ionization cross-sections obtained from TOPBASE and store data in array of structures. Cross-sections are stored as Log base 10, frequencies are stored as Log10( Freq/F0 ) where F0 = edge-frequency.
• READ_TRANS Read the ASCII file of radiative transitions obtained from TOPBASE, which includes the oscillator strengths (gf). If transition gf > 0 then the energy levels are interchanged so that the transition is from lower to higher energy (as for gf < 0) and then set gf = abs( gf ).
• READ_UNIDEX Get the position of a Unidex axis.
• REDUC_SCATT This is a procedure to rotate scatter images and subtract a background Date 11/07/94 Authors Standley & Norton in_image input image to rotate out_image output rotated image backgrd per pixel background to subtract
• REMOVE_IMAGES Remove images from collection by user selection. Frank Varosi STX @ NASA/GSFC 1989. F.V added option to Lasso images with rubber box, 1990. F.V put Lasso and other options into pick_images, 1991.
• REMOVE_MOSAIC Frank Varosi STX @ NASA/GSFC 1989. F.V. 1991, converted to use mosaic_specs structure. F.V. 1991, call itself recursively to remove more mosaics.
• REMOVE_MOSAICS Remove mosaic-images from collection by user selection. Frank Varosi NASA/GSFC 1991. (adapted from remove_images)
• REPLACE_MOSAIC Replace a mosaic image with another, keeping the old display specs.
• REREAD_IMAGES Reread the images from files thereby recalculating the error properties and estimates of relative errors.
• RESIZE_WINDOW Compute new size for window to hold images and place them in center. Frank Varosi NASA/GSFC 1989 F.V.1992, restrict shift to actual pixel grid (shift MOD Magf).
• RESTORE_EFFICS Restore previously saved efficiency calculations. Replaces existing effics variable.
• RESTORE_EFF_M Restore previously saved efficiency measurements. Option to merge with existing eff_meas variable.
• RESTORE_IMAGES Restore an IDL save file containing a collection of images (structured array). Files have extension: *.iml
• RESTORE_INVEN Restore an IDL save file containing an inventory of images (structured array) from disk. Files have extension: *.inventory
• RESTORE_MATHMOS Restore a raw mosaic of mosaics (images of any size or type) and apply any defined filtering, factors, and offsets. Most of the work is done by function Setup_MathMos called at end.
• RESTORE_MOSAIC Restore mosaic image and specs from a file/memory by either: inquiring user via menu for which file to restore, or finding file if NAME= is specified and then restoring it.
• RESTORE_MOSAICF Restore file and/or insert mosaic, mosaic_spec, and mosaic_info into arrays: mosaics (a memory pool), mosaic_specs, mosaic_infos. (called by: pro restore_mosaic, or pro Load_FITS_image).
• RINGING Compute the ringing of transmission versus wavelength, using a parabolic fit as reference level. Ringing can be defined as maximum peak-peak variation (default), or the maximum absolute deviation from mean reference parabolic fit, or the ratio of integrated deviation area over transmission area.
• RINGING_MAP Produce map of max peak-to-mean ringing of transmission at each pixel, using a parabolic fit as reference mean level.
• SAVE_ANALYSIS Frank Varosi STX @ NASA/GSFC 1990 F.V. 1991, mod to save source_marks and mosaic_spec.
• SAVE_EFF_MEAS Save_Eff_Meas Save_Eff_Meas, eff_data eff_data = array of structures, created by pro get_Effic_Data. KEYWORDS: DIRECTORY = Variable eff_data saved to an XDR file (var name is changed to protect).
• SAVE_IMAGES Frank Varosi NASA/GSFC 1989.
• SAVE_IMAGES1 Frank Varosi NASA/GSFC 1989. F.V. 1991, save scale_type, smoothing, minLog & colors with images.
• SAVE_INVEN Frank Varosi NASA/GSFC 1989. F.V. 1991, save scale_type, smoothing, minLog & colors with images.
• SAVE_MATHMOS Frank Varosi NASA/GSFC 1990 F.V. 1991, mod to save source_marks and mosaic_spec.
• SAVE_MOSAIC Save mosaic image, mosaic_spec, and mosaic_info, etc. to IDL file. The default is to select & extract mosaic image from pool-memory, or if arg: mosaic_spec is specified, then it selects the mosaic to save. Inquires user for a new file name, or can overrite existing file.
• SCALE_IMAGES Select type of scaling and apply to all images.
• SCALE_MOSAIC mosaic_scaled = scale_mosaic( mosaic, mosaic_spec ) mosaic = 2D image array. mosaic_spec = structure with contour display specifications. Frank Varosi STX @ NASA/GSFC 1989. F.V.1990, added Log10 option. F.V.1990, added truncate option.
• SCALE_MOSAICS Select type of scaling and apply to all mosaic images.
• SCAN_MONOCHROM Scan the ACTON-SpectraPro monochromator wavelength between requested positions, units are nanometers.
• SCATTRD3 read a Photometrics CC200 CCD data file into IDL IDL Version 2.0.12 (vms vax) Journal File for OPTIK::DAVEC Working directory: $1$DIA0:[DAVEC.MODIST] Date: Thu Dec 19 09:45:40 1991 revised: 26-Feb-93 DAC
• SCATTRD4 read a Photometrics CC200 CCD data file into IDL revised: 26-Feb-93 DAC revisions: adding interpretations of additional information being loaded into the CC200 numeric header by the CC200 controller BASIC program CC200DC additions include: date; Klinger stage positions; CCD temperature; laser power meter (flux monitor)
• SCATT_RD read a Photometrics CC200 CCD data file into IDL revised: 26-Feb-93 DAC revisions: adding interpretations of additional information being loaded into the CC200 numeric header by the CC200 controller BASIC program CC200DC additions include: date; Klinger stage positions; CCD temperature; laser power meter (flux monitor)
• SCREEN_COORDIN Use actual relative Locations of images to define display screen coordinates, accounting for current magnification, and optional unsmoothed border. If structure is for mosaics, the actual of each image is used. Frank Varosi NASA/GSFC 1991.
• SELECT_FILES select_files select_files, obs_dir, obs_files obs_dir = string, directory. obs_files = string array of file names. COMMON BLOCKS: common select_files, dir_obs
• SELECT_IMAGE Allow selection with mouse (cursor) and return image number (top image), or optionally return subscripts of all images containing selected point. LEFT button selects, RIGHT button aborts (returns -4), MIDDLE button also aborts (-2), unless /MIDDLE set, then it selects. CALLING EXAMPLES: im_num = select_image( image_List, xi,yi ) im_subs = select_image( image_List, /ALL )
• SELECT_IMAGES Select a bunch of images by clicking LEFT button on them, one by one, then MIDDLE button to indicate done, or RIGHT button to abort.
• SELECT_LEVELS Called by pro Modion_Cursor to process cursor events of modion widget. Finds Levels within SLP and Energy values/range and toggles select flag, and also redisplays selected/unselected Levels with new colors. If keyword /MERGE is set, then the group tag is set to indicate that selected Levels should be merged with others in current group. Negative group tag means that levels are awaiting merge into superlevel, and positive group tags indicate a created superlevel which cannot be altered by this routine. Also, in normal mode of operation the select flag of a normal level or merging level is toggled, but in /MERGE mode the select flag of a normal level cannot be toggled.
• SELECT_MOSAIC F.V. 1991 added option to restore mosaic.
• SELECT_REGION select_region region = select_region( image_List, purpose, request ) image_List = array of structures containing image locations & info, EXTERNAL CALLS: PROCEDURE: Written: Frank Varosi NASA/GSFC 1990.
• SETUP_62X58 device,RETAIN=1 ;needed for old OpenWin-2 bug.
• SETUP_AXES Stores setup info about axes of a single device in structured array (in common gpib, devices).
• SETUP_CCD device,RETAIN=1
• SETUP_DEVICES Stores device setup info in structured array (in common gpib, devices).
• SETUP_LEAR device,RETAIN=1
• SETUP_MAMA ;print_que = ["irlaser","tek350"]
• SETUP_MATHMOS Setup a raw mosaic of mosaics (images of any size or type) and apply any defined filtering, factors, offsets, scaling, rotation. Called by Restore_MathMos.
• SETUP_RASCAL setup_devices, "filter", TYPE="FILTER", DESCRIP="ARC SpectraPro filter assembly" setup_axes, "filter", AXES= "filter" , $ ALIAS= "Filter" , $ UNITS= "" , $ SCALE= 1 , $ FORM= "(I3)" , $
• SETUP_SPIRAC ---------------------------------------------------------------------------
• SETUP_USER device,RETAIN=1
• SET_BBT_LOCS Set the X-Y graphics device coordinate Locations for bound-bound transitions. Coordinates are obtained from energy Levels and SuperLevels.
• SET_COLORS Set the color index tags in the structures for Energy Levels, SuperLevels and B-B transitions, to current respective table numbers.
• SET_COORD Compute X-Y graphics device coordinate Locations for Energy Levels, and store in same structure. Also create X & Y axis Labels for display.
• SET_GRAT_PARMS Set grating parameters: angle of incidence, groove density, order, in the efficiency calculation structure array.
• SET_HARD_COPY Interactively (via menu) set image hard-copy (PS) options for OPTICON.
• SET_PLATE_SCALE CALLING EXAMPLE:
• SHOW_HEADER Print header information about images in separate window(s).
• SHOW_HEADER1 Print single header information structure in a window.
• SHOW_INFO Print information about images on the displayed images.
• SIG_REF Call either function sig_ref_CCD or sig_ref_MAMA to read Sig & Ref (filter In & Out) image pair from a file, and perform first level of processing (optional). The detector CCD or MAMA is selected by string variable detector in common block detector.
• SIG_REF_CCD Read Sig & Ref (filter In & Out) image pair, that was taken by CCD detector, from a file, and perform first level of processing (optional).
• SIG_REF_MAMA Read Sig & Ref (filter In & Out) image pair, that was taken by MAMA detector, from a file, and perform first level of processing (optional).
• SKY_GAIN_INTERP Setup the interpolation between sky or gain images.
• SKY_STACK_AVERAGE Stack a set of sky images (e.g from LWS-Keck) and average them into single sky image.
• SKY_SUB_GAIN Select blank sky image and subtract from selected source images, thereby removing residual offsets due to telescope, or select gain image and divide (normalized) into selected images, thereby attempting to correct for the gain matrix of detector array.
• SLP_CHAR Form the standard SLP string (e.g. 2Pe) from the SLP quantum numbers, and optionally return (S,L,P) triplet from SLP 3-digit input.
• SPLICE_IMAGES Splice (no averaging) the images in raw_mosaic into one mosaic image, Order of splicing is determined by Level (stacking) of images in raw mosaic. Frank Varosi NASA/GSFC 1992.
• STACK_IMAGE find all other images which will be obscured by image Location, then return one plus the maximum Level of obscuration. Loc = [xmin,xmax,ymin,ymax] of new image Location. Frank Varosi NASA/GSFC 1989
• STACK_IMAGES increase Levels of images(inums) by maximum Level of all images, in order to pop them to the top all at once. Frank Varosi NASA/GSFC 1989
• START_INTEG Set the pixel size and tell xmacq to integrate for (dt) seconds.
• STATS_IN_CIRCLE Get statistics of image within a circle (specified by 2nd arg.) and return it as a structure. Called by pro InBand_Fspecs.
• STAT_IMAGES Estimate the sky level and noise in images selected interactively. (function Sky_Noise actually finds the st.dev. of noise and sky level) Return a structure array containing statistics, with option to order alphabetically by image name structure tag.
• STOP_INTEG Tell xmacq to stop an integration (i.e. set mode= 0 ).
• STORE_FITS_IMAG Write a mosaic image to FITS file. Inquire user via menu for which one to write.
• STORE_IMAGE Store header & image of MAMA data into a FITS file. The structure header is converted to FITS type of header. Note that the filename is contained in header structure fields: output file = header.directory + header.filename + ".fits".
• SUPLEVS_REORDER Modify group tags of SuperLevels to go in order of average energies, and modify group tags of Energy Levels to keep correspondence.
• SUPLEVS_STYLE Change the appearance of SuperLevels on the display of Grotrian diagram between either the standard box enclosing all levels in the group or a single line at the average energy instead of showing the levels in box. The default mode (no keywords set) is to check if any are in box-style and if so then set all to box-style, else set all to Line-style. Default mode also sets the x-coordinates to standard ranges.
• SUPLEV_CREATE Merge the selected energy levels (indicated by negative group tags) into a SuperLevel and add to the array of SuperLevel structures. Negative group tags in the ELevs array then become abs( ) positive indicating that merging of levels is complete. SuperLevel energy is calculated as the Maxwell-Boltzman statistical average energy at a given temperature which is queried from the user. Optionally, can create SuperLevels for each 2S+1 and parity seperately.
• SUPLEV_DESTROY Ask the user to select which super-Level to breakup from a List of all super-Levels, then destroy the selected one by removing it from the array of super-Level structures and reseting the related energy level group tags to zero.
• TOFU Create a Raw Mosaic out of collection of images (all same size).
• TOFU_MAIN Main program for calling: Prep
• TOFU_OPTIONS "ignore": BEGIN menu = ["Width of border to neglect ?",string(indgen(10))] sel = wmenu( menu, INIT=2, TITLE=0 ) > 1 border_ignore = sel-1 print," width of ignored border = ", strtrim( border_ignore,2 )
• TOFU_SETUP Do NOT modify this file! This file should be linked to: ~/tofu/setup.pro so that it is automatically executed by ~/idl/idl_startup.pro (need: setenv IDL_STARTUP ~/idl/idl_startup.pro). Copy and put any desired modifications and variable settings in: ~/tofu/setup_user.pro, which is invoked at end of this IDL script.
• TOFU_TASK Perform tasks commonly requested by MOSAIC & PREP & ANALYZE, by routing request to other procedures and function.
• TQCM_MONITOR Create widget interface (GUI) to monitor the TQCM which is read by means of the HP-3412A Data Acquisition device. The temperature (voltage) and frequency reads are done periodically by widget timer events.
• TQCM_PLOT Plot the TQCM temperature, frequency, freq. rate of change, vs. time. Called by TQCM_event, the widget event handler for TQCM_monitor.
• TQCM_RECORD Record the TQCM temperature, frequency, freq. rate of change, and time, to a file (appended), and update the status widgets. Called by TQCM_event, the widget event handler for TQCM_monitor.
• TQCM_SAVE Record the TQCM temperature, frequency, freq. rate of change, and time, to a file (appended), and update the status widgets. Called by TQCM_event, the widget event handler for TQCM_monitor.
• TRANSREDUC reduce transmission data in IDL revised: 14-june-96 TAN laser power meter (flux monitor) accounted for varying integration times between I and IO accounted for bias level of the detector accounted for at constant of 147 counts/pixel
• TRANSREDUC1 reduce transmission data in IDL revised: 10-june-96 TAN laser power meter (flux monitor) accounted for varing integration times between I and IO accounted for bias level of the detector accounted for at constant of 147 counts
• UNDO_FACTORS Undo factors & offsets that were applied to images. CALLING EXAMPLE: undo_factors, image_List, INUMS=inums, /REDISPLAY
• UNIDEX_ADC Command UNIDEX controller to perform Analog to Digital conversion of voltage at analog input and read back the value (fraction of 10 V).
• UNIDEX_BUTTONS Create widget interface to control a particular Unidex device by means of an exclusive array of buttons commanding preset moves.
• UNIDEX_CONTROL Create widget interface (GUI) to control the Unidex device axes by means of sliders, text entry, and buttons.
• UNIDEX_FEEDBACK Get feedback from the Unidex motion controller by reading the analog or digital inputs. Analog is scaled and displayed as volts in widget, or first 3-bits of digital input is mapped and displayed in widget.
• UNIDEX_READ Read the value of a parameter, register, or variable on the Unidex motion controller, while in the GPIB host mode of operation.
• UNIDEX_SLIDER Create widget interface to command a Unidex controller (GPIB device) by means of sliders, text entry, and move/reset/options buttons.
• UNIDEX_STATUS Get the status of a Unidex device & axis.
• UNIDEX_WRITE Modify the value of a parameter or register of the Unidex motion controller, while in the GPIB host mode of operation.
• WAVECEN ACS/TUT specific routine - find central wavelength for each TUT pixel inputs: inventory -- should include .01 edges on red & blue sides blue01map - wavelengths for each pixel for blue01edge red01map -wavelengths for each pixel for red01edge output: wavecenmap -integer(nm) wavelength for equal area in each direction == central wavelength.
• WAVEMAPATT pro Wave_Map_at_T map wavelengths at which transmission = Tval ACS/TUT specific routine, written 9/19/96 D. Content inventory set of TUT images at a range of wavelengths Tval specific (scalar) value of transmission to find (optional) rising flag, if not present or 1, look for first W at which T rises to Tval; if ne 1, look for falling edge
• WAVE_TCENTER Produce map of central wavelengths: the wavelength where integrated transmission of filter is half of total.
• WAVE_TMAP Produce map of wavelengths at which transmission crosses a threshold.
• WRITE_ISA_WIND Write selected levels & transitions and to a formatted file for use by the ISA-Wind stellar model. Write approximate cross-sections to a separate file.
• WRITE_TLUSTY Write selected levels, transitions and approximate cross-sections to a formatted file for use by the TLUSTY stellar model.
• ZOOM_MOSAIC If mosaic_spec.zoom_enable=1 then return zoomed region of mosaic image. The mosaic_spec.zoom field of structure defines zoomed region. /SET_ZOOM allows interactive specification of the zoomed region, and then the average zoom factor is returned.