- FOSS project
- quickly set up and run a metrologically enabled multi-agent system
- handle both static data sets and online data streams
- consider measurement uncertainties as well as metadata with the provided message system
- installable as a Python package or ready-to-deploy Docker image
- comes bundled with several introductary and advanced tutorials
- accompanied by several use cases with close-to-industry IIoT applications in our GitHub organisation
- comprehensive and ever-growing documentation
Quickstart
agentMET4FOF comes bundled with some tutorials to get you started as quick as possible. In your Python console execute the following to run the first tutorial.
>>> from agentMET4FOF_tutorials.tutorial_1_generator_agent import demonstrate_generator_agent_use >>> generator_agent_network = demonstrate_generator_agent_use()
About
Sensor deployments in industrial applications usually form networks in all sorts of environments. This requires a flexible framework for the implementation of the corresponding data analysis. An excellent way to represent such networks is a multi-agent system (MAS), where independent software modules (agents) encapsulate properties and functionalities. agentMET4FOF is an interactive and flexible open-source implementation of such a MAS. The software engineering process is driven by several industry-oriented use cases with the aim of impacting on IIoT applications. This leads to a framework that is specialized in representing heterogeneous sensor networks.
A special emphasize is put on supporting metrological treatment of sensor streaming data. This includes the consideration of measurement uncertainties during data analysis and processing as well as propagating metadata alongside the data itself.
One of the many questions that drive us in the project is:
How can metrological input be incorporated into an agent-based system for addressing uncertainty of machine learning in future manufacturing?
Features
Some notable features of agentMET4FOF include:
- Modular agent classes for metrological data streams and analytics
- A built-in buffering mechanism to decouple transmission, processing and visualization of data
- Easy connection among software agents to send and receive data
- Choose backends between:
- Interactive and customisable dashboard from the get-go to:
- Visualize and change agent-network topologies
- Visualize groups of cooperative agents as Coalitions
- View and change the agents' parameters
- View the agents' outputs as plotly or matplotlib plots or generate and embed your own images
The agentMET4FOF dashboard
agentMET4FOF comes bundled with our so called dashboard. It is an optional component of every agent network and provides a web browser based view. You can observe the state of your agents, modify the connections between them and even add more pre-made agents to your network all during run-time. The address to your dashboard is printed to the console on every launch of an agent network.
For details on the tutorials visit our screencast series.
Tutorials
As mentioned above, agentMET4FOF comes bundled with several tutorials to get you started as quick as possible. You will find tutorials on how to set up:
- a simple pipeline to plot a signal
- a simple pipeline with signal postprocessing
- an advanced pipeline with multichannel signals
- a simple metrological datastream
- pipelines to determine redundancy in sensor networks
- a pipeline to reduce noise and jitter in sensor readings
... and more!
Documentation and screencasts
Screencast series
Additionally, we provide some video tutorials based on agentMET4FOF 0.4.1 on the project homepage in the section Tutorials for the multi-agent system agentMET4FOF. You can self-register on the linked page and get started immediately. The video series begins with our motivation for creating agentMET4FOF, guide you through the installation of Python and other recommended software until you execute the tutorials on your machine.
Live online tutorial during early development
In an early development stage we held a live online tutorial based on agentMET4FOF 0.1.0 which you can download.
If questions arise, or you feel something is missing, reach out to us.
Installation
There are different ways to run agentMET4FOF. Either:
- you install Python and our package agentMET4FOF in a virtual Python environment on your computer, or
- you install Docker, start agentMET4FOF in a container and visit the Jupyter Notebook server and the agentMET4FOF dashboard directly in your browser or even deploy it over a proper webserver
In the screencast series we guide you through every step of option 1. More detailed instructions on both options you can find in the installation section of the docs.
Contributing
Whenever you are involved with agentMET4FOF, please respect our Code of Conduct. If you want to contribute back to the project, after reading our Code of Conduct, take a look at our open developments in the project board, pull requests and search the issues. If you find something similar to your ideas or troubles, let us know by leaving a comment or remark. If you have something new to tell us, feel free to open a feature request or bug report in the issues. If you want to contribute code or improve our documentation, please check our contributing guide.
Coming soon
- Improve handling of metadata
- Further improve plotting
For a comprehensive overview of current development activities and upcoming tasks, take a look at the project board, issues and pull requests.
Citation
If you publish results obtained with the help of agentMET4FOF, please cite the linked DOI.
Acknowledgement
This work was part of the Joint Research Project Metrology for the Factory of the Future (Met4FoF), project number 17IND12 of the European Metrology Programme for Innovation and Research (EMPIR). The EMPIR is jointly funded by the EMPIR participating countries within EURAMET and the European Union.
Disclaimer
This software is developed as a joint effort of several project partners namely:
- Institute for Manufacturing of the University of Cambridge (IfM)
- Physikalisch-Technische Bundesanstalt (PTB)
- Van Swinden Laboratory (VSL)
- National Physics Laboratory (NPL)
under the lead of IfM. The software is made available "as is" free of cost. The authors and their institutions assume no responsibility whatsoever for its use by other parties, and makes no guarantees, expressed or implied, about its quality, reliability, safety, suitability or any other characteristic. In no event will the authors be liable for any direct, indirect or consequential damage arising in connection with the use of this software.
License
agentMET4FOF is distributed under the LGPLv3 license.