Add particle unique ID

[ChunYen-Chen]

This is a follow-up PR of PR #348. It solves part of #79.

Changes

• Wiki pages about particles are updated.

New

• A new built-in particle attribute PAR_PUID to store the particle UID.
• A new section of Wiki pages about particle UID.
• A new script track_particle.py to track the particle by UID.

Results

Comparison of tracking particle by UID and index of the array with different MPI rank number

Here I show the results of three different UIDs (300, 5403, and 31111) with different MPI ranks (1, 2, and 16). As shown in the figures, the particles can be tracked well by the UID.



The figure shows the position and the velocity in each direction of particles with specified UID. The idx means the index of specified particle UID in the array at step 0.

Note

• yt module does not recognize the integer attribute type correctly.
• gamer_compare_data is not supported yet.
• libyt is also not supported yet.

[hyschive]

@ChunYen-Chen Since the C-binary output format is deprecated (i.e., OPT__OUTPUT_TOTAL = 2), I suggest the following changes:

• Output_DumpData_Total.cpp: update FormatVersion to 2310.
• Init_ByRestart_v2.cpp: raise an error when PARTICLE is enabled and restarting from a file with FormatVersion < 2310.

Do you agree?

[ChunYen-Chen]

Since the C-binary output format is deprecated (i.e., OPT__OUTPUT_TOTAL = 2), I suggest the following changes:
Output_DumpData_Total.cpp: update FormatVersion to 2310.
Init_ByRestart_v2.cpp: raise an error when PARTICLE is enabled and restarting from a file with FormatVersion < 2310.
Do you agree?

@hyschive I assume you are referring to version 2510. If so, I have updated the relevant files.

[hyschive]

Since the C-binary output format is deprecated (i.e., OPT__OUTPUT_TOTAL = 2), I suggest the following changes:
Output_DumpData_Total.cpp: update FormatVersion to 2310.
Init_ByRestart_v2.cpp: raise an error when PARTICLE is enabled and restarting from a file with FormatVersion < 2310.
Do you agree?

@hyschive I assume you are referring to version 2510. If so, I have updated the relevant files.

No, I mean FormatVersion in Output_DumpData_Total.cpp instead of Output_DumpData_Total_HDF5.cpp