HighResolutionHipsTask¶

HighResolutionHipsTask is a task to warp coadd images into (HiPS)-compatible HPX exposures. Currently, the task includes a custom quantum-graph generation code, which is accessed from the command-line with build-high-resolution-hips-qg. Note that this task only generates HiPS-compatible exposures, it does not generate a HiPS directory tree.

Processing summary¶

In order to use this task from pipetask, you must generate a custom quantum graph. There are two stages. First one segments the survey with build-high-resolution-hips-qg segment. Second, one builds a quantum graph for a given segment with build-high-resolution-hips-qg build.

build-high-resolution-hips-qg segment -r REPO -p PIPELINE -c COLLECTIONS [COLLECTIONS] [-o HPIX_BUILD_ORDER]

The default for the build healpix order (that is, nside = 2**HPIX_BUILD_ORDER) is 1, so that the generator segments the sky over large areas. The PIPELINE is a pipeline yaml that must contain only one task (HighResolutionHipsTask) and should contain any configuration overrides. Depending on the workflow engine, one may wish to build quantum graphs over a smaller region of the sky. This will print out healpix pixels (nest ordering) over which to segment the sky. For each healpix segment one can now build a quantum graph:

build-high-resolution-hips-qg build -r REPO -p PIPELINE -c COLLECTIONS [COLLECTIONS] [-o HPIX_BUILD_ORDER] -f FILENAME -P PIXELS [PIXELS ...]

This will output a quantum graph covering PIXELS at order HPIX_BUILD_ORDER and output the graph to FILENAME. This quantum graph may now be used in a regular pipetask run.

Python API summary¶

from lsst.pipe.tasks.hips import HighResolutionHipsTask

classHighResolutionHipsTask(**kwargs): Task for making high resolution HiPS images...

attributeconfig: Access configuration fields and retargetable subtasks.

methodrun(pixels, coadd_exposure_handles): Run the HighResolutionHipsTask...

Retargetable subtasks¶

No subtasks.

Configuration fields¶

connections¶

Data type: lsst.pipe.base.config.Connections
Field type: ConfigField

Configurations describing the connections of the PipelineTask to datatypes

hips_order¶

Default: 11
Field type: int Field

HIPS image order.

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.

shift_order¶

Default: 9
Field type: int Field

HIPS shift order (such that each tile is 2**shift_order pixels on a side)

warp¶

Data type: lsst.afw.math._warper.WarperConfig
Field type: ConfigField

Warper configuration

Navigation