Usage: pgkyl animate [OPTIONS]
Animate a sequence of frames, one frame per dataset (or dataset group).
Each panel uses its own value range across all frames. Datasets overlaid in a panel
share that range; explicit bounds override the computed limits.
Options:
-u, --use TEXT Select datasets with this tag.
-c, --collected [BOOLEAN] Treat the leading axis of each dataset as time.
[default: False]
-s, --squeeze [BOOLEAN] Draw all components in one panel. [default: False]
--subplots [BOOLEAN] Draw each dataset in a separate block of panels.
[default: False]
-n, --num_subplot_row INTEGER Number of subplot rows.
--num_subplot_col INTEGER Number of subplot columns.
-t, --transpose [BOOLEAN] Transpose the display axes. [default: False]
--contour [BOOLEAN] Draw contours. [default: False]
--clevels TEXT Contour count or start:end:count levels.
-q, --quiver [BOOLEAN] Draw vector arrows. [default: False]
--streamline [BOOLEAN] Draw streamlines. [default: False]
--sdensity FLOAT Streamline density. [default: 1.0]
-a, --arrowstyle TEXT Streamline arrow style.
-g, --group INTEGER Draw lineouts along coordinate 0 or 1.
--scatter [BOOLEAN] Draw point markers without connecting lines.
[default: False]
-m, --markersize FLOAT Marker size in points.
-l, --linewidth FLOAT Line width.
--linestyle TEXT Matplotlib line style.
--color TEXT Line or vector color.
--style TEXT Matplotlib style name or file.
-d, --diverging [BOOLEAN] Use a diverging colormap. [default: False]
--arg TEXT Matplotlib format string, for example ``*--``.
-f, --fixaspect [BOOLEAN] Use equal scaling on the display axes. [default:
False]
--logx [BOOLEAN] Use logarithmic x scaling. [default: False]
--logy [BOOLEAN] Use logarithmic y scaling. [default: False]
--logz [BOOLEAN] Use logarithmic z scaling. [default: False]
-x, --xshift FLOAT X shift, applied before scaling. [default: 0.0]
--xscale FLOAT X scale factor. [default: 1.0]
-y, --yshift FLOAT Y shift, applied before scaling. [default: 0.0]
--yscale FLOAT Y scale factor. [default: 1.0]
-z, --zshift FLOAT Z shift, applied before scaling. [default: 0.0]
--zscale FLOAT Z scale factor. [default: 1.0]
--xmin FLOAT X minimum limit.
--xmax FLOAT X maximum limit.
--ymin FLOAT Y minimum limit.
--ymax FLOAT Y maximum limit.
--zmin FLOAT Z minimum limit.
--zmax FLOAT Z maximum limit.
--xlim <FLOAT FLOAT>... X limits as a pair or comma-separated string;
overrides individual bounds.
--ylim <FLOAT FLOAT>... Y limits as a pair or comma-separated string;
overrides individual bounds.
--zlim <FLOAT FLOAT>... Z limits as a pair or comma-separated string;
overrides individual bounds.
--no_legend [BOOLEAN] Suppress legends. [default: False]
--no_colorbar [BOOLEAN] Suppress colorbars. [default: False]
--forcelegend [BOOLEAN] Show a legend even for one curve. [default: False]
--xlabel TEXT Override the x label.
--ylabel TEXT Override the y label.
--clabel TEXT Override the c label.
--title TEXT Title shown on every frame.
-e, --edgecolors TEXT Mesh cell edge color.
--no_showgrid [BOOLEAN] Suppress grid lines. [default: False]
--hashtag [BOOLEAN] Display the Postgkyl hashtag. [default: False]
--multiblock [BOOLEAN] Force datasets with the same frame index into one
frame. [default: False]
--grouptags [BOOLEAN] Build a separate animation for each dataset tag.
[default: False]
-i, --interval INTEGER live-animation delay between frames, in milliseconds.
[default: 100]
-v, --variable_range [BOOLEAN] Recompute each panel's value/color scale for every
frame instead of holding it constant across the
animation. [default: False]
--cutoffglobalrange FLOAT clip the fixed range to this central percentile band
(see ``_frame_value_range``); ``None`` uses the true
min/max.
--notitle [BOOLEAN] suppress the per-frame frame/time title. [default:
False]
--no_show [BOOLEAN] Do not open a live window (the ``FuncAnimation`` path
only). [default: False]
--save [BOOLEAN] write to ``saveas`` (or ``anim.gif``) after building
the frames. [default: False]
--saveas TEXT output path; its extension selects the writer
(``.gif``/ ``.webp``/``.apng`` via PIL,
``.mp4``/``.mov``/``.avi``/``.mkv`` via ffmpeg).
--fps INTEGER frames per second for the saved movie; defaults from
``interval``.
--codec TEXT Video encoder name, such as libx264 or mpeg4. By
default, prefer software H.264, then MPEG-4. Checked
before frame generation.
--dpi INTEGER resolution for saved frames/movies.
--saveframes TEXT when given, write ``<saveframes>_<i>.png`` for every
frame instead of building a live ``FuncAnimation``.
--figsize <FLOAT FLOAT>... figure size in inches, forwarded to
``matplotlib.plot``.
--nproc INTEGER parallel worker processes for frame generation
(``saveframes``, or the ``tmpdir``-backed compile path
below); ``1`` renders sequentially in-process.
[default: 1]
--tmpdir TEXT directory for the temporary frame directory used when
``nproc`` is greater than 1 and ``saveframes`` is not
given (frames are written there, compiled into the
output, then discarded).
--help Show this message and exit.