다음을 통해 공유


ScoringExplainer 클래스

채점 모델을 정의합니다.

transformationsoriginal_explainer에 전달된 경우 해당 변환은 채점 설명자에게 전달되고 원시 데이터를 예상하며 기본적으로 원시 기능에 대한 중요도가 반환됩니다. feature_maps가 여기에 전달되면(transformations와 동시에 사용되지 않음) 설명자는 변환된 데이터를 예상하고 기본적으로 변환된 데이터에 대해 중요도가 반환됩니다. 두 경우 모두 설명자의 explain 메서드에서 get_raw를 명시적으로 True 또는 False로 설정하여 출력을 지정할 수 있습니다.

ScoringExplainer를 초기화합니다.

transformationsoriginal_explainer에 전달된 경우 해당 변환은 채점 설명자에게 전달되고 원시 데이터를 예상하며 기본적으로 원시 기능에 대한 중요도가 반환됩니다. feature_maps가 여기에 전달되면(transformations와 동시에 사용되지 않음) 설명자는 변환된 데이터를 예상하고 기본적으로 변환된 데이터에 대해 중요도가 반환됩니다. 두 경우 모두 설명자의 explain 메서드에서 get_raw를 명시적으로 True 또는 False로 설정하여 출력을 지정할 수 있습니다.

상속
azureml._logging.chained_identity.ChainedIdentity
ScoringExplainer

생성자

ScoringExplainer(original_explainer, feature_maps=None, raw_features=None, engineered_features=None, **kwargs)

매개 변수

Name Description
original_explainer
필수
<xref:interpret_community.common.base_explainer.BaseExplainer>

학습 시간 설명자는 원래 모델을 설명하는 데 사용되었습니다.

feature_maps

원시에서 생성된 기능까지의 기능 맵 목록입니다. 목록은 numpy 배열 또는 스파스 행렬일 수 있습니다. 여기서 각 배열 항목(raw_index, generated_index)은 생성된 각 원시 기능 쌍의 가중치입니다. 다른 항목은 0으로 설정됩니다. 원시 기능에서 생성된 기능을 생성하는 일련의 변환 [t1, t2, ..., tn]의 경우 기능 맵 목록은 t1, t2 등과 같은 시퀀스로 원시에서 생성된 맵에 해당합니다. 전체 원시 t1에서 tn까지 생성된 기능 맵을 사용할 수 있는 경우 단일 요소 목록의 해당 기능 맵만 전달할 수 있습니다.

Default value: None
raw_features

원래 설명자가 엔지니어링된 기능에 대한 설명을 계산하는 경우 지정할 수 있는 원시 기능에 대한 기능 이름의 선택적 목록입니다.

Default value: None
engineered_features

원래 설명자에 변환이 전달되고 원시 기능의 중요도만 계산하는 경우 지정할 수 있는 엔지니어링된 기능에 대한 기능 이름의 선택적 목록입니다.

Default value: None
original_explainer
필수
<xref:interpret_community.common.base_explainer.BaseExplainer>

학습 시간 설명자는 원래 모델을 설명하는 데 사용되었습니다.

feature_maps
필수

원시에서 생성된 기능까지의 기능 맵 목록입니다. 목록은 numpy 배열 또는 스파스 행렬일 수 있습니다. 여기서 각 배열 항목(raw_index, generated_index)은 생성된 각 원시 기능 쌍의 가중치입니다. 다른 항목은 0으로 설정됩니다. 원시 기능에서 생성된 기능을 생성하는 일련의 변환 [t1, t2, ..., tn]의 경우 기능 맵 목록은 t1, t2 등과 같은 시퀀스로 원시에서 생성된 맵에 해당합니다. 전체 원시 t1에서 tn까지 생성된 기능 맵을 사용할 수 있는 경우 단일 요소 목록의 해당 기능 맵만 전달할 수 있습니다.

raw_features
필수

원래 설명자가 엔지니어링된 기능에 대한 설명을 계산하는 경우 지정할 수 있는 원시 기능에 대한 기능 이름의 선택적 목록입니다.

engineered_features
필수

원래 설명자에 변환이 전달되고 원시 기능의 중요도만 계산하는 경우 지정할 수 있는 엔지니어링된 기능에 대한 기능 이름의 선택적 목록입니다.

메서드

explain

채점을 위한 모델을 사용하여 데이터의 기능 중요도 값을 근사치로 표시합니다.

fit

scikit-learn 파이프라인 인터페이스에 맞추는 데 필요한 더미 메서드를 구현합니다.

predict

데이터의 기능 중요도 값을 가져오기 위해 채점에 TreeExplainer 및 트리 모델을 사용합니다.

.explain() 함수를 래핑합니다.

explain

채점을 위한 모델을 사용하여 데이터의 기능 중요도 값을 근사치로 표시합니다.

abstract explain(evaluation_examples, get_raw)

매개 변수

Name Description
evaluation_examples
필수
array 또는 DataFrame 또는 csr_matrix

모델의 출력을 설명할 특징 벡터 예제(예제 수 x 기능 수)의 행렬입니다.

get_raw
필수

True이면 원시 기능의 중요도 값이 반환됩니다. False이면 엔지니어링된 기능의 중요도 값이 반환됩니다. 지정되지 않고 transformations가 원래 설명자로 전달된 경우 원시 중요도 값이 반환됩니다. 지정되지 않고 feature_maps가 채점 설명자로 전달된 경우 엔지니어링된 중요도 값이 반환됩니다.

반환

형식 Description

회귀와 같은 단일 출력이 있는 모델의 경우 이 메서드는 기능 중요도 값의 행렬을 반환합니다. 벡터 출력이 있는 모델의 경우 이 함수는 각 출력에 대해 하나씩 이러한 행렬의 목록을 반환합니다. 이 행렬의 차원은 (예제 수 x 기능 수)입니다.

fit

scikit-learn 파이프라인 인터페이스에 맞추는 데 필요한 더미 메서드를 구현합니다.

fit(X, y=None)

매개 변수

Name Description
X
필수

학습 데이터입니다.

y

학습 대상입니다.

Default value: None

predict

데이터의 기능 중요도 값을 가져오기 위해 채점에 TreeExplainer 및 트리 모델을 사용합니다.

.explain() 함수를 래핑합니다.

predict(evaluation_examples)

매개 변수

Name Description
evaluation_examples
필수
array 또는 DataFrame 또는 csr_matrix

모델의 출력을 설명할 특징 벡터 예제(예제 수 x 기능 수)의 행렬입니다.

반환

형식 Description

회귀와 같은 단일 출력이 있는 모델의 경우 기능 중요도 값의 행렬을 반환합니다. 벡터 출력이 있는 모델의 경우 이 함수는 각 출력에 대해 하나씩 이러한 행렬의 목록을 반환합니다. 이 행렬의 차원은 (예제 수 x 기능 수)입니다.

특성

engineered_features

설명 호출에서 get_raw=False 매개 변수에 해당하는 엔지니어링된 기능 이름을 가져옵니다.

원래 설명자에 변환이 전달된 경우 엔지니어링된 기능은 engineered_features 매개 변수를 사용하여 채점 설명자 생성자에 전달되어야 합니다. 그렇지 않으면 기능 맵이 점수 매기기 설명자에게 전달된 경우 엔지니어링된 기능은 기능과 동일합니다.

반환

형식 Description
list[str],

엔지니어링된 기능 이름 또는 사용자가 지정하지 않은 경우 없음입니다.

features

기능 이름을 가져옵니다.

설명 호출에 get_raw 지정되지 않은 경우 기본 기능 이름을 반환합니다.

반환

형식 Description
list[str],

기능 이름 또는 사용자가 지정하지 않은 경우 None입니다.

raw_features

설명 호출에서 get_raw=True 매개 변수에 해당하는 원시 기능 이름을 가져옵니다.

원래 설명자에게 전달된 변환이 없었고 feature_maps 채점 설명자에게 전달된 경우 원시 기능 이름은 raw_features 매개 변수를 사용하여 채점 설명자 생성자에 전달되어야 합니다. 그렇지 않으면 원시 기능이 기능과 동일합니다.

반환

형식 Description
list[str],

원시 기능 이름 또는 사용자가 지정하지 않은 경우 없음입니다.