NAME

       bpls.serial - ADIOS2 utility

DESCRIPTION

       usage: bpls [OPTIONS] file [mask1 mask2 ...]

       List/dump  content  of  a BP/HDF5 file.  A mask can be a shell pattern like with 'ls' e.g.
       "*/x?".  Variables with multiple timesteps are reported with  an  extra  dimensions.   The
       time dimension is the first dimension then.

       --long |  -l            Print  values  of all scalars and attributes and min/max values of
              arrays (no overhead to get them!)

       --attrs
              | -a           List/match attributes too

       --attrsonly | -A
              List attributes only

       --meshes
              | -m           List meshes

       --timestep
              | -t           Read content step by step (stream reading)

       --dump | -d           Dump matched  variables/attributes  To  match  attributes  too,  add
              option -a

       --regexp
              | -e           Treat masks as extended regular expressions

       --output
              | -o <path>    Print to a file instead of stdout

       --start
              |  -s  "spec"    Offset indices in each dimension (default is 0 for all dimensions)
              <0 is handled as in python (-1 is last)

       --count
              | -c "spec"    Number of elements in each  dimension  -1  denotes  'until  end'  of
              dimension (default is -1 for all dimensions)

       --noindex
              | -y           Print data without array indices

       --string
              | -S           Print 8bit integer arrays as strings

       --columns
              | -n "cols"    Number of data elements per row to print

       --format
              |  -f  "str"      Format  string  to  use for one data item in print instead of the
              default. E.g. "%6.3f"

       --hidden_attrs
              Show hidden ADIOS attributes in the file

       --decomp
              | -D           Show decomposition of variables as layed out in file

       --transport-parameters | -T
              Specify File transport parameters e.g. "Library=stdio"

       --engine
              | -E <name>  Specify ADIOS Engine

       --engine-params
              | -P string  Specify ADIOS Engine Parameters e.g. "SelectSteps=0:n:2"

              Examples for slicing: -s "0,0,0"   -c "1,99,1":  Print 100  elements  (of  the  2nd
              dimension).  -s "0,0"     -c "1,-1":    Print the whole 2nd dimension however large
              it is.  -s "-1,-1"   -c "1,1":     Print the very last element (of a 2D array)

       Help options

       --help | -h           Print this help.

       --verbose
              | -v           Print log about what this program is  doing.   Use  multiple  -v  to
              increase logging level.

       --version
              | -V           Print version information; compatible  with --verbose for additional
              information, i.e.  -v --version.

       Typical use: bpls -lav <file>