condor_dir {condor}

Condor Directories

Description

List Condor run directories, either on submitter machine or on a local drive.

Usage

condor_dir(top.dir = "condor", local.dir = NULL, pattern = "*",
  report = TRUE, sort = "job.id", session = NULL, ...)

Arguments

top.dir

top directory on submitter machine that contains Condor run directories.

local.dir

local directory to examine instead of top.dir.

pattern

regular expression identifying which run directories to show. The default is to show all directories inside top.dir or local.dir.

report

whether to return a detailed report of the run status in each directory.

sort

column name or column number used to sort the report data frame.

session

optional object of class ssh_connect.

...

passed to grep.

Details

If the user passes top.dir that resembles a Windows local directory (drive letter, colon, forward slash), it is automatically interpreted as a local.dir. In other words, condor_dir("c:/myruns") and condor_dir(local.dir="c:/myruns") are equivalent.

The default value of session = NULL looks for a session object in the user workspace. This allows the user to run Condor functions without explicitly specifying the session.

Value

A data frame containing details about each directory, or if report = FALSE a character vector of directory names.

Note

If there are many Condor run directories, the report generation can take substantial time (one SSH execution per run directory). To quickly return a vector of directory names, pass report = FALSE.

Author(s)

Arni Magnusson.

See Also

condor_submit, condor_q, condor_dir, and condor_download provide the main Condor interface.

condor_rm stops Condor jobs and condor_rmdir removes directories on the submitter machine.

condor_log and summary.condor_log are called to produce the detailed report if report = TRUE.

condor-package gives an overview of the package.

Examples

## Not run: 

# General workflow
session <- ssh_connect("servername")

condor_submit()
condor_q()
condor_dir()
condor_download()  # after job has finished

# Alternatively, examine runs on local drive
condor_dir(local.dir="myruns")
condor_dir("c:/myruns")

## End(Not run)