ParsNIP Files

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