:normalize

Las funciones de función se utilizan en expresiones de ordenamiento. La mayoría de estas funciones solo están disponibles en las expresiones de ordenamiento fino. Es posible combinar diversos sintaxis y cláusulas para ejecutar ordenamientos complejos.

Los campos que se referencian en los parámetros de las funciones de función deben configurarse como campos de índice o de atributo, según la descripción de cada función.

1. Descripción general del escenario

La relevancia de un documento se calcula a partir de distintas dimensiones. Las puntuaciones obtenidas de cada dimensión pueden pertenecer a diferentes rangos de valores. Por ejemplo, una página web puede tener millones de clics, mientras que su puntuación de relevancia de texto es un valor entre 0 y 1. No es posible comparar directamente valores que pertenecen a rangos distintos. La función normalize convierte las puntuaciones de distintos rangos a un mismo rango de valores. De esta manera, las puntuaciones normalizadas sirven para cálculos posteriores. Esta función admite tres métodos de normalización: lineal, logarítmica y por arcotangente. El método aplicado depende de los parámetros de entrada. Si solo se establece el parámetro value, la función utiliza la arcotangente. Si se establecen los parámetros value y max, se aplica la función logarítmica. Cuando se especifican los parámetros value, max y min, se emplea la función lineal.

1. Sintaxis

normalize(value, max, min)

1. Parámetros

   • value: campo de un documento o expresión cuyo valor o valor de retorno desea normalizar. Este valor debe ser de tipo DOUBLE.

   • max: valor máximo del rango después de la normalización. Este parámetro es opcional y debe ser de tipo DOUBLE.

   • min: valor mínimo del rango después de la normalización. Este parámetro es opcional y debe ser de tipo DOUBLE.

2. Valor de retorno

El valor de retorno es de tipo DOUBLE. Los valores válidos se encuentran en el rango [0.1].

1. Escenarios

Escenario 1: desea normalizar el valor del campo price, pero desconoce su rango de valores. En este caso, utilice la función normalize con el siguiente formato: normalize(price).

Escenario 2: busca normalizar el valor del campo price y solo conoce el valor máximo de su rango. Para este propósito, aplique la función normalize con el siguiente formato: normalize(price, 100).

Escenario 3: requiere normalizar el valor del campo price, donde el valor máximo es 100 y el mínimo es 1. Aquí conviene usar la función normalize con el siguiente formato: normalize(price, 100, 1).

Escenario 4: necesita normalizar el valor de retorno de la función distance a un valor entre 0 y 1. Para lograrlo, emplee la función normalize con el siguiente formato: normalize(distance(longitude_in_doc, latitude_in_doc, longtitude_in_query, latitude_in_query)).

1. Notas de uso:

   • Configure el campo referenciado en la función como un campo de atributo.

   • Si se usa la normalización por arcotangente y el valor del campo o el valor de retorno de la expresión especificada es menor que 0, la función normalize devuelve 0.

   • Cuando se aplica la normalización logarítmica, el valor del parámetro max debe ser mayor que 1.

   • Al utilizar la normalización lineal, el valor del parámetro max debe ser mayor que el del parámetro min.