|
Calling Sequence
|
|
Attractor(vars, exprlist, init)
Attractor(vars, exprlistlist, init, probabilities)
Attractor(vars, exprlist, init, opts)
Attractor(vars, exprlistlist, init, probabilities, opts)
|
|
Parameters
|
|
vars
|
-
|
list of names, with length greater than or equal to 2, specifying the variables of the iterative function. The first variable is used on the horizontal axis and the second variable is used on the vertical axis.
|
exprlist
|
-
|
list of algebraic expressions defining the iterative function on vars. The exprlist parameter must be of the same length as vars.
|
exprlistlist
|
-
|
list of lists of algebraic expressions defining the iterative functions on vars, with probabilities defined by probabilities. Each list of expressions must be of the same length as vars.
|
init
|
-
|
list of numeric real values, with the same length as vars, specifying the initial values of vars
|
probabilities
|
-
|
(optional) list of positive real numbers, such as , where N is the length of probabilities, defines the probability that the ith expression list in exprlistlist will be used for on the jth iteration, as explained below. The length of probabilities must be of the same length as the number of lists in exprlistlist. The default value is [1]
|
|
|
|
|
Options
|
|
•
|
iterations : keyword option of the form iterations=val, where val is a positive integer specifying the number of times the function defined by exprs will be applied. The default value is 100000.
|
•
|
outputimage : keyword option of the form outputimage=img where img is a color image as used by the ImageTools package, with dimensions of height and width. Attractor will fill img with the generated image defined below.
|
•
|
height : keyword option of the form height=val, where val is a positive integer specifying the height of the image. If outputimage is defined, the default value is the height of outputimage. Otherwise, the default value is 500.
|
•
|
width : keyword option of the form width=val, where val is a positive integer specifying the width of the image. If outputimage is defined, the default value is the width of outputimage. Otherwise, the default value is 500.
|
•
|
fixview : keyword option of the form fixview=truefalse. If fixview=false, the image will resize itself in order to fit all the points generated by the attractor. Otherwise, the image will only contain points within the boundaries formed by xmin, xmax, ymin, ymax. The default value is false.
|
•
|
xmin : keyword option of the form xmin=val, where val is a real number specifying the minimum value displayed on the horizontal axis. The default value is
|
•
|
xmax : keyword option of the form xmax=val, where val is a real number specifying the maximum value displayed on the horizontal axis. The default value is
|
•
|
ymin : keyword option of the form ymin=val, where val is a real number specifying the minimum value displayed on the vertical axis. The default value is
|
•
|
ymax : keyword option of the form ymax=val, where val is a real number specifying the maximum value displayed on the vertical axis. The default value is
|
•
|
loopvariable : keyword option of the form loopvariable=var, where var is a name specifying the variable representing the current iteration index. The default value is
|
•
|
redvariable : keyword option of the form redvariable=var, where var is a name specifying the red color variable at the current position on the image. The default value is
|
•
|
greenvariable : keyword option of the form greenvariable=var, where var is a name specifying the green color variable at the current position on the image. The default value is
|
•
|
bluevariable : keyword option of the form bluevariable=var, where var is a name specifying the blue color variable at the current position on the image. The default value is
|
•
|
redexpression : keyword option of the form redexpression=expr, where expr is an algebraic expression defining the coloring procedure of the red color value at the current position on the image. If redexpression= then no procedure is applied to the red value at the current point. The default value is
|
•
|
greenexpression : keyword option of the form greenexpression=expr, where expr is an algebraic expression defining the coloring procedure of the green color value at the current position on the image. If greenexpression= then no procedure is applied to the green value at the current point. The default value is
|
•
|
blueexpression : keyword option of the form blueexpression=expr, where expr is an algebraic expression defining the coloring procedure of the blue color value at the current position on the image. If blueexpression= then no procedure is applied to the blue value at the current point.The default value is
|
|
|
Description
|
|
•
|
The Attractor command generates an image of points of an iterative function (the first variable in vars against the second variable in vars) being applied iterations times.
|
•
|
Starting at the point =init in , where N is the number of variables in vars, the sequence =, 1 iterations, is generated.
|
•
|
The function , is defined by the following algorithm:
|
|
Apply the function to the current point:
|
|
Replace the jth component of with :
|
|
Increment j by 1, and repeat the process with the new . Stop when , where is the number of variables in vars.
|
•
|
Each is defined by evaluating at the current values of the variables in vars.
|
•
|
If given an exprlistlist, then one of the functions in exprlistlist will be randomly selected to be applied to , for each 0 iterations-1. The probability that the ith function defined in exprlistlist is applied to is equal to .
|
•
|
Whenever this process yields a point , the values are examined to find which pixel in the image they correspond to. Then, the expressions , , are evaluated, substituting the values for the variables , and the current red, green, and blue values of that pixel for the variables , , and , respectively.
|
•
|
The red, green, and blue values of the pixel are then updated to the newly evaluated values.
|
•
|
If a coloring expression is then the color, corresponding to the expression, of the pixel will be unchanged
|
•
|
Note that redexpression, greenexpression, blueexpression are applied to an image as defined by ImageTools:-Image, thus the minimum and maximum color values are 0 and 1 respectively.
|
•
|
Attractor returns an image as described above, the range of the horizontal axis, and the range of the vertical axis. Further coloring procedures, defined in ImageTools, can be applied to the image.
|
•
|
The defaults for options redexpression, greenexpression, and blueexpression generate an image that is designed to be used with ImageTools:-ColouringProcedures:-HueToRGB.
|
|
|
Compatibility
|
|
•
|
The IterativeMaps:-Attractor command was introduced in Maple 2015.
|
|
|
|
|