Metadata-Version: 2.4
Name: trame-deckgl
Version: 2.0.4
Summary: Deck.gl widget for trame
Author: Kitware Inc.
License: MIT
License-File: LICENSE
Keywords: Application,Framework,Interactive,Python,Web
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: JavaScript
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Requires-Dist: trame-client
Provides-Extra: dev
Requires-Dist: pre-commit; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: pytest-asyncio; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Requires-Dist: trame-client[test]; extra == 'dev'
Description-Content-Type: text/x-rst

.. |pypi_download| image:: https://img.shields.io/pypi/dm/trame-deckgl

High-scale spatial rendering for trame |pypi_download|
===========================================================================

.. image:: https://github.com/Kitware/trame-deckgl/actions/workflows/test_and_release.yml/badge.svg
    :target: https://github.com/Kitware/trame-deckgl/actions/workflows/test_and_release.yml
    :alt: Test and Release

trame-deckgl extend trame **widgets** with components that can interface with PyDeck while being powered by Deck.gl.
Deck integration in trame allow you to create rich visualization by leveraging `PyDeck <https://pydeck.gl/index.html>`_ (`Apache License <https://github.com/visgl/deck.gl/blob/master/bindings/pydeck/LICENSE.txt>`_).


Installing
-----------------------------------------------------------

trame-deckgl can be installed with `pip <https://pypi.org/project/trame-deckgl/>`_:

.. code-block:: bash

    pip install --upgrade trame-deckgl


Usage
-----------------------------------------------------------

The `Trame Tutorial <https://kitware.github.io/trame/docs/tutorial.html>`_ is the place to go to learn how to use the library and start building your own application.

The `API Reference <https://trame.readthedocs.io/en/latest/index.html>`_ documentation provides API-level documentation.


License
-----------------------------------------------------------

trame-deckgl is made available under the MIT License. For more details, see `LICENSE <https://github.com/Kitware/trame-deckgl/blob/master/LICENSE>`_
This license has been chosen to match the one use by `Deck.gl <https://github.com/visgl/deck.gl/blob/master/LICENSE>`_ which is use within trame-deckgl.


Community
-----------------------------------------------------------

`Trame <https://kitware.github.io/trame/>`_ | `Discussions <https://github.com/Kitware/trame/discussions>`_ | `Issues <https://github.com/Kitware/trame/issues>`_ | `RoadMap <https://github.com/Kitware/trame/projects/1>`_ | `Contact Us <https://www.kitware.com/contact-us/>`_

.. image:: https://zenodo.org/badge/410108340.svg
    :target: https://zenodo.org/badge/latestdoi/410108340


Enjoying trame?
-----------------------------------------------------------

Share your experience `with a testimonial <https://github.com/Kitware/trame/issues/18>`_ or `with a brand approval <https://github.com/Kitware/trame/issues/19>`_.


Example: PyDeck
-----------------------------------------------------------

The Deck component relies on the server for generating the map definition.

.. code-block:: python

    import pydeck as pdk
    from trame.widgets import deckgl

    deck = pdk.Deck(
      map_provider="mapbox",
      map_style="mapbox://styles/mapbox/light-v9",
      initial_view_state={
          "latitude": 37.76,
          "longitude": -122.4,
          "zoom": 11,
          "pitch": 50,
      },
      layers=selected_layers,
    )

    widget = deckgl.Deck(mapboxApiKey=..., deck=deck)
    widget.update(deck2)


JavaScript dependency
-----------------------------------------------------------

This Python package bundle the ``@deck.gl/jupyter-widget@8.4.7`` JavaScript library. If you would like us to upgrade it, `please reach out <https://www.kitware.com/trame/>`_.
