TransformsCatalogクラス

プロパティ

プロパティ 内容
CategoricalTransforms Categorical カテゴリ データ (categorical data) に対する、操作のリスト
ConversionTransforms Conversion データ型変換の、操作のリスト
TextTransforms Text テキストデータ処理の、操作のリスト
FeatureSelectionTransforms FeatureSelection 基準に基づいて特徴を選択する、操作のリスト

メソッド

LoadImages(TransformsCatalog, String, String, String)

指定の列のデータを、新しい列に画像として読み込む、ImageLoadingEstimatorを作成できます。

public static Microsoft.ML.Data.ImageLoadingEstimator LoadImages (
    this Microsoft.ML.TransformsCatalog catalog,
    string outputColumnName,         // inputColumnNameの変換結果の列の名前
    string imageFolder,
    string inputColumnName = default // 読み込む画像へのパスを含む列の名前
    );
ImageEstimatorsCatalog.LoadImages メソッド (Microsoft.ML) | Microsoft Learn

LoadRawImageBytes(TransformsCatalog, String, String, String)

指定の列のデータを、新しい列に生バイトの画像 (image of raw bytes) として読み込む、ImageLoadingEstimatorを作成できます。

public static Microsoft.ML.Data.ImageLoadingEstimator LoadRawImageBytes (
    this Microsoft.ML.TransformsCatalog catalog,
    string outputColumnName,
    string imageFolder,
    string inputColumnName = default
    );

読み込んだデータを加工せずに機械学習モデルに渡すには、LoadImages()ではなくこのメソッドを用います。

ResizeImages(TransformsCatalog, String, Int32, Int32, String, ImageResizingEstimator.ResizingKind, ImageResizingEstimator.Anchor)

指定の列のデータを、新しい列の画像にリサイズする、ImageResizingEstimatorを作成できます。

public static Microsoft.ML.Transforms.Image.ImageResizingEstimator ResizeImages (
    this Microsoft.ML.TransformsCatalog catalog,
    string outputColumnName,
    int imageWidth,
    int imageHeight,
    string inputColumnName = default,
    Microsoft.ML.Transforms.Image.ImageResizingEstimator.ResizingKind resizing = Microsoft.ML.Transforms.Image.ImageResizingEstimator+ResizingKind.IsoCrop,
    Microsoft.ML.Transforms.Image.ImageResizingEstimator.Anchor cropAnchor = Microsoft.ML.Transforms.Image.ImageResizingEstimator+Anchor.Center
    );
ImageEstimatorsCatalog.ResizeImages メソッド (Microsoft.ML) | Microsoft Learn

トレーニングするときに画像のサイズが統一されていないと、IEstimator<TTransformer>.Fit()の呼び出しで「Schema mismatch for input column '***': expected known-size image, got unknown-size image Arg_ParamName_Name」としてArgumentOutOfRangeExceptionが投げられます。

ExtractPixels(TransformsCatalog, String, String, ImagePixelExtractingEstimator.ColorBits, ImagePixelExtractingEstimator.ColorsOrder, Boolean, Single, Single, Boolean)

指定の列のデータを、新しい列にピクセル値を抽出する、ImagePixelExtractingEstimatorを作成できます。

public static Microsoft.ML.Transforms.Image.ImagePixelExtractingEstimator ExtractPixels(
    this Microsoft.ML.TransformsCatalog catalog,
    string outputColumnName,
    string inputColumnName = default,
    Microsoft.ML.Transforms.Image.ImagePixelExtractingEstimator.ColorBits colorsToExtract = Microsoft.ML.Transforms.Image.ImagePixelExtractingEstimator.ColorBits.Rgb,
    Microsoft.ML.Transforms.Image.ImagePixelExtractingEstimator.ColorsOrder orderOfExtraction = Microsoft.ML.Transforms.Image.ImagePixelExtractingEstimator.ColorsOrder.ARGB,
    bool interleavePixelColors = false, // trueならば、ピクセルの色をインターリーブする
    float offsetImage = 0,
    float scaleImage = 1,
    bool outputAsFloatArray = true
    );
ImageEstimatorsCatalog.ExtractPixels Method (Microsoft.ML) | Microsoft Learn

interleavePixelColorsがtrueならば、orderOfExtractionの順に保持されます。

トレーニングするときに数値形式 (numerical format) になっていないと、IEstimator<TTransformer>.Fit()の呼び出しで「Schema mismatch for *** column '***': expected ***, got *** Arg_ParamName_Name」としてArgumentOutOfRangeExceptionが投げられます。

Microsoft Learnから検索