ExpressionEstimator クラス

定義

public sealed class ExpressionEstimator : Microsoft.ML.IEstimator<Microsoft.ML.Transforms.ExpressionTransformer>

type ExpressionEstimator = class
    interface IEstimator<ExpressionTransformer>

Public NotInheritable Class ExpressionEstimator
Implements IEstimator(Of ExpressionTransformer)

継承

Object

ExpressionEstimator

実装

IEstimator<ExpressionTransformer>

注釈

推定器の特性

結果として得られる ExpressionTransformer は、出力列名パラメーターで指定された という名前の新しい列を作成します。ここで、式は入力値に適用されます。 入力列の最大 1 つは VectorDataViewType 型で、入力にベクター列が含まれている場合、式はベクターの各要素で独立して計算され、その入力と同じ長さのベクター出力が作成されます。

式言語

式推定器の言語は、幅広いユーザーにとって快適である必要があります。 これは、いくつかの一般的な言語と多くの類似点を共有しています。 大文字と小文字が区別され、複数の型がサポートされ、豊富な演算子と関数のセットがあります。 言語に変更可能な値や変更操作が存在しないという意味では、純粋な機能です。 通常の値が適切でない場合に NA 値を生成する代わりに、例外メカニズムも必要もありません。 静的に型指定されますが、すべての型はコンパイラによって推論されます。

構文

ラムダの構文は、パラメーター リストの後にコロン (:)または矢印 (=>) の後に式が続く形式で構成されます。 パラメーター リストには、1 つの識別子、またはかっこで囲まれた 1 つ以上の識別子のコンマ区切りのリストを指定できます。

ラムダ：

• parameter-list : expression
• parameter-list => expression

parameter-list:

• identifier
• (parameter-names)

parameter-names:

• identifier
• identifier , parameter-names

式では、パラメーター、リテラル、演算子、with-expressions、および関数を使用できます。

リテラル

• ブールリテラルは true と false です。
• 整数リテラルは、10 進数または 16 進数 (例: 0x1234ABCD) にすることができます。 これらは、u または U でサフィックスを付けることができ、符号なしを示し、l または L は long (Int64) を示します。 U または U の使用はまれであり、特定の 32 ビットの 16 進値の昇格にのみ影響し、定数が負の Int32 値と見なされるか、正の Int64 値と見なされるかが判断されます。
• 浮動小数点リテラルでは、指数表記 (123.45e-37) を含む標準構文が使用されます。 F または F のサフィックスを付け、単精度を示すか、d または D を付け、倍精度を示すことができます。 C# とは異なり、浮動小数点リテラルの既定の有効桁数は単精度です。 倍精度を指定するには、d または D を追加します。
• テキスト リテラルは二重引用符で囲まれており、標準のエスケープ メカニズムをサポートします。

演算子

式言語の演算子を次の表に示します。前置順に示します。 特に記載がない限り、二項演算子は結合されたままであり、NA 値を伝達します (どちらかのオペランド値が NA の場合、結果は NA になります)。 一般に、整数値のオーバーフローは NA を生成し、浮動小数点値のオーバーフローは無限大を生成します。

With 式

with-expression の構文は次のとおりです。

with-expression:

• with( assignment-list ; expression )

assignment-list:

• 割り当て
• assignment , assignment-list

割り当て：

• identifier = 式

with-expression には、1 つ以上の名前付き値が導入されています。 たとえば、次の式は、セルシウス温度を華氏に変換し、華氏が低すぎるか高すぎるかに基づいてメッセージを生成します。

c => with(f = c * 9 / 5 + 32 ; f < 60 ? "Too Cold!" : f > 90 ? "Too Hot!" : "Just Right!")

1 つの代入の式は、メッセージの代わりに -1、0、または 1 を返すこの例のように、前の割り当てによって導入された識別子を参照できます。

c : with(f = c * 9 / 5 + 32, cold = f < 60, hot = f > 90 ; -float(cold) + float(hot))

上で示したように、with-expression は、より大きな式で式の値が複数回必要な場合に便利です。 また、複雑な定数や重要な定数を扱う場合にも便利です。

    ticks => with(
        ticksPerSecond = 10000000L,
        ticksPerHour = ticksPerSecond \* 3600,
        ticksPerDay = ticksPerHour \* 24,
        day = ticks / ticksPerDay,
        dayEpoch = 1 ;
        (day + dayEpoch) % 7)

これにより、標準の .Net DateTime エポック (理想的なグレゴリオ暦では 01/01/0001) 以降のティック数 (Int64 として) から曜日が計算されます。 割り当ては、秒単位のティック数、1 時間あたりのティック数、1 年のティック数、エポックの曜日に使用されます。 この例では、日曜日を 0 にマップするため、エポックは月曜日であるため、dayEpoch を 1 に設定します。 エポックが変更された場合、または別の曜日を 0 にマップする場合は、単に dayEpoch を変更します。 ticksPerSecond は 10000000L として定義され、Int64 値 (8 バイト整数) になります。 L サフィックスがない場合、ticksPerDay は Int32 の範囲をオーバーフローします。

関数

式変換では、多くの便利な関数がサポートされています。

任意の型のオペランドを受け取ることができる一般的な単項関数を次の表に示します。

単項変換関数を次の表に示します。 NA オペランドは NA を生成し、型でサポートされていない場合は をスローします。 変換が成功しない、またはオーバーフローすると、NA または例外も発生します。 この最も一般的なケースは、標準の変換解析を使用するテキストから変換する場合です。 浮動小数点値 (float または double) から整数値 (Int32 または Int64) に変換する場合、変換では切り捨て操作が実行されます (ゼロに丸められます)。

数値オペランドを必要とする単項関数を次の表に示します。 結果の型はオペランド型と同じです。 NA オペランド値は NA を生成します。

数値オペランドを必要とするバイナリ関数を次の表に示します。 オペランド型が同じでない場合、オペランドは適切な型に昇格されます。 結果の型は、昇格されたオペランド型と同じです。 NA オペランド値は NA を生成します。

浮動小数点オペランドを必要とする単項関数を次の表に示します。 結果の型はオペランド型と同じです。 Overflow は無限大を生成します。 入力値が無効な場合、NA が生成されます。

浮動小数点オペランドを必要とするバイナリ関数を次の表に示します。 オペランド型が同じでない場合、オペランドは適切な型に昇格されます。 結果の型は、昇格されたオペランド型と同じです。 NA オペランド値は NA を生成します。

テキスト関数を次の表に示します。

メソッド

拡張メソッド

適用対象

こちらもご覧ください

• Expression(TransformsCatalog, String, String, String[])