:normalize

Les fonctions de caractéristiques s'utilisent dans les expressions de tri. La plupart ne sont prises en charge que dans les expressions de tri fin. Combinez diverses syntaxes et instructions pour créer des fonctionnalités de tri puissantes.

Vous devez créer un index ou une propriété pour tout champ de document utilisé comme paramètre dans une fonction de caractéristique. Pour plus d'informations, consultez la documentation relative à cette fonction.

1. Présentation :

Lors du calcul de la pertinence, la qualité d'un document se mesure selon différentes dimensions. Chaque dimension peut avoir une plage de scores différente. Par exemple, le nombre de clics sur une page peut atteindre des dizaines de millions, tandis que les scores de pertinence textuelle se situent dans la plage [0, 1]. Ces scores ne sont pas directement comparables. Pour utiliser ces éléments dans une formule, vous devez normaliser les différents scores sur la même plage. La fonction normalize offre une méthode simple pour cette normalisation. Elle prend en charge trois méthodes : la fonction linéaire, la fonction logarithmique et la fonction arc tangente. La fonction sélectionne automatiquement la méthode en fonction des paramètres d'entrée. Si vous spécifiez uniquement le paramètre value, normalize utilise la fonction arc tangente. Si vous spécifiez les paramètres value et max, normalize utilise la fonction logarithmique. Si vous spécifiez les paramètres value, max et min, normalize utilise la fonction linéaire.

2. Utilisation :

normalize(value, max, min)

3. Paramètres :

• value : Valeur à normaliser. Ce paramètre prend en charge les nombres à virgule flottante en double précision. La valeur peut être extraite d'un champ de document ou d'une autre expression.

• max : Valeur maximale de l'entrée. Ce paramètre est facultatif et prend en charge les nombres à virgule flottante en double précision.

• min : Valeur minimale de l'entrée. Ce paramètre est facultatif et prend en charge les nombres à virgule flottante en double précision.

4. Valeur de retour :

Une valeur double dans la plage [0, 1].

5. Scénarios :

Scénario 1 : Pour normaliser le champ price lorsque sa plage de valeurs est inconnue, utilisez la formule suivante : normalize(price)

Scénario 2 : Pour normaliser le champ price lorsque vous savez uniquement que sa valeur maximale est 100, utilisez la formule suivante : normalize(price, 100)

Scénario 3 : Pour normaliser le champ price lorsque vous savez que sa valeur maximale est 100 et sa valeur minimale est 1, utilisez la formule suivante : normalize(price, 100, 1)

Scénario 4 : Pour normaliser le résultat de la fonction distance dans la plage [0, 1] : normalize(distance(longitude_in_doc, latitude_in_doc, longitude_in_query, latitude_in_query))

6. Notes :

• Créez les paramètres de la fonction sous forme de propriétés.

• Lorsque vous utilisez la fonction arc tangente pour la normalisation, la valeur normalisée est 0 si value est inférieure à 0.

• Lorsque vous utilisez la fonction logarithmique pour la normalisation, max doit être supérieur à 1.

• Lorsque vous utilisez la fonction linéaire pour la normalisation, max doit être supérieur à min.