estimate_al_amestimate_al_amEstimateAlAmEstimateAlAmestimate_al_am (Operator)
Name
estimate_al_amestimate_al_amEstimateAlAmEstimateAlAmestimate_al_am — Estimate the albedo of a surface and the amount of ambient light.
Signature
def estimate_al_am(image: HObject) -> Tuple[Sequence[float], Sequence[float]]
def estimate_al_am_s(image: HObject) -> Tuple[float, float]
Description
estimate_al_amestimate_al_amEstimateAlAmEstimateAlAmestimate_al_am estimates the AlbedoAlbedoAlbedoalbedoalbedo of a
surface, i.e. the percentage of light reflected by the surface, and
the amount of ambient light AmbientAmbientAmbientambientambient by using the maximum
and minimum gray values of the image.
Attention
It is assumed that the image contains at least one point for which
the reflection function assumes its minimum, e.g., points in
shadows. Furthermore, it is assumed that the image contains at
least one point for which the reflection function assumes its
maximum. If this is not the case, wrong values will be
estimated.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Automatically parallelized on tuple level.
Parameters
ImageImageImageimageimage (input_object) singlechannelimage(-array) → objectHImageHObjectHObjectHobject (byte)
Image for which albedo and ambient are to be estimated.
AlbedoAlbedoAlbedoalbedoalbedo (output_control) real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Amount of light reflected by the surface.
AmbientAmbientAmbientambientambient (output_control) real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Amount of ambient light.
Result
estimate_al_amestimate_al_amEstimateAlAmEstimateAlAmestimate_al_am always returns the value 2 (
H_MSG_TRUE)
.
Possible Successors
sfs_mod_lrsfs_mod_lrSfsModLrSfsModLrsfs_mod_lr,
sfs_orig_lrsfs_orig_lrSfsOrigLrSfsOrigLrsfs_orig_lr,
sfs_pentlandsfs_pentlandSfsPentlandSfsPentlandsfs_pentland,
photometric_stereophotometric_stereoPhotometricStereoPhotometricStereophotometric_stereo,
shade_height_fieldshade_height_fieldShadeHeightFieldShadeHeightFieldshade_height_field
Module
3D Metrology