ParaView-Web RemoteRenderer in Jupyter
Project description
pvlink
ParaView-Web RemoteRenderer in Jupyter
Installation
You can install pvlink using pip
.
$ pip install pvlink
If you are using Jupyter Notebook 5.2 or earlier, you may also need to enable the nbextension:
$ jupyter nbextension enable --py [--sys-prefix|--user|--system] pvlink
To enable pvlink with Jupyter lab, make sure the Jupyter widgets extension is installed, and install the pvlink extension:
$ jupyter labextension install @jupyter-widgets/jupyterlab-manager # install the Jupyter widgets extension
$ jupyter labextension install pvlink
Usage
For examples see the example notebook.
The RemoteRenderer additionally requires the paraview.simple
and paraview.web modules
.
Jupyter Proxy Setup (using nginx)
To enable streaming these settings need to be set, in the nginx config file for Jupyter (for example: in /etc/nginx/conf.d/):
# top-level http config for websocket headers
# If Upgrade is defined, Connection = upgrade
# If Upgrade is empty, Connection = close
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
... location ... {
...
# websocket headers
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
...
}
An unused stream is automatically disconnected by nginx, after proxy_read_timeout
's seconds are exceeded. The default value of 60s is reached quite fast, therefore it is recommended to increase this value.
For example:
# HTTPS server to handle JupyterHub
server {
listen 443 ssl;
...
proxy_read_timeout 3600s;
...
Changelog
See Changelog
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pvlink-0.3.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ff11c5b0ee05b6e77c3385417c3fc1309b7c9bc71405a1f5a7636e0d9829c2b1 |
|
MD5 | f59a1a15d597cfd4f0377e185b3d20bd |
|
BLAKE2b-256 | c35b66227483b8d69699b04852f4146f6eebcc535e463e849e27db1f74e457ff |