Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/koaning/wigglystuff
A collection of creative AnyWidgets for Python notebook environments
https://github.com/koaning/wigglystuff
Last synced: 11 days ago
JSON representation
A collection of creative AnyWidgets for Python notebook environments
- Host: GitHub
- URL: https://github.com/koaning/wigglystuff
- Owner: koaning
- License: mit
- Created: 2024-05-19T19:19:03.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2024-12-17T16:56:20.000Z (26 days ago)
- Last Synced: 2024-12-25T06:08:09.668Z (18 days ago)
- Language: JavaScript
- Homepage: https://koaning.github.io/wigglystuff/
- Size: 7.54 MB
- Stars: 21
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-marimo - wigglystuff - Creative widgets for explorable explanations. (Libraries / Deployment Templates)
README
# wigglystuff
> "A collection of creative AnyWidgets for Python notebook environments."
The project uses [anywidget](https://anywidget.dev/) under the hood so our tools should work in [Jupyter](https://jupyter.org/), [Shiny for Python](https://shiny.posit.co/py/docs/jupyter-widgets.html), [VSCode](https://code.visualstudio.com/docs/datascience/jupyter-notebooks), [Colab](https://colab.google/), [Solara](https://solara.dev/) *and* [Marimo](https://marimo.io/). Because of the anywidget integration you should also be able interact with [ipywidgets](https://ipywidgets.readthedocs.io/en/stable/) natively.
## Online demos
We've made some demos of the widgets and shared them on the Marimo gallery for easy exploration.
Tangle Widgets for exploration
## Installation
Installation occurs via `pip` or `uv`.
```
python -m pip install wigglystuff
uv pip install wigglystuff
```
## Usage
### `Slider2D`
```python
from wigglystuff import Slider2D
widget = Slider2D()
widget
```
This widget allows you to grab the `widget.x` and `widget.y` properties to get the current position of the slider. But you can also use the `widget.observe` method to listen to changes in the widget.
Example of widget.observe
```python
import ipywidgets
from wigglystuff import Slider2D
widget = Slider2D()
output = ipywidgets.Output()
state = [[0.0, 0.0]]
@output.capture(clear_output=True)
def on_change(change):
if abs(widget.x - state[-1][0]) > 0.01:
if abs(widget.y - state[-1][1]) > 0.01:
state.append([widget.x, widget.y])
for elem in state[-5:]:
print(elem)
widget.observe(on_change)
on_change(None)
ipywidgets.HBox([widget, output])
```
### `Matrix`
If you want to get an intuition of linear algebra, the `Matrix` object might really help. It can generate a matrix for you that allows you to update all the values in it.
```python
from wigglystuff import Matrix
arr = Matrix(rows=1, cols=2, step=0.1)
mat = Matrix(matrix=np.eye(2), mirror=True, step=0.1)
```
### `TangleSlider`
Sliders are neat, but maybe you'd prefer to have something more inline. For that use-case the `TangleSlider` can be just what you need.
```python
from wigglystuff import TangleSlider
```
### `TangleChoice`
This is similar to the `TangleSlider` but for discrete choices.
```python
from wigglystuff import TangleChoice
```
