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