1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
.TH BPLS.MPI "1" "September 2024" "ADIOS" "User Commands"
.SH NAME
bpls.mpi \- ADIOS2 utility
.SH DESCRIPTION
usage: bpls [OPTIONS] file [mask1 mask2 ...]
.PP
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.
.TP
\fB\-\-long\fR
| \fB\-l\fR Print values of all scalars and attributes and
min/max values of arrays (no overhead to get them!)
.TP
\fB\-\-attrs\fR
| \fB\-a\fR List/match attributes too
.TP
\fB\-\-attrsonly\fR | \fB\-A\fR
List attributes only
.TP
\fB\-\-meshes\fR
| \fB\-m\fR List meshes
.TP
\fB\-\-timestep\fR
| \fB\-t\fR Read content step by step (stream reading)
.TP
\fB\-\-ignore_flatten\fR
Display steps as written (don't flatten, even if writer said to)
.TP
\fB\-\-dump\fR
| \fB\-d\fR Dump matched variables/attributes
To match attributes too, add option \fB\-a\fR
.TP
\fB\-\-regexp\fR
| \fB\-e\fR Treat masks as extended regular expressions
.TP
\fB\-\-output\fR
| \fB\-o\fR <path> Print to a file instead of stdout
.TP
\fB\-\-start\fR
| \fB\-s\fR "spec" Offset indices in each dimension
(default is 0 for all dimensions)
<0 is handled as in python (\fB\-1\fR is last)
.TP
\fB\-\-count\fR
| \fB\-c\fR "spec" Number of elements in each dimension
\fB\-1\fR denotes 'until end' of dimension
(default is \fB\-1\fR for all dimensions)
.TP
\fB\-\-noindex\fR
| \fB\-y\fR Print data without array indices
.TP
\fB\-\-string\fR
| \fB\-S\fR Print 8bit integer arrays as strings
.TP
\fB\-\-columns\fR
| \fB\-n\fR "cols" Number of data elements per row to print
.TP
\fB\-\-format\fR
| \fB\-f\fR "str" Format string to use for one data item in print
instead of the default. E.g. "%6.3f"
.TP
\fB\-\-hidden_attrs\fR
Show hidden ADIOS attributes in the file
.TP
\fB\-\-decomp\fR
| \fB\-D\fR Show decomposition of variables as layed out in file
.TP
\fB\-\-error\fR
| \fB\-X\fR string Specify read accuracy (error,norm,rel|abs)
e.g. error="0.0,0.0,abs"
L2 norm = 0.0, Linf = inf
.TP
\fB\-\-transport\-parameters\fR | \fB\-T\fR
Specify File transport parameters
e.g. "Library=stdio"
.TP
\fB\-\-engine\fR
| \fB\-E\fR <name> Specify ADIOS Engine
.TP
\fB\-\-engine\-params\fR
| \fB\-P\fR string Specify ADIOS Engine Parameters
e.g. "SelectSteps=0:n:2"
.IP
Examples for slicing:
\fB\-s\fR "0,0,0" \fB\-c\fR "1,99,1": Print 100 elements (of the 2nd dimension).
\fB\-s\fR "0,0" \fB\-c\fR "1,\-1": Print the whole 2nd dimension however large it is.
\fB\-s\fR "\-1,\-1" \fB\-c\fR "1,1": Print the very last element (of a 2D array)
.PP
Help options
.TP
\fB\-\-help\fR
| \fB\-h\fR Print this help.
.TP
\fB\-\-verbose\fR
| \fB\-v\fR Print log about what this program is doing.
Use multiple \fB\-v\fR to increase logging level.
.TP
\fB\-\-version\fR
| \fB\-V\fR Print version information; compatible with
\fB\-\-verbose\fR for additional information, i.e.
\fB\-v\fR \fB\-\-version\fR.
.PP
Typical use: bpls \fB\-lav\fR <file>
|
