Sollya User's Manual

Name:

asciiplot plots a function in a range using ASCII characters

Usage:

asciiplot(function, range) : (function, range) -> void

Parameters:

function represents a function to be plotted
range represents a range the function is to be plotted in

Description:

asciiplot plots the function function in range range using ASCII characters. On systems that provide the necessary TIOCGWINSZ ioctl, Sollya determines the size of the terminal for the plot size if connected to a terminal. If it is not connected to a terminal or if the test is not possible, the plot is of fixed size 77x25 characters. The function is evaluated on a number of points equal to the number of columns available. Its value is rounded to the next integer in the range of lines available. A letter "x" is written at this place. If zero is in the hull of the image domain of the function, an x-axis is displayed. If zero is in range, a y-axis is displayed. If the function is constant or if the range is reduced to one point, the function is evaluated to a constant and the constant is displayed instead of a plot.

Example 1:

   > asciiplot(exp(x),[1;2]);
                                                                              x
                                                                            xx
                                                                         xxx
                                                                       xx
                                                                     xx
                                                                  xxx
                                                                xx
                                                             xxx
                                                           xx
                                                        xxx
                                                     xxx
                                                  xxx
                                               xxx
                                            xxx
                                         xxx
                                     xxxx
                                 xxxx
                              xxx
                          xxxx
                     xxxxx
                xxxxx
            xxxx
       xxxxx
   xxxx

Example 2:

   > asciiplot(expm1(x),[-1;2]);
                            |                                                 x
                            |                                                x
                            |                                               x
                            |                                              x
                            |                                             x
                            |                                           xx
                            |                                          x
                            |                                         x
                            |                                       xx
                            |                                     xx
                            |                                   xx
                            |                                 xx
                            |                                x
                            |                             xxx
                            |                           xx
                            |                        xxx
                            |                     xxx
                            |                 xxxx
                            |             xxxx
                            |         xxxx
                            |   xxxxxx
   ---------------------xxxxxxxx-----------------------------------------------
            xxxxxxxxxxxx    |
   xxxxxxxxx                |

Example 3:

> asciiplot(5,[-1;1]);
5

Example 4:

> asciiplot(exp(x),[1;1]);
2.71828182845904523536028747135266249775724709369998