Mhdump

From MidasWiki
Revision as of 17:07, 31 July 2015 by Suz (talk | contribs)
Jump to navigation Jump to search

Description

The mhdump utility dumps history files.

mhdump reads and decodes all the data in the given history (.hst) files, with options to limit the decoding to specified events and tags, and an option to omit the event and tag names from the output.

mhdump is completely standalone and does not require MIDAS header files and libraries.


Arguments

 -h          print this help message
 -t          omit tag definitions
 -n          omit variable names
 -L          list tag definitions only
 -E event_id specify event id
 -T tag_name specify tag 
 -A          do all 


Usage

$ mhdump
$ mhdump [-h] [-L] [-n] [-t] [-E event_id] [-T tag_name] file1.hst file2.hst ...

Examples

  • To list all existing tags: mhdump -L file1.hst file2.hst ...
  • To show data for all events, all tags: mhdump file1.hst file2.hst ...
  • To show all data for event 0: mhdump -E 0 file1.hst file2.hst ...
  • To show data for event 0, tag "State": mhdump -n -E 0 -T State file1.hst file2.hst ...
  • To show data for event 3, tag "MCRT", array index 5: mhdump -n -E 3 -T MCRT[5] file1.hst file2.hst ...

Notes

The mhdump source code can be found in the Midas package under ../midas/utils/ and a description of the .hst file format is can be found under Mhformat.