.. highlightlang:: us

.. _histc:

histc
=====

.. index:: histc

.. us.tag  histc NOREADYGERMAN New532  math-base

:ref:`histc` ermittelt die Werte für ein Histogramm.

.. function::  r = histc(v, edges)

.. us.return

**Returnwert**

*r* ist ein Vektor der Länge ``len(edges)-1``. Jedes Element enthält die 
Anzahl der Werte, die in den Bereich v[i] >= edges[j] und  v[i] < edges[j+1] 
fallen. Die letzte Klasse zählt auch die Elemente, die auf der Klassengrenze 
edges(end) liegen. Werte außerhalb der Klassengrenzen werden nicht gezählt.
Im Fehlerfall (*edges*  nicht monoton aufsteigend) liefert die Funktion den
Wert -1.

.. us.params

**Parameter**

.. uparam:: v

   *v* ist ein Zahlen-Vektor oder eine Matrix.

.. uparam:: edges

   *edges* ist ein Vektor mit den Klassengrenzen. Es sind mindestens 2 Werte 
   erforderlich. Die Elemente müssen monoton aufsteigend sein (e[i] < e[i+1]).

.. us.example

**Beispiel**

:: 

   * a = [1, 1.2, 1.41, 1.65, 1.66, 1.71, 1.8, 2.0]
   * edges = [1, 1.2, 1.4, 1.6, 1.8, 2.0]
   * histc(a, edges)
   1
   1
   1
   3
   2

Dieses Beispiel gibt ein Histogramm der Grautöne eines Bitmaps aus:

::

   hImg = ImageCreate("c:/test.png");
   b = ImageUpdate(hImg);
   if (b == FALSE) error("image not found");
   g = ImageGetPixelGray(hImg);
   r = histc(g, 0:255);
   plot(r);

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - 5.3.2
     - Neu.

.. seealso::
   :ref:`uberblick-mathematik`,
   :ref:`cumsum`,
   :ref:`histogram`

:sub:`id-926486`