ValueMappingEstimator<TKey,TValue> 클래스

정의

입력 데이터의 값 쌍을 사용하여 키-값 맵을 만들기 위한 ValueMappingTransformer 예측 도구 PrimitiveDataViewType

public sealed class ValueMappingEstimator<TKey,TValue> : Microsoft.ML.Transforms.ValueMappingEstimator
type ValueMappingEstimator<'Key, 'Value> = class
    inherit ValueMappingEstimator
Public NotInheritable Class ValueMappingEstimator(Of TKey, TValue)
Inherits ValueMappingEstimator

형식 매개 변수

TKey

키 형식을 지정합니다.

TValue

값 유형을 지정합니다.

상속

설명

예측 도구 특성

이 추정기는 매개 변수를 학습하기 위해 데이터를 확인해야 합니까? 아니요
입력 열 데이터 형식 벡터 또는 기본 숫자, 부울, 텍스트, System.DateTime 형식입니다.
출력 열 데이터 형식 벡터 또는 기본 숫자, 부울, 텍스트, System.DateTime 형식입니다.
ONNX로 내보낼 수 있습니다. 아니요

키 역할을 하는 값과 사전의 값으로 사용되는 값의 두 집합이 지정된 경우 ValueMappingEstimator는 특정 키를 지정하면 특정 값을 반환할 수 있도록 이 사전을 빌드합니다. ValueMappingEstimator는 다양한 데이터 형식을 지원하기 위해 다른 System.Type 의 키와 값을 지원합니다. ValueMappingEstimator를 사용하는 예제는 다음과 같습니다.

  • 문자열 값을 문자열 값으로 변환하면 그룹화에 유용할 수 있습니다(예: 'cat', 'dog', 'horse'는 '포유동물'에 매핑됨).
  • 문자열 값을 정수 값으로 변환(예: 품질과 같은 텍스트 설명을 'good'이 1로 매핑되는 숫자로 변환, '불량'은 0으로 매핑).
  • 정수 값을 문자열 값으로 변환하고 문자열 값이 형식으로 표현되도록 합니다. (즉, 우편 번호를 상태 문자열 값으로 변환하여 레이블로 사용할 수 있는 고유한 정수 값을 생성합니다.

여러 키가 동일한 값에 매핑되도록 값을 반복할 수 있지만 키를 반복할 수는 없습니다. 키와 값 간의 매핑은 목록을 통해 지정할 수 있습니다. 여기서 키 목록과 값 목록은 크기가 같아야 하거나 System.IDataView를 통해 수행할 수 있습니다.

사용 예제에 대한 링크는 참고 섹션을 참조하세요.

메서드

Fit(IDataView)

입력 데이터의 값 쌍을 사용하여 키-값 맵을 만들기 위한 ValueMappingTransformer 예측 도구 PrimitiveDataViewType

(다음에서 상속됨 TrivialEstimator<TTransformer>)
GetOutputSchema(SchemaShape)

변환기에서 SchemaShape 생성할 스키마를 반환합니다. 파이프라인에서 스키마 전파 및 확인에 사용됩니다.

(다음에서 상속됨 ValueMappingEstimator)

확장 메서드

AppendCacheCheckpoint<TTrans>(IEstimator<TTrans>, IHostEnvironment)

추정기 체인에 '캐싱 검사점'을 추가합니다. 이렇게 하면 다운스트림 추정기가 캐시된 데이터에 대해 학습됩니다. 여러 데이터 전달을 수행하는 트레이너 앞에 캐싱 검사점을 두는 것이 유용합니다.

WithOnFitDelegate<TTransformer>(IEstimator<TTransformer>, Action<TTransformer>)

추정기가 지정된 경우 대리자를 호출한 후 Fit(IDataView) 호출되는 래핑 개체를 반환합니다. 예측 도구가 적합한 항목에 대한 정보를 반환하는 것이 중요한 경우가 많습니다. 따라서 Fit(IDataView) 메서드는 일반 ITransformer개체가 아닌 특별히 형식화된 개체를 반환합니다. 그러나 동시에 IEstimator<TTransformer> 개체가 많은 파이프라인으로 형성되는 경우가 많으므로 변압기를 가져올 추정기가 이 체인의 어딘가에 묻혀 있는 위치를 통해 EstimatorChain<TLastTransformer> 추정기 체인을 빌드해야 할 수도 있습니다. 이 시나리오에서는 fit이 호출되면 호출되는 대리자를 이 메서드를 통해 연결할 수 있습니다.

적용 대상

추가 정보