table of contents
BPLS.SERIAL(1) | User Commands | BPLS.SERIAL(1) |
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)
- --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"
- 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>
September 2024 | ADIOS |