ParsNIP-1.0 October 2014
Brief documentation for using ParsNIP tool, See https://sourceforge.net/p/ptracparser/wiki/ParsNIP%20home/ for more info...
This has been tested for the supplied input files but otherwise testing is limited to a fixed file format. I cannot guarantee it'll work for everyone without some modification! Tested PTRAC files were generated with MCNP5 and the PTRAC card (with variations):
PTRAC file=asc write=all cell=1 filter=-1.0,1,u -1.0,1,v -1.0,1,w &
-40.0,40.0,y -40.0,40.0,z 1.0,13.6,erg event=col max=100
(See MCNP5 manual 3-152 for more info on PTRAC inputs)
The code requires a basic file structure, an example of which is:
File structure:
Home: .../parsnip/
Files: ip_test Test input deck (see file for required input and explanations)
ptrac_test Sample file to check things are working
out_test Test output
parsnipOSX Pre-compiled executable for Mac OSX
Source: .../parsinp/src/
Files: main.c Contains main code for PTRAC parser
main.h Function and main struct definitions
lookup.c Crude lookup table for event types, banked particle descriptions and input variables
Compile from home directory with:
gcc src/*.c -o parsnip
Run with:
./parsnip ip_test (If run without input file, will request variables for input)
NOTE: It will be necessary to change the home path in ip_test to where the files are located, otherwise ParsNIP will fail during run.
Output written to home... will overwrite so be careful!
Guide to output variables:
Variable Definition Notes
NPS History number
COUNT Event number within history
TYPE Source, banked, surface, collision or termination
NXS ZZAAA for event COL and BNK events only
NTYN Reaction type (MT number) COL and BNK events only
NSF Surface crossing SUR event only
ANG Angle with surface normal (degrees) SUR event only
NTER Termination type TER event only
BRANCH Branch number for history TER event only
NCL Cell number
MAT Material number
NCP Number of collisions to event from source
X, Y, Z Co-ordinates of event (cm)
U, V, W Unit vector for direction after event write=all only
ERG Energy after event (MeV) write=all only
WGT Particle weight after event write=all only
TME Event time write=all only