<?xml version="1.0" encoding="utf-8"?>
<?xml-stylesheet href="../../../design/description.xslt" type="text/xsl"?>
<node lang="en" xmlns="http://dynamicnodes.mastersign.de/description"
      type="DynamicNode.Lib.Mathematics.NNormalizer" assembly="NLibDefault">
  <caption>Normalize</caption>
  <group>Math</group>
  <description>Adapts the value range of a numerical MDO.</description>
  <inPorts>
    <port name="input">
      <type>IMDO&lt;double&gt;</type>
      <description>The original MDO.</description>
    </port>
    <port name="autoMin" managed="true">
      <type>bool</type>
      <description>Indicates if the minimum of the original MDO is automatical determined.</description>
    </port>
    <port name="autoMax" managed="true">
      <type>bool</type>
      <description>Indicates if the maximum of the original MDO is automatical determined.</description>
    </port>
    <port name="inMin" managed="true">
      <type>double</type>
      <description>
        The minimum of the input MDO. 
        This value does not need to be the actual minimum, 
        all values below are raised to the given minimum.
        This value is ignored, if <c>true</c> is the current value on the in port <c>autoMin</c>.
      </description>
    </port>
    <port name="inMax" managed="true">
      <type>double</type>
      <description>
        The maximum of the input MDO.
        This value does not need to be the actual maximum,
        all values above are lowered to the given maximum.
        This value is ignored, if <c>true</c> is the current value on the in port <c>autoMax</c>.
      </description>
    </port>
    <port name="outMin" managed="true">
      <type>double</type>
      <description>The new minimum for the resulting MDO.</description>
    </port>
    <port name="outMax" managed="true">
      <type>double</type>
      <description>The new maximum for the resulting MDO.</description>
    </port>
  </inPorts>
  <outPorts>
    <port name="output">
      <type>IMDO&lt;double&gt;</type>
      <description>The normalized MDO.</description>
    </port>
  </outPorts>
  <helpText>
    <p>With this node, MDOs can be adapted in their value range.</p>
    <p>
      If, e.g. a accumulated histogram shall be used as a table for a look-up,
      the following values are useful:
      <pre>
        Auto In-Min: false (poss. true)
        Auto In-Max: true
        In-Min: 0 (poss. ignored)
        In-Max: is ignored
        Out-Min: 0
        Out-Max: 255
      </pre>
    </p>
  </helpText>
</node>
