commit 7b357056476c47c8b59025320bf010dc05a15f82
Author: liangjg <liangjg2008@gmail.com>
Date:   Tue Aug 14 12:44:40 2018 -0700

    readme file

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4684053
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+# BEAVRS
+
+The BEAVRS benchmark (Benchmark for Evaluation And Validation of Reactor Simulations)
+represents a 4-loop Westinghouse plant with a detailed description of fuel
+assemblies, burnable absorbers, in-core fission detectors, core loading and
+re-loading patterns. This benchmark enables analysts to develop extremely
+detailed reactor core models that can be used for testing and validation of
+coupled neutron transport, thermal-hydraulics, and fuel isotopic depletion.
+The benchmark also provides measured reactor data and assocaited uncertainties
+for Hot Zero Power (HZP) physics tests, boron letdown curves, and
+three-dimensional in-core flux maps from 58 instrumented assemblies.
+
+This repository contains the latest release of BEAVRS, including:
+
+ - documentation: pdf and latex source files for the specifications and UQ report
+ - measurement data: detector signals, power history, boron letdown, etc
+ - models: inputs of simulation codes (e.g., OpenMC) for BEAVRS
+
+## Reporting
+BEAVRS Users Group: https://groups.google.com/forum/#!forum/beavrs-users
+