OpenMC Monte Carlo Code https://docs.openmc.org
Find a file
2018-06-15 01:18:38 +00:00
cmake/Modules Fixes in FindHDF5.cmake for Intel Xeon Phi. 2015-09-14 10:48:19 +07:00
docs Merge pull request #1001 from nelsonag/mgxs_expansion_with_tests 2018-05-08 14:58:41 -05:00
examples Implemented Expansion filters in to the MGXS classes and removed the old score-based expansions 2018-04-27 19:45:38 -04:00
include Add init methods (with order) for capi expansion filters 2018-05-22 08:12:49 -06:00
man/man1 Happy new year 2018! 2018-01-01 15:19:51 -06:00
openmc Merge pull request #1008 from tjlaboss/mesh_from_lattice 2018-05-23 17:56:58 -04:00
scripts Use latest HDF5 format for openmc-get-jeff-data 2018-03-19 10:40:45 -05:00
src More cleaning-up, fixing style and comments. 2018-06-15 01:18:38 +00:00
tests Merge pull request #1008 from tjlaboss/mesh_from_lattice 2018-05-23 17:56:58 -04:00
tools/ci Add tqdm to dependencies. Install mpi4py on Travis 2018-02-14 07:22:16 -06:00
.gitignore fixes per request of @paulromano: fixing test scratch files vice using .gitignore, minor typo in docs, and some otherwise small code cleanups 2018-05-01 19:17:21 -04:00
.gitmodules Replace FoX with pugixml 2017-03-03 09:17:49 -06:00
.travis.yml Use empty-argument form of super() 2018-02-05 23:14:30 -05:00
CMakeLists.txt making sure CMakelist.f90 and simulation.f90 2018-05-28 18:13:59 +00:00
LICENSE Happy new year 2018! 2018-01-01 15:19:51 -06:00
MANIFEST.in Remove tox.ini for now, update install instructions 2017-10-18 10:51:45 -05:00
pytest.ini Skip multipole-related tests if OPENMC_MULTIPOLE_LIBRARY is not set 2018-02-06 13:27:01 -05:00
readme.rst Add simple test for openmc.Settings 2018-02-05 07:35:48 -06:00
schemas.xml Added back RELAX NG compact schemata. 2013-08-15 00:36:49 -05:00
setup.py Add test for Chain.from_endf. Remove tqdm dependence. 2018-02-23 11:37:55 -06:00

==========================================
OpenMC Monte Carlo Particle Transport Code
==========================================

|licensebadge| |travisbadge| |coverallsbadge|

The OpenMC project aims to provide a fully-featured Monte Carlo particle
transport code based on modern methods. It is a constructive solid geometry,
continuous-energy transport code that uses HDF5 format cross sections. The
project started under the Computational Reactor Physics Group at MIT.

Complete documentation on the usage of OpenMC is hosted on Read the Docs (both
for the `latest release`_ and developmental_ version). If you are interested in
the project or would like to help and contribute, please send a message to the
OpenMC User's Group `mailing list`_.

------------
Installation
------------

Detailed `installation instructions`_ can be found in the User's Guide.

------
Citing
------

If you use OpenMC in your research, please consider giving proper attribution by
citing the following publication:

- Paul K. Romano, Nicholas E. Horelik, Bryan R. Herman, Adam G. Nelson, Benoit
  Forget, and Kord Smith, "`OpenMC: A State-of-the-Art Monte Carlo Code for
  Research and Development <https://doi.org/10.1016/j.anucene.2014.07.048>`_,"
  *Ann. Nucl. Energy*, **82**, 90--97 (2015).

---------------
Troubleshooting
---------------

If you run into problems compiling, installing, or running OpenMC, first check
the `Troubleshooting section`_ in the User's Guide. If you are not able to find
a solution to your problem there, please send a message to the User's Group
`mailing list`_.

--------------
Reporting Bugs
--------------

OpenMC is hosted on GitHub and all bugs are reported and tracked through the
Issues_ feature on GitHub. However, GitHub Issues should not be used for common
troubleshooting purposes. If you are having trouble installing the code or
getting your model to run properly, you should first send a message to the
User's Group `mailing list`_. If it turns out your issue really is a bug in the
code, an issue will then be created on GitHub. If you want to request that a
feature be added to the code, you may create an Issue on github.

-------
License
-------

OpenMC is distributed under the MIT/X license_.

.. _latest release: http://openmc.readthedocs.io/en/stable/
.. _developmental: http://openmc.readthedocs.io/en/latest/
.. _mailing list: https://groups.google.com/forum/?fromgroups=#!forum/openmc-users
.. _installation instructions: http://openmc.readthedocs.io/en/stable/usersguide/install.html
.. _Troubleshooting section: http://openmc.readthedocs.io/en/stable/usersguide/troubleshoot.html
.. _Issues: https://github.com/mit-crpg/openmc/issues
.. _license: http://openmc.readthedocs.io/en/stable/license.html

.. |licensebadge| image:: https://img.shields.io/github/license/mit-crpg/openmc.svg
   :target: http://openmc.readthedocs.io/en/latest/license.html
   :alt: License

.. |travisbadge| image:: https://travis-ci.org/mit-crpg/openmc.svg?branch=develop
   :target: https://travis-ci.org/mit-crpg/openmc
   :alt: Travis CI build status (Linux)

.. |coverallsbadge| image:: https://coveralls.io/repos/github/mit-crpg/openmc/badge.svg?branch=develop
   :target: https://coveralls.io/github/mit-crpg/openmc?branch=develop
   :alt: Code Coverage