matrix.Matrix.add_data¶

Matrix.add_data(choice: str, values_dict: dict[str, float] = None, **criteria_to_values)¶

Adds criterion data for the given choice, which is used to calculate their score.

Parameters

choice (str) – The name of the choice.
values_dict (Optional[dict[str, float]]) – The criterion-value pairs in the form of a dictionary.

Keyword Arguments

**criteria_to_values (float) – The criterion-value pairs (str, float) as keyword arguments.

Raises

TypeError – If neither values_dict nor criteria_to_values is given.

Examples

>>> import matrix
>>> m = matrix.Matrix()  # No need to add choices
>>> m.add_continuous_criterion('size', weight=4)
>>> m.add_continuous_criterion('price', weight=8)
>>> m.if_(price=0).then(score=10)
>>> m.if_(price=10).then(score=0)
>>> m.if_(size=0).then(score=0)
>>> m.if_(size=10).then(score=10)
>>> m.add_data('apple', price=2, size=3)
>>> m.add_data('orange', {'price': 7, 'size': 5})
>>> m
|        |   size |   price | Percentage         |
|:-------|-------:|--------:|:-------------------|
| Weight |      4 |       8 |                    |
| apple  |      3 |       8 | 63.33333333333333  |
| orange |      5 |       3 | 36.666666666666664 |
>>> m.value_score_df
   price  price_score  size  size_score
0    0.0         10.0   NaN         NaN
1   10.0          0.0   NaN         NaN
2    NaN          NaN   0.0         0.0
3    NaN          NaN  10.0        10.0
>>> m.data_df
        price  size
apple       2     3
orange      7     5