fastPASTA uses Semantic Versioning.
For extensive documentation of public facing source code, invoke cargo doc --open
For an exhaustive list of the data verification done via the check subcommand, see list of checks.
To verify or view curated content of the scanned raw binary data from ALICE.
The rust toolchain is required to compile the binary. On macOS, Linux or other Unix-like OS simply run
shell
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
and follow the on-screen instructions.
cargo build -r and find it in /target/release/fastpastashell
$ ./fastpasta -h
```shell
$ lz4 -d input.raw -c | ./fastpasta --filter-link 3 | ./fastpasta view rdh
lz4```
Piping is often optional and avoiding it will improve performance. e.g. the following is equivalent to the previous example, but saves significant IO overhead, by using one less pipe.
shell
$ lz4 -d input.raw -c | ./fastpasta --filter-link 3 view rdh
```shell
sanity (stateless) AND running (stateful)$ ./fastpasta input.raw --filter-link 0 check all
sanity checks$ ./fastpasta input.raw check sanity -f 0
sanity and running checks and include checks applicable to ITS only$ ./fastpasta input.raw check all ITS --filter-link 0
sanity include sanity checks specific to ITS$ ./fastpasta input.raw -f 3 check sanity its # target its is case-insensitive
```
less```shell
$ ./fastpasta input.raw view hbf | less
$ ./fastpasta input.raw view hbf -f 3 | less ```
shell
MEMORY_OFFSET: [ERROR_CODE] ERROR_MESSAGE
shell
0xE450FFD: [E10] RDH sanity check failed: data_format = 255
But they signify categories of errors.
E.g. all RDH sanity checks have the same error code, but the error message will specify which field failed.
The following is a list of error codes and their meaning, x is a placeholder for any number 0-9.
* [Ex0] - Sanity check
* [E1x] - RDH
* [E3x] - IHW
* [E4x] - TDH
* [E5x] - TDT
* [E6x] - DDW0
* [E7x] - Data word (Even number: IB, Odd number: OB) E70 is sanity check for both IB/OB.
* [E8x] - CDW
Run the full test suite with:
shell
$ cargo test -- --test-threads=1 --nocapture
Passing --test-threads=1 and --nocapture is necessary as several tests asserts that content written to stdout matches expectations, which will break when tests are run concurrently or writing to stdout is suppressed.
Apache 2.0 or MIT at your option.
Passively Maintained. There are no plans for new features, but the maintainer intends to respond to issues that get filed.
In the tables below fastPASTA is compared with rawdata-parser and decode.py in typical verification tasks. Hyperfine is used for benchmarking, with cache warmup.
| Tool | Command | Mean [s] | Min [s] | Max [s] |
|:---|:---|---:|---:|---:|
|fastPASTA| ./fastpasta input.raw check all | 0.060 ± 0.001 | 0.058 | 0.063 |
|rawdata-parser| ./rawdata-parser --skip-packet-counter-checks input.raw | 0.369 ± 0.002 | 0.366 | 0.372|
|decode.py| python3 decode.py -i 20522 -f input.raw --skip_data | 13.674 ± 0.386 | 13.610 | 14.499 |
| Tool | Command | Mean [s] | Min [s] | Max [s] |
|:---|:---|---:|---:|---:|
|fastPASTA| ./fastpasta input.raw check all | 0.690 ± 0.014 | 0.674 | 0.719|
|rawdata-parser| ./rawdata-parser --skip-packet-counter-checks input.raw | 2.892 ± 0.063 | 2.829 | 3.020 |
|decode.py| Verifying multiple links simultaneously is not supported | N/A | N/A | N/A |
| Tool | Command | Mean [s] | Min [s] | Max [s] |
|:---|:---|---:|---:|---:|
|fastPASTA| ./fastpasta input.raw check all ITS | 0.106 ± 0.002 | 0.103 | 0.111 |
|rawdata-parser| Verifying payloads is not supported | N/A | N/A | N/A |
|decode.py| python3 decode.py -i 20522 -f input.raw | 55.903 ± 0.571 | 54.561 | 56.837 |
The primary release profile of fastPASTA is already very fast, but if you absolutely need 10-20% more speed, a faster build profile exists that utilizes the experimental rust nightly toolchain.
The rust compiler rustc does not yet provide access to all the features that its backend LLVM has. But the experimental nightly rust toolchain allows passing flags directly to LLVM. fastPASTA includes configuration for a build profile release-nightly which utilizes LLVM to achieve more speed at the cost of compilation time and binary size. As of this writing, the stable channel of Rust does not have a way to pass compiler flags to the LLVM backend. The increased speed is mainly achieved through configuring a higher threshold for inlining, which will increase speed but also compilation time and binary size, and most crucially, cache pressure. The performance impact will be highly dependent on the machine fastPASTA runs on. Better/more CPU cache will lead to a higher performance gain. With >1 GB individual link data, the performance on one particular CERN machine running CentOS Stream 8, as measured by hyperfine increased by ~17%.
shell
$ rustup toolchain install nightly
$ rustup run nightly rustc --version
release-nightly experimental build profileshell
$ cargo +nightly build --profile release-nightly
/target/release-nightly/fastpasta