Home > ISET > vcamera > opticalImage > oiAdjustIlluminance.m

oiAdjustIlluminance

PURPOSE

Scale optical image mean illuminance to meanL

SYNOPSIS

function oi = oiAdjustIlluminance(oi,newLevel,stat)

DESCRIPTION

Scale optical image mean illuminance to meanL

  oi = oiAdjustIlluminance(oi,newLevel,[stat='mean'])

Purpose:
   Adjust the (mean or max) photon level in the optical structure so that
   the  mean illuminance level is newLevel, rather than the current level.  
   The fields oi.data.illuminance and oi.data.newLevel are updated as well.

 Example:
   OI = oiAdjustIlluminance(OI,10);
   OI = oiAdjustIlluminance(OI,100,'max');

 Copyright ImagEval Consultants, LLC, 2003.

CROSS-REFERENCE INFORMATION

This function calls:

oiGet Get properties and derived quantities from an optical image structure
oiSet Set ISET optical image parameter values

This function is called by:

oiInterpolateW Wavelength interpolation for optical image data