giswqs / leafmaptools

A Python package for building a tool widgets infrastructure with ipyleaflet and ipywidgets

leafmaptools

A Python package for building a tool widgets infrastructure with ipyleaflet and ipywidgets.

• Free software: MIT license
• Documentation: https://leafmaptools.gishub.org

Contents

• Introduction
• Features
• Installation
• Examples
• Credits

Introduction

This is a Python package exploring ideas for building a tool widgets infrastructure with ipyleaflet and ipywidgets. The outcome should be a collection of useful and reusable tools that provide workarounds for missing features and can be used on and off the map without the need for writing Javascript code.

Features

The Wiki contains some early [feature ideas](https://github.com/giswqs/leafmaptools/wiki/Feature-ideas) which can be used/imported from the code now. The following image is a sneak preview, more is about to come:

Installation

leafmaptools is available on PyPI. To install leafmaptools, run this command in your terminal:

pip install leafmaptools

leafmaptools is also available on conda-forge. If you have Anaconda or Miniconda installed on your computer, you can create a conda Python environment to install leafmaptools:

conda create -n lmt python
conda activate lmt
conda install mamba -c conda-forge
mamba install leafmaptools -c conda-forge 

Optionally, you can install Jupyter notebook extensions, which can improve your productivity in the notebook environment. Some useful extensions include Table of Contents, Gist-it, Autopep8, Variable Inspector, etc. See this post for more information.

mamba install jupyter_contrib_nbextensions -c conda-forge 

If you have installed leafmaptools before and want to upgrade to the latest version, you can run the following command in your terminal:

pip install -U leafmaptools

If you use conda, you can update leafmaptools to the latest version by running the following command in your terminal:

mamba update -c conda-forge leafmaptools

To install the development version from GitHub using Git, run the following command in your terminal:

pip install git+https://github.com/giswqs/leafmaptools

Examples

Example notebooks can be found in the docs/notebooks/examples folder. The easiest way to run these online without installing anything is to click the "launch binder" button above which will launch a pre-built Docker image and present all example notebooks which can be conveniently run online.

Credits

This package was created with Cookiecutter and the giswqs/pypackage project template.