From GridLAB-D Wiki
Jump to: navigation, search

pcontrol - Interactive process control Template:NEW30


gridlabd --pcontrol


The process control window is a continuous interactive screen that shows all the current GridLAB-D simulations active on the local host. The display is typically as follows:

GridLAB-D Process Control - Version 3.0.0-4595 (Hassayampa)

PROC PID   RUNTIME    STATE   CLOCK                   MODEL
---- ----- ---------- ------- ----------------------- -----------------------------------------------------------------
   0 72169        34s Running 2000-01-03 22:29:49 UTC /Users/david/gridlabd_3.0/core ... test_groupid/test_groupid.glm
   1 72563         6s Running 2000-01-01 15:53:27 UTC /Users/david/gridlabd_3.0/core ... test_groupid/test_groupid.glm
   2 72698         4s Running 2000-01-21 06:57:28 UTC /Users/david/gridlabd_3.0/comm ... ial_Qi/test_commercial_Qi.glm
   3   -
   4   -
   5   -
   6   -
   7   -

2012/08/19 15:36:54: Ready.
C to clear defunct, Up/Down to select, K to kill, Q to quit: 

The columns in the listing are relative self-explanatory:

  • PROC is the GridLAB-D process map entry number. It is assumed that there can be no more than one entry per CPU available on the host.
  • PID is the host process id. This is used to send signals to the process.
  • RUNTIME is the elapsed wall clock time since the simulation started.
  • STATE is the state of the simulation. Possible states are
Initialization in progress.
Run in progress.
Paused for user or server I/O.
Simulation completed.
Simulation locked for synchronization or event.
Simulation no longer running but did not complete normally. These can be cleared using the 'C' key.
  • CLOCK is the current simulation clock time. All clock times are presented in UTC regardless of the timezone used by the simulation.
  • MODEL is the name of the model

The bolded entry is the selected entry. The up and down arrow keys allows the selection to be changed. Pressing the 'K' key kills the selected entry. 'C' will clear the process list of any defunct simulations that could be left from unexpected crashes. The 'Q' key will quit. The 'Ctrl-C' button will also quit.


The screen refreshes every second and this cannot be changed.

Because the process map is sampled once every second, it is quite likely that a quick simulation might never show up on the list.


Process control was introduced in Hassayampa (Version 3.0).

See also