UP | HOME

LTLDO

Table of Contents

NAME

ltldo − run LTL/PSL formulas through other tools

SYNOPSIS

ltldo [OPTION...] [COMMANDFMT...]

DESCRIPTION

Run LTL/PSL formulas through another program, performing conversion of input and output as required.

Input options:

−f, −−formula=STRING

process the formula STRING

−F, −−file=FILENAME[/COL]

process each line of FILENAME as a formula; if COL is a positive integer, assume a CSV file and read column COL; use a negative COL to drop the first line of the CSV file

−−lbt−input

read all formulas using LBT’s prefix syntax

−−lenient

parenthesized blocks that cannot be parsed as subformulas are considered as atomic properties

Specifying translators to call:

−−list−shorthands

list availabled shorthands to use in COMMANDFMT

−t, −−translator=COMMANDFMT

register one translator to call

−T, −−timeout=NUMBER

kill translators after NUMBER seconds

COMMANDFMT should specify input and output arguments using the following character sequences:

%%

a single %

%f,%s,%l,%w

the formula as a (quoted) string in Spot, Spin, LBT, or Wring’s syntax

%F,%S,%L,%W

the formula as a file in Spot, Spin, LBT, or Wring’s syntax

%O

the automaton is output in HOA, never claim, LBTT, or ltl2dstar’s format

If either %l, %L, or %T are used, any input formula that does not use LBT−style atomic propositions (i.e. p0, p1, ...) will be relabeled automatically. Furthermore, if COMMANDFMT has the form "{NAME}CMD", then only CMD will be passed to the shell, and NAME will be used to name the tool in the output.

Output format:

−8, −−utf8

enable UTF−8 characters in output (ignored with −−lbtt or −−spin)

−−check[=PROP]

test for the additional property PROP and output the result in the HOA format (implies −H). PROP may be any prefix of ’all’ (default), ’unambiguous’, or ’stutter−invariant’.

−−dot[=1|a|b|B|c|e|f(FONT)|h|n|N|o|r|R|s|t|v]

GraphViz’s format (default). Add letters for (1) force numbered states, (a) acceptance display, (b) acceptance sets as bullets, (B) bullets except for Büchi/co−Büchi automata, (c) force circular nodes, (e) force elliptic nodes, (f(FONT)) use FONT, (h) horizontal layout, (v) vertical layout, (n) with name, (N) without name, (o) ordered transitions, (r) rainbow colors for acceptance sets, (R) color acceptance sets by Inf/Fin, (s) with SCCs, (t) force transition−based acceptance.

−H, −−hoaf[=i|s|t|m|l]

Output the automaton in HOA format. Add letters to select (i) use implicit labels for complete deterministic automata, (s) prefer state−based acceptance when possible [default], (t) force transition−based acceptance, (m) mix state and transition−based acceptance, (l) single−line output

−−lbtt[=t]

LBTT’s format (add =t to force transition−based acceptance even on Büchi automata)

−−name=FORMAT

set the name of the output automaton

−o, −−output=FORMAT

send output to a file named FORMAT instead of standard output. The first automaton sent to a file truncates it unless FORMAT starts with ’>>’.

−q, −−quiet

suppress all normal output

−s, −−spin[=6|c]

Spin neverclaim (implies −−ba). Add letters to select (6) Spin’s 6.2.4 style, (c) comments on states

−−stats=FORMAT

output statistics about the automaton

Any FORMAT string may use the following interpreted sequences:

%%

a single %

%a

number of acceptance sets

%c

number of SCCs

%d

1 if the output is deterministic, 0 otherwise

%e

number of edges

%F

name of the input file

%f

formula translated

%g

acceptance condition (in HOA syntax)

%L

location in the input file

%m

name of the automaton

%n

number of nondeterministic states in output

%p

1 if the output is complete, 0 otherwise

%r

processing time (excluding parsing) in seconds

%R

serial number of the formula translated

%s

number of states

%t

number of transitions

%T

tool used for translation

%w

one word accepted by the output automaton

Miscellaneous options:

−−help

print this help

−−version

print program version

Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options.

REPORTING BUGS

Report bugs to <spot@lrde.epita.fr>.

COPYRIGHT

Copyright © 2015 Laboratoire de Recherche et Développement de l’Epita. License GPLv3+: GNU GPL version 3 or later.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

randltl(1), genltl(1), ltlfilt(1), ltl2tgba(1), ltldo(1)