Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
gout(1)			     Scotch user's manual		       gout(1)

NAME
       gout - output graphics from matrices and	graphs

SYNOPSIS
       gout [options] [gfile] [xfile] [mfile] [vfile]

DESCRIPTION
       The  gout program creates graphics files	of various types, representing
       the Scotch graph	and mapping data which is passed to it.

       Source graph file gfile can only	be  a  centralized  graph  file.  File
       xfile  stores  its  associated geometry,	whenever necessary. File mfile
       represents label	information attached to	each of	 the  graph  vertices,
       for  instance the index of the part to which each vertex	belongs	in the
       case of a mapping file. File vfile is the  output  graphics  file,  the
       type  of	 which may differ according to the input parameters. When file
       names are not specified,	data is	read from standard input  and  written
       to standard output. Standard streams can	also be	explicitly represented
       by a dash '-'.

       When the	proper libraries have been included at compile time, gtst  can
       directly	 handle	 compressed graphs, both as input and output. A	stream
       is treated as compressed	whenever its name is  postfixed	 with  a  com-
       pressed	file  extension, such as in 'brol.grf.bz2' or '-.gz'. The com-
       pression	formats	which can be supported are the bzip2 format  ('.bz2'),
       the gzip	format ('.gz'),	and the	lzma format ('.lzma', on input only).

OPTIONS
       -h     Display some help.

       -ggeop Geometry	parameters,  which  can	be an arbitrary	combination of
	      any of the following code	letters:

	      n	     Do	not read geometry data,	when it	is  not	 available  or
		     not required, such	as when	using the -om option.

	      p	     Permute Y and Z geometry dimensions.

	      r	     Rotate geometry by	90 degrees in the (X,Y)	plane.

       -h     Display some help.

       -mn    Do  not  read  mapping data, when	it is not available or not re-
	      quired.

       -ooutp Select the output	file type and allows to	provide	additional pa-
	      rameters between braces and separated by commas:

	      i	     OpenInventor  3D mesh file, to be viewed by means of pro-
		     grams such	as ivview. Additional parameters for this out-
		     put file type are:

		     c	    Color output.

		     g	    Gray level output.

		     r	    Remove cut edges.

		     v	    View cut edges.

	      m	     PostScript	matrix pattern file. Additional	parameters for
		     this output file type are:

		     e	    EPSF-type output.

		     f	    Full-page output.

	      p	     PostScript	2D mesh	file. This output module was  intended
		     for  2D  meshes;  as a fallback, the Z coordinate is pro-
		     jected according  to  isometric  perspective  rules,  but
		     drawings of full 3D objects are most likely to be unread-
		     able. Additional parameters for  this  output  file  type
		     are:

		     c	    Color output.

		     g	    Gray level output.

		     e	    EPSF-type output.

		     f	    Full-page output.

		     s	    Short clipping (disks excluded).

		     l	    Large clipping (disks included).

		     a	    Avoid displaying disks.

		     d	    Display disks.

		     r	    Remove cut edges.

		     v	    View cut edges.

		     X=rat  Maximum x clipping ratio (in [0.0;1.0]).

		     x=rat  Minimum x clipping ratio.

		     Y=rat  Maximum y clipping ratio.

		     y=rat  Minimum y clipping ratio.

	      t	     Tulip 3D mesh file. Additional parameters for this	output
		     file type are:

		     b	    Black and white output.

		     c	    Color output.

		     a	    Avoid displaying disks.

		     d	    Display disks.

		     r	    Remove cut edges.

		     v	    View cut edges.

       -V     Display program version and copyright.

EXAMPLES
       Build an	OpenInventor file of the mapping of graph  brol.grf  contained
       in file brol.map. Vertices with no mapping information attached to them
       will be rendered	in white, while	distinct colors	will be	used to	repre-
       sent the	different parts. Cut edges will	be removed:

	   $ gout '-oi{r}' brol.grf brol.xyz brol.map brol.iv
	   $ ivview brol.iv

       Build  an OpenInventor file of graph brol.grf without any vertex	infor-
       mation associated to it.	Mapping	data are not required and will not  be
       read, but a file	name has to be provided, hence the

	   $ gout -oi -mn brol.grf brol.xyz - brol.iv

       Output  the pattern of matrix brol.grf on the form of a PostScript flat
       drawing.	Geometry and mapping data are not required  and	 will  not  be
       read, but file names have to be provided, hence the two '-'s:

	   $ gout -om -gn -mn brol.grf - - brol.ps

       Output a	PostScript 2D drawing of a rectangular portion graph brol.grf,
       with disks representing mapping data:

	   $ gout '-op{c,e,d,x=0.3,X=0.6,y=0.2,Y=0.5}' brol.grf	brol.xyz brol.map brol.ps

SEE ALSO
       gmap(1),	gout(1), gtst(1).

       Scotch user's manual.

AUTHOR
       Francois	Pellegrini <francois.pellegrini@labri.fr>

				August 03, 2010			       gout(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=gout&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help