FLTRNOI

Description

FLTRNOIS filters noise in an image channel or layer, using a registered noise-free reference image that is sampled at the same pixel size as the noisy image. The reference image can be from a different date, frequency band, and sensor.

Parameters

Name	Type	Caption	Length	Value range
FILI_NS *	String	Input noisy file name	1 - 192
FILI_REF *	String	Input reference file name	1 - 192
FILO *	String	Output file name	1 - 192
DBIC_REF *	Integer	Input reference channel(s) or layer(s)	1 - 1
DBIC_NS *	Integer	Input noisy channel(s) or layer(s)	1 - 1
DBOC *	Integer	Output raster channel(s) or layer(s)	1 - 1
MAXGAIN	Float	Maximum model gain	0 - 1	0.0 - 256.0 Default: 3.0
KSIZE	Integer	Kernel size (pixels)	0 - 1	1 - 100 Default: 7
ENH	Float	Enhancement factor	0 - 1	0 - 10.0 Default: 1.0
REPORT	String	Report mode	0 - 192	Quick links
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

* Required parameter

Parameter descriptions

FILI_NS

Specifies a PCIDSK file that contains the noisy image data to filter.

FILI_REF

Specifies a PCIDSK file that contains the reference image data.

The reference image must have the same dimensions as the input noisy image (FILI_NS).

FILO

Specifies the name of the file to receive the output filtered image data.

The filtered image data will be placed in the channel specified in DBOC. The dimensions and type (8-bit unsigned) of the output file must be identical to those of the input noisy file (FILI_NS) and the input reference (FILI_REF).

DBIC_REF

Specifies the image channel to be used as the noise-free reference. This must be an 8-bit unsigned image channel.

DBIC_NS

Specifies the noisy image channel or layer to filter. This must be an 8-bit unsigned image channel.

DBOC

Specifies the output channel(s) or layer(s) to receive the noise-filtered results.

This must be an 8-bit unsigned image channel.

MAXGAIN

Specifies the maximum model gain (MAXGAIN) to be used during enhancement. Lower values reduce the tendency of the algorithm to introduce noise into water regions. A typical starting value is 3 (default value). If noise results in water regions, reduce the maximum gain value.

KSIZE

Specifies the size of the linear kernels on which the cross-correlation modelling is performed. Correlation is done on a window size of ( 2 * KSIZE + 1 ) pixels.

A kernel size of less than 3 will produce noisier images. Kernel sizes greater than 7 will blur edges.

ENH

Specifies the degree of enhancement. This parameter provides as output a linear combination of the noisy input and the filtered version. Values lower than 1 will be noisier.

REPORT

Specifies where to direct the generated report.

Available options are:

• TERM: generates a report on the terminal (default)
• DISK: generates a report on file "IMPRPT.LST"
• OFF: turns off report generation
• <filename>: appends a report to the specified file

MONITOR

The program progress can be monitored by printing the percentage of processing completed. A system parameter, MONITOR, controls this activity.

Available options are:

• ON: Turns the monitor ON (default)
• OFF: Turns the monitor OFF (recommended if running in batch or background mode)

Details

FLTRNOI performs a cross-correlation between the input reference image (FILI_REF) and the input noisy image (FILI_NS), and creates a horizontal and vertical kernel defined by the Kernel Size (KSIZE) parameter. As this kernel scans across the window, the merit of both the horizontal and vertical kernels are evaluated, and the correlation coefficients (b0 and b1) of the kernel with the best merit are used. When the b0 and b1 matrices are obtained, the output image is reconstructed using the reference image b0 and b1 matrices in the following manner:

ORIGINAL_OUTPUT = B0 + B1 * FILI_REF

The amount of smoothing while preserving edge detail in the output image can be controlled with the maxium model gain parameter (MAXGAIN), which sets the upper limit of the B1 coefficient of the kernel with the best merit. For example, setting MAXGAIN = 0 results in FILI_NS as output, with no enhancement applied.

The ENH (degree of enhancement) parameter controls the enhancement factor for the noise reduction filter:

OUTPUT = ENH * ORIGINAL_OUTPUT + (1 - ENH) * FILI_NS

An enhancement factor of 1 produces only the enhanced image. An enhancement factor is 0 produces only the noisy image. As the enhancement factor is adjusted from 0 -> 1, the amount of enhancement increases as the percentage of information from the noisy image decreases.

Example

In the image database l7_ms.pix, cross model channel 1 (the noisy image) with channel 1 of fl_reference.pix (the reference image), and place the output image into channel 6 of l7_ms.pix.

Use a MAXGAIN of 3, a kernel size of 7, and set the ENH to 1 (100% enhancement).

EASI>FILI_NS = "l7_ms.pix"		! input file with noise channel
EASI>FILI_REF = "fl_reference.pix"	! input file with reference channel
EASI>FILO = "l7_ms.pix"		! output file
EASI>DBIC_NS = 1			! noise channel
EASI>DBIC_REF = 1			! reference channel
EASI>DBOC = 6				! output channel
EASI>MAXGAIN = 3			! maximum model gain 
EASI>KSIZE = 7			        ! kernel size 
EASI>ENH = 1				! enhancement factor 
EASI>REPORT = ""
EASI>MONITOR = "ON"

EASI>RUN FLTRNOI