ghorwin / MonVerifyTools

A set of scripts to automatically check the content of periodically obtained measurement data files, useful for larger monitoring projects

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Logos

MonVerifyTools

A set of scripts to automatically check the content of periodically obtained measurement data files, useful for larger monitoring projects.

These tools and the methodology were developed at the Institut für Bauklimatik, TU Dresden, during various research projects. Some were:

  • EnEff:Stadt - Verbundvorhaben: Modellhaftes innerstädtisches Gebiet "Altes Zöllnerviertel Weimar" (FKZ 03ET1173C)
  • Forschungsprüfstand für multtifunktionale aktive Fassadensysteme mit Raumankopplung, im Rahmen der SAB Förderung "Anwendungsorientierte Forschung an innovativen Energietechniken"
  • "Carbon Concrete Composite C³" - Carbonbeton mit integrierten bauklimatischen Funktionen, ein Zwanzig20 C³ Projekt (BMBF)

Motivation

Engineering/scientific monitoring typically starts small with a few sensors that can be read and analyzed by users in suitable intervals. As soon as the number of sensors increases and measurement frequency becomes higher (semi-hourly or minutely values), retrieving and checking the measurement data manually becomes a cumbersome and error-prone process.

Here, the MonVerifyTools step in and assist with automated functionality to:

  • (push-type) collection of monitoring data files from external sources (clients)
  • check for correct input format of measurement files (compare against expected formats)
  • perform a set of configured content checks to see if files are complete and valid (e.g. guard against sensor fault, missing time points, broken client/server connections and partial file commits etc.)
  • perform additional physical value checks (e.g. out-of-value-range checks, large oszillation/gradient checks, etc.), that signal that something might be wrong with a) sensor, b) monitored system/equipment
  • log results of checks to log files for easy screening by human-users
  • move offending files to separate review directory, and move correct files to "ready for processing" directories

Basically, you can think of the MonVerifyTools as a quality assurance interim step, between raw data collection and actual data processing.

Overview

Is this something for you?

Whenever you find yourself frequently copying data from a data logger and importing the data into some post-processing software, you may want to take a look at the MonVerifyTools.

What is this toolkit and how does it work?

Basically, it's a Python script that scans a directory structure for rule files, and incoming data. The data files are read/checked and if correct according to requirements moved to an archive folder, or if something is amiss, they are moved to a review folder, for human users to check and fix. Also, log files are written.

For now, see documentation (currently only in German, but source code is documented in english).

Btw, the file format used by the MonVerifyTools is natively supported by the free scientific post-processing software PostProc 2, which makes it very easy to deal with frequently updated data (and creates nice diagrams as well :-).

About

A set of scripts to automatically check the content of periodically obtained measurement data files, useful for larger monitoring projects

License:BSD 2-Clause "Simplified" License


Languages

Language:Python 96.1%Language:Shell 3.9%