Merge branch 'master' into 'master'

dxt_analyzer

See merge request !16

darshan-util/Makefile.in

@@ -144,6 +144,7 @@ install:: all
 	install -m 755 darshan-dxt-parser $(bindir)
 	install -m 755 darshan-merge $(bindir)
 	install -m 755 $(srcdir)/darshan-summary-per-file.sh $(bindir)
+	install -m 755 dxt_analyzer.py $(bindir)
 	install -m 755 libdarshan-util.a $(libdir)
 ifeq ($(DARSHAN_ENABLE_SHARED),1)
 	install -m 755 libdarshan-util.so $(libdir)

darshan-util/doc/dxt_analyzer.txt

+# Email questions to SDMSUPPORT@LBL.GOV
+# Scientific Data Management Research Group
+# Lawrence Berkeley National Laboratory
+#
+# last update on Mon Aug  7 08:47:28 PDT 2017
+
+
+To plot the read or write activity from Darshan Extended Trace (DXT) logs.
+
+% ./dxt_analyzer.py --help
+usage: dxt_analyzer.py [-h] -i DXT_LOGNAME [-o SAVEFIG] [--show] [--read]
+                            [--filemode] [-f FNAME]
+
+io activity plot from dxt log
+
+optional arguments:
+  -h, --help            show this help message and exit
+  -i DXT_LOGNAME, --input DXT_LOGNAME
+                        dxt log path
+  -o SAVEFIG, --save SAVEFIG
+                        output file name for the plot
+  --show                Show the plot rather than saving to a PDF
+  --read                READ I/O action to be plotted. 
+                        Default is False for WRITE mode.
+  --filemode            Single file mode (must be used with --fname). 
+                        Default is False for all files
+  -f FNAME, --fname FNAME
+                        name of file to be plotted (must use with --filemode)
+
+Example runs:
+% python dxt_analyzer.py -i darshan_dxt-a.txt 
+
+% python dxt_analyzer.py -i darshan_dxt-a.txt \
+        --filemode -f /global/cscratch1/sd/asim/amrex/a24/plt00000.hdf5
+
+% python dxt_analyzer.py -i darshan_dxt-d.txt \
+	-o dxt-d.pdf
+
+% python dxt_analyzer.py -i darshan_dxt-df.txt 
+
+% python dxt_analyzer.py -i darshan_dxt-c.txt 
+
+% python dxt_analyzer.py -i darshan_dxt-v.txt 
+
+
+For more information on creating DXT logs, see:
+http://www.mcs.anl.gov/research/projects/darshan/docs/darshan3-util.html#_darshan_dxt_parser