Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

show status

Usage:

row show status [OPTIONS] [DIRECTORIES]

row show status summarizes actions in the workflow. The summary includes the number of directories in each status and an estimate of the remaining cost in either CPU-hours or GPU-hours based on the number of submitted, eligible, and waiting jobs and the resources used by the action.

[DIRECTORIES]

Show the status of these specific directories. By default, row shows the status for the entire workspace.

Pass a single - to read the directories from stdin (separated by newlines):

echo "dir1" | row show status -

[OPTIONS]

--action

(also: -a)

Set --action <pattern> to choose which actions to display by name. By default, row shows the status of all actions. <pattern> is a wildcard pattern.

-all

Show all actions. By default, show status hides actions with 0 matching directories.

--completed

Show actions with completed directories.

--eligible

Show actions with eligible directories.

--no-header

Hide the header in the output.

--submitted

Show actions with submitted directories.

--waiting

Show actions with waiting directories.

Examples

  • Show the status of the entire workspace:
    row show status
    
  • Show the status of all actions with eligible directories:
    row show status --eligible
    
  • Show the status of a specific action:
    row show status --action=action
    
  • Show the status of all action names that match a wildcard pattern:
    row show status --action='project*'
    
  • Show the status of specific directories in the workspace:
    row show status directory1 directory2
    

Development of row is led by the Glotzer Group at the University of Michigan.

Copyright © 2024-2025 The Regents of the University of Michigan.