GopherProxy

	tgranular2img.1: elaborate and improve examples - granular - granular dynamics …
	git clone git://src.adamsgaard.dk/granular
	Log
	Files
	Refs
	README
	LICENSE
	---
	commit 07c37130f357210cd172869bf5bd3168c5eba930
	parent daa1b5a133bea3df774745dbd50f42cd41336c58
	Author: Anders Damsgaard <[email protected]>
	Date: Thu, 22 Apr 2021 21:47:41 +0200

	granular2img.1: elaborate and improve examples

	Diffstat:
	M granular2img.1 \| 40 ++++++++++++++++++++++++++++-…

	1 file changed, 37 insertions(+), 3 deletions(-)
	---
	diff --git a/granular2img.1 b/granular2img.1
	t@@ -15,8 +15,10 @@ The
	.Nm
	utility reads
	.Xr granular 5
	-formatted data and plots grains as an image file, e.g. pdf (default),
	-written to stdout.
	+formatted data and plots grains as an image file, pdf format by default,
	+and writes it to stdout.
	+The common use is to pipe the stdout to a file or a suitable program
	+which accepts the format as stdin.
	.Pp
	The options are as follows:
	.Bl -tag -width Ds
	t@@ -47,20 +49,52 @@ successful exit
	unspecified error
	.El
	.Sh EXAMPLES
	+Read a file (packing.tsv) in
	+.Xr granular 5
	+format and save an image of it in pdf format:
	+.Pp
	+.Dl $ granular2img < packing.tsv > out.pdf
	+.Pp
	+Read output from
	+.Xr granularpacking 1
	+and plot it and save the result as a PNG file:
	+.Pp
	.Dl $ granularpacking \| granular2img -t png > out.png
	.Pp
	+Color the grains according to the second field in the
	+.Xr granular 5
	+format, which is x position, set a suitable colorbar label, and open it
	+directly in the PDF viewer
	+.Xr zathura 1 :
	+.Pp
	.Bd -literal -offset indent
	$ granularpacking \| granular2img -f '$2' -l 'x pos. [m]' \\
	\| zathura -
	.Ed
	+.Pp
	+Same as the previous example, but color grains according to the product
	+of x and y position:
	+.Pp
	.Bd -literal -offset indent
	$ granularpacking \| granular2img -f '$2$3' -l 'xy pos. [m]' \\
	\| zathura -
	.Ed
	.Pp
	-.Dl $ granular2img < packing.tsv > out.pdf
	+Loop over all output files from
	+.Xr granular 1
	+simulation "test", save them as images, and combine them into a video
	+animation:
	+.Pp
	+.Bd -literal -offset indent
	+$ for f in test.grain.*.tsv; do \\
	+ granular2img -t png < "$f" > "${f%.tsv}.png"; \\
	+ done && \\
	+ ffmpeg -i test.grain.%05d.png \\
	+ -c:v libx264 -vf fps=10 -pix_fmt yuv420p test.mp4
	+.Ed
	.Sh SEE ALSO
	.Xr awk 1 ,
	+.Xr ffmpeg 1 ,
	.Xr gnuplot 1 ,
	.Xr granular2vtu 1 ,
	.Xr granular 5