The MVM processing can be performed using one of two interfaces:

Command-line Interface for MVM Processing

The task runmultihap serves as the primary interface for processing data from multiple visits that share a single skycell into a uniform set of images.

runmultihap.py - Module to control processing of multi-visit mosaics

License

LICENSE

USAGE:
>>> python drizzlepac/runmultihap [-dl] inputFilename
  • The ‘-d’ option will run this task in DEBUG mode producing additional outputs. If not explicitly specified, the default value is logical “False”.

  • The ‘-l’ option allows the user to control the level of verboseness in the log statements displayed on the screen and written to the .log file. Valid options are “critical”, “error”, “warning”, “info”, and “debug”. If not explicitly specified, the default value is “info”.

Python USAGE:
>>> python
>>> from drizzlepac import runmultihap
>>> runmultihap.perform(inputFilename, debug=False, log_level="info")
drizzlepac.runmultihap.perform(input_filename, **kwargs)[source]

Main calling subroutine.

Parameters
input_filenamestring

Name of the input csv file containing information about the files to be processed

debugBoolean

display all tracebacks, and debug information?

input_custom_pars_filestr, optional

Represents a fully specified input filename of a configuration JSON file which has been customized for specialized processing. This file should contain ALL the input parameters necessary for processing. If not specified, default configuration parameter values will be used.

log_levelstring

The desired level of verboseness in the log statements displayed on the screen and written to the .log file.

Associated Helper Code

These modules and functions assist with some of the logistics associated with multi-visit processing.

drizzlepac.haputils.make_poller_files

Generates a poller file that will be used as input to runsinglehap.py, hapsequencer.py, runmultihap.py or hapmultisequencer.py based on the files or rootnames listed user-specified list file.

USAGE
>>> python drizzlepac/haputils/make_poller_files.py <input filename> -[ost]
- input filename: Name of a file containing a list of calibrated fits files (ending with "_flt.fits" or
  "_flc.fits") or rootnames (9 characters, usually ending with a "q" to process. The corresponding
  flc.fits or flt.fits files must exist in the user-specified path, the current working directory or the
  online cache
  • The ‘-o’ optional input allows users to input the name of an output poller file that will be created. If not explicitly specified, the poller file will be named “poller_file.out”.

  • The ‘-s’ optional input allows users to input the Name of the skycell. The correct syntax for skycell names is “skycell-pNNNNxXXyXX”, where NNNN is the 4-digit projection cell number, and XX and YY are the two-digit X and Y skycell indices, respectively. NOTE: this input argument is not needed for SVM poller file creation, but REQUIRED for MVM poller file creation. Users can determine the skycell(s) that their observations occupy using the haputils.which_skycell script.

  • The ‘-t’ optional input allows users to specify the type of poller file that will be created. The valid input options are “svm” to create a poller file for use with the single-visit mosaics pipeline or “mvm” to create a poller file for use with the multiple-visit mosaics pipeline. If not explicitly specified, the default value is “svm”. NOTE: if creating a MVM poller file, one must specify the skycell name using the “-s” input argument.

Python USAGE:
>>> python
>>> from drizzlepac.haputils import make_poller_files
>>> make_poller_files.generate_poller_file(input_list, poller_file_type='svm', output_poller_filename="poller_file.out", skycell_name=None):
drizzlepac.haputils.make_poller_files.generate_poller_file(input_list, poller_file_type='svm', output_poller_filename='poller_file.out', skycell_name=None)[source]

Creates a properly formatted SVM or MVM poller file.

Parameters
input_liststr

Name of the text file containing the list of filenames or rootnames to process

poller_file_typestr, optional

Type of poller file to create. ‘svm’ for single visit mosaic, ‘mvm’ for multi-visit mosaic. Default value is ‘svm’.

output_poller_filenamestr, optional

Name of the output poller file that will be created. Default value is ‘poller_file.out’.

skycell_namestr, optional

Name of the skycell to use when creating a MVM poller file. skycell_name is REQUIRED for the creation of a MVM poller file, but completely unnecessary for the creation of a SVM poller file. The correct syntax for skycell names is ‘skycell-pNNNNxXXyXX’, where NNNN is the 4-digit projection cell number, and XX and YY are the two-digit X and Y skycell indices, respectively. Default value is logical ‘None’. NOTE: this input argument is not needed for SVM poller file creation, but REQUIRED for MVM poller file creation. Users can determine the skycell(s) that their observations occupy using the haputils.which_skycell script.

Returns
Nothing.

drizzlepac.haputils.which_skycell

Reports the name(s) of the projection cell(s)/skycell(s) that the observations in the user-specified input file occupy.

USAGE:
>>> python drizzlepac/haputils/which_skycell.py -[i]
  • The ‘-i’ optional input allows users to specify the name of a file containing a list of calibrated fits files (ending with “_flt.fits” or “_flc.fits”) to process. If not explicitly specified, all ‘flc/flt fits files in the current working directory will be processed.

Python USAGE:
>>> python
>>> from drizzlepac.haputils import which_skycell
>>> which_skycell.report_skycells(img_list)
drizzlepac.haputils.which_skycell.report_skycells(img_list)[source]

reports the names of the projection cell(s)/skycell(s) that the observations in the user-specified input list occupy.

Parameters
img_listlist

list of the images to process

Returns
Nothing!