keplergl-jupyter

This is a simple jupyter widget for kepler.gl, an advanced geo-spatial visualization tool, to render large-scale interactive maps.

Usage no npm install needed!

<script type="module">
  import keplerglJupyter from 'https://cdn.skypack.dev/keplergl-jupyter';
</script>

README

kperlgl-jupyter

This is a simple jupyter widget for kepler.gl, an advanced geospatial visualization tool, to render large-scale interactive maps.

Package Install


Prerequisites

More links

Local Dev


Local Dev Installation for Classic Notebook

To develop this package against the classic notebook, run:

  • pip install -e . (installs python package for development, runs npm install and npm run build)
  • jupyter nbextension install --py --symlink --sys-prefix keplergl
    (symlinks static/ directory into <jupyter path>/nbextensions/keplergl/). Now the notebook has access to the frontend code.
  • jupyter nbextension enable --py --sys-prefix keplergl
    (copies <npm_package_name>.json into <environment path>/etc/jupyter/nbconfig/notebook.d/ directory). Now the notebook will load your frontend code on page load.

Now make some changes to your source code. Then:

  • After making Python code changes, restarting the notebook kernel will be enough to reflect changes
  • After making JavaScript code changes:
    • cd js
    • npm run build
    • Refresh browser to reflect changes

Local Dev Installation for JupyterLab

To develop this package against JupyterLab, run:

  • pip install -e . (installs python package for development, runs npm install and npm run build)
  • jupyter labextension install @jupyter-widgets/jupyterlab-manager: this install lab widgets manager.
  • jupyter labextension install js: this installs the current labextension into JupyterLab and enables it.
  • jupyter lab --watch starts JupyterLab, but in --watch mode: it will rebuild itself incrementally if it detects changes.

Now make some changes to your source code. Then:

  • After making Python code changes, restarting the notebook kernel will be enough to reflect changes

  • After making JavaScript code changes:

    • cd js
    • npm run build:lab
    • Refresh browser to reflect changes
  • By default, the application will load from the JupyterLab staging directory (default is /share/jupyter/lab/staging. Check the correct version of @jupyter-widgets/jupyterlab-manager and @jupyter-widgets/base is install in yarn.lock

JupyterLab widget Dependencies

Install correct version of jupyterlab-manager based on your Jupyter Lab version. Make sure @jupyter-widgets/base version in the widget does not conflict with requirements in jupyterlab-manager.