seisflows.system.runscripts.run_funcs
=====================================

.. py:module:: seisflows.system.runscripts.run_funcs

.. autoapi-nested-parse::

   Only required when system==cluster (or any subclass of cluster)

   This script is a wrapper for running tasks on systems during an active workflow.
   Loads in functions/methods and their keyword arguments from pickle files which
   have been written by system.run(). Runs functions in order of list.

   .. note::
       Not to be called by the user, this script is to be called by system.run()

   .. rubric::
       >> python run --funcs function_list.p --kwargs kwarg_dict.p



Attributes
----------

.. autoapisummary::

   seisflows.system.runscripts.run_funcs.args


Functions
---------

.. autoapisummary::

   seisflows.system.runscripts.run_funcs.parse_args
   seisflows.system.runscripts.run_funcs.export


Module Contents
---------------

.. py:function:: parse_args()

   Get command line arguments


.. py:function:: export(myenv)

   Exports comma delimited list of environment variables also allows deleting 
   environment variables by providing VARNAME with no corresponding value 

   e.g. VARNAME1=value1,VARNAME2=value2,VARNAME3
   will add VARNAME1 and VARNAME2 to the environment with corresponding values, 
   and remove VARNAME3 from the environment

   .. note::
       The ability to delete environment variables came from the Maui upgrade
       to Slurm 21.08, which enforced mutually exclusivity of --mem-per-cpu 
       and --mem-per-node, which are both defined on cross-cluster submissions.
       We needed a mechanism to remove one of these

   :type myenv: str
   :param myenv: the system environment to take variables from


.. py:data:: args