penergyvalue

Synopsis

Description

penergyvalue measures the global energy of the input image im_in or the input graph im_in.

The energy is:

   energy = SUM{ im_in[p] * im_in[p]} / N

For image, the energy is measured per band from the pixel values.

For graph, the energy is measured from the node values.

The energy values for each band are stored in the collection col_out.

Inputs

• im_in: an image or a graph.

Outputs

• col_out: a collection of float values.

Result

Returns the global energy value (for the first band only). This value can be get using operator pstatus.

Examples

Measures the global energy of the tangram.pan (Unix version):

   penergyvalue tangram.pan col.pan
   val=`pstatus`
   echo "Energy = $val"

Measures the global energy of the tangram.pan (MsDos version):

   penergyvalue tangram.pan col.pan
   call pstatus
   call pset val
   echo Energy = %val%

See also

C++ prototype

Version française

Calcul de l'énergie d'une image ou d'un graphe.