cngf-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