README.md

Quantitative Timed Pattern Matching

This is an experimental implementation of Quantitative Timed Pattern Matching. See FORMATS2019.md for the experiments in our FORMATS 2019 paper.

Demo on Google Colab is HERE!!

Usage

Synopsis

qtpm [OPTIONS] -f FILE [FILE]

Options

-h, --help Print a help message.
-q, --quiet Quiet mode. Causes any results to be suppressed.
-V, --version Print the version
-i file, --input file Read a signal from file.
-f file, --automaton file Read a timed automaton from file.
-a, --abs absolute time mode. In this mode, the "time" entry shows the (absolute) timestamp of the end of each piece.
--maxmin Use max-min semiring robust semantics (default).
--minplus Use min-plus semiring robust semantics.
--maxplus Use max-plus semiring robust semantics.
--boolean Use boolean semantics.

Installation

This software is tested on Ubuntu 20.04, Ubuntu 22.04, macOS 11, macOS 12, macOS 13, and Arch Linux.

Requirements

• C++ compiler supporting C++14 and the corresponding libraries.
• Boost (>= 1.59)
• Eigen
• CMake

Instructions

mkdir build
cd build && cmake -DCMAKE_BUILD_TYPE=Release .. && make

Input Format

Signal

A signal is a sequence of the following lines.

 time v(x1) v(x2) v(x3) ... v(xn)

Here, the column "time" has different meaning between relative time mode (default) and absolute time mode (enabled by -a). Consider an example of a signal where during the first 1.0 time unit, the value is 0.0, and during the next 1.0 time unit, the value is 2.0. In the relative time mode, such a signal is encoded as follows, where the "time" entry shows the duration of each piece.

1.0 0.0
1.0 2.0

In the absolute time mode, such a signal is encoded as follows, where the "time" entry shows the (absolute) timestamp of the end of each piece.

1.0 0.0
2.0 2.0

Note on the accepting states

To simplify the algorithm, we assume that each matching ends at the same time as a transition to an accepting state is invoked. This assumption does not harm the generality: one can construct a TSWA for such a matching algorithm by making all the states during matching non-accepting, making a fresh accepting state, and making transitions to it so that the transitions to the accepting state are invoked when the matching ends. The following is a typical example of such a TSWA:

How to make compile_commands.json

mkdir build
cd build && cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON ..

Reference

• Masaki Waga, Online Quantitative Timed Pattern Matching with Semiring-Valued Weighted Automata, In Proc. FORMATS 2019, LNCS 11750, pp. 3-22 (Best paper awarded). arXiv version