rfsm 1.6-alpha-3 · OCaml Package

type state = State.t

The type of state identifiers

type label = TransLabel.t

The type of state identifiers

The type of transition labels

module Repr : 
  Lascar.Ltsa.T
    with type state = state
     and type label = label
     and type attr = unit

The underlying representation : a LTS(A) for which state attributes have type unit.

type t = Repr.t

val repr_of : t -> Repr.t

val of_repr : Repr.t -> t

type transition = state * label * state

The type for transition. A transition is a triplet (s1,l,s2), where s1 is the source state, s2 the destination state and l the transition label

type itransition = label * state

The type for transition. A transition is a triplet (s1,l,s2), where s1 is the source state, s2 the destination state and l the transition label

The type for initial transition. An initial transition is a pair (l,s), where s is the destination state and l the transition label

module State : Lascar.Lts.STATE with type t = state

module Label : Lascar.Lts.LABEL with type t = label

module States : Set.S with type elt = state

val states : t -> States.t

Returns the set of states

val states' : t -> state list

Returns the set of states

Returns the list of states

val istates : t -> States.t

Returns the list of states

Returns the set of initial states

val istates' : t -> state list

Returns the set of initial states

Returns the list of initial states

val transitions : t -> transition list

Returns the list of initial states

Returns the list of transitions

val itransitions : t -> itransition list

Returns the list of transitions

Returns the list of initial transitions

val string_of_state : state -> string

A synonym of State.to_string

val string_of_label : label -> string

A synonym of State.to_string

A synonym of Label.to_string

val string_of_transition : transition -> string

A synonym of Label.to_string

Inspectors

val is_state : t -> state -> bool

is_state s q returns true iff q is a state in s

val is_init_state : t -> state -> bool

is_state s q returns true iff q is a state in s

is_init s q returns true iff q is an initial state in s

val is_reachable : t -> state -> bool

is_init s q returns true iff q is an initial state in s

is_reachable s q returns true iff q is a reachable state in s, i.e. if it can be reached from an initial state using the transitio relation.

val is_transition : t -> transition -> bool

is_reachable s q returns true iff q is a reachable state in s, i.e. if it can be reached from an initial state using the transitio relation.

is_transition t q returns true iff t is a transition in s

val succs : t -> state -> States.t

succs s q returns the set of immediate successors in s, i.e. the set of state q' such that there exists a transition (q,l,q') in R. Raise Invalid_argument if q is not in s.

val succs' : t -> state -> (state * label) list

succs s q returns the set of immediate successors in s, i.e. the set of state q' such that there exists a transition (q,l,q') in R. Raise Invalid_argument if q is not in s.

succs' s q returns the list of immediate successors, with the associated transition label, of state q in s. Raise Invalid_argument if q is not in s.

val preds : t -> state -> States.t

preds s q returns the set of immediate predecessors of state q in s, i.e. the set of state q' such that there exists a transition (q',l,q) in R. Raise Invalid_argument if q is not in s.

val preds' : t -> state -> (state * label) list

preds' s q returns the list of immediate predecessors, with the associated transition label, of state q in s. Raise Invalid_argument if q is not in s.

val succs_hat : t -> state -> States.t

preds' s q returns the list of immediate predecessors, with the associated transition label, of state q in s. Raise Invalid_argument if q is not in s.

Transitive closure of succs. succs_hat s q returns all the successors (immediate or not) of q in s

val preds_hat : t -> state -> States.t

Transitive closure of succs. succs_hat s q returns all the successors (immediate or not) of q in s

Transitive closure of preds. preds_hat s q returns all the predecessors (immediate or not) of q in s

Building functions

val empty : t

The empty LTS (no state, no transition)

val create : 
  states:state list ->
  itrans:(label * state) list ->
  trans:(state * label * state) list ->
  t

create qs q0s ts builds a LTS from

a list of states identifiers
a list of initial transitions, where each transition is given as (label,dst_state)
a list of transitions ts, where each transition is given as (src_state,label,dst_state)

val add_state : state -> t -> t

add_state q s returns the LTS obtained by adding state q to s. Returns s is q is already a state in s

exception Invalid_state of state

val add_transition : (state * label * state) -> t -> t

add_transition (q1,l,q2) s returns the LTS obtained by adding transition from state q1 to state q2, with label l to LTS s. Raises Invalid_state if q1 or q2 are not states of s

val add_itransition : (label * state) -> t -> t

add_itransition (l,q) s returns the LTS obtained by adding initial transition to state q, with label l to LTS s. Raises Invalid_state if q are is not a state of s

val remove_state : state -> t -> t

remove_state q s returns the LTS obtained by removing state q, and all attached transitions, from s. Raises Invalid_state is q is not a state in s

Global iterators

val iter_states : (state -> unit) -> t -> unit

iter_states f s applies function f to all states (with associated attribute) of s

val fold_states : (state -> 'a -> 'a) -> t -> 'a -> 'a

iter_states f s applies function f to all states (with associated attribute) of s

fold_states f s z computes f xN ... (f x2 (f x1 z))..., where x1, ..., xN are all the states of s

val iter_transitions : (transition -> unit) -> t -> unit

fold_states f s z computes f xN ... (f x2 (f x1 z))..., where x1, ..., xN are all the states of s

iter_transitions f s applies function f to all transitions of s

val fold_transitions : (transition -> 'a -> 'a) -> t -> 'a -> 'a

iter_transitions f s applies function f to all transitions of s

fold_transitions f s z computes f xN ... (f x2 (f x1 z))..., where x1, ..., xN are all the transitions of s

val iter_itransitions : (itransition -> unit) -> t -> unit

fold_transitions f s z computes f xN ... (f x2 (f x1 z))..., where x1, ..., xN are all the transitions of s

iter_itransitions f s applies function f to all initial transitions of s

val fold_itransitions : (itransition -> 'a -> 'a) -> t -> 'a -> 'a

iter_itransitions f s applies function f to all initial transitions of s

fold_itransitions f s z computes f xN ... (f x2 (f x1 z))..., where x1, ..., xN are all the initial transitions of s

State iterators

val fold_succs : t -> state -> (state -> label -> 'a -> 'a) -> 'a -> 'a

fold_succs s x f z computes f xN lN ... (f x2 (f x1 l1 z) l2)..., where x1, ..., xN are all the successors of state x in LTS s, and l1, ..., lN the associated transitions labels

val iter_succs : t -> state -> (state -> label -> unit) -> unit

fold_succs s x f z computes f xN lN ... (f x2 (f x1 l1 z) l2)..., where x1, ..., xN are all the successors of state x in LTS s, and l1, ..., lN the associated transitions labels

iter_succs s x f z computes f x1 l1; ... ;f xN lN, where x1, ..., xN are all the successors of state x in LTS s, and l1, ..., lN the associated transitions labels

val fold_preds : t -> state -> (state -> label -> 'a -> 'a) -> 'a -> 'a

iter_succs s x f z computes f x1 l1; ... ;f xN lN, where x1, ..., xN are all the successors of state x in LTS s, and l1, ..., lN the associated transitions labels

fold_preds s x f z computes f xN lN ... (f x2 (f x1 l1 z) l2)..., where x1, ..., xN are all the predecessors of state x in LTS s, and l1, ..., lN the associated transitions labels

val iter_preds : t -> state -> (state -> label -> unit) -> unit

fold_preds s x f z computes f xN lN ... (f x2 (f x1 l1 z) l2)..., where x1, ..., xN are all the predecessors of state x in LTS s, and l1, ..., lN the associated transitions labels

iter_preds s x f z computes f x1 l1; ... ;f xN lN, where x1, ..., xN are all the predecessors of state x in LTS s, and l1, ..., lN the associated transitions labels

Global transformations

val map_label : (label -> label) -> t -> t

map_states f s returns the LTS obtained by replacing each transition label l by f l in s.

val clean : t -> t

Removes unreachable nodes and associated transitions

Output functions

val dot_output : 
  string ->
  ?fname:string ->
  ?options:Utils.Dot.graph_style list ->
  ?marked_states:(state * Utils.Dot.node_style) list ->
  ?extra_nodes:(string * Utils.Dot.node_style) list ->
  ?implicit_transitions:transition list ->
  t ->
  unit

dot_output name s writes a .dot representation of s with name name in file. The name of the file is name.dot or specified with the fname optional argument. With the optional argument append, the description is appended to the specified file. Global graph drawing options can be specified with the options optional argument. States listed with the optional argument marked_states will be drawn with the specified style. Extra nodes, to be added to the generated graph, can be specified with the extra_nodes optional argument. Transitions listed in the implicit_transitions optional argument will not be drawn.

val dot_output_oc : 
  string ->
  out_channel ->
  ?options:Utils.Dot.graph_style list ->
  ?marked_states:(state * Utils.Dot.node_style) list ->
  ?extra_nodes:(string * Utils.Dot.node_style) list ->
  ?implicit_transitions:transition list ->
  t ->
  unit

dot_output_coc name oc s is a variant of dot_output in which the description of s is written to the (previously opened) output channel oc.

val dot_output_execs : 
  string ->
  ?fname:string ->
  ?options:Utils.Dot.graph_style list ->
  int ->
  t ->
  unit

dot_output_execs name depth s writes a .dot representation, with name name of the execution trees obtained by calling unwind depth s. The name of the file is name.dot or specified with the fname optional argument. Drawing options can be specified with the options optional argument.

val tex_output : 
  string ->
  ?fname:string ->
  ?listed_transitions:label list option ->
  t ->
  unit

tex_output name fname s writes a .tex representation of s with name name. The name of the output file is name.dot or specified with the fname optional argument. When the optional argument listed_transitions is Some l, only transitions listed in l are written, otherwise all transitions of s are written.