Skip to content

Latest commit

 

History

History
152 lines (109 loc) · 3.81 KB

README.rst

File metadata and controls

152 lines (109 loc) · 3.81 KB
Raw

Finish Line

Finish Line is a framework for quickly building beautiful customizable dashboards in Plotly Dash. The framework provides utility for developers to easily plugin new interactive visualization components into the dashboard. Components are automatically added to the dashboard using a responsive grid layout.

How to use Finish Line

An example use of the framework is located in the GitHub repo under the example directory. The following shows the minimum code required to start a Finish Line dashboard server.

from finishline import FinishLine
import dash

app = dash.Dash()
data = load_my_data()

fl = FinishLine(app=app, data=data)
fl.load_plugins()
app.layout = fl.generate_layout()

if __name__ == '__main__':
    fl.run_server(debug=True, port=5000, host='0.0.0.0')

Visualization components are loaded from the plugins folder. The default location is in a folder called plugins in the current working directory (directory the web server is started). Individual plugins are located in subfolders under the plugins folder. The entry point to a plugin is in the file __init__.py.

Here is an example component. The code is placed in ./plugins/HelloWorld/__init__.py

import dash_html_components as html
import dash_core_components as dcc

def initialize(app, data, fl):

    fl.register_vis(
        'HelloWorld',
        dcc.Graph(
            id='basic-chart',
            figure={
                'data': [
                    {
                        'x': [1, 2, 3, 4],
                        'y': [4, 1, 3, 5],
                        'text': ['a', 'b', 'c', 'd'],
                        'customdata': ['c.a', 'c.b', 'c.c', 'c.d'],
                        'name': 'Trace 1',
                        'mode': 'markers',
                        'marker': {'size': 12}
                        },
                    {
                        'x': [1, 2, 3, 4],
                        'y': [9, 4, 1, 4],
                        'text': ['w', 'x', 'y', 'z'],
                        'customdata': ['c.w', 'c.x', 'c.y', 'c.z'],
                        'name': 'Trace 2',
                        'mode': 'markers',
                        'marker': {'size': 12}
                        }
                    ]
                },
            config={
                'autosizable': True
                }
            )
    )

def finalize(app, data, fl):
    pass

Installation

Finish Line depends upon dash. Note, we have only tested with python3.

Requirements:

  • dash
  • dash-responsive-grid-layout

Install Options

pip3 install finishline

Build

Create distribution

  • edit setup.py and change version number
python3 setup.py sdist bdist_wheel

Install distribution locally

pip3 uninstall finishline
pip3 install dist/finishline-VERSION-py3-none-any.whl

Push to test pip

twine upload --repository-url https://test.pypi.org/legacy/ dist/*VERSION*
pip3 install -U --index-url https://test.pypi.org/simple/ finishline

Push to production pip

twine upload dist/*VERSION*
pip3 install -U finishline

Features

  • Client and server side data store API
  • Plugin visualization component API
  • Responsive grid layout
  • Customizable grid layout via drag and drop
  • Developer mode

To Do List

  • Save layout
  • Reusable components API
  • Hide/Show components
  • Support multiple pages
  • Better support for resizing plotly charts