Update submission scripts docs add note

Author: shuds13

docs/platforms/example_scripts.rst

@@ -2,8 +2,22 @@ Example Scheduler Submission Scripts
 ====================================
 
 Below are example submission scripts used to configure and launch libEnsemble
-on a variety of high-powered systems. See :ref:`here<platform-index>` for more
-information about the respective systems and configuration.
+on a variety of high-powered systems. See :ref:`Running on HPC Systems<platform-index>`
+for more information about the respective systems and configuration.
+
+.. note::
+    It is **highly recommended** that the directive lines (e.g., #SBATCH) in batch
+    submission scripts do **NOT** specify  processor, task, or GPU configuration info
+    --- these lines should only specify the number of nodes required.
+
+    For example, do not specify ``#SBATCH --gpus-per-node=4`` in order to use four
+    GPUs on the node, when each worker may use less than this, as this may assign
+    all of the GPUs to a single MPI invocation. Instead,  the configuration should
+    be supplied either
+    :doc:`in the simulation function<../examples/sim_funcs/forces_simf_gpu>`
+    or, if using dynamic resources,
+    :doc:`in the generator<../examples/sim_funcs/forces_simf_gpu_vary_resources>`.
+
 
 General examples
 ----------------
@@ -55,33 +69,26 @@ System Examples
         :caption: /examples/libE_submission_scripts/submit_pbs_polaris.sh
         :language: bash
 
-.. dropdown:: Bridges - Central Mode
+.. dropdown:: Bebop - Central Mode
 
-    ..  literalinclude:: ../../examples/libE_submission_scripts/bridges_submit_slurm_central.sh
-        :caption: /examples/libE_submission_scripts/bridges_submit_slurm_central.sh
+    ..  literalinclude:: ../../examples/libE_submission_scripts/bebop_submit_pbs_central.sh
+        :caption: /examples/libE_submission_scripts/bebop_submit_pbs_central.sh
         :language: bash
 
-.. dropdown:: Bebop - Central Mode
+.. dropdown:: Bridges - MPI / Central Mode
 
-    ..  literalinclude:: ../../examples/libE_submission_scripts/bebop_submit_slurm_central.sh
-        :caption: /examples/libE_submission_scripts/bebop_submit_slurm_central.sh
+    ..  literalinclude:: ../../examples/libE_submission_scripts/bridges_submit_slurm_central.sh
+        :caption: /examples/libE_submission_scripts/bridges_submit_slurm_central.sh
         :language: bash
 
-.. dropdown:: Bebop - Distributed Mode
+.. dropdown:: SLURM - MPI / Distributed Mode (co-locate workers & MPI applications)
 
-    ..  literalinclude:: ../../examples/libE_submission_scripts/bebop_submit_pbs_distrib.sh
-        :caption: /examples/libE_submission_scripts/bebop_submit_pbs_distrib.sh
+    ..  literalinclude:: ../../examples/libE_submission_scripts/submit_distrib_mpi4py.sh
+        :caption: /examples/libE_submission_scripts/submit_distrib_mpi4py.sh
         :language: bash
 
 .. dropdown:: Summit (Decommissioned) - On Launch Nodes with Multiprocessing
 
     ..  literalinclude:: ../../examples/libE_submission_scripts/summit_submit_mproc.sh
         :caption: /examples/libE_submission_scripts/summit_submit_mproc.sh
         :language: bash
-
-.. dropdown:: Cobalt - Intermediate node with Multiprocessing
-
-    .. literalinclude:: ../../examples/libE_submission_scripts/cobalt_submit_mproc.sh
-        :caption: /examples/libE_submission_scripts/cobalt_submit_mproc.sh
-        :language: bash
-

examples/libE_submission_scripts/submit_perlmutter.sh

@@ -7,10 +7,9 @@
 
 # This script is using GPU partition
 export MPICH_GPU_SUPPORT_ENABLED=1
-export SLURM_EXACT=1
 
 # One worker for generator and 4 for sims (one GPU each)
 python libe_calling_script.py -n 5
 
 # Or if libE_specs option gen_on_manager=True
-python libe_calling_script.py -n 4
+# python libe_calling_script.py -n 4