ktzio(n)							      ktzio(n)



1mNAME0m
       ktzio  -	conversion tool	for transition systems

       Part  of	 Tina  Toolbox	for analysis of	Petri nets and Time Petri nets
       (see also nd, tina, plan, struct, ndrio,	selt).


1mSYNOPSIS0m
       1mktzio 22m[-4mh24melp] [-sp n] [-tp n] [-wp n] [-g] [-tina | -fw] -i file]

       1mktzio 22m[-4mh24melp] [-KTZ | -BCG | -AUT]
	     [-4mk24mtz	| -bcg |-4ma24mut | -mec | -l |	-v | -q]
	     [-sp n] [-tp n] [-wp n] [-g] [-tina | -fw]	[-bf | -df]
	     [infile] [outfile]	[errorfile]


1mDESCRIPTION0m
       ktzio converts kripke transition	systems	between	several	formats.

       The formats manipulated are the following:

       name	 file ext  description
       ------------------------------------------------------
       ktz	 .ktz	   tina	compact	binary format
       bcg	 .bcg	   CADP	compact	binary format
       aut	 .aut	   CADP	aldebaran format
       mec	 .mec	   Mec4	model checker format
       textual	 .txt	   textual descriptions, explained below

       The conversions currently supported are the following:

       from	 to
       ------------------------------------------------------
       ktz	 ktz, aut, mec,	bcg, textual
       bcg	 ktz, textual
       aut	 ktz, textual


1mOPTIONS0m
       -4mh24melp Recalls options.


       1mInteractive mode:0m


       -i infile
	      Reads a kts from infile and prints its  contents	interactively,
	      as a list	of state descriptions.


       1mInput format flags:0m


       -KTZ | -BCG | -AUT
	      Specifies	  the  format	of the	input transition  system. This
	      flag is necessary	when the input transition  system is  read  on
	      standard	input,	or  read  from	a  file	that does not bear the
	      expected extension. Default is -KTZ.


       1mOutput	format flags:0m


       -ktz | -bcg | -aut | -mec | -l |	-v | -q
	      Specifies	the  format of	the output  transition	 system.  This
	      flag  is necessary  when the output  transition system  is writ-
	      ten  on standard output,	 or   in  a   file   that   does   not
	      bear    the   expected extension.	 Flags -l, -v, -q produce tex-
	      tual descriptions, as follows. Default is	-l.
	      -l : ktzio -i style output (default)
	      -v : tina	-v style output	(only from ktz)
	      -q : tina	-q style output	(only from ktz)


       1mTransition system generation options (see the tina page):0m


       -sp n  For ktz to ktz/aut/mec/bcg  conversions.	 Encoding   of	 state
	      properties  in  output  transition  system  (when	information is
	      present in the input system).
	      -sp 0 : no state properties (default for .aut, .bcg)
	      -sp 1 : boolean state properties (default	for .mec)
	      -sp 2 : weighted state properties	(default for .ktz)
	      -sp 3 : weighted state properties	for all	weights


       -tp n  For ktz to ktz/aut/mec/bcg conversions.  Encoding	of  transition
	      properties   in  output  transition  system (when	information is
	      present in the input system):
	      -tp 0 : no transition properties
	      -tp 1 : boolean transition properties (default for all formats)
	      -tp 2 : weighted transition properties (default for .ktz)
	      -tp 3 : weighted transition properties for all weights


       -wp n  For ktz to ktz/aut/mec/bcg conversions.  Encoding	of wait	 prop-
	      erties in	output transition  system (when	information is present
	      in the input system):
	      -wp 0 : no wait properties (default for .aut, .bcg, .mec)
	      -wp 1 : preserve wait properties (default	for .ktz)


       -g     For ktz to ktz  conversions.  Removes  liveness  information  if
	      present.


       -tina  For  .aut	 or  .bcg input. Decodes properties assuming they were
	      encoded by tina. E.g. if the .aut	file  was  generated  by  tina
	      with  flag  -sp  2, restores the state properties	encoded	in the
	      file. If the input file was not  generated  by  tina,  then  the
	      behavior is undefined.


       -fw    This  flag  is  necessary	 to  convert older ktz files capturing
	      unbounded	property values	(such as those resulting from tina -C)
	      into  crrent  ktz.   If  omitted	and the	file actually contains
	      unbounded	values,	then the conversion will fail.


       -df | -bf
	      Tune up flag for bcg to ktz conversions. Default is -df.


       1mInput source:0m


       infile Where the	 kts is	 read. The  input  format  is	determined  by
	      the file type, according to the table above. If absent or	speci-
	      fied by "-", the kts is  read on standard	 input in the	format
	      specified	 by   the  input  flag.	 If  both an  infile and  some
	      input flag  are present,	then the format	defined	 by the	 input
	      flag supersedes  that determined	by the infile extension.


       1mOutput	destination:0m


       outfile
	      Where  results  are  written. The	output format is determined by
	      the file type, according	to the	table  above.  If   absent  or
	      specified	  by  "-", then	results	are written on standard	output
	      in the format specified by the output flag. If both an   outfile
	      and  some	 output	 flag  are present, then the format defined by
	      the output flag supersedes that determined by the	outfile	exten-
	      sion.


       1mErrors	destination:0m


       errorfile
	      Where error messages are written.	By default, errors are printed
	      on standard error.



1mFILES0m
       Files aut.txt, bcg.txt,	mec.txt,   ktz.txt  in	directory  doc/formats
       specify	the  syntax  of	 .aut,	.bcg,  .mec and	.ktz transition	system
       description files, respectively.



1mEXAMPLES0m
       ktzio -i	abp.ktz
       ktzio -v	abp.ktz
       ktzio abp.ktz abp.aut
       ktzio -AUT - abp.ktz < abp.aut
       ktzio -AUT -ktz < abp.aut > abp.ktz
       ktzio abp.bcg -ktz | ktzio -KTZ - abp.aut

       Note: not all targets support  binary data on standard input or output.


1mSEE ALSO0m
       nd, tina, plan, struct, ndrio, selt


1mAUTHORS0m
       Bernard Berthomieu, LAAS/CNRS, 2000-2010, Bernard.Berthomieu@laas.fr.




Tina Tools			Version	2.9.10			      ktzio(n)
