command: SyncroSim console command

In rsyncrosim: The R Interface to 'SyncroSim'

SyncroSim console command

Description

This function issues a command to the SyncroSim console, and is mostly used internally by other functions.

Usage

command(
  args,
  session = NULL,
  program = "SyncroSim.Console.exe",
  wait = TRUE,
  progName = NULL
)

Arguments

args	character string, named list, named vector, unnamed list, or unnamed vector. Arguments for the SyncroSim console. See 'details' for more information about this argument
session	Session object. If NULL(default), the default session will be used
program	character. The name of the target SyncroSim executable. Options include "SyncroSim.Console.exe" (default), "SyncroSim.Server.exe", "SyncroSim.PackageManager.exe" and "SyncroSim.Multiband.exe"
wait	logical. If TRUE(default) R will wait for the command to finish before proceeding. Note that silent(session) is ignored if wait=FALSE
progName	character. Internal argument for setting path to SyncroSim installation folder.

Details

Example args, and the resulting character string passed to the SyncroSim console:

• Character string e.g. "–create –help": "–create –help"

• Named list or named vector e.g. list(name1=NULL,name2=value2): "–name1 –name2=value2"

• Unnamed list or unnamed vector e.g. c("create","help"): "–create –help"

Value

Character string: output from the SyncroSim program.

Examples

# Install "stsim" if not already installed
addPackage("stsim")

# Set the file path and name of the new SsimLibrary
myLibraryName <- file.path(tempdir(),"testlib.ssim")

# Specify the command line arguments for creating a new stsim SsimLibrary
args <- list(create = NULL, library = NULL, 
        name = myLibraryName, 
        package = "stsim")
        
# Use a default session to create a new SsimLibrary in the current working directory
output <- command(args, session = session(printCmd = TRUE))
output

# Provide arguments to the command line using an unnamed vector
command(c("create", "help"))

# Provide arguments to the command line using a character string
command("--create --help")

# Provide arguments to the command line using a named list
command(list(create = NULL, help = NULL))

# Call on a different program to find all installed packages
command(list(installed = NULL), program = "SyncroSim.PackageManager.exe")

rsyncrosim documentation built on Oct. 8, 2022, 9:06 a.m.