LSST Applications g00d0e8bbd7+edbf708997,g03191d30f7+6b31559d11,g118115db7c+ac820e85d2,g199a45376c+5137f08352,g1fd858c14a+90100aa1a7,g262e1987ae+64df5f6984,g29ae962dfc+1eb4aece83,g2cef7863aa+73c82f25e4,g3541666cd7+1e37cdad5c,g35bb328faa+edbf708997,g3fd5ace14f+fb4e2866cc,g47891489e3+19fcc35de2,g53246c7159+edbf708997,g5b326b94bb+d622351b67,g64539dfbff+dfe1dff262,g67b6fd64d1+19fcc35de2,g74acd417e5+cfdc02aca8,g786e29fd12+af89c03590,g7aefaa3e3d+dc1a598170,g87389fa792+a4172ec7da,g88cb488625+60ba2c3075,g89139ef638+19fcc35de2,g8d4809ba88+dfe1dff262,g8d7436a09f+db94b797be,g8ea07a8fe4+79658f16ab,g90f42f885a+6577634e1f,g9722cb1a7f+d8f85438e7,g98df359435+7fdd888faa,ga2180abaac+edbf708997,ga9e74d7ce9+128cc68277,gbf99507273+edbf708997,gca7fc764a6+19fcc35de2,gd7ef33dd92+19fcc35de2,gdab6d2f7ff+cfdc02aca8,gdbb4c4dda9+dfe1dff262,ge410e46f29+19fcc35de2,ge41e95a9f2+dfe1dff262,geaed405ab2+062dfc8cdc,w.2025.46
LSST Data Management Base Package
Loading...
Searching...
No Matches
lsst::afw::fits::QuantizationOptions Struct Reference

Options controlling quantization for image compression with FITS. More...

#include <fitsCompression.h>

Public Member Functions

bool uses_mask () const
 Whether this quantization configuration would make use of a Mask and the configured mask_planes.
 

Public Attributes

DitherAlgorithm dither = DitherAlgorithm::NO_DITHER_
 The method used to dither floating point values with random noise.
 
ScalingAlgorithm scaling = ScalingAlgorithm::STDEV_MASKED
 The algorithm used to determine the scaling for quantization.
 
std::vector< std::stringmask_planes = {"NO_DATA"}
 Mask planes to ignore when doing statistics.
 
float level = 0
 Target quantization level.
 
int seed = 0
 Random seed used for dithering.
 

Detailed Description

Options controlling quantization for image compression with FITS.

Definition at line 56 of file fitsCompression.h.

Member Function Documentation

◆ uses_mask()

bool lsst::afw::fits::QuantizationOptions::uses_mask ( ) const
inline

Whether this quantization configuration would make use of a Mask and the configured mask_planes.

Definition at line 86 of file fitsCompression.h.

86 {
87 switch (scaling) {
90 return true;
93 break;
94 };
95 return false;
96 }
@ RANGE
Scale to preserve dynamic range with bad pixels msasked out.
@ STDEV_MASKED
Scale based on the standard deviation with bad pixels masked out.
@ STDEV_CFITSIO
Let CFITSIO work out the scaling (per-tile; does not respect mask planes)
ScalingAlgorithm scaling
The algorithm used to determine the scaling for quantization.

Member Data Documentation

◆ dither

DitherAlgorithm lsst::afw::fits::QuantizationOptions::dither = DitherAlgorithm::NO_DITHER_

The method used to dither floating point values with random noise.

Definition at line 58 of file fitsCompression.h.

◆ level

float lsst::afw::fits::QuantizationOptions::level = 0

Target quantization level.

Interpretation depends on the scaling algorithm. For RANGE, this is ignored. For STDEV_*, this is the number of quantization levels within the standard deviation. For MANUAL, this is just ZSCALE, the factor the compressed integer values should be scaled by to (approximately) recover the original floating-point values.

Definition at line 75 of file fitsCompression.h.

◆ mask_planes

std::vector<std::string> lsst::afw::fits::QuantizationOptions::mask_planes = {"NO_DATA"}

Mask planes to ignore when doing statistics.

This is used by all STDEV_ algorithms except STDEV_CFITSIO.

Definition at line 66 of file fitsCompression.h.

66{"NO_DATA"};

◆ scaling

ScalingAlgorithm lsst::afw::fits::QuantizationOptions::scaling = ScalingAlgorithm::STDEV_MASKED

The algorithm used to determine the scaling for quantization.

Definition at line 61 of file fitsCompression.h.

◆ seed

int lsst::afw::fits::QuantizationOptions::seed = 0

Random seed used for dithering.

Must be between 1 and 10000 (inclusive) to be set explicitly; 0 signals that a random seed should be generated from the current time, and negative sets a random seed based on the checksum of the first tile.

Definition at line 82 of file fitsCompression.h.


The documentation for this struct was generated from the following file: