calysto_processing

A ProcessingJS kernel for Jupyter


License
BSD-3-Clause
Install
pip install calysto_processing==2.0.2

Documentation

Calysto Processing is the merging of ProcessingJS with Project Jupyter (aka IPython). Processing Sketches are entered into Jupyter notebook cells, and even run in rendered notebooks. Sketches can be paused, and stepped one draw() at a time.

Because Calysto Processing uses MetaKernel, it has a fully-supported set of "magics"---meta-commands for additional functionality. A list of magics can be seen at MetaKernel Magics.

Calysto Processing in use:

You can install Calysto Processing with:

pip install --upgrade calysto-processing

or in the system kernels with:

sudo pip install --upgrade calysto-processing

Next, install Processing 2 from https://processing.org/download/

You will need to make sure that you have installed and access to the processing_java command. Mac users will need to install it from Processing by selecting 'Install "processing_java"' under the Tools menu.

Finally, edit the installed calysto_processing/kernel.js to include the full path to the processing_java command. That might look like:

{
 "argv": 
    ["/usr/bin/python3", 
     "-m", "calysto_processing", 
     "-f", "{connection_file}"], 
 "display_name": "Calysto Processing", 
 "env": {"PROCESSING_JAVA": "/home/dblank/Desktop/processing-2.2.1/processing-java"}, 
 "language": "java", 
 "name": "calysto_processing"
}

Use it in the notebook with:

ipython notebook

and then select Calysto Processing for a new notebook.

Calysto Processing also has an enhancement: Tables, and some related functions:

/* @pjs includeTable="true"; */

Table table;

void setup() {
    table = loadTable("test.csv", "header");
    println(table.getRowCount() + " total rows in table"); 
}

long findMax() {
    int retval = 0;
    for (TableRow row : table.rows()) {
        int pop = row.getInt("Population");
        if (pop > retval)
            retval = pop;
    }
    return retval;
}

Table-related classes and methods:

  • loadTable(CSV_FILNAME, "header");
  • Table class
  • TableRow class
  • table.rows() - returns iterator for use with for(TableRow row : table.rows()) {...}
  • row.getInt(COLUMN_NAME)
  • row.getString(COLUMN_NAME)
  • row.getFloat(COLUMN_NAME)

See source for more details.

Example notebooks can be found in https://github.com/Calysto/calysto_processing/tree/master/notebooks

Requires:

  • ipython-3.0
  • Python2 or Python3
  • metakernel (installed with pip)
  • calysto (installed with pip)

Calysto Processing supports:

  • MetaKernel Magics
  • All of ProcessingJS, plus pause/restart and stepper