tcngf-pf-plot-point-evol.1 - cngf-pf - continuum model for granular flows with pore-pressure dynamics (renamed from 1d_fd_simple_shear)
(HTM) git clone git://src.adamsgaard.dk/cngf-pf
(DIR) Log
(DIR) Files
(DIR) Refs
(DIR) README
(DIR) 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 parameter.
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.output*.txt > fluid-pressure.pdf
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 anders@adamsgaard.dk