Scroll to navigation

SFEPY-VIEW(1) SfePy SFEPY-VIEW(1)

NAME

sfepy-view - View SfePy meshes or results of SfePy calculations

SYNOPSIS

[–fields-map map [map …]] [-s step] [-l] [-i ISOSURFACES] [-e] [-w field] [–factor factor] [–opacity opacity] [–color-map cmap] [–axes-options options [options …]] [–no-axes] [–grid-vector1 grid_vector1] [–grid-vector2 grid_vector2] [–max-plots MAX_PLOTS] [–no-labels] [–label-position position] [–no-scalar-bars] [–scalar-bar-size size] [–scalar-bar-position position] [-v position] [–camera-position camera_position] [–window-size window_size] [-a output_file] [-r rate] [-o output_file] [–off-screen] [-2] filenames [filenames …]

DESCRIPTION

This is a script for quick VTK-based visualizations of finite element computations results.

In the examples below it is supposed that sfepy is installed. When using the in-place build, replace sfepy-view by python3 sfepy/scripts/resview.py.

Examples

The examples assume that python -c "import sfepy; sfepy.test('--output-dir=output-tests')" has been run successfully and the resulting data files are present.

•
View data in output-tests/test_navier_stokes.vtk:

sfepy-view output-tests/navier_stokes-navier_stokes.vtk


•
Customize the above output: plot0: field “p”, switch on edges, plot1: field “u”, surface with opacity 0.4, glyphs scaled by factor 2e-2:

sfepy-view output-tests/navier_stokes-navier_stokes.vtk -f p:e:p0 u:o.4:p1 u:g:f2e-2:p1


•
As above, but glyphs are scaled by the factor determined automatically as 20% of the minimum bounding box size:

sfepy-view output-tests/navier_stokes-navier_stokes.vtk -f p:e:p0 u:o.4:p1 u:g:f10%:p1


•
View data and take a screenshot:

sfepy-view output-tests/diffusion-poisson.vtk -o image.png


•
Take a screenshot without a window popping up:

sfepy-view output-tests/diffusion-poisson.vtk -o image.png --off-screen


•
Create animation from output-tests/diffusion-time_poisson.*.vtk:

sfepy-view output-tests/diffusion-time_poisson.*.vtk -a mov.mp4


•
Create animation from output-tests/test_hyperelastic.*.vtk, set frame rate to 3, plot displacements and mooney_rivlin_stress:

sfepy-view output-tests/test_hyperelastic_TL.*.vtk -f u:wu:e:p0 mooney_rivlin_stress:p1 -a mov.mp4 -r 3



POSITIONAL ARGUMENTS

filenames             results/mesh files

OPTIONAL ARGUMENTS

show this help message and exit

fields to plot, options separated by “:” are possible: “cX” - plot only Xth field component; “e” - print edges; “fX” - scale factor for warp/glyphs, see –factor option; “g - glyphs (for vector fields only), scale by factor; “iX” - plot X isosurfaces; “tX” - plot X streamlines, gradient employed for scalar fields; “mX” - plot cells with mat_id=X; “oX” - set opacity to X; “pX” - plot in slot X; “r” - recalculate cell data to point data; “sX” - plot data in step X; “vX” - plotting style: s=surface, w=wireframe, p=points; “wX” - warp mesh by vector field X, scale by factor
–fields-map map [map …]
map fields and cell groups, e.g. 1:u1,p1 2:u2,p2



select data in a given time step
plot mesh outline
plot isosurfaces [default: 0]
plot cell edges
warp mesh by vector field
scaling factor for mesh warp and glyphs. Append “%” to scale relatively to the minimum bounding box size.
set opacity [default: 1.0]
set color_map, e.g. hot, cool, bone, etc. [default: viridis]

–axes-options options [options …]
options for directional axes, e.g. xlabel=”z1” ylabel=”z2”, zlabel=”z3”

hide orientation axes
define positions of plots along grid axis 1 [default: “0, 0, 1.6”]
define positions of plots along grid axis 2 [default: “0, 1.6, 0”]
maximum number of plots along grid axis 1 [default: 4]
hide plot labels
define position of plot labels [default: “-1, -1, 0, 0.2”]
hide scalar bars
define size of scalar bars [default: “0.15, 0.05”]
define position of scalar bars [default: “0.8, 0.02, 0, 1.5”]
camera azimuth, elevation angles, and optionally zoom factor [default: “225,75,0.9”]
define camera position
define size of plotting window
create animation, mp4 file type supported
set framerate for animation
save screenshot to file
off screen plots, e.g. when screenshotting
-2, --2d-view
2d view of XY plane

Author

SfePy developers

Copyright

2020, Robert Cimrman and SfePy developers

December 31, 2025 version: 2025.4