APPEND

 The specified points are appended to last data set. If you wish to create a new set you should use the DATA SET command. This option may not be used with the SETS or POINTS options. It is also illegal for mesh data. Along with APPEND you must specify 3 of the options FROM,TO,BY,N.

BINS|VALUES

 BINS creates values at the centers of bins whose edge is defined by the values. VALUES specifies the values for the specified coordinate. If you specify a range of values or bins, you may not specify operations such as TIMES,DIVIDE,MINUS,PLUS or a coordinate such as X,Y,DX... or an equation. If you generate a new data set you must specify 3 numbers for FROM,TO,BY, and N. If you modify an existing data set only 2 numbers are spcified. You may also specify a single value. examples TD:DX=0.5 Sets all DX values to 0.5 TD:X=BINS FROM 1 to 10 by 2 Generates a new data set with values X=2,4,6,8 TD:X=VALUES FROM 1 TO 10 BY 2 or... TD:X FROM 1 TO 10 BY 2 Generates a new data set with values X=1,3,5,7,9 TD:X FROM 1 BY 2 SET=2 Modifies data set 2 with values X=1,3,5,7,9... TD:X=Y TIMES FROM 1 TO 10 BY 2 Is illegal TD:X=Y TIMES 2 is legal

ERROR

 This specifies the error on the value you have specified. If you use NOERROR the error analysis is turned off. This only works when you are modifying X,Y,Z values. The specified error is used to modify the DX,DY,DZ value. example Y=Y * 5.0 Will multiply each Y and DY value by 5.0. Y=Y * 5.0 ERROR=0.1 Will multiply each Y and DY value by 5.0. The specified error of 0.1 Will be used to compute the actual DY value. Y=Y * 5.0 NOERROR Will multiply each Y value by 5.0. The DY values will remain unchanged. Y="LOG(YV)" NOERROR Will take the LOG to base 10 of each Y value. The DY values will remain unchanged. Y="LOG(YV)" Will take the LOG to base 10 of each Y value. The DY values will be modified as: DY=ABS(LOG(Y+DY)-LOG(Y)).

expression

 You may use an expression inside quotes to actually calculate the value for an existing data set. The expression is evaluated for each value required. The lexicals V_XVALUE,V_DXVALUE,V_ZVALUE... are the current X,DX,Y... needed to perform the calculation. If you do not specify NOERROR then the error is also computed when X,Y,Z are modified by the expression. If you use an expression you may not use any other options except for POINTS, LINES, COLUMNS, SETS, and LOG and ERROR.

Additional Information on:

  • errors
  • examples

    • LINES|ROWS

     selects the mesh rows for which values are generated. If a single number is specified it is the row number to set. If both n1 and n2 are specified they are the first and last row to set.

    LOG

     Types on your terminal the results of the operation. (Default:LOG=OFF)

    NAME

     The new set will usually have a name consisting of a transformation name followed by the old set name. If you specify a new name it is applied to the new data set. If the name ends in "%" then the old name is appended to the new name. See option:APPEND

    POINTS|COLUMNS

     selects the points or mesh data columns for which values are generated. If a single number is specified it is point number to set. If both n1 and n2 are specified they are the first and last point to set.

    POISSON|SQRT

     applies only to Dn and makes Dn=SQRT(n). This is counting statistics. It is a special case of binomial statistics for a large number of samples.

    SAMPLES

     SAMPLES=s applies binomial statistics to Dn, Dn=SQRT(max(n,1)*max(s-n,1)/s). You must supply the number of samples (s). If you generate a set of data by a Monte-Carlo method where the total number of hits s is selected, but the distribution of the hits is generated by the program then you should use Binomial statistics.

    SETS

     selects the data set to modify.

    TIMES

     Multiplies the selected coordinate by the selected value. If you are multiplying X,Y, or Z by a constant the DX,DY, or DZ are also multiplied by the constant. In addition if ERROR was specified then the final Dn will be modified by the specified error. DY=SQRT(DY**2+(e*n/c)**2)*c where C is the specified constant.

    If a coordinate and a number are specified, but no operator then TIMES is assumed. example To multiply y by 2+-0.1 Y=Y TIMES 2 ERROR=.1 or... Y=Y * 2 ERROR=.1 To multiply y by 2 with no error on the value 2. Y=2 Y or... Y=2 TIMES Y or... Y=2 * Y

    PLUS

    Adds the value to the coordinate. If you specify ERROR and you are adding a constant to X,Y, or Z the DX,DY, or DZ are also modified. DY=SQRT(DY**2+(e)**2) where e is the specified error. example To add 2+-0.1 to y Y=Y PLUS 2 ERROR=.1 or... Y=Y + 2 ERROR=.1

    MINUS

     Subtracts the value from the coordinate or the coordinate from the value. If you specify ERROR and you are subtracting a constant to X,Y, or Z the DX,DY, or DZ are also modified. DY=SQRT(DY**2+(e)**2) where e is the specified error. example To subtract 2+-0.1 from y Y=Y MINUS 2 ERROR=.1 or... Y=Y - 2 ERROR=.1 To subtract Y from 2. Y=2 MINUS Y or... Y=2 - Y

    DIVIDE

     Divides the coordinate by the value or a value by a coordinate. If you are dividing X,Y, or Z by a constant the DX,DY, or DZ are also divided by the constant. In addition if ERROR was specified then the final Dn will be modified by the specified error. DY=SQRT(DY**2+(e*n/c)**2)/c where C is the specified constant. example To divide y by 2+-0.1 Y=Y DIVIDE 2 ERROR=.1 or... Y=Y / 2 ERROR=.1 To divide 2+-0.1 by Y Y=2 ERROR=.1 DIVIDE Y or... Y=2 ERROR=.1 / Y

    warning

     If you have already plotted the current data, this command will delete it if just a value, or range of values is specified for X,Y, or Z. If you wish to keep the data, you should use the option POINTS, SETS, or APPEND.

    examples

     TD:X VALUES FROM 0 to 10 by 1 creates a data set with 11 values for X 0,1,2,...10 TD:X BINS FROM 0 to 10 N=10 or ... TD:X FROM 0 to 10 by 1 BINS create a data set with 10 values for X 0.5,1.5....9.5 TD:X FROM 0 to 20 BINS POINTS=1 TO 10 generates 1,3,5,...19 for Data points 1 to 10. TD:Y=2.0 POINT=5 data point number 5 is set to 2.0 TD:DY =5 Sets all Y errors to +-5. TD:DX =.1 * X or .... TD:DX =.1 TIMES X Sets all X errors to 1. times the X value. TD:X = 1 PLUS X or ... TD:X = 1 + X Adds 1.0 to all X values. TD:X = 1 + X ERROR=0.1 Adds 1.0 to all X values and adds 0.1 in quadrature to all DX. DX=SQRT(DX**2+(0.1)**2) TD:Y = DIVIDE 5 Both Y and DY are divided by 5. TD:Y =Y * 5 ERROR=0.1 The Y coordinate is multiplied by 5, and the DY is modified according to the error. DY=5*SQRT(DY**2+(0.1*Y/5)**2) TD:SET ORDER Y TD:1.5; 3.8; 9.7 TD:X FROM 1 to 3 or.... TD:X FROM 1 BY 1 is the same as: TD:1 1.5; 2 3.8; 3 9.7 TD:DY SAMPLES=100 Each DY is now equal to SQRT(Y*(100-Y)/100). This assumes that each Y represents the number of sucesses out of a sample of 100. TD:Y=Y / V_SUM Normalizes the data to the total sum over all data. Note: This may not have the desired effect if you have more than 1 data set. To normalize only one data set: SET STATISTICS SET=2 TD:Y=Y / V_SUM Normalizes only data set 2. TD:Y="LOG(YV)" Transforms Y by taking the LOG to base 10. DY is likewise modified. Y=LOG10(Y) and DY=ABS(LOG10(Y+DY)-LOG10(Y))

    mesh_examples

     Assume you have mesh data X,Y (ROW,COLUMN) of size 20, 30. TD:X=X MINUS 5 Shifts the X scale TD:Y=Y TIMES 2 Expands the Y scale TD:Z=10 ROW=5 COLUMN=3 Modifies 1 entry TD:Z=0 Sets all mesh values to 0.0 TD:Z=Z PLUS 1 ROW=5 TO 10 COLUMN=3 TO 5 Adds 1 to all mesh values for the specified range of rows and columns. 15 values are modified.