# Quibbler: your data - interactive!
**Interactive, reproducible and efficient data analytics**
With *Quibbler*, your data analysis is automatically live and interactive.
https://user-images.githubusercontent.com/62783755/209929327-67766771-f271-40f0-8f3a-76deb88310b7.mp4
## What is it?
<img src="https://github.com/Technion-Kishony-lab/quibbler/blob/master/pyquibbler-documentations/docs/images/quibicon.gif?raw=true" width=250 align='right'>
*Quibbler* is a toolset for building highly interactive, yet reproducible,
transparent and efficient data analysis pipelines. *Quibbler* allows using standard
*Python* syntax to process data through any series of analysis steps, while
automatically maintaining connectivity between downstream results and upstream raw data
sources. *Quibbler* facilitates and embraces human interventions as an inherent part
of the analysis pipeline: input parameters, as well as exceptions and overrides,
can be specified and adjusted either programmatically, or by
interacting with live graphics, and all such interventions are automatically
recorded in well-documented human-machine readable files. Changes to such parameters
propagate downstream, pinpointing which specific data items, or
even specific elements thereof, are affected, thereby vastly saving unnecessary
recalculations. *Quibbler*, therefore, facilitates hands-on interactions with data
in ways that are not only flexible, fun and interactive, but also traceable,
reproducible, and computationally efficient.
## Main Features
* **Interactivity**
* Creating [interactive graphics](https://quibbler.readthedocs.io/en/latest/Quickstart.html) is as
simple as calling standard Matplotlib graphics functions with arguments that represent your parameter values.
* Any data presented graphically is automatically live and interactive
(no need for the tedious programming of callback functions).
* **Traceability and Reproducibility**
* Trace which specific data items and analysis parameters affect focal downstream results (see
[dependency graph](https://quibbler.readthedocs.io/en/latest/Quib-relationships.html)).
* Inherent [undo/redo](https://quibbler.readthedocs.io/en/latest/Jupyter-lab-ext.html) functionality.
* [Save/load](https://quibbler.readthedocs.io/en/latest/Project-save-load.html) parameter values as
human-readable records (either as external text files,
or [inside Jupyter notebook](https://quibbler.readthedocs.io/en/latest/Jupyter-lab-ext.html)).
* **Computational efficiency**
* Upon parameter changes, *Quibbler* pinpoints and only recalculates the specifically affected array elements
of downstream analysis steps ([here](https://quibbler.readthedocs.io/en/latest/Diverged-evaluation.html)).
* **Very little to learn: your standard-syntax code automatically comes to life.**
* To get started with Quibbler, you do not need to learn any new syntax or new functions. Just encapsulate your
input parameters with `iquib` and your analysis and graphics automatically become live and interactive.
* Quibbler supports standard coding syntax with all Python operators, slicing, getitem, Numpy functions,
Matplotlib graphics functions, Matplotlib widgets, and ipywidgets. It further provides an easy way to incorporate
any user functions or functions from any other non-graphics packages ([here](https://quibbler.readthedocs.io/en/latest/User-defined-functions.html)).
Support for other graphics packages, besides Matplotlib, will be offered in future releases.
## Minimal app
```python
from pyquibbler import initialize_quibbler, iquib
initialize_quibbler()
import matplotlib.pyplot as plt
x = iquib(0.5)
y = 1 - x
plt.plot([0, 1], [1, 0], '-')
plt.plot([0, x, x], [y, y, 0], '--', marker='D')
plt.title(x, fontsize=20)
```
## Documentation and Examples
For complete documentation and a getting-started tour, see [readthedocs](https://quibbler.readthedocs.io/en/latest/).
For simple demos and small apps, see our [Examples](https://quibbler.readthedocs.io/en/latest/Examples.html).
## Installation
We recommend installing *Quibbler* in a new virtual environment
(see [creating a new environment](https://github.com/Technion-Kishony-lab/quibbler/blob/master/INSTALL.md)).
To install run:
`pip install pyquibbler`
If you are using Quibbler within *Jupyter lab*, you can also add the
[pyquibbler Jupyter Lab extension](https://quibbler.readthedocs.io/en/latest/Jupyter-lab-ext.html):
`pip install pyquibbler_labextension`
## Development
To install for developers,
see our guide [here](https://github.com/Technion-Kishony-lab/quibbler/blob/master/INSTALL.md).
## Credit
Quibbler was created by Roy Kishony, initially implemented as a Matlab toolbox.
The first release of Quibbler for Python, *pyquibbler*, was developed at the
[Kishony lab](https://kishony.technion.ac.il/quibbler/),
[Technion - Israel Institute of Technology](https://www.technion.ac.il/),
by Maor Kern, Maor Kleinberger and Roy Kishony.
We very much welcome any thoughts, suggestions and ideas and of course welcome PR contributions
(for some proposed directions, see our pending [issues](https://github.com/Technion-Kishony-lab/quibbler/issues)).
## Related packages
* [Matplotlib](https://github.com/matplotlib/matplotlib)
* [Streamlit](https://streamlit.io/)
* [Plotly](https://plotly.com/)
* [Shiny](https://shiny.rstudio.com/)
* [ipywidgets](https://github.com/jupyter-widgets/ipywidgets)
* [bokeh](http://bokeh.org)
* [HoloViz](https://holoviz.org/)
* [Vega-Altair](https://altair-viz.github.io/)
* [Datashader](https://datashader.org/)
Raw data
{
"_id": null,
"home_page": "https://github.com/Technion-Kishony-lab/quibbler",
"name": "pyquibbler",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Kishony lab, Technion Israel Institute of Technology",
"author_email": "rkishony@technion.ac.il",
"download_url": null,
"platform": null,
"description": "# Quibbler: your data - interactive! \n**Interactive, reproducible and efficient data analytics**\n\n\n\n\n\nWith *Quibbler*, your data analysis is automatically live and interactive.\n\nhttps://user-images.githubusercontent.com/62783755/209929327-67766771-f271-40f0-8f3a-76deb88310b7.mp4\n\n## What is it?\n<img src=\"https://github.com/Technion-Kishony-lab/quibbler/blob/master/pyquibbler-documentations/docs/images/quibicon.gif?raw=true\" width=250 align='right'>\n\n*Quibbler* is a toolset for building highly interactive, yet reproducible, \ntransparent and efficient data analysis pipelines. *Quibbler* allows using standard \n*Python* syntax to process data through any series of analysis steps, while \nautomatically maintaining connectivity between downstream results and upstream raw data \nsources. *Quibbler* facilitates and embraces human interventions as an inherent part \nof the analysis pipeline: input parameters, as well as exceptions and overrides, \ncan be specified and adjusted either programmatically, or by \ninteracting with live graphics, and all such interventions are automatically \nrecorded in well-documented human-machine readable files. Changes to such parameters \npropagate downstream, pinpointing which specific data items, or\neven specific elements thereof, are affected, thereby vastly saving unnecessary \nrecalculations. *Quibbler*, therefore, facilitates hands-on interactions with data \nin ways that are not only flexible, fun and interactive, but also traceable, \nreproducible, and computationally efficient.\n\n\n## Main Features\n\n* **Interactivity** \n\n * Creating [interactive graphics](https://quibbler.readthedocs.io/en/latest/Quickstart.html) is as \nsimple as calling standard Matplotlib graphics functions with arguments that represent your parameter values.\n\n * Any data presented graphically is automatically live and interactive \n(no need for the tedious programming of callback functions).\n\n* **Traceability and Reproducibility**\n * Trace which specific data items and analysis parameters affect focal downstream results (see \n[dependency graph](https://quibbler.readthedocs.io/en/latest/Quib-relationships.html)). \n\n * Inherent [undo/redo](https://quibbler.readthedocs.io/en/latest/Jupyter-lab-ext.html) functionality.\n\n * [Save/load](https://quibbler.readthedocs.io/en/latest/Project-save-load.html) parameter values as \nhuman-readable records (either as external text files, \nor [inside Jupyter notebook](https://quibbler.readthedocs.io/en/latest/Jupyter-lab-ext.html)).\n\n* **Computational efficiency**\n * Upon parameter changes, *Quibbler* pinpoints and only recalculates the specifically affected array elements \nof downstream analysis steps ([here](https://quibbler.readthedocs.io/en/latest/Diverged-evaluation.html)).\n\n* **Very little to learn: your standard-syntax code automatically comes to life.**\n * To get started with Quibbler, you do not need to learn any new syntax or new functions. Just encapsulate your\ninput parameters with `iquib` and your analysis and graphics automatically become live and interactive. \n * Quibbler supports standard coding syntax with all Python operators, slicing, getitem, Numpy functions, \nMatplotlib graphics functions, Matplotlib widgets, and ipywidgets. It further provides an easy way to incorporate \nany user functions or functions from any other non-graphics packages ([here](https://quibbler.readthedocs.io/en/latest/User-defined-functions.html)). \nSupport for other graphics packages, besides Matplotlib, will be offered in future releases. \n\n## Minimal app\n```python\nfrom pyquibbler import initialize_quibbler, iquib\ninitialize_quibbler()\nimport matplotlib.pyplot as plt\n\nx = iquib(0.5)\ny = 1 - x\nplt.plot([0, 1], [1, 0], '-')\nplt.plot([0, x, x], [y, y, 0], '--', marker='D')\nplt.title(x, fontsize=20)\n```\n\n\n\n\n## Documentation and Examples\nFor complete documentation and a getting-started tour, see [readthedocs](https://quibbler.readthedocs.io/en/latest/). \n\nFor simple demos and small apps, see our [Examples](https://quibbler.readthedocs.io/en/latest/Examples.html). \n\n## Installation \n\nWe recommend installing *Quibbler* in a new virtual environment \n(see [creating a new environment](https://github.com/Technion-Kishony-lab/quibbler/blob/master/INSTALL.md)). \n\nTo install run:\n\n`pip install pyquibbler`\n\nIf you are using Quibbler within *Jupyter lab*, you can also add the \n[pyquibbler Jupyter Lab extension](https://quibbler.readthedocs.io/en/latest/Jupyter-lab-ext.html):\n\n`pip install pyquibbler_labextension`\n\n## Development \nTo install for developers, \nsee our guide [here](https://github.com/Technion-Kishony-lab/quibbler/blob/master/INSTALL.md).\n\n## Credit\n\nQuibbler was created by Roy Kishony, initially implemented as a Matlab toolbox. \n\nThe first release of Quibbler for Python, *pyquibbler*, was developed at the \n[Kishony lab](https://kishony.technion.ac.il/quibbler/), \n[Technion - Israel Institute of Technology](https://www.technion.ac.il/), \nby Maor Kern, Maor Kleinberger and Roy Kishony.\n\nWe very much welcome any thoughts, suggestions and ideas and of course welcome PR contributions \n(for some proposed directions, see our pending [issues](https://github.com/Technion-Kishony-lab/quibbler/issues)). \n\n## Related packages\n\n* [Matplotlib](https://github.com/matplotlib/matplotlib)\n* [Streamlit](https://streamlit.io/)\n* [Plotly](https://plotly.com/)\n* [Shiny](https://shiny.rstudio.com/)\n* [ipywidgets](https://github.com/jupyter-widgets/ipywidgets)\n* [bokeh](http://bokeh.org)\n* [HoloViz](https://holoviz.org/)\n* [Vega-Altair](https://altair-viz.github.io/)\n* [Datashader](https://datashader.org/)\n",
"bugtrack_url": null,
"license": null,
"summary": "Interactive, reproducible and efficient data analytics",
"version": "0.3.4",
"project_urls": {
"Homepage": "https://github.com/Technion-Kishony-lab/quibbler"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "20f3eceadb16db09e5ab2ead94dfbd1003583665051e8dde8edb0c61656306f6",
"md5": "a9ed103f3866d5d5d8316c74f26b0291",
"sha256": "498567dacbefec35950421c324b4087d2b9a438464a4b7225e86f76b9be79665"
},
"downloads": -1,
"filename": "pyquibbler-0.3.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a9ed103f3866d5d5d8316c74f26b0291",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 279793,
"upload_time": "2025-02-22T22:28:07",
"upload_time_iso_8601": "2025-02-22T22:28:07.348221Z",
"url": "https://files.pythonhosted.org/packages/20/f3/eceadb16db09e5ab2ead94dfbd1003583665051e8dde8edb0c61656306f6/pyquibbler-0.3.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-22 22:28:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Technion-Kishony-lab",
"github_project": "quibbler",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"tox": true,
"lcname": "pyquibbler"
}
JSON
