.. _variables-histogram_point_uncertain-integer:

"""""""
integer
"""""""


Integer valued point histogram variable


.. toctree::
   :hidden:
   :maxdepth: 1

   variables-histogram_point_uncertain-integer-pairs_per_variable
   variables-histogram_point_uncertain-integer-abscissas
   variables-histogram_point_uncertain-integer-counts
   variables-histogram_point_uncertain-integer-initial_point
   variables-histogram_point_uncertain-integer-descriptors


**Specification**

- *Alias:* None

- *Arguments:* INTEGER


**Child Keywords:**

+-------------------------+--------------------+------------------------+-----------------------------------------------+
| Required/Optional       | Description of     | Dakota Keyword         | Dakota Keyword Description                    |
|                         | Group              |                        |                                               |
+=========================+====================+========================+===============================================+
| Optional                                     | `pairs_per_variable`__ | Number of pairs defining each histogram point |
|                                              |                        | integer variable                              |
+----------------------------------------------+------------------------+-----------------------------------------------+
| Required                                     | `abscissas`__          | Integer abscissas for a point histogram       |
+----------------------------------------------+------------------------+-----------------------------------------------+
| Required                                     | `counts`__             | Counts for integer-valued point histogram     |
+----------------------------------------------+------------------------+-----------------------------------------------+
| Optional                                     | `initial_point`__      | Initial values for variables                  |
+----------------------------------------------+------------------------+-----------------------------------------------+
| Optional                                     | `descriptors`__        | Labels for the variables                      |
+----------------------------------------------+------------------------+-----------------------------------------------+

.. __: variables-histogram_point_uncertain-integer-pairs_per_variable.html
__ variables-histogram_point_uncertain-integer-abscissas.html
__ variables-histogram_point_uncertain-integer-counts.html
__ variables-histogram_point_uncertain-integer-initial_point.html
__ variables-histogram_point_uncertain-integer-descriptors.html



**Description**


This probability mass function is integer-valued; the abscissa values
must all be integers.  The ``n`` abscissa values are paired with ``n``
``counts`` which indicate the relative frequency (mass) of each integer
relative to the other specified integers.



**Examples**



.. code-block::

    histogram_point_uncertain
      integer = 2
      pairs_per_variable = 2     3
      abscissas          = 3 4   100 200 300
      counts             = 1 1   1   2   1


There are two variables, the first one has two possible integer values
which are equally probable.  The second one has three options, and 200
is twice as probable as either 100 or 300.