|
1 | | -ipyleaflet meta package |
| 1 | +# ipyleaflet |
| 2 | + |
| 3 | +[](https://ipyleaflet.readthedocs.io/en/latest/?badge=latest) |
| 4 | +[](https://mybinder.org/v2/gh/jupyter-widgets/ipyleaflet/stable?urlpath=lab%2Ftree%2Fexamples) |
| 5 | +[](https://gitter.im/jupyter-widgets/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) |
| 6 | +[](https://pepy.tech/project/ipyleaflet/month) |
| 7 | + |
| 8 | +A Jupyter / Leaflet bridge enabling interactive maps in the Jupyter notebook. |
| 9 | + |
| 10 | +## Usage |
| 11 | + |
| 12 | +### Selecting a basemap for a leaflet map: |
| 13 | + |
| 14 | + |
| 15 | + |
| 16 | +### Loading a geojson map: |
| 17 | + |
| 18 | + |
| 19 | + |
| 20 | +### Making use of leafletjs primitives: |
| 21 | + |
| 22 | + |
| 23 | + |
| 24 | +### Using the splitmap control: |
| 25 | + |
| 26 | + |
| 27 | + |
| 28 | +### Displaying velocity data on the top of a map: |
| 29 | + |
| 30 | + |
| 31 | + |
| 32 | +### Choropleth layer: |
| 33 | + |
| 34 | + |
| 35 | + |
| 36 | +### Widget control |
| 37 | + |
| 38 | + |
| 39 | + |
| 40 | +## Installation |
| 41 | + |
| 42 | +Using conda: |
| 43 | + |
| 44 | +``` |
| 45 | +conda install -c conda-forge ipyleaflet |
| 46 | +``` |
| 47 | + |
| 48 | +Using pip: |
| 49 | + |
| 50 | +``` |
| 51 | +pip install ipyleaflet |
| 52 | +``` |
| 53 | + |
| 54 | +## Installation from sources |
| 55 | + |
| 56 | +For a development installation (requires yarn, you can install it with `conda install -c conda-forge yarn`): |
| 57 | + |
| 58 | +``` |
| 59 | +git clone https://github.com/jupyter-widgets/ipyleaflet.git |
| 60 | +cd ipyleaflet |
| 61 | +(cd python/jupyter_leaflet; pip install -e .) |
| 62 | +(cd python/ipyleaflet; pip install -e .) |
| 63 | +``` |
| 64 | + |
| 65 | +For developing with JupyterLab: |
| 66 | + |
| 67 | +``` |
| 68 | +jupyter labextension develop --overwrite jupyter_leaflet |
| 69 | +``` |
| 70 | + |
| 71 | +## Documentation |
| 72 | + |
| 73 | +To get started with using `ipyleaflet`, check out the full documentation |
| 74 | + |
| 75 | +https://ipyleaflet.readthedocs.io/ |
| 76 | + |
| 77 | +## License |
| 78 | + |
| 79 | +We use a shared copyright model that enables all contributors to maintain the |
| 80 | +copyright on their contributions. |
| 81 | + |
| 82 | +This software is licensed under the MIT license. See the [LICENSE](LICENSE) file for details. |
| 83 | + |
| 84 | +## Related projects |
| 85 | + |
| 86 | +The `ipyleaflet` repository includes the `jupyter-leaflet` npm package, which |
| 87 | +is a front-end component, and the `ipyleaflet` python package which is the |
| 88 | +backend for the Python Jupyter kernel. |
| 89 | + |
| 90 | +Similarly, the [`xleaflet`](https://github.com/jupyter-xeus/xleaflet/) project |
| 91 | +provides a backend to `jupyter-leaflet` for the "xeus-cling" C++ Jupyter |
| 92 | +kernel. |
| 93 | + |
| 94 | + |
0 commit comments