######################################################################## # README_Windows.txt # # README file for installing MCNP5-1.60 & Data Libraries # on Windows PC Systems # ######################################################################## MCNP5-1.

60 Contents: -------------------1. README -- This basic description of files and installation 2. The file MCNP5_dist.tgz -- The compressed tar file which contains the source, test suites, and uti lities. The following are contained in the tar file: a) directory MCNP5/bin executables for MCNP5 and MAKXSF for Linux, MacOSX, & Windows in their respective subdirectories. For MCNP5/bin/Windows, the following executables are included: mcnp5.exe, mcnp5_mpi.exe, mcnp5_threaded.exe, mcnpx, merge_meshtal.exe, onegxs.exe and X11.dll. b) directory Source source files for building MCNP5 on all systems c) directory Testing Regression test set for verifying correct compilation/execution, VALIDATION_CRITICALITY, VALIDATION_SHIELDING, and VERIFICATION_KEFF are directories which contain additional test sets. The xsec_data directory contains nuclear data for the regression tes t set, and should not be used for any other purpose. d) directory utilities This directory contains several scripts and programs that are useful for MCNP5. They include the EventLog_Analyzer, MCNP_PSTUDY, MCNP_RANDOM, MERGE_MCTAL, MERGE_MESHTAL, ONEGXS and The VISUAL_EDITOR. Each of these has accompanying documentation in their own directory. 3. directory docfiles manuals, documentation and publications for MCNP and Monte Carlo. All of this documentation can be accessed though the ABOUT_MCNP5.htm document located in the highest directory of the release DVD. 4. directory Windows_Installer This directory contains the Windows InstallShield Installer, similar to other Windows Installer programs. Double click on the "setup.exe" file to begin installation of MCNP5-1.60 Administrative privileges are required to install MCNP5-1.60. 5. The windows files 7z.exe, 7z.dll, and 7z_license.txt The 7z.exe executable is used by the Windows Installer to uncompress the .tgz files on Windows PCs. This program is open-source and under the

GNU LGPL license. 7z.dll is GNU LGPL + unRAR restriction For more information, see www.7-zip.org webpages. The source coding and executables in MCNP include all of the corrections described in the release notes document (LA-UR-10-06235). Output template files for the installation test set have also been updated. Cross-section files required for MCNP usage are NOT included, but can be insta lled with the MCNP_DATA/Windows_Installer data installation program. See the MCNP website for more information: http://mcnp.lanl.gov/index.html *********************************************************** Note: MCNP5 source coding and Volumes II & III of the MCNP5 manuals (MCNP5_Install_Guide.pdf, MCNP5_manual_VOL_II.pdf, MCNP5_manual_VOL_III.pdf) are EXPORT CONTROLLED. All relevant DOE/NNSA procedures must be followed in order to further distribute them. *********************************************************** Short Guide to Building/Testing new installation of MCNP5-1.60 on Windows PCs: ------------------------------------0. Either use the InstallShield Installer, located in the MCNP5/Windows_Instal ler directory, by double-clicking on the setup.exe file. -- or -0. On a Unix system, or in a Cygwin shell on a Windows PC, copy the entire MCNP5 directory to your chosen destination cp -r MCNP5 $HOME/LANL This will create a directory MCNP5, with subdirectories bin, docfiles, Source, Testing, utilities. It is preferred to not have any spaces in the directory path where MCNP5 wi ll be placed. 1. On a Unix system, or in a Cygwin shell on a Windows PC, change to the Source directory: cd $HOME/LANL/MCNP5/Source 2. Ensure that GNU make is available on the system, and that "make" invokes the GNU version of make. (This may involve setting a link or adjusting the PATH variable.) 3. Build & test the code: make The code will be compiled, with the executable: MCNP5/Source/src/mcnp5

(with a ".exe" extension on PCs) The default compilation is sequential. See the installation guide for details on selecting options for plotting &/or parallel operation. Then the regression test problems will be run, with a summary of diffs at the end. make test1 4. See the PDF file MCNP5_Install_Guide.pdf for more details. NOTE: An MPI version of MCNP5 can be built using the Cygwin make utility and either MPICH_NT or MPICH2. To compile an MPI version, replace "seq" with "mpi" on the "make build CONFIG=' ...'" command line. The build system assumes that MPICH_NT and MPICH2 are installed in their default directories, C:\Program Files\MPICH or C:\Program Files\MPICH2, respectively. If they are installed in a different directory, then the Windows_NT.gcf file in the config folder will need to be modified to point to the correct include and library files. Short Guide to Building/Testing with existing installation of MCNP5: ------------------------------------It is recommended, but not necessary, to remove the existing older copy of MCNP5 . If the copy was installed with the Windows Installer, it should be removed with the Add/Remove Programs feature of the Windows operating system control panel. Then the new installer on this DVDROM should be used. If the older version is not remove d, the PATH environmental variable will be prepended with the new MCNP5-1.60 direct ory path, so the new MCNP5-1.60 will be executed when mcnp5 is typed at the command line. If the older version of MCNP5 was manually copied, then the old directory should be removed manually. The new version of MCNP5 can be installed with the steps above in any directory the user chooses. It is up to the user to manually change the PATH environmental variables, and th e user is strongly encouraged to prepend the new MCNP5-1.60 directory path to the PATH env ironmental variable. Comments on the Installation Test Problem Set: --------------------------------------------1. We have generated reference results ("templates") for Windows: 32 Bit Pentium IV, Windows 2000 Professional SP4, Intel 9.1 f90, gcc 2. If compiling on those specific systems, exact diffs are made between the OUTP & MCTAL files and the templates. All diffs should be zero, if the Windows

Installers were used. 3. On other systems or if running with any of MPI/PVM/OpenMP, then "fuzzy" diffs are taken to attempt to account for small, unimportant roundoff differences. Very small floating point numbers are converted to zero, and the last 2 digits are trimmed from floating point numbers. Integers & strings are not changed. Diffs are then taken. All MCTAL diffs should be zero (except for problem inp41, which depends on processor speed). Diffs for OUTP files should be zero or small (a few 100 or 1000 bytes or less). 4. See the NOTES at the end of the test results summary.