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>

ADIOS                                             February 2024                                   BPLS.SERIAL(1)