8. Processing dump fileΒΆ

You can output the information on transport particles on dump file by [t-cross], [t-time], and [t-product] tallies in either ascii or binary format. This dump-a.f program can convert the dump data from ascii to binary, or vice versa. It can also divide, or combine, dump files into several files. The latter function is useful when the dump file is employed as the source data of the PHITS simulation using the MPI parallelization with different numbers of cores. In addition, you can get the information that cannot be obtained by the conventional tally functions in PHITS by analyzing the dump file. For that purpose, you need to make your own program in dump-a.f, and compile it by yourself. The followings are the instruction how to use this program.

Executable files for this program are dump-a_win.exe, dump-a_mac.exe, and dump-a_lin.exe, for Windows, Mac, and Linux, respectively. After running the executable file, you have to supply either input file name or the variable of each parameter in the terminal. The meaning of each input parameter is given below.

  • 1st card (iasb): The format of dump file (0: binary, 1: ascii)

  • 2nd card (ipur): Purpose (0: convert format, 1: divide/combine, 2: user program)

  • 3rd card (chin): Input dump data file name (comments should NOT be written in this line)

  • 4th card (isdmp(0)): Number of data in a record

  • 5th card (isdmp(1-isdmp(0))): ID number of each record (see also Table tbl-dumpID1 and tbl-dumpID2)

  • 6th card (chot): Output dump data file name (comments should NOT be written in this line)

  • 7th card (irec): Number of records to be read (0: all data)

  • 8th card (ninp): Number of input dump files (only for divide/combine mode, 0 for single file)

  • 9th card (nout): Number of output dump files (only for divide/combine mode, 0 for single file)

The characters in the parentheses are the variable name in the program.

Sample input files for converting the format (dump-convert.inp) and divide/combine the files (dump-divcom.inp) are in phits/utility/dump-a folder. Note that the information on the dump particles generated by the same history is written in the same file in the divide/combine mode in order to keep the correlation of each particle.