From eecb2a850797d7738281b4e8f07b55e5282a3b6c Mon Sep 17 00:00:00 2001
From: YoungHui Park <ypark234@wisc.edu>
Date: Thu, 5 Nov 2020 23:39:25 -0600
Subject: [PATCH] Add a new format file for surface source

---
 docs/source/io_formats/index.rst          |  1 +
 docs/source/io_formats/surface_source.rst | 21 +++++++++++++++++++++
 2 files changed, 22 insertions(+)
 create mode 100644 docs/source/io_formats/surface_source.rst

diff --git a/docs/source/io_formats/index.rst b/docs/source/io_formats/index.rst
index 7ae22c0a33..bc5b0a4a91 100644
--- a/docs/source/io_formats/index.rst
+++ b/docs/source/io_formats/index.rst
@@ -44,6 +44,7 @@ Output Files
 
    statepoint
    source
+   surface_source
    summary
    depletion_results
    particle_restart
diff --git a/docs/source/io_formats/surface_source.rst b/docs/source/io_formats/surface_source.rst
new file mode 100644
index 0000000000..5cf25fc60b
--- /dev/null
+++ b/docs/source/io_formats/surface_source.rst
@@ -0,0 +1,21 @@
+.. _io_surface_source:
+
+==========================
+Surface Source File Format
+==========================
+
+When surface source writing is triggered, a separate source file is written with
+only the sources on specified surfaces. The format is identical to source file.
+
+**/**
+
+:Attributes: - **filetype** (*char[]*) -- String indicating the type of file.
+
+:Datasets:
+
+           - **source_bank** (Compound type) -- Source bank information for each
+             particle. The compound type has fields ``r``, ``u``, ``E``,
+             ``wgt``, ``delayed_group``, ``surf_id`` and ``particle``,
+             which represent the position, direction, energy, weight,
+             delayed group, surface ID, and particle type (0=neutron, 1=photon,
+             2=electron, 3=positron), respectively.