Package org.kie.kogito.explainability.handlers

Class LimeExplainerServiceHandler

java.lang.Object

org.kie.kogito.explainability.handlers.LimeExplainerServiceHandler

All Implemented Interfaces:

LocalExplainerServiceHandler<Map<String,org.kie.kogito.explainability.model.Saliency>,LIMEExplainabilityRequest>, org.kie.kogito.explainability.local.LocalExplainer<Map<String,org.kie.kogito.explainability.model.Saliency>>

@ApplicationScoped
public class LimeExplainerServiceHandler
extends Object
implements LocalExplainerServiceHandler<Map<String,org.kie.kogito.explainability.model.Saliency>,LIMEExplainabilityRequest>

Constructor Summary

Constructors

Constructor	Description
LimeExplainerServiceHandler(org.kie.kogito.explainability.local.lime.LimeExplainer explainer, PredictionProviderFactory predictionProviderFactory)

Method Summary

Modifier and Type	Method	Description
BaseExplainabilityResult	createFailedResult(LIMEExplainabilityRequest request, Throwable throwable)	Creates a result containing the "failed" information for an explanation calculation.
BaseExplainabilityResult	createIntermediateResult(LIMEExplainabilityRequest request, Map<String,org.kie.kogito.explainability.model.Saliency> result)	Creates a result containing the "intermediate" information for an explanation calculation.
BaseExplainabilityResult	createSucceededResult(LIMEExplainabilityRequest request, Map<String,org.kie.kogito.explainability.model.Saliency> result)	Creates a result containing the "success" information for an explanation calculation.
CompletableFuture<Map<String,org.kie.kogito.explainability.model.Saliency>>	explainAsync(org.kie.kogito.explainability.model.Prediction prediction, org.kie.kogito.explainability.model.PredictionProvider predictionProvider, Consumer<Map<String,org.kie.kogito.explainability.model.Saliency>> intermediateResultsConsumer)
org.kie.kogito.explainability.model.Prediction	getPrediction(LIMEExplainabilityRequest request)	Gets a Prediction object from the request for the LocalExplainer.
org.kie.kogito.explainability.model.PredictionProvider	getPredictionProvider(LIMEExplainabilityRequest request)	Gets a PredictionProvider object from the request for the LocalExplainer.
<T extends BaseExplainabilityRequest> boolean	supports(Class<T> type)	Checks whether an implementation supports a type of explanation.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.kie.kogito.explainability.local.LocalExplainer

explainAsync

Methods inherited from interface org.kie.kogito.explainability.handlers.LocalExplainerServiceHandler

explainAsyncWithResults

Constructor Details

LimeExplainerServiceHandler

@Inject
public LimeExplainerServiceHandler(org.kie.kogito.explainability.local.lime.LimeExplainer explainer,
 PredictionProviderFactory predictionProviderFactory)

Method Details

supports

public <T extends BaseExplainabilityRequest>
boolean supports(Class<T> type)

Description copied from interface: LocalExplainerServiceHandler

Checks whether an implementation supports a type of explanation.

Specified by:

supports in interface LocalExplainerServiceHandler<Map<String,org.kie.kogito.explainability.model.Saliency>,LIMEExplainabilityRequest>

Parameters:

type - The Trusty Service request type.

Returns:

true if the implementation supports the type of explanation.

getPredictionProvider

public org.kie.kogito.explainability.model.PredictionProvider getPredictionProvider(LIMEExplainabilityRequest request)

Description copied from interface: LocalExplainerServiceHandler

Gets a PredictionProvider object from the request for the LocalExplainer.

Specified by:

getPredictionProvider in interface LocalExplainerServiceHandler<Map<String,org.kie.kogito.explainability.model.Saliency>,LIMEExplainabilityRequest>

Parameters:

request - The explanation request.

Returns:

A PredictionProvider object.

getPrediction

public org.kie.kogito.explainability.model.Prediction getPrediction(LIMEExplainabilityRequest request)

Description copied from interface: LocalExplainerServiceHandler

Gets a Prediction object from the request for the LocalExplainer. It should contain all the necessary information for the LocalExplainer to calculate an explanation.

Specified by:

getPrediction in interface LocalExplainerServiceHandler<Map<String,org.kie.kogito.explainability.model.Saliency>,LIMEExplainabilityRequest>

Parameters:

request - The explanation request.

Returns:

A Prediction object containing all of the information necessary to calculate an explanation.

createSucceededResult

public BaseExplainabilityResult createSucceededResult(LIMEExplainabilityRequest request,
 Map<String,org.kie.kogito.explainability.model.Saliency> result)

Description copied from interface: LocalExplainerServiceHandler

Creates a result containing the "success" information for an explanation calculation.

Specified by:

createSucceededResult in interface LocalExplainerServiceHandler<Map<String,org.kie.kogito.explainability.model.Saliency>,LIMEExplainabilityRequest>

Parameters:

request - The original request.

result - The result from the LocalExplainer calculation.

Returns:

createIntermediateResult

public BaseExplainabilityResult createIntermediateResult(LIMEExplainabilityRequest request,
 Map<String,org.kie.kogito.explainability.model.Saliency> result)

Description copied from interface: LocalExplainerServiceHandler

Creates a result containing the "intermediate" information for an explanation calculation.

Specified by:

createIntermediateResult in interface LocalExplainerServiceHandler<Map<String,org.kie.kogito.explainability.model.Saliency>,LIMEExplainabilityRequest>

Parameters:

request - The original request.

result - The intermediate result from the LocalExplainer calculation.

Returns:

createFailedResult

public BaseExplainabilityResult createFailedResult(LIMEExplainabilityRequest request,
 Throwable throwable)

Description copied from interface: LocalExplainerServiceHandler

Creates a result containing the "failed" information for an explanation calculation.

Specified by:

createFailedResult in interface LocalExplainerServiceHandler<Map<String,org.kie.kogito.explainability.model.Saliency>,LIMEExplainabilityRequest>

Parameters:

request - The original request.

throwable - The exception thrown during calculation.

Returns:

explainAsync

public CompletableFuture<Map<String,org.kie.kogito.explainability.model.Saliency>> explainAsync(org.kie.kogito.explainability.model.Prediction prediction,
 org.kie.kogito.explainability.model.PredictionProvider predictionProvider,
 Consumer<Map<String,org.kie.kogito.explainability.model.Saliency>> intermediateResultsConsumer)

Specified by:

explainAsync in interface org.kie.kogito.explainability.local.LocalExplainer<Map<String,org.kie.kogito.explainability.model.Saliency>>