Program: INSPECTOR #begin section gettingstarted GETTING STARTED =============== #end section gettingstarted #begin section mousebuttons Documentation in Postscript: http://www.intra.astro.rug.nl/~gipsy/inspector/inspector.ps LEFT : For dragging the closest tilted ring marker. The focus remains on that marker until the button is released. MIDDLE: Let Tilted Ring (TR) parameters markers follow the mouse in vertical direction. The closest marker is moved. SHIFT LEFT: In current panel, draw segment line 1 then 2, remove 1, then 2 etc. CTRL RIGHT: Move all markers within segment. Action depends on the current segment mode. CTRL LEFT: Select a new segment mode. #end section mousebuttons #begin section recipe Documentation in Postscript: http://www.intra.astro.rug.nl/~gipsy/inspector/inspector.ps You will need a GDS data cube with dimension >= 3 The program works with physical coordinates only if the subset axes are spatial and the profile axis is a velocity axis (FREQ or VELO). Otherwise calculations and plotting is done in pixel coordinates. With such a cube (in fact a set of channel maps) you are able to display slices through the data in so called XV diagrams. Data along a slice is extracted and this process is repeated for all subsets to get an XV image. If you have data that describes a tilted ring model for a galaxy (velocity, inclination & position angle as function of radius stored in a GDS table or an ASCII file on disk) then this program calculates the line-of-sight velocities and marks those velocities in your XV maps (or channel maps, if MODUS=1). It displays the tilted ring parameters in three plots to the right of the mosaic with XV maps. The tilted ring parameters can be changed using the mouse. Two extra parameter panels represent angles defined with respect to a central disk. These are coupled to the panels with position angle and inclination. A full description of how to derive rotation curves with INSPECTOR and its advantages and disadvantages over existing methods is given in 'Dark Matter in Late-type Dwarf galaxies', Rob Swaters, PhD thesis Rijkuniversiteit Groningen, Oct 1999. #end section recipe #begin section example Documentation in Postscript: http://www.intra.astro.rug.nl/~gipsy/inspector/inspector.ps This is a list with a minimum number of keywords extracted from the program after a test run. The data file 'voginp.dat' contains test data. Its contents is: 0 0 60 50 10 10 60 50 20 20 60 50 30 30 60 50 etc. These are the keywords: BOX= -10 -10 10 10 CLIP= 0 10 GALCENTRE= 0 0 INCLINATION= file(voginp.dat,3,1:) INSET=vogtest f POSANG= file(voginp.dat,4,1:) RADII= file(voginp.dat,1,1:) SAMPLE= 5 SKYANGLES= 0 50 90 230 310 SLICEX0Y0= 0 0 VELOCITY= file(voginp.dat,2,1:) VSYS= 603.5 #end section example #begin section defaults Documentation in Postscript: http://www.intra.astro.rug.nl/~gipsy/inspector/inspector.ps Defaults in the input window: (GALCENTRE=) Default galaxy center is 0 0 if that is within the box, else it is the grid center of the map. (BOX=) The default box appears after the set input. If you press enter in an empty box field, a default box, (entire subset area) will appear. (CLIP=) A default clip appears after the set input. The default is read from the header (Header items datamin and datamax). The default re-appears if you press enter in an empty field. (XUNITS=) The default units for the X axis of an XV diagram are arcsec if the subset axes are both spatial and the header units can be converted to degrees. (VUNITS=) The default units are km/s. (SLICEX0Y0=) Default appears after defining the slice angles. The default of the slices centre is 0,0 i.e. if 0,0 is within the given box. Else the grid centre of the box is the default. (SAMPLE=) Default appears after defining the slice angles. The default sampling is 1 in current XUNITS= units. (OVERSUB=) Default subset is the middle subset. The default appears in the 'Overlay on subset' input window after the input set in entered. Defaults in the Tilted Ring window: (TRXUNITS=) The default appears after the set input. The units are copied from XUNITS= (TRVUNITS=) The default appears after the set input. The units are copied from VUNITS=. If the data in the parameter plots is constant (e.g. constant inclination) then the upper limit is increased by 20 and the lower limit is decreased by 20. The default limits can be adjusted in the Tilted Rings input window under 'limits'. Defaults in the Label window: (TITLEX=) The default title if Offset (...). For the dots is substituted the contents of XUNITS= (TITLEY=) The default title if Velocity (...). For the dots is substituted the contents of VUNITS= (MOSROWS=) A default for the number of rows with which to build a mosaic of XV plots, appears after the input of slice angles. The default tends to make the mosaic a square. Defaults in other windows: There are numerous defaults for colours, size of markers symbols etc. #end section defaults #begin section keywords Documentation in Postscript: http://www.intra.astro.rug.nl/~gipsy/inspector/inspector.ps BLINK= Start blinker window BOX= Data limits of input subsets BETMINMAX= Min, max in plot of beta's CLIP= Data between these two values are mapped onto XV images COLEDIT= Start the colour editor CONCOL= Set the colour of the contours CONSET= The source of the contour data CONTOURS= The contour levels EXTRACT= (Re)plot FILE= Menu for saving and quitting FIXINC= Convert galaxy angles to sky angles with this fixed inclination FIXPHI= Convert galaxy angles to sky angles with this position angle GALANGLES= Slice angles in galaxy system GALCENTRE= Center of galaxy GALMODE= Set angle mode to sky or galaxy GIDSSLICES= Overlay subset slices on HCDEVICE= Hardcopy device HCFILENAME= Hardcopy PostScript file name HELP= Display help document INCLINATION= Tiltes ring inclinations INCMINMAX= Min. & max. of these inclinations INPUT= Pop up INPUT window INSET= The GIPSY data cube to extract slices from LABCOL= Colour of labels in XV mosaic plots LABDELTAX= Step size for tick marks in X direction LABDELTAY= Step size for tick marks in V direction LABELS= Pop up LABELS window LABSTARTX= Start value for labels in X direction LABSTARTY= Start value for labels in V direction LABSUBX= Number of minor tick marks in X direction LABSUBY= Number of minor tick marks in Y direction M0_APPLY= Refresh Slices plot markers M0_DELTA= Increment of XV marker size in charachter heights M0_COLOUR= Colour of slice plot markers M0_LINEWIDTH= Linewidth of slice plot markers M0_SIZE= Size (character height) M0_SYMBOL= Symbol used for markers M1_APPLY= Tilted ring markers M1_COLOUR= M1_LINEWIDTH= M1_SIZE= M1_SYMBOL= M2_APPLY= Line-of-sight velocity markers M2_COLOUR= M2_LINEWIDTH= M2_SIZE= M2_SYMBOL= M3_APPLY= Colour of moving markers in slices plot M3_COLOUR= M3_LINEWIDTH= M3_SIZE= M3_SYMBOL= MAPUNITS= Units of data in GIPSY set MARKERS= Pop up MARKERS window MONITOR= Monitor events in Hermes MOSROWS= Number of rows in mosaic MODUS= 1. Plot markers on XV maps 2. Plot markers on channel maps 3. Plot projected rings on total HI map M_APPLY= Refresh all markers OVERSUB= Subset number used for overlay of slice lines PHIMINMAX= Min. & max. of of position angles PINFO= Text string used for extra annotation at left bottom in hardcopy POSANG= Tilted ring position angles QUIT= Close application and quit RADII= Tilted ring radii RADMINMAX= Min and max radii for plot RESET= Reset plots ROTPAR= Pop up rotation curve input window SAMPLE= Sample size in current units SAVESLICES= Save extracted slice data to set on disk SAVETILT= Save modified TR data to file on disk SEGMODE= Set mouse action in segment SKYANGLES= Angle of slices in sky SKYGAL= Flag for galaxy or sky angle mode SKYMODE= Slice angles defined in sky SLICEX0Y0= Center of slice in grids or ph. coords. THEMINMAX= Min, max in plot of theta's TITLEX= Plot title along X TITLEY= plot title along Y TRVUNITS= Units for TR velocities (km/s,...) TRXUNITS= Untis for TR offsets (arcsec,...) VELMINMAX= Min., max velocity in TR plot VELOCITY= The TR velocities VELSET= One (sub)set with velocities for overlay VSYS= Systemic velocity in VUNITS= units VUNITS= Units of velocities in XV diagram XUNITS= Units of offset in XV diagram XYSIZE= Size of INSPECTOR window in pixels #end section keywords #begin section limits Documentation in Postscript: http://www.intra.astro.rug.nl/~gipsy/inspector/inspector.ps The maximum number of input subsets (channel maps) is 4096. The maximum number of Tilted Ring radii is 1024. The maximum number of XV slices (is the maximum number of slice angles) is 1024. The maximum number of contours is 128. #end section limits #begin section description Documentation in Postscript: http://www.intra.astro.rug.nl/~gipsy/inspector/inspector.ps Calculate line of sight velocities from tilted ring parameter data and mark those velocities in XV maps. The XV maps are slices at arbitrary angles through a data cube. Changing the tilted ring parameters in one of the panels with a graphics cursor, results in an update of the velocities in the XV diagrams or channel maps (depending on MODUS=) Rather than using the tilted ring parameters, it is also possible to supply the program with an initial guess of the rotation curve. This initial guess can then be adjusted interactively. A full description of how to derive rotation curves with INSPECTOR and its advantages and disadvantages over existing methods is given in Swaters' PhD thesis (Rijkuniversiteit Groningen, in preparation). INSPECTOR compares radial HI velocities, obtained from (fitted) 'tilted ring' circular velocities, with projected velocities in data slices. A slice is a description of coordinates in a two dimensional subset at which image values are extracted from the data set in INSET= A slice has a central position (SLICEX0Y0=) in the subset (entered in grids or physical coordinates), and an angle (ANGLE=). The central position can differ from the rotation centre (CENTRE=). The angle is entered in degrees and is defined wrt. the north in the direction of the east. This angle is constant along the slice therefore the projection system is taken into account for spatial systems. Samples along the slice are separated at distance SAMPLE= which must be specified in XUNITS= The offsets in X of a slice are positive towards the receding part of a galaxy. #end section description #begin section about Purpose: INSPECTOR writes slices through a 3d GIPSY data cube. It overlays radial HI velocities (i.e. 'tilted ring' circular velocities) on velocities in XV diagrams and lets you adjust the tilted ring parameters to get a better fit. Category: ANALYSIS, PLOTTING, ROTATION-CURVES, VELOCITY-FIELDS File: inspector.src Author: M.G.R. Vogelaar Notes: 1) Use keyword XYSIZE= to set the INSPECTOR window size in pixels, e.g.: INSPECTOR XYSIZE=800 600 2) Selecting a menu item only works if the keyboard CAPS-LOCK is OFF! 3) If your sample size is too big, you won't see any slice data, but you still can have overlays of tilted ring velocities. This can be confusing. Related docs: See inspector.dvi or inspector.ps in www.astro.rug.nl/~gipsy/htm/inspector Updates: Apr 04, 2005: VOG, Document created. Mar 16, 2006: Two panels added. Update PS document Inverse velocities allowed e.g. FREQ 36:-19:-1, Markers on subsets. #end section about