HealSparsePropertyMapTask

HealSparsePropertyMapTask generates a set of survey property maps in healsparse format. One map is created per map type per tract per band.

The resolution of the maps is set by the resolution configured for HealSparseInputMapTask and run during the coadd assembly.

The maps to be run are configured through the “property map registry”, and new maps can be defined via the lsst.pipe.tasks.healSparseMappingProperties.register_property_map decorator. Maps can do computations with any values that are available via the visit summary datasets.

Each map type can be configured to compute the minimum value at each position (do_min, dataset type {name}_map_min); the maximum value (do_max, dataset type {name}_map_max); the mean value (do_mean, dataset type {name}_map_mean); the weighted mean, using the coadd weights (do_weighted_mean, dataset type {name}_map_weighted_mean); and the sum (do_sum, dataset type {name}_map_sum). In each case {name} refers to the registered name of the map.

Note that the output maps cover the full coadd tract, and are not truncated to the inner tract region. Truncation to the inner region is performed when tract maps are consoldated in ConsolidateHealSparsePropertyMapTask.

Supported Map Types

The following map types are supported, and it is possible to add more by subclassing BasePropertyMap. All values are sampled at the center of each map pixel. All PSF properties are estimated by realizing the PSF model over a grid of points on each detector and approximating the variation with a second-order Chebyshev polynomial.

  • exposure_time: The input visit exposure time, usually with do_sum=True.

  • psf_size: The size of the PSF as computed from the determinant radius (pixels).

  • psf_e1: The PSF e1 ellipticity.

  • psf_e2: The PSF e2 ellipticity.

  • n_exposure: The number of exposures, usually with do_sum=True.

  • psf_maglim: The magnitude limit for PSF magnitudes. Can only be used with do_weighted_mean=True.

  • sky_background : The sky background, scaled to nJy.

  • sky_noise: The sky noise, scaled to nJy.

  • dcr_dra: The shift in the RA position of sources due to differential chromatic refraction (DCR) will be an empirically determined constant multiplied by the object color multiplied by this map.

  • dcr_ddec: The shift in the Dec position of the sources due to DCR.

  • dcr_e1: The shift in the ellipticity e1 due to DCR will be an empirically determined constant multipled by the object color multiplied by this map.

  • dcr_e2: The shift in the ellipticity e2 due to DCR.

Python API summary

from lsst.pipe.tasks.healSparseMapping import HealSparsePropertyMapTask
classHealSparsePropertyMapTask(**kwargs)

Task to compute Healsparse property maps...

attributeconfig

Access configuration fields and retargetable subtasks.

methodrun(sky_map, tract, band, coadd_dict, input_map_dict, visit_summary_dict)

Run the healsparse property task...

See also

See the HealSparsePropertyMapTask API reference for complete details.

Retargetable subtasks

property_maps

Default
['exposure_time', 'psf_size', 'psf_e1', 'psf_e2', 'psf_maglim', 'sky_noise', 'sky_background', 'dcr_dra', 'dcr_ddec', 'dcr_e1', 'dcr_e2', 'epoch']
Field type

Multi-selection RegistryField

Choices
'exposure_time'

lsst.pipe.tasks.healSparseMappingProperties.Configurable

'psf_size'

lsst.pipe.tasks.healSparseMappingProperties.Configurable

'psf_e1'

lsst.pipe.tasks.healSparseMappingProperties.Configurable

'psf_e2'

lsst.pipe.tasks.healSparseMappingProperties.Configurable

'n_exposure'

lsst.pipe.tasks.healSparseMappingProperties.Configurable

'psf_maglim'

lsst.pipe.tasks.healSparseMappingProperties.Configurable

'sky_background'

lsst.pipe.tasks.healSparseMappingProperties.Configurable

'sky_noise'

lsst.pipe.tasks.healSparseMappingProperties.Configurable

'dcr_dra'

lsst.pipe.tasks.healSparseMappingProperties.Configurable

'dcr_ddec'

lsst.pipe.tasks.healSparseMappingProperties.Configurable

'dcr_e1'

lsst.pipe.tasks.healSparseMappingProperties.Configurable

'dcr_e2'

lsst.pipe.tasks.healSparseMappingProperties.Configurable

'epoch'

lsst.pipe.tasks.healSparseMappingProperties.Configurable

Property map computation objects

Configuration fields

connections

Data type

lsst.pipe.base.config.HealSparsePropertyMapConfigConnections

Field type

ConfigField

Configurations describing the connections of the PipelineTask to datatypes

saveLogOutput

Default
True
Field type

bool Field

Flag to enable/disable saving of log output for a task, enabled by default.

saveMetadata

Default
True
Field type

bool Field

Flag to enable/disable metadata saving for a task, enabled by default. Deprecated: This field is deprecated and will be removed after v26.