# Floatview Stats
<table>
<tr>
<td>Latest Release</td>
<td>
<a href="https://pypi.org/project/floatview/"/>
<img src="https://badge.fury.io/py/floatview.svg"/>
</td>
</tr>
<tr>
<td>PyPI Downloads</td>
<td>
<a href="https://pepy.tech/project/floatview"/>
<img src="https://pepy.tech/badge/floatview/month"/>
</td>
</tr>
</table>
# Floatview
A floatview output widget for JupyterLab and a data explorer for glue/iplotly
## Installation
If you use jupyterlab 2.X:
```bash
pip install floatview
jupyter labextension install @jupyter-widgets/jupyterlab-manager@2.0.0
jupyter labextension install jupyterlab-plotly@4.9.0
jupyter labextension install plotlywidget@4.9.0
jupyter labextension install jupyterlab-floatview@0.3.1
```
If you use jupyterlab 1.X:
```bash
pip install floatview==0.2.0
jupyter labextension install @jupyter-widgets/jupyterlab-manager@1.0.1
jupyter labextension install jupyterlab-datawidgets@6.2.0
jupyter labextension install jupyterlab-plotly@1.0.0
jupyter labextension install plotlywidget@1.0.0
jupyter labextension install jupyterlab-floatview@0.2.0
```
older versions:
```bash
pip install floatview==0.1.18
jupyter labextension install @jupyterlab/plotly-extension@0.18.2
jupyter labextension install plotlywidget@0.9.1
jupyter labextension install @jupyter-widgets/jupyterlab-manager@0.38.1
jupyter labextension install jupyterlab-floatview@0.1.11
```
## Usage
The floatview widget is used as a context manager, just like ipywidgets' output
widget.
```python
from floatview import Floatview
from ipywidgets import IntSlider
sc = Floatview(title='Floatview Output', mode='tab-after', active=True)
sl = IntSlider(description='Some slider')
with sc:
display(sl)
```
When a single output is displayed in a Floatview, it is allowed to occupy all of
the vertical space available. If more content is displayed, the natural height
is used instead.
The gluemanagerwidget is used as a data/visualization manager for a glue dataset.
```python
from floatview import GlueManagerWidget
from pandas import read_csv
data = read_csv('your_data.csv', index_col=False, usecols=cols)
gmw = GlueManagerWidget(data, modal=True, label="Data")
```
## Available Visualizations
```python
#Histogram (supports 1 component)
view = gmw.gluemanager.newView(
"histogram",
["PULocationID"],
"Histogram"
)
```
```python
#Scatter (supports 2-n components)
view = gmw.gluemanager.newView(
"scatter",
["PULocationID", "DOLocationID"],
"Scatter"
)
view = gmw.gluemanager.newView(
"composed_scatter",
["trip_distance", "payment_type", 'passenger_count'],
"Composed Scatter"
)
```
```python
#ErrorBar (supports 2-n components)
view = gmw.gluemanager.newView(
"errorbar",
["trip_distance", "total_amount"],
"Error"
)
view = gmw.gluemanager.newView(
"composed_errorbar",
["trip_distance", "payment_type", 'passenger_count'],
"Composed Error"
)
```
```python
#Polynomial Fitting 2-n degree (supports n components)
view = gmw.gluemanager.newView(
"composed_polyfit_3d",
["trip_distance", "total_amount"],
"Polyfit"
);
```
```python
#scatter 3D (supports 3 components)
view = gmw.gluemanager.newView(
"scatter3D",
["trip_distance", "total_amount", "passenger_count"],
"Scatter3D"
)
```
```python
#Contours 2D (supports 2 components)
view = gmw.gluemanager.newView(
"contour",
["trip_distance", "total_amount"],
"Contour"
);
```
```python
#Table (supports n components)
view = gmw.gluemanager.newView(
"table",
['passenger_count', 'trip_distance', 'total_amount', 'payment_type'],
"Table"
);
```
```python
#Parallel coordinatess (supports n components)
view = gmw.gluemanager.newView(
"parallels",
['passenger_count', 'trip_distance', 'total_amount', 'payment_type'],
"Parallels"
);
```
```python
#Parallel categories (supports n components)
view = gmw.gluemanager.newView(
"parallelscat",
['passenger_count', 'trip_distance', 'total_amount', 'payment_type'],
"Parallels Categ"
);
```
```python
#Sankey (supports n components)
view = gmw.gluemanager.newView(
"sankey",
['passenger_count', 'trip_distance', 'total_amount', 'payment_type'],
"Sankey"
);
```
```python
#Sunburst (supports n components)
view = gmw.gluemanager.newView(
"sunburst",
['passenger_count', 'trip_distance', 'total_amount', 'payment_type'],
"Sunburst"
);
```
```python
#Sankey Tree (supports n components)
view = gmw.gluemanager.newView(
"sankeytree",
['total_amount', 'payment_type', 'passenger_count', ],
"Sankey Tree"
);
```
```python
#Scatter Matrix (supports n components)
view = gmw.gluemanager.newView(
"scattermatrix",
['passenger_count', 'trip_distance', 'total_amount', 'payment_type'],
"scatter Matrix"
);
```
```python
#Correlation Matrix (supports n components)
view = gmw.gluemanager.newView(
"corrcoef",
['passenger_count', 'trip_distance', 'total_amount', 'payment_type'],
"Correlation Matrix"
);
```
```python
#Principal components (supports n components)
view = gmw.gluemanager.newView(
"pca",
['passenger_count', 'trip_distance', 'total_amount', 'payment_type'],
"Principal components"
);
```
```python
#Network (supports 2 components)
view = gmw.gluemanager.newView(
"network",
['trip_distance', 'total_amount'],
"Network"
);
```
```python
#Image (supports 3 components)
view = gmw.gluemanager.newView(
"image",
["trip_distance", "total_amount", 'passenger_count'],
"Image"
);
```
```python
#Lines (supports n components)
view = gmw.gluemanager.newView(
"composed_lines",
["trip_distance", "payment_type", 'passenger_count'],
"Lines"
);
```
Raw data
{
"_id": null,
"home_page": "https://github.com/denphi/jupyterlab-floatview",
"name": "floatview",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "Jupyter,Widgets,IPython",
"author": "Project Jupyter contributor",
"author_email": "denphi@denphi.com",
"download_url": "",
"platform": "Linux",
"description": "# Floatview Stats\n\n<table>\n <tr>\n <td>Latest Release</td>\n <td>\n <a href=\"https://pypi.org/project/floatview/\"/>\n <img src=\"https://badge.fury.io/py/floatview.svg\"/>\n </td>\n </tr>\n <tr>\n <td>PyPI Downloads</td>\n <td>\n <a href=\"https://pepy.tech/project/floatview\"/>\n <img src=\"https://pepy.tech/badge/floatview/month\"/>\n </td>\n </tr>\n</table>\n\n# Floatview\n\nA floatview output widget for JupyterLab and a data explorer for glue/iplotly\n\n## Installation\n\nIf you use jupyterlab 2.X:\n\n```bash\npip install floatview\njupyter labextension install @jupyter-widgets/jupyterlab-manager@2.0.0\njupyter labextension install jupyterlab-plotly@4.9.0\njupyter labextension install plotlywidget@4.9.0\njupyter labextension install jupyterlab-floatview@0.3.1\n```\n\nIf you use jupyterlab 1.X:\n\n```bash\npip install floatview==0.2.0\njupyter labextension install @jupyter-widgets/jupyterlab-manager@1.0.1\njupyter labextension install jupyterlab-datawidgets@6.2.0\njupyter labextension install jupyterlab-plotly@1.0.0\njupyter labextension install plotlywidget@1.0.0\njupyter labextension install jupyterlab-floatview@0.2.0\n```\n\nolder versions:\n\n```bash\npip install floatview==0.1.18\njupyter labextension install @jupyterlab/plotly-extension@0.18.2\njupyter labextension install plotlywidget@0.9.1\njupyter labextension install @jupyter-widgets/jupyterlab-manager@0.38.1\njupyter labextension install jupyterlab-floatview@0.1.11\n```\n\n\n## Usage\n\nThe floatview widget is used as a context manager, just like ipywidgets' output\nwidget.\n\n```python\nfrom floatview import Floatview\nfrom ipywidgets import IntSlider\n\nsc = Floatview(title='Floatview Output', mode='tab-after', active=True)\nsl = IntSlider(description='Some slider')\nwith sc:\n display(sl)\n```\n\n\nWhen a single output is displayed in a Floatview, it is allowed to occupy all of\nthe vertical space available. If more content is displayed, the natural height\nis used instead.\n\nThe gluemanagerwidget is used as a data/visualization manager for a glue dataset.\n\n```python\nfrom floatview import GlueManagerWidget\nfrom pandas import read_csv\n\ndata = read_csv('your_data.csv', index_col=False, usecols=cols)\ngmw = GlueManagerWidget(data, modal=True, label=\"Data\")\n```\n\n\n\n\n\n## Available Visualizations\n```python\n#Histogram (supports 1 component)\nview = gmw.gluemanager.newView(\n \"histogram\",\n [\"PULocationID\"],\n \"Histogram\"\n)\n```\n\n\n```python\n#Scatter (supports 2-n components)\nview = gmw.gluemanager.newView(\n \"scatter\",\n [\"PULocationID\", \"DOLocationID\"],\n \"Scatter\"\n)\nview = gmw.gluemanager.newView(\n \"composed_scatter\",\n [\"trip_distance\", \"payment_type\", 'passenger_count'],\n \"Composed Scatter\"\n)\n```\n\n\n\n```python\n#ErrorBar (supports 2-n components)\nview = gmw.gluemanager.newView(\n \"errorbar\",\n [\"trip_distance\", \"total_amount\"],\n \"Error\"\n)\nview = gmw.gluemanager.newView(\n \"composed_errorbar\",\n [\"trip_distance\", \"payment_type\", 'passenger_count'],\n \"Composed Error\"\n)\n```\n\n\n\n```python\n#Polynomial Fitting 2-n degree (supports n components)\nview = gmw.gluemanager.newView(\n \"composed_polyfit_3d\",\n [\"trip_distance\", \"total_amount\"],\n \"Polyfit\"\n);\n```\n\n\n```python\n#scatter 3D (supports 3 components)\nview = gmw.gluemanager.newView(\n \"scatter3D\",\n [\"trip_distance\", \"total_amount\", \"passenger_count\"],\n \"Scatter3D\"\n)\n```\n\n\n```python\n#Contours 2D (supports 2 components)\nview = gmw.gluemanager.newView(\n \"contour\",\n [\"trip_distance\", \"total_amount\"],\n \"Contour\"\n);\n```\n\n\n```python\n#Table (supports n components)\nview = gmw.gluemanager.newView(\n \"table\",\n ['passenger_count', 'trip_distance', 'total_amount', 'payment_type'],\n \"Table\"\n);\n```\n\n\n```python\n#Parallel coordinatess (supports n components)\nview = gmw.gluemanager.newView(\n \"parallels\",\n ['passenger_count', 'trip_distance', 'total_amount', 'payment_type'],\n \"Parallels\"\n);\n```\n\n\n```python\n#Parallel categories (supports n components)\nview = gmw.gluemanager.newView(\n \"parallelscat\",\n ['passenger_count', 'trip_distance', 'total_amount', 'payment_type'],\n \"Parallels Categ\"\n );\n```\n\n\n```python\n#Sankey (supports n components)\nview = gmw.gluemanager.newView(\n \"sankey\",\n ['passenger_count', 'trip_distance', 'total_amount', 'payment_type'],\n \"Sankey\"\n);\n```\n\n\n```python\n#Sunburst (supports n components)\nview = gmw.gluemanager.newView(\n \"sunburst\",\n ['passenger_count', 'trip_distance', 'total_amount', 'payment_type'],\n \"Sunburst\"\n);\n```\n\n\n```python\n#Sankey Tree (supports n components)\nview = gmw.gluemanager.newView(\n \"sankeytree\",\n ['total_amount', 'payment_type', 'passenger_count', ],\n \"Sankey Tree\"\n);\n```\n\n\n```python\n#Scatter Matrix (supports n components)\nview = gmw.gluemanager.newView(\n \"scattermatrix\",\n ['passenger_count', 'trip_distance', 'total_amount', 'payment_type'],\n \"scatter Matrix\"\n);\n```\n\n\n```python\n#Correlation Matrix (supports n components)\nview = gmw.gluemanager.newView(\n \"corrcoef\",\n ['passenger_count', 'trip_distance', 'total_amount', 'payment_type'],\n \"Correlation Matrix\"\n);\n```\n\n\n```python\n#Principal components (supports n components)\nview = gmw.gluemanager.newView(\n \"pca\",\n ['passenger_count', 'trip_distance', 'total_amount', 'payment_type'],\n \"Principal components\"\n);\n```\n\n\n\n```python\n#Network (supports 2 components)\nview = gmw.gluemanager.newView(\n \"network\",\n ['trip_distance', 'total_amount'],\n \"Network\"\n);\n```\n\n\n\n```python\n#Image (supports 3 components)\nview = gmw.gluemanager.newView(\n \"image\",\n [\"trip_distance\", \"total_amount\", 'passenger_count'],\n \"Image\"\n);\n```\n\n\n\n```python\n#Lines (supports n components)\nview = gmw.gluemanager.newView(\n \"composed_lines\",\n [\"trip_distance\", \"payment_type\", 'passenger_count'],\n \"Lines\"\n);\n```\n\n",
"bugtrack_url": null,
"license": "BSD",
"summary": "A floatview output widget for JupyterLab + GlueViz Visualization with plotly",
"version": "0.3.2",
"split_keywords": [
"jupyter",
"widgets",
"ipython"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "14018e4720988499da4b24d1ab54284761461e78f386dd94296103b5c975a79e",
"md5": "50bfa1d45e2d938296af75dc3793f7a0",
"sha256": "e4d6504a7f24f6d7b02e2a4b02689f000c1e291839372a1adf8b94b198d98db3"
},
"downloads": -1,
"filename": "floatview-0.3.2-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "50bfa1d45e2d938296af75dc3793f7a0",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 23239068,
"upload_time": "2023-01-20T18:45:21",
"upload_time_iso_8601": "2023-01-20T18:45:21.915905Z",
"url": "https://files.pythonhosted.org/packages/14/01/8e4720988499da4b24d1ab54284761461e78f386dd94296103b5c975a79e/floatview-0.3.2-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-20 18:45:21",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "denphi",
"github_project": "jupyterlab-floatview",
"travis_ci": true,
"coveralls": true,
"github_actions": false,
"appveyor": true,
"lcname": "floatview"
}
JSON
