Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 30 additions & 10 deletions content/docs/tooling/tooling-performance-analysis.md
Original file line number Diff line number Diff line change
Expand Up @@ -222,25 +222,45 @@ where the naming pattern is `participant-rank-file_number`. To find and merge th
$ ls
A
B
$ precice-cli profiling merge A B
Searching A : found 1 files in A/precice-profiling
Searching B : found 1 files in B/precice-profiling
Found 2 unique event files
$ precice-cli profiling merge
Found 2 files in .
Found a single run for participant B
Found a single run for participant A
Loading event files
Globalizing event names
Grouping events
Aligning B (-179us) with A
Writing to profiling.db
Loading 2 event files
Loading precice-profiling/B-0-1.txt
Processing precice-profiling/B-0-1.txt
Loading precice-profiling/A-0-1.txt
Processing precice-profiling/A-0-1.txt
Align participant ranks
Align participants
Aligning B with A shift latter by 5
$ ls
A
B
profiling.db
```

The merge command searches passed directories for the event files.
The merge command searches the current directory recursively for event files.
You can also pass individual directories to be searched, or individual event files to use.
You can also pass individual files if you are not interested in all ranks.
To tell the merge to search only folders A and B run:

```console
precice-cli profiling merge A B
Found 1 files in A
Found 1 files in B
Found 2 profiling files in total
Found a single run for participant A
Found a single run for participant B
Loading 2 event files
Loading A/precice-profiling/A-0-1.txt
Processing A/precice-profiling/A-0-1.txt
Loading B/precice-profiling/B-0-1.txt
Processing B/precice-profiling/B-0-1.txt
Align participant ranks
Align participants
Aligning B with A shift latter by 5
```

The merge command is written in pure Python, without external dependencies, to make it easy to use on clusters.
After you run `precice-cli profiling merge`, you end up with a single file, which can be additionally compressed and transferred to another machine.
Expand Down
Loading