GHRS 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]

Last modified: Thu Dec 21 21:34:13 2000.

List of Routines

ABSCAL Provide an absolute calibration using the BZERO and BSCALE keywords in an FITS header
AD2XY Compute an X and Y position given the RA and DEC and the astrometry parameters CD, CRPIX, and CRVAL. A tangent (gnomonic) projection is assumed. AD2XY is meant to be used internal to other procedures. For interactive purposes, use ADXY.
ADDPM *NAME: ADDPM *PURPOSE: Correctly adds proper motions to input positions. *CALLING SEQUENCE: ADDPM,ra,dec,pm_ra,pm_dec,v_r,parallax,delta_t,OUTRA,OUTDEC *PARAMETERS: ra - (REQ) - (0) - (R,D) - RA in decimel degrees.
ADSTRING Return RA and Dec as character string in sexigesimal format. RA and Dec may be entered as either a 2 element vector or as 2 scalars. You may also specify the precision of the declination in digits after the decimal point.
ADXY Use an image header to compute X and Y positions, given the RA and Dec in decimal degrees. A tangent (gnomonic) projection
AIPSDIR Print a listing of AIPS image files on a VAX directory
AIPSNAME Returns the VAX filename of a specified AIPS sequence number, for a given user number. Needed because AIPS tries to hide the VAX file name, which is what the IDL procedure AIPSRD needs to read an image.
AIPSRD Read an AIP disk image (MAP) file into an IDL image and header arrays Use AIPSDIR or AIPSNAME to determine the VAX filename of the desired
AIRTOVAC Convert air wavelengths to vacuum wavelengths, i.e. correct for the index of refraction of air under standard conditions. Wavelength values below 2000 A will not be altered. Accurate to about 0.005 A
ARC A driver for the GHRS WAVECAL procedure to give a more interactive representation for the wavelength calibration.
ARC_CPLOT Procedure to plot a comparison of two spectra and manipulate the plot
ARC_PLOT_DIS arc_plot_dis,lname,cwave,plot_info=plot_info
ASTRO Interactive astronomical utitlity for precession and coordinate
ASTROLIB Add the system variables in use in the IDL Astronomy User's Library
AVG Calculate the average value of an array, or calculate the average value over one dimension of an array as a function of all the other
AVSPT *NAME: AVSPT *PURPOSE: Find single point zeros in IUEHI file and remove *CALLING SEQUENCE: result = avspt(f,e,kk) *MODIFICATION HISTORY: F Walter - 6/90 - donated to GHRS DAF.
A_B Compute interstellar extinction in the B bandpass as a function of galactic position using the 21 parameter function given by deVaucoulers in the 2nd Reference Catalog of Galaxies
BANDS To get the floating point and byte arrays of all the bands of one hcon of an image.
BASEREM To fit a polynomial of order NDEG to a user-specified spectral region for removing a baseline from a spectral feature.
BBDRAW Draw blackbody curves over data through a given point.
BB_FLUX gives the blackbody flux (NOT the "astrophysical flux") in ergs/cm2/s/sr from allen astrophysical quantities section 44
BCK_SMOOTH Routine to smooth background spectra by a median filter followed by a mean filter.
BINS To bin flux data on a specified wavelength grid with or without weights.
BIN_SPEC Procedure to bin a GHRS spectrum by summing over a specified (NPTS) number of datapoints to produce an effective low resolution spectrum
BLEMISH To interactively remove blemishes in a flux vector by linear interpolation between the flux values on each side of the blemish. (Based on BLEMISH by D. Lindler.)
BOXAVE Box-average a 1 or 2 dimensional array. This procedure differs from REBIN in that INTEGER arrays are boxaveraged using REAL arithmetic. For boxaveraging REAL and DOUBLE arrays, the REBIN function should be used (it is faster).
BOXCOUNT Determine integrated counts within selected regions. The regions are specified by registering the cursor on a contour map.
BSORT Function to sort data into ascending order, like a simple bubble sort. original subscript order is maintained when values are equal (FIFO). (This differs from the IDL SORT routine alone, which may rearrange order for equal values)
CALCPOS *NAME: CALCPOS *PURPOSE: Updates an input position for precession and proper motion. *CALLING SEQUENCE: CALCPOS,ra_deg,dec_deg,pm_ra,pm_dec,v_r,parallax,in_equinox, out_equinox,pm_equinox,obs_epoch,pm_epoch,pm_yn,prec_pos,OUTRA,OUTDEC *PARAMETERS:
CALC_CARPOS Procedure to compute carrousel position from wavelength and
CALC_RIPPLE Compute approximate ripple function for purposes of estimating exposure times. (no epsilon effect is included and the blaze is set to 63.4 degress and 2*delta=13.25)
CALFOS Calibrates FOS GEIS files CALLING SEQUENCE: calfos,name,params,wave,flux,eps,err,h,gpar,rate,gross,sky,back,net name - rootname of input file (without extension) params - keyword parameters 0 - use all defaults
CALFOS_BAC calfos_bac CALLING SEQUENCE: calfos_bac,bac,fwidths,config,pattern,h,data,eps,back,rootname,ctable,rtable bac - reference background (from CALFOS_RDBAC). It is used only if no ystep has the background. fwidths = 2 element vector with median filter width and
CALFOS_CCG2 CALFOS_CCG2 Read deadtime coefficient table CALLING SEQUENCE: calfos_ccg2,name,config,h,coef name - ccg2 table name config - configuration vector (from CALFOS_RD)
CALFOS_CCS0 CALFOS_ccs0 Read aperture area table CALLING SEQUENCE: calfos_ccs0,name,config,h,areas name - ccs0 table name config - configuration vector (from CALFOS_RD)
CALFOS_CCS1 CALFOS_ccs1 Read aperture position table CALLING SEQUENCE: calfos_ccs1,name,config,h,ypos name - ccs1 table name config - configuration vector (from CALFOS_RD)
CALFOS_CCS2 CALFOS_CCS2 Read sky emission line table CALLING SEQUENCE: calfos_ccs2,name,config,h,line_beg,line_end name - CCS2 table name config - configuration vector (from CALFOS_RD)
CALFOS_CCS3 CALFOS_ccs3 Read filter width table CALLING SEQUENCE: calfos_ccs3,name,config,h,widths name - ccs3 table name config - configuration vector (from CALFOS_RD)
CALFOS_CCS5 CALFOS_CCS5 Read sky NSHIFT table CALLING SEQUENCE: calfos_ccs5,name,config,pattern,h,nshift name - ccs5 table name config - configuration vector (from CALFOS_RD)
CALFOS_CCS6 CALFOS_ccs6 Read dispersion coef. table CALLING SEQUENCE: calfos_ccs6,name,config,h,coef name - ccs6 table name config - configuration vector (from CALFOS_RD)
CALFOS_DQI CALFOS_DQI data quality initialization CALLING SEQUENCE: calfos_dqi,name,ypos,config,pattern,,dqi,eps,data name - rootname of observation ypos - 2 element vector containing upper and lower aperture pos.
CALFOS_EXP CALFOS_EXP Convert to count rates CALLING SEQUENCE: calfos_exp,fname,pattern,ddt,h,gpar,data,eps,err,expmax fname - rootname of observation pattern - pattern vector for CALFOS_RD
CALFOS_FLT CALFOS_FLT FOS flat fielding CALLING SEQUENCE: calfos_flt,flat,ypos,config,pattern,h,data,err flat - flat field array NS x 2. flat(*,0) = upper or single aperture or pass_dir = 1
CALFOS_IVS CALFOS_WAV Conversion to absolute flux units. CALLING SEQUENCE: calfos_ivs,ivs,ypos,config,pattern,net,h,err,flux ivs - inverse sensitivity array (from calfos_rdivs) ypos - ybases of the upper and lower aperture of an aperture
CALFOS_MEAN CALFOS_MEAN Mean filter routine CALLING SEQUENCE: result = calfos_mean(in,width,first,last) in - input spectrum width - filter width (if greater than the number of points
CALFOS_MEDIAN CALFOS_MEDIAN FOS median filter routine CALLING SEQUENCE: result = calfos_median(in,width,first,last) in - input spectrum width - filter width (if greater than the number of points
CALFOS_OFF calfos_off Apply GIMP offsets to the data. Offsets are applied to the nearest pixel. No interpolation is done. CALLING SEQUENCE: calfos_off,rootname,table,stable,pattern,expomax,h,data,err,eps,gpar rootname - observation rootname
CALFOS_PPC CALFOS_PPC FOS paired pulse correction CALLING SEQUENCE: calfos_ppc,ppcoef,h,data,err,eps ppcoef - paired pulse coef. (from routine CALFOS_CCG2) INPUT/OUTPUTS:
CALFOS_RD calfos_rd Routine to read fos .d0h file CALLING SEQUENCE: calfos_rd,name,h,data,gpar,eps,pattern,config name - file name h - FITS header
CALFOS_RDBAC CALFOS_RDBAC read background reference file CALLING SEQUENCE: calfos_rdbac,name,config,pattern,h,back name - reference file name config - configuration vector (from CALFOS_RD)
CALFOS_RDDDT CALFOS_RDddt read disable diode file CALLING SEQUENCE: calfos_rdddt,rname,name,config,pattern,h,ddt rname - rootname of observation name - reference file name
CALFOS_RDDQI CALFOS_RDDQI read data quality initialization file CALLING SEQUENCE: calfos_rddqi,name,config,pattern,h,dqi name - reference file name config - configuration vector (from CALFOS_RD)
CALFOS_RDFLT CALFOS_RDFLT read flat feild reference file CALLING SEQUENCE: calfos_rdflt,name,config,pattern,h,flat name - reference file name config - configuration vector (from CALFOS_RD)
CALFOS_RDIVS CALFOS_RDIVS read invserse sensitivity reference file CALLING SEQUENCE: calfos_rdivs,name,config,pattern,h,ivs name - reference file name config - configuration vector (from CALFOS_RD)
CALFOS_REF calfos_ref Get reference file names and switches from input header CALLING SEQUENCE: calfos_ref,h,pattern,config,reference,switches,ddt_over h - fits header of .d0h file (from CALFOS_RD) pattern - pattern vector (from CALFOS_RD)
CALFOS_REPAIR calfos_repair Repair bad pixels in a data vector by linear interpolation over good pixels. CALLING SEQUENCE: calfos_repair,mask,data mask - mask of same length as data. mask=0 (good pixel)
CALFOS_SKY CALFOS_SKY subtracts smoothed sky spectrum from object spectra. CALLING SEQUENCE: calfos_sky,areas,line_beg,line_end,nshift,ypos,widths,config,pattern, gross,sky,eps_sky,h,eps,net areas - relative aperture areas (from routine calfos_ccs0)
CALFOS_WAV CALFOS_WAV Determine FOS wavelengths CALLING SEQUENCE: calfos_wav,coef,ypos,config,pattern,h,wave coef - dispersion coefficients (from routine calfos_ccs6) ypos - ybases of the upper and lower aperture of an aperture
CALHRS Reduce (calibrate) GHRS science data.
CALHRS_ABS Routine to convert GHRS data to absolute flux units.
CALHRS_AIR Convert vacumm wavelengths to air wavelenghts
CALHRS_BCK Routine to compute and subtract the background from GHRS spectra.
CALHRS_BLEM calhrs_blem Subroutine of CALHRS which flags photocathode blemishes CALLING SEQUENCE: calhrs_blem,table,ih,epsilon,log table - name of blemish table containing the following columns DETECTOR - detector number
CALHRS_DC Computes dispersion coefficients for given carrousel position by one of two methods: 1) Interpolates or extrapolates in table of dispersion coefficients to determine coefficients for a specified carrousel position. 2) Computes dispersion coefficients using global fit for grating. Global fit models the disp. coef. as a polynomial function of carrousel position.
CALHRS_DEF SUBROUTINE OF CALHRS - not standalone user procedure, used to set default reference file names
CALHRS_DIO Perform correction for diode non-linearities
CALHRS_DQI Routine to perform data quality initialization
CALHRS_EXP Routine to convert to count rates.
CALHRS_GIMP hrs_gimp Routine to compute the geomagnetically induced image motion and correct the mapping function for the motion. CALLING SEQUENCE: calhrs_gimp,gimp,ihudl,udl,u1,u2,ih,log gimp - 2 element vector giving motion (diodes/gauss)
CALHRS_HEL Use the low-precision formulae for the Sun's coordiantes described in the Astronimical Almanac (1984), page C24. The velocities are obtained by takeing the derivatives of the coordinates. The velocity vector is in the equatorial coordiante system of epoch J2000. THis algorithm does not include the Earth-Moon Motion, Sun- barycenter motion, light time correction from the earth to the Sun. It should be accurate to approx. 0.025 km/sec. within the epoch range of 1900 to 2100 AD.
CALHRS_IAC calhrs_iac Subroutine of calhrs for applying the incidence angle correction to wavelengths for data not taken in the small science aperture. CALLING SEQUENCE: calhrs_iac,iatab,ih,wave,log iatab - incidence angle table (CCR8)
CALHRS_MAP calhrs_map Routine to perform GHRS mapping function. CALLING SEQUENCE: calhrs_map,tnames,ih,log tnames - string array with 2 elements: tnames(0) = line mapping function table
CALHRS_MER calhrs_mer procedure to merge substep bins CALLING SEQUENCE: calhrs_mer,ih,d,eps,err,first,nbins,nf,nmerge,iho,d_o,epso,erro,log ih - header array (128 x n) d - data array (512 x n)
CALHRS_ORD calhrs_ord Routine to compute spectral orders from the carrousel position and y-deflection using the carrousel calibration coefficients. CALLING SEQENCE: calhrs_ord,tname,gmode,aperture,cpos,ydefs,orders tname - name of the carrousel calibration table
CALHRS_OUT calhrs_out routine to write calibration results generated by CALHRS CALLING SEQUENCE: calhrs_out,ioblock,type,flag,headers,data,epsilon,errors ioblock - output file description vector (from HRS_OPEN) type - type of data (string)
CALHRS_PPC calhrs_ppc Performs the paired pulse (deadtime) correction of GHRS CALLING SEQUENCE: calhrs_ppc,ih,data,eps,errors,log INPUT/OUTPUTS: ih - header array, 128xN (returned by HRS_READ)
CALHRS_RDVIG Obtain vignetting curve for given carrousel position and photocathode line position by bilinear interpolation in a vignetting reference file
CALHRS_RIP calhrs_rip Corrects GHRS data for echelle ripple *CALLING SEQUENCE: calhrs_rip,tnames,ih,flux,err,log tnames - strarr array containing reference table names tnames(0) = echelle grating parameter table
CALHRS_SORT calhrs_sort procedure to sort all bins of data by readout CALLING SEQUENCE: calhrs_sort,udls,ih,first_bin,nbins,nfound,nmerge,log udls - array of unique data logs ih - header vectors (128xN)
CALHRS_STOW calhrs_stow Procedure to compute wavelengths from photocathode sample positions CALLING SEQUENCE: calhrs_stow,samples,order,dc,wave samples - photocathode sample positions order - spectral order
CALHRS_UDL calhrs_udl procedure to match udls to science data packets. CALLING SEQUENCE: calhrs_udl,ihudl,ihsdp,udls,udl_begin,udl_end ihudl - headers for udl packets (returned from HRS_READ) ihsdp - headers for science packets (returned fro HRS_READ)
CALHRS_VIG Subroutine of CALHRS to perform the vignetting correction
CALHRS_WAV calhrs_wav Routine to compute wavelength array from dispersion coefficients. CALLING SEQUENCE: calhrs_wav,tflag,tnames,ih,wave,log tflag - integer flag (if greater than 0 thremal motion correction is done)
CALHRS_XDEF calhrs_xdef routine to extract inital x-deflection information from udl and place results in header vector. CALLING SEQUENCE: calhrs_xdef,udls,u1,u2,ih,log udls - array of unique data logs
CAL_SLOPE ***************************************************** **NAME: CAL_SLOPE **CATEGORY: IRAS Image Processing routine: calculates the slope of periodic stripes in IRAS skyflux images. **CALLING SEQUENCE: cal_slope, image, mn, mx, angle **PARAMETERS: IMAGE, MN, MX, ANGLE
CENTERFLUX centerflux Routine to compute average flux values for the selected portion of the diode arrays. CALLING SEQUENCE: centerflux,idlist,params,table idlist - integer list of observation id numbers or
CENTROID_MERGE *NAME: CENTROID_MERGE *CATEGORY: *PURPOSE: Merge FP-SPLIT subexposures and multiple exposures to single vector. *CALLING SEQUENCE: CENTROID_MERGE, w, f, er, MW, MF, MER, type *PARAMETERS:
CHECK_FITS Given a FITS array IM, and a associated FITS or SDAS header HDR, this procedure will check that (1) HDR is a string array, and IM is defined and numeric (2) The NAXISi values in HDR are appropiate to the dimensions of IM (3) The BITPIX value in HDR is appropiate to the datatype of IM. If HDR contain a DATATYPE keyword (as in SDAS files), then this is also checked against the datatype of of IM If the UPDATE keyword is present, then FITS header will be modified, if necesary, to force agreement with the image array
CHECK_MATH_MSG Return IDL math error status message *Calling Sequence: msg= check_math_msg( status )
CHKIMHD Check that the first parameter is an array type, that the second parameter is a header type, and that the size info in the header matches that in the array. One may optionally check if the datatype specified by DATATYPE matches the data array. Program will set !ERR=1 and print error message if one of these conditions does not hold.
CHKREF CHKREF List reference files not available for calfos processing. CALLING SEQUENCE: chkref,rootname [,outfile] rootname - rootname of GEIS file(s) to be examined; wildcards valid. outfile - name of output files containing list of reference files not
CHOOSER *NAME: CHOOSER *CATEGORY: *PURPOSE: Prompts for record number of star of interest from given database. *CALLING SEQUENCE: CHOOSER, rec, dbase *PARAMETERS:
CLEAN_SPEC *NAME: CLEAN_SPEC *PURPOSE: Cleans the noise from the spectrum by filtering in the Fourier domain *CALLING SEQUENCE: CLEAN_SPEC,ft_cspec *PARAMETERS: ft_cspec - (REQ) - (1) - (I,R,L,D) - Input flux.
COADD_EXPS Coadd multiple readouts (sub_exposures) by linearly interpolating each flux exposure onto the same scale, coadd and then average.
COLORBAR Puts a color bar on the right edge of the display. Width is 20 pixels, each color 2 pixels high.
COMBINE_VEL Combines the current color table in the common block COLORS with the velocity color table as formed by LOAD_VEL.
COMP_GEIS Compare GEIS files (i.e. compare version 1 and 2 files)
CONFIND procedure to select continuum points in a spectrum. CONFIND is a modified version of the front end of NORM which uses the interactive graphics cursor to pick out points for later continuum fitting.
CONFIND2 procedure to select continuum points in a spectrum. CONFIND is a modified version of the front end of NORM which uses the interactive graphics cursor to pick out points for later continuum fitting.
CONS_DEC Returns a set of Y pixels values, given an image with astrometry, and
CONS_RA Return a set of X pixel values given an image with astrometry,
CONTINENT generates cylindrical projection of continental outlines in the default viewport using SUPMAP data. Optional parameter allows latitude coordinates to be plotted as the sin of latitude.
CONT_HARD To make a hardcopy of a contour plot of an iras image printable on the Postscript laser printer.
CONT_OVER To overlay a contour plot of an image on the image display.
CONV Example of the GHRS binary files which need to be converted for use on Sun workstation.
CONVERT To convert IUE .dat and .lab files to a format compatible with the host operating system. CONVERT supports IUE G.O. file format conversions between SunOs (Sun-3s, Sun-4s, and SPARCStations), ULTRIX (DECStation 3100), DOS (386-class PC), and VMS (VAX).
CONVERT_SAV converts RDAF .SAV files created on the VAX to a Unix-compatible format. Apparently VAX FORWRT commands add 4 bytes at the beginning of each record and each block. The block length is determined from the first integer in the second record. This program removes these bytes and writes the data out to disk using the F77_UNFORMATTED option in the IDL openw command.
CONV_CAL To convert ST/SDAS formatted file (i.e. .hhh/.hhd) or ST/GEIS formatted files (i.e. .d0h/.d0d).
CONV_DBAS Convert IDL database from VAX to: 1) DOS/WINDOWS computer. 2) Sun workstations (Sun 3/4/Sparc)
CONV_EXT Convert the extinction tables (i.e. UNRED) from
CONV_KUR Convert the kurucz (hnu.tab and cont.tab) files from
CONV_MOD Convert the kurucz MODELS.TAB files from VAX to DOS
CONV_SCI Convert GHRS SCI and SCX datasets from VAX to SUN format.
CONV_SCI_SCX Convert GHRS SCI and SCX datasets from VAX to SUN format.
CONV_UNIX_VAX To convert Unix IDL data types to VAX IDL data types. Currently assumes the Unix IDL data type is IEEE standard.
CONV_VAX_BLOCK To convert VMS Fortran unformatted block delimiters to their Unix
CONV_VAX_UNIX To convert VAX IDL data types to UNIX (Sun,MIPS,etc.) IDL data types. The architecture is obtained from IDL sys.var. !VERSION.ARCH.
CON_GO To convert IUE GO format .dat and .lab files between SunOs ULTRIX, DOS, and VMS formats, using FINDFILE and CONVERT.
CON_SAV Converts RDAF .sav files to a format compatible with the host operating system. Con_sav can convert files created with IUESAVE under VMS IDL version 1 or version 2, and files created under DEC or SunOS IDL version 2 to the appropriate format for the host operating system. Output files are written using IDL FORTRAN compatible unformatted write statements of the form WRITEU,UNIT,H,W,F,E.
COPY_ST_TAPE PROCEDURE TO COPY THE CONTENTS FROM THE INPUT TAPE TO THE OUTPUT TAPE
CREATE_DOC Create documentation file(s) for the procedure(s) specified
CROSS_CORRELATE Normalized mean and covariance cross correlation offset between two input vectors or the same length.
CRSCOR CRSCOR JUNE,1984 Cross-correlation *PURPOSE: To cross correlate two spectra and produce the velocity difference between them. *CALLING SEQUENCE:
CRSMAX DETERMINE THE MAXIMUM OF THE CROSS CORRELATION FUNCTION
CRSPROD To compute a normalized cross correlation for two spectral segments which are sampled on the same log(lambda) scale.
CRSTRIM To extract the spectral data within the user-specified wavelength range, and to interpolate the spectral data to a common log(lambda)
CSPLINE function to evaluate a cubic spline at specified data points
CT2LST To convert local civil time to local mean sidereal time.
CURFIT Non-linear least squares fit to a function of an arbitrary number of parameters. Function may be any non-linear function where the partial derivatives are known or can be approximated.
CURS Selects a cursor shape.
CURS_BLOW Get a section of an image using cursor position and zoom it.
CURVAL Display values associated with the cursor as it is moved over an image.
D2DMS Convert decimal degrees (or hours) to degrees (hours), minutes and seconds. CALLING SEQUENCE: dms=d2dms(degrees [,dmsstr [,ndp [,dchar]]]) degrees - decimal degrees or hours ndp - number of digits after decimal point to include in dmsstr (default is 3)
DATATYPE Returns data type as a string. Makes it easier to do data type dependent operations.
DATE DATE converts day-of-year to ordinary Gregorian date; works on cumulative day from 1-JAN-1979 (for instance), as well as more well-mannered days-of-year.
DATE_CONV Procedure to perform conversion of dates to one of three possible
DAYCNV Converts julian dates to gregorian calendar dates
DBBUILD Build a database by appending new values for every item. The database must be opened for update (with DBOPEN) before calling DBBUILD.
DBCIRCLE Find sources in a database within a specified radius of a specified center. Database should include RA and DEC items and should previously be opened with DBOPEN
DBCLOSE procedure to close a data base file
DBCREATE Create new data base file or modify description. A database definition file (.DBD) file must already exist. The default directory must be a ZDBASE: directory.
DBDELETE Deletes specified entries from data base
DBEDIT Interactively edit specified fields in a database. The value of each field is displayed, and the user has the option of changing or keeping the value.
DBEXT Procedure to extract values of up to 12 items from data base file, and place into IDL variables
DBEXT_DBF Procedure to extract values of up to 12 items from a data base file. This is a subroutine of DBEXT, which is the routine a user should
DBEXT_IND routine to read a indexed item values from index file
DBFIND Function to search data base for entries with specified search characteristics.
DBFIND_ENTRY This is a subroutine of dbfind and is not a standalone procedure It performs a entry number search.
DBFIND_SORT This is a subroutine of dbfind and is not a standalone procedure It is used to limit the search using sorted values
DBFPARSE Subroutine of DBFIND
DBGET Find entry number of fields which contain specified values in a specified item. DBGET is an altnerative to DBFIND when the desired search values are not easily expressed as a string.
DBHELP Procedure to either list available databases (if no database is currently open) or the items in the currently open database.
DBINDEX Procedure to create index file for data base
DBINDEX_BLK To set up an associated variable of the correct data-type and offset into the file by some amount in preparation for writing to the file.
DBMATCH Find one entry number in a database for each element in a vector of item values. DBMATCH is especially useful for finding a one-to-one correspondence between entries in different databases, and thus to create the vector needed for database pointers.
DBOPEN Routine to open data base files.
DBPRINT Procedure to print specified items from a list of database entries
DBPUT procedure to place a new value for a specified item into a data base file entry.
DBRD procedure to read an entry from a data base file or from linked multiple databases.
DBSEARCH Search a vector for specified values This is a subroutine of dbfind and is not a standalone procedure
DBSORT Routine to sort list of entries in data base
DBSUNTOHOST Routine to convert Sun database files to the host computer form. Needed for machines that do not implement the IEEE standard such as VAXes and Decstations. Requires that the ASCII .dbd file and the binary .dbf file already be present in the current directory, exactly as copied from the SUN
DBTITLE function to create title line for routine dbprint
DBUPDATE Update columns of data in a database
DBVAL procedure to extract value(s) of the specified item from a data base file entry.
DBVAXTOSUN routine to convert vax database (.dbf) file to the sun form.
DBWRT procedure to update or add a new entry to a data base
DBXPUT routine to replace value of an item in a data base entry
DBXVAL procedure to quickly return a value of the specified item number from the entry
DB_ABSTRACT To access, display, and print GHRS abstract databases.
DB_INFO Function to obtain information on opened data base file(s)
DB_ITEM procedure to return the item numbers and other information of a specified item name
DB_ITEM_INFO routine to return information on selected item(s) in the opened
DB_MULT To display parsed data base fields whose entries are separated by commas
DB_OR Combine two vectors of entry numbers, removing duplicate values. DB_OR can also be used to remove duplicate values from any longword
DB_TITLES Print database name and title. Called by DBHELP
DECIMAL To convert from degrees to decimal.
DECOMPOSE DECOMPOSE (General IDL Library 01) 19-JUL-81 PARSING *CATEGORY: Break file name into component parts, using VMS and RSX11 punctuation rules. *CALLING SEQUENCE: DECOMPOSE,FILE,DISK,PATH,NAME,EXTN,VERSION
DEFINE Use the SETLOG procedure of VMS IDL to emulate the DCL DEFINE command, or use the SETENV procedure of UNIX IDL to set an environment
DEF_DLM *NAME: DEF_DLM *PURPOSE: Decides which delimiter is in a numeric string and sends it back. *CALLING SEQUENCE: delim = DEF_DLM( input_string ) *PARAMETERS: input_string - a string scalar containing a comma, blank or colon
DEGRAY DEGRAY Routine to take the ones complement and compute the degrayed value of an 8 bit integer. CALLING SEQUENCE: degray,a a - raw encoder value (8 bit integer)
DELIM Return system specific file delimeters
DEREDD Deredden then Stromgren parameters given for a value of E(b-y) See the procedure UVBYBETA for more info.
DESTRIPE NAME: DESTRIPE CATEGORY: IRAS Image Processing routine: removes periodic stripes CALLING SEQUENCE: destripe,angle1,angle2,bckgr,new_bckgr PARAMETERS: ANGLE1, ANGLE2: (REQ) (I) (R) (0)
DFITSRD Convert true disk FITS formatted file(s) into STSDAS formatted file(s). Disk FITS refers to files (that can be created by IRAF or AIPS) that keep the exact format (e.g. 2880 byte record length) of a FITS tape. STSDAS files have a detached header and 512 byte record length.
DFITSRD_LARGE Convert true disk FITS formatted file(s) into STSDAS formatted file(s). Disk FITS refers to files (that can be created by IRAF or AIPS) that keep the exact format (e.g. 2880 byte record length) of a FITS tape. STSDAS files have a detached header and 512 byte record length.
DFITSREAD Procedure will read a disk FITS file and write to a STSDAS disk file. The header is placed in .HHH and the data is placed in the file .HHD. This procedure is called by DFITSRD which is the procedure that an interactive user would normally use.
DFITSREAD_LARGE Procedure will read a disk FITS file The header is placed in .HHH and the data is placed in the file .HHD. Called by DFITSRD_LARGE
DFITSWRITE Procedure will write an internal SDAS file to a FITS file on disk. Note: Called by DFITSWRT
DFITSWRT Convert ST/SDAS formatted files to true disk FITS formatted file(s). D(isk) fits: refers to files (that can be created by IRAF or AIPS) that keep the exact format (e.g. 2880 byte record length) of a FITS tape. ST/SDAS files: has detached header and 512 byte record length.
DIR Emulates the DCL command DIRECTORY on a VMS machine (On a UNIX cmachine DIR will simply spawn an ls command.)
DISP4 Calculates dispersion for specified GHRS grating position
DISPL_STRETCH To convert a floating point image to byte in a manner that selects a good range Uses the formula: BIMAGE = ((IMAGE-MN)*(255/(MX-MN)) > 0) < 255
DISP_IH Display the values in the Science Header Record
DISP_UDL display the values in the unique data log SUBROUTINE OF HRS_DUMP TO PRINT CONTENTS OF UNIQUE DATA LOG
DMS_IN *NAME: DMS_IN *PURPOSE: Convert an input string of 1, 2 or 3 numbers into decimal degrees. *CALLING SEQUENCE: DMS_IN, dms_str, DEGREES, NPARM *PARAMETERS: dms_str - (REQ) - (0) - (S) - String of 1, 2 or 3 numbers,
DOC_LIBRARY Make a description of one or all of the routines in the IDL User's Library by extracting the templates.
DST_INFO To read in the next section of the header in a DAOPHOT image file.
DTRANS To convert homogeneous data files to a format compatible with the current operating system. DTRANS supports data file conversions between SunOs (Sun-4s, and SPARCStations, ULTRIX (DECstation 3100), VMS (VAX), and DOS (PC's).
DWEK To find the Eli Dwek temperature from the ratio of two Iras bands.
EDT Call the EDT editor to edit a file.
ELK Call the ELK editor to edit a file.
ESS_ACQUIRE ess_acquire Routine to convert ESS .DAT file to an SDAS table files. CALLING SEQUENCE: ess_acquire,name,qualifier,year name - input ESS file name (default extension = .dat) OPTIONAL INPUTS:
ESS_BASE Translate a non-negative decimal integer to either hexadecimal or octal string
ESS_PLOT Routine to plot values in a table created by ess_to_tab
ESS_PRINT ess_print Prints contents of an ESS table file created by ESS_ACQUIRE. CALLING SEQUENCE: ess_print,table[,octflg,columns] table - name of the table file *OPTIONAL INPUT:
EULER Transform between galactic, celestial, and ecliptic coordinates. Use the procedure ASTRO to use this routine interactively
EVE Call the EVE editor to edit a file.
EXTAST Extract astrometry parameters from a FITS image header. The astrometry in the header can be in either CD (Coordinate description) format, or CROTA and CDELT (AIPS-type) format. However, the output astrometry will always be in CD format.
EXTBIT EXTBIT Extract bits from an integer*2 array. Bits may straddle word boundaries. CALLING SEQUENCE: result=getbit(a,pos,first,number) a - integer*2 array pos - word position in the array
EXTRACT THE FUNCTION EXTRACTS PORTIONS OF ARRAYS
FBTAPE Read in a fixed-block ASCII text tape file.
FDECOMP Routine to decompose file name
FEATURE To measure the essential attributes of a spectral feature
FEATURE_OUT To output the results of the feature procedure measurements to text and graphics windows
FILTER PERFORM AN ARBITRARY SYMMETRICAL FILTERING.
FINDMID Function to calculate the mid-time of an GHRS observation using the
FIND_ROOTS Procedure to find root names of Raw HRS OSS files or PODPS files. The rootnames are sorted by observation time.
FIND_STR To search a string for instances of a substring.
FITS2X Read FITS file from tape directly into an IDL image array and FITS header array. One can optionally provide a compression factor to compress the image before writing into the IDL arrays. The procedure is useful for quickly checking the FITS images on a tape. FOR VMS
FITSBYTE To convert an image array from FITS byte ordering to the ordering used by the computer.
FITSLIST Procedure will read FITS files from a tape on the specified tape unit. The headers are placed in file NAME, with the default extension of .LIS. Headers are also displayed at the terminal. FOR VMS IDL ONLY!
FITSRD Interactive procedure to read FITS tape files into SDAS/FITS disk files. FOR VMS IDL ONLY.
FITSRD_LARGE Interactive procedure to read FITS tape files into SDAS/FITS disk files. FOR VMS IDL ONLY.
FITSREAD Procedure to read a FITS file from a tape on the specified tape unit. The header is placed in .HHH and the data is placed in the file .HHD. This procedure is called by FITSRD which is the interactive procedure for normal use. FOR VMS
FITSREAD_LARGE Procedure to read a FITS file from a tape on the specified tape unit. The header is placed in .HHH and the data is placed in the file .HHD. FOR VMS IDL ONLY
FITSTAPE Function to perform FITS tape I/O. Called by FITSREAD. FOR VMS IDL ONLY!
FITSWRITE Procedure will write an internal SDAS file to a FITS tape on the specified tape unit. Called by FITSWRT
FITSWRT Interactive procedure to write internal SDAS file(s) to a FITS tape
FITS_CD_FIX Replace the coordinate description parameters in a FITS header from the underscore form (CD1_1) once favored by Space Telescope to the official 8 character FITS keywords (e.g CD001001)
FIX_ACCUM Recover datapoints in a saturated ACCUM observation
FLAT FLAT transforms the image of a galaxy so that the galaxy appears face-on. Either a nearest-neighbor approximations or a bilinear interpolation may be used.
FLATTEN *NAME: FLATTEN *CLASS: IRAS IMAGE ANALYSIS *CATEGORY: *PURPOSE: Flattens the background of IRAS Skyflux image *CALLING SEQUENCE: FLATTEN,FLUX,XSIZE,YSIZE,FLAT,FIT,X1,Y1,F1,X2,Y2,F2,X3,Y3,F3,X4,Y4,F4
FLUX2MAG Convert from flux (ergs/s/cm^2/A) to magnitudes. Use MAG2FLUX for the opposite direction.
FLUX_RATIO flux_ratio Routine to compute the ratio of flux values in a input flux table with those in a reference table. CALLING SEQUENCE: flux_ratio,flux_tab,ref_tab,ratio_tab flux_tab - flux table name with at minimum the columns
FMEAS To numerically integrate across spectral features and determine common measurements and moments for the line profile.
FNINC Increments FOS filename string by 1
FORM_INT Takes an intensity image, and scales it into a byte array suitable for use with the combined intensity/velocity color table created by
FORM_VEL Takes a velocity image, and scales it into a byte array suitable for use with the velocity color table created by LOAD_VEL.
FORPRINT Print a set of vectors by looping over each index value. If W and F are equal length vectors, then the statement
FOS_BACK fos_back Computes the mean background rate and applies a correction to the input background to make it agree with this mean rate. CALLING SEQUENCE: fos_back,rootname,ctable,rtable,bac,back rootname - observation rootname without an extension.
FOS_BACK_PRED to estimate mean background level for a given FOS exposure
FOS_FIXHDR fos_fixhdr Takes the value from the parameter and if it is non-null then adds it to the header. If the keyword already exists its value won't be replaced unless the replace keyword is set. The new header is written to the input header filename. CALLING SEQUENCE:
FOS_GIMP fos_gimp Computes the earths magnetic field strength in FOS detector coordinates and the image motion offsets for each ystep/slice/readout of an observation. CALLING SEQUENCE: fos_gimp,rootname,table,offsets_x,offsets_y,beff_x,beff_y,bfield, reftable=stable
FOS_SMS Extract all FOS observations from an SMS, listing UT, proposal ID, target ID, instrument configuration and total exposure time. If called with a second parameter, also get FGS and GS info for each obset. CALLING SEQUENCE: sms, smsid [,getgs] INPUT: smsid - year and day number of flight sms (e.g. 91042), or proposal ID for test sms (e.g. 1026), etc. SMS directory is searched
FOS_WAVECALC fos_wavecalc Routine to compute FOS wavelength vector for specified sample positions and dispersion coefficients. CALLING SEQUENCE: fos_wavecalc,fgwa_id,x,coef0,coef1,coef2,coef3,coef4,xzero,w fgwa_id = grating mode
FP_MERGE *NAME: FP_MERGE *CATEGORY: *PURPOSE: Merges multiple spectra from multiple exposures and FP-SPLIT. *CALLING SEQUENCE: FP_MERGE, w, f, er, MW, MF, MER, type *PARAMETERS:
FRQ ************************************************ IRAS Image Processing routine: determines the frequency of stripes in IRAS skyflux images. **CALLING SEQUENCE: frq, image, period_val **PARAMETERS: IMAGE, PERIOD_VAL
FSHIFT Routine to shift an image by non-integer values CALLING SEQUENCE: results = fshift(image,delx,dely) image - 2D image to be shifted delx - shift in x (same direction as IDL SHIFT function) dely - shift in y
FTAB_TO_DB Add FITS table contents to an existing or new database file.
FTADDCOL Routine to add a field to a fits table
FTCREATE Procedure to create a new (blank) FITS table and header with the specified size.
FTDELCOL Delete a column of data from a FITS table
FTDELROW Delete a row of data from a FITS table
FTDIR Provide a brief description of the disk FITS tables on a directory The # of columns and rows, and the name of the first five columns are displayed for each table.
FTGET function to return value(s) from specified column
FTHELP Routine to print a description of a disk FITS table
FTHMOD Procedure to modify header information for a specified field in a FITS table.
FTINFO Procedure to return information on the specified field in a FITS table.
FTKEEPROW Subscripts (and reorders) a FITS table. A companion piece to FTDELROW.
FTPRINT Procedure to print specified columns and rows of a FITS table
FTPUT Procedure to add or update a field in an FITS table
FTREAD Procedure to read an internal FITS table file
FTSIZE Procedure to return the size of a fits table.
FTSORT Sort a FITS table according to a specified field
FTWRITE Procedure to write an FITS table to disk
FUNCT_GAUSS Compute guassian for use by curfit
FXADDPAR Add or modify a parameter in a FITS header array.
FXBADDCOL Modify a basic FITS binary table extension (BINTABLE) header array to define a column.
FXBCLOSE Close a FITS binary table extension that was opened for read.
FXBCREATE Write a binary table extension header to the end of a disk FITS file, and leave it open to receive the data.
FXBFIND Find column keywords in a FITS binary table header.
FXBFINDLUN Find the logical unit number UNIT in the FXBINTABLE common block. Called from FXBCREATE and FXBOPEN.
FXBFINISH Close a FITS binary table extension file that was open for write.
FXBHELP Prints a short description of the columns in a FITS binary table.
FXBHMAKE Create a basic FITS binary table extension (BINTABLE) header array.
FXBOPEN Open a binary table extension in a disk FITS file for reading.
FXBPARSE Parse the binary table extension header, and store the information about the format of the binary table in the FXBINTABLE common block--called from FXBCREATE and FXBOPEN.
FXBPARSETDIM Parse the value of a TDIM-like keyword (e.g. TDIMnnn, TDESC, etc.) to return the separate elements contained within.
FXBPARSETFORM Procedure to return information about the various columns in a FITS
FXBREAD Read a data array from a disk FITS binary table file. INPUT PARAMETERS: UNIT = Logical unit number corresponding to the file containing the
FXBWRITE Write a binary data array to a disk FITS binary table file.
FXFINDEND Find the end of a FITS file.
FXHCLEAN Removes any keywords relevant to array structure from a FITS header, preparatory to recreating it with the proper values.
FXHMAKE Create a basic FITS header array.
FXHREAD Reads a FITS header from an opened disk file.
FXPARPOS Find the position to insert a record into a FITS header. Called from
FXREAD Read the primary array from a disk FITS file. Optionally allows the user to read in only a subarray and/or every Nth pixel.
FXTAPEIO_READ Procedure to copy a FITS file from a tape on the specified tape unit to the disk file .FITS. Data is left in FITS format, and not converted to SDAS. This procedure is called by FXTAPEREAD which is the interactive procedure for normal use. *FOR VMS IDL ONLY*
FXTAPEIO_WRITE Procedure will copy a disk FITS file to the specified tape unit. Used for true disk FITS files, not SDAS/Geis files. Called by FXTAPEWRITE.
FXTAPEREAD Interactive procedure to copy FITS files from tape onto disk. Data is left in FITS format, and not converted to SDAS. *FOR VMS IDL ONLY*
FXTAPEWRITE Interactive procedure to copy disk FITS files to tape.
FXWRITE Write a disk FITS file.
GAUSS TO CALCULATE A GAUSSIAN FUNCTION
GAUSSFITS To fit Gaussians and a polynomial baseline to data points
GCIRC Computes rigorous great circle arc distances.
GETDAT Part of the GHRS SV/OV and GTO ATLAS package created by Dr F Walter
GETDEFPAR procedure to get default parameters from parameter file
GETFILE This function helps the user retrieve a file in IDL. Better than FileView since you can have several disks in your user defined tree under FILETREE.DAT in your SYS$LOGIN directory. See notes for a detailed description. Best when used with Xwindows (or other devices that support the MENU function,) but it is functional in text mode.
GETFILES This procedure allows you to interatively specify a list of files by specifying a single file per line or a range of files separated by a dash or comma.
GETFITS the Sun, then convert the data file into Sun format.
GETLOG Returns the correct logical directory for the given operating system. E.G. dat: for vms, $DAT/ for unix.
GETOPT Function to convert a user's response string into a valid scalar or vector. Distinct elements in the string may be separated by either a comma or a space. The output scalar or vector can be specified to be either integer or floating point. A null string is converted to a zero. !ERR is set to the number of elements supplied. If an input is invalid, !ERR is set to -1 and the result is set to 999.
GETPAR *NAME: GETPAR *CATEGORY: *PURPOSE: HRS parameter processing routine. *CALLING SEQUENCE: GETPAR,parms,dfile,par *PARAMETERS:
GETPRO Extract a procedure from an IDL Library or directory given in the !PATH system variable and place it in the current default directory (presumably to be edited by the user). GETPRO can also be used to obtain a copy of the default startup file.
GETREF GETREF Copies reference files from CDBS directory to user's working directory. CALLING SEQUENCE: getref,reffile [,source [,dest]] reffile - name of file to be copied from 'source' to 'dest' directories. If first character is '@' the following name indicates a pair
GETROT Derive the counterclockwise rotation angle, and the X and Y scale factors of an image, from a FITS image header. First parameter may be either an image header or a CD matrix (in radians).
GETTOK Function to retrieve the first part of the string until the character char is encountered. (eg. if st is 'abc=999' then gettok(st,'=') would return 'abc' and st would be left as 999)
GETVAX Convert source code from the VAX to a DOS computer.
GETWRD Return the N'th word in a string delimited by spaces.
GET_COORDS A general purpose routine that takes user input for angular coordinates and returns floating-point values. The user may input as floating point or sexigesimal. If user inputs RA then it is the calling procedure's job to convert hours to degrees if needed. Since the input string is parsed character-by-character, ANY character that is not a digit, minus sign or decimal point may be used as a delimiter. i.e. acceptable examples of user input are: 1:03:55 -10:15:31 1 3 55.0 -10 15 31 1*3 55 -10abcd15efghij31
GET_IDAT Part of the GHRS SV/OV and GTO ATLAS package by F Walter.
GET_VAL *NAME: GET_VAL *PURPOSE: Prompts for an input value. User supplies the prompt and a default value. *CALLING SEQUENCE: X = GET_VAL( default, prompt ) *PARAMETERS:
GGM calculates geomagnetic longitude (mlong) and latitude (mlat) from geographic longitude (longi) and latitude (lati) for art=0 calculates reverse for art=1
GHRS2IUE *NAME: GHRS2IUE Data Conversion *CATEGORY: *PURPOSE: Convert GHRS CALIBRATED data files to IUE format(H,W,F,E). *CALLING SEQUENCE: GHRS2IUE, name, H, WAVE, FLUX, EPS, [ERR, type=type]
GLACTC Program to convert right ascension (ra) and declination (dec) to galactic longitude (gl) and latitude (gb) (j=1) or vice versa (j=2). Calling Sequence: glactc,ra,dec,year,gl,gb,j
GRIDTERP This is a linear interpolation procedure to operate properly on IUE data. The flux, gross, and back vectors are interpolated, but the eps vector is set to the minimum of the two relevant values. This routine will work fast ! You can interpolate to a 3000 point grid in about 13 seconds when all 5 output vectors are desired, faster if you only care about flux and eps.
GS_IMAGE To scale an image according to a color table
HASTROM Perform a linear transformation (with POLY_2D) on an image so that its astrometry is identical with that in a reference header. This procedure is used to align two images.
HBOXAVE Box average an image array using the function BOXAVE and update the header array
HCONGRID Expand or contract an image using CONGRID and update the
HCONS To get the floating point and byte arrays of all the hcons of one band of an image.
HEADFITS Read a FITS file header record
HELIO Compute (low-precision) Heliocentric coordinates for the planets. Adapted from the book Celestial Basic
HEXTRACT Extract a subimage from an array and create a new header with updated astrometry for the subarray
HOST_TO_IEEE To translate an IDL variable from IEEE-754 representation (as used, for example, in FITS data ), into the host machine architecture.
HP *NAME: HP (... Hyperbolic Paraboloid) *CLASS: GENERAL *CATEGORY: belongs to IRAS image analysis routines *PURPOSE: fits hyperbolic paraboloid through 4 points (exact fit) *CALLING SEQUENCE: HP,XSIZE,YSIZE,Z, X1,Y1,Z1, X2,Y2,Z2, X3,Y3,Z3, $ X4,Y4,Z4
HPRECESS Precess the astrometry in a FITS header to a new equinox
HPRINT Print a FITS header (or any other string array) at the the terminal by printing 1 line at a time. Needed because IDL Version 2 will add an extra space to the 80 character FITS lines, causing a space to appear betweeen lines.
HREBIN Expand or contract an image using REBIN and update the header array. The size of the new image must be an integer factor of the original image size.
HREVERSE Reverse an image about either the X or Y axis, and create a new header with updated astrometry for the reversed image.
HROT Rotate an image (bilinear or nearest neighbor) and create a new header with updated astrometry for the rotated image.
HRSHELP *NAME: HRSHELP *CATEGORY: *PURPOSE: Generate listing of FOS documentation for input file. *CALLING SEQUENCE: HRSHELP, procedure_name *PARAMETERS:
HRSPLOT Display QUICK-LOOK plot of GHRS calibrated data.
HRS_2DSPEC Create 2D array from a series of GHRS spectra.
HRS_ACQUIRE *NAME: HRS_ACQUIRE *PURPOSE: Routine to convert HRS_GEIS files to .SCI and .PLH files *CALLING SEQUENCE: hrs_acquire,files,tape_number *PARAMETERS: files - file specification, eg. 'z00*'
HRS_ACQUIRE_CAL *NAME: HRS_ACQUIRE_CAL *PURPOSE: Subroutine of hrs_acquire to process calibrated data files *CALLING SEQUENCE: hrs_acquire_cal,present,root,name,h *PARAMETERS: present - flags set to 1 if .shh file is present
HRS_ACQUIRE_PLH hrs_acquire_plh *PURPOSE: Subroutine of hrs_acquire to create output processing logs *CALLING SEQUENCE: *PARAMETERS: version - version number of hrs_acquire present - flags showing which GEIS files are present
HRS_ACQUIRE_RTB *NAME: HRS_ACQUIRE_RTB *PURPOSE: Subroutine of hrs_acquire to process return to brightest point data files *CALLING SEQUENCE: hrs_acquire_rtb,present,name,out,h *PARAMETERS:
HRS_ACQUIRE_SDP *NAME: HRS_ACQUIRE_SDP *PURPOSE: Subroutine of hrs_acquire to process ghrs science data files *CALLING SEQUENCE: hrs_acquire_sdp,present,name,binids,out,h *PARAMETERS: present - flags set to 1 if .d0h, .x0h, .q0h, .dqh files are present
HRS_ACQUIRE_SHP *NAME: HRS_ACQUIRE_SHP *PURPOSE: Subroutine of hrs_acquire to process standard header packets *CALLING SEQUENCE: hrs_acquire_shp,present,name,out,h *PARAMETERS: present - flag set to 1 if .shh file is present
HRS_ACQUIRE_UDL *NAME: HRS_ACQUIRE_UDL *PURPOSE: Subroutine of hrs_acquire to process unique data logs *CALLING SEQUENCE: hrs_acquire_udl,present,name,out,binids,h *PARAMETERS: present - flag set to 1 if .ulh file is present
HRS_CLOSE *NAME: HRS_CLOSE *CATEGORY: *PURPOSE: Procedure to close a GHRS science data file and update the header of the file if it was opened for update or write. *CALLING SEQUENCE: HRS_CLOSE,ioblock
HRS_COMBINE *NAME: HRS_COMBINE Data Reduction *PURPOSE: Combine the different readouts in a GHRS data file into a single spectrum. *CALLING SEQUENCE: HRS_COMBINE, name, wtype, ftype, Wl, FL_TOT, VAR, EPS, ERR,/swidth
HRS_DBASE Copy and convert GHRS/IDL database from VAX to SUN computer.
HRS_DUMP Routine to dump hrs science data files
HRS_DUMP_SDP PRINT A DUMP OF THE HRS Standard Data Packet
HRS_DUMP_SHP SUBROUTINE OF HRS_DUMP TO PROCESS STANDARD HEADER PACKETS
HRS_DUMP_UDL SUBROUTINE OF HRS_DUMP TO PRINT CONTENTS OF UNIQUE DATA LOG
HRS_ECH_MODE Read list of order vs wavelength
HRS_FLAT hrs_flat Return the line of the flat field file relevant to observation specfied CALLING SEQUENCE: hrs_flat,id,flat id - observation ID flat - flat field (from flat field lamp observation) at y-deflection
HRS_GIMP hrs_gimp Routine to compute the earth's magnetic field in GHRS detector coordinates CALLING SEQUENCE: hrs_gimp,id,juldates,beff_x,beff_y,bfield,delta_t,jd1,jd2 id - observation id juldates - modified julian dates at midpoint of each readout
HRS_MERGE Merge data from an GHRS fp-split or WSCAN observations.
HRS_MODE hrs_mode Routine to return the observation mode of a file previously opened by HRS_OPEN. CALLING SEQUENCE: hrs_mode,ioblock,detector,grating,sdtype,nreads ioblock - file description record returned by HRS_OPEN
HRS_OFFSET *NAME: HRS_OFFSET Data Reduction *CATEGORY: *PURPOSE: Determine the shift (in pixels) of one spectrum with respect to another. *CALLING SEQUENCE:
HRS_OPEN *NAME: HRS_OPEN *PURPOSE: Routine to open an GHRS science data file. *CALLING SEQUENCE: hrs_open, name, ioblock [,access,ident,log,unit] *PARAMETERS: INPUTS:
HRS_ORBIT Routine to plot GHRS orbit for the period covered by the given observation id.
HRS_READ *NAME: HRS_READ *CATEGORY: *PURPOSE: Read data for HRS science file *CALLING SEQUENCE: HRS_READ,ioblk,type,IH,DATA [,readout] *PARAMETERS:
HRS_REVIEW *NAME: HRS_REVIEW *PURPOSE: list contents of hrs science file *CALLING SEQUENCE: hrs_review,ioblcok *PARAMETERS: ioblock - ioblock returned by HRS_OPEN or the name of the
HRS_SHIFT Compute shifts between spectra covering the same wavelength region.
HRS_START_END Extracts the start and end time of observations (incl. header)
HRS_SUMMARY Procedure to print summary of HRS science data files
HRS_WAVECOR Correct GHRS wavelength array using measured offsets between input
HRS_WRITE hrs_write write to GHRS science data file CALLING SEQUENCE hrs_write,ioblock,ih,data ioblock - file description vector returned by HRS_OPEN ih - 128 x N integer*2 array of record headers where N
HST_LAT_LONGT This program determines the latitude and longtitude of the HST between the start to end times.
HST_ORBIT A procedure to plot a world map, SAA contours from the PDB, and the HST subsatellite point for each minute between (and including) specified start
HST_PLOT A procedure to overplot HST latitude and longitude during specified start and end times.
HST_POS A procedure to calculate the HST latitiude and longitude for provided julian_dates
IDL_OS Procedure returns the IDL names for a computer architecture and Operating System (see IDL system variable !version)
IEEE_TO_HOST To translate an IDL variable in IEEE-754 representation (as used, for example, in FITS data ), into the host machine architecture.
IGRF Calculate the International Geomagnetic Reference Field for given input conditions
IMCONTOUR Contour plot labeled with astronomical coordinates. The type of coordinate display is controlled by the keyword TYPE Set TYPE=0 (default) to measure distances from the center of the image (IMCONTOUR will decide whether the plotting units will be in arc seconds, arc minutes, or degrees depending on image size.) Set TYPE=1 for standard RA and Dec labeling
IMDBASE Locate sources within a specified catalogue that are within a
IMF Returns values of a two-component power-law initial mass function, normalized so that the total mass distribution equals one solar mass.
INTEG To numerically integrate tabulated data using the trapezoid rule.
INTEGRAL integral Routine to perform trapezoidal integration in X,Y between limits xmin to xmax. CALLING SEQUENCE: result = integral(x,y,xmin,xmax) x,y - vectors to be integrated
INTEGRAL2 integral Routine to perform trapezoidal integration in X,Y between limits xmin to xmax. CALLING SEQUENCE: result = integral(x,y,xmin,xmax) x,y - vectors to be integrated
IRAFDIR Provide a brief description of the IRAF images on a directory
IRAFRD Open an IRAF file and read into an array. Program will prompt for the file name if not supplied. Keyword vms included to indicate a file that was copied from a VAX so appropriate byteordering will be performed.
IR_PLANCK gives the blackbody flux (i.e. pi*intensity) ergs/cm2/s from allen astrophysical quantities section 44
ISARRAY Determine if arg is an array.
ISERNO called for values in ISER that have multiple copies, to use most recently
IUEFETCH *NAME: IUEFETCH *CATEGORY: *PURPOSE: Retrieve data from a file created with routine IUESAVE. *CALLING SEQUENCE: IUEFETCH,NAME,H,WAVE,FLUX,EPS *PARAMETERS:
IUEFX IUEFX *CATEGORY: To submit an IUE archive request using the NDADS REQUEST command. Files are automatically converted to RDAF format and transferred to the specified directory. *CALLING SEQUENCE:
IUEGWY Procedure to retrieve an extracted file via the GATEWAY (form of IBM/DEC network) resident on the GSFC-SCF (IBM 3081).
IUESAVE Save IUE data on a disk file for later retrieval by IUEFETCH.
IUE_DETERM TO CALCULATE THE DETERMINANT OF A SQUARE MATRIX
IUE_SPLINE PREFORM SPLINE INTERPOLATIONS OR INTEGRATIONS
JDCNV Converts Gregorian dates to Julian days
JULDATE Convert from calender to Reduced Julian Date
JUL_DATE jul_date A function to calculate the Julian Date - 2400000 CALLING SEQUENCE: result = jul_date(time) time - string or string array giving times in form: DD-MMM-YYYY HH:MM:SS.S
KURUCZ JULY 1, 1983 Generates Kurucz fluxes and continuum for the 284 models presented in AP J SUPPL 40,1,1979.
LAT_LONGT_PLOT Overplot latitude and longitude grid and labels(optional) on existing plot.
LINEID To search the Kelly & Palumbo line list for identified UV spectral lines within a given range of wavelengths. This procedure provides a link between the point.pro and kandp.pro procedures.
LINEID_PLOT lineid_plot Plot spectrum with specified line identifications annotated at the top of the plot. CALLING SEQUENCE: lineid_plot,wave,flux,wline,text1,text2,charsize=charsize, $ extend = extend, charthick = charthick
LINFIT To make a least squares fit to data with a straight line: Y = A + B*X (IDL version of Bevington's LINFIT program)
LINT *NAME: LINT *CATEGORY: *PURPOSE: For linear interpolation of GHRS bins. *CALLING SEQUENCE: LINT, ww, ff, WMERGE, FMERGE *PARAMETERS:
LINTERP To linearly interpolate tabulated data from one data grid to another.
LKDAT Calling sequence: LKDAT, idat0, n1, n2
LOADBW similar to LOADCT in that it loads predefined lookup tables but loads only grey scale tables
LOAD_VEL Loads a velocity color table. Velocity arrays can be scaled for display for this color table using FORM_VEL.
LPLT *********************************************************** ro lplt,dev
LUCY_GUESS *NAME: LUCY_GUESS *PURPOSE: Richardson-Lucy alg. for deconvolving spectra using Bayesian methods. Requires the point spread function. *CALLING SEQUENCE: LUCY_GUESS, n_iter, f, psf, new, guess=guess, conv_guess=conv_guess *PARAMETERS:
LYMANA To correct a spectral segment for interstellar extinction by HI Lyman
MAG2FLUX Convert from magnitudes to flux (ergs/s/cm^2/A). Use FLUX2MAG for the opposite direction.
MAKEMELO2 MAKEMELO2 AUGUST 11, 1989 Extraction Format Conversion *CATEGORY: *PURPOSE: Creates a new MELO .DAT and .LAB file from ELBL or LBLS data arrays
MAKE_2D Convert an N element X vector, and an M element Y vector, into N x M arrays giving all possible combination of X and Y pairs. Useful for obtaining the X and Y positions of each element of a regular grid.
MAKE_CONTINENT Create the CONTINENT.DAT file on any computer (ie. UNIX or DOS)
MAKE_DOS Used to transfer files from the VAX or SUN to a DOS computer. The main purpose of the routine is to append all .PRO files together into one large dataset.
MAKE_HELP Extract documentation from programs in an IDL version 2 library format it in a form for a HELP library
MAN_PROC Provides online documentation for IDL topics. If the current graphics device supports widgets, a graphical user interface is used. Otherwise, a more basic version which is a cross between Unix man pages and VMS online help is used. The help is organized in a two level hierarchy --- Level 1 is the global subject, and Level 2 supplies help on subjects within each global subject.
MATCH Routine to match values in two vectors.
MEDARR To combine a series of arrays into a single array by filling each pixel in the output array with the median of the corresponding pixels in the input arrays.
MERGECAR mergecar Routine to merge data from different carrousel positions by binning data into equal wavelength bins. CALLING SEQUENCE: mergecar,idlist,params,table idlist - integer list of observation id numbers or
MID_RD_DISDSC Get a MIDAS directory descriptor from a MIDAS BDF.
MID_RD_IMAGE Get a pixel matrix and some support information from a MIDAS file.
MID_RD_TABLE Open and read data from a MIDAS table.
MID_UP_IMAGE Get a pixel matrix and some support information from a MIDAS file. Allow updating of data, using DATA.
MID_UP_TABLE Open and update data from a MIDAS table.
MINMAX Return a 2 element array giving the minimum and maximum of a vector or array. This is faster than doing a separate MAX and MIN.
MJD_TO_DATE *NAME: MJD_TO_DATE *CLASS: UTILITY *CATEGORY: HRS_ACQUIRE subroutine *PURPOSE: Converts Modified Julian Date to YYDDD.FFF *CALLING SEQUENCE: MJD_TO_DATE,mjd,DOY,DATE
MJD_TO_DATE2 *NAME: MJD_TO_DATE2 *CLASS: UTILITY *CATEGORY: HRS_ACQUIRE subroutine *PURPOSE: Converts Modified Julian Date to YYDDD.FFF *CALLING SEQUENCE: date = MJD_TO_DATE2(mjd [,DOY])
MJD_TO_STRING mjd_to_string convert modified Julian date to a string date CALLING SEQUENCE: result = mjd_to_string(mjd) mjd - modified Julian date str - date string
MKHDR Make a FITS image header with required keywords. If an image array is supplied, then the header will be appropiate to that array. Otherwise, the user can specify the dimensions and datatype.
MOONPOS To compute the RA and Dec of the Moon at a given date.
MP_BASIC Provides on-line documentation for IDL topics. The style is a cross between Unix man pages and VMS on-line help. The help is organized in a two level hierarchy --- Level 1 is the global subject, and Level 2 supplies help on subjects within each global subject. If !D.WINDOW is not -1, (window system in use) the mouse is used to prompt for subjects; otherwise, the normal tty interface is used. This routine is used when in Widget IDL and widgets are not available.
NETABORT Tests whether the Interlink connection between the cluster and the IBM 3081 is up. Does RETALL (aborts all levels of IDL code)
NINT Nearest integer function
NORM Continuum normalization using either straight line segment approximations to the continuum, polynomial fits, or cubic spline fits.
NORM2 Continuum normalization using either straight line segment approximations to the continuum, polynomial fits, or cubic spline fits.
NULLTRIM Function to trim a string of all characters after and including the first null character (ascii 0)
N_BYTES To return total number of bytes in data element
OPT_FILTER *NAME: OPT_FILTER *PURPOSE: Removes noise from a spectrum using an Optimum filter technique. *CALLING SEQUENCE: OPT_FILTER, spec, CSPEC *PARAMETERS: spec - (REQ) - (0) - (I,R,L,D) - Original flux.
OSFCNVRT Returns the correctly formatted logical directory syntax for the host operating
PARCHECK to check that a procedure has been called with the minimum of allowed number of parameters.
PARJUST To right justify numerical values in parameter string array
PARSE_STR ????
PCHECK this procedure is used to check the parameters of a procedure for correct type and dimensions variable - variable to be checked postion - parameter position of the variable dimension- valid dimensions (3 digit integer) each digit must be 0 or 1
PDSHEAD Print the header information from a PDS tape record. This procedure is called by PDSRD
PDSRD Procedure to read any record or range of records from a PDS tape. Image can be ANY size up to 8192 x 4096. If no variable is supplied tape will still be read and checked for parity errors. Parity errors will be displayed on screen, but will not stop the procedure. Output array will be reduced in size by a factor of nbox. FOR VMS IDL ONLY.
PIXCOLOR Assign colors to specified pixel values in a color lookup table
PLANCK TO CALCULATE THE PLANCK FUNCTION IN UNITS ERGS/CM2/S/A
PLANE *NAME: PLANE *CLASS: GENERAL *CATEGORY: belongs to IRAS image analysis routines *PURPOSE: fits plane through 4 points (least squares fit) *CALLING SEQUENCE: PLANE,XSIZE,YSIZE,Z, X1,Y1,Z1, X2,Y2,Z2, X3,Y3,Z3, $ X4,Y4,Z4
PLOTCLOSE Routine to close plot file opened by plotopen.
PLOTOPEN procedure to open plot journal file
PLOTPRINT Sends a plot file create using PLOTOPEN to the HRS laser printer.
POINT POINT (General IDL Library 01) JANUARY 14, 1981 spectral lines, measurement *PURPOSE: To interactively measure the wavelength and flux at (a) point(s) defined by the intersection of the graphics cursor cross-hairs. *CALLING SEQUENCE: POINT,WAVE,FLUX,mode,/log
PRECESS Precess coordinates from EPOCH1 to EPOCH2. For interactive display, one should use ASTRO which calls PRECESS.
PRECESS_CD Precess CD (coordinate description) matrix from a FITS header from EPOCH1 to EPOCH2. Called by HPRECESS
PREDICT_GHRS Predicts the observed GHRS spectrum from a given instrumental configuration (e.g. grating, aperture, exposure time, etc) using UV flux information supplied by the user.
PREDICT_RD_SENS Read calibration sensitivity curves for routine PREDICT_GHRS
PREDICT_READ Read input datasets for routing PREDICT_GHRS
PREPARE_SPEC *NAME: PREPARE_SPEC *PURPOSE: Prepares a spectrum for Fourier transforming. *CALLING SEQUENCE: PREPARE_SPEC, cspec, CSPEC1 *PARAMETERS: cspec - (REQ) - (1) - (I,R,L,D) - Raw flux.
PSF_CONSTRUCT *NAME: PSF_CONSTRUCT *PURPOSE: Construction of point spread functions for the GHRS using FOC data. *CALLING SEQUENCE: PSF_CONSTRUCT, filter_name, X, CON, Y, PSF_BINNED, PPB, GAUSS, decenter= decenter *PARAMETERS:
PSVCAT *NAME: PSVCAT *CATEGORY: *PURPOSE: Plot spectra from GHRS SV catalogs (type 7 or 8 only) *CALLING SEQUENCE: psvcat,dev,catname,n1,n2 *PARAMETERS:
PUTAST Put astrometry parameters into a given FITS header.
QMS_CT To load a color table that has the same scaleing as IRAS_GS_QMS.
QUADTERP Quadratically interpolate (3 point Lagrangian) a function Y = f(X) at specified grid points. Use LINTERP for linear interpolation
RADEC To convert right ascension and declination from decimal degrees to sexigesimal hours (for R.A.) and degrees( for Dec.).
RDCCS8 Reads in the ccs8 background geomagnetic field rates table and constructs an array of rate values and corresponding vectors for geomagnetic lattitude and longitude. CALLING SEQUENCE: rdccs8,table,det,lat,lon,rate table - stsdas table name containing rates
READCOL Read an ASCII data file with columns of data into IDL variables. Lines of data not meeting the specified format (e.g. comments) are ignored. Columns may be separated by commas or spaces.
READFITS Read a FITS file into IDL data and optionally header variables.
READ_DST To read a DTA image file (default extension = .DST) of the format used by DAOPHOT (CalTech data structure) from disk into an IDL array.
READ_KEY To read a keystroke and return its ASCII equivalent, unless an ESCAPE sequence was produced. In that case, if the sequence is recognized, a code is returned.
READ_SPEC Procedure to read an SDAS table and return the wavelength, flux and eps vectors
READ_VAX_BLOCK Reads one block from a VAX Fortran unformatted file.
REDSHIFT Converts between redshift, Recession velocity, and Distance for any given Hubble constant. Also displays angular size equivalence and photometric information.
REGRESS Multiple linear regression fit. Fit the function: Y(i) = A0 + A(0)*X(0,i) + A(1)*X(1,i) + ... + A(Nterms-1)*X(Nterms-1,i)
REMCHAR Remove all appearances of character (char) from string (st)
REMOVE_TABS Remove tabs from an ASCII dataset.
REM_DUP *NAME: REM_DUP *PURPOSE: Function to remove duplicate values from a vector. *CALLING SEQUENCE: result=rem_dup(a,flag) *PARAMETERS: a - vector of values from which duplicates are to be found
REPCHR Replace all occurences of one character with another in a text string. (Use the procedure REPSTR to replace more than one character.)
REPSTR String substitution as in many text editors. Replace all occurences of one substring by another.
RESTGAP Part of the GHRS SV/OV and GTO ATLAS package created by Dr F Walter
RINTER Cubic interpolates an image at a set of reference points points. Optionally obtain the X and Y derivatives at
RIPPLE_COEF ripple_coef Procedure to compute echelle ripple "fudge factors" CALLING SEQUENCE: ripple_coef,table,params,outtab table -table name to compute coefficients for. these table(s) are normally generated by routine
RIPPLE_COMP ripple_comp function to compute HRS ripple CALLING SEQUENCE: RESULT = ripple_comp(m,carpos,blaze,delta,r0,norm,a,b) m - spectral order(s) carpos - carrousel position(s)
RIPPLE_FIT ripple_fit Procedure to compute echelle ripple "fudge factors" CALLING SEQUENCE: ripple_fit,tables,params,outtab tables - list of table names to compute coefficients for. these table(s) are normally generated by routine
RIPPLE_FUNCT ripple_funct Routine to compute ripple function. CALLING SEQUENCE: ripple_funct,X,PAR,F,ISEL,DF INPUT PARAMETERS: x - 2-D vector of order and carrrousel positions
RIPPLE_PEAK ripple_peak Routine to tabulate the flux at the carrousel position corresponding to the echelle blaze angle. CALLING SEQUENCE: ripple_peak,table,grattab,peak_tab table - name of the echelle order profile table, normally generated
RIPPLE_PLOT ripple_plot procedure to plot echelle ripple data generated by routine CENTERFLUX, RIPPLE_FIT, or RIPPLE_COEF. CALLING SEQUENCE: ripple_plot,table,params table - name of the table file to plot
ROTATE_3D rotate_3d rotation of 3-D vector(s) a specfied angle about a specified axis CALLING SEQUENCE: rotate_3d,angle,axis,vector theta - angle to rotate in degrees axis - axis number 1 - first axis
SCREEN_SELECT Routine to allow a user to make an interactive screen selection from a list (array) of strings. This procedure determines whether to use the x-windows version or the non-x-windows version by examining the !d.name system variable.
SCREEN_SELECT_O Routine to allow a user to make an interactive screen selection from a list (array) of strings. This assumes a non-x-windows device.
SCREEN_SELECT_X Routine to allow a user to make an interactive screen selection from a list (array) of strings. This assumes an x-windows device.
SCR_ATTRIB To set the screen attribute to those given, in the given order.
SCR_CHARSET To change the character sets.
SCR_CURMOV To mov the cursor around the screen relative to its original position.
SCR_CURPOS To position the cursor at the specified screen location. Unspecified coordinates are set to one. Please note that the ESCAPE sequence expects the coordinates to be counted from (1,1).
SCR_ERASE To erase portions of the terminal screen.
SCR_OTHER To allow the user to issue any ESCAPE sequence.
SCR_RESET To reset the terminal.
SCR_SCROLL To define the scrolling area on the screen. Please note that the line coordinates should be counted from 1.
SC_TIME Function to convert from spacecraft time to UT.
SDF_EXTRACT sdf_extract Routine to extract relevant rows from SDF test ESS table. The output table will have one row for each time the ZICS2 goes from 0 to 4. CALLING SEQUENCE: sdf_extract,table,table_out,deltat
SDF_UPDATE SDF_UPDATE Update the SDF status code field in an ESS table. Assumes table has been modified by routine SDF_EXTRACT. table - ESS table file *OPTIONAL INPUT: sdf_file - text file contains SDF update parameters. The
SETPARVAL setparval procedure to change a parameter value setparval,st,names,par st - new parameter value (string) 'name=value' names - string array of parameter names INPUT/OUTPUT:
SFIT driver routine for splinefit to compute least squares spline with equally spaced nodes. CALLING SEQUENCE: fit = sfit(x,y,nodes,xs,ys) x - x data vector y - y data vector
SF_GFITS Perform gaussian fit - adapted from routine GAUSSFITS
SF_PLOT_RES Procedure to plot the results of the curve fitting calculation
SF_WRTFITS Display results of the calculation (SPEC_FIT).
SHP_DECODE Decode selected values in a standard header packet
SIGMA Calculate the standard deviation value of an array, or calculate the standard deviation over one dimension of an array as a function of all the other dimensions.
SIGRANGE Selects out the most significant range in the data to be used in displaying images.
SINCE_VERSION Determine if the current release of IDL (as given in the !VERSION.RELEASE system variable) comes after the user specified release.
SIXTY Converts decimal number to sexigesimal. Reverse of TEN function.
SMS_FIELDS *NAME: SMS_FIELDS *PURPOSE: Uses a template (.def) to load the title, categories, and field names for an HST SMS Review Page. *CALLING SEQUENCE: sms_fields, SMS_DATA_FILE, cat_info *PARAMETERS:
SMS_PARSE_LINE *PURPOSE: Scan a line (line) of an SMS and parse the fields (items), and extracts the values for those fields (results). *PARAMETERS: line - (string) - a single line from the SMS Review Pages. items- (strarr) - names of SMS fields to be searched for the a single line of the SMS Review Pages.
SMS_XREF *PROCEDURE: - Reads in the SMS Cross Reference (xref) table which associates a field in the the SMS review page to a particular database item name. - The format of the xref file is: dbase_name, sms_name, load_flag, comment
SPEC_DIR Provide a complete file specification by appending a default disk or directory if necessary.
SPEC_FIT Procedure to determine the properties of a spectrum
SPLIE2 Given an M by N tabulated function YA, and tabulated independent variables X1A (M values) and X2A (N values), this routine constructs one-dimensional natural cubic splines of the rows of YA and returns the second derivatives in the array Y2A. Numerical Recipes, 1986. (page 100) CALLING SEQUENCE:
SPLIN2 Given X1A, X2A, YA, M, N as described in SPLIE2.PRO and Y2A as produced by that routine, and given a desired interpolating point X1, X2, this routine returns an interpolated function value Y by bicubic spline interpolation. Numerical Recipes, 1986. (page 101) CALLING SEQUENCE: splin2,x1a,x2a,ya,y2a,m,n,x1,x2,y
SPLINEFIT Non-linear least squares fit to a cubic spline function of an arbitrary number of nodes. Numerical Recipes, natural cubic spline is used.
SPLINF Given arrays X and Y of length N containing a tabulated function, i.e. Yi = f(Xi), with X1 < X2 < ... < Xn, and given values YP1 and YPN for the first derivative of the interpolating function at points 1 and N, respectively, this routine returns and array Y2 of length N which contains the second derivatives of the interpolating function at the tabulated points Xi. If YP1 and/or YPN are equal to 1.E30 or larger, the routine is signalled
SPLINT Given arrays XA and YA of length N, which tabulate a function (with the XA's in order), and given the array Y2A, which is the output from SPLINE.PRO, and given a value of X this routine returns a cubic-spline interpolated Numerical Recipes, 1986. (page 89) CALLING SEQUENCE: splint,xa,ya,y2a,n,x,y
SQUARE_PORT *NAME: SQUARE_PORT *CATEGORY: GRAPHICS Same calling sequence as set_viewport. The routine adjusts the viewport in the x or y direction (which ever is larger) so that the plot is square. * Calling Sequence: square_port [, x1, x2, y1, y2 ]
SSREAD ROUTINE TO READ STANDARD STAR DATA TABLE
STANDARD_MERGE *NAME: STANDARD_MERGE *CATEGORY: *PURPOSE: Merge FP-SPLIT subexposures and multiple exposures to single vector. *CALLING SEQUENCE: STANDARD_MERGE, w, f, er, SW, SF, SER, type *PARAMETERS:
STARAST Compute an exact astrometry solution using the positions and coordinates from 2 or 3 reference stars. If 2 stars are used, then the X and Y plate scales are assumed to be identical, and the axis are assumed to be orthogonal. Use of three stars will allow a unique determination of each element of the CD matrix.
STAR_PLOT To mark stars on a contour plot
STRBLK to remove all blanks from a string
STRD Open an SDAS file and read into an array. Combines the functions of SXREAD and SXOPEN. Program will prompt for the file name
STRDEC to convert a string array, which each element has the three components of degrees (hr,min,sec), to a floating point array
STREBCASC Function to converts an EBCDIC string scalar or array to its ASCII equivalent. Similar to the IDL Version 1 routine of the same name.
STRINGAD Converts a string of sexigesimal coordinates to their
STRN The main and original purpose of this procedure is to convert a number to and unpadded string (i.e. with no blanks around it.) However, it has been expanded to be a multi-purpose formatting tool. You may specify a length for the output string; the returned string is either sut to that length or padded to be that length. You may specify characters to be used in padding and which side to be padded. Finally, you may also specify a format for the number. NOTE that the input "number" need not be a number; it may be a string, or anything. It is converted to string.
STRNAM to remove all characters that cannot be used in a file name from a string : !, @, #, $, %, ^, &, *, (, ), [, ], {, }, <, >, -, +, , =, ~, `, |, \, ;, , :, ", ', , , ., ?, /
STRNUMBER Function to determine if a string is a valid numeric value.
STRPUTS ????
STSUB READ A SUBSET OF A SPACE TELESCOPE SDAS IMAGE FILE
STSUBIM Open an SDAS file and read a portion of the file into an array. An enhanced version of STRD. Program will prompt for the file name and subimage bounds.
STWRT Write an SDAS header and/or 2-D array to disk (without groups!)
ST_DUMP Routine to dump raw generic data file (GEIS files).
ST_DUMP_HEADER subroutine of st_dump to print contents of the header h from lines beginning at keyword1 to the line containing
ST_DUMP_SDP SUBROUTINE OF st_dump TO PRINT SCIENCE DATA PACKET
ST_DUMP_SHP SUBROUTINE OF st_dump TO PROCESS STANDARD HEADER PACKETS
ST_DUMP_UDL SUBROUTINE OF st_dump TO PRINT CONTENTS OF UNIQUE DATA LOG
ST_GEOMAG st_geomag Compute earths magnetic field in ST coordinates (V2,V3,V1) CALLING SEQUENCE: st_geomag,log,year,juldates,bfield log - fits header containing the ST orbital and pointing parameters year - observation time in years (eg. 1991.12)
ST_SUMMARY Procedure to print summary of raw PODPS or OSS data files
ST_TALLY A procedure to search through a directory and check which GEIS files are available for each observation
ST_TAPELIST *NAME: ST_TAPELIST *CATEGORY: *PURPOSE: Routine to read an ST FITS tape and print summary. *CALLING SEQUENCE: ST_TAPELIST,unit,[tapeid,verify,first_file,last_file] *PARAMETERS:
ST_TAPEREAD *Routine to read an ST FITS tape and reconstruct GEIS files
ST_TAPEWRITE Write FITS tape in ST GO format
ST_TAPEWRITE_D st_tapewrite_d Subroutine of st_tapewrite to scale and write the data portion of the FITS file CALLING SEQUENCE: st_tapewrite_d,scale,bzero,bscale,bitpix,gcount,data_present,data scale - flag set to 1 if data is to be scaled
ST_TAPEWRITE_HD st_tapewrite_hd subroutine of st_tapewrite to write the FITS header to the tape CALLING SEQUENCE: st_tapewrite_hd,header header - fits header (string array) version 1 D. Lindler Aug. 1991
ST_TAPEWRITE_IO st_tapewrite_io Tape I/O subroutine for st_tapewrite.pro CALLING SEQUENCE: st_tapewrite,'INIT',unit,nblocks Initialization st_tapewrite,'SKIP' Skip to next 2880 block st_tapewrite,'CLOSE' close output file
ST_TAPEWRITE_TB st_tapewrite_tb Subroutine of st_tapewrite which writes the group parameters to a table extention CALLING SEQUENCE: st_tapewrite_tb,h,pcount,gcount h - original header of the GEIS (SDAS image) File
ST_TAPE_DATA Routine to read next header and data array from ST fits tape. This is a subroutine of st_taperead and not intended for stand alone use.
ST_TAPE_GEIS Routine to construct GEIS files from ST FITS data read from tape. This is a subroutine of st_taperead.
ST_TAPE_IEEE Convert IEEE real*4 and real*8 values to VAX internal representation
ST_TAPE_TABLE Routine to read FITS table from an ST fits tape. This is a subroutine of st_taperead and not intended for stand alone use.
SUM *NAME: SUM *CATEGORY: *PURPOSE: Total up an array over one of its dimensions. *CALLING SEQUENCE: RESULT = SUM(ARRAY,DIMENSION) *PARAMETERS:
SUMC To sum an array over one dimension.
SUNPOS To compute the RA and Dec of the Sun at a given date.
SWAP_BYTES To perform the byte reordering required for conversion of integer, longword, floating point, or double precision variables between various machine representations.
SXADDHIST Procedure to add history line(s) to FITS header
SXADDPAR Add or modify a parameter in a FITS header array.
SXDELPAR Procedure to delete a keyword parameter(s) from a FITS header
SXGPAR SXGPAR obtain group parameter value in SDAS/FITS file CALLING SEQUENCE: result = sxgpar(h,par,name,type,sbyte,nbytes) h - header returned by SXOPEN par - parameter block returned by SXREAD or multiple
SXGREAD Read group parameters from a Space Telescope STSDAS image file
SXHCOPY Copies selected portions of one header to another
SXHEDIT Routine to interactively edit a SDAS header on diskusing EDT if on a VAX, or EMACS if on a SUN..
SXHMAKE Create a basic St header file from an IDL data array
SXHREAD Procedure to read a FITS header from disk. This version of SXHREAD can read three types of disk files (1) VMS Fixed record length 80 byte files (2) Unix stream files with a CR after every 80 bytes (3) Variable length record files
SXHWRITE Procedure to write an SDAS Fits header to disk
SXMAKE Create a basic St header file from an IDL Array before writing data.
SXMERGE Routine to merge SDAS image files into a single file
SXOPEN Open a Space Telescope formatted header file. Save the parameters required subsequent SX routines in the common block Stcommn. Optionally save the header in the string array Header, and the history in the string array History. Open the data file associated with this header on the same unit.
SXPAR Obtain the value of a parameter in a FITS header
SXREAD Read a Space Telescope STSDAS image file
SXWRITE Write a group of data and parameters in ST format to a STSDAS data file.
SX_CONVERT procedure to convert GEIS files from VAX/VMS to either Sun3/Sparc, DOS/WINDOWS, and CONVEXOS computers.
TABINV To find the effective index of a function value in an ordered vector.
TABLE_APPEND Routine to append STSDAS tables to create a single table. Input tables must all have identical columns.
TABLE_CALC Adds a new table column from a expression using existing columns
TABLE_DELETE Delete specified rows from an STSDAS table
TABLE_EXT routine to extract columns from an stsdas table
TABLE_HELP Procedure to decribe an SDAS table file.
TABLE_LIST Procedure to list contents of an stsdas table. This does not print the table in tabular form but instead for each row prints the column name followed by its value (one column per
TABLE_PRINT Routine to print an stsdas table.
TABLE_SORT Procedure to sort an STSDAS table by the specified column
TAB_ADDCOL Procedure to add a new column to an existing stsdas table.
TAB_COL Procedure to extract column information from table control block
TAB_CONV Convert SDAS tables from VAX to SUN(or DOS) computers.
TAB_CONVERT Convert SDAS tables from VAX to SUN(or DOS) computers.
TAB_CREATE Procedure to create a new table file.
TAB_DEL Delete specified row(s) from an STSDAS table
TAB_EXPAND routine to expand the size of an SDAS table file.
TAB_FORTOSPP Procedure to convert a fortran format to an spp format specfication.
TAB_HCONVERT Perform byte-swapping when converting SDAS tables from
TAB_MODCOL Modify column description in a STSDAS table
TAB_NULL function to locate null values within a vector of values from an stsdas table.
TAB_NULLROW Insert null row(s) into a STSDAS table
TAB_PRINT Routine to print an stsdas table.
TAB_PUT Procedure to place new values into a stsdas table.
TAB_READ Procedure to read an SDAS table file
TAB_SIZE Routine to extract the table size from a table control block
TAB_SORT Procedure to sort table by the specified column
TAB_SPEC Procedure to tabulate the wavelength and flux for a spectrum into an SDAS table.
TAB_SPPTOFOR This procedure converts an spp format specification to a normal Fortran format specification.
TAB_TO_DB Add SDAS table contents to an existing or new database file.
TAB_VAL tab_val Routine to read a column from an SDAS table file CALLING SEQUENCE: values = tab_val(tcb,table,column) values = tab_val(tcb,table,column,rows) tcb - table control block returned by tab_val
TAB_WRITE Routine to write an stsdas table to disk
TACOUNTS Calculates the total count rate in any of the GHRS mirrors
TARATES *NAME: TARATES *PURPOSE: Calculate expected count rates in each Target acquisition mode. *CALLING SEQUENCE: TARATES, parms, cps [, in_wave, in_flux ] *PARAMETERS: params - parameter description. 0 - use all defaults
TA_MOSAIC Construct a mosaic from maps obtained in a GHRS spiral search
TA_POS *NAME: TA_POS *PURPOSE: Generates RA and DEC from an input position, correcting for proper motion from an input date to the observation date, and allowing for precession between two coordinate equinoxes. The proper motion in RA can be in seconds of time or seconds of arc. Interactive front end for CALCPOS.PRO. The output equinox defaults to 2000.
TBDELCOL Delete a column of data from a FITS 3_D binary table
TBDELROW Delete a row of data from a FITS table
TBDIR Provide a brief description of the disk FITS tables on a directory The # of columns and rows, and the name of the first five columns are displayed for each table.
TBGET Function to return value(s) from specified column in a binary
TBHELP Routine to print a description of a disk 3D binary FITS table
TBINFO Procedure to return information on the specified field in a FITS binary table.
TBPRINT Procedure to print specified columns and rows of a FITS table
TBREAD Procedure to read an internal FITS table file
TBSIZE Procedure to return the size of a fits table.
TEKTOVT100 Returns screen from Tektronix 40** to VT100
TEN Converts sexigesimal number to decimal. Inverse of SIXTY function.
TENV Converts sexigesimal number to decimal. Like TEN but allows vector
TEXTCLOSE *NAME: TEXTCLOSE *CATEGORY: *PURPOSE: Procedure to close file for text output as specifed by !textout. *CALLING SEQUENCE: textclose, textout=textout *PARAMETERS:
TEXTOPEN *NAME: TEXTOPEN *PURPOSE: Procedure to open file for text output as specified by !textout. *CALLING SEQUENCE: textopen,program *PARAMETERS: program - scalar string giving name of program calling textopen
TICLABELS Used to display images with right ascension and declination axes. This routine creates labels for already determined tic tic marks (every other tic mark)
TICPOS Procedure to specify distance between tic marks for astronomical coordinate overlays. User inputs number an approximate distance between tic marks, and the axis length in degrees. TICPOS will return a distance between tic marks such that the separation is a round multiple in arc seconds, arc minutes, or degrees
TICS For use in labelling a displayed image with right ascension and declination axes. An approximate distance between tic marks is input, and a new value is computed such that the distance between tic marks is in simple increments of the tic label values.
TIC_ONE For use in labelling images with right ascension and declination axes. This routine determines the position in pixels of the first tic.
TMPR Calculate the color temperature of an iras image
TO_HEX Translate a non-negative decimal integer to a hexadecimal string
TRANS_BYTES To translate internal data formats between different machine architectures. TRANS_BYTES currently supports SunOS (Sun-4s and SPARCStations), ULTRIX (DECstation 3100), VMS (VAX), and DOS (IBM 386-class PCs).
TVBOX Draw a box or rectangle in the graphics plane of specified width centered on the cursor, or at a specified position.
TVCIRCLE To draw a circle of specified radius centered on the cursor, or at specified position
TVELLIPSE Draw an ellipse in a window.
TVIMAGE Overlay an image and a contour plot.
TVLASER Prints screen onto a Postscript laser printer. TVLASER uses the logical name or environment variable PSLASER to check which postscript printer to use. Optionally print selected information from a FITS header. Users will want to tailor this program to their particular computer environment.
TVLIST Cursor controlled listing of a TV image on the terminal. If !TEXTOUT = 3, then listing is printed to a disk file TVLIST.PRT. The keyword TEXTOUT can be used in calling TVLIST so that !TEXTOUT will not have to be set and reset.
TYPE Emulates DCL command TYPE command. On a Unix machine, TYPE simply spawns to the more(1) command.
UNRED Correct an (ultraviolet) flux vector for interstellar extinction. One can choose from 9 different extinction curves (or a user specified
UVBYBETA Derive dereddened colors, metallicity, and effective temperature from Stromgren colors. Adapted from FORTRAN routine of same name published by T.T. Moon, Communications of University of London Observatory, No. 78. Can be used either interactively or called from a main procedure.
VACTOAIR Convert vacuum wavelengths to air wavelengths, i.e. correct for the index of refraction of air under standard conditions. Wavelength values below 2000 A will not be altered. Accurate to about 0.005 A
VAXFITS Procedure to copy FITS files from a VAX computer and deposit in the users directory on a SUN 3/4/SPARC computer.
VAX_DOS PURPOSE: To convert VAX IDL data types to dos IDL data types. CALLING SEQUENCE: vax_dos, variable variable - The data variable to be converted. This may be a scalar or an array. Valid datatypes are integer, longword,
VAX_TO_SUN vax_to_sun PURPOSE: To convert VAX IDL data types to Sun IDL data types. CALLING SEQUENCE: vax_to_sun, variable variable - The data variable to be converted. This may be a scalar
VECTOR_TRIM *NAME: VECTOR_TRIM *CATEGORY: *PURPOSE: Trims excess off end of merged flux vectors from shifted spectra. *CALLING SEQUENCE: VECTOR_TRIM, trim, MF, MER *PARAMETERS:
VMEDIAN vector median filter routine
VOIGT Implementation of Voigt function
VT100 Erases screen and puts retrographics or selanar terminal into the VT100 mode.
VTOU To translate internal data formats between different machine architectures. VTOU currently supports SunOS (Sun-3s, Sun-4s and SPARCStations), ULTRIX (DECstation 3100), and VMS (VAX).
WAVECAL Compute GHRS dispersion coefficients
WAVECAL_FIND THIS ROUTINE COMPUTES THE POSITIONS OF FEATURES USING CORSS CORRELATION WITH A USER DEFINED TEMPLATE.
WAVECAL_FIT subroutine of WAVECAL to fit dispersion coef to measured sample positions
WAVECAL_PRT WAVECAL PROCEDURE TO PRINT RESULTS IN A TEXT FILE
WAVE_OFFSET wave_offset Computes the FOS dispersion coefficients for a spectrum by determining the shift (using cross correlation) for a reference spectrum with known dispersion coefficients. CALLING SEQUENCE: wave_offset,root1,dc1,root2,DC2
WFIT To fit a nonlinear function to weighted data points using linearization of the fitting function (i.e. an IDL version of Bevingtion's program CURFIT).
WFPC_SMS *PURPOSE: Scan and parse the WFPC Parallel Obs SMS Review pages *PARAMETERS: review_page - (string) - SMS Review Page containing WFPC Parallel Observation information. OPTIONAL: vol_path -(string) - path for volitale database. Default is
WFPC_SMS_OPT *PURPOSE: Handle special case database updates for WFPC SMS. *PARAMETERS: item - (string) - name of database item. val - (string) - value extracted from SMS Reveiw Pages. OUTPUT: new_val - Results of converting VAL to reflect differences between
WINDOW_TO_PS Outputs the contents of a window to a postscript file that can be printed on a postscipt printer.
WPOLYFIT TO FIT A WEIGHTED POLYNOMIAL TO DATA POINTS USING THE METHOD OF LEAST-SQUARES.
WRITEFITS Write an an IDL array into a disk FITS file. Does not handle groups or extensions.
WRITE_ASC WRITE_ASC Creates an ASCII table file in which each column represents one of the specified input vectors. Up to 10 parameters are allowed. *CALLING SEQUENCE: WRITE_ASC,FILENAME,P1 [,p2,...,p8,/no_tabs,A_fmt=A_fmt] *PARAMETERS:
X2FITS Create basic FITS files on tape from IDL Arrays (any dimensions). A minimal FITS header is created by this program. FOR VMS IDL ONLY.
XBITS ROUTINE TO EXTRACT BITS AND OPTIONALLY RETURN THEM AS A STRING
XY2AD Compute R.A. and Dec in radians from X and Y and the plate solutions in six-parameter format. A tangent (gnomonic) projection is assumed. XY2AD is meant to be used internal to other procedures. For interactive purposes use XYAD.
XYAD Use an image header to compute R.A. and Dec in decimal degrees from X and Y. A gnomonic (tangent) projection is assumed.
XYREADS To prompt for and read a string input by the user at a specific location in the graphics window.
XYZ Calculate heliocentric X,Y, and Z coordinates for 1950.0 (The positive X axis is directed towards the equinox, the y-axis towards the point on the equator at right ascension 6h, and the z axis toward the north pole of the equator.
YADDHDR YADDHDR Add the standard header keywords and group parameters to OSS format FOS raw data files. CALLING SEQUENCE: yaddhdr,filespec,makeq0 filespec - observation rootname specification (including standard VMS
YAPERPSN YAPERPSN Decode from the serial engrg data (ul) the entrance aperture position name. CALLING SEQUENCE: result=yaperpsn(iser,index) iser - array of serial eng. data index - index of aperture wheel encoder data in iser
YDN2MD Convert from day number of year to month and day of month. (Use YMD2DN to go in the opposite direction)
YESNO *NAME: YESNO *CLASS: i/o *CATEGORY: *PURPOSE: To convert an answer to a yes/no question into an integer ( 1 OR 0). *CALLING SEQUENCE: YESNO,IN
YFGWPSN YFGWPSN Computes grating ID from encoder value and detector number CALLING SEQUENCE: result=yfgwpsn(detector,encoder) detector - detector side (0=A; 1=B) encoder - fgwa raw encoder value from serial engrg data (ul)
YFIT PROCEDURE TO EVALUATE Y FOR A SET OF FUNCTION PARAMETERS A Y IS ASSUMED TO BE A GAUSSIAN ON TOP OF A POLYNOMIAL BASELINE
YHELP Purpose: Generate listing of FOS documentation for input file. Calling Sequence: YHELP [,'help_file'] help_file - (string) name of FOS IDL procedure for which user desires a listing of the documentation. If no input is specified, the user is prompted for the procedure name. Minimum matching is
YINFOS YINFOS Read FOS exposure parameters, configuration, target, and calibration info from the specified FITS header or header file. CALLING SEQUENCE: configst=yinfos(h [,targid [,mode [,pattern [,expo [,config [,targ [,ref [,switch]]]]]]]])
YLOGS ROUTINE NAME: YLOGS -- Print a log of all FOS observations matching the input filespec, in one of three formats. CALLING SEQUENCE: ylogs,filespec [,length,outfile=outfile] filespec - observation rootname specification (including standard
YMD2DN Convert from year, month, day to day number of year. Use YDN2MD to go in the opposite direction.
YPLZRPSN YPLZRPSN Calculate polarizer mechanism position from serial engrg data (ul). CALLING SEQUENCE: result=yplzrpsn(iser,index,detector) iser - serial engrg data (ul) index - position of polarizer raw encoder readings in iser
YRD Read an SDAS multi-group format image file, such as written by procedure YWRT CALLING SEQUENCE: pro yrd,fn,data [,hist [,h [,gpar]]] fn - name of input file, including extension. If extension is not specified, .d0h is assumed. Single character extensions are assumed to be abbreviations for the standard files written
YREDUCER YREDUCER Reduces FOS GEIS files, producing corrected counts, count rates and wavelength or diode arrays; substitute for procedure YREDUCE. CALLING SEQUENCE: yreducer,name,parms,h,wave,count,eps,hist,rate,gpar name - rootname of input file (without extension)
YWRT Write an SDAS image file, with multiple group format. Ysteps, slices (bins) and read(out)s are written to separate groups. The data type, which may be indicated by the specified filename extension, is written to the header parameter 'BUNIT'. A single character filename extension may be used to indicate the standard CALFOS output product data types. CALLING SEQUENCE:
ZANG Determine the angular size of an object as a function of redshift in a Friedmann cosmology (homogeneous, isotropic universe with zero cosmological constant)
ZBINS To bin flux data on a specified wavelength grid with or without weights.
ZCENTROID *NAME: ZCENTROID *CATEGORY: *PURPOSE: Does Gaussian fit on a spectral line using limits defined by cursor. *CALLING SEQUENCE: ZCENTROID, w, f, index, WL, WR, XC *PARAMETERS:
ZENPOS To supply the zenith RA and Dec in radians corresponding to a supplied
ZPARCHECK ZPARCHECK Routine to check user parameters to a procedure CALLING SEQUENCE: parcheck,progname,parameter,parnum,types,dimens,message progname - string name of calling procedure parameter - parameter passed to the routine
ZPRECESS Precess coordinates from EPOCH1 to EPOCH2. For interactive display, one should use ASTRO which calls ZPRECESS.