Author: Gernot Plank email@example.com
limpetGUI is a simple tool for visualizing traces output with bench. It has been developed originally by Bernardo Rocha. Using bench traces of all state variables can be dumped to binary files by specifying the
--validate option. If one is interested in a detailed analysis of all traces it is recommended to increase the temporal resolution using
--dt-out which is specified in ms. For instance, running
dumps all state variable traces of the TT2 model into a number of binary files, each trace is written at a temporal output resolution of 0.01 ms == 10 \(\mu s\). Each trace is written into a separate binary file. The header file, in this case named
TT2_header.txt keeps track of the individual files, the type and size of data tokens stored in each file. The header file follows the following format:
0 # is bigendian TT2_baseline.Vm.bin Real 8 11 TT2_baseline.Lambda.bin Real 8 11 TT2_baseline.delLambda.bin Real 8 11 TT2_baseline.Tension.bin Real 8 11 TT2_baseline.Iion.bin Real 8 11 TT2_baseline.t.bin Real 8 11 TT2_baseline_TT2.Ca_i GlobalData_t 8 11 TT2_baseline_TT2.CaSR GlobalData_t 8 11 TT2_baseline_TT2.CaSS Gatetype 4 11 TT2_baseline_TT2.R_ Gatetype 4 11 TT2_baseline_TT2.O Gatetype 4 11 TT2_baseline_TT2.Na_i GlobalData_t 8 11 TT2_baseline_TT2.K_i GlobalData_t 8 11 TT2_baseline_TT2.M Gatetype 4 11 TT2_baseline_TT2.H Gatetype 4 11 TT2_baseline_TT2.J Gatetype 4 11 TT2_baseline_TT2.Xr1 Gatetype 4 11 TT2_baseline_TT2.Xr2 Gatetype 4 11 TT2_baseline_TT2.Xs Gatetype 4 11 TT2_baseline_TT2.R Gatetype 4 11 TT2_baseline_TT2.S Gatetype 4 11 TT2_baseline_TT2.D Gatetype 4 11 TT2_baseline_TT2.F Gatetype 4 11 TT2_baseline_TT2.F2 Gatetype 4 11 TT2_baseline_TT2.FCaSS Gatetype 4 11 TT2_baseline_LandHumanStress.TRPN GlobalData_t 8 11 TT2_baseline_LandHumanStress.TmBlocked GlobalData_t 8 11 TT2_baseline_LandHumanStress.XS GlobalData_t 8 11 TT2_baseline_LandHumanStress.XW GlobalData_t 8 11 TT2_baseline_LandHumanStress.ZETAS GlobalData_t 8 11 TT2_baseline_LandHumanStress.ZETAW GlobalData_t 8 11 TT2_baseline_LandHumanStress.__Ca_i_local GlobalData_t 8 11
limpetGUI expects hdf5 files as input. The individual *.bin files output by bench are dumped into a single hdf5 file using the
bin2h5 python script. All files listed in the corresponding header file are read in and added to the hdf5 file. If one is interested only in a subset of state variables the header file can be modified by simply deleting all file pertaining to state variables that should not be included and leaving the rest. Launching the command
Quite often it is of interest to investigate the effect of a given modification upon state variables, be it the modification of some parameters in the model or the impact of changes in the numerical integration such as changing the time step or using a different integrator. limpetGUI reads in two hdf5 files and plots corresponding traces together. For instance, a comparison between the standard TT2 model and a modified TT2-PZ model is shwon in fig-limpetGUI-compare-mod-model-env and fig-limpetGUI-compare-mod-model-zoom.
In fig-limpetGUI-compare-mod-integrator the effect of altering the integration time step upon state variable traces is shown. While the overall behavior remains largely unaffected noticeable deviations are witnessed in some state variable traces.
By default, limpetGUI compares traces between two h5 files where correspondence is established based on the names of the state variables. This straight forward approach of establishing correspondence does not work when traces are compared between different models. Names of various states are not consistent across models although they may refer to the same physical quantities. In such cases the establish between traces must be established manually by defining a mapping that can be passed on to limpetGUI. A map follows the simple definition