PagesPanneau de sortie · 19 / 29

Panneau de sortie

Le panneau de sortie se trouve en bas de l'espace de travail QuantCraft ; c'est là qu'apparaît tout ce que dit ou dessine votre code : instructions print(), messages d'erreur, graphiques et progression des backtests de longue durée.

Il est partagé entre Run et Test : chaque exécution l'efface et écrit une sortie fraîche au fil de son déroulement. Les métriques et graphiques structurés apparaissent dans les Résultats des tests.

Ouvrir, réduire et redimensionner

Le panneau s'ouvre automatiquement dès que quelque chose de nouveau est journalisé ou tracé, afin que vous ne manquiez aucune sortie.
Cliquez sur le titre Output (ou sur la flèche à côté) pour réduire ou développer le panneau.
Le séparateur horizontal au-dessus du panneau peut être glissé vers le haut ou le bas pour lui donner plus ou moins d'espace à l'écran. Vous pouvez aussi donner le focus au séparateur et utiliser les flèches Haut / Bas pour l'ajuster.
La hauteur du panneau de sortie (et la répartition de l'éditeur) est mémorisée d'une session à l'autre.

Journaux (`stdout` et messages d'exécution)

Tout ce que votre script écrit sur la sortie standard apparaît sous forme de ligne de journal horodatée dans le panneau :

[14:32:11] Loaded 480 bars
[14:32:11] Entering position at 192.40
[14:32:13] Final equity: 102450.13

À savoir :

Chaque entrée est horodatée avec votre horloge locale.
Le texte du journal utilise une police à chasse fixe et revient à la ligne afin que les longues lignes restent lisibles sans défilement horizontal.
Le panneau défile automatiquement vers le dernier message à mesure que de nouvelles sorties arrivent, pendant l'exécution comme juste après sa fin.
Un court texte (no output) s'affiche si votre script s'est terminé sans rien à afficher.
Lorsque les données de calendrier sont activées, le moteur écrit une ligne [calendar] par opération sur titres appliquée (fractionnement ou dividende), plus une synthèse à la fin, par exemple :
[calendar] 2024-01-10 AAPL — SPLIT 4:1 applied to 1 position(s): 100 -> 400 shares (cost basis unchanged; bars stay unadjusted) [calendar] 2024-02-09 AAPL — DIVIDEND $0.2400/share on 400 share(s): +$96.00 cash … [calendar] corporate actions — 1 split(s) applied; 1 dividend(s) applied (0 exact ex-date, 1 estimated +/-7d)
Si aucune ligne [calendar] n'apparaît, vérifiez que Include calendar data est activé dans la fenêtre d'exécution — voir Données de calendrier.
Lors d'un backtest Screener, un onglet Screener Output apparaît à côté de Logs, listant chaque date de rééquilibrage et les symboles négociés pour cette fenêtre — voir Screener.

Il existe un plafond d'environ 200 entrées par onglet ; les lignes les plus anciennes sont supprimées lorsque le plafond est atteint. Pour les exécutions qui produisent d'énormes quantités de sortie, préférez synthétiser dans le code ou n'afficher qu'une barre sur N.

Erreurs (`stderr`)

Tout ce qui est écrit sur l'erreur standard — traces d'exceptions, avertissements que votre code envoie vers stderr, ou messages du framework — est mis en évidence en rouge et compté dans l'en-tête du panneau :

Un petit badge N error / N errors apparaît à côté du titre Output et indique combien de lignes d'erreur ont été journalisées.
Les erreurs conservent leur horodatage comme les lignes de journal normales, ce qui permet de les rapprocher des événements alentour.
Si une exécution se termine avec un code de sortie non nul sans avoir écrit sur stderr, vous verrez une seule ligne d'erreur (exit code N) pour savoir que l'exécution a échoué.

Le nombre d'erreurs est un compteur en direct : effacer la sortie (ce qui se produit au début de chaque Run / Test) le réinitialise, et si la nouvelle exécution installe un paquet ou se rétablit d'un échec précédent, le compte est supprimé.

Graphiques

Le panneau de sortie affiche des figures intégrées issues de votre code, sans visionneuse externe.

Matplotlib

Toute figure Matplotlib que votre code affiche pendant l'exécution apparaît sous forme d'image PNG à la largeur du panneau. Idéal pour des graphiques exploratoires rapides.

Plotly

Les figures Plotly sont rendues sous forme de graphiques entièrement interactifs dans le panneau :

Survolez une série pour voir les valeurs exactes.
Zoomez et déplacez-vous à la souris / au toucher.
Utilisez la barre d'outils Plotly pour télécharger, mettre à l'échelle automatiquement et d'autres actions.
Le graphique se redimensionne avec le panneau.

Chaque graphique — Matplotlib ou Plotly — apparaît dans son propre bloc encadré dans la chronologie du panneau, à côté des lignes de journal, ce qui vous permet de voir exactement où il a été produit par rapport à votre sortie print().

Les graphiques et les journaux partagent le même plafond par onglet ; de très longues séries de figures finiront donc par faire sortir de la vue les sorties précédentes.

Progression des longues exécutions

Lorsqu'un backtest est en cours, l'en-tête du panneau reçoit deux éléments supplémentaires pour suivre la progression sans fixer des journaux qui défilent :

Une barre de progression avec un libellé tel que :
- Bar 1234 / 5000 — combien de barres simulées ont été traitées.
- Run 3 / 10 — pour une optimisation en cours, l'exécution en cours sur le total.
- Gen 2/5 · 7/16 — pour l'optimisation génétique, génération/individu en cours.
- Backtest running tant que le moteur a démarré mais qu'aucune progression exacte n'est encore disponible.
La barre grandit à mesure que le moteur rapporte sa progression et disparaît dès que l'exécution se termine.

Vous pouvez réduire le panneau : la barre de progression reste visible dans l'en-tête, de sorte que l'état de l'exécution est toujours à portée de regard, même si vous êtes concentré sur l'éditeur.

Bouton Disclaimer

L'en-tête comporte un bouton Disclaimer qui ouvre un court avis sur la manière dont QuantCraft exécute Python sur votre machine. C'est la même explication que celle affichée avant votre premier Run, disponible à tout moment si vous voulez la relire. La fermer ne modifie pas vos paramètres.

Conseils

print() est votre ami pour un débogage rapide. Gardez des messages courts et étiquetez-les (f"[ENTRY] {symbol} {qty} @ {price}") pour les repérer facilement.
Envoyez les longs détails dans un fichier depuis votre code plutôt que d'afficher des milliers de lignes : seules les quelque 200 dernières entrées restent visibles.
Les erreurs sont en rouge et comptées dans le badge : quand le compteur augmente, allez en bas ; la dernière erreur est généralement ce qui a arrêté l'exécution.
Pour Plotly, utilisez le séparateur de redimensionnement du panneau pour donner plus de hauteur au graphique ; il s'adapte automatiquement.
Le panneau est partagé entre les fichiers : si vous changez d'onglet en cours d'exécution, la sortie que vous voyez correspond à la dernière exécution / à l'exécution active.

6 min de lectureSuggérer une modification ↗