# -*- coding: utf-8 -*-
import socket
import dash
import dash_html_components as html
import dash_core_components as dcc
from .Dashboard_Control import _Dashboard_Control
[docs]class AgentDashboard:
"""
Class for the web dashboard which runs with the AgentNetwork object, which by default are on the same IP.
Optional to run the dashboard on a separate IP by providing the right parameters. See example for an implementation of a separate run of dashboard to connect to an existing agent network. If there is no existing agent network, error will show up.
An internal _Dashboard_Control object is instantiated inside this object, which manages access to the AgentNetwork.
"""
def __init__(self, dashboard_modules=[], dashboard_layouts=[], dashboard_update_interval = 3, max_monitors=10, ip_addr="127.0.0.1",port=8050, agentNetwork="127.0.0.1", agent_ip_addr=3333,agent_port=None):
"""
Parameters
----------
dashboard_modules : modules
Modules which are separate files, and contain classes of agents to be imported into the dashboard's interactive "Add Agent" function
dashboard_update_interval : int
Auto refresh rate which the dashboard queries the states of Agent Network to update the graphs and display
max_monitors : int
Due to complexity in managing and instantiating dynamic figures, a maximum number of monitors is specified first and only the
each Monitor Agent will occupy one of these figures. It is not ideal, but will undergo changes for the better.
ip_addr : str
IP Address of the dashboard to be instantiated on.
port : int
Port number of the dashboard to be instantianted on.
agentNetwork: AgentNetwork
AgentNetwork object. If `agent_ip_addr` or `agent_port` is provided, this argument will be ignored and try to connect to a new AgentNetwork specified by those arguments.
agent_ip_addr : str
IP Address of the Agent Network address to connect to. By default, it will match that of the ip_addr, assuming the Dashboard and Agent Network are run on the same machine with same IP address.
If they are meant to be separated, then this argument will point to the IP address of where the Agent Network is running.
agent_port : int
Port of the Agent Network port. The rationale is similar to that of the argument `agent_ip_addr`.
"""
if self.is_port_in_use(ip_addr,port) is False:
if dashboard_modules is not None and dashboard_modules is not False:
#initialise the dashboard layout and its control here
self.external_stylesheets = ['https://fonts.googleapis.com/icon?family=Material+Icons', 'https://cdnjs.cloudflare.com/ajax/libs/materialize/1.0.0/css/materialize.min.css']
self.external_scripts = ['https://cdnjs.cloudflare.com/ajax/libs/materialize/1.0.0/js/materialize.min.js']
self.app = self.init_app_layout(update_interval_seconds=dashboard_update_interval,max_monitors=max_monitors, dashboard_layouts=dashboard_layouts)
self.app.dashboard_ctrl = _Dashboard_Control(modules=dashboard_modules,agent_ip_addr=agent_ip_addr,agent_port=agent_port,agentNetwork=agentNetwork)
self.app.run_server(debug=False,host=ip_addr, port=8050)
else:
print("Dashboard is running on: " + ip_addr+":"+str(port))
[docs] def init_app_layout(self,update_interval_seconds=3, max_monitors=10, dashboard_layouts=[]):
"""
Initialises the overall dash app "layout" which has two sub-pages (Agent network and ML experiment)
Parameters
----------
update_interval_seconds : float or int
Auto refresh rate which the app queries the states of Agent Network to update the graphs and display
max_monitors : int
Due to complexity in managing and instantiating dynamic figures, a maximum number of monitors is specified first and only the
each Monitor Agent will occupy one of these figures. It is not ideal, but will undergo changes for the better.
Returns
-------
app : Dash app object
"""
app = dash.Dash(__name__,
external_stylesheets=self.external_stylesheets,
external_scripts=self.external_scripts
)
app.update_interval_seconds = update_interval_seconds
app.num_monitors = max_monitors
#initialise dashboard layout objects
self.dashboard_layouts = [dashboard_layout(app) for dashboard_layout in dashboard_layouts]
app.layout = html.Div(children=[
#header
html.Nav([
html.Div([
html.A("Met4FoF Agent Testbed", className="brand-logo center"),
html.Ul([
], className="right hide-on-med-and-down")
], className="nav-wrapper container")
], className="light-blue lighten-1"),
dcc.Tabs(id="main-tabs", value="agt-net", children=[
dashboard_layout.dcc_tab for dashboard_layout in self.dashboard_layouts
]),
html.Div(id="page-div",children=[
dashboard_layout.get_layout() for dashboard_layout in self.dashboard_layouts
]),
])
for dashboard_layout in self.dashboard_layouts:
dashboard_layout.prepare_callbacks(app)
@app.callback([dash.dependencies.Output('page-div', 'children')],
[dash.dependencies.Input('main-tabs', 'value')])
def render_content(tab):
for dashboard_layout in self.dashboard_layouts:
if dashboard_layout.id == tab:
return [dashboard_layout.get_layout()]
return app
def is_port_in_use(self,ip_addr,_port):
with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
return s.connect_ex((ip_addr, _port)) == 0