🤖 AIによる機械翻訳（非公式） — これは OpenCV 4.13.0 公式リファレンス（英語）を AI (Claude) で自動翻訳したものです。訳に誤りを含む場合があります。正確な情報は公式英語版（原文）を参照してください。

java.lang.Object
- org.opencv.core.Algorithm
- - org.opencv.bioinspired.Retina

```
public class Retina
extends Algorithm
```
class which allows the Gipsa/Listic Labs model to be used with OpenCV. This retina model allows spatio-temporal image processing (applied on still images, video sequences). As a summary, these are the retina model properties:
- スペクトル白色化（中域周波数のディテール強調）を適用する
- 高周波の時空間ノイズの低減
- 低周波の輝度の低減（輝度レンジ圧縮）
- 局所的な対数輝度圧縮により、低照度条件下でディテールを強調できる
USE : this model can be used basically for spatio-temporal video effects but also for : _using the getParvo method output matrix : texture analysiswith enhanced signal to noise ratio and enhanced details robust against input images luminance ranges _using the getMagno method output matrix : motion analysis also with the previously cited properties for more information, reer to the following papers : Benoit A., Caplier A., Durette B., Herault, J., "USING HUMAN VISUAL SYSTEM MODELING FOR BIO-INSPIRED LOW LEVEL IMAGE PROCESSING", Elsevier, Computer Vision and Image Understanding 114 (2010), pp. 758-773, DOI: http://dx.doi.org/10.1016/j.cviu.2010.01.011 Vision: Images, Signals and Neural Networks: Models of Neural Processing in Visual Perception (Progress in Neural Processing),By: Jeanny Herault, ISBN: 9814273686. WAPI (Tower ID): 113266891. The retina filter includes the research contributions of phd/research collegues from which code has been redrawn by the author : take a look at the retinacolor.hpp module to discover Brice Chaix de Lavarene color mosaicing/demosaicing and the reference paper: B. Chaix de Lavarene, D. Alleysson, B. Durette, J. Herault (2007). "Efficient demosaicing through recursive filtering", IEEE International Conference on Image Processing ICIP 2007 take a look at imagelogpolprojection.hpp to discover retina spatial log sampling which originates from Barthelemy Durette phd with Jeanny Herault. A Retina / V1 cortex projection is also proposed and originates from Jeanny's discussions. more informations in the above cited Jeanny Heraults's book.

フィールドの要約
- クラス org.opencv.core.Algorithm から継承されたフィールド
  nativeObj

コンストラクタの要約

コンストラクタ
Modifier Constructor Description

protected Retina(long addr)

メソッドの要約

すべてのメソッド静的メソッドインスタンスメソッド具象メソッド
Modifier and Type	Method	Description
`static Retina`	`__fromPtr__(long addr)`
`void`	`activateContoursProcessing(boolean activate)`	Activate/desactivate the Parvocellular pathway processing (contours information extraction), by default, it is activated
`void`	`activateMovingContoursProcessing(boolean activate)`	Activate/desactivate the Magnocellular pathway processing (motion information extraction), by default, it is activated
`void`	`applyFastToneMapping(Mat inputImage, Mat outputToneMappedImage)`	Method which processes an image in the aim to correct its luminance correct backlight problems, enhance details in shadows.
`void`	`clearBuffers()`	Clears all retina buffers (equivalent to opening the eyes after a long period of eye close ;o) whatchout the temporal transition occuring just after this method call.
`static Retina`	`create(Size inputSize)`
`static Retina`	`create(Size inputSize, boolean colorMode)`	Constructors from standardized interfaces : retreive a smart pointer to a Retina instance
`static Retina`	`create(Size inputSize, boolean colorMode, int colorSamplingMethod)`	Constructors from standardized interfaces : retreive a smart pointer to a Retina instance
`static Retina`	`create(Size inputSize, boolean colorMode, int colorSamplingMethod, boolean useRetinaLogSampling)`	Constructors from standardized interfaces : retreive a smart pointer to a Retina instance
`static Retina`	`create(Size inputSize, boolean colorMode, int colorSamplingMethod, boolean useRetinaLogSampling, float reductionFactor)`	Constructors from standardized interfaces : retreive a smart pointer to a Retina instance
`static Retina`	`create(Size inputSize, boolean colorMode, int colorSamplingMethod, boolean useRetinaLogSampling, float reductionFactor, float samplingStrength)`	Constructors from standardized interfaces : retreive a smart pointer to a Retina instance
`Size`	`getInputSize()`	Retreive retina input buffer size
`void`	`getMagno(Mat retinaOutput_magno)`	Accessor of the motion channel of the retina (models peripheral vision).
`Mat`	`getMagnoRAW()`
`void`	`getMagnoRAW(Mat retinaOutput_magno)`	Accessor of the motion channel of the retina (models peripheral vision).
`Size`	`getOutputSize()`	Retreive retina output buffer size that can be different from the input if a spatial log transformation is applied
`void`	`getParvo(Mat retinaOutput_parvo)`	Accessor of the details channel of the retina (models foveal vision).
`Mat`	`getParvoRAW()`
`void`	`getParvoRAW(Mat retinaOutput_parvo)`	Accessor of the details channel of the retina (models foveal vision).
`java.lang.String`	`printSetup()`	Outputs a string showing the used parameters setup
`void`	`run(Mat inputImage)`	Method which allows retina to be applied on an input image, after run, encapsulated retina module is ready to deliver its outputs using dedicated acccessors, see getParvo and getMagno methods
`void`	`setColorSaturation()`	Activate color saturation as the final step of the color demultiplexing process -> this saturation is a sigmoide function applied to each channel of the demultiplexed image.
`void`	`setColorSaturation(boolean saturateColors)`	Activate color saturation as the final step of the color demultiplexing process -> this saturation is a sigmoide function applied to each channel of the demultiplexed image.
`void`	`setColorSaturation(boolean saturateColors, float colorSaturationValue)`	Activate color saturation as the final step of the color demultiplexing process -> this saturation is a sigmoide function applied to each channel of the demultiplexed image.
`void`	`setup()`	Try to open an XML retina parameters file to adjust current retina instance setup if the xml file does not exist, then default setup is applied warning, Exceptions are thrown if read XML file is not valid You can retrieve the current parameters structure using the method Retina::getParameters and update it before running method Retina::setup.
`void`	`setup(java.lang.String retinaParameterFile)`	Try to open an XML retina parameters file to adjust current retina instance setup if the xml file does not exist, then default setup is applied warning, Exceptions are thrown if read XML file is not valid
`void`	`setup(java.lang.String retinaParameterFile, boolean applyDefaultSetupOnFailure)`	Try to open an XML retina parameters file to adjust current retina instance setup if the xml file does not exist, then default setup is applied warning, Exceptions are thrown if read XML file is not valid
`void`	`setupIPLMagnoChannel()`	Set parameters values for the Inner Plexiform Layer (IPL) magnocellular channel this channel processes signals output from OPL processing stage in peripheral vision, it allows motion information enhancement.
`void`	`setupIPLMagnoChannel(boolean normaliseOutput)`	Set parameters values for the Inner Plexiform Layer (IPL) magnocellular channel this channel processes signals output from OPL processing stage in peripheral vision, it allows motion information enhancement.
`void`	`setupIPLMagnoChannel(boolean normaliseOutput, float parasolCells_beta)`	Set parameters values for the Inner Plexiform Layer (IPL) magnocellular channel this channel processes signals output from OPL processing stage in peripheral vision, it allows motion information enhancement.
`void`	`setupIPLMagnoChannel(boolean normaliseOutput, float parasolCells_beta, float parasolCells_tau)`	Set parameters values for the Inner Plexiform Layer (IPL) magnocellular channel this channel processes signals output from OPL processing stage in peripheral vision, it allows motion information enhancement.
`void`	`setupIPLMagnoChannel(boolean normaliseOutput, float parasolCells_beta, float parasolCells_tau, float parasolCells_k)`	Set parameters values for the Inner Plexiform Layer (IPL) magnocellular channel this channel processes signals output from OPL processing stage in peripheral vision, it allows motion information enhancement.
`void`	`setupIPLMagnoChannel(boolean normaliseOutput, float parasolCells_beta, float parasolCells_tau, float parasolCells_k, float amacrinCellsTemporalCutFrequency)`	Set parameters values for the Inner Plexiform Layer (IPL) magnocellular channel this channel processes signals output from OPL processing stage in peripheral vision, it allows motion information enhancement.
`void`	`setupIPLMagnoChannel(boolean normaliseOutput, float parasolCells_beta, float parasolCells_tau, float parasolCells_k, float amacrinCellsTemporalCutFrequency, float V0CompressionParameter)`	Set parameters values for the Inner Plexiform Layer (IPL) magnocellular channel this channel processes signals output from OPL processing stage in peripheral vision, it allows motion information enhancement.
`void`	`setupIPLMagnoChannel(boolean normaliseOutput, float parasolCells_beta, float parasolCells_tau, float parasolCells_k, float amacrinCellsTemporalCutFrequency, float V0CompressionParameter, float localAdaptintegration_tau)`	Set parameters values for the Inner Plexiform Layer (IPL) magnocellular channel this channel processes signals output from OPL processing stage in peripheral vision, it allows motion information enhancement.
`void`	`setupIPLMagnoChannel(boolean normaliseOutput, float parasolCells_beta, float parasolCells_tau, float parasolCells_k, float amacrinCellsTemporalCutFrequency, float V0CompressionParameter, float localAdaptintegration_tau, float localAdaptintegration_k)`	Set parameters values for the Inner Plexiform Layer (IPL) magnocellular channel this channel processes signals output from OPL processing stage in peripheral vision, it allows motion information enhancement.
`void`	`setupOPLandIPLParvoChannel()`	Setup the OPL and IPL parvo channels (see biologocal model) OPL is referred as Outer Plexiform Layer of the retina, it allows the spatio-temporal filtering which withens the spectrum and reduces spatio-temporal noise while attenuating global luminance (low frequency energy) IPL parvo is the OPL next processing stage, it refers to a part of the Inner Plexiform layer of the retina, it allows high contours sensitivity in foveal vision.
`void`	`setupOPLandIPLParvoChannel(boolean colorMode)`	Setup the OPL and IPL parvo channels (see biologocal model) OPL is referred as Outer Plexiform Layer of the retina, it allows the spatio-temporal filtering which withens the spectrum and reduces spatio-temporal noise while attenuating global luminance (low frequency energy) IPL parvo is the OPL next processing stage, it refers to a part of the Inner Plexiform layer of the retina, it allows high contours sensitivity in foveal vision.
`void`	`setupOPLandIPLParvoChannel(boolean colorMode, boolean normaliseOutput)`	Setup the OPL and IPL parvo channels (see biologocal model) OPL is referred as Outer Plexiform Layer of the retina, it allows the spatio-temporal filtering which withens the spectrum and reduces spatio-temporal noise while attenuating global luminance (low frequency energy) IPL parvo is the OPL next processing stage, it refers to a part of the Inner Plexiform layer of the retina, it allows high contours sensitivity in foveal vision.
`void`	`setupOPLandIPLParvoChannel(boolean colorMode, boolean normaliseOutput, float photoreceptorsLocalAdaptationSensitivity)`	Setup the OPL and IPL parvo channels (see biologocal model) OPL is referred as Outer Plexiform Layer of the retina, it allows the spatio-temporal filtering which withens the spectrum and reduces spatio-temporal noise while attenuating global luminance (low frequency energy) IPL parvo is the OPL next processing stage, it refers to a part of the Inner Plexiform layer of the retina, it allows high contours sensitivity in foveal vision.
`void`	`setupOPLandIPLParvoChannel(boolean colorMode, boolean normaliseOutput, float photoreceptorsLocalAdaptationSensitivity, float photoreceptorsTemporalConstant)`	Setup the OPL and IPL parvo channels (see biologocal model) OPL is referred as Outer Plexiform Layer of the retina, it allows the spatio-temporal filtering which withens the spectrum and reduces spatio-temporal noise while attenuating global luminance (low frequency energy) IPL parvo is the OPL next processing stage, it refers to a part of the Inner Plexiform layer of the retina, it allows high contours sensitivity in foveal vision.
`void`	`setupOPLandIPLParvoChannel(boolean colorMode, boolean normaliseOutput, float photoreceptorsLocalAdaptationSensitivity, float photoreceptorsTemporalConstant, float photoreceptorsSpatialConstant)`	Setup the OPL and IPL parvo channels (see biologocal model) OPL is referred as Outer Plexiform Layer of the retina, it allows the spatio-temporal filtering which withens the spectrum and reduces spatio-temporal noise while attenuating global luminance (low frequency energy) IPL parvo is the OPL next processing stage, it refers to a part of the Inner Plexiform layer of the retina, it allows high contours sensitivity in foveal vision.
`void`	`setupOPLandIPLParvoChannel(boolean colorMode, boolean normaliseOutput, float photoreceptorsLocalAdaptationSensitivity, float photoreceptorsTemporalConstant, float photoreceptorsSpatialConstant, float horizontalCellsGain)`	Setup the OPL and IPL parvo channels (see biologocal model) OPL is referred as Outer Plexiform Layer of the retina, it allows the spatio-temporal filtering which withens the spectrum and reduces spatio-temporal noise while attenuating global luminance (low frequency energy) IPL parvo is the OPL next processing stage, it refers to a part of the Inner Plexiform layer of the retina, it allows high contours sensitivity in foveal vision.
`void`	`setupOPLandIPLParvoChannel(boolean colorMode, boolean normaliseOutput, float photoreceptorsLocalAdaptationSensitivity, float photoreceptorsTemporalConstant, float photoreceptorsSpatialConstant, float horizontalCellsGain, float HcellsTemporalConstant)`	Setup the OPL and IPL parvo channels (see biologocal model) OPL is referred as Outer Plexiform Layer of the retina, it allows the spatio-temporal filtering which withens the spectrum and reduces spatio-temporal noise while attenuating global luminance (low frequency energy) IPL parvo is the OPL next processing stage, it refers to a part of the Inner Plexiform layer of the retina, it allows high contours sensitivity in foveal vision.
`void`	`setupOPLandIPLParvoChannel(boolean colorMode, boolean normaliseOutput, float photoreceptorsLocalAdaptationSensitivity, float photoreceptorsTemporalConstant, float photoreceptorsSpatialConstant, float horizontalCellsGain, float HcellsTemporalConstant, float HcellsSpatialConstant)`	Setup the OPL and IPL parvo channels (see biologocal model) OPL is referred as Outer Plexiform Layer of the retina, it allows the spatio-temporal filtering which withens the spectrum and reduces spatio-temporal noise while attenuating global luminance (low frequency energy) IPL parvo is the OPL next processing stage, it refers to a part of the Inner Plexiform layer of the retina, it allows high contours sensitivity in foveal vision.
`void`	`setupOPLandIPLParvoChannel(boolean colorMode, boolean normaliseOutput, float photoreceptorsLocalAdaptationSensitivity, float photoreceptorsTemporalConstant, float photoreceptorsSpatialConstant, float horizontalCellsGain, float HcellsTemporalConstant, float HcellsSpatialConstant, float ganglionCellsSensitivity)`	Setup the OPL and IPL parvo channels (see biologocal model) OPL is referred as Outer Plexiform Layer of the retina, it allows the spatio-temporal filtering which withens the spectrum and reduces spatio-temporal noise while attenuating global luminance (low frequency energy) IPL parvo is the OPL next processing stage, it refers to a part of the Inner Plexiform layer of the retina, it allows high contours sensitivity in foveal vision.
`void`	`write(java.lang.String fs)`	Write xml/yml formated parameters information

クラス org.opencv.core.Algorithm から継承されたメソッド
clear, empty, getDefaultName, getNativeObjAddr, save

クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - Retina
```
protected Retina(long addr)
```
- メソッドの詳細
  - __fromPtr__
```
public static Retina __fromPtr__(long addr)
```
  - getInputSize
```
public Size getInputSize()
```
    Retreive retina input buffer size
    
    戻り値:
    
    網膜の入力バッファサイズ
  - getOutputSize
```
public Size getOutputSize()
```
    Retreive retina output buffer size that can be different from the input if a spatial log transformation is applied
    
    戻り値:
    
    網膜の出力バッファサイズ
  - setup
```
public void setup(java.lang.String retinaParameterFile,
                  boolean applyDefaultSetupOnFailure)
```
    Try to open an XML retina parameters file to adjust current retina instance setup
    
    xmlファイルが存在しない場合は、デフォルト設定が適用される
    
    警告。読み込んだXMLファイルが正しくない場合は例外がスローされる
    引数:
    
    retinaParameterFile - パラメータファイル名
    
    applyDefaultSetupOnFailure - エラー時に例外をスローする必要がある場合はtrueに設定する。現在のパラメータ構造体はメソッドRetina::getParametersで取得でき、メソッドRetina::setupを実行する前に更新できる。
  - setup
```
public void setup(java.lang.String retinaParameterFile)
```
    Try to open an XML retina parameters file to adjust current retina instance setup
    
    xmlファイルが存在しない場合は、デフォルト設定が適用される
    
    警告。読み込んだXMLファイルが正しくない場合は例外がスローされる
    引数:
    
    retinaParameterFile - パラメータファイル名。現在のパラメータ構造体はメソッドRetina::getParametersで取得でき、メソッドRetina::setupを実行する前に更新できる。
  - setup
```
public void setup()
```
    Try to open an XML retina parameters file to adjust current retina instance setup
    
    xmlファイルが存在しない場合は、デフォルト設定が適用される
    
    警告。読み込んだXMLファイルが正しくない場合は例外がスローされる
    
    You can retrieve the current parameters structure using the method Retina::getParameters and update it before running method Retina::setup.
  - printSetup
```
public java.lang.String printSetup()
```
    Outputs a string showing the used parameters setup
    
    戻り値:
    
    整形されたパラメータ情報を含む文字列
  - write
```
public void write(java.lang.String fs)
```
    Write xml/yml formated parameters information
    
    引数:
    
    fs - フォーマットされたパラメータ情報を開いて書き込むxmlファイルのファイル名
  - setupOPLandIPLParvoChannel
```
public void setupOPLandIPLParvoChannel(boolean colorMode,
                                       boolean normaliseOutput,
                                       float photoreceptorsLocalAdaptationSensitivity,
                                       float photoreceptorsTemporalConstant,
                                       float photoreceptorsSpatialConstant,
                                       float horizontalCellsGain,
                                       float HcellsTemporalConstant,
                                       float HcellsSpatialConstant,
                                       float ganglionCellsSensitivity)
```
    Setup the OPL and IPL parvo channels (see biologocal model) OPL is referred as Outer Plexiform Layer of the retina, it allows the spatio-temporal filtering which withens the spectrum and reduces spatio-temporal noise while attenuating global luminance (low frequency energy) IPL parvo is the OPL next processing stage, it refers to a part of the Inner Plexiform layer of the retina, it allows high contours sensitivity in foveal vision. See reference papers for more informations. for more informations, please have a look at the paper Benoit A., Caplier A., Durette B., Herault, J., "USING HUMAN VISUAL SYSTEM MODELING FOR BIO-INSPIRED LOW LEVEL IMAGE PROCESSING", Elsevier, Computer Vision and Image Understanding 114 (2010), pp. 758-773, DOI: http://dx.doi.org/10.1016/j.cviu.2010.01.011
    
    引数:
    
    colorMode - カラー処理を行うか(true)、行わずグレーレベル画像を処理するか(false)を指定する
    
    normaliseOutput - 出力を0から255の範囲に再スケーリングするか(true)、しないか(false)を指定する
    
    photoreceptorsLocalAdaptationSensitivity - 光受容体の感度。範囲は0-1(値が増えるほど対数圧縮効果が強くなる)
    
    photoreceptorsTemporalConstant - 光受容体の一次ローパスフィルタの時定数。高い時間周波数(ノイズや速い動き)をカットするために使う。単位はフレームで、代表値は1フレーム
    
    photoreceptorsSpatialConstant - 光受容体の一次ローパスフィルタの空間定数。高い空間周波数(ノイズや太い輪郭)をカットするために使う。単位はピクセルで、代表値は1ピクセル
    
    horizontalCellsGain - 水平細胞ネットワークのゲイン。0なら出力の平均値はゼロになり、パラメータが1に近いと輝度はフィルタされず出力でもなお到達可能になる。代表値は0
    
    HcellsTemporalConstant - 水平細胞の一次ローパスフィルタの時定数。低い時間周波数(局所的な輝度変動)をカットするために使う。単位はフレームで、光受容体と同様に代表値は1フレーム
    
    HcellsSpatialConstant - 水平細胞の一次ローパスフィルタの空間定数。低い空間周波数(局所的な輝度)をカットするために使う。単位はピクセルで、代表値は5ピクセル。この値は神経節細胞レベル(内網状層の小細胞チャンネルモデル)で局所コントラスト適応を計算する際の局所コントラスト計算にも使われる
    
    ganglionCellsSensitivity - 神経節細胞の局所適応出力の圧縮強度。最良の結果を得るには0.6から1の値を設定する。高い値ほど低い値の感度をより高めるが、出力はより速く飽和する。推奨値は0.7
  - setupOPLandIPLParvoChannel
```
public void setupOPLandIPLParvoChannel(boolean colorMode,
                                       boolean normaliseOutput,
                                       float photoreceptorsLocalAdaptationSensitivity,
                                       float photoreceptorsTemporalConstant,
                                       float photoreceptorsSpatialConstant,
                                       float horizontalCellsGain,
                                       float HcellsTemporalConstant,
                                       float HcellsSpatialConstant)
```
    Setup the OPL and IPL parvo channels (see biologocal model) OPL is referred as Outer Plexiform Layer of the retina, it allows the spatio-temporal filtering which withens the spectrum and reduces spatio-temporal noise while attenuating global luminance (low frequency energy) IPL parvo is the OPL next processing stage, it refers to a part of the Inner Plexiform layer of the retina, it allows high contours sensitivity in foveal vision. See reference papers for more informations. for more informations, please have a look at the paper Benoit A., Caplier A., Durette B., Herault, J., "USING HUMAN VISUAL SYSTEM MODELING FOR BIO-INSPIRED LOW LEVEL IMAGE PROCESSING", Elsevier, Computer Vision and Image Understanding 114 (2010), pp. 758-773, DOI: http://dx.doi.org/10.1016/j.cviu.2010.01.011
    
    引数:
    
    colorMode - カラー処理を行うか(true)、行わずグレーレベル画像を処理するか(false)を指定する
    
    normaliseOutput - 出力を0から255の範囲に再スケーリングするか(true)、しないか(false)を指定する
    
    photoreceptorsLocalAdaptationSensitivity - 光受容体の感度。範囲は0-1(値が増えるほど対数圧縮効果が強くなる)
    
    photoreceptorsTemporalConstant - 光受容体の一次ローパスフィルタの時定数。高い時間周波数(ノイズや速い動き)をカットするために使う。単位はフレームで、代表値は1フレーム
    
    photoreceptorsSpatialConstant - 光受容体の一次ローパスフィルタの空間定数。高い空間周波数(ノイズや太い輪郭)をカットするために使う。単位はピクセルで、代表値は1ピクセル
    
    horizontalCellsGain - 水平細胞ネットワークのゲイン。0なら出力の平均値はゼロになり、パラメータが1に近いと輝度はフィルタされず出力でもなお到達可能になる。代表値は0
    
    HcellsTemporalConstant - 水平細胞の一次ローパスフィルタの時定数。低い時間周波数(局所的な輝度変動)をカットするために使う。単位はフレームで、光受容体と同様に代表値は1フレーム
    
    HcellsSpatialConstant - 水平細胞の一次ローパスフィルタの空間定数。低い空間周波数(局所的な輝度)をカットするために使う。単位はピクセルで、代表値は5ピクセル。この値は神経節細胞レベル(内網状層の小細胞チャンネルモデル)で局所コントラスト適応を計算する際の局所コントラスト計算にも使われる。出力。最良の結果を得るには0.6から1の値を設定する。高い値ほど低い値の感度をより高めるが、出力はより速く飽和する。推奨値は0.7
  - setupOPLandIPLParvoChannel
```
public void setupOPLandIPLParvoChannel(boolean colorMode,
                                       boolean normaliseOutput,
                                       float photoreceptorsLocalAdaptationSensitivity,
                                       float photoreceptorsTemporalConstant,
                                       float photoreceptorsSpatialConstant,
                                       float horizontalCellsGain,
                                       float HcellsTemporalConstant)
```
    Setup the OPL and IPL parvo channels (see biologocal model) OPL is referred as Outer Plexiform Layer of the retina, it allows the spatio-temporal filtering which withens the spectrum and reduces spatio-temporal noise while attenuating global luminance (low frequency energy) IPL parvo is the OPL next processing stage, it refers to a part of the Inner Plexiform layer of the retina, it allows high contours sensitivity in foveal vision. See reference papers for more informations. for more informations, please have a look at the paper Benoit A., Caplier A., Durette B., Herault, J., "USING HUMAN VISUAL SYSTEM MODELING FOR BIO-INSPIRED LOW LEVEL IMAGE PROCESSING", Elsevier, Computer Vision and Image Understanding 114 (2010), pp. 758-773, DOI: http://dx.doi.org/10.1016/j.cviu.2010.01.011
    
    引数:
    
    colorMode - カラー処理を行うか(true)、行わずグレーレベル画像を処理するか(false)を指定する
    
    normaliseOutput - 出力を0から255の範囲に再スケーリングするか(true)、しないか(false)を指定する
    
    photoreceptorsLocalAdaptationSensitivity - 光受容体の感度。範囲は0-1(値が増えるほど対数圧縮効果が強くなる)
    
    photoreceptorsTemporalConstant - 光受容体の一次ローパスフィルタの時定数。高い時間周波数(ノイズや速い動き)をカットするために使う。単位はフレームで、代表値は1フレーム
    
    photoreceptorsSpatialConstant - 光受容体の一次ローパスフィルタの空間定数。高い空間周波数(ノイズや太い輪郭)をカットするために使う。単位はピクセルで、代表値は1ピクセル
    
    horizontalCellsGain - 水平細胞ネットワークのゲイン。0なら出力の平均値はゼロになり、パラメータが1に近いと輝度はフィルタされず出力でもなお到達可能になる。代表値は0
    
    HcellsTemporalConstant - 水平細胞の一次ローパスフィルタの時定数。低い時間周波数(局所的な輝度変動)をカットするために使う。単位はフレームで、光受容体と同様に代表値は1フレーム。水平細胞。低い空間周波数(局所的な輝度)をカットするために使う。単位はピクセルで、代表値は5ピクセル。この値は神経節細胞レベル(内網状層の小細胞チャンネルモデル)で局所コントラスト適応を計算する際の局所コントラスト計算にも使われる。出力。最良の結果を得るには0.6から1の値を設定する。高い値ほど低い値の感度をより高めるが、出力はより速く飽和する。推奨値は0.7
  - setupOPLandIPLParvoChannel
```
public void setupOPLandIPLParvoChannel(boolean colorMode,
                                       boolean normaliseOutput,
                                       float photoreceptorsLocalAdaptationSensitivity,
                                       float photoreceptorsTemporalConstant,
                                       float photoreceptorsSpatialConstant,
                                       float horizontalCellsGain)
```
    Setup the OPL and IPL parvo channels (see biologocal model) OPL is referred as Outer Plexiform Layer of the retina, it allows the spatio-temporal filtering which withens the spectrum and reduces spatio-temporal noise while attenuating global luminance (low frequency energy) IPL parvo is the OPL next processing stage, it refers to a part of the Inner Plexiform layer of the retina, it allows high contours sensitivity in foveal vision. See reference papers for more informations. for more informations, please have a look at the paper Benoit A., Caplier A., Durette B., Herault, J., "USING HUMAN VISUAL SYSTEM MODELING FOR BIO-INSPIRED LOW LEVEL IMAGE PROCESSING", Elsevier, Computer Vision and Image Understanding 114 (2010), pp. 758-773, DOI: http://dx.doi.org/10.1016/j.cviu.2010.01.011
    
    引数:
    
    colorMode - カラー処理を行うか(true)、行わずグレーレベル画像を処理するか(false)を指定する
    
    normaliseOutput - 出力を0から255の範囲に再スケーリングするか(true)、しないか(false)を指定する
    
    photoreceptorsLocalAdaptationSensitivity - 光受容体の感度。範囲は0-1(値が増えるほど対数圧縮効果が強くなる)
    
    photoreceptorsTemporalConstant - 光受容体の一次ローパスフィルタの時定数。高い時間周波数(ノイズや速い動き)をカットするために使う。単位はフレームで、代表値は1フレーム
    
    photoreceptorsSpatialConstant - 光受容体の一次ローパスフィルタの空間定数。高い空間周波数(ノイズや太い輪郭)をカットするために使う。単位はピクセルで、代表値は1ピクセル
    
    horizontalCellsGain - 水平細胞ネットワークのゲイン。0なら出力の平均値はゼロになり、パラメータが1に近いと輝度はフィルタされず出力でもなお到達可能になる。代表値は0。水平細胞。低い時間周波数(局所的な輝度変動)をカットするために使う。単位はフレームで、光受容体と同様に代表値は1フレーム。水平細胞。低い空間周波数(局所的な輝度)をカットするために使う。単位はピクセルで、代表値は5ピクセル。この値は神経節細胞レベル(内網状層の小細胞チャンネルモデル)で局所コントラスト適応を計算する際の局所コントラスト計算にも使われる。出力。最良の結果を得るには0.6から1の値を設定する。高い値ほど低い値の感度をより高めるが、出力はより速く飽和する。推奨値は0.7
  - setupOPLandIPLParvoChannel
```
public void setupOPLandIPLParvoChannel(boolean colorMode,
                                       boolean normaliseOutput,
                                       float photoreceptorsLocalAdaptationSensitivity,
                                       float photoreceptorsTemporalConstant,
                                       float photoreceptorsSpatialConstant)
```
    Setup the OPL and IPL parvo channels (see biologocal model) OPL is referred as Outer Plexiform Layer of the retina, it allows the spatio-temporal filtering which withens the spectrum and reduces spatio-temporal noise while attenuating global luminance (low frequency energy) IPL parvo is the OPL next processing stage, it refers to a part of the Inner Plexiform layer of the retina, it allows high contours sensitivity in foveal vision. See reference papers for more informations. for more informations, please have a look at the paper Benoit A., Caplier A., Durette B., Herault, J., "USING HUMAN VISUAL SYSTEM MODELING FOR BIO-INSPIRED LOW LEVEL IMAGE PROCESSING", Elsevier, Computer Vision and Image Understanding 114 (2010), pp. 758-773, DOI: http://dx.doi.org/10.1016/j.cviu.2010.01.011
    
    引数:
    
    colorMode - カラー処理を行うか(true)、行わずグレーレベル画像を処理するか(false)を指定する
    
    normaliseOutput - 出力を0から255の範囲に再スケーリングするか(true)、しないか(false)を指定する
    
    photoreceptorsLocalAdaptationSensitivity - 光受容体の感度。範囲は0-1(値が増えるほど対数圧縮効果が強くなる)
    
    photoreceptorsTemporalConstant - 光受容体の一次ローパスフィルタの時定数。高い時間周波数(ノイズや速い動き)をカットするために使う。単位はフレームで、代表値は1フレーム
    
    photoreceptorsSpatialConstant - 光受容体の一次ローパスフィルタの空間定数。高い空間周波数(ノイズや太い輪郭)をカットするために使う。単位はピクセルで、代表値は1ピクセル。出力の平均値はゼロになり、パラメータが1に近いと輝度はフィルタされず出力でもなお到達可能になる。代表値は0。水平細胞。低い時間周波数(局所的な輝度変動)をカットするために使う。単位はフレームで、光受容体と同様に代表値は1フレーム。水平細胞。低い空間周波数(局所的な輝度)をカットするために使う。単位はピクセルで、代表値は5ピクセル。この値は神経節細胞レベル(内網状層の小細胞チャンネルモデル)で局所コントラスト適応を計算する際の局所コントラスト計算にも使われる。出力。最良の結果を得るには0.6から1の値を設定する。高い値ほど低い値の感度をより高めるが、出力はより速く飽和する。推奨値は0.7
  - setupOPLandIPLParvoChannel
```
public void setupOPLandIPLParvoChannel(boolean colorMode,
                                       boolean normaliseOutput,
                                       float photoreceptorsLocalAdaptationSensitivity,
                                       float photoreceptorsTemporalConstant)
```
    Setup the OPL and IPL parvo channels (see biologocal model) OPL is referred as Outer Plexiform Layer of the retina, it allows the spatio-temporal filtering which withens the spectrum and reduces spatio-temporal noise while attenuating global luminance (low frequency energy) IPL parvo is the OPL next processing stage, it refers to a part of the Inner Plexiform layer of the retina, it allows high contours sensitivity in foveal vision. See reference papers for more informations. for more informations, please have a look at the paper Benoit A., Caplier A., Durette B., Herault, J., "USING HUMAN VISUAL SYSTEM MODELING FOR BIO-INSPIRED LOW LEVEL IMAGE PROCESSING", Elsevier, Computer Vision and Image Understanding 114 (2010), pp. 758-773, DOI: http://dx.doi.org/10.1016/j.cviu.2010.01.011
    
    引数:
    
    colorMode - カラー処理を行うか(true)、行わずグレーレベル画像を処理するか(false)を指定する
    
    normaliseOutput - 出力を0から255の範囲に再スケーリングするか(true)、しないか(false)を指定する
    
    photoreceptorsLocalAdaptationSensitivity - 光受容体の感度。範囲は0-1(値が増えるほど対数圧縮効果が強くなる)
    
    photoreceptorsTemporalConstant - 光受容体の一次ローパスフィルタの時定数。高い時間周波数(ノイズや速い動き)をカットするために使う。単位はフレームで、代表値は1フレーム。光受容体。高い空間周波数(ノイズや太い輪郭)をカットするために使う。単位はピクセルで、代表値は1ピクセル。出力の平均値はゼロになり、パラメータが1に近いと輝度はフィルタされず出力でもなお到達可能になる。代表値は0。水平細胞。低い時間周波数(局所的な輝度変動)をカットするために使う。単位はフレームで、光受容体と同様に代表値は1フレーム。水平細胞。低い空間周波数(局所的な輝度)をカットするために使う。単位はピクセルで、代表値は5ピクセル。この値は神経節細胞レベル(内網状層の小細胞チャンネルモデル)で局所コントラスト適応を計算する際の局所コントラスト計算にも使われる。出力。最良の結果を得るには0.6から1の値を設定する。高い値ほど低い値の感度をより高めるが、出力はより速く飽和する。推奨値は0.7
  - setupOPLandIPLParvoChannel
```
public void setupOPLandIPLParvoChannel(boolean colorMode,
                                       boolean normaliseOutput,
                                       float photoreceptorsLocalAdaptationSensitivity)
```
    Setup the OPL and IPL parvo channels (see biologocal model) OPL is referred as Outer Plexiform Layer of the retina, it allows the spatio-temporal filtering which withens the spectrum and reduces spatio-temporal noise while attenuating global luminance (low frequency energy) IPL parvo is the OPL next processing stage, it refers to a part of the Inner Plexiform layer of the retina, it allows high contours sensitivity in foveal vision. See reference papers for more informations. for more informations, please have a look at the paper Benoit A., Caplier A., Durette B., Herault, J., "USING HUMAN VISUAL SYSTEM MODELING FOR BIO-INSPIRED LOW LEVEL IMAGE PROCESSING", Elsevier, Computer Vision and Image Understanding 114 (2010), pp. 758-773, DOI: http://dx.doi.org/10.1016/j.cviu.2010.01.011
    
    引数:
    
    colorMode - カラー処理を行うか(true)、行わずグレーレベル画像を処理するか(false)を指定する
    
    normaliseOutput - 出力を0から255の範囲に再スケーリングするか(true)、しないか(false)を指定する
    
    photoreceptorsLocalAdaptationSensitivity - 光受容体の感度。範囲は0-1(値が増えるほど対数圧縮効果が強くなる)。光受容体。高い時間周波数(ノイズや速い動き)をカットするために使う。単位はフレームで、代表値は1フレーム。光受容体。高い空間周波数(ノイズや太い輪郭)をカットするために使う。単位はピクセルで、代表値は1ピクセル。出力の平均値はゼロになり、パラメータが1に近いと輝度はフィルタされず出力でもなお到達可能になる。代表値は0。水平細胞。低い時間周波数(局所的な輝度変動)をカットするために使う。単位はフレームで、光受容体と同様に代表値は1フレーム。水平細胞。低い空間周波数(局所的な輝度)をカットするために使う。単位はピクセルで、代表値は5ピクセル。この値は神経節細胞レベル(内網状層の小細胞チャンネルモデル)で局所コントラスト適応を計算する際の局所コントラスト計算にも使われる。出力。最良の結果を得るには0.6から1の値を設定する。高い値ほど低い値の感度をより高めるが、出力はより速く飽和する。推奨値は0.7
  - setupOPLandIPLParvoChannel
```
public void setupOPLandIPLParvoChannel(boolean colorMode,
                                       boolean normaliseOutput)
```
    Setup the OPL and IPL parvo channels (see biologocal model) OPL is referred as Outer Plexiform Layer of the retina, it allows the spatio-temporal filtering which withens the spectrum and reduces spatio-temporal noise while attenuating global luminance (low frequency energy) IPL parvo is the OPL next processing stage, it refers to a part of the Inner Plexiform layer of the retina, it allows high contours sensitivity in foveal vision. See reference papers for more informations. for more informations, please have a look at the paper Benoit A., Caplier A., Durette B., Herault, J., "USING HUMAN VISUAL SYSTEM MODELING FOR BIO-INSPIRED LOW LEVEL IMAGE PROCESSING", Elsevier, Computer Vision and Image Understanding 114 (2010), pp. 758-773, DOI: http://dx.doi.org/10.1016/j.cviu.2010.01.011
    
    引数:
    
    colorMode - カラー処理を行うか(true)、行わずグレーレベル画像を処理するか(false)を指定する
    
    normaliseOutput - 出力を0から255の範囲に再スケーリングするか(true)、しないか(false)を指定する(値が増えるほど対数圧縮効果が強くなる)。光受容体。高い時間周波数(ノイズや速い動き)をカットするために使う。単位はフレームで、代表値は1フレーム。光受容体。高い空間周波数(ノイズや太い輪郭)をカットするために使う。単位はピクセルで、代表値は1ピクセル。出力の平均値はゼロになり、パラメータが1に近いと輝度はフィルタされず出力でもなお到達可能になる。代表値は0。水平細胞。低い時間周波数(局所的な輝度変動)をカットするために使う。単位はフレームで、光受容体と同様に代表値は1フレーム。水平細胞。低い空間周波数(局所的な輝度)をカットするために使う。単位はピクセルで、代表値は5ピクセル。この値は神経節細胞レベル(内網状層の小細胞チャンネルモデル)で局所コントラスト適応を計算する際の局所コントラスト計算にも使われる。出力。最良の結果を得るには0.6から1の値を設定する。高い値ほど低い値の感度をより高めるが、出力はより速く飽和する。推奨値は0.7
  - setupOPLandIPLParvoChannel
```
public void setupOPLandIPLParvoChannel(boolean colorMode)
```
    Setup the OPL and IPL parvo channels (see biologocal model) OPL is referred as Outer Plexiform Layer of the retina, it allows the spatio-temporal filtering which withens the spectrum and reduces spatio-temporal noise while attenuating global luminance (low frequency energy) IPL parvo is the OPL next processing stage, it refers to a part of the Inner Plexiform layer of the retina, it allows high contours sensitivity in foveal vision. See reference papers for more informations. for more informations, please have a look at the paper Benoit A., Caplier A., Durette B., Herault, J., "USING HUMAN VISUAL SYSTEM MODELING FOR BIO-INSPIRED LOW LEVEL IMAGE PROCESSING", Elsevier, Computer Vision and Image Understanding 114 (2010), pp. 758-773, DOI: http://dx.doi.org/10.1016/j.cviu.2010.01.011
    
    引数:
    
    colorMode - カラー処理を行うか(true)、行わずグレーレベル画像を処理するか(false)を指定する(値が増えるほど対数圧縮効果が強くなる)。光受容体。高い時間周波数(ノイズや速い動き)をカットするために使う。単位はフレームで、代表値は1フレーム。光受容体。高い空間周波数(ノイズや太い輪郭)をカットするために使う。単位はピクセルで、代表値は1ピクセル。出力の平均値はゼロになり、パラメータが1に近いと輝度はフィルタされず出力でもなお到達可能になる。代表値は0。水平細胞。低い時間周波数(局所的な輝度変動)をカットするために使う。単位はフレームで、光受容体と同様に代表値は1フレーム。水平細胞。低い空間周波数(局所的な輝度)をカットするために使う。単位はピクセルで、代表値は5ピクセル。この値は神経節細胞レベル(内網状層の小細胞チャンネルモデル)で局所コントラスト適応を計算する際の局所コントラスト計算にも使われる。出力。最良の結果を得るには0.6から1の値を設定する。高い値ほど低い値の感度をより高めるが、出力はより速く飽和する。推奨値は0.7
  - setupOPLandIPLParvoChannel
```
public void setupOPLandIPLParvoChannel()
```
    Setup the OPL and IPL parvo channels (see biologocal model) OPL is referred as Outer Plexiform Layer of the retina, it allows the spatio-temporal filtering which withens the spectrum and reduces spatio-temporal noise while attenuating global luminance (low frequency energy) IPL parvo is the OPL next processing stage, it refers to a part of the Inner Plexiform layer of the retina, it allows high contours sensitivity in foveal vision. See reference papers for more informations. for more informations, please have a look at the paper Benoit A., Caplier A., Durette B., Herault, J., "USING HUMAN VISUAL SYSTEM MODELING FOR BIO-INSPIRED LOW LEVEL IMAGE PROCESSING", Elsevier, Computer Vision and Image Understanding 114 (2010), pp. 758-773, DOI: http://dx.doi.org/10.1016/j.cviu.2010.01.011 level image (more log compression effect when value increases) the photoreceptors, use it to cut high temporal frequencies (noise or fast motion), unit is frames, typical value is 1 frame the photoreceptors, use it to cut high spatial frequencies (noise or thick contours), unit is pixels, typical value is 1 pixel the output is zero, if the parameter is near 1, then, the luminance is not filtered and is still reachable at the output, typicall value is 0 horizontal cells, use it to cut low temporal frequencies (local luminance variations), unit is frames, typical value is 1 frame, as the photoreceptors horizontal cells, use it to cut low spatial frequencies (local luminance), unit is pixels, typical value is 5 pixel, this value is also used for local contrast computing when computing the local contrast adaptation at the ganglion cells level (Inner Plexiform Layer parvocellular channel model) output, set a value between 0.6 and 1 for best results, a high value increases more the low value sensitivity... and the output saturates faster, recommended value: 0.7
  - setupIPLMagnoChannel
```
public void setupIPLMagnoChannel(boolean normaliseOutput,
                                 float parasolCells_beta,
                                 float parasolCells_tau,
                                 float parasolCells_k,
                                 float amacrinCellsTemporalCutFrequency,
                                 float V0CompressionParameter,
                                 float localAdaptintegration_tau,
                                 float localAdaptintegration_k)
```
    Set parameters values for the Inner Plexiform Layer (IPL) magnocellular channel this channel processes signals output from OPL processing stage in peripheral vision, it allows motion information enhancement. It is decorrelated from the details channel. See reference papers for more details.
    
    引数:
    
    normaliseOutput - 出力を0から255の範囲に再スケーリングするか(true)、しないか(false)を指定する
    
    parasolCells_beta - 網膜のIPLレベル(神経節細胞の局所適応用)で局所コントラスト適応に使われるローパスフィルタのゲイン。代表値は0
    
    parasolCells_tau - 網膜のIPLレベルでの局所コントラスト適応（神経節細胞の局所適応）に用いるローパスフィルタの時定数。単位はフレーム、典型値は0（即時応答）
    
    parasolCells_k - 網膜のIPLレベルでの局所コントラスト適応（神経節細胞の局所適応）に用いるローパスフィルタの空間定数。単位はピクセル、典型値は5
    
    amacrinCellsTemporalCutFrequency - 大細胞系（動き情報チャンネル）の一次ハイパスフィルタの時定数。単位はフレーム、典型値は1.2
    
    V0CompressionParameter - 神経節細胞の局所適応出力の圧縮強度。最良の結果を得るには0.6から1の間の値を設定する。値を大きくすると低い値に対する感度がより高まり……出力がより速く飽和する。推奨値は0.95
    
    localAdaptintegration_tau - 局所適応計算のための局所「動き平均」の計算に関わるローパスフィルタの時定数を指定する
    
    localAdaptintegration_k - 局所適応計算のための局所「動き平均」の計算に関わるローパスフィルタの空間定数を指定する
  - setupIPLMagnoChannel
```
public void setupIPLMagnoChannel(boolean normaliseOutput,
                                 float parasolCells_beta,
                                 float parasolCells_tau,
                                 float parasolCells_k,
                                 float amacrinCellsTemporalCutFrequency,
                                 float V0CompressionParameter,
                                 float localAdaptintegration_tau)
```
    Set parameters values for the Inner Plexiform Layer (IPL) magnocellular channel this channel processes signals output from OPL processing stage in peripheral vision, it allows motion information enhancement. It is decorrelated from the details channel. See reference papers for more details.
    
    引数:
    
    normaliseOutput - 出力を0から255の範囲に再スケーリングするか(true)、しないか(false)を指定する
    
    parasolCells_beta - 網膜のIPLレベル(神経節細胞の局所適応用)で局所コントラスト適応に使われるローパスフィルタのゲイン。代表値は0
    
    parasolCells_tau - 網膜のIPLレベルでの局所コントラスト適応（神経節細胞の局所適応）に用いるローパスフィルタの時定数。単位はフレーム、典型値は0（即時応答）
    
    parasolCells_k - 網膜のIPLレベルでの局所コントラスト適応（神経節細胞の局所適応）に用いるローパスフィルタの空間定数。単位はピクセル、典型値は5
    
    amacrinCellsTemporalCutFrequency - 大細胞系（動き情報チャンネル）の一次ハイパスフィルタの時定数。単位はフレーム、典型値は1.2
    
    V0CompressionParameter - 神経節細胞の局所適応出力の圧縮強度。最良の結果を得るには0.6から1の間の値を設定する。値を大きくすると低い値に対する感度がより高まり……出力がより速く飽和する。推奨値は0.95
    
    localAdaptintegration_tau - 局所適応計算のための局所「動き平均」の計算に関わるローパスフィルタの時定数を指定する（局所適応計算のための局所「動き平均」の計算における）
  - setupIPLMagnoChannel
```
public void setupIPLMagnoChannel(boolean normaliseOutput,
                                 float parasolCells_beta,
                                 float parasolCells_tau,
                                 float parasolCells_k,
                                 float amacrinCellsTemporalCutFrequency,
                                 float V0CompressionParameter)
```
    Set parameters values for the Inner Plexiform Layer (IPL) magnocellular channel this channel processes signals output from OPL processing stage in peripheral vision, it allows motion information enhancement. It is decorrelated from the details channel. See reference papers for more details.
    
    引数:
    
    normaliseOutput - 出力を0から255の範囲に再スケーリングするか(true)、しないか(false)を指定する
    
    parasolCells_beta - 網膜のIPLレベル(神経節細胞の局所適応用)で局所コントラスト適応に使われるローパスフィルタのゲイン。代表値は0
    
    parasolCells_tau - 網膜のIPLレベルでの局所コントラスト適応（神経節細胞の局所適応）に用いるローパスフィルタの時定数。単位はフレーム、典型値は0（即時応答）
    
    parasolCells_k - 網膜のIPLレベルでの局所コントラスト適応（神経節細胞の局所適応）に用いるローパスフィルタの空間定数。単位はピクセル、典型値は5
    
    amacrinCellsTemporalCutFrequency - 大細胞系（動き情報チャンネル）の一次ハイパスフィルタの時定数。単位はフレーム、典型値は1.2
    
    V0CompressionParameter - 神経節細胞の局所適応出力の圧縮強度。最良の結果を得るには0.6から1の間の値を設定する。値を大きくすると低い値に対する感度がより高まり……出力がより速く飽和する。推奨値は0.95（局所適応計算のための局所「動き平均」の計算に関わる、局所適応計算のための局所「動き平均」の計算における）
  - setupIPLMagnoChannel
```
public void setupIPLMagnoChannel(boolean normaliseOutput,
                                 float parasolCells_beta,
                                 float parasolCells_tau,
                                 float parasolCells_k,
                                 float amacrinCellsTemporalCutFrequency)
```
    Set parameters values for the Inner Plexiform Layer (IPL) magnocellular channel this channel processes signals output from OPL processing stage in peripheral vision, it allows motion information enhancement. It is decorrelated from the details channel. See reference papers for more details.
    
    引数:
    
    normaliseOutput - 出力を0から255の範囲に再スケーリングするか(true)、しないか(false)を指定する
    
    parasolCells_beta - 網膜のIPLレベル(神経節細胞の局所適応用)で局所コントラスト適応に使われるローパスフィルタのゲイン。代表値は0
    
    parasolCells_tau - 網膜のIPLレベルでの局所コントラスト適応（神経節細胞の局所適応）に用いるローパスフィルタの時定数。単位はフレーム、典型値は0（即時応答）
    
    parasolCells_k - 網膜のIPLレベルでの局所コントラスト適応（神経節細胞の局所適応）に用いるローパスフィルタの空間定数。単位はピクセル、典型値は5
    
    amacrinCellsTemporalCutFrequency - 大細胞系（動き情報チャンネル）の一次ハイパスフィルタの時定数。単位はフレーム、典型値は1.2。出力。最良の結果を得るには0.6から1の間の値を設定する。値を大きくすると低い値に対する感度がより高まり……出力がより速く飽和する。推奨値は0.95（局所適応計算のための局所「動き平均」の計算に関わる、局所適応計算のための局所「動き平均」の計算における）
  - setupIPLMagnoChannel
```
public void setupIPLMagnoChannel(boolean normaliseOutput,
                                 float parasolCells_beta,
                                 float parasolCells_tau,
                                 float parasolCells_k)
```
    Set parameters values for the Inner Plexiform Layer (IPL) magnocellular channel this channel processes signals output from OPL processing stage in peripheral vision, it allows motion information enhancement. It is decorrelated from the details channel. See reference papers for more details.
    
    引数:
    
    normaliseOutput - 出力を0から255の範囲に再スケーリングするか(true)、しないか(false)を指定する
    
    parasolCells_beta - 網膜のIPLレベル(神経節細胞の局所適応用)で局所コントラスト適応に使われるローパスフィルタのゲイン。代表値は0
    
    parasolCells_tau - 網膜のIPLレベルでの局所コントラスト適応（神経節細胞の局所適応）に用いるローパスフィルタの時定数。単位はフレーム、典型値は0（即時応答）
    
    parasolCells_k - 網膜のIPLレベルでの局所コントラスト適応（神経節細胞の局所適応）に用いるローパスフィルタの空間定数。単位はピクセル、典型値は5。大細胞系（動き情報チャンネル）、単位はフレーム、典型値は1.2。出力。最良の結果を得るには0.6から1の間の値を設定する。値を大きくすると低い値に対する感度がより高まり……出力がより速く飽和する。推奨値は0.95（局所適応計算のための局所「動き平均」の計算に関わる、局所適応計算のための局所「動き平均」の計算における）
  - setupIPLMagnoChannel
```
public void setupIPLMagnoChannel(boolean normaliseOutput,
                                 float parasolCells_beta,
                                 float parasolCells_tau)
```
    Set parameters values for the Inner Plexiform Layer (IPL) magnocellular channel this channel processes signals output from OPL processing stage in peripheral vision, it allows motion information enhancement. It is decorrelated from the details channel. See reference papers for more details.
    
    引数:
    
    normaliseOutput - 出力を0から255の範囲に再スケーリングするか(true)、しないか(false)を指定する
    
    parasolCells_beta - 網膜のIPLレベル(神経節細胞の局所適応用)で局所コントラスト適応に使われるローパスフィルタのゲイン。代表値は0
    
    parasolCells_tau - 網膜のIPLレベルでの局所コントラスト適応（神経節細胞の局所適応）に用いるローパスフィルタの時定数。単位はフレーム、典型値は0（即時応答）。網膜のIPLレベルでの（神経節細胞の局所適応）、単位はピクセル、典型値は5。大細胞系（動き情報チャンネル）、単位はフレーム、典型値は1.2。出力。最良の結果を得るには0.6から1の間の値を設定する。値を大きくすると低い値に対する感度がより高まり……出力がより速く飽和する。推奨値は0.95（局所適応計算のための局所「動き平均」の計算に関わる、局所適応計算のための局所「動き平均」の計算における）
  - setupIPLMagnoChannel
```
public void setupIPLMagnoChannel(boolean normaliseOutput,
                                 float parasolCells_beta)
```
    Set parameters values for the Inner Plexiform Layer (IPL) magnocellular channel this channel processes signals output from OPL processing stage in peripheral vision, it allows motion information enhancement. It is decorrelated from the details channel. See reference papers for more details.
    
    引数:
    
    normaliseOutput - 出力を0から255の範囲に再スケーリングするか(true)、しないか(false)を指定する
    
    parasolCells_beta - 網膜のIPLレベルでの局所コントラスト適応（神経節細胞の局所適応）に用いるローパスフィルタのゲイン。典型値は0。網膜のIPLレベルでの（神経節細胞の局所適応）、単位はフレーム、典型値は0（即時応答）。網膜のIPLレベルでの（神経節細胞の局所適応）、単位はピクセル、典型値は5。大細胞系（動き情報チャンネル）、単位はフレーム、典型値は1.2。出力。最良の結果を得るには0.6から1の間の値を設定する。値を大きくすると低い値に対する感度がより高まり……出力がより速く飽和する。推奨値は0.95（局所適応計算のための局所「動き平均」の計算に関わる、局所適応計算のための局所「動き平均」の計算における）
  - setupIPLMagnoChannel
```
public void setupIPLMagnoChannel(boolean normaliseOutput)
```
    Set parameters values for the Inner Plexiform Layer (IPL) magnocellular channel this channel processes signals output from OPL processing stage in peripheral vision, it allows motion information enhancement. It is decorrelated from the details channel. See reference papers for more details.
    
    引数:
    
    normaliseOutput - 出力を0から255の間に再スケーリングするか（true）しないか（false）を指定する。網膜のIPLレベル（神経節細胞の局所適応）、典型値は0。網膜のIPLレベルでの（神経節細胞の局所適応）、単位はフレーム、典型値は0（即時応答）。網膜のIPLレベルでの（神経節細胞の局所適応）、単位はピクセル、典型値は5。大細胞系（動き情報チャンネル）、単位はフレーム、典型値は1.2。出力。最良の結果を得るには0.6から1の間の値を設定する。値を大きくすると低い値に対する感度がより高まり……出力がより速く飽和する。推奨値は0.95（局所適応計算のための局所「動き平均」の計算に関わる、局所適応計算のための局所「動き平均」の計算における）
  - setupIPLMagnoChannel
```
public void setupIPLMagnoChannel()
```
    Set parameters values for the Inner Plexiform Layer (IPL) magnocellular channel this channel processes signals output from OPL processing stage in peripheral vision, it allows motion information enhancement. It is decorrelated from the details channel. See reference papers for more details. IPL level of the retina (for ganglion cells local adaptation), typical value is 0 at the IPL level of the retina (for ganglion cells local adaptation), unit is frame, typical value is 0 (immediate response) at the IPL level of the retina (for ganglion cells local adaptation), unit is pixels, typical value is 5 the magnocellular way (motion information channel), unit is frames, typical value is 1.2 output, set a value between 0.6 and 1 for best results, a high value increases more the low value sensitivity... and the output saturates faster, recommended value: 0.95 involved in the computation of the local "motion mean" for the local adaptation computation in the computation of the local "motion mean" for the local adaptation computation
  - run
```
public void run(Mat inputImage)
```
    Method which allows retina to be applied on an input image, after run, encapsulated retina module is ready to deliver its outputs using dedicated acccessors, see getParvo and getMagno methods
    
    引数:
    
    inputImage - 処理対象の入力Mat画像。任意の形式（8bitから16bit）でグレーレベルまたはBGRエンコードのものが指定可能
  - applyFastToneMapping
```
public void applyFastToneMapping(Mat inputImage,
                                 Mat outputToneMappedImage)
```
    Method which processes an image in the aim to correct its luminance correct backlight problems, enhance details in shadows. This method is designed to perform High Dynamic Range image tone mapping (compress >8bit/pixel images to 8bit/pixel). This is a simplified version of the Retina Parvocellular model (simplified version of the run/getParvo methods call) since it does not include the spatio-temporal filter modelling the Outer Plexiform Layer of the retina that performs spectral whitening and many other stuff. However, it works great for tone mapping and in a faster way. Check the demos and experiments section to see examples and the way to perform tone mapping using the original retina model and the method.
    
    引数:
    
    inputImage - 処理対象の入力画像（float形式でエンコードされている必要がある：CV_32F, CV_32FC1, CV_32F_C3, CV_32F_C4。第4チャンネルは考慮されない）。
    
    outputToneMappedImage - 出力されるチャンネルあたり8bitのトーンマッピング画像（CV_8UまたはCV_8UC3形式）。
  - getParvo
```
public void getParvo(Mat retinaOutput_parvo)
```
    Accessor of the details channel of the retina (models foveal vision). Warning, getParvoRAW methods return buffers that are not rescaled within range [0;255] while the non RAW method allows a normalized matrix to be retrieved.
    引数:
    
    retinaOutput_parvo - the output buffer (reallocated if necessary), format can be :
    
    Mat。この出力はOpenCVでの標準的な8bit画像処理用途に合わせて再スケーリングされている
    
    RAWメソッドは実際には1次元行列を返す（エンコードはR1, R2, ... Rn, G1, G2, ..., Gn, B1, B2, ...Bn）。この出力は量子化や再スケーリングを行わない、元の網膜フィルタモデルの出力である。SEE: getParvoRAW
  - getParvoRAW
```
public void getParvoRAW(Mat retinaOutput_parvo)
```
    Accessor of the details channel of the retina (models foveal vision). SEE: getParvo
    
    引数:
    
    retinaOutput_parvo - 自動生成
  - getMagno
```
public void getMagno(Mat retinaOutput_magno)
```
    Accessor of the motion channel of the retina (models peripheral vision). Warning, getMagnoRAW methods return buffers that are not rescaled within range [0;255] while the non RAW method allows a normalized matrix to be retrieved.
    引数:
    
    retinaOutput_magno - the output buffer (reallocated if necessary), format can be :
    
    Mat。この出力はOpenCVでの標準的な8bit画像処理用途に合わせて再スケーリングされている
    
    RAWメソッドは実際には1次元行列を返す（エンコードはM1, M2,... Mn）。この出力は量子化や再スケーリングを行わない、元の網膜フィルタモデルの出力である。SEE: getMagnoRAW
  - getMagnoRAW
```
public void getMagnoRAW(Mat retinaOutput_magno)
```
    Accessor of the motion channel of the retina (models peripheral vision). SEE: getMagno
    
    引数:
    
    retinaOutput_magno - 自動生成
  - getMagnoRAW
```
public Mat getMagnoRAW()
```
  - getParvoRAW
```
public Mat getParvoRAW()
```
  - setColorSaturation
```
public void setColorSaturation(boolean saturateColors,
                               float colorSaturationValue)
```
    Activate color saturation as the final step of the color demultiplexing process -> this saturation is a sigmoide function applied to each channel of the demultiplexed image.
    
    引数:
    
    saturateColors - 色の彩度処理を有効（true）または無効（false）にするブール値
    
    colorSaturationValue - 彩度係数：クロミナンスバッファに適用される単純な係数
  - setColorSaturation
```
public void setColorSaturation(boolean saturateColors)
```
    Activate color saturation as the final step of the color demultiplexing process -> this saturation is a sigmoide function applied to each channel of the demultiplexed image.
    
    引数:
    
    saturateColors - 色の彩度処理を有効（true）または無効（false）にするブール値。バッファ
  - setColorSaturation
```
public void setColorSaturation()
```
    Activate color saturation as the final step of the color demultiplexing process -> this saturation is a sigmoide function applied to each channel of the demultiplexed image. buffers
  - clearBuffers
```
public void clearBuffers()
```
    Clears all retina buffers (equivalent to opening the eyes after a long period of eye close ;o) whatchout the temporal transition occuring just after this method call.
  - activateMovingContoursProcessing
```
public void activateMovingContoursProcessing(boolean activate)
```
    Activate/desactivate the Magnocellular pathway processing (motion information extraction), by default, it is activated
    
    引数:
    
    activate - 大細胞系出力を有効にする場合はtrue、しない場合はfalse……有効にすると、大細胞系出力はgetMagnoメソッドを使って取得できる
  - activateContoursProcessing
```
public void activateContoursProcessing(boolean activate)
```
    Activate/desactivate the Parvocellular pathway processing (contours information extraction), by default, it is activated
    
    引数:
    
    activate - 小細胞系（輪郭情報抽出）出力を有効にする場合はtrue、しない場合はfalse……有効にすると、小細胞系出力はRetina::getParvoメソッドを使って取得できる
  - create
```
public static Retina create(Size inputSize)
```
  - create
```
public static Retina create(Size inputSize,
                            boolean colorMode,
                            int colorSamplingMethod,
                            boolean useRetinaLogSampling,
                            float reductionFactor,
                            float samplingStrength)
```
    Constructors from standardized interfaces : retreive a smart pointer to a Retina instance
    引数:
    
    inputSize - 入力フレームのサイズ
    
    colorMode - 選択する処理モード：色処理を行うか行わないか
    
    colorSamplingMethod - specifies which kind of color sampling will be used :
    
    cv::bioinspired::RETINA_COLOR_RANDOM: 各ピクセル位置はランダムにR、G、Bのいずれかになる
    
    cv::bioinspired::RETINA_COLOR_DIAGONAL: 色のサンプリングは1行目RGBRGBRGB...、2行目BRGBRGBRG...、3行目GBRGBRGBR...となる
    
    cv::bioinspired::RETINA_COLOR_BAYER: 標準的なベイヤーサンプリング
    
    useRetinaLogSampling - 網膜の対数サンプリングを有効にする。trueの場合、続く2つの引数が使用できる
    
    reductionFactor - param useRetinaLogSampling=trueの場合のみ有用。出力フレームの縮小率を指定する（中心（中心窩）は高解像度で、隅は縮小しても構わないため、精度の損失なく出力を縮小できる）
    
    samplingStrength - param useRetinaLogSampling=trueの場合のみ有用。適用される対数スケールの強度を指定する
    
    戻り値:
    
    自動生成
  - create
```
public static Retina create(Size inputSize,
                            boolean colorMode,
                            int colorSamplingMethod,
                            boolean useRetinaLogSampling,
                            float reductionFactor)
```
    Constructors from standardized interfaces : retreive a smart pointer to a Retina instance
    引数:
    
    inputSize - 入力フレームのサイズ
    
    colorMode - 選択する処理モード：色処理を行うか行わないか
    
    colorSamplingMethod - specifies which kind of color sampling will be used :
    
    cv::bioinspired::RETINA_COLOR_RANDOM: 各ピクセル位置はランダムにR、G、Bのいずれかになる
    
    cv::bioinspired::RETINA_COLOR_DIAGONAL: 色のサンプリングは1行目RGBRGBRGB...、2行目BRGBRGBRG...、3行目GBRGBRGBR...となる
    
    cv::bioinspired::RETINA_COLOR_BAYER: 標準的なベイヤーサンプリング
    
    useRetinaLogSampling - 網膜の対数サンプリングを有効にする。trueの場合、続く2つの引数が使用できる
    
    reductionFactor - param useRetinaLogSampling=trueの場合のみ有用。出力フレームの縮小率を指定する（中心（中心窩）は高解像度で、隅は縮小しても構わないため、精度の損失なく出力を縮小できる）。適用される対数スケール
    
    戻り値:
    
    自動生成
  - create
```
public static Retina create(Size inputSize,
                            boolean colorMode,
                            int colorSamplingMethod,
                            boolean useRetinaLogSampling)
```
    Constructors from standardized interfaces : retreive a smart pointer to a Retina instance
    引数:
    
    inputSize - 入力フレームのサイズ
    
    colorMode - 選択する処理モード：色処理を行うか行わないか
    
    colorSamplingMethod - specifies which kind of color sampling will be used :
    
    cv::bioinspired::RETINA_COLOR_RANDOM: 各ピクセル位置はランダムにR、G、Bのいずれかになる
    
    cv::bioinspired::RETINA_COLOR_DIAGONAL: 色のサンプリングは1行目RGBRGBRGB...、2行目BRGBRGBRG...、3行目GBRGBRGBR...となる
    
    cv::bioinspired::RETINA_COLOR_BAYER: 標準的なベイヤーサンプリング
    
    useRetinaLogSampling - 網膜の対数サンプリングを有効にする。trueの場合、続く2つの引数が使用できる。出力フレームの縮小率（中心（中心窩）は高解像度で、隅は縮小しても構わないため、精度の損失なく出力を縮小できる）。適用される対数スケール
    
    戻り値:
    
    自動生成
  - create
```
public static Retina create(Size inputSize,
                            boolean colorMode,
                            int colorSamplingMethod)
```
    Constructors from standardized interfaces : retreive a smart pointer to a Retina instance
    引数:
    
    inputSize - 入力フレームのサイズ
    
    colorMode - 選択する処理モード：色処理を行うか行わないか
    
    colorSamplingMethod - specifies which kind of color sampling will be used :
    
    cv::bioinspired::RETINA_COLOR_RANDOM: 各ピクセル位置はランダムにR、G、Bのいずれかになる
    
    cv::bioinspired::RETINA_COLOR_DIAGONAL: 色のサンプリングは1行目RGBRGBRGB...、2行目BRGBRGBRG...、3行目GBRGBRGBR...となる
    
    cv::bioinspired::RETINA_COLOR_BAYER: 標準的なベイヤーサンプリング
    
    be used factor of the output frame (as the center (fovea) is high resolution and corners can be underscaled, then a reduction of the output is allowed without precision leak the log scale that is applied
    
    戻り値:
    
    自動生成
  - create
```
public static Retina create(Size inputSize,
                            boolean colorMode)
```
    Constructors from standardized interfaces : retreive a smart pointer to a Retina instance
    引数:
    
    inputSize - 入力フレームのサイズ
    
    colorMode - the chosen processing mode : with or without color processing
    
    cv::bioinspired::RETINA_COLOR_RANDOM: 各ピクセル位置はランダムにR、G、Bのいずれかになる
    
    cv::bioinspired::RETINA_COLOR_DIAGONAL: 色のサンプリングは1行目RGBRGBRGB...、2行目BRGBRGBRG...、3行目GBRGBRGBR...となる
    
    cv::bioinspired::RETINA_COLOR_BAYER: 標準的なベイヤーサンプリング
    
    be used factor of the output frame (as the center (fovea) is high resolution and corners can be underscaled, then a reduction of the output is allowed without precision leak the log scale that is applied
    
    戻り値:
    
    自動生成

クラス Retina

フィールドの要約

クラス org.opencv.core.Algorithm から継承されたフィールド

コンストラクタの要約

メソッドの要約

クラス org.opencv.core.Algorithm から継承されたメソッド

クラス java.lang.Object から継承したメソッド

コンストラクタの詳細

Retina

メソッドの詳細

__fromPtr__

getInputSize

getOutputSize

setup

setup

setup

printSetup

write

setupOPLandIPLParvoChannel

setupOPLandIPLParvoChannel

setupOPLandIPLParvoChannel

setupOPLandIPLParvoChannel

setupOPLandIPLParvoChannel

setupOPLandIPLParvoChannel

setupOPLandIPLParvoChannel

setupOPLandIPLParvoChannel

setupOPLandIPLParvoChannel

setupOPLandIPLParvoChannel

setupIPLMagnoChannel

setupIPLMagnoChannel

setupIPLMagnoChannel

setupIPLMagnoChannel

setupIPLMagnoChannel

setupIPLMagnoChannel

setupIPLMagnoChannel

setupIPLMagnoChannel

setupIPLMagnoChannel

run

applyFastToneMapping

getParvo

getParvoRAW

getMagno

getMagnoRAW

getMagnoRAW

getParvoRAW

setColorSaturation

setColorSaturation

setColorSaturation

clearBuffers

activateMovingContoursProcessing

activateContoursProcessing

create

create

create

create

create

create

fromPtr