BioSimSpace.Process.ProcessRunner¶
-
class
BioSimSpace.Process.ProcessRunner(processes, name='runner', work_dir=None, nest_dirs=True)¶ A class for managing and running multiple simulation processes, e.g. a free energy simulation at multiple lambda values.
-
__init__(processes, name='runner', work_dir=None, nest_dirs=True)¶ Constructor.
- Parameters
processes ([
Process]) – A list of process objects.name (str) – The name of the of processes.
work_dir (str) – The working directory for the processes.
nest_dirs (bool) – Whether to nest the working directory of the processes inside the process runner top-level directory.
Methods
__init__(processes[, name, work_dir, nest_dirs])Constructor.
addProcess(process)Add a process to the runner.
errored()Return the indices of the errored processes.
getName()Return the process runner name.
isError()Return whether each process is in an error state.
isQueued()Return whether each process is queued.
Return whether each process is running.
kill(index)Kill a specific process. The same can be achieved using:
killAll()Kill all of the processes.
nError()Return the number of errored processes.
Return the number of processes.
nQueued()Return the number of queued processes.
nRunning()Return the number of running processes.
Return the list of processes.
queued()Return the indices of the queued processes.
removeProcess(index)Remove a process from the runner.
Restart any jobs that are in an error state.
runTime()Return the run time for each process.
running()Return the indices of the running processes.
setName(name)Set the process runner name.
start(index)Start a specific process. The same can be achieved using:
startAll()Start all of the processes.
workDir()Return the working directory.
-
addProcess(process)¶ Add a process to the runner.
-
errored()¶ Return the indices of the errored processes.
- Returns
idx_errored – A list containing the indices of the errored processes.
- Return type
[int]
-
getName()¶ Return the process runner name.
- Returns
name – The name of the process.
- Return type
str
-
isError()¶ Return whether each process is in an error state.
- Returns
is_error – A list indicating whether each process is in an error state.
- Return type
[bool]
-
isQueued()¶ Return whether each process is queued.
- Returns
is_queued – A list indicating whether each process is queued.
- Return type
[ bool ]
-
isRunning()¶ Return whether each process is running.
- Returns
is_running – A list indicating whether each process is running.
- Return type
[ bool ]
-
kill(index)¶ - Kill a specific process. The same can be achieved using:
runner.processes()[index].kill()
- Parameters
index (int) – The index of the process.
-
killAll()¶ Kill all of the processes.
-
nError()¶ Return the number of errored processes.
- Returns
n_error – The number of processes that are in an error state.
- Return type
int
-
nProcesses()¶ Return the number of processes.
- Returns
n_processes – The number of processes managed by the runner.
- Return type
int
-
nQueued()¶ Return the number of queued processes.
- Returns
n_queued – The number of processes that are queued.
- Return type
int
-
nRunning()¶ Return the number of running processes.
- Returns
n_running – The number of processes that are running.
- Return type
int
-
processes()¶ Return the list of processes.
- Returns
processes – The list of processes.
- Return type
[
Process]
-
queued()¶ Return the indices of the queued processes.
- Returns
idx_queued – A list containing the indices of the queued processes.
- Return type
[int]
-
removeProcess(index)¶ Remove a process from the runner.
- Parameters
index (int) – The index of the process.
-
restartFailed()¶ Restart any jobs that are in an error state.
-
runTime()¶ Return the run time for each process.
- Returns
run_time – A list containing the run time of each process.
- Return type
-
running()¶ Return the indices of the running processes.
- Returns
idx_running – A list containing the indices of the running processes.
- Return type
[ int ]
-
setName(name)¶ Set the process runner name.
- Parameters
name (str) – The process runner name.
-
start(index)¶ - Start a specific process. The same can be achieved using:
runner.processes()[index].start()
- Parameters
index (int) – The index of the process.
-
startAll()¶ Start all of the processes.
-
workDir()¶ Return the working directory.
- Returns
work_dir – The working directory.
- Return type
str
-