30 | | The source code for the tools `pp_merge`, `pp_rdiff`, `pp_qdiff` and `pp_getfields` can be downloaded. Unpack the tar file and type `make` for instructions. |
| 30 | The source code for the following tools `pp_merge`, `pp_rdiff`, `pp_qdiff` and `pp_getfields` can be downloaded here: [attachment:PP_tools_src.tar.gz PP Tools Source] |
| 31 | Unpack the tar file and type `make` for instructions. |
| 32 | |
| 33 | == pp_merge == |
| 34 | |
| 35 | Merges (interleaves) PP files to produce a PP file in time order. This is suitable for use with NDdiag, which requires its input to be in time order. |
| 36 | |
| 37 | Usage: |
| 38 | {{{ |
| 39 | pp_merge {PP output file} { List of PP input files } |
| 40 | }}} |
| 41 | |
| 42 | == pp_rdiff == |
| 43 | |
| 44 | This compares two PP files of the same size. It computes the relative difference between corresponding field points according to the formula |
| 45 | |
| 46 | Image |
| 47 | |
| 48 | Usage: |
| 49 | {{{ |
| 50 | pp_rdiff {Input PP file 1} {Input PP file 2} [{Threshold}] |
| 51 | }}} |
| 52 | where `Threshold` is a positive number. If no threshold is supplied, a value of 10-7 is used. The tool reports whether the files are different to within threshold and the maximum absolute relative difference found. |
| 53 | |
| 54 | == pp_qdiff == |
| 55 | |
| 56 | PP quick difference. This simply subtracts the field points of the two input files, which must be the same size, and puts them in the output. |
| 57 | |
| 58 | Usage: |
| 59 | {{{ |
| 60 | pp_qdiff {PP file 1} {PP file 2} {Output PP file} |
| 61 | }}} |
| 62 | |
| 63 | The output file can then be examined by a graphical program like `xconv`. |
| 64 | |
| 65 | == pp_getfields == |
| 66 | |
| 67 | This program extracts a list of fields specified by the user. |
| 68 | |
| 69 | Usage: |
| 70 | {{{ |
| 71 | pp_getfield {Input PP} {Output PP} {STASH list} |
| 72 | }}} |
| 73 | where the STASH items are separated by spaces. |