Skip to main content

Function modifiers

cardinality

Commentary​

added in 0.8.3

Restricts the maximum number of unique values that a function can generate. When the limit is exceeded, previously generated values will be chosen at random.

Note that this modifier is a ceiling: if a function can't generate more unique values than the specified cardinality, it won't reach the cardinality limit.

Examples​

Setting cardinality​

Set cardinality to a positive integer. In this example:

  • a is only ever assigned one unique value
  • b is assigned 3 unique values, after which older values are reused
  • c always contains newly generated values
{
    "a": {
        "_gen": "normalDistribution",
        "mean": 10,
        "sd": 2,
        "decimals": 4,
        "cardinality": 1
    },
    "b": {
        "_gen": "normalDistribution",
        "mean": 10,
        "sd": 2,
        "decimals": 4,
        "cardinality": 3
    },
    "c": {
        "_gen": "normalDistribution",
        "mean": 10,
        "sd": 2,
        "decimals": 4
    }
}
[
    {
        "a": 12.4173,
        "b": 11.0891,
        "c": 10.0472
    },
    {
        "a": 12.4173,
        "b": 8.5548,
        "c": 11.1975
    },
    {
        "a": 12.4173,
        "b": 13.2317,
        "c": 11.8931
    },
    {
        "a": 12.4173,
        "b": 13.2317,
        "c": 12.0802
    },
    {
        "a": 12.4173,
        "b": 11.0891,
        "c": 10.0119
    },
    {
        "a": 12.4173,
        "b": 8.5548,
        "c": 8.3222
    },
    {
        "a": 12.4173,
        "b": 8.5548,
        "c": 9.7154
    },
    {
        "a": 12.4173,
        "b": 11.0891,
        "c": 8.9873
    },
    {
        "a": 12.4173,
        "b": 13.2317,
        "c": 12.3993
    },
    {
        "a": 12.4173,
        "b": 11.0891,
        "c": 9.0275
    }
]

Specification​

JSON schema​

{
    "type": "integer",
    "minimum": 1
}