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
-
class
HighResolutionHipsTask(**kwargs) Task for making high resolution HiPS images
...
- attributeconfig
Access configuration fields and retargetable subtasks.
See also
See the HighResolutionHipsTask API reference for complete details.
Retargetable subtasks¶
No subtasks.
Configuration fields¶
connections¶
- Data type
lsst.pipe.base.config.HighResolutionHipsConfigConnections- Field type
Configurations describing the connections of the PipelineTask to datatypes
hips_order¶
HIPS image order.
saveLogOutput¶
Flag to enable/disable saving of log output for a task, enabled by default.
saveMetadata¶
Flag to enable/disable metadata saving for a task, enabled by default. Deprecated: This field is deprecated and will be removed after v26.
shift_order¶
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
Warper configuration