branches
plot the branches of a multi-valued function
Calling Sequence
Parameters
Description
Examples
branches(f)
branches(f, ...)
branches(f, 'show_defaults')
f
-
function name
...
options
'show_defaults'
lists the defaults used by branches for the given function f
This routine produces a plot of the ranges of the branches of the complex multi-valued function f, if this information is known.
One of the major difficulties with multi-valued functions over the complex number field is determining a principal branch, and then assigning the values of the function consistently on the branch cut(s). This latter assignment is referred to as closure.
branches can use one of two methods to indicate how closure on the branch cut(s) of the function f is defined: color or curve thickening. The default is to use color. In this case, boundary curves of the same color belong to the same range. This is usually sufficient to deduce the closure. In addition, the principal branch of the function is labeled in the same color as its boundary.
For non-color devices, or for devices on which the color variation is insufficient, curve thickening can be used to indicate closure by specifying the option thick. This will use a default line thickness to widen the boundary curve into the region to which it is attached.
Curve thickening is simulated by drawing parallel curves. If the default values for this mechanism are not adequate for the plotting device, or if there is still insufficient visual information available to deduce closure, the following additional options can be used. (The presence of any of these options implies that curve thickening will be used.)
thick = nonnegative
Sets line thickness to t units.
gap = positive
Set the gap between the parallel curves to g units
skip = nonnegint
Specifies how many curves to omit after the initial one
An additional option, colors, can be used to change the selection of colors used to display the plots. The format is:
colors = list
Specifies the colors of the curves. See plot colors for details.
The following functions are currently known to branches:
arcsin
arccos
arctan
arccsc
arcsec
arccot
arcsinh
arccosh
arctanh
arccsch
arcsech
arccoth
ln
LambertW
branches⁡arccosh
branches⁡arcsin,thick=0.1,gap=0.02,skip=2
The command to create the plot from the Plotting Guide is
branches⁡LambertW
The curve and text colors can be modified
branches⁡LambertW,colors=black,Purple,magenta
Show the default parameter values
branches⁡arccos,show_defaults
thick = .6e-1 gap = .2e-1 skip = 0 colors= ["magenta", "blue", "red", "green", "cyan", "yellow"]
See Also
initialfunctions
plot colors
Download Help Document