Metadata-Version: 2.1
Name: pydeck
Version: 0.1.dev3
Summary: Widget for deck.gl maps
Home-page: https://github.com/uber/deck.gl/tree/master/bindings/python/pydeck
Author: Andrew Duberstein
Author-email: ajduberstein@gmail.com
License: MIT License
Description: [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/uber/deck.gl/binder?filepath=examples)
        
        # pydeck: Beautiful maps with Python
        
        ![demo](https://user-images.githubusercontent.com/2204757/58838976-1538f400-8615-11e9-84f6-a2fe42bb300b.gif)
        
        The pydeck library is a set of Python bindings for making spatial visualizations with [deck.gl](https://deck.gl),
        optimized for a Jupyter Notebook environment.
        
        For __interactive demos__, click the binder logo below:
        
        [![Binder](https://mybinder.org/static/logo.svg?v=f9f0d927b67cc9dc99d788c822ca21c0)](https://mybinder.org/v2/gh/uber/deck.gl/binder?filepath=examples)
        
        
        [See further documentation here.](https://github.com/uber/deck.gl/tree/master/bindings/python/pydeck/docs)
        
        ## Installation
        
        ```bash
        pip install pydeck
        ```
        
        If you are installing this for a Jupyter notebook server, you'll have to enable the widget extension.
        To do this, run:
        
        ```bash
        jupyter nbextension install --sys-prefix --symlink --overwrite --py pydeck
        jupyter nbextension enable --sys-prefix --py pydeck
        ```
        
        ## Getting started
        
        The following code renders a visualization similar to the one above in a Jupyter notebook:
        
        ```python
        import pydeck as pdk
        
        # 2014 location of car accidents in the UK
        UK_ACCIDENTS_DATA = 'https://raw.githubusercontent.com/uber-common/deck.gl-data/master/examples/3d-heatmap/heatmap-data.csv'
        
        # Define a layer to display on a map
        layer = pdk.Layer(
            'HexagonLayer',
            UK_ACCIDENTS_DATA,
            get_position='[lng,lat]',
            auto_highlight=True,
            elevation_scale=50,
            pickable=True,
            elevation_range=[0, 3000],
            extruded=True,                 
            coverage=1)
        
        # Set the viewport location
        view_state = pdk.ViewState(
            longitude=-1.415,
            latitude=52.2323,
            zoom=6,
            min_zoom=5,
            max_zoom=15,
            pitch=40.5,
            bearing=-27.36)
        
        # Render
        r = pdk.Deck(layers=[layer], initial_view_state=view_state)
        r.show()
        ```
        
        If you're outside of a Jupyter notebook, you can alternately run:
        ```python
        r.to_html()
        ```
        
        For more, check out the docs and Binder examples above.
        
        ### Debugging note
        
        Because pydeck uses Python renders Javascript, some errors will appear only in the Javascript console.
        If you encounter an error, open the Javascript console in your browser. This will be updated in future versions of pydeck.
        If you encounter an issue, file it under the [deck.gl issues page](https://github.com/uber/deck.gl/issues/new?assignees=&labels=question&template=question.md&title=)
        and include console output.
        
        
        ### Installation from source
        
        ```bash
        # Clone the deck.gl repo
        git clone https://github.com/uber/deck.gl/
        
        # Navigate to the pydeck module
        cd deck.gl/bindings/python/pydeck
        
        # Create a virtual environment
        python3 -m venv env3
        . env3/bin/activate
        
        python3 setup.py install
        ```
        
        ## Development
        
        ```
        git clone https://github.com/uber/deck.gl/
        cd deck.gl
        # Build the entire deck.gl project
        yarn bootstrap
        
        # Optional but recommended: Run a hot reloading development server
        cd modules/jupyter-widget
        export PYDECK_DEV_SERVER=http://localhost:8080 && yarn watch
        ```
        
        To specifiy a non-default URL for the webpack dev server, you can set a URL in the `PYDECK_DEV_SERVER` environment variable,
        e.g., `export PYDECK_DEV_SERVER=http://localhost:8081`.
        
        Elsewhere, run:
        
        ```bash
        export PYDECK_DEV_SERVER=http://localhost:8080
        cd deck.gl/bindings/python/pydeck
        
        # Create a virtual environment
        python3 -m venv env3
        . env3/bin/activate
        
        pip install -r requirements.txt
        pip install -r requirements-dev.txt
        pip install -e .
        ```
        
        ### Tests
        
        Tests are handled by pytest. In this folder, you can type:
        
        ```bash
        pytest
        ```
        
        Tests expect the development build of pydeck, specified above.
        Click on the URLs in the test output to see visualizations generated by the tests.
        
Keywords: data,visualization,graphics,GIS,maps
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Multimedia :: Graphics
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Framework :: Jupyter
Description-Content-Type: text/markdown
Provides-Extra: testing
