Program: SCANAID Purpose: Add IRAS data with respect to a reference point (ADDSCAN) Category: IRAS File: scanaid.c Author: T. Prusti Keywords: INIRDS= Input IRDS OUTSET= Output set [Scans not stored in a set] Set to contain the selected detector scans. * OVERWRITE= Output set exists, ok to overwrite? [Y]/N If OVERWRITE=N you will be prompted for another OUTSET= FILENAME= Name of ASCII file: [No output to file] If a name is specified, an ASCII file is created to store data. If you press carriage return, there will be no output to an ASCII file. If a given name already exists, APPEND= must be specified. * APPEND= File exists, ok to append? [Y]/N The file specified in FILENAME= already exists. You can append to this file with APPEND=Y. If APPEND=N you will be prompted for another filename. POS= Reference position [Center of the IRDS] OBJECT= Name of the object in the reference position [IRDS name] ** UNITS= Output units [Jy] ** ACDC= ACDC conversion [default] IRAS band dependent conversion factor to change calibration applicable for point sources. Default values are 1.282, 1.2195, 1.087 and 1.0 for 12, 25, 60 and 100 micron respectively. See Explanatory Supplement page IV-9 for more information. ** INCFAC= Include factor in half detector units. [1.0] Include scans crossing at a distance INCFAC * detector half width. By default INCFAC is 1.0 which will select only scans which had the reference position within the nominal detector size. SHOW= Control plotting of scans [Plot final result] N(one), A(ll), O(ne by one) plotting can be chosen in addition to the default to show the ADDSCAN result only. * GRDEVICE= Plot device: [List of devices] Destination of plot, Screen or Hardcopy. ** LENGTH= Length of the scan to be plotted (arcmin) [15 arcmin] Length is the minimum length to be plotted and valid only for the individual scans (not to ADDSCAN). ** AROUND= The minimum number of samples around the closest [5] This value is used to select only those scans which have at least AROUND samples before and after the sample closest to the reference point. It is also used to define the window for minimum and maximum determination for baseline removal and plot limits. ** MINMAX= Fixed minimum and maximum value for plots [calculated] Plot height will be fixed to contain at least the min and max given by the user. Otherwise the plot y-scale will vary from scan to scan. Units as from UNITS=. ** PGMOSAIC= View surface sub divisions in x,y: [1,1] View surface can contain a number of plots in in X and Y direction (mosaic). Default is 1 plot in both X- and Y direction. ** PGPAPER= Give width(cm), aspect ratio: [calc, calc] Aspect ratio is height/width. ** PGVIEW= Viewport on paper: [0.2 0.95 0.1 0.9] It is possible to change the viewport on paper. The parameters are x-left, x-right, y-bottom y-top. ** PGCOLOR= Give color 1..15: [1] See description for the available colors. ** PGWIDTH= Give line width 1..21: [2] ** PGHEIGHT= Give character height: [1.0] ** PGFONT= Give font 1..4: [2] Description: From the given input IRDS all data crossing the given reference point will be extracted and put in the given output set after regridding the data into a finer grid. The output set has axes for OFFSET (with respect to the reference point) and SCANNR. SCANNR zero contains the average of all scans (equivalent to ADDSCAN if the default INCFAC=1.0 is kept). For every detector scan selected a plot (if chosen) and a line of information is given. In the plot the crosses are the original data and the smooth line represents the splined data. In the final ADDSCAN result the average of the splined data is shown. The printed information contains a running number (equal to SCANNR above), sop & att numbers identifying the scan, detector number, in-scan offset of the closest sample to the normal from the detector scan to the reference point, in-scan step as deduced from the immediate surroundings of the reference point, twist angle of the scan, cross-scan offset between the center of the detector and the detector scan, half cross-scan size of the detector in question, modified Julian Date (JD-2440000 e.g. 0 UT Jan 1, 1983 is 5335.5) and IRDS info. The IRDS info contains SNIP and SDET coordinates of the scan in the original input IRDS set. Also the number of the closest sample in the IRDS is listed. Color indices: 0 Background 1 Default (Black if background is white) 2 Red 3 Green 4 Blue 5 Cyan 6 Magenta 7 Yellow 8 Orange 9 Green + Yellow 10 Green + Cyan 11 Blue + Cyan 12 Blue + Magenta 13 Red + Magenta 14 Dark Gray 15 Light Gray 16-255 Undefined Available fonts: 1 single stroke "normal" font 2 roman font 3 italic font 4 script font Notes: The program only selects scans. It is left up to the user to extract the final result either from the final plot or from the outset. The baseline removal is primitive and should be controlled for high precision work. For the pointed observations it may be necessary to define ACDC and AROUND (see above) to get correct results. Hints: Use keywords PGMOSAIC= and MINMAX= to plot several scans in one scale on one page. Updates: Aug 5, 1992: TP, Document created and test version released. May 26, 1993: TP, Version 1.0 released. Jun 1, 1993: TP, Handling of units simplified. Jun 2, 1993: TP, MINMAX= handling fixed. Jun 3, 1993: TP, Modifications made to improve PO handling. Nov 11, 1993: TP, Allow change of viewport. Apr 12, 1995: VOG/ZAAL Implemented CDELT1 for OFFSET axis 'Ytitle' position default (PGLAB) Dec 12, 2001: DK, provide more precision on JD.