bpls.mpi(1)

NAME

bpls.mpi - 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)

--ignore_flatten

Display steps as written (don't flatten, even if writer said to)

--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

--error

| -X string Specify read accuracy (error,norm,rel|abs) e.g. error="0.0,0.0,abs" L2 norm = 0.0, Linf = inf

--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>