From 2e904bfe7159b3acb5b3d06cd6696aa73912390d Mon Sep 17 00:00:00 2001 From: Paul Romano Date: Tue, 19 Mar 2013 19:28:27 -0400 Subject: [PATCH] Updated a few things in documentation. --- docs/source/developers.rst | 25 +++++------------- docs/source/index.rst | 10 +++++--- docs/source/publications.rst | 18 ++++++------- docs/source/usersguide/troubleshoot.rst | 34 ++++++++++++++++++------- 4 files changed, 47 insertions(+), 40 deletions(-) diff --git a/docs/source/developers.rst b/docs/source/developers.rst index 685507e796..a1001321f5 100644 --- a/docs/source/developers.rst +++ b/docs/source/developers.rst @@ -6,21 +6,10 @@ Development Team Active development of the OpenMC Monte Carlo code is currently led by: -* `Paul Romano`_ -* `Bryan Herman`_ -* `Nick Horelik`_ -* `Adam Nelson`_ - -Advisors to the project include: - -* `Benoit Forget`_ -* `Kord Smith`_ -* `Andrew Siegel`_ - -.. _Paul Romano: mailto:paul.k.romano@gmail.com -.. _Bryan Herman: mailto:bherman@mit.edu -.. _Nick Horelik: mailto:nhorelik@mit.edu -.. _Adam Nelson: mailto:nelsonag@umich.edu -.. _Benoit Forget: mailto:bforget@mit.edu -.. _Kord Smith: mailto:kord@mit.edu -.. _Andrew Siegel: mailto:siegela@mcs.anl.gov +* `Paul Romano `_ +* `Bryan Herman `_ +* `Nick Horelik `_ +* `Adam Nelson `_ +* `Benoit Forget `_ +* `Kord Smith `_ +* `Andrew Siegel `_ diff --git a/docs/source/index.rst b/docs/source/index.rst index da41dcd971..83eac22e0a 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -8,13 +8,15 @@ constructive solid geometry with second-order surfaces. The particle interaction data is based on ACE format cross sections, also used in the MCNP and Serpent Monte Carlo codes. -The development of OpenMC is led by the `Computational Reactor Physics Group`_ -at the `Massachusetts Institute of Technology`_. For more information on OpenMC, -feel free to contact `Paul Romano`_. +OpenMC was originally developed by members of the `Computational Reactor Physics +Group`_ at the `Massachusetts Institute of Technology`_ starting +in 2011. Various universities, laboratories, and other organizations now +contribute to the development of OpenMC. For more information on OpenMC, feel +free to send a message to the User's Group `mailing list`_. .. _Computational Reactor Physics Group: http://crpg.mit.edu .. _Massachusetts Institute of Technology: http://web.mit.edu -.. _Paul Romano: mailto:paul.k.romano@gmail.com +.. _mailing list: https://groups.google.com/forum/?fromgroups=#!forum/openmc-users -------- Contents diff --git a/docs/source/publications.rst b/docs/source/publications.rst index 1b4f404425..e04138faf8 100644 --- a/docs/source/publications.rst +++ b/docs/source/publications.rst @@ -4,19 +4,19 @@ Publications ============ +- Paul K. Romano and Benoit Forget, "The OpenMC Monte Carlo Particle Transport + Code," *Ann. Nucl. Energy*, **51**, 274--281 + (2013). ``_ + +- Andrew R. Siegel, Kord Smith, Paul K. Romano, Benoit Forget, and Kyle Felker, + "The effect of load imbalances on the performance of Monte Carlo codes in LWR + analysis", *J. Comput. Phys.*, **235**, 901--911 (2013). + ``_ + - Paul K. Romano and Benoit Forget, "Reducing Parallel Communication in Monte Carlo Simulations via Batch Statistics," *Trans. Am. Nucl. Soc.*, **107**, 519--522 (2012). -- Paul K. Romano and Benoit Forget, "The OpenMC Monte Carlo Particle Transport - Code," *Ann. Nucl. Energy*, **51**, 274--281 - (2012). ``_ - -- Andrew R. Siegel, Kord Smith, Paul K. Romano, Benoit Forget, and Kyle Felker, - "The effect of load imbalances on the performance of Monte Carlo codes in LWR - analysis", *J. Comput. Phys.*, - ``_ (2012). - - Paul K. Romano and Benoit Forget, "Parallel Fission Bank Algorithms in Monte Carlo Criticality Calculations," *Nucl. Sci. Eng.*, **170**, 125--135 (2012). ``_ diff --git a/docs/source/usersguide/troubleshoot.rst b/docs/source/usersguide/troubleshoot.rst index 911cb62596..3779940d41 100644 --- a/docs/source/usersguide/troubleshoot.rst +++ b/docs/source/usersguide/troubleshoot.rst @@ -1,8 +1,8 @@ .. _usersguide_troubleshoot: -====================== -Troubleshooting OpenMC -====================== +=============== +Troubleshooting +=============== ------------------------- Problems with Compilation @@ -11,14 +11,31 @@ Problems with Compilation If you are experiencing problems trying to compile OpenMC, first check if the error you are receiving is among the following options. -Fatal Error: File 'xml_data_settings_t.mod' opened at (1) is not a GFORTRAN module file -*************************************************************************************** +undefined reference to `_vtab$... +********************************* + +If you see this message when trying to compile, the most likely cause is that +you are using a compiler that does not support type-bound procedures from +Fortran 2003. This affects any version of gfortran prior to 4.6. Downloading and +installing the latest gfortran_ compiler should resolve this problem. + +Fatal Error: Wrong module version '4' (expected '9') for file 'xml_data_cmfd_t.mod' opened at (1) +************************************************************************************************* + +The `.mod` modules files that are created by gfortran are versioned and +sometimes are usually not backwards compatible. If gfortran is upgraded and the +modules files for xml-fortran source files are not deleted, this error may +occur. To fix this, clear out all module and object files with :program:`make +distclean` and then recompiling. + +Fatal Error: File 'xml_data_cmfd_t.mod' opened at (1) is not a GFORTRAN module file +*********************************************************************************** When OpenMC compiles, the first thing it needs to do is compile source in the xml-fortran subdirectory. If you compiled everything with a compiler other than gfortran, performed a :program:`make clean`, and then tried to :program:`make` with gfortran, the xml-fortran modules would have been compiled with a different -compiler. To fix this, try clearing out all modules and object files with +compiler. To fix this, try clearing out all module and object files with :program:`make distclean` and then recompiling. gfortran: unrecognized option '-cpp' @@ -68,8 +85,7 @@ the following commands: Now when you re-run your problem, it should report exactly where the program failed. If after reading the debug output, you are still unsure why the program -failed, send an email to the OpenMC `developers -`_. +failed, send an email to the OpenMC User's Group `mailing list`_. ERROR: No cross_sections.xml file was specified in settings.xml or in the CROSS_SECTIONS environment variable. ************************************************************************************************************** @@ -105,4 +121,4 @@ has a collision. For example, if you received this error at cycle 5, generation 5 1 4032 .. _gfortran: http://gcc.gnu.org/wiki/GFortran - +.. _mailing list: https://groups.google.com/forum/?fromgroups=#!forum/openmc-users