Utilisation de fonctions simples

Pour vos calculs dans Maximo® Monitor, vous pouvez saisir ou coller une fonction simple dans Maximo Monitor dans le cadre de vos calculs. Vous devez maîtriser l'écriture de la fonction simple avant de l'ajouter.

Une fonction simple est un bloc de code Python . Il a une trame de données et un dictionnaire de paramètres comme entrées. Contrairement aux fonctions personnalisées, les fonctions simples produisent un élément de données unique comme sortie.

Il arrive parfois que vous écriviez une expression plutôt qu'une fonction simple pour effectuer un calcul de base. Utilisez une fonction simple si vous souhaitez ajouter plusieurs lignes de code, ou si vous voulez ajouter une logique de contrôle à votre code.

Utilisez PythonFunction à partir du catalogue de fonctions pour ajouter une fonction simple.

Pour les métriques de flux de données en continu, utilisez la syntaxe Python . Vous pouvez utiliser la syntaxe pandas pour les métriques de données par lots.

Ecriture de fonctions simples

Les métriques de données par Maximo Monitor lots utilisent la bibliothèque pandas. Pour plus d'informations, consultez la section Utilisation des calculs. Avant d'écrire des expressions pour les métriques de données par lots, familiarisez-vous avec les structures de données, les opérations et la syntaxe dans les pandas.

Remarque : lorsque vous entrez une fonction simple dans Maximo Monitor, vous n'écrivez pas une nouvelle fonction d' Python. En revanche, la fonction simple est un paramètre d'entrée d'une fonction intégrée. Vous devez adapter la syntaxe de votre bloc de code en conséquence.

Exemple

Un gestionnaire des opérations surveille de près les performances d'un bras robotisé nouvellement introduit. La distance parcourue par chaque bras robotisé pendant les essais est calculée. Le responsable des opérations demande que les valeurs extrêmes soient signalées pour chaque bras robotisé à des fins d'analyse plus poussée. Le responsable s'intéresse aux distances trop élevées.

Un spécialiste des données définit une nouvelle métrique is_distance_high comme suit:

is_distance_high = True where distance > threshold

Le spécialiste des données définit le seuil comme suit :

threshold = (mean(distance) + 2) * std(distance)

Un analyste écrit la fonction simple suivante pour le calcul :

def f(df,parameters = None):
    import numpy as np
    threshold = df['distance'].mean() + 2 * df['distance'].std()
    output = np.where(df['distance']>threshold,1,0)
    return output

Avant que l'analyste puisse coller le bloc de code dans Maximo Monitor, la fonction doit respecter les règles suivantes :

  • La fonction doit être nommée f.
  • La fonction doit accepter un cadre de données (df) et des paramètres en entrée.
  • La fonction doit renvoyer un cadre de données, une série, un tableau NumPy ou une valeur scalaire en sortie.

L'analyste ajoute un nouveau calcul à l'aide de PythonFunction dans le catalogue. Dans les zones d'entrée, l'analyste sélectionne distance et colle le bloc de code dans la zone d'entrée function_code. L'analyste identifie le paramètre de sortie sous la forme is_distance_high.

Test de fonctions simples

Testez vos fonctions simples dans votre propre environnement avant de les utiliser dans Maximo Monitor.

Utilisez un magasin de modèles de fichier dans lequel conserver une fonction localement lors des tests.

Informations complémentaires