Module jobutils

Set the source path property to the original job directory. This is obtained from the job control Job object for this process. If no Job object is found, the current directory is used.

Parameters:

• struct (schrodinger.structure.Structure) - The structure to set the property on. Note that property setting works properly on both Structure and Cms objects.
• backend (schrodinger.job.jobcontrol._Backend) - The job control backend. Will be used to obtain the job object if no job is supplied. If neither backend or job are supplied, the backend will be obtained from job control (if one exists).
• job (schrodinger.job.jobcontrol.Job) - The job control job for this process. If not supplied, will be obtained from the backend (if one exists).

Returns: str

The directory set as the source path. Will be either the OrigLaunchDir property of the job or the current directory if not running under job control.

Get the source path to the original job directory

Parameters:

• source (schrodinger.structure.Structure or schrodinger.project.ProjectRow) - Either the ProjectRow or the structure to obtain the source information from. If a structure, can be either a Structure or a Cms object.
• existence_check (bool) - If True (default), a blank string will be returned if the source path does not exist. If False, the path is returned regardless of whether it exists or not.

Returns: str

The original job directory or a blank string if none is found

Prepare generic job specification builder. If set_driver_reserves_cores script (driver) is set to True, script is expected to use all the cores (cpus), similar to umbrella mode in multisim. For an example see stress-strain driver. For all other cases (such as in opto/hopping/amorphous) keep set_driver_reserves_cores to False.

Parameters:

• argv (list) - The list of command line arguments, including the script name at [0], similar to that returned by sys.argv
• program_name (str) - Program name
• default_jobname (str) - Default job name
• input_fn (str) - Input filename
• set_driver_reserves_cores (bool) - If True, enable launchapi.setDriverReservesCores

Returns: launchapi.JobSpecificationArgsBuilder

Job specification builder object

Remove dashes in the beginning of the keys. Used with ArgumentParser.

Parameters:

• adict (dict{string:any}) - Dictionary of defaults

Returns: dict{string:any}

Get the absolute path to the user's local MatSci data directory for storing custom templates, protocols, etc. Directory is created if it doesn't exist.

Returns: str

The absolute path the Materials Science data parent directory

Parse parameters file.

Format of the file: 1st line is driver's filename 2nd line is original arguments passed to the driver

Parameters:

• path (str) - Path to the file with original arguments

Returns: dict

Dictionary with parsed values

Write out original arguments to parameters file and add the file as an output file to any existing jobcontrol backend.

Parameters:

• driver (str) - Driver's filename
• args (list) - Original arguments passed to driver
• outpath (str) - Path to the parameters file to write original arguments

For the given restart jobname, return the name of the file containing the job id.

Returns: str

The name of the restart jobid file

Unzip the archive in the current directory. All the error handling is on the caller function.

Parameters:

• options (argparse.Namespace) - The object holding all the option values

Create a gzipped tar archive in the current directory from the provided list of file paths. All the error handling is on the caller function.

Parameters:

• path (path) - Path to the new archive to be created
• path (path) - List of files to be archived

Generate command-line list for the job restart.

Parameters:

• driver_path (str) - Path to the driver
• zip_fn (str) - Filename of the archive with all restart files
• restart_options (argparse.Namespace) - The object holding all the option values
• args (list) - List of the arguments passed to the original run
• default_jobname (str) - Default job name

Returns: list

Store the job id in a file as a signal to the GUI that a new job has been launched.

Parameters:

• jobobj (schrodinger.job.jobcontrol.Job) - The object holding all the option values

Return the option value associated with flag

Parameters:

• options (argparse.Namespace) - The object holding all the option values
• flag (str) - The flag for the desired option.

Returns: any

The value associated with flag, or None if flag (minus any leading dashes) is not found as a property on options

Set the option value associated with flag

Parameters:

• options (argparse.Namespace) - The object holding all the option values
• flag (str) - The flag for the desired option. If the string starts with a '-', the '-' is removed.
• value (any) - The value to set the option.flag value to

Add restart arguments to the parser

Parameters:

• parser (argparse.ArgumentParser) - The parser to add arguments to

Get the command line options from the -restart_x flags

Returns: tuple

tuple of strings (viewname, incorporation, project, host:cpu, jobname)

Add a keyword argument to the parser

Parameters:

• parser (argparse.ArgumentParser) - The parser to add this argument to

Adds keystring and keydict properties to the argparse options object that are the list of keyword arguments turned into, respectively, a string or a dictionary. Valid keyword syntax is checked for.

Typical usage:

jobutils.add_keyword_parser_argument(parser) options = parser.parse_args(args) jobutils.parse_keyword_list(options) print options.keystring, options.keydict

Parameters:

• options (argparse.Namespace) - The parser Namespace object with a keywords attribute
• exit_on_error (bool) - True if the ValueError for keyword syntax should result in a message being printed and sys.exit() being called, False if the error should just be raised.
• logger (logging.Logger) - The logger to use for recording error messages, otherwise they'll be printed.
• validate (bool) - Whether keywords/values not recognized by Jaguar should be considered an error.

Raises:

• ValueError - If an invalid keyword pair syntax is detected and handle_error is False

  @raises schrodinger.application.jaguar.validation.JaguarKeywordException if validate=True, exit_on_error=False and an invalid Jaguar keyword/value has been used.

Add a SAVE_FLAG argument to the parser

Parameters:

• parser (argparse.ArgumentParser) - The parser to add this argument to

Check if a valid token exists

Parameters:

• panel (schrodinger.ui.qt.appframework.AppFramework) - panel to use to put up an error dialog if no license
• token (schrodinger.utils.license constant) - A token type from the schrodinger.utils.license module, such as MATERIALSCIENCE_MAIN or MATERIALSCIENCE_GA
• name (str) - The user-identifiable name for the token - used for error messages. If not provided, the string used in the license module for this token (if one exists) will be used.
• as_validator (bool) - If True, this function will work as an AF2 validation method. Instead of posting a dialog or printing a message for a failed license check, it will return (False, error_message).

Returns: bool or (bool, str)

True if valid license exists. If no valid license exists, False will be returned by default, but (False, msg) will be returned if as_validator=True. Note that (False, msg) evalutes to True so must be handled by the calling routine as not a boolean if as_validator=True.

Create a subdirectory to run a job in, asking the user and removing existing directories if needed.

Parameters:

• panel (schrodinger.ui.qt.appframework.AppFramework) - panel to use to put up an error dialog if no license
• jobname (str) - The name of the job. The directory will be jobname + _dir

Returns: str or None

The path to the directory or None if an existing directory was found and the user elected not to remove it

Change a text string from a file to a value. Converts string values of special Python tokens such as True, False or None to the Python tokens. Converts numbers to int or float if possible.

Parameters:

• string (str) - The string to convert

Returns:

string converted to, in order of preference: [True|False|None], int, float, or input type

A context manager which changes the working directory to the given path, and then changes it back to its previous value on exit.

Decorators:

• @contextlib.contextmanager

Cleans the given string by removing special characters to make it acceptable for a file name. If the string is blank, it will be replaced by the value of default.

Parameters:

• string (str) - The string to clean.
• default (str) - The name to use if string is blank

Returns: str

A string usable as a filename

Zip up all the requested files and set the resulting archive as the job control backend structure output file (if runnning under job control).

Parameters:

• zipname (str) - The name of the archive to create
• filelist (list) - Each item in filelist is the name of a file to add to file zipname

Make sure $ are escaped in the given pattern for command lines

Parameters:

• pattern (str) - A string to modify

Returns: str

pattern with a \ in front of $

Return a the jobname from backend, command line (-NAMEJOB / environment), DEFAULT_JOBNAME

Parameters:

• default_jobname (str) - default_jobname of the current module

Returns: string

__doc__

Value:

""" Copyright Schrodinger, LLC. All rights reserved. """

__warningregistry__

Value:

{('This function is deprecated. Use get_directory_path instead.', <type 'exceptions.DeprecationWarning'>, 221): True}