Add DataFilterExtension example (#358)

### Changelog

- Add `DataFilterExtension` example
- Move layer extensions out of `experimental`

docs/api/layer-extensions/brushing-extension.md

@@ -4,7 +4,7 @@
 
 > Screen recording from [U.S. County-to-County Migration example](../../../examples/migration/).
 
-::: lonboard.experimental.BrushingExtension
+::: lonboard.layer_extension.BrushingExtension
     options:
       show_bases: false
       inherited_members: true

docs/api/layer-extensions/collision-filter-extension.md

@@ -1,6 +1,6 @@
 # CollisionFilterExtension
 
-::: lonboard.experimental.CollisionFilterExtension
+::: lonboard.layer_extension.CollisionFilterExtension
     options:
       show_bases: false
       inherited_members: true

docs/api/layer-extensions/data-filter-extension.md

@@ -1,6 +1,8 @@
 # DataFilterExtension
 
-::: lonboard.experimental.DataFilterExtension
+![](../../assets/data-filter-extension.gif)
+
+::: lonboard.layer_extension.DataFilterExtension
     options:
       show_bases: false
       inherited_members: true

docs/api/traits.md

@@ -5,3 +5,7 @@
 ::: lonboard.traits.ColorAccessor
 
 ::: lonboard.traits.FloatAccessor
+
+::: lonboard.traits.PointAccessor
+
+::: lonboard.traits.GetFilterValueAccessor

examples/migration.ipynb

@@ -38,7 +38,8 @@
     "from matplotlib.colors import Normalize\n",
     "\n",
     "from lonboard import Map, ScatterplotLayer\n",
-    "from lonboard.experimental import ArcLayer, BrushingExtension"
+    "from lonboard.experimental import ArcLayer\n",
+    "from lonboard.layer_extension import BrushingExtension"
    ]
   },
   {
@@ -207,7 +208,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 6,
+   "execution_count": 5,
    "id": "13b8b182",
    "metadata": {},
    "outputs": [],
@@ -226,7 +227,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 7,
+   "execution_count": 6,
    "id": "8e0c2fd9",
    "metadata": {},
    "outputs": [],
@@ -253,7 +254,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 8,
+   "execution_count": 7,
    "id": "86799a4c",
    "metadata": {},
    "outputs": [],
@@ -270,7 +271,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 9,
+   "execution_count": 8,
    "id": "570868b8",
    "metadata": {},
    "outputs": [],
@@ -297,7 +298,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 10,
+   "execution_count": 9,
    "id": "56b9dcf2",
    "metadata": {},
    "outputs": [],
@@ -329,7 +330,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 11,
+   "execution_count": 10,
    "id": "6400bd35",
    "metadata": {},
    "outputs": [],
@@ -367,22 +368,22 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 12,
+   "execution_count": 11,
    "id": "5ef02c61",
    "metadata": {},
    "outputs": [
     {
      "data": {
       "application/vnd.jupyter.widget-view+json": {
-       "model_id": "528e69ea2bac4278a26f1215a74ccf75",
+       "model_id": "4cbbf3652a5e4fe590157620b932e821",
        "version_major": 2,
        "version_minor": 0
       },
       "text/plain": [
        "Map(layers=[ScatterplotLayer(brushing_radius=200000.0, extensions=[BrushingExtension()], get_fill_color=<pyarr…"
       ]
      },
-     "execution_count": 12,
+     "execution_count": 11,
      "metadata": {},
      "output_type": "execute_result"
     }

lonboard/__init__.py

@@ -1,7 +1,7 @@
 """Python library for fast, interactive geospatial vector data visualization in Jupyter.
 """
 
-from . import colormap, controls, traits
+from . import colormap, controls, layer_extension, traits
 from ._layer import (
     BaseArrowLayer,
     BaseLayer,

lonboard/_base.py

@@ -4,6 +4,13 @@
 from anywidget import AnyWidget
 from ipywidgets import Widget
 
+msg = """
+Unexpected keyword argument: '{provided_trait_name}'.
+Check the spelling of your parameters. If you're trying to use layer properties added by
+a layer extension, ensure you've passed the extension object into the `extensions`
+parameter of the layer.
+"""
+
 
 class BaseWidget(Widget):
     def __init__(self, **kwargs):
@@ -13,7 +20,7 @@ def __init__(self, **kwargs):
         layer_trait_names = self.trait_names()
         for provided_trait_name in kwargs.keys():
             if provided_trait_name not in layer_trait_names:
-                raise TypeError(f"unexpected keyword argument '{provided_trait_name}'")
+                raise TypeError(msg.format(provided_trait_name=provided_trait_name))
 
         super().__init__(**kwargs)
 
@@ -24,7 +31,7 @@ def __init__(self, **kwargs):
         layer_trait_names = self.trait_names()
         for provided_trait_name in kwargs.keys():
             if provided_trait_name not in layer_trait_names:
-                raise TypeError(f"unexpected keyword argument '{provided_trait_name}'")
+                raise TypeError(msg.format(provided_trait_name=provided_trait_name))
 
         super().__init__(**kwargs)
 

lonboard/controls.py

@@ -13,7 +13,7 @@ class MultiRangeSlider(VBox):
     """A widget for multiple ranged sliders.
 
     This is designed to be used with the
-    [DataFilterExtension][lonboard.experimental.DataFilterExtension] when you want to
+    [DataFilterExtension][lonboard.layer_extension.DataFilterExtension] when you want to
     filter on 2 to 4 columns on the same time.
 
     If you have only a single filter, use an ipywidgets

lonboard/experimental/__init__.py

@@ -5,8 +5,3 @@
 """
 
 from ._layer import ArcLayer, TextLayer
-from .layer_extension import (
-    BrushingExtension,
-    CollisionFilterExtension,
-    DataFilterExtension,
-)

lonboard/experimental/_layer.py

@@ -9,10 +9,10 @@
 
 from lonboard._constants import EXTENSION_NAME
 from lonboard._layer import BaseArrowLayer
-from lonboard.experimental.traits import PointAccessor
 from lonboard.traits import (
     ColorAccessor,
     FloatAccessor,
+    PointAccessor,
     PyarrowTableTrait,
     TextAccessor,
 )