schrodinger.application.macromodel.paraUtils module

Copyright Schrodinger, LLC. All rights reserved.

This is a common module for parallel job execution. It provides functionalities to configure and run parallel jobs. Currently this script is used by epik_driver, bmin_driver, and ligprep_driver.

schrodinger.application.macromodel.paraUtils.add_para_job_options(parser, options=None)

Adds common para job control options to a SingleDashOptionParser instance.

Parameters:
  • parser (SingleDashOptionParser) – Instance of SingleDashOptionParser
  • options (List) – List of module enums that indicate what options to add to the parser.
schrodinger.application.macromodel.paraUtils.validate_options(options)

Validate the job control options

Parameters:options (Instance) – object containing values of para job options
schrodinger.application.macromodel.paraUtils.print_job_info(argv, driver_script, version)

Check command line arguments passed and environment variables based on the driver.

Parameters:
  • argv (String) – Command line arguments
  • driver_script (String) – Driver script name
  • version (String) – Driver script version
schrodinger.application.macromodel.paraUtils.launch_subjobs(options, driver_script, backend_instance, backend_args, job_input_file, job_output_file, cmd_append='', merge=True, prepare_subjob_callback=None, callback_data={}, split_input_file=True, post_execution_processing_callback=None, post_execution_processing_callback_data={})

Launch subjobs.

Parameters:
  • options (Instance) – object containing values of para job options
  • driver_script (String) – Driver script name
  • backend_instance (_Backend) – Instance of the _Backend
  • backend_args (List) – List of arguments
  • job_input_file (String) – Job input file
  • job_output_file (String) – Job output file
  • cmd_append (String) – Command to be appended to subjob command
  • merge (Boolean) – Whether to join subjob outputs or not
  • prepare_subjob_callback (Function) – Function to be called to prepare subjob data
  • callback_data (Dictionary) – A dictionary to be passed to subjob callback