STRING INTERACTION

STRING INTERACTION

Let Subcommand

Given a list of parameters, create a string that represents an interaction term.

This is a specialized command that is used in creating labels in the context of a 2-level full or fractional factorial design.

As an example, suppose we have the parameters J1, J2, and J3 where J1 = 3, J2 = 1, and J3 = 5, then this command will create a string containing

X3 * X1 * X5

The parameters identify factors of interest, so they will typically contain integers in the range 1 to k where k is the number of factors in the design. If the parameter is negative, then that parameter will not be included in the output string.

LET <sout> = STRING INTERACTION <j1> ... <jk>
where <sout> is the name of the resulting string;
and <j1> ... <jk> is a list of parameters.

LET SOUT = STRING INTERACTION J1 J2 J3
LET SOUT = STRING INTERACTION J1 J2 J3 J4 J5

The total number of characters that DATAPLOT can use for storing functions and strings is set when DATAPLOT is built. The current default (11/2008) is 50,000 characters. Previous versions may set this limit at 1,000 or 10,000 characters. This limit applies to the combined number of characters for all functions and strings.

None

None

NUMBER OF WORDS	=	Return the number of words in a string.
UPPER CASE	=	Convert a string to upper case.
LOWER CASE	=	Convert a string to lower case.
LET FUNCTION	=	Defines a function.
LET STRING	=	Defines a string.
READ STRING	=	Reads a string from a file.
SUBSTITUTE CHARACTER (^)	=	Substitute the value of a string or parameter.
CONCATENATE CHARACTER (&)	=	Concatenate two strings.
SUBTRING	=	Extract a substring from an existing string.
BLANK STRING	=	Create a blank string.
STRING INDEX	=	Extract the start/stop positions of a substring within a string.
STRING CONCATENATE	=	Concatenate one or more previously defined strings.
STRING EDIT	=	Edit a string.
STRING MERGE	=	Insert a string into another string without overwrite.
STRING LENGTH	=	Return the length of a string.
CHARACTER	=	Convert numeric values to strings based on the ASCII collating sequence.
ICHAR	=	Convert a string to numeric values based on the ASCII collating sequence.
GROUP LABEL	=	Define the text for group labels.

2-Level Full and Fractional Factorial Designs

2018/04

 
. Step 1:   Define inputs
.
let j1 = 1
let j2 = 2
let j3 = 3
let j4 = 4
let j5 = 5
.
. Step 2:   Execute the command
.
let stnew  = string interaction j1 j2 j3 j4 j5
.
let j4 = -9999
let j5 = -9999
let stnew2  = string interaction j1 j2 j3 j4 j5
.
print "stnew:  ^stnew"
print "stnew2: ^stnew2"
    

The following output is generated

stnew:  X1 * X2 * X3 * X4 * X5
stnew2: X1 * X2 * X3