For the complete documentation index, see llms.txt. This page is also available as Markdown.

Cycle Timer

Ce bloc fonction mesure le temps écoulé entre évaluations consécutives et fournit cette durée sous forme de valeur numérique. Il est utile pour profiler des étapes, mesurer des périodes de boucles ou d'événements, et surveiller les performances d'exécution en temps réel.

📥 Entrées

Ce bloc fonction n'a aucune entrée.

📤 Sorties

Seconds Cette sortie fournit le temps écoulé (en secondes) depuis l'évaluation précédente. Lors de la toute première évaluation après le placement ou la réinitialisation, la sortie sera égale à zéro.

🕹️ Contrôles

No Controls Ce bloc n'a pas de contrôles visibles pour l'utilisateur. Il met automatiquement à jour son horodatage interne à chaque exécution.

⚙️ Mécanisme d'exécution

  • À chaque évaluation du bloc dans le scénario, il compare l'heure courante avec l'heure enregistrée lors de l'évaluation précédente et renvoie leur différence sous forme de Seconds.

  • La première évaluation sert d'initialisation et renvoie zéro car il n'existe pas d'horodatage précédent.

  • Comme le bloc mesure le temps réel (wall-clock), il fournit une mesure haute résolution adaptée à la mesure d'intervalles courts entre étapes ou événements.

🎯 Fonctions

  • Mesure d'intervalle légère et automatique, sans configuration.

  • Mesure haute résolution, idéale pour le profilage et la surveillance des cycles.

  • Valeurs immédiatement disponibles pour un traitement en aval ou pour l'enregistrement.

📝 Instructions d'utilisation

  1. Placez le bloc dans votre scénario à l'endroit où vous souhaitez mesurer le temps écoulé entre évaluations.

  2. Lisez la sortie Seconds dans les blocs en aval pour consigner, analyser ou déclencher des actions basées sur le temps écoulé.

  3. Gardez à l'esprit que la première mesure après le placement ou la réinitialisation renvoie zéro.

Combinaisons courantes :

  • Utilisez avec Rising Edge ou Logic Input pour mesurer le temps entre événements discrets ou actions déclenchées par l'utilisateur.

  • Utilisez avec des sources d'image comme Camera USB, Stream Reader ou Video pour mesurer les intervalles d'images ou la latence de traitement.

  • Envoyez la sortie à Round pour une présentation numérique plus propre, ou à Scope pour afficher un graphique en direct des temps de cycle.

  • Enregistrez les valeurs vers CSV Export ou Image Logger pour conserver l'historique des temps de cycle.

💡 Astuces et conseils

  • Pour surveiller la stabilité du traitement, connectez Seconds à Scope afin de visualiser le jitter et les pics au fil du temps.

  • Pour un enregistrement à long terme, utilisez CSV Export pour collecter les temps de cycle en vue d'analyses hors ligne.

  • Pour mesurer entre actions manuelles, combinez avec Keyboard/Barcode Reader ou Logic Input afin de capturer des durées précises d'événement à événement.

  • Si vous avez besoin d'un affichage formaté, utilisez Round pour réduire les décimales avant d'afficher les valeurs dans des blocs UI.

🛠️ Dépannage

  • Si vous observez constamment des valeurs nulles, vérifiez que le scénario s'exécute réellement de façon répétée et n'est pas figé ; la première évaluation après placement ou réinitialisation renvoie zéro par conception.

  • Si les mesures affichent des intervalles anormalement petits, assurez-vous que le bloc n'est pas évalué plusieurs fois par étape logique à cause d'autres constructions de flux. Envisagez d'utiliser un déclencheur d'événement (par exemple Rising Edge) pour que le bloc mesure uniquement aux moments souhaités.

  • Pour réduire les pics de bruit dans les mesures à court terme, lissez ou faites la moyenne de plusieurs valeurs Seconds consécutives en aval, ou enregistrez et post-traitez les données.

Mis à jour