pyreal.explanation_types.feature_based.AdditiveFeatureContributionExplanation#

class pyreal.explanation_types.feature_based.AdditiveFeatureContributionExplanation(explanation, values=None)[source]#

A type wrapper for local feature contribution DataFrame type outputs from explanation algorithms. Local feature contribution explanations give one numeric value per instance per feature, representing that feature’s contribution to the model’s prediction for this instance. Contribution values can be added together with meaningful effect (ie., contribution of feature A + contribution of feature B = combined contribution of feature A and B)

__init__(explanation, values=None)#

Set the wrapped explanation to explanation and values to values and validate :param explanation: wrapped explanation :type explanation: object :param values: Values corresponding with the object being explained :type values: DataFrame of shape (n_instances, n_features) or None

Methods

__init__(explanation[, values])

Set the wrapped explanation to explanation and values to values and validate :param explanation: wrapped explanation :type explanation: object :param values: Values corresponding with the object being explained :type values: DataFrame of shape (n_instances, n_features) or None

apply_feature_descriptions(feature_descriptions)

Apply feature descriptions to explanation

combine_columns(columns, new_column)

Combine the values for columns into a new column, if appropriate :param columns: Columns to sum :type columns: list of strings :param new_column: Name of new column :type new_column: string

get()

Get the explanation wrapped by this type.

get_all()

Get the explanation and wrapped values as a tuple.

get_explanation()

Get the explanation wrapped by this type

get_top_features([num_features, select_by])

Get the top features from the explanation :returns:

get_values()

Return the values associated with the explanation

update_explanation(new_explanation[, ...])

Sets this object's explanation to the new value.

update_values(values[, inplace])

Updates this objects values, and validates

validate()

Validate that self.explanation is a valid DataFrame :returns: None

validate_values()

Validate that self.values are valid values for this Explanation.