.\" .de Id .. .de Sp .if n .sp .if t .sp 0.4 .. .TH iorheo 8rheolef "rheolef-7.0" "rheolef-7.0" "rheolef-7.0" .\" label: /*Class:iorheo .SH NAME \fBiorheo\fP - input and output functions and manipulation .\" skip: @cindex graphic render .\" skip: @clindex iorheo .\" skip: @clindex csr .\" skip: @clindex geo .\" skip: @clindex field .\" skip: @fiindex @file{.geo} mesh .\" skip: @fiindex @file{.hb} Harwell-Boeing matrix .\" skip: @fiindex @file{.mm} Matrix-Market matrix .\" skip: @fiindex @file{.field} field .\" skip: @fiindex @file{.tcl} tool command language .\" skip: @fiindex @file{.vtk} visualization toolkit .\" skip: @fiindex @file{.off} geomview data .\" skip: @fiindex @file{.plot} gnuplot script .\" skip: @fiindex @file{.gdat} gnuplot data .\" skip: @fiindex @file{.mtv} plotmtv .\" skip: @fiindex @file{.x3d} x3d mesh .\" skip: @fiindex @file{.atom} PlotM mesh .\" skip: @toindex @code{gnuplot} .\" skip: @toindex @code{plotmtv} .\" skip: @toindex @code{vtk} .\" skip: @toindex @code{geomview} .\" skip: @toindex @code{PlotM} .SH SMALL PIECES OF CODE input geo in standard file format: .\" begin_example .Sp .nf cin >> g; .Sp .fi .\" end_example output geo in standard file format: .\" begin_example .Sp .nf cout << g; .Sp .fi .\" end_example output geo in gnuplot format: .\" begin_example .Sp .nf cout << gnuplot << g; .Sp .fi .\" end_example .PP .SH DESCRIPTION output manipulators enable the selection of some pretty graphic options, in an elegant fashion. .PP .SH BOOLEAN MANIPULATORS The boolean manipulators set an internal optional flag. Each option has its negative counterpart, as \fBverbose\fP and \fBnoverbose\fP, by adding the \fBno\fP prefix. .\" begin_example .Sp .nf cout << noverbose << a; .Sp .fi .\" end_example .\" begin table .\" start item .TP .B verbose trace some details, such as loading, storing or unix command operations on \fBcerr\fP. Default is on. .\" start item .TP .B clean delete temporary files during graphic outputs. Default is on. .\" start item .TP .B execute run unix operations, such as \fBgnuplot\fP or \fBplotmtv\fP or \fBvtk\fP. Note that the corresponding files are created. Default is on. .\" start item .TP .B transpose perform transposition when loading/soring a \fBcsr\fP matrix from Harwell-Boeing file. This feature is available, since the file format store matrix in transposed format. Default is off. .\" start item .TP .B logscale when using matrix sparse postscript plot manipulator \fBps\fP and \fBcolor\fP. The color scale is related to a logarithmic scale. .\" start item .TP .B fill .\" start item .TP .B grid .\" start item .TP .B shrink .\" start item .TP .B tube .\" start item .TP .B ball .\" start item .TP .B full .\" start item .TP .B stereo .\" start item .TP .B cut .\" start item .TP .B iso .\" start item .TP .B split when using the \fBvtk\fP or \fBmayavi\fP manipulators for a mesh or a field. .\" start item .TP .B volume volume rendering by using ray cast functions. .\" skip: @cindex velocity .\" skip: @cindex deformation .\" start item .TP .B velocity .\" start item .TP .B deformation Vector-valued fields are rendered by using arrows (\fBvelocity\fP) or deformed meshes (\fBdeformation\fP). For \fBvtk\fP or \fBplotmtv\fP rendering. .\" skip: @cindex elevation .\" start item .TP .B elevation Scalar valued fields in two dimension are rendered by using a tridimensionnal surface elevation. For \fBvtk\fP or \fBplotmtv\fP rendering. .\" end table .PP .\" skip: @findex fastfieldload .\" begin table .\" start item .TP .B fastfieldload try to reuse the supplied space. Default is on. .\" end table .PP .SH FILE FORMAT MANIPULATORS .\" skip: @fiindex @file{.bamg} bamg mesh .\" skip: @fiindex @file{.mesh} mmg3d mesh .\" skip: @fiindex @file{.node} tetgen mesh nodes .\" skip: @fiindex @file{.ele} tetgen mesh elements .\" skip: @fiindex @file{.face} tetgen mesh boundary faces .\" skip: @fiindex @file{.v} grummp tridimensionnal mesh .\" skip: @fiindex @file{.m} grummp bidimensionnal mesh .\" skip: @fiindex @file{.gmsh} gmsh mesh .\" skip: @fiindex @file{.gmsh_pos} gmsh metric mesh .\" skip: @fiindex @file{.hb} Harwell-Boeing matrix .\" skip: @fiindex @file{.geo} mesh .\" skip: @fiindex @file{.field} field .\" skip: @fiindex @file{.m} matlab matrix .\" skip: @fiindex @file{.ps} postscript .\" skip: @fiindex @file{.vtk} visualization toolkit .\" skip: @fiindex @file{.plot} gnuplot script .\" skip: @fiindex @file{.mtv} plotmtv .\" skip: @fiindex @file{.x3d} x3d mesh .\" skip: @fiindex @file{.atom} PlotM mesh .\" skip: @toindex @code{vtk} .\" skip: @toindex @code{gnuplot} .\" skip: @toindex @code{plotmtv} .\" skip: @toindex @code{x3d} .\" skip: @toindex @code{PlotM} .\" skip: @toindex @code{bamg} .\" skip: @toindex @code{mmg3d} .\" skip: @toindex @code{tetgen} .PP The \fIformat\fP manipulator group applies for streams. Its value is an enumerated type, containing the following possibilities: .\" begin table .\" start item .TP .B rheo use the default textual input/output file format. For instance, this is `\fB.geo'\fP for meshes, `\fB.field'\fP for discretized functions. This default format is specified in the corresponding class documentation (see also geo(2) and field(2)). This is the default. .\" start item .TP .B bamg uses `\fB.bamg'\fP Frederic Hecht's bidimensional anisotropic mesh generator file format for geo input/output operation. .\" start item .TP .B tetgen uses `\fB.node'\fP `\fB.ele'\fP and \fB.face\fP Hang Si's tridimensional mesh generator file format for geo input/output operation. .\" start item .TP .B mmg3d uses `\fB.mmg3d'\fP Cecile Dobrzynski's tridimensional anisotropic mesh generator file format for geo input/output operation. .\" start item .TP .B gmsh uses `\fB.gmsh'\fP gmsh Christophe Geuzaine and Jean-Francois Remacle mesh generator file format for geo input/output operation. .\" start item .TP .B gmsh_pos uses `\fB.gmsh_pos'\fP gmsh Christophe Geuzaine and Jean-Francois Remacle mesh metric file format for geo adapt input/output operation. .\" start item .TP .B grummp uses `\fB.m'\fP (bidimensional) or `\fB.v'\fP (tridimensionnal) Carl Ollivier-Gooch 's mesh generator file format for geo input/output operation. .\" start item .TP .B qmg uses `\fB.qmg'\fP Stephen A. Vavasis's mesh generator file format for geo input/output operation. .\" start item .TP .B vtkdata uses `\fB.vtk'\fP mesh file format for geo input/output operations. This file format is suitable for graphic treatment. .\" start item .TP .B vtkpolydata uses `\fB.vtk'\fP polydata (specific for polygonal boundaries) mesh file format for geo input/output operations. This file format is suitable for graphic treatment. .\" skip: @fiindex @file{.cemagref} cemagref topographic mesh .\" skip: @cindex @code{cemagref} topographic mesh .\" skip: @cindex topography .\" start item .TP .B cemagref uses `\fB.cemagref'\fP surface mesh (topography, with a \fBz\fP cote). This file format is used at Cemagref (french research center for mountains, \fBhttp://www.cemagref.fr\fP). .\" start item .TP .B dump output an extensive listing of the class data structure. This option is used for debugging purpose. .\" start item .TP .B hb uses `\fB.hb'\fP Harwell-Boeing file format for sparse matrix input/output operation. This is the default. .\" start item .TP .B matrix_market uses `\fB.mm'\fP Matrix-Market file format for sparse matrix input/output operation. .\" start item .TP .B ml .\" start item .TP .B matlab uses `\fB.m'\fP Matlab file format for sparse matrix output operation. .\" start item .TP .B sparse_matlab uses `\fB.m'\fP Matlab sparse file format for sparse matrix output operation. .\" start item .TP .B ps uses `\fB.ps'\fP postscript for sparse matrix output operation. .\" start item .TP .B vtk for mesh and field outputs. Generate `\fB.vtk'\fP data file and the `\fB.tcl'\fP command script file and run the \fBvtk\fP command on the `\fB.tcl'\fP. .\" skip: @fiindex @file{.py} python script file (for mayavi visualization tool) .\" skip: @toindex @code{mayavi} .\" start item .TP .B mayavi for field outputs. Generate `\fB.vtk'\fP data file and the `\fB.py'\fP command script file and run the \fBpython\fP command on the `\fB.py'\fP associated to the \fBmayavi\fP/\fBvtk\fP library. .\" start item .TP .B geomview for boundary cad outputs. Generate `\fB.off'\fP data file and run the \fBgeomview\fP command. .\" start item .TP .B gnuplot for mesh and field outputs. Generate `\fB.gdat'\fP data file and the `\fB.plot'\fP command script file and run the \fBgnuplot\fP command on the `\fB.plot'\fP. .\" start item .TP .B plotmtv for mesh and field outputs. Generate `\fB.mtv'\fP data file and run the \fBplotmtv\fP command. .\" start item .TP .B x3d for mesh output. Generate `\fB.x3d'\fP data file and run the \fBx3d\fP command. This tool has fast rotation rendering. .\" start item .TP .B atom for mesh output. Generate `\fB.atom'\fP data file and run the \fBPlotM\fP command. Tridimensional mesh rendering is performed as a chemical molecule: nodes as balls and edges as tubes. The \fBPlotM\fP tool is developed at Cornell University Laboratory of Atomic and Solid State Physics (LASSP) in a Joint Study with IBM, with support by the Materials Science Center and Corning Glassworks. .\" end table .SH COLOR MANIPULATORS The \fIcolor\fP manipulator group acts for sparse matrix postscript output. Its value is an enumerated type, containing three possibilities: .\" begin_example .Sp .nf cout << color << a; cout << gray << b; cout << black_and_white << c; .Sp .fi .\" end_example The default is to generate a color postcript file. Conversely, its act for field rendering, via \fBmayavi\fP. .PP .SH VALUATED MANIPULATORS .\" skip: @pindex mfield Some manipulators takes an argument that specifies a value. .\" begin_example .Sp .nf cout << geomview << bezieradapt << subdivide(5) << my_cad_boundary; cout << vtk << iso << isovalue(2.5) << my_mesh; cout << velocity << plotmtv << vectorscale(0.1) << uh; .Sp .fi .\" end_example .\" skip: @clindex catchmark See also catchmark(4) for input-output of vector-valued fields. .\" begin table .\" start item .TP .B isovalue \fIfloat\fP .\" start item .TP .B n_isovalue \fIint\fP .\" start item .TP .B n_isovalue_negative \fIint\fP .\" start item .TP .B vectorscale \fIfloat\fP .\" start item .TP .B subdivide \fIfloat\fP .\" start item .TP .B rounding_precision \fIfloat\fP This manipulator set a rounding precision that could be used by some output functions, e.g. by the \fBgeo\fP class. By default, the rounding value is zero and there is no rounding. .\" skip: @cindex image file format .\" skip: @cindex graphic render .\" skip: @fiindex @file{.png} image .\" skip: @fiindex @file{.jpg} image .\" skip: @fiindex @file{.pdf} image .\" start item .TP .B image_format \fIstring\fP The argument is any valid image format, such as \fBpng\fP, \fBjpg\fP or \fBpdf\fP, that could be handled by the corresponding graphic render. .\" end table .\" END .\" LENGTH = 3 .SH SEE ALSO geo(2), field(2), catchmark(4) .SH COPYRIGHT Copyright (C) 2000-2018 Pierre Saramito 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.