**This file should be placed in a directory which is included **in the HELPPATH environment variable. This is the XView help file for "robot". The items in it are accessed by pressing "Help" or F1 above the appropriate button when running robot. :robot This is ROBOT. A general purpose plotting and data analysis program. # Used if -notol flag used. :dismiss Dismiss Get rid of this control panel. # :reply Reply> Enter the information requested and then either press return or click on the box marked "OK". To cancel execution of this command press the button marked "Cancel". :Datafile Datafile [DATAFILE/DATA/PLOTFILE/P] This command reads in an ASCII data file containing values to plot. If you want to read Robot commands from a file then use the "File" command instead. Data files have a default ".dat" extension. # :File File [FILE/F] This command is used to read from a file which contains Robot instructions. If you want to read data values then use the "Datafile" command instead. Robot files have a default ".rob" extension. # :Goplot Goplot [GOPLOT/G/PLOT] Plot data using the current settings for styles. # :New Page New Page [NXTPAG/N] Clears the graph. Previous Robot commands are still retained in the log file but the plot itself is lost so it cannot be printed. # :Rescale Rescale [RESCALE] Scales the plot to fit the presently defined plotting area. May be used, for example, after manipulating the data using using an arithmetic or function operation. # :Reset Reset [RESET] Sets as many things as possible back to default values. e.g. plot style, one graph per page, line width, text size etc. # :tidy_up End... [END/E] Pops up a panel which allows you to quit robot and dispose of the log files by either saving them or deleting. # :colour Color... [cf. COLOR/COLOUR] This pops up a panel with controls to change the plotting color. The commands COLO(U)R and RGB can also be used to directly change the plotting color. COLO(U)R takes the name of a color (e.g. BLUE, RED) RGB takes three numbers in the range 0 to 255 to specify individual red, green and blue color levels. :print Print... [PRINT] This pops up a panel which enable you to create a PostScript format file containing your plot. This can also optionally be sent to the printer. # :split_window Split Window... This pops up a panel which allows you to control the splitting of the plot area into sub-windows. You can also control the gaps between sub-windows and the amount of the plotting area that is used. # :fits_table Fits Table... This pops up a window which enables you to read in FITS binary table data and create a spectrum. :fitter Fitter... This pops up a window to provide controls for fitting models to the data. It is an alternative to choosing "Curve Fit" [CURFIT] from the Fit menu. # :history History... Displays a window containing a history of the most recently entered commands. The full log of commands is stored in a temporary disc file and you have the option of saving this log file when you select the "End..." button. # :about About Robot... Pops up a window with limited information on Robot. This window also allows you to bring up a further window which can be used to send mail (bug reports, complaints, suggestions etc.) to the author of this program. # :axis_controls Axes... Pops up a window with controls for specifying axis properties (e.g. which axes are drawn, tick mark size etc.) # :Aliases Aliases Shows the aliases you have created. :Fit Fit Menu Commands for fitting curves, calculating correlation coefficients, plotting fits, controlling convergence conditions etc. # :other_fit_options Other Options This replicates the "Fit" menu button found on the main panel. "Curve Fit" is simply a command line alternative to this control panel. Of more relevance are options for plotting and subtracting or adding the curve once a fit has been done. The "Convergence", "Fit Mode", and "FitDelta" commands allow control of the fitting conditions. # :Draw Draw Menu Drawing commands and change how lines are drawn. # :Words Words Menu Write text, change text properties (size, angle, style). # :Numbers Numbers Menu Arithmetic and functions. # :I/O I/O Menu Read and write data (ASCII). Specify what format the input data has. # :Style Style Menu Commands which change how your plot will look are in this menu. # :Analyse Analyse Menu Miscellaneous data processing commands. # :Analyze Analyze Menu Miscellaneous data processing commands. # :Stats. Stats. Menu Simple statistics (mean, variance etc.) # :Astro Astro Menu Astronomical specific commands are in this menu. # # HELP FOR SPECIFIC MENU ITEMS. :Curve Fit Curve Fit [CURFIT] Do fits to data using a variety of models. An alternative to this is "Fitter..." which brings up a control panel. # :Polynomial Fit Polynomial Fit [POLFIT] Fit the data with a polynomial. # :Linear Fit Linear Fit [LINFIT] Straight line fit to the data and calculate the correlation coefficient. # :Predict Predict [PREDICT] For a specified value of the independent variable ("x" value) a value of the dependent variable variable ("y" value) is calculated. A fit must have been done before this can be calculated. :Plot Curve Plot Curve [PLOTCUR] Plot the results from "Curve Fit" [CURFIT] and "Fitter...". # :Plot Dashed Curve Plot Dashed Curve [PLOTCURD] Plot the results from "Curve Fit" [CURFIT] and "Fitter..." as a dashed line. # :Curmodelplot Curmodelplot [CURMODELPLOT] Plots individual models resulting from curve fitting. # :Curmodelplot Dashed Curmodelplot Dashed [CURMODELPLOTD] Plots individual models resulting from curve fitting as dashed lines. # :Plot Polynomial Plot Polynomial [PLOTPOLY] Plot the polynomial fit from "Polynomial Fit" [POLFIT]. # :Plot Linear Fit Plot Linear Fit [PLOTFIT] Plot the linear fit from "Linear Fit" [LINFIT]. # :Subtract Curve Subtract Curve [SUBCUR] Subtract the curve from the result of "Curve Fit" [CURFIT] from the data. # :Add Curve Add Curve [ADDCUR] Add the curve from the result of "Curve Fit" [CURFIT] to the data. # :Subtract Polynomial Subtract Polynomial [SUBPOLY] Subtract the polynomial fit result of "Polynomial Fit" [POLFIT] from the data. # :Add Polynomial Add Polynomial [ADDPOLY] Add the polynomial fit result of "Polynomial Fit" [POLFIT] to the data. # :Convergence Convergence [CONVERGENCE] Controls the convergence conditions for "Curve Fit" [CURFIT] - the percentage change in chi square and the number of iterations. # :FitDelta FitDelta [FITDELTA] Controls the behavior of "Curve Fit" [CURFIT] - changes step values used in calculating derivatives of parameters of fit. The steps are parameter value divided by the FITDELTA value. # :Fit Mode Fit Mode [FITMODE] Determines the whether points will be weighted by error bars during fitting. The default is that they will be unless the data has no associated errors. # :Grid Grid [GRID] Do a chi square grid in fitting. # NOW HELP FOR THE PLOT MENU. :Line Line [LINE] Draw a line. # :Dashed Line Dashed Line [DASHEDLINE] Draw a dashed line. # :Box Box [BOX] Draw a box. # :Filled Box Filled Box [FILLEDBOX] Draw a box filled with the current plotting color. # :Circle Circle [CIRCLE] Draw a circle. # :Filled Circle Filled Circle [FILLEDCIRCLE] Draw a circle filled with the current plotting color. # :Ellipse Ellipse [ELLIPSE] Draw an ellipse. # :Cursor Cursor [CURSOR] Use the cursor to obtain the (x, y) values. When the left button on the mouse is clicked then the cursor position is stored as the XCURSOR and YCURSOR parameters. # :Ruler Ruler [RULER] Interactively measure X and Y distances on a graph using the cursor. # :Arc Arc [ARC] Draw a circular arc centered on the specified position. Both the start and end angles are measured with respect to the "3 o'clock" line. # :PolyLine PolyLine [POLYLINE] Draw a series of connected lines. Use the left hand button to specify positions. Press the middle button when you've finished drawing lines. # :Polygon Polygon [POLYLINE] Draw a series of connected lines with the last point connected to the first. Use the left hand button to specify positions. Press the middle button when you've finished drawing lines. # :PolyFill PolyFill [POLYFILL] Draw a filled polygon. The filling rule is "even odd". Use the left hand button to specify positions. Press the middle button when you've finished drawing lines. # :Line Width Line Width [LINEWIDTH] Set the width of the lines used for plotting. The default is 0. This should give the fastest possible plotting for X. However, PostScript output with a width of "0" may well be too narrow (especially for publication) and a thicker line should be used. # :Line Width 0 Line Width 0 [WIDTH0] Plot using a line width of "0". i.e. use the smallest possible size. This is supposed to give the fastest plotting in X. The PostScript output may have problems on very high resolution devices. :Line Width 1 Line Width 1 [WIDTH1] Plot using a line width of "1". # :Line Width 2 Line Width 2 [WIDTH2] Plot using a line width of "2". # :Line Width 4 Line Width 4 [WIDTH4] Plot using a line width of "4". # :Line Width 8 Line Width 8 [WIDTH8] Plot using a line width of "8". # :Line Style Line Style [LINESTYLE] Specify the style with which lines are drawn: SolidLines, DashedLines, DotDashedLines, DotDashedLines. # :SolidLines SolidLines [SOLIDLINES] Draw all lines as solid. # :DashedLines DashedLines [DASHEDLINES] Draw all lines as dashes. # :DottedLines DottedLines [DOTTEDLINES] Draw all lines as dots. # :DotDashedLines DotDashedLines [DOTDASHEDLINES] Draw all lines as dot-dashes. # :User Axis User Axis [USERAXIS] Draw an axis wherever you want. # :Log Axis Log Axis [LOGAXIS] Draw a logarithmic axis wherever you want. # :User Axis Label User Axis Label [USERAXISLABEL] Label your own axis. # :Log Axis Label Log Axis Label [LOGAXISLABEL] Label your own logarithmic axis. # HELP FOR THE WORDS MENU :Text Text [TEXT] Add text to the plot. Text style and size can be changed inside a string. This is activated using a \ followed by a two character code: \sf Symbol Font \if Italic Font \bf Bold Font \bi Bold Italic \nf normal Font (not italic or bold) \hf Helvetica Font \cf Courier Font \tf Times Font \up move up to a position 1/2 the font size higher (superscript) \dn move down ..... \bs move back one character size (approx.) or a text size such as \08 \10 \12 \18 etc. To decrease or increase the font size by two points use \- and \+ respectively. e.g. O\dn\bs\bs8\bs\up\up\bs16 will give you something like: 16 O 8 Special characters may be obtained using sequences such as \{infinity}. This can also be used as alternative way of generating Greek characters. e.g. \{alpha}, \{Gamma}. # :Text Size Text Size [TEXTSIZE] Change the size of the text used. An alternative to this is to select one of "10 Point", "12 Point" etc. # :10 Point 10 Point [TENPOINT] Set the text size to be 10 point. # :12 Point 12 Point [TWELVEPOINT] Set the text size to be 12 point. # :14 Point 14 Point [FOURTEENPOINT] Set the text size to be 14 point. # :18 Point 18 Point [EIGHTEENPOINT] Set the text size to be 18 point. # :24 Point 24 Point [TWENTYFOURPOINT] Set the text size to be 24 point. # :Text Style Text Style [TEXTSTYLE] Choose the style for the text (e.g. bold). Alternatively select one of the commands such as "Bold" directly. # :Normal Normal [NORMAL] Set the test style back to non-bold, non-italic. :Bold Bold [BOLD] Set the text style to bold. # :Italic Italic [ITALIC] Set the text style to italic for Times fonts. For Helvetica and Courier fonts an oblique font is used. # :Bold Italic Bold Italic [BOLDITALIC] Set the text style to be both bold and italic. # :Font Font [FONT] Specify which font to use (e.g. Times, Courier etc.) :Symbol Symbol [SYMBOL] Use the "symbol" font for plotting. This includes Greek characters. Characters in the symbol font (and other special characters) can also be accessed by including sequences such as \{alpha} in a text string even if you are using another font. # :Times Times [TIMES] Use the Times-Roman font family. This is the default. # :Helvetica Helvetica [HELVETICA] Use the Helvetica font family. This is a sans serif font. # :Courier Courier [COURIER] Use the Courier font family. This is a mono-spaced (non-proportional) font. # :AvantGarde AvantGarde [AVANTGARDE] Use the AvantGarde font family. # :Bookman Bookman [BOOKMAN] Use the Bookman font family. # :HelveticaNarrow HelveticaNarrow [HELVETICANARROW/HELVETICAN] Use the Helvetica-Narrow font family. # :NewCentury NewCentury [NEWCENTURY] Use the NewCenturySchlbk font family. # :Palatino Palatino [PALATINO] Use the Palatino font family. # :Chancery Chancery [CHANCERY] Use the ZapfChancery-MediumItalic font. This is a single font and not a family and so other styles are not available # :Dingbats Dingbats [DINGBATS] Use the ZapfDingbats font. This is a single font and not a family and so other styles are not available # :Kanji Kanji [KANJI] Use the (Japanese) Kanji font. Standard ASCII characters are printed as normal. To access additional symbols in the Kanji font there are two methods: Use a sequence such as \[ka] This will print the hiragana equivalent of the "ka" syllable. To use katakana instead use \[Ka] If you know the JIS code this can also be used. For example \[3b33] will print the symbol "yama" (mountain). The escape sequences used for JIS are also recognized. As the Escape character is not accepted in the text prompt, to be able to print this type of text you'll probably need to include it in a .rob file and use the "FILE" command to access it. # :Text Angle Text Angle [TANGLE] Select the angle for drawing text. Although angled text displayed on the screen looks somewhat messy any hardcopy angled text will not have this problem. # THESE ARE FOR THE NUMBERS MENU. :X Arithmetic X Arithmetic [XARITH] Perform arithmetic on the x data values. Multiply and divide also affect the error array. # :Y Arithmetic Y Arithmetic [YARITH] Perform arithmetic on the y data values. Multiply and divide also affect the error array. # :Z Arithmetic Z Arithmetic [ZARITH] Perform arithmetic on the z array. # :X Function X Function [XFUNCTION] Replace x values with a function of them (log, square root etc.). # :Y Function Y Function [YFUNCTION] Replace y values with a function of them (log, square root etc.). # :Z Function Z Function [ZFUNCTION] Replace z values with a function of them (log, square root etc.). # :Xerrarith Xerrarith [XERRARITH] Arithmetic on the x error values alone. # :Yerrarith Yerrarith [YERRARITH] Arithmetic on the y error values alone. # :Variable Variable [VARIABLE] Define a name to be used as a variable. Variable names are _not_ case sensitive. After a variable has been defined with this command a value can be assigned using the "Assign" command. Variables named A1, A2, A3, A4 and A5 already exist by default. All variables are floating point numbers. # :Assign Assign [ASSIGN] Assign a value to a user accessible variable. Default variables are A1, A2, A3, A4 and A5. Use the "Variable" command to define new variable names. # :Log X Log X [LOGX] Take the log of the x values and adjust the x error array. # :Log Y Log Y [LOGY] Take the log of the y values and adjust the y error array. # :Log X&Y Log X&Y [LOGXY] Take the log of the x and y values and adjust the x and y error arrays. # :Z Reset Z Reset [ZRESET] Set the z array to zero. # THESE ARE FOR THE I/O MENU :Table Table [TABLE] Specify which columns of the input file contain x, y and error values. (The input file need not contain all this information - e.g. errors are not essential). The default setting is: 1 2 3 4 i.e. X values are in the first column, Y values in the second, Y errors (if any) in the third, and X errors (if any) in the fourth. If a column doesn't exist then you can specify this with a "0". For example: 2 1 0 0 means the X values are in the second column, Y values are in the first column and there are no X or Y error values. If no X value is given. e.g.: 0 1 0 0 then the line number is used for the X values. # :Infilenotext Infilenotext [INFILENOTEXT] The input data file doesn't contain the three lines of text at the top which Robot expects as the default. These three lines are the plot title, X label, and Y label. # :Infiletext Infiletext [INFILETEXT] The input data file contains the three lines of text at the top which Robot expects as the default. These three lines are the plot title, X label, and Y label. # :Clobber Clobber [CLOBBER] If "Clobber" is set then the command WRITEDATA will be able to overwrite existing files. The default is not to allow this. # :NoClobber NoClobber [NOCLOBBER] If "NoClobber" is set then the command WRITEDATA will not able to overwrite existing files. This is the default behavior. # :Overplot Overplot [OVERPLOT] Read in new data file, similar to Datafile except that the plotting area etc. are not redefined. # :Moreplot Moreplot [MOREPLOT] Add additional data to that already read in. # :Type Type [TYPE] Directly input data rather than reading it from a file. This command can be used to include data directly inside a Robot command file. # :Overtype Overtype [OVERTYPE] Input data (cf. TYPE) but doesn't rescale the plotting area. # :Typemore Typemore [TYPEMORE/MORETYPE] Directly input data to add to that already read in (either by "Type" or "Datafile"). # :Write Data Write Data [WRITEDATA] Write out the data to an ASCII file or to the screen (default). # THESE ARE FOR THE STYLE MENU :Plot Mode Plot Mode [PLOTMODE] Specify how the data are to be plotted (e.g. lines, symbols etc.). # :Title Title [TITLE] Specify/change the title of the plot. # :LeftTitle LeftTitle [LEFTTITLE] Title of plot will be left justified. # :CenterTitle CenterTitle [CENTERTITLE/CENTRETITLE] Title of plot will be centered. # :RightTitle LeftTitle [RIGHTTITLE] Title of plot will be right justified. # :X Label X Label [XLABEL] Specify/change the title for the x axis. # :Y Label Y Label [YLABEL] Specify/change the title for the y axis. # :Othertitles Othertitles [OTHERTITLES] Gives you access to extra labels apart from the defaults. # :Data Limits Data Limits [DATALIMITS] Specify the limits for plotting the data (doesn't affect limits for fitting!) # :Page Use Page Use [PAGEUSE] Specify the percentage of the plotting area used for the plot. # :Divide Window Divide Window [DIVWINDOW] Divide the plotting area into sub-windows. # :Select Window Select Window [SELWINDOW] Select one of the sub-windows created using "Divide Window" [DIVWINDOW] # :Titles Titles [TITLES] The plot will be labeled with titles for the plot and the axes. # :No Titles No Titles [NOTITLES] The plot will not be labeled with titles for the plot and the axes. # :Axes Axes [AXES] Plot axes. # :No Axes No Axes [NOAXES] Don't plot axes. # :Label Axes Label Axes [LABELAXES] Label the axes. # :Don't Label Axes Don't Label Axes [NOLABELAXES] Don't label the axes. # :Label X Axis Label X Axis [LABELXAXIS] Label the X Axis. # :Label Y Axis Label Y Axis [LABELYAXIS] Label the Y Axis. # :Don't Label X Axis Don't Label X Axis [NOLABELXAXIS] Don't Label X Axis # :Don't Label Y Axis Don't Label Y Axis [NOLABELYAXIS] Don't Label Y Axis # :Minor Tick Marks Minor Tick Marks [MINORAXES] The axes will also have minor tick marks drawn. # :No Minor Tick Marks No Minor Tick Marks [NOMINORAXES] The axes will not have minor tick marks drawn. # :Linear Axes Linear Axes [LINEARAXES] Both the x and y axis will be linear (not log). # :Logarithmic Axes Logarithmic Axes [LOGAXES] Both the x and y axis will be log (not linear). # :Linear X Axis Linear X Axis [LINEARXAXIS] The x axis will be linear (not log). # :Linear Y Axis Linear Y Axis [LINEARYAXIS] The y axis will be linear (not log). # :Log X Axis Log X Axis [LOGXAXIS] The x axis will be log (not linear). # :Log Y Axis Log Y Axis [LOGYAXIS] The y axis will be log (not linear). # :Plot Grid Plot Grid [PLOTGRID] A grid will be plotted as well as axes. This only applies if axes are plotted too. # :Don't Plot Grid Don't Plot Grid [NOPLOTGRID] A grid will not be plotted as well as the axes. # THE NEXT ITEMS ARE FOR THE PLOTMODE SUB-MENU :SymbolSize SymbolSize [SYMBOLSIZE] Specifies the size of symbols that are drawn if a plot mode of "Nice-symbol" is selected. # :FillStyle FillStyle [FILLSTYLE] Specifies how the polygon fill is to be done if a plot mode of "Fill" is selected. # THE NEXT ITEMS ARE FOR THE ANALYSE MENU :Sort Sort [SORT] Sort the data by ascending x values. # :Sort Y Sort Y [SORTY] Sort the data by ascending y values. # :Smooth Smooth [SMOOTH] Smooth the data by convolving with a triangular response. # :SmoothN SmoothN [SMOOTHN] Smooth the data by convolving with a triangular response "N" times. # :Rebin Rebin [REBIN] Rebin the data into larger bins. # :Histogram Histogram [HISTOGRAM] Create a frequency histrogram from the Y values. (i.e. a histogram of how often Y values occur in specified ranges). # :Data and Fit Limits Data and Fit Limits [DFLIMITS] Change the limits for both plotting and for fitting. :Fit Limits Fit Limits [XYFITLIMITS] Change the limits for fitting data (the plot limits are not changed!) # :Fold Fold [FOLD] Fold the data on a specified period (doesn't bin the data). # :Bin Fold Bin Fold [BINFOLD] Fold the data on a specified period and bin it. # :PDM PDM [PDM] Search for periodicities in the data using the Phase Dispersion Minimization technique described by Stellingwerf (1978). # :Find Period Find Period [FINDPERIOD] Search for periodicities in the data by folding, binning and calculating chi square. # :Periodogram Periodogram [PERIODOGRAM] Search for periodicities in the data by folding, binning and calculating chi square. Then plot the resulting values of chi square against trial period. # :Power Power [POWER] Search for periodicities in the data by calculating a power spectral density spectrum using a Fourier Transform. Whether the spectrum overwrites the data or not is controlled by whether Overwrite is set or not. If WeightFT is set then the power spectrum is calculated using data points which are weighted by their errors. The default is to plot the power spectrum on the screen - this is turned off with the command NoPlotFT. (e.g. if you set "Overwrite" and "NoPlotFT" you can get a better looking plot at the expense of overwriting the current data arrays). # :FFT FFT [FFT] Calculate the Fast Fourier Transform of the data. Data must be evenly spaced and the number of data points must be an integer power of 2. If the number of points doesn't satisfy this condition the default is to truncate the input data. Alternate behavior is set with the FFTMode command. Whether the FFT overwrites the data depends on whether Overwrite is set or not. Weighting (WeightFT/NoWeightFT) does not apply to the FFT which is never weighted. # :FFTMode FFTMode [FFTMODE] If the number of data points is not an integer power of 2 then an FFT cannot be calculated. To get around this the default of Robot is to truncate the data. Alternate behavior can be specified with the FFTMode command: - Truncate (default) - Pad (extend data using the mean data value) - Nearest (choose either Pad or Truncate depending on which is nearest logarithmically.) # :Overwrite Overwrite [OVERWRITE] If Overwrite is set then the spectrum calculated with POWER or FFT will overwrite the input data. Cancel with NOOVERWRITE. # :NoOverwrite NoOverwrite [NOOVERWRITE] If NoOverwrite is set then the spectrum calculated with POWER or FFT will not overwrite the input data. This is the default behavior. Change with OVERWRITE. # :PlotFT PlotFT [PLOTFT] If PlotFT is set then the calculated power spectrum is plotted on the screen. This is the default. Turn this off with NOPLOTFT. # :NoPlotFT NoPlotFT [NOPLOTFT] NoPlotFT turns off the plotting of the power spectrum that is done by default with the POWER and FT commands. Turn plotting back on again with PLOTFT. # :WeightFT WeightFT [WEIGHTFT] If WeightFT is set then the spectrum calculated with POWER (but not FFT) will be weighted by the errors on individual data points. Cancel with NOWEIGHTFT. # :NoWeightFT NoWeightFT [NOWEIGHTFT] If NoWeightFT is set then the spectrum calculated with POWER will not be weighted by the errors on individual data points. FFT never uses any weighting. This is the default behavior. Change with WEIGHTFT. # :Randomise Randomise [RANDOMISE/RANDOMIZE] Replace the data values with random values with the same mean and standard deviation. # :Randomize Randomize [RANDOMIZE/RANDOMISE] Replace the data values with random values with the same mean and standard deviation. # :Bin Fold Best Bin Fold Best [BINFOLDBEST] Fold and bin the data on the most likely period found by "Find Period" or "Periodogram". # :Fold Best Fold Best [FOLDBEST] Fold the data on the most likely period found by "Find Period" or "Periodogram". # :Median Median [MEDIAN] Calculate the median value of the y array within the current limits. # :MedianX MedianX [MEDIANX] Calculate the median value of the x array within the current limits. # :CCF CCF [CCF] Cross correlate one Robot data file against another. # THESE ARE FOR THE STATS. MENU :Moments Moments [MOMENTS] Calculate mean, standard deviation and other statistical properties of the data arrays. Once this command has been used then the parameters MEAN and SIGMA can be used as arguments to other commands. These are the mean and the standard deviation of the y array. # :Kendall Kendall [KENDALL] Kendall's tau statistic - a non-parametric test of correlation. Reference: Lehmann, E.L., 1975, "Nonparametrics: Statistical Methods Based on Ranks, San Francisco, Holden-Day. # :York York [YORK] Linear fitting weighting using both x and y errors. THIS IS BUGGY AND NOT TO BE TRUSTED! Reference: D. York, "Least squares fitting of a straight line", Canadian Journal of Physics, 44, 1079-1086, 1966. # HELP FOR THE ASTRO MENU :RA Dec to Galactic RA Dec to Galactic [RADECTOGAL] Converts your x and y values to galactic coordinates. This assumes that they are already RA and dec. values in degrees. # :Galactic to RA Dec Galactic to RA Dec [GALTORADEC] Converts your x and y values to equatorial coordinates. This assumes that they are already Galactic coordinates in degrees. # :RA Dec Plot RA Dec Plot [RADECPLOT] Plots points to indicate RA and dec. positions. This assumes that your x and y values are already RA and dec. values in degrees. Uses Aitoff/Hammer equal area projection. :RA Dec Grid RA Dec Grid [RADECGRID] Plots a grid showing RA and Dec. type coordinates. Positions may then be plotted on top of this. Uses Aitoff/Hammer equal area projection. # :FITS FITS [FITS] Extract a cross section through a FITS image. There is also a command "FITSX" which takes a cross section in the "other" direction. Ultimately I hope to merge the two commands together. # AXES PANEL :Top Axis Top Axis [TOPAXIS/NOTOPAXIS] Controls whether an axis is drawn at the top of the plot. # :Bottom Axis Bottom Axis [BOTTOMAXIS/NOBOTTOMAXIS] Controls whether an axis is drawn at the bottom of the plot. # :Left Axis Left Axis [LEFTAXIS/NOLEFTAXIS] Controls whether an axis is drawn at the left of the plot. # :Right Axis Right Axis [RIGHTAXIS/NORIGHTAXIS] Controls whether an axis is drawn at the right of the plot. # :X Tick Marks X Tick Marks [INTERNALXTICKS/EXTERNALXTICKS] Controls whether the tick marks for the X axis are internal or external. # :Y Tick Marks Y Tick Marks [INTERNALYTICKS/EXTERNALYTICKS] Controls whether the tick marks for the Y axis are internal or external. # :X Tick Size X Tick Size [XTICKSIZE] Specify the tick size of the tick marks on the X axis instead of using the default values. # :Y Tick Size Y Tick Size [YTICKSIZE] Specify the tick size of the tick marks on the Y axis instead of using the default values. # :Minor Tick Size Minor Tick Size [MINORTICKSIZE] Specify the ratio of the tick size of the minor tick marks compared to the tick size of major tick marks instead of using the default values. # :Minor Tick Frequency Minor Tick Frequency [MINORTICKFREQUENCY] Specify the frequency of the of the minor tick marks compared to the major tick marks instead of using the default values. # :Default Tick Size Default Tick Size [DEFAULTTICKSIZE] Let Robot automatically choose the tick sizes for you. This negates the effects of the "X Tick Size", "Y Tick Size" and "Minor Tick Size" buttons. # :No. of X Ticks No. of X Ticks [NTICKX] Specifies the approximate number of tick marks used on the X axis. # :No. of Y Ticks No. of Y Ticks [NTICKY] Specifies the approximate number of tick marks used on the Y axis. # SUB-MENUS :Arrow Arrow [ARROW] Draw an arrow between the specified end points. # :ArrowLine ArrowLine [ARROWLINE] Draw arrow heads as two lines. # :ArrowFill ArrowFill [ARROWFILL] Draw filled arrow heads. # :ArrowHollow ArrowHollow [ARROWHOLLOW] Draw hollow arrow heads. # :ArrowSize ArrowSize [ARROWSIZE] Specify the size of the arrow head. # :ArrowAngle ArrowAngle [ARROWANGLE] Specify the angle of the arrow head. # :SingleArrow SingleArrow [SINGLEARROW] Draw arrow head at just the end of the arrow. # :DoubleArrow DoubleArrow [DOUBLEARROW] Draw arrow heads at both ends of the arrow. # FOLLOWING IS HELP FOR POP-UP WINDOWS. Print Window :postscript_dir Output Directory: The directory where the output file will be written. # :postscript_file PostScript File Name: The name of the file that the PostScript output will be written to. A warning is given if the specified output file already exists. # :postscript_printer Printer Name (optional): Allows a particular printer to be specified. The print command issued is lpr -Pprinter or lp -dprinter # :postscript_number Number of Copies: Specify how many copies of the plot are to be printed. The default is one copy. # :direction_choice Plot Direction: Choose orientation for your plot. Either landscape (wider than it's tall) or portrait (taller than it's wide). # :print_now Print Now? If "Yes" is selected your PostScript file will automatically be sent to the printer. If "No" is selected then only an output file will be created. # :do_it Print/Write File Causes a PostScript file to be written or printed as specified with the buttons above. # :ps_type PostScript Type? Not normally used. If EPS is selected then the graph is moved to the bottom left hand corner. The "BoundingBox" in the PostScript file is adjusted and there is no "showpage" at the end of the file. # :ps_scale: Plot Scale? Allows you to choose between keeping the output PostScript file maintaining the same relative scaling as the display (WYSIWYG) or fitting to the full extent of the output page. # # #FOR THE FITTER WINDOW # :delete_model Delete Model Delete the selected model from the list. # :undelete_model Undelete Model Restore the last deleted model to the list. # :duplicate_model Duplicate Model Duplicate the selected model along with its parameters. # :model_list This list shows the models that have been chosen for the fit. The individual models are added together. To modify the parameters of a model select it with the mouse. # :Gauss Gauss Gaussian profile. function gauss(a1,a2,a3,x,i) c gaussian c a1=normalization c a2=mean, a3=standard deviation double precision z, t1, t2, t3 real x(*) gauss=0.0 t1 = x(i) t2 = a2 t3 = a3 z = (t1 - t2)/t3 z2=z*z if(z2-50.)16,20,20 16 gauss=a1*exp(-z2/2.) 20 return end # :Exponential Exponential Exponential curve. c exponential function expon(a1,a2,a3,x,i) c a1=normalization, a2=start time, a3=decay constant real x(*) double precision time, t1, t2 t1 = x(i) t2 = a2 time = t1 - t2 if(time.lt.0.0)then c before start of exponential expon = 0.0 return else expon = a1*exp(-time/a3) end if end # :Polynomial Polynomial Polynomial of user defined order. # :User User User specified function. This can presently only be changed by editing the file user.f or user.c and recompiling. Future plans are for an interpreted version. # :Lorentz Lorentz Lorentzian profile. c lorentzian function function ploren(a1,a2,a3,x,i) c a1=normalization, a2=mean, a3=width real x(*) div=(x(i)-a2)*(x(i)-a2)+a3*a3*0.250000000 ploren=a1*a3*a3*0.25/div end # :Tophat Tophat A "tophat" profile. i.e. 0 outside the specified range and a constant value within it. c top hat function tophat(a1,a2,a3,x,i) c a1=height,a2=start,a3=width real x(*) if(x(i).gt.a2.and.x(i).lt.a2+a3)then tophat=a1 else tophat=0.0 end if end # :Powerlaw Powerlaw Power law type function. c power law function powl(a1,a2,x,i) real x(*) powl=a1*x(i)**a2 end # :Sine Sine Sine wave. C Sine wave function sine(a1,a2,a3,x,i) real x(*) data twopi/6.2831853/ c a1=amplitude,a2=phase,a3=period sine=a1*sin(twopi*(x(i)-a2)/a3) end # :Triangle Triangle Triangle shape. c Triangle function trian(a1,a2,a3,x,i) c a1=height,a2=start,a3=half width at zero real x(*) if(x(i).lt.a2.or.x(i).gt.a2+a3+a3)then c not in triangle trian=0.0 return end if if(x(i).lt.a2+a3)then c ascending part trian=a1*(x(i)-a2)/a3 return end if c got to be descending bit trian=a1*(1.-(x(i)-a2-a3)/a3) end # :SineWave SineWave Periodic Sawtooh wave function. # :Blackbody Blackbody Blackbody emission spectrum curve. c Black body function bbody(a1,a2,x,i) c a1=normalization, a2=kt in units of x real x(*) bbody=a1*x(i)*x(i)*x(i)/(exp(x(i)/a2)-1.) end # :Orbit Orbit The velocity variations exhibited by a star in a binary orbit. # :npar_setter Parameters? Use this control to set the number of parameters for this model. This is only used for: - Polynomial - User For a polynomial this determines the order of the polynomial that will be fitted. For a User model this must be set to the actual number of parameters expected by the user supplied model. # :fix_free Free Fixed Determines whether the parameter value will be allowed to float during the fitting procedure or will be kept at the user specified value. # :replace_parameters Replace Parameters with Fit Results The parameter values specified above will be altered to the parameter values obtained from the results of the fit. # :replace_models Load & Replace Models If a fit has been done (e.g. from a robot command file) then this button will load the fitted models and their parameters into this Fit Controller panel. # :do_fit Do Fit! Carry out a fit to the data using the parameters listed above. Some fit properties such as fractional change in chi squared or the number of iterations to do can be accessed both via the local "Other Options" menu and the "Fit" menu on the main control panel. # # # options for End panel # :finish_dir_name Directory: The directory where the log and results files will be stored. (If you select a "Save" or "Copy" command.) # :finish_log_name Save Log File as: The name of the file where the log of robot instructions will be stored. (If you select a "Save" or "Copy" command from this panel.) # :finish_info_name Save Results File as: The name of the file where the results of such things as calculating statistics, fitting a function to the data will be stored. (If you select a "Save" or "Copy" command from this panel.) If you only plot data then this file may well be empty. # :save_continue Copy Log Files and Continue Copy the log and information temporary files to the file names specified above; then dismiss this window and continue with Robot. The temporary log and result files will continue to exist and subsequent Robot commands will be appended to them. # :clear_continue Clear Log Files and Continue Clear existing information in the log and results files and then dismiss this panel. Subsequent robot commands will still be logged. # :save_quit Save Log Files and Quit Save the log and information temporary files to the file names listed above and then exit from Robot. # :delete_quit Delete Log Files and Quit Delete the temporary log and information files and then exit from Robot. # :finish_hide Continue with Robot Remove this window and continue with Robot. The log and results files are not affected in any way. # # For the Colour selector panel # :colour_slider Apply Slider Values Causes the plotting color to be set to the RGB values set using the sliders. # :reset_colours Reset Set the slider color values back to what they were before you started changing them. Causes the plotting color to be set to the RGB values set using the sliders. # :colour_canvas This plotting area shows the color that is set by the slider values. (Might not be applied to the actual plot yet if the "Apply Slider Values" button is active). :specify_choice Apply Color to? Used to specify whether the color selected will be used for plotting everything, just the data points, or everything apart from the data points. # :color_slider Red Green Blue Use the sliders to alter the individual red, green and blue components of the color you want to apply. When you have the correct color apply it by pressing the button labeled "Apply Slider Values". # :gray_slider Gray This slider modifies all three color sliders at the same time. When you have the correct color apply it by pressing the button labeled "Apply Slider Values". # :color_choice: Colors: Select a color from the list. The color selected is applied immediately. # :tile_choice: Tile Type: [TILE] Specifies whether objects are painted using a fill style of a specified pattern or just a solid color. # :pattern_slider Pattern: If objects are filled with a pattern then this slider can be used to select which pattern is used. # :text_input Robot Command: A robot command (either as specified in the robot manual and stored in the log file, or as written in the menus) can directly be entered here. To repeat the previous command type !! A repeat a command beginning with "string" type !string To edit the previous line use the syntax ^old_string^new_string^ The commands typed here, and also those issued by pressing buttons and selecting menu items, may also be repeated and edited through the use of the window which is displayed if the button labeled "History..." is pressed. # # :mouser Get Coordinates: Specifying where lines, text etc. is to be plotted can either be done using the mouse or by typing the coordinates in response to a question. If you select typing you can still use the mouse if you hit as the response. :mail_to To: Mail should be sent to the address specified here. # :mail_cc Cc: A copy of your mail message should be sent to the address specified here. # :send Send Deliver the message in the text window to the address given. # :cancel Cancel Cancels execution of the current command. # :mail_cancel mail cancel Don't send mail and get rid of this pop-up window. # :send_mail Email... Creates a window you can use to compose a mail message to send to the author of Robot. # :web_help Web Help... Starts a web browser which is directed to a particular location. The default set in the Makefile is to use netsacpe to look at www.robotx.cx This could be changed to, for example, point to a local HTML version of the manual that comes with the full source distribution. # :canvas Current Robot Plot Area This is the current plotting area. To get a coordinate position click or drag the mouse in this area - coordinates are displayed at the lower right of the plot frame. To edit text double click on a word. The "menu" mouse button (the right hand one) will bring up a menu with some selected commands. # :old_canvas This is a previous plotting area you were using. You can make this the active plotting area again (e.g. to add to the plot or print it) or destroy it by using the "menu" (right hand) mouse button to bring up the menu for this plotting area. # :flip Flip Page [FLIPPAGE] Switch the plot area between landscape and portrait orientations. # :new_plot New Plot Area... [NEWPLOTAREA] Create a new plotting area. The previous plotting area will remain on the screen until you kill it. Using the right (menu) button on the mouse it is possible to reselect an old plotting area or print it. # :sheet_button Edit... Use a crude data editor. # :load_data Load Data Load the current data from the internal arrays into the editor. # :replace_data Replace Data Replace Robot's data arrays with the contents of this data editor. # :write_data Write Data This doesn't yet do anything! # :panel1 Control panel number 1. Try positioning the mouse over a button or menu item! # :panel2 Control panel number 2. Try positioning the mouse over a button or menu item! # :panel0 Control panel number 0. Try positioning the mouse over a button or menu item! # :answer_ok OK Select the option highlighted in the list above. As an alternative to clicking this button you may also double click on one of the above items. # # # For the history frame # :history_list This is a list of the most recently entered commands. To select an item single click on it. You may then edit it before executing it. # :history_text Command: The command that will be executed if the "Send Command" button is pressed. This command may be edited before you press the button. # :history_ok Send Command Execute the command listed above. If you double click on an item in the history list then that will automatically be executed. # # Drop site :dragon_droppings This is a "drop" target. To use this select a robot file in the file manager and drag and drop the icon onto this target. Or, simply drag and drop a file name from e.g. a terminal emulator window. Robot will then generally execute a "file" command with the name of the file selected as the argument. If the file name ends in ".dat" then, rather than executing a "file" command, a "datafile" command will be executed instead. # # For the file selector :filter Filter on: Select one of the pre-defined filter names. If a name is specified then only files which end in the specified string will be displayed. By selecting "Other" you can type in your own string to filer on. # :filter_name Filter String If "Other" is selected then you can type your own filter string here. Only file names which "end" in the specified string will be displayed. # :select_file Select Open the selected file for reading. You may also double click on a file to open it. In addition, you can directly type a file name at the line labeled "File:". # :file_text File: You can directly type a file name on this line and then either press "return" or click on the button labeled "Open". # :file_list Files: This shows the files that are available in the current directory. To select a file either double click on a file name or single click and then select "Open". You can also directly type a file name at the line labeled "File:". # :directory_list Directories: This shows the directories that are available in the current directory. To select a directory double click on a directory name. You can also directly type a directory name at the line labeled "File:". To go to the next higher level directory select "..". # :rescan_file Rescan Rescan the list of available files. This is useful if the files in a directory have changed. Also used if "Other" is slected for filtering. # :cancel_file Cancel Get rid of the file selector window. # # For the Axis control frame :axes Axes... This pops up a window containing controls for altering some properties of the axes. # :select_list To select an item from this list either double click on it or single click and then press the button labeled "OK" below. # For the text editing window (double click on # a text string in the plot window) :text_editor_button Apply Change Change the text string and/or position to the values specified above. # :text_editor_xpos x position Enter a new x position for the text string if desired. # :text_editor_ypos y position Enter a new y position for the text string if desired. # :text_editor_text Text is: Enter new text string here. If the text is centered or right justified then you cannot enter special control sequences or characters (e.g. \{alpha}) here. If you want to add these to an axis label then use the command XLABEL for example instead. # # For the zoom controls :zoom_controls Zoom... This button pops up a control panel which enables you to zoom in on various regions of a graph and also pan around. # :Zoom In Zoom In [ZOOMIN] Zoom in on the center of the plot. # :Zoom Out Zoom Out [ZOOMOUT] Zoom out from the center of the plot. # :Pan Right Pan Right [PANRIGHT] Shift plot area to the right. # :Pan Left Pan Left [PANLEFT] Shift plot area to the left. # :Pan Up Pan Up [PANUP] Shift plot area up. # :Pan Down Pan Down [PANDOWN] Shift plot area downwards. # :zoom_range Zoom Value [ZOOMVALUE] Specify the amount of zooming that is used. # :pan_range Pan Value [PANVALUE] Specify the amount of panning that is used. # :cursor_button Use Cursor [DFLIMITS; N; G] Use the cursor to select a region to plot. # :reset_button Full Range [RESCALE; N; G] Set the plot area to the full range. # # For controls relating to "special" characters. :specials Special Characters... Pop up a control panel to help with selecting "special" characters such as math symbols, Greek characters. # :symbols_list Symbols Select a symbol from this list. To add to the text string you're using either double-click on the item or press "Add". # :greek_list Greek Select a Greek character from this list. To add to the text string you're using either double-click on the item or press "Add". # :specials_list Others Select a special character from this list. To add to the text string you're using either double-click on the item or press "Add". # :specials_canvas A special character selected is "demonstrated" by being written in this area. # :special_ok Add Press this (or double-click on a panel entry) if you want a selected character to be added to the text string. # :extras Extras... Pop up a panel which allows you to access other control sequences such as commands for superscript, subscript, change the font etc. # :hide_extras Hide Extras Remove the panel which allows access to additional control sequences. # :extras_list Control Control sequences for changing the font. As a number of these cannot be displayed directly the demonstration area just displays the control sequence itself. Double click or press "Add" to include one of these sequences in the text string. # :specials_panel This panel is for assisting with adding "special" characters to text strings. # # The panel which deals with sub-window commands :split_panel This panel contains controls for dividing the plot area into sub-windows. Some of the controls duplicate commands such as "Divide Window" which is under the "Style" menu. The small plot area shows how the plot area is split up. Sub-windows can also be selected by clicking inside the small plot area. # :split_canvas This small plot area is intended to give a simple representation of how the real plotting area is divided into sub-windows. The solid rectangle indicates the location of the current sub-window in use. If there is more than one sub-window you can select a different sub-window by clicking there. # :divide_x No. of X windows Choose how many sub-windows in the "x" direction are going to be used. Press the "Divide Plot Area" button to apply the setting. # :divide_y No. of Y windows Choose how many sub-windows in the "y" direction are going to be used. Press the "Divide Plot Area" button to apply the setting. # :divide Divide Plot Area [DIVWINDOW] Apply the settings on the two sliders above to split the current plotting area into the required number of sub-windows. # :select_x Select Window (X) Select the sub-window in the "x" direction. Press the "Select Window" button to apply the choice. # :select_y Select Window (Y) Select the sub-window in the "y" direction. Press the "Select Window" button to apply the choice. # :select Select Window [SELWINDOW] Apply the settings of the two above sliders to select a sub-window. Alternatively a sub-window may be selected by clicking with the mouse in the small plot in the top right hand corner of this panel. # :window_gap Window Gap (%) [WINDOWGAP] Specify the gaps between the sub-windows. Any setting here affects the separation in both the "x" and the "y" directions. # :window_gap_x X Window Gap (%) [XWINDOWGAP] Specify the gaps between the sub-windows. Any setting here affects the separation in only the "x" direction. # :window_gap_y Y Window Gap (%) [YWINDOWGAP] Specify the gaps between the sub-windows. Any setting here affects the separation in only the "y" direction. # :page_use Page Use [PAGEUSE] Apply the settings on the Min. X, Min. Y, Max. X and Max. Y sliders to specify what fraction of the current plotting area is to be used. # :split_min_x Min. X The left edge of the plotting area specified as a percentage. (Applied with the "Page Use" button). # :split_min_y Min. Y The bottom edge of the plotting area specified as a percentage. (Applied with the "Page Use" button). # :split_max_x Max. X The right edge of the plotting area specified as a percentage. (Applied with the "Page Use" button). # :split_max_y Max. Y The top edge of the plotting area specified as a percentage. (Applied with the "Page Use" button). # # Used by the canvas menu :show_controls Bring Controls to Front Makes the control window the top window on the display. Useful if the main control panel is buried by other windows. # :plotscale Plotscale [PLOTSCALE] Scale the plotting area by a given factor. Can reduce the screen area used and so useful for small displays. # :kill_plot Destroy Plot Area Get rid of this plotting area and all arrays associated with it. # :select_plot Select Plot Make this old plot area the current plotting area. It will then be possible to draw to it, print it, etc. # :FITS Table... FITS Table... A basic FITS table reading routine. This is a prototype for a more extensive and useful utility to be added later.