struct(n)							     struct(n)



1mNAME0m
       struct -	Structural analysis tool

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


1mSYNOPSIS0m
       1mstruct	22m[-4mh24melp]
	      [-S | -F]	[-I | -Q] [-P |	-T] [-mp] [-4ti2]
	      [-NET | -NDR | -PNML | -TPN | -TTS] [-v |	-q]
	      [infile] [outfile] [errorfile]



1mDESCRIPTION0m
       struct computes	generator sets for  semiflows, or bases	of  flows,  on
       places  and transitions.	 It takes  as input descriptions of a Priority
       Time  Petri  net	 in  textual  form (.net,  .pnml,  .tpn	 formats)   or
       graphical   form	(.ndr  format  of  files produced  by  nd, .pnml  with
       graphics), or a Time Transition System description in .tts format.



1mOPTIONS0m
       -4mh24melp Recalls options.


       1mOperating mode	options:0m


       -P | -T
	      Computes semiflows or flows for places only (-P) or  transitions
	      only (-T).  In absence of	either flag, computes them for both.


       -S | -F
	      Computes semiflow	generator sets (-S) or flow bases (-F).	If -S,
	      also computes the	invariant and consistent properties.


       -I | -Q
	      Computes	semiflow   (resp.  flow	   bases)   such   that	   any
	      semiflow	(resp.	flow)	is a  linear combination with  integer
	      (-I)  or rational	(-Q) coefficients of those in basis  (nongena-
	      tive if -S, in addition).


       -mp    Use  arbitrary precision arithmetics when	-Q passed (struct will
	      tell you if needed).


       -4ti2  Use the 4ti2 tool	(www.4ti2.de) rather than  the	built-in  code
	      when -I passed.  This option requires to compile and install the
	      4ti2 tool	on your	machine.   4ti2	 is  significantly  faster  on
	      large nets.


       1mOutput	format selection :0m


       -v     textual output, prints full results.


       -q     textual output, prints a summary of results.


       1mInput format flags:0m


       -NET | -NDR | -PNML | -TPN | -TTS
	      Specifies	 the  format  of the input net.	This flag is necessary
	      when the input net is read on standard input,  or	 read  from  a
	      file  that does not bear the expected extension. By default, the
	      net is assumed in	.net or


       1mInput source:0m


       infile Where the	 net is	 read. The  input  format  is	determined  by
	      the file type, according to the table below. If absent or	speci-
	      fied by "-", the net 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.

	      file extension	  input	format
	      --------------------------------------------------------------
	       .net		  net format
	       .ndr		  ndr format
	       .tpn		  tpn format
	       .pnml		  pnml format
	       .tts		  tts format


       1mOutput	destination:0m


       outfile
	      Where  results are  written.   If	 absent	or  specified  by "-",
	      then results are written on standard output.



       1mErrors	destination:0m


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



       1mDefault options are :0m

	      struct -t	0 -v -S	-Q



1mFILES0m
       Files   net.txt,	 ndr.txt,   tpn.txt,  tts.txt,	TPN.rng	 in  directory
       doc/formats specify the syntax of .net, .ndr, .tpn, .tts	and .pnml  net
       description files, respectively.



1mEXAMPLES0m
       struct <	nets/ifip.ndr >	ifip.struct
       struct -q nets/ifip.ndr ifip.struct



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


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




Tina Tools			Version	2.9.10			     struct(n)
