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 создает новый столбец с именем, указанным в параметрах имени выходного столбца, где выражение применяется к входным значениям. Не более одного из входных столбцов может иметь тип VectorDataViewType, а если входные данные содержат векторный столбец, выражение вычисляется независимо для каждого элемента вектора для создания векторных выходных данных с той же длиной, что и входные данные.

Язык выражений

Язык оценщика выражений должен быть удобным для широкого круга пользователей. Он имеет много общего с некоторыми популярными языками. Он учитывает регистр, поддерживает несколько типов и имеет широкий набор операторов и функций. Она является чисто функциональной в том смысле, что в языке нет изменяемых значений или изменяемых операций. Он не имеет и не нуждается в каком-либо механизме исключения, вместо этого создает значения NA, если нормальное значение не подходит. Он является статически типизированным, но все типы выводятся компилятором.

Синтаксис

Синтаксис лямбда-выражения состоит из списка параметров, за которым следует двоеточие (:) или стрелка (=>), за которой следует выражение. Список параметров может быть либо одним идентификатором, либо разделенным запятыми списком из одного или нескольких идентификаторов, окруженных круглыми скобками.

Лямбда:

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

список-параметров:

• identifier
• (parameter-names)

parameter-names:

• identifier
• identifier , parameter-names

Выражение может использовать параметры, литералы, операторы, выражения with и функции.

Литералы

• Логические литералы имеют значение true и false.
• Целочисленные литералы могут быть десятичными или шестнадцатеричными (например, 0x1234ABCD). Они могут иметь суффиксы you или U, обозначающие неподписанный знак, а также l или L, обозначающие long (Int64). Вы или U используется редко и влияет только на повышение определенных 32-разрядных шестнадцатеричных значений, определяя, считается ли константа отрицательным значением Int32 или положительным значением Int64.
• Литералы с плавающей запятой используют стандартный синтаксис, включая экспоненциальную нотацию (123,45e-37). Они могут быть обозначены суффиксами f или F, обозначающими однократную точность, или d или D, обозначающие двойную точность. В отличие от C#, по умолчанию точность литерала с плавающей запятой — одна точность. Чтобы указать двойную точность, добавьте d или D.
• Текстовые литералы заключаются в двойные кавычки и поддерживают стандартные escape-механизмы.

Операторы

Операторы языка выражений перечислены в следующей таблице в порядке предопределенности. Если не указано иное, бинарные операторы остаются ассоциативными и распространяют значения NA (если одно из значений операнда — NA, результатом является NA). Как правило, переполнение целочисленных значений приводит к НС, а переполнение значений с плавающей запятой — к бесконечности.

Выражение With

Синтаксис выражения with-expression имеет следующий вид:

with-expression:

• with( assignment-list ; expression )

assignment-list:

• назначение
• assignment , assignment-list

Назначения:

• выражение идентификатора =

Выражение with вводит одно или несколько именованных значений. Например, следующее выражение преобразует температуру celcius в значение fahrenheit, а затем создает сообщение в зависимости от того, слишком низкая или высокая ли температура по fahrenheit.

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

Выражение для одного назначения может ссылаться на идентификаторы, введенные предыдущими назначениями, как в этом примере, который возвращает -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)

При этом день недели вычисляется на основе количества тактов (int64) со времени стандартной эпохи даты и времени .NET (01.01.0001 в идеализованном григорианском календаре). Задания используются для числа тактов в секунду, числа тактов в час, числа тактов в году и дня недели для эпохи. В этом примере мы хотим сопоставить воскресенье с нулем, поэтому, так как эпоха является понедельником, мы задаем значение dayEpoch равным 1. Если эпоха была изменена или мы хотели бы сопоставить другой день недели с нулевым, мы бы просто изменили dayEpoch. Обратите внимание, что ticksPerSecond определяется как 10000000L, чтобы сделать его значением Int64 (8-байтовое целое число). Без суффикса L ticksPerDay переполняет диапазон Int32.

Функции

Преобразование выражений поддерживает множество полезных функций.

Общие унарные функции, которые могут принимать операнды любого типа, перечислены в следующей таблице.

Унарные функции преобразования перечислены в следующей таблице. Операнд НС создает НС или выдает исключение, если тип не поддерживает его. Преобразование, которое не завершается успешно, или переполнение также приводит к НД или исключению. Чаще всего это происходит при преобразовании из текста, в котором используется стандартный анализ преобразования. При преобразовании значения с плавающей запятой (float или double) в целочисленное значение (Int32 или Int64) преобразование выполняет операцию усечения (округление к нулю).

Унарные функции, которым требуется числовой операнд, перечислены в следующей таблице. Тип результата совпадает с типом операнда. Значение операнда НС создает значение НС.

Двоичные функции, которым требуются числовые операнды, перечислены в следующей таблице. Если типы операндов не совпадают, операнды повышаются до соответствующего типа. Тип результата совпадает с типом операнда с повышенным значением. Значение операнда НС создает значение НС.

Унарные функции, которым требуется операнд с плавающей запятой, перечислены в следующей таблице. Тип результата совпадает с типом операнда. Переполнение производит бесконечность. Недопустимые входные значения создают НД.

Двоичные функции, которым требуются операнды с плавающей запятой, перечислены в следующей таблице. Если типы операндов не совпадают, операнды повышаются до соответствующего типа. Тип результата совпадает с типом операнда с повышенным значением. Значение операнда НС создает значение НС.

Текстовые функции перечислены в следующей таблице.

Методы

Методы расширения

Применяется к

См. также раздел

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