{ "version": "https:\/\/jsonfeed.org\/version\/1", "title": "LEFT JOIN: blog on analytics, visualisation & data science, posts tagged: untappd", "home_page_url": "https:\/\/en.leftjoin.ru\/tags\/untappd\/", "feed_url": "https:\/\/en.leftjoin.ru\/tags\/untappd\/json\/", "icon": "https:\/\/en.leftjoin.ru\/user\/userpic@2x.jpg", "author": { "name": "Nikolay Valiotti", "url": "https:\/\/en.leftjoin.ru\/", "avatar": "https:\/\/en.leftjoin.ru\/user\/userpic@2x.jpg" }, "items": [ { "id": "43", "url": "https:\/\/en.leftjoin.ru\/all\/how-to-build-dashboard-with-bootstrap-4-from-scratch-part-1\/", "title": "How to build a dashboard with Bootstrap 4 from scratch (Part 1)", "content_html": "

In previous articles we reviewed Plotly’s Dash Framework, learned to build scatter plots<\/a> and  create a map visualization<\/a>. This time we will summarize our knowledge and put all the pieces together to design a dashboard layout using the Bootstrap 4 grid system.
\nTo facilitate the development, we’ll refer to the dash-bootstrap-components<\/a> library. This is a great tool that integrates Bootstrap in Dash, allowing us to write web pages in pure Python, and add any Bootstrap components and styling.<\/p>\n

Draft Layout<\/h2>\n

Before we begin coding it’s crucial to have a plan of our app, a rough layout that would help us to see the big picture and quickly modify the structure. We used draw.io<\/a> to make a dashboard draft, this application enables to create diagrams, graphs, flowcharts, and forms at the click of a button. The dashboard will be built according to this template:<\/p>\n

\n\"\"\n<\/div>\n

Like the dashboard itself, the top header will be colored in gold and white, the main colors of Untappd<\/a>. Just below the header, there is a section with breweries, which includes a scatter plot and a control panel. And at the bottom of the page, there will be a map showing beverage rating across the regions of Russia.<\/p>\n

All right, let’s get started, first create a new python file with the name application.py. The file will store all the front end components of the dashboard, and create a new directory named assets. The directory structure should be similar:<\/p>\n

- application.py\r\n- assets\/\r\n    |-- typography.css\r\n    |-- header.css\r\n    |-- custom-script.js\r\n    |-- image.png<\/code><\/pre>
Then we import the libraries and initialize our application:<\/p>\n
import dash\r\nimport dash_bootstrap_components as dbc\r\nimport dash_html_components as html\r\nimport dash_core_components as dcc\r\nimport pandas as pd\r\nfrom get_ratio_scatter_plot import get_plot\r\nfrom get_russian_map import get_map\r\nfrom clickhouse_driver import Client\r\nfrom dash.dependencies import Input, Output\r\n\r\nstandard_BS = dbc.themes.BOOTSTRAP\r\napp = dash.Dash(__name__, external_stylesheets=[standard_BS])<\/code><\/pre>
Main parameters of the app:
\n__name__<\/span>  — to enable access to static elements stored in the assets folder (such as images, CSS and JS files)
\nexternal_stylesheets<\/span> — external CSS styling,  here we are using a standard Bootstrap theme, however you can create your own theme  or use any of  the availables ones<\/a>.<\/p>\n
Hook up a few more things to work with local files  and connect to the Clickhouse Database:<\/p>\n
app.scripts.config.serve_locally = True\r\napp.css.config.serve_locally = True\r\n\r\nclient = Client(host='ec2-3-16-148-63.us-east-2.compute.amazonaws.com',\r\n                user='default',\r\n                password='',\r\n                port='9000',\r\n                database='default')<\/code><\/pre>
Add a palette of colors:<\/p>\n
colors = ['#ffcc00', \r\n          '#f5f2e8', \r\n          '#f8f3e3',\r\n          '#ffffff', \r\n          ]<\/code><\/pre>
Creating a layout<\/h2>\n
All the dashboard elements will be placed within a Bootstrap container,  which is in the  <div> block:<\/p>\n
- app \r\n    |-- div\r\n     |-- container\r\n      |-- logo&header\r\n     |-- container\r\n      |-- div\r\n       |-- controls&scatter\r\n       |-- map<\/code><\/pre>
app.layout = html.Div(\r\n                    [\r\n                        dbc.Container(\r\n\r\n                                         < header>\r\n                         \r\n                        dbc.Container(       \r\n                            html.Div(\r\n                                [\r\n                        \r\n                                    < body >\r\n                        \r\n                                ],\r\n                            ),\r\n                            fluid=False, style={'max-width': '1300px'},\r\n                        ),\r\n                    ],\r\n                    style={'background-color': colors[1], 'font-family': 'Proxima Nova Bold'},\r\n                )<\/code><\/pre>
Here we set a fixed container width, background color, and font style of the page that is stored in typography.css in the assets folder. Let’s take a closer look at the first element in the div block,  that’s the top header with the Untappd logo:<\/p>\n
logo = html.Img(src=app.get_asset_url('logo.png'),\r\n                        style={'width': "128px", 'height': "128px",\r\n                        }, className='inline-image')<\/code><\/pre>
and the header:<\/p>\n
header = html.H3("Russian breweries stats from Untappd", style={'text-transform': "uppercase"})<\/code><\/pre>
We used Bootstrap Forms to position these two elements on the same level.<\/p>\n
logo_and_header = dbc.FormGroup(\r\n        [\r\n            logo,\r\n            html.Div(\r\n                [\r\n                    header\r\n                ],\r\n                className="p-5"\r\n            )\r\n        ],\r\n        className='form-row',\r\n)<\/code><\/pre>
The class name  ‘p-5’ allows to increase padding and vertically align the title while specifying ‘form-row’  as the form class name we put the logo and header in one row.  At this point, the top header should  look the following:<\/p>\n
\n\"\"\n<\/div>\n
Now we need to center the elements and add some colors.  Create a separate container that will take one row. Specify ‘d-flex justify-content-center’<\/span> in the className<\/span>  to achieve the same output.<\/p>\n
dbc.Container(\r\n                    dbc.Row(\r\n                        [\r\n                            dbc.Col(\r\n                                html.Div(\r\n                                    logo_and_header,\r\n                                ),\r\n                            ),\r\n                        ],\r\n                        style={'max-height': '128px',\r\n                               'color': 'white',\r\n                       }\r\n\r\n                    ),\r\n                    className='d-flex justify-content-center',\r\n                    style={'max-width': '100%',\r\n                           'background-color': colors[0]},\r\n                ),<\/code><\/pre>
And now the top header is done:<\/p>\n
\n\"\"\n<\/div>\n
We’re approaching the main part, create the next Bootstrap Container and add a subheading:<\/p>\n
dbc.Container(\r\n                    html.Div(\r\n                        [\r\n                            html.Br(),\r\n                            html.H5("Breweries", style={'text-align':'center', 'text-transform': 'uppercase'}),\r\n                            html.Hr(), # horizontal  break<\/code><\/pre>
The main body will consist of Bootstrap Cards, they can provide a structured layout of all parts,  giving each element a clear border and saving the white space. Create the next element, a control panel with sliders:<\/p>\n
slider_day_values = [1, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100]\r\nslider_top_breweries_values = [5, 25, 50, 75, 100, 125, 150, 175, 200]\r\n\r\ncontrols = dbc.Card(\r\n    [\r\n       dbc.CardBody(\r\n           [\r\n               dbc.FormGroup(\r\n                    [\r\n                        dbc.Label("Time Period", style={'text-align': 'center', 'font-size': '100%', 'text-transform': 'uppercase'}),\r\n                        dcc.Slider(\r\n                            id='slider-day',\r\n                            min=1,\r\n                            max=100,\r\n                            step=10,\r\n                            value=100,\r\n                            marks={i: i for i in slider_day_values}\r\n                        ),\r\n                    ], style={'text-align': 'center'}\r\n               ),\r\n               dbc.FormGroup(\r\n                    [\r\n                        dbc.Label("Number of breweries", style={'text-align': 'center', 'font-size': '100%', 'text-transform': 'uppercase'}),\r\n                        dcc.Slider(\r\n                            id='slider-top-breweries',\r\n                            min=5,\r\n                            max=200,\r\n                            step=5,\r\n                            value=200,\r\n                            marks={i: i for i in slider_top_breweries_values}\r\n                        ),\r\n                    ], style={'text-align': 'center'}\r\n               ),\r\n           ],\r\n       )\r\n    ],\r\n    style={'height': '32.7rem', 'background-color': colors[3]}\r\n)<\/code><\/pre>
\n\"\"\n<\/div>\n
The control panel consists of two sliders that can be used to change the view on the scatter, they are positioned one below the other in a Bootstrap Form. The sliders were put inside the dbc.CardBody block, other elements will be added in the same way. It allows to eliminate alignment problem and achieve clear borders.  By default, the sliders are painted in blue, but we can easily customize them by changing the properties of the class in sliders.css.  Add the control panel with the scatter plot as follows:<\/p>\n
dbc.Row(\r\n                [\r\n                    dbc.Col(controls, width={"size": 4,\r\n                                     "order": 'first',\r\n                                             "offset": 0},\r\n                     ),\r\n                     dbc.Col(dbc.Card(\r\n                                [\r\n                                    dbc.CardBody(\r\n                                        [\r\n                                            html.H6("The ratio between the number of reviews and the average brewery rating",\r\n                                                    className="card-title",\r\n                                                    style={'text-transform': 'uppercase'}), \r\n                                            dcc.Graph(id='ratio-scatter-plot'),\r\n                                        ],\r\n                                    ),\r\n                                ],\r\n                                style={'background-color': colors[2], 'text-align':'center'}\r\n                             ),\r\n                     md=8),\r\n                ],\r\n                align="start",\r\n                justify='center',\r\n            ),\r\nhtml.Br(),<\/code><\/pre>
And at the bottom of the page we will position the map:<\/p>\n
html.H5("Venues and Regions", style={'text-align':'center', 'text-transform': 'uppercase',}),\r\n                            html.Hr(), # horizontal  break\r\n                            dbc.Row(\r\n                                [\r\n                                    dbc.Col(\r\n                                        dbc.Card(\r\n                                            [\r\n                                                dbc.CardBody(\r\n                                                    [\r\n                                                        html.H6("Average beer rating across regions",\r\n                                                                className="card-title",\r\n                                                                style={'text-transform': 'uppercase'},\r\n                                                        ),  \r\n                                                        dcc.Graph(figure=get_map())\r\n                                                    ],\r\n                                                ),\r\n                                            ],\r\n                                        style={'background-color': colors[2], 'text-align': 'center'}\r\n                                        ),\r\n                                md=12),\r\n                                ]\r\n                            ),\r\n                            html.Br(),<\/code><\/pre>
Callbacks in Dash<\/h2>\n
Callback functions allow making dashboard elements interactive through the  Input and Output properties of a particular component.<\/p>\n
@app.callback(\r\n    Output('ratio-scatter-plot', 'figure'),\r\n    [Input('slider-day', 'value'),\r\n     Input('slider-top-breweries', 'value'),\r\n     ]\r\n)\r\ndef get_scatter_plots(n_days=100, top_n=200):\r\n    if n_days == 100 and top_n == 200:\r\n        df = pd.read_csv('data\/ratio_scatter_plot.csv')\r\n        return get_plot(n_days, top_n, df)\r\n    else:\r\n        return get_plot(n_days, top_n)<\/code><\/pre>
In this example, our inputs are the “value” properties of the components that have the ids “slider-day’” and  “slider-top-breweries”. Our output is the “children” property of the component with the id “ratio-scatter-plot”. When the input values are changed, the decorator function will be called automatically and the output on the scatter is updated. Learn more about callbacks from the examples in the docs.<\/a>
\nIt’s worth noting, that the scatter plot may not be displayed correctly when the page is loaded. To avoid this scenario we need to specify its initial state and produce a scatter plot from the saved CSV file stored in the data folder.  Then, when changing the slider values, all data will be taken directly from the Clickhouse tables.<\/p>\n
\n
\n\"\"\n\"\"\n<\/div>\n<\/div>\n
Add a few more lines responsible for deployment and our app is ready to run:<\/p>\n
application = app.server\r\n\r\nif __name__ == '__main__':\r\n    application.run(debug=True, port=8000)<\/code><\/pre>
Next, we need to  deploy our app to AWS BeansTalk<\/a> and the first part of our Bootstrap Dashboard is completed<\/a>:<\/p>\n