Exécuter des scripts Python avec Minitab Statistical Software

Vous pouvez exécuter la commande PYSC dans le panneau Ligne de commande. Pour obtenir des informations générales sur le panneau Ligne de commande, accédez au panneau Ligne de commande/Historique. Pour obtenir des informations générales sur l’utilisation des commandes de session, accédez à Aide sur les commandes de session.

PYSC["filename.py"]["Args"...]

Exécute le script Python que vous spécifiez.

L'extension de fichier par défaut pour les scripts Python est .PY. Si l'extension de fichier est .PY, vous n'avez pas besoin de saisir l'extension de fichier.

L'argument facultatif Args permet de transmettre des arguments au script Python par sys.argv[1:]. Les Args peuvent être n'importe quelles valeurs de texte séparées par une espace. Utilisez des guillemets pour encadrer les arguments. La valeur par défaut est None, ce qui signifie que le script ne reçoit aucun argument.

En général, vous utilisez des arguments pour transférer des données de Minitab vers Python. Vous pouvez saisir des arguments de plusieurs façons. Par exemple, vous pouvez utiliser des arguments qui sont des identificateurs pour les colonnes, les matrices ou les constantes :

Commande de session Minitab	Valeur dans Python	Utilisation
PYSC "test.py" "C1"	"C1"	Utilisez la fonction suivante pour récupérer la colonne : mtbpy.mtb_instance().get_column(sys.argv[1:][0])
PYSC "test.py" "M1"	"M1"	Utilisez la fonction suivante pour récupérer la matrice : mtbpy.mtb_instance().get_matrix(sys.argv[1:][0])
PYSC "test.py" "K1"	"K1"	Utilisez la fonction suivante pour récupérer la constante : mtbpy.mtb_instance().get_constant(sys.argv[1:][0])

Vous pouvez également utiliser des arguments qui sont les noms des colonnes, des matrices ou des constantes dans Minitab :

Commande de session Minitab	Valeur dans Python	Utilisation
PYSC "test.py" "My Column"	"My Column"	Utilisez la fonction suivante pour récupérer la colonne : mtbpy.mtb_instance().get_column(sys.argv[1:][0])
PYSC "test.py" "My Matrix"	"My Matrix"	Utilisez la fonction suivante pour récupérer la matrice : mtbpy.mtb_instance().get_matrix(sys.argv[1:][0])
PYSC "test.py" "My Constant"	"My Constant"	Utilisez la fonction suivante pour récupérer la constante : mtbpy.mtb_instance().get_constant(sys.argv[1:][0])

Vous pouvez également spécifier des arguments pour transmettre du texte à utiliser dans votre code Python. Vous pouvez transmettre du texte directement ou dans une constante.

Commande de session Minitab	Valeur dans Python	Utilisation
PYSC "test.py" "Text not Stored"	"Text not Stored"	Ce cas a transmis une valeur qui ne peut pas être utilisée avec une commande "get" mtbpy. Cependant, les Args ne se limitent pas à la transmission de colonnes, de matrices et de constantes.
LET K1 = "Text in Constant" PYSC "test.py" K1	"Text in Constant"	Ce cas souligne que, bien que PYSC n'accepte pas les arguments qui ne sont pas des valeurs de texte, vous pouvez transmettre une constante à PYSC tant que la constante est définie comme une valeur de texte.

Lorsque vous transmettez plus d’un argument, vous pouvez accéder aux arguments dans l’ordre à partir de la liste des arguments :

Commande de session Minitab	Valeur dans Python	Utilisation
PYSC "test.py" "C1" "C2" "M1" "K3" "10"	"C1" "C2" "M1" "K3" "10"	Ce cas est un exemple de la transmission de plusieurs Args, où vous y accéderiez en utilisant les fonctions suivantes dans Python : mtbpy.mtb_instance().get_column(sys.argv[1:][0]) mtbpy.mtb_instance().get_column(sys.argv[1:][1]) mtbpy.mtb_instance().get_matrix(sys.argv[1:][2]) mtbpy.mtb_instance().get_constant(sys.argv[1:][3]) int(sys.argv[1:][4])

Utilisez le fichier suivant pour voir la sortie du texte d’exemple pour les sous-commandes suivantes. Assurez-vous que le fichier test.py se trouve dans le dossier de Minitab destiné aux scripts Python.

Fichier

Description

test.py

Un exemple de script Python utilisé tout au long de ce guide. Lorsque vous transmettez des arguments au script, les résultats incluent une liste des valeurs des arguments. Lorsque vous exécutez le script avec l’argument "ArgToBePrintedToStdErr", le script écrit le nom de l’argument dans le fichier stderr. Lorsque vous exécutez le script avec l’argument "ArgToBePrintedToStdOut", le script écrit le nom de l’argument dans le fichier stdout. Utilisez les sous-commandes qui suivent pour contrôler si le contenu de ces fichiers apparaît dans le panneau des résultats de Minitab.

NOSERR

Spécifie de ne pas afficher le texte de la sortie de console d'erreur standard (stderr) dans le panneau des résultats de Minitab. La sortie de console stderr est l’endroit où vous voyez des messages d’erreur Python lorsque vous exécutez votre code dans un environnement de développement intégré Python, bien que vous puissiez utiliser Python pour ajouter d’autres résultats dans le fichier stderr. Par exemple, par défaut :

PYSC "test.py" "ArgToBePrintedToStdErr". 

Génère les résultats suivants qui incluent la sortie de console stderr :

Python Script

These results are from external software.

The following arguments were passed to Python: ['ArgToBePrintedToStdErr']

Python standard error

The following arguments were printed to Stderr: 'ArgToBePrintedToStdErr'

Les commandes de session suivantes excluent la sortie de console stderr :

PYSC "test.py" "ArgToBePrintedToStdErr"; NOSERR.

Les commandes de session génèrent les résultats suivants :

Python Script

These results are from external software.

The following arguments were passed to Python: ['ArgToBePrintedToStdErr']

SOUT

Spécifie d'afficher le texte de la sortie de console standard (stdout) dans le panneau des résultats de Minitab. Le stdout est l'endroit où vous verriez les résultats de commandes comme print() dans un environnement de développement intégré Python. Par exemple, par défaut :

PYSC "test.py" "ArgToBePrintedToStdOut". 

Génère les résultats suivants qui excluent le stdout :

Python Script

These results are from external software.

The following arguments were passed to Python: ['ArgToBePrintedToStdOut']

Les commandes de session suivantes incluent le stdout :

PYSC "test.py" "ArgToBePrintedToStdOut"; SOUT.

Les commandes de session génèrent les résultats suivants :

Python Script

These results are from external software.

The following arguments were passed to Python: ['ArgToBePrintedToStdOut']

Python standard output

The following arguments were printed to Stdout: 'ArgToBePrintedToStdOut'

Les exécutables sont des fichiers texte qui contiennent des commandes de session Minitab. Vous pouvez inclure la commande PYSC qui lance Python dans un exécutable Minitab. Avec les fichiers exécutables, vous pouvez facilement exécuter des commandes sans les saisir à nouveau, et vous pouvez affecter l’exécutable à un bouton personnalisé dans Minitab. Pour plus d’informations sur les exécutables Minitab, accédez à Aide Minitab sur les macros. Pour lancer un exécutable, sélectionnez Fichier > Lancer un exécutable.

PYSC "test.py" "Arg1" "Arg2"

1. Sélectionnez Fichier > Lancer un exécutable.
2. Cliquez sur Sélectionner un fichier.
3. Sélectionnez PYEXEC.MTB.
4. Cliquez sur Ouvrir.

Le script affiche les valeurs des arguments dans Minitab, et l'exécutable génère les résultats suivants :

Python Script

These results are from external software.

The following arguments were passed to Python: ['Arg1', 'Arg2']

Si vous avez un fichier exécutable Minitab, vous pouvez créer un bouton ou un menu personnalisé qui lance l’exécutable. Pour plus d’informations générales sur la façon de personnaliser l’interface dans Minitab, accédez à Personnalisation des menus, des barres d’outils et des touches de raccourci.

En plus de personnaliser l’interface de Minitab, vous pouvez utiliser un langage compatible COM pour créer des boîtes de dialogue et des analyses personnalisées. Pour plus d’informations sur la façon de personnaliser Minitab avec la technique COM, accédez à Automatisation Minitab.