VisHandler

The PHANGS pipeline to handle staging and pre-processing of uv data before imaging. Works through a single big class (the VisHandler). This needs to be attached to a keyHandler to access the target, product, and configuration keys and locations of the uv data.

Requires CASA to run.

phangsPipeline.VisHandler.loop_stage_uvdata(self, do_all: bool = False, do_copy: bool = False, do_remove_staging: bool = False, do_custom: bool = False, do_contsub: bool = False, do_extract_line: bool = False, do_extract_cont: bool = False, extra_ext: str = '', make_directories: bool = True, statwt_line: bool = True, statwt_cont: bool = True, intent=None, timebin=None, just_projects=None, require_full_line_coverage: bool = False, require_full_cont_coverage: bool = False, overwrite: bool = False, strict_config=None)

Loops over the full set of targets, products, and configurations to run the uv data processing. Toggle the parts of the loop using the do_XXX booleans. Other choices affect the algorithms used.

This strict_config option has now been deprecated in favour of more granular control. Use the ‘requires’ keyword in the config_definitions file instead. By default, we require ALL arrays that make up the configuration, but this can be changed to an OR if you only need one of a certain combination, e.g.

interf_config 12m {‘array_tags’:[‘12m_1’,’12m_2’]} interf_config 12m {‘requires’:[‘12m_1|12m_2’]}

requires only one of 12m_1 or 12m_2 to be present. If an array is not in the ‘requires’ list, then it is assumed to be required.

The require_full_line_coverage option sets whether to require a measurement set to completely cover a given line’s frequency range (True) or not (False).

Parameters:

  • do_all (bool) – Will switch do_copy, do_contsub, do_custom, do_extract_line, do_extract_cont, and do_remove_staging to True

  • do_copy – If True, will split out the raw data to the staging directory

  • do_remove_staging – If True, will remove the intermediate data after staging

  • do_custom – Not currently used

  • do_contsub – If True, will do continuum subtraction

  • do_extract_line – If True, will extract the line from the dataset

  • do_extract_cont – If True, will extract continuum from the dataset

  • make_directories – If True, will create missing directories

  • statwt_line – If True, will statwt the lines after concatenation

  • statwt_cont – If True, will statwt the continuum after concatenation

  • intent – If set, will only split out datasets with the specified intent (e.g. ‘OBSERVE_TARGET#ON_SOURCE’)

  • timebin – If set, will apply timebin in the splitting

  • just_projects – If set, will only run on the specified projects (list)

  • require_full_line_coverage – If True, will only run on datasets where an SPW completely contains the line in question

  • require_full_cont_coverage – If True, will only run on datasets where an SPW completely contains the continuum frequency range requested

  • overwrite – If True, will overwrite existing staged datasets

  • strict_config – Deprecated. If set, raise an error. Use the “requires” keywords in the config key file instead.