GopherProxy

	tcngf-pf-plot-point-evol.1 - cngf-pf - continuum model for granular flows with …
	git clone git://src.adamsgaard.dk/cngf-pf
	Log
	Files
	Refs
	README
	LICENSE
	---
	tcngf-pf-plot-point-evol.1 (2689B)
	---
	1 .Dd $Mdocdate$
	2 .Dt CNGF-PF-PLOT-POINT-EVOL 1
	3 .Os
	4 .Sh NAME
	5 .Nm cngf-pf-plot-point-evol
	6 .Nd plot evolution of a model point
	7 .Sh SYNOPSIS
	8 .Nm
	9 .Op Fl h
	10 .Op Fl f Ar field
	11 .Op Fl l Ar label
	12 .Op Fl p Ar point
	13 .Op Fl t Ar term
	14 .Ar
	15 .Sh DESCRIPTION
	16 This tool is intended to process output files from
	17 .Xr cngf-pf 1 ,
	18 and visualizes the evolution of a model parameter across output files
	19 using
	20 .Xr gnuplot 1 .
	21 The standard output is raw file data, so either redirect to a viewer
	22 program that accepts files as standard input streams, or save to disk.
	23 The output plot has file number as the horizontal axis, and plots the
	24 specified
	25 .Ar field
	26 values of model
	27 .Ar point
	28 as the vertical axis.
	29 .Pp
	30 For publication-quality figures, it is recommended to adapt the
	31 .Nm
	32 script to own purposes.
	33 .Pp
	34 The arguments are as follows:
	35 .Bl -tag -width Ds
	36 .It Fl f Ar field
	37 Plot the specified
	38 .Ar field
	39 number in the input files.
	40 See the
	41 .Sx OUTPUT FORMAT
	42 section in
	43 .Xr cngf-pf 1
	44 for information on what field numbers correspond to which model paramete…
	45 The value
	46 .Ar field
	47 must be a positive number.
	48 Default: 2 (shear velocity).
	49 .It Fl h
	50 Show usage information.
	51 .It Fl l Ar label
	52 Print this value as the vertical axis label.
	53 Default: "shear velocity [m/s]".
	54 .It Fl p Ar point
	55 Select the n-th
	56 .Ar point
	57 in the model domain.
	58 The value
	59 .Ar point
	60 must be a non-zero positive or negative number.
	61 Positive numbers correspond to the n'th model point counted from the base
	62 (-z).
	63 Negative numbers correspond to the n'th model point counted from the top
	64 (+z).
	65 Default: -1 (top point).
	66 .It Fl t Ar term
	67 Specify the
	68 .Xr gnuplot 1
	69 output terminal type and corresponding output file format.
	70 Write
	71 .Ql set term
	72 in
	73 .Xr gnuplot 1
	74 to see a complete listing of output terminals available on the system.
	75 Default: "pdf".
	76 .It Ar
	77 A list of paths to files generated by
	78 .Xr cngf-pf 1 .
	79 .El
	80 .Sh EXAMPLES
	81 Generate some
	82 .Xr cngf-pf 1
	83 output files with a daily change in fluid pressure for subsequent
	84 plotting:
	85 .Pp
	86 .Dl $ cngf-pf -F 50e3 -a 40e3 -q 1.16e-5 -I 3600 -e 345600 sim
	87 .Pp
	88 This generates many output files with the
	89 .Ql sim
	90 prefix.
	91 To plot the shear velocity of the uppermost model point over time,
	92 and save the output to a file:
	93 .Pp
	94 .Dl $ cngf-pf-plot-point-evol sim.output*.txt > shear-vel.pdf
	95 .Pp
	96 Or to view the output directly in the pdf viewer
	97 .Xr zathura 1 :
	98 .Pp
	99 .Dl $ cngf-pf-plot-point-evol sim.output*.txt \| zathura -
	100 .Pp
	101 Plot the fluid pressure at the 10th model point from the bottom:
	102 .Pp
	103 .Dl $ cngf-pf-plot-point-evol -f 4 -l 'Fluid pressure [Pa]' -p 10 sim.ou…
	104 .Sh SEE ALSO
	105 .Xr cngf-pf 1 ,
	106 .Xr cngf-pf-plot-depth-evol 1 ,
	107 .Xr gnuplot 1
	108 .Sh AUTHORS
	109 .An Anders Damsgaard Aq Mt [email protected]