sourcextractor.config.measurement_images.MeasurementImage Class Reference

Inheritance diagram for sourcextractor.config.measurement_images.MeasurementImage:

Collaboration diagram for sourcextractor.config.measurement_images.MeasurementImage:

Public Member Functions
def	__init__
def	__str__

Public Attributes
	meta
	gain
	saturation
	flux_scale
	has_weight_threshold
	is_background_constant
	constant_background_value

Private Member Functions
def	_set_checked

Detailed Description

A MeasurementImage is the processing unit for SourceXtractor++. Measurements and model fitting can be done
over one, or many, of them. It models the image, plus its associated weight file, PSF, etc.

Parameters
----------
fits_file : str or FitsFile object
    The path to a FITS image, or an instance of FitsFile
psf_file : str
    The path to a PSF. It can be either a FITS image, or a PSFEx model.
weight_file : str or FitsFile
    The path to a FITS image with the pixel weights, or an instance of FitsFile
gain : float
    Image gain. If None, `gain_keyword` will be used instead.
gain_keyword : str
    Keyword for the header containing the gain.
saturation : float
    Saturation value. If None, `saturation_keyword` will be used instead.
saturation_keyword : str
    Keyword for the header containing the saturation value.
flux_scale : float
    Flux scaling. Each pixel value will be multiplied by this. If None, `flux_scale_keyword` will be used
    instead.
flux_scale_keyword : str
    Keyword for the header containing the flux scaling.
weight_type : str
    The type of the weight image. It must be one of:

        - none
            The image itself is used to compute internally a constant variance (default)
        - background
            The image itself is used to compute internally a variance map
        - rms
            The weight image must contain a weight-map in units of absolute standard deviations
            (in ADUs per pixel).
        - variance
            The weight image must contain a weight-map in units of relative variance.
        - weight
            The weight image must contain a weight-map in units of relative weights. The data are converted
            to variance units.
weight_absolute : bool
    If False, the weight map will be scaled according to an absolute variance map built from the image itself.
weight_scaling : float
    Apply an scaling to the weight map.
weight_threshold : float
    Pixels with weights beyond this value are treated just like pixels discarded by the masking process.
constant_background : float
    If set a constant background of that value is assumed for the image instead of using automatic detection
image_hdu : int
    For multi-extension FITS file specifies the HDU number for the image. Default 0 (primary HDU)
psf_hdu : int
    For multi-extension FITS file specifies the HDU number for the psf. Defaults to the same value as image_hdu
weight_hdu : int
    For multi-extension FITS file specifies the HDU number for the weight. Defaults to the same value as image_hdu

Definition at line 55 of file measurement_images.py.

Constructor & Destructor Documentation

def sourcextractor.config.measurement_images.MeasurementImage.__init__	(		self,
			fits_file,
			psf_file = None,
			weight_file = None,
			gain = None,
			gain_keyword = 'GAIN',
			saturation = None,
			saturation_keyword = 'SATURATE',
			flux_scale = None,
			flux_scale_keyword = 'FLXSCALE',
			weight_type = 'none',
			weight_absolute = False,
			weight_scaling = 1.,
			weight_threshold = None,
			constant_background = None,
			image_hdu = 0,
			psf_hdu = None,
			weight_hdu = None
	)

Constructor.

Definition at line 126 of file measurement_images.py.

Referenced by sourcextractor.config.measurement_images.MeasurementImage._set_checked().

Member Function Documentation

def sourcextractor.config.measurement_images.MeasurementImage.__str__

(

self

)

Returns
-------
str
    Human readable representation for the object

Definition at line 205 of file measurement_images.py.

References std::locale::id.id(), std::thread::id.id(), SourceXtractor::PyId.id, SourceXtractor::PyMeasurementImage.image_hdu, sourcextractor.config.measurement_images.MeasurementImage.meta, SourceXtractor::PyMeasurementImage.psf_hdu, and SourceXtractor::PyMeasurementImage.weight_hdu.

Here is the call graph for this function:

def sourcextractor.config.measurement_images.MeasurementImage._set_checked (   self,   attr_name,   value  )

private

Definition at line 112 of file measurement_images.py.

References sourcextractor.config.measurement_images.MeasurementImage.__init__().

Here is the call graph for this function:

Member Data Documentation

sourcextractor.config.measurement_images.MeasurementImage.constant_background_value

Definition at line 191 of file measurement_images.py.

sourcextractor.config.measurement_images.MeasurementImage.flux_scale

Definition at line 173 of file measurement_images.py.

sourcextractor.config.measurement_images.MeasurementImage.gain

Definition at line 159 of file measurement_images.py.

sourcextractor.config.measurement_images.MeasurementImage.has_weight_threshold

Definition at line 181 of file measurement_images.py.

sourcextractor.config.measurement_images.MeasurementImage.is_background_constant

Definition at line 187 of file measurement_images.py.

sourcextractor.config.measurement_images.MeasurementImage.meta

Definition at line 148 of file measurement_images.py.

Referenced by sourcextractor.config.measurement_images.MeasurementImage.__str__(), and sourcextractor.config.measurement_images.DataCubeSlice.__str__().

sourcextractor.config.measurement_images.MeasurementImage.saturation

Definition at line 166 of file measurement_images.py.

---

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

• SEImplementation/python/sourcextractor/config/measurement_images.py