plotly-dash custom component. Adds Plotly.extendTraces() support to dash_core_components.Graph()
Project description
dash-extendable-graph
dash-extendable-graph is a Dash component library. This library contains a single component: ExtendableGraph
. The component is a fork of the Graph() component of dash-core-components (v 0.45.0), with an extra property (extendData
) that allows Graph traces to be drawn through Plotly.extendTraces()
instead of Plotly.react()
.
Note: plotly.js is required. However, the library is NOT explicitly listed in MANIFEST.in
or in dash_extendable_graph\__init__.py
as a way to reduce bundle size. Plotly.js is already distributed with the dash-core-components package, and most projects will import dcc as well as dash-extendable-graph.
Installation
Get started with:
- Install Dash and dependencies: https://dash.plot.ly/installation
$ pip install -r requirements.txt
- Install dash-extendable-graph
$ pip install dash-extendable-graph
- Run
python usage.py
- Visit http://localhost:8050 in your web browser
Usage
General examples may be found in usage.py
extendData keys
updateData
[list]: a list of dictionaries, each containing representing trace data (e.gdict(x=[1], y=[1])
)traceIndices
[list, optional]: identify the traces that should be extended. If the specified trace index does not exist, the corresponding trace shall be appended to the figure.maxPoints
[number, optional]: define the maximum number of points to plot in the figure (per trace).
Based on the Plotly.extendTraces()
api.
Code
Extend a trace once per second, limited to 100 maximum points.
import dash_extendable_graph as deg
import dash
from dash.dependencies import Input, Output, State
import dash_html_components as html
import dash_core_components as dcc
import random
app = dash.Dash(__name__)
app.scripts.config.serve_locally = True
app.css.config.serve_locally = True
app.layout = html.Div([
deg.ExtendableGraph(
id='extendablegraph_example',
figure=dict(
data=[{'x': [0],
'y': [0],
'mode':'lines+markers'
}],
)
),
dcc.Interval(
id='interval_extendablegraph_update',
interval=1000,
n_intervals=0,
max_intervals=-1),
html.Div(id='output')
])
@app.callback(Output('extendablegraph_example', 'extendData'),
[Input('interval_extendablegraph_update', 'n_intervals')],
[State('extendablegraph_example', 'figure')])
def update_extendData(n_intervals, existing):
x_new = existing['data'][0]['x'][-1] + 1
y_new = random.random()
return [dict(x=[x_new], y=[y_new])], [0], 100
if __name__ == '__main__':
app.run_server(debug=True)
Contributing
See CONTRIBUTING.md
Local Installation
- Dependencies
$ npm install
$ virtualenv venv
$ . venv/bin/activate
$ pip install -r requirements.txt
$ pip install -r tests/requirements.txt
- Build
$ npm run build:all
- Check out the component via component-playground
$ npm run start
The demo app is in `src/demo`
- Check out the sample Dash application using the component
$ python setup.py install
$ python usage.py
Tests
- Run the tests with
$pytest tests
Create a production build and publish:
$ npm run build
$ rm -rf dist
$ python setup.py sdist bdist_wheel
$ twine upload dist/*
$ npm publish
Test your tarball by copying it into a new environment and installing it locally:
$ pip install dash_extendable_graph-X.X.X.tar.gz
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for dash_extendable_graph-0.2.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | f6b24db46b1148029cc86030ba6cd6f37705d07fe8a72d21d836e5b3eb438f4b |
|
MD5 | 617f70b6254c76e809e435f3170a601c |
|
BLAKE2b-256 | b830172021894f548a0ed51c988b684aa33c0819d1e050aa13a3e9e6d6fe1e1a |
Hashes for dash_extendable_graph-0.2.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 61ec0cc22bdded07e3d99c9557fa7a5e92504694f858abd62f9344adfa9fee3c |
|
MD5 | d5df14465115fbd0c9eba9d27657fd18 |
|
BLAKE2b-256 | e2d424c5cb5f54eb917be412a5c97d3ce76b091fcda016e3a915ef1812be57a8 |