onegenplot(1) General Commands Manual onegenplot(1)NAMEonegenplot - Make an X/Y plot with genhstpltSYNOPSISonegenplot [options] data_fileDESCRIPTIONOnegenplot is a Python script to make Genhstplt draw one X/Y plot then exit when its graph window is closed. It has many default set- tings so that simple graphs can be viewed with a minimum of entries. The data file is a text file with one or more columns of data values for each individual item, separated by commas, spaces, or tabs. In addition, the first entry for each item can be a type number or group identifier. The file can have non-numeric lines at the beginning that need to be skipped over. In most cases, this program can automatically detect both the number of columns of data values and how many lines of non-numeric text to skip at the beginning. See the-ncoland-skipoptions for the limitations of this capability. If there are no types in the file, you can graph one or more columns of values versus one other column. If there are types, you can graph one column versus another for one or more types. In addition, you use a sequence of numbers instead of a data column for the X values, and thus plot the sequential values of one or more columns or types. Note that the graph window can be saved as a PNG file or printed from a popup menu brought up by right-clicking in the window. For publica- tion-quality graphs in Postscript, it is necessary to run Genhstplt directly.OPTIONSOnegenplot uses the PIP package for input (see the manual page for pip). Options can be specified either as command line arguments (with the -) or one per line in a command file (without the -). Options can be abbreviated to unique letters; the currently valid abbreviations for short names are shown in parentheses.-input(-i)OR-InputDataFileFilenameName of file with data to plot. If this option is not entered, the first non-option argument is used for the name.-ncol(-n)OR-NumberOfColumnsIntegerThe number of columns of data per item in the file, or 0 if the number is in the file on a line just before the data, or -1 if all the entries for a data item are on one line, so that the number can be determined automatically. The default is -1.-skip(-sk)OR-SkipLinesAtStartIntegerNumber of lines to skip at the beginning of the data file. If this option is not entered, the program will attempt to deter- mine the number of lines to be ignored automatically. This should work provided that any one of these conditions is the case: 1) the extra lines always start with non-numeric text; 2) the number of numeric values at the beginning of extra lines is fewer than the number of columns entered with -ncol (minus 1 if -types is entered too); 3) extra lines start with a non-integer if -ncol is entered as 0; 4) extra lines start with only one number if -types is entered.-columns(-col)OR-ColumnsToPlotMultipleintegersNumbers of the columns to plot, numbered from 1. If more than one number is entered and -ordinals is not entered, the first number specifies the column to use for the X axis; otherwise all numbers specify columns to plot on the Y axis. If there are no data types, multiple columns can be given for the Y axis; if there are data types, only one column can be listed for Y. If this option is not entered, the default is 1 and 2, unless there is only one data column or -ordinals is entered, in which case the default is 1.-types(-ty)OR-TypesToPlotMultipleintegersOne or more data types to plot; types are not numbered from one but correspond to the arbitrary type values in the data file. With this entry, the first column of numbers in the file will be read as type values, and the column after that will become the first column of data. If there are type numbers in the file and this entry is not given, the type numbers will end up in the first column of data.-symbols(-sy)OR-SymbolsForTypesMultipleintegersOne or more symbols to use for the different types or columns being plotted. Available symbol numbers are: 1, 2: Open and filled squares 3, 4: Open and filled diamonds 5, 6: Open and filled triangles 7, 8: X and + 9, 10: Open and filled circles 11, 12: Open and filled inverted triangles 13, 14: U and S 15: Open circle with vertical line 18: Small dot 19: Horizontal line 0: No symbol, points are automatically connected with lines -1: Draw item number at each data point If no, or not enough, symbol values are entered, the program will assign symbols in order from this list: 9, 7, 5, 8, 13, 14, 1, 11, 3, 10, 6, 2, 12, 4, excluding any that have already been specified.-connect(-con)OR-ConnectWithLinesDraw lines between successive points within a type or column; this entry is not needed if the symbol is 0-ordinal(-o)OR-OrdinalsForXvaluesPlot data within each column or type sequentially in X, i.e., versus a set up numbers that start from 1 and increase by 1 for each value plotted. This entry is implied if only one column is entered.-xlog(-xl)OR-XLogOrRootAndBaseTwofloats1 to take the logarithm or 2 to take the square root of X val- ues, and the base to add before that operation. A base is needed to avoid taking the logarithm or quare root of negative numbers. An appropriate base value can also be helpful for spreading out the data more evenly. The numeric axis labels on the graph will be in the units of the data after the operation, e.g., in log units, not in original units.-ylog(-yl)OR-YLogOrRootAndBaseTwofloats1 to take the logarithm or 2 to take the square root of Y val- ues, and the base to add before that operation.-hue(-hu)OR-HueOfGroupTextstringThis option can be used to specify a color for each group being plotted. Groups are numbered from 1 and correspond to the types or columns being plotted in separate curves. Enter either 4 integers separated by commas (the group number and the red, green, and blue values, ranging from 0 to 255) or the group num- ber and a stock color name separated by a comma. Groups without a color will be drawn in black. (Successive entries accumulate)-defhue(-d)OR-DefaultHuesAssign default colors for all groups without a specific hue entry. The default colors are a subset of 12, including black, that are chosen from the stock colors for their distinguishabil- ity. Each group without a color specified by-huewill be assigned one of these default colors, with the colors used in order and cycled through again if more than 12 are needed.-stock(-st)OR-StockColorListList standard colors available by name in the -hue option. These are a subset of standard HTML color names and values.-axis(-a)OR-XaxisLabelTextstringLabel for the X axis-keys(-k)OR-KeyLabelsTextstringText to display as a key for one type or column, shown along with that type's or column's symbol, if any, on the right side of the window. Text is drawn in a large box with word wrapping enabled, so the key can be longer than the space on the right of the graph. The program will show default keys with the column or type number if not enough labels are entered. (Successive entries accumulate)-message(-m)OR-MessageBoxLineTextstringOne line of a message to be displayed in a message box (Succes- sive entries accumulate)-tooltip(-to)OR-ToolTipLineTextstringOne line of tooltip for the graphics window (Successive entries accumulate)-size(-si)OR-SizeOfPlotTwointegersSize of graphics window in X and Y, in pixels-position(-po)OR-PositionOfPlotTwointegersCoordinates of the top left corner of the graphics window in X and Y, in pixels, where Y is 0 at the top of the screen.-xminmax(-xm)OR-XRangeMinAndMaxTwofloatsLower and upper limit of X range for graph. If the limits do not define a range that is a multiple of one of the allowed fac- tors, the range will be rounded up.-yminmax(-ym)OR-YRangeMinAndMaxTwofloatsLower and upper limit of Y range for graph-png(-pn)OR-SavePNGandExitFilenameSave the graph as a PNG to the given file name (which should include its extension), close the graph window, and exit the program.-remove(-r)OR-RemoveDataFileDelete input file when exiting. This option is meant to be used only when running in the background, as cleanup will not occur if the program is interrupted with Ctrl-C.-help(-he)OR-usagePrint help output-StandardInputRead parameter entries from standard inputEXAMPLESIf the data file has 2 or more columns, onegenplot data_file will plot the second column versus the first, showing scattered open circles. If the data file has at least 5 columns, onegenplt -col 1,3,5 -con data_file will plot column and 3 and 5 versus column 1, with circles and X's, respectively, connected by lines. If the data file has type numbers 10, 20, 30, and 40 and at least 5 data columns, onegenplt -col 2,4 -type 20,40 -sym 10,9 data_file will plot column 4 versus column 2 for types 20 and 40 with closed and open circles, respectively. If the data file has has 120 lines of data in 6 columns, onegenplt -col 3,6 -sym 0,0 -con -ord data_file will plot columns 3 and 6 sequentially versus 1 to 120 with lines and no symbols.AUTHORDavid MastronardeSEEALSOgenhstplt Email bug reports to mast at colorado dot edu. IMOD 4.12.28 onegenplot(1)