EBTCalc (Desktop)

Description

EBTCalc (Desktop) is a Reverse Polish Notation (RPN) calculator that can have custom buttons. Custom buttons are programmed in Javascript with a convenient editor. EBTCalc runs on Windows 10, OSX, and Linux. EBTCalc is open source.

EBTCalc Main Screen

EBTCalc Main Screen

RPN Calculators

RPN calculators require numbers to be entered before the operation is performed. Operations have no priority - they are performed in the order entered. Consequently RPN calculators do not need parentheses. Since numbers must be entered before the operation to be performed, to evaluate 1 + 2:
  1. Press the 1 button
  2. Press the Enter button
  3. Press the 2 button
  4. Press the + button
The result, 3, is left on the stack.

More Examples:

ExpressionHow to Evaluate
17 * (3 + 4)17 Enter 3 Enter 4 + *
3.14 * 123.4^23.14 Enter 123.4 x^2 *
(3^2 * (7^2 - 8)) / 53 x^2 7 x^2 8 - * 5 /

The Value Entry Area and the Stack

EBTCalc Value Entry Area, Stack, Category Selector, Built-in Buttons, Custom Buttons

Value Entry Area, Stack, Category Selector, Built-in Buttons, Custom Buttons

As values are entered they are displayed in the Value Entry Area. Press the BS (Back Space) button to correct errors in the value you're entering. Press the Clear Ent (Clear Entry) button to clear the entire value.

Every time you press the Enter key, the value you entered is placed at the top of a list, called the Stack.

Built-in Buttons

EBTCalc includes the usual buttons that you'd expect to find on a calculator. These buttons operate on values stored in the stack. For instance, in the above illustration, pressing the + button would take the top two values from the stack (2 and 1), add them, and finally replace them with the sum (3).

Pre-Programmed Buttons

In addition to the built-in buttons, EBTCalc includes many pre-programmed buttons in various categories. For instance, in the above illustration, the Main category includes the following buttons: ⌈x⌉, ⌊x⌋, →Fraction, and so on.

Since pre-programmed buttons are implemented in Javascript, they can be removed or changed by editing the Javascript code.

Category Selector

Pre-programmed and custom buttons are arranged in categories. To display the buttons belong to a particular category, click the Category Selector (figure 2).

Adding Custom Buttons (with Methods)

Custom buttons are added by programming them in Javascript. To add a new button, click Edit. For example, to add a new custom button to compute the distance between two points, click Edit.

Add Custom Button, Step 1

Creating a custom Button, Step 1

Add the following code. Do not enter the line numbers.

1:  class Geometry {
2:    // button Geometry.distance "Distance" "Geometry"
3:    static distance(x1, y1, x2, y2) {
4:      console.log(`Geometry.distance(${x1}, ${y1}, ${x2}, ${y2})`);
5:
6:      return Math.sqrt(Math.pow(x1 - x2, 2) + Math.pow(y1 - y2, 2));
7:    }
8:  }

Press the Save button, then press Close. Click the Category Selector and select "Geometry". You should now see the button for the distance function. Try it out:

Click 0 and click Enter
Click 1 and click Enter
Click 1, 0, 0 and click Enter
Click 1, 0, 1 and click Enter

The stack should now have the following values:

0
1
100
101

Custom Button Help Text

When you hover the cursor over any custom button, you'll see help text that shows the parameters that must be entered on the stack. For example, hover over the custom "Distance" button you just created:

Custom Button Help Text

Custom Button Help Text

Click the Distance button you just created. The computed distance (141.42) will appear in the stack.

Now an explanation of the source code you entered:

In line 1 a new class named Geometry was declared. The comment in line 2 cased the custom "distance" button to be created. Such comments must be entered in the following format, exactly:

    // button {class name.method name} "{button text}" "{category text}"

    or

    // button {function name} "{button text}" "{category text}"

The distance method was declared in lines 3 to 7. Since the distance method is static, it's not necessary to have a Geometry object on the stack to call the distance method. Once 4 numbers have been entered, the distance button can be pressed to compute the Pythagorean distance between the points (x1, y1) and (x2, y2). In line 4 the arguments are logged. More about logging soon.

How Stack Values are Converted to Arguments

The arguments (x1, y2, x2, y2) in line 3 come from values the user has previously entered on the stack:

How Stack Values are Converted to Arguments

How Stack Values are Converted to Arguments

Default and Rest Arguments

You can use default and rest parameters in your methods and functions. For example:

// button defaultedArg "defaultedArg" "Functions"
function defaultedArg(x, y = 0) {
  console.log(`defaultedArg(${x}, ${y})`);

  return x + y;
}

// button restArg "restArg" "Functions"
function restArg(x, ...moreArgs) {
  console.log(`restArg(${x}, [${moreArgs}])`);

  let sum = 0;

  moreArgs.forEach(element => {
    sum = sum + element;
  });

  return x * sum;
}

With the above custom button code, when you click the "defaultArg" button, if there are two values on the stack, they will be converted into the x and y arguments. If there is only one value on the stack, it will be converted to the x argument, and the y argument will have the default value of 0.

When you click the "restArg" button, the first value on the stack will be converted to the x argument. All other values, if any, will be converted into the moreArgs argument, which is an array.

Logging

Click the Log button to see the log messages written by the distance function:

Log Messages

Log Messages

Adding Custom Buttons (with Functions)

In the previous example, you created a class (Geometry) and a method (distance), callable by clicking a custom button. In this example, you'll do the same thing, with a function.

Click Edit to return to editing custom button code. Add the following code. Do not enter the line numbers:

10:  // button answer "answer" "Functions"
11:  function answer() { return 42; }
Creating a Custom Button Using a Function

Creating a Custom Button Using a Function

Click Save, then click Close

Test your new button by clicking the Category Selector and selecting "Functions". Click the "answer" custom button. Since this function has no arguments, no values need to be entered on the stack.

Right Clicking Custom Buttons

When you right click a custom button, you'll go to that button's code in the edit window. If the button is disabled, you'll have to click the "Edit" button.

Cancel Long-Running Custom Button Code

If the code for a custom button takes too long to run, click Cancel.

Stack Context Menus

When you right-click the stack, you'll be able to display the stack in a larger window, or copy a selected item or the entire stack.

Stack Context Menus

Stack Menu

Click Display Stack Contents and you'll see the logging messages created when the Custom.Fibonacci method was run. By default, only the most recent 100 log messages are retained. This threshold can be increased by editing the Javascript code, but increasing the number of lines will tend to slow down the app since it permanently stores the logging statements.

Graphing

You can graph any function's values with EBTCalc.

For example, click the Edit button and add the following code:

function fibonacci(n) {
  if (n === 0) {
    return 0;
  } else if (n === 1) {
    return 1;
  } else {
    return fibonacci(n - 2) + fibonacci(n - 1);
  }
}

// button graph "Graph" "Graph"
function graph() {
  return ___Graph.render(
    fibonacci,
    0,
    30,
    1,
    "f(x)",
    "Fibonacci Numbers",
    "X",
    "Y",
    "linear",
    "linear"
  );
}

Click the "Save" and "Close" buttons. Then select the "Graph" category and the graph will be drawn:

Graphing

Graph


___Graph.render arguments:

ArgumentDescriptionDefault Value
functionfunction to graph. This function must return a numerical result and must have a single parameter.n/a
minXMinimum x-axis value.n/a
maxXMaximum x-axis value.n/a
intervalDistance between two consecutive points, on the x-axis.n/a
dataSetNameTitle of dataset being graphed'f(x)'
titleGraph Heading'Graph'
xAxisLabelx-Axis Title'X'
yAxisLabely-Axis Title'Y'
xAxisTypex-Axis Type. Acceptable values: 'linear', 'logarithmic'.'linear'
yAxisTypey-Axis Type. Acceptable values: 'linear', 'logarithmic'.'linear'

EBTCalc uses Chart.js. You can generate a graph using the simplified ___Graph.render function (above), or you can use the full power of Chart.js (see function fullControlGraph(), below). See Chart.js for details.


// button fullControlGraph "Graph (Full Control)" "Graph"
function fullControlGraph() {
  const graphData = {
    type: "bar",
    data: {
      labels: ["Red", "Blue", "Yellow", "Green", "Purple", "Orange"],
      datasets: [
        {
          label: "# of Votes",
          data: [12, 19, 3, 5, 2, 3],
          backgroundColor: [
            "rgba(255, 99, 132, 0.2)",
            "rgba(54, 162, 235, 0.2)",
            "rgba(255, 206, 86, 0.2)",
            "rgba(75, 192, 192, 0.2)",
            "rgba(153, 102, 255, 0.2)",
            "rgba(255, 159, 64, 0.2)"
          ],
          borderColor: [
            "rgba(255, 99, 132, 1)",
            "rgba(54, 162, 235, 1)",
            "rgba(255, 206, 86, 1)",
            "rgba(75, 192, 192, 1)",
            "rgba(153, 102, 255, 1)",
            "rgba(255, 159, 64, 1)"
          ],
          borderWidth: 1
        }
      ]
    },
    options: {
      scales: {
        yAxes: [
          {
            ticks: {
              beginAtZero: true
            }
          }
        ]
      }
    }
  };

  return new ___Graph(graphData.type, graphData.data, graphData.options);
}

Graphing with full control of Chart.js features

Graphing with Access to all Chart.js Features



Defensive Programming

Factorials can only be competed for values ≥ 0. If you enter a negative value, EBTCalc displays an error message. Try it for yourself: Enter a -2 (click 2, then click "+/-"). Then click "x!" and you'll see a red error message on the bottom right:

Error Message

Error Message

You can use the same technique in your custom code. Just add a throw statement if any function or method argument is invalid (line 5):

1:  _factorial(n) {
2:      n = new BigNumber(n).toNumber();
3:
4:      if (!Number.isInteger(n) || n < 0) {
5:          throw 'Error: Argument to factorial must be an integer ≥ 0.';
6:      }
7:
8:      return (n === 0 || n === 1) ? 1 : n * this._factorial(n - 1);
9:  }

Storing and Retrieving Variables

Variables can be stored indefinitely and retrieved. Select the Memory category with the Category Selector. To store the top stack value, click the Store button. Click Retrieve to retrieve a previously stored value. Click Delete to delete a specific variable. Click Clear to delete all variables.

Settings

Click the "Settings" button to specify the decimal point, thousands separator, and tab width

Settings

Settings

Downloading

Download EBTCalc (Desktop).

Thanks!

Thank you for your interest in EBTCalc. I hope you find EBTCalc to be a useful and enjoyable tool. I welcome any and all feedback. Click the Help / Email Feedback menu item to send me feedback.

Eric, Rudy & Greta

Eric Bergman-Terrell, Greta, & Rudy


Download EBTCalc (Desktop)