Updating of outputfiles_merge to allow it to be imported as a function.

docs/source/examples_simple_2D.rst

@@ -155,7 +155,7 @@ You should have produced 60 output files, one for each A-scan, with names ``cyli
 
     python -m tools.outputfiles_merge user_models/cylinder_Bscan_2D
 
-You should see a combined output file ``cylinder_Bscan_2D_merged.out``. The tool will ask you if you want to delete the original single A-scan output files or keep them.
+You should see a combined output file ``cylinder_Bscan_2D_merged.out``. You can add the optional argument ``--remove-files`` if you want to automatically delete the original single A-scan output files.
 
 You can now view an image of the B-scan using the command:
 
@@ -171,9 +171,3 @@ You can now view an image of the B-scan using the command:
     :width: 600px
 
     B-scan of model of a metal cylinder buried in a dielectric half-space.
-
-
-
-
-
-

docs/source/utils.rst

@@ -21,15 +21,16 @@ where ``inputfile`` is the name of input file including the path.
 outputfiles_merge.py
 --------------------
 
-gprMax produces a separate output file for each trace (A-scan) in a B-scan. This module combines the separate output files into a single file, and offers to remove the separate output files afterwards. Usage (from the top-level gprMax directory) is:
+gprMax produces a separate output file for each trace (A-scan) in a B-scan. This module combines the separate output files into a single file, and can remove the separate output files afterwards. Usage (from the top-level gprMax directory) is:
 
 .. code-block:: none
 
-    python -m tools.outputfiles_merge basefilename
+    python -m tools.outputfiles_merge basefilename --remove-files
 
 where:
 
 * ``basefilename`` is the base name file of the output file series, e.g. for ``myoutput1.out``, ``myoutput2.out`` the base file name would be ``myoutput``
+* ``remove-files`` is an optional argument (flag) that when given will remove the separate output files after the merge.
 
 
 convert_png2h5.py