Top
Menu

POF-ML

Histogram Transform

Here is listed and described the PUs of the histogram transform category. Some of this PUs require an histogram to perform their processing.

bc - Brightness/Contrast

This PU apply a simple polynomial function with brightnessOffset and a contrastGain. The function is the following:

\( \mathit{output} = (\mathit{input} \times \mathit{contrastGain}) + \mathit{brightnessOffset}\)

Syntax

bc(child,brightnessOffset,contrastGain)

Input

This PU takes in input one PU with one sample per pixel.

Parameters

  • child - is the child PU.
  • brightnessOffset - is the offset (integer value).
  • constrastGain - is the gain (float value).

Output

The output is a PU with one unsigned int sample per pixel (0 for background).

bg - Background value

The bg PU allow the user to specify an additional background value.

Syntax

bg(child,bgValue)

Input

This PU takes in input one PU with one sample per pixel.

Parameters

  • child - is the child PU.
  • bgValue - is the additional background value.

Output

The output is a PU with one sample per pixel. The output data type is the same as in input.

eq - Histogram equalisation

The eq PU performs a histogram equalisation based on the given histogram.

Syntax

eq(child,histo)

Input

This PU takes in input one PU with one sample per pixel. The expected data type is integer.

Parameters

  • child - is the child PU.
  • histo - is the identifier of an histogram.

Output

The output is a PU with one unsigned int sample per pixel (0 for background).

extr - Extract value

The extr PU put all the pixels to background expect the ones that are equal to the specifier value.

Syntax

extr(child,extacted_value)

Input

This PU takes in input one PU with one sample per pixel. The expected data type is integer.

Parameters

  • child - is the child PU.
  • extacted_value - is the value to be extraced.

Output

The output is a PU with one sample per pixel. The output data type is the same as in input.

gam - Gamma function

The gam PU apply a gamma function on the input values. The function is the following:

\( \text{output} = \text{A} \times \text{input} ^ \gamma\)

Syntax

gam(child,A,gamma)

Input

This PU takes in input one PU with one sample per pixel. The expected data type is integer.

Parameters

  • child - is the child PU.
  • A - is the gain of the function gamma.
  • gamma - is the gamma value of the function.

Output

The output is a PU with one unsigned int sample per pixel (0 for background).

gau - Gaussian equalisation

The gau PU performs a gaussian equalisation based on the given histogram.

Syntax

gau(child,histo,mean,stdev)

Input

This PU takes in input one PU with one sample per pixel. The expected data type is integer.

Parameters

  • child - is the child PU.
  • histo - is the identifier of an histogram.
  • mean - is the mean of the gaussian model.
  • stdev - is the standard deviation of the gaussian model.

Output

The output is a PU with one unsigned int sample per pixel (0 for background).

noht - No histogram transform

The noht PU performs a conversion from 16bits to 8bits by keeping only the 8 most significant bits.

Syntax

noht(child)

Input

This PU takes in input one PU with one sample per pixel. The expected data type is integer.

Parameters

  • child - is the child PU.

Output

The output is a PU with one unsigned int sample per pixel (0 for background).

sta - Automatic stretching

The sta PU performs an automatic stretching based on the given histogram.

Syntax

sta(child,histo,leftSat,rightSat)

Input

This PU takes in input one PU with one sample per pixel. The expected data type is integer.

Parameters

  • child - is the child PU.
  • histo - is the identifier of an histogram.
  • leftSat - is the the left saturation applied to the histogram.
  • rightSat - is the the right saturation applied to the histogram .

Output

The output is a PU with one unsigned int sample per pixel (0 for background).

stc - Column stretching

The stc PU performs a statistic imposed stretching on each column of the product to improve the rendering of the offshore area of sar product. This stretching is based on precalculated statistics per column (mean and standard deviation).

Syntax

stc(child,rcs,output_mean,output_stdev,smooth_radius)

Input

This PU takes in input one PU with one sample per pixel. The expected data type is integer.

Parameters

  • child - is the child PU.
  • rcs - is the identifier of the Radar Cross Section statistics (mean and standard deviation per column).
  • output_mean - is the user requested output mean of each column.
  • output_stdev - is the user requested output standard deviation of each column.
  • smooth_radius - is the radius of the smooth filtering apply to the “rcs”.

Output

The output is a PU with one unsigned int sample per pixel (0 for background).

sti - Interval stretching

The sti PU performs an interval stretching based on stretching points defined by the user.

Syntax

sti(child,x1,y1,x2,y2,...,xn,yn)

Input

This PU takes in input one PU with one sample per pixel. The expected data type is integer.

Parameters

  • child - is the child PU.
  • xi - is the abscissa of the stretching point "i" (input definition).
  • yi - is the ordinate of the stretching point "i" (output definition).

Output

The output is a PU with one unsigned int sample per pixel (0 for background).

str - Linear stretching

The str PU performs a linear stretching based on user defined bounds

Syntax

str(child,a,b)

Input

This PU takes in input one PU with one sample per pixel. The expected data type is integer.

Parameters

  • child - is the child PU.
  • a - is the left bound of the stretching.
  • b - is the right bound of the stretching.

Output

The output is a PU with one unsigned int sample per pixel (0 for background).

sts - Statistics stretching

The sts PU performs a linear stretching based on a given output mean and standard deviation

Syntax

sts(child,histo,output_mean,output_stdev)

Input

input description

Parameters

  • child - is the child PU.
  • histo - is the identifier of an histogram.
  • output_mean - is the requested global output mean.
  • output_stdev - is the requested global output standard deviation.

Output

The output is a PU with one unsigned int sample per pixel (0 for background).