FaultMap is a data-driven, model-free process fault detection and diagnosis tool. Causal links between processes elements are identified using information theory measures (transfer entropy). These links are then used to create a visual representation of the main flows of information (disturbances, etc.) among the process elements as a directed graph. These directed graphs are useful as troubleshooting aids.
Network centrality algorithms are applied to determine the most influential elements based on the strength and quality of their influence on other connected nodes (eigenvector centrality).
Documentation and demonstrations still under development.
Most of the prerequisites are related to getting JPype to work correctly:
- Python 3.7+ with compatible C++ compiler
- On Windows, compiling packages usually requires the
VC++ 2015.3 v14.00 (v140) toolset for desktopto be installed from the Visual Studio installer.
- On Windows, compiling packages usually requires the
- Java JDK 1.8.201+ (or latest Java 8 SDK)
- The JAVA_HOME environment variable should point to the installation directory.
git clone https://github.com/SimonStreicher/FaultMap.git
cd FaultMap
conda create --name faultmap python=3.7
source activate faultmap
pip install -r requirements.txt
pytestA Docker image is available with all necessary packages and dependencies installed.
docker pull simonstreicher/faultmapIf you want to build locally, the Dockerfile can be found at FaultMapDocker GitHub.
Create directories for storing the data, configuration files as well as results.
Create a file caseconfig.json in the root directory, similar to testconfig.json which comes with the distribution.
Enter the full path to the data, configuration and results directories as well as the infodynamics.jar you want to use for Java Information Dynamics Toolkit (JIDT) (the tested version is included in the distribution).
Example caseconfig.json file (also included in example_configs directory):
{
"dataloc": "~/faultmap/faultmap_data",
"configloc": "~/repos/faultmapconfigs",
"saveloc": "~/faultmap/faultmap_results",
"infodynamicsloc": "~/repos/FaultMap/infodynamics.jar"
}Refer to the example_configs directory in the distribution for the required format of configuration files in order to fully define cases and scenarios.
The following configuration files are needed to fully specify a specific case:
weightcalc.jsonnoderank.jsongraphreduce.jsonplotting.json
In order to calculate a full set of results for a specific case, make sure this case name is included in the config_full.json file in the directory defined under configloc in the caseconfig.json file.
Example config_full.json file (also included in example_configs directory):
{
"mode": "cases",
"writeoutput": true,
"cases": [
"tennessee_eastman"
]
}
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent