blob: 8b5b13a807a150e590cd03d09be17dea807474fb [file] [log] [blame]
---------------------------------------------------------------------------------------
SETUP INFO
---------------------------------------------------------------------------------------
Jupyter EASE scripting engine is a specialization of the Py4J EASE engine.
The Eclipse Preference named "Scripting/Python Scripting (using Py4J)/Python location"
should point to a python.exe in Python distribution where Jupyter Notebook is installed.
Important remark : Anaconda (https://www.anaconda.com/) is providing such a distribution.
However, the advanced option "Add anaconda to my PATH environnment" option should
be checked during its install process. (Otherwise, you may have dll/so loading issues during
engine startup).
Notice that the engine is also taking the General/Web Browser option to determine
if the notebook should be run into an Eclipse integrated web browser (internal)
or an external browser such as Firefox or Google Chrome.
--------------------------------------------------------------------------------------
STARTUP INFO
--------------------------------------------------------------------------------------
Jupyter ipynb files are considered as script files by our notebook. Existing notebooks
can be started from a Right click on ipynb file -> Run As -> EASE Script... popup menu.
We don't provide a new Notebook wizard yet. New notebooks can be created either by copy/pasting
existing ones such as this example, or by starting the Jupyter EASE scripting engine from
the EASE Script Shell View/"Switch scripting Engine" button.
This will launch a new Jupyter Notebook session from which you will have to create a new
EASE Py4J Kernel notebook. Be fast! The EASE engine is waiting for an acknowledgement from
the Py4J Jupyer kernel, you only have 1 minute to create your notebook before considering
a failure occured.
----------------------------------------------------------------------------------------
SHUTDOWN INFO
----------------------------------------------------------------------------------------
Jupyter Notebook is launched as a third party executable which still runs after the web
browser is closed => closing the tab in the browser doesn't stop the engine.
The engine can be explicitly killed with the "Terminate" red button from the Eclipse
console view.
Notice that when Eclipse terminates normally, all the Jupyter server instances started by EASE
Jupyter engine are automatically terminated.