string

String (categorical) valued point histogram variable

Specification

  • Alias: None

  • Arguments: INTEGER

  • JSON argument key: count

Child Keywords:

Required/Optional

Description of Group

JSON Group Key

Dakota Keyword

Dakota Keyword Description

Optional

pairs_per_variable

Number of pairs defining each histogram point string variable

Required

abscissas

String abscissas for a point histogram

Required

counts

Counts for string-valued point histogram

Optional

initial_point

Initial values for variables

Optional

descriptors

Labels for the variables

Description

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

Examples

variables
  histogram_point_uncertain
    string = 2
      pairs_per_variable = 2            3
      abscissas          = 'no' 'yes'   'function1' 'function2' 'function3'
      counts             = 1     1      1           2           1
      descriptors        = 'vote'       'which_function'
{
  "variables": [
    {
      "histogram_point_uncertain": {
        "string": {
          "count": 2,
          "pairs_per_variable": [2, 3],
          "abscissas": ["no", "yes", "function1", "function2", "function3"],
          "counts": [1.0, 1.0, 1.0, 2.0, 1.0],
          "descriptors": ["vote", "which_function"]
        }
      }
    }
  ]
}

Here there are two variables, the first one (‘vote’) has two possible string values ‘yes’ and ‘no’ which are equally probable. The second one has three options for ‘which_function’, and ‘function2’ is twice as probable as ‘function1’ or ‘function3’.