Sollya User's Manual

Name:

asciiplot plots a function in a range using ASCII characters

Library name:

void sollya_lib_asciiplot(sollya_obj_t, sollya_obj_t)

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]);
                                                                             xx
                                                                           xx
                                                                         xx
                                                                       xx
                                                                     xx
                                                                  xxx
                                                                xx
                                                             xxx
                                                           xx
                                                        xxx
                                                     xxx
                                                  xxx
                                               xxx
                                            xxx
                                        xxxx
                                     xxx
                                 xxxx
                             xxxx
                         xxxx
                     xxxx
                xxxxx
           xxxxx
      xxxxx
   xxx

Example 2:

   > asciiplot(expm1(x),[-1;2]);
                            |                                                 x
                            |                                                x
                            |                                               x
                            |                                              x
                            |                                            xx
                            |                                           x
                            |                                          x
                            |                                        xx
                            |                                       x
                            |                                     xx
                            |                                   xx
                            |                                 xx
                            |                               xx
                            |                             xx
                            |                           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.7182818284590452353602874713526624977572470937