tcngf-pf-plot-depth-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-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