Execute scripts Python com o Minitab Statistical Software

Conheça as diferentes maneiras que você pode usar para executar o Python no Minitab.

Neste tópico

Execute scripts Python no painel Linha de comando
Execute scripts Python de um arquivo exec do Minitab
Execute scripts Python pela interface do Minitab
Interrompa o comando PYSC

Você pode executar scripts Python pelo Minitab de três maneiras:

Execute o comando PYSC no painel Linha de comando.
Execute um exec do Minitab que inclua o comando PYSC.
Personalize a interface do Minitab para executar um exec do Minitab que inclua o comando PYSC.

O comando PYSC amplia a funcionalidade do Minitab com o Python, mas não torna o Minitab um ambiente Python interativo. Dessa maneira, use o Minitab apenas com scripts Python que sejam concluídos sem interação. Por exemplo, a função input(), que aceita a entrada por teclado enquanto um script é executado, não funciona em Minitab. A interatividade no Python assumo muitas outras formas, como plot.show() e keyboard.read_key().

Para obter mais informações sobre o módulo Python do Minitab, incluindo exemplos de código Python, acesse Python Referências de API.

Todos os arquivos mencionados neste guia estão disponíveis neste arquivo .ZIP : python_guide_files.zip.

Observação

Instale e execute o Python antes de tentar integrar o Python ao Minitab Statistical Software. Para obter assistência na instalação do Python, consulte o departamento de suporte técnico da sua organização. O suporte técnico Minitab não pode auxiliar na instalação do Python.

Execute scripts Python no painel Linha de comando

Você pode executar o comando PYSC no painel Linha de comando. Para obter informações gerais sobre o painel Linha de comando, vá para o painel Linha de Comando/Histórico. Para obter informações gerais sobre o uso de comandos de sessão, vá para a ajuda do Comando Session.

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

Executa o script Python especificado por você.

A extensão de arquivo padrão para scripts Python é .PY. Se a extensão do arquivo for .PY, não é preciso digitar a extensão do arquivo.

O argumento opcional Args permite que você passe argumentos para o script Python por meio do sys.argv[1:]. Args pode ser quaisquer valores de texto separados por um espaço. Coloque os argumentos entre aspas. O valor padrão é None, o que significa que o script não recebe nenhum argumento.

Em geral, usa-se argumentos para transportar os dados do Minitab para o Python.. Você pode inserir argumentos de várias maneiras. Por exemplo, você pode usar argumentos que são identificadores para colunas, matrizes ou constantes:

Comando Session do Minitab Valor em Python Uso

Comando Session do Minitab	Valor em Python	Uso
`PYSC "test.py" "C1"`	`"C1"`	Use a seguinte função para recuperar a coluna: `mtbpy.mtb_instance().get_column(sys.argv[1:][0])`
`PYSC "test.py" "M1"`	`"M1"`	Use a seguinte função para recuperar a matriz: `mtbpy.mtb_instance().get_matrix(sys.argv[1:][0])`
`PYSC "test.py" "K1"`	`"K1"`	Use a seguinte função para recuperar a constante: `mtbpy.mtb_instance().get_constant(sys.argv[1:][0])`

PYSC "test.py" "C1"

"C1"

Use a seguinte função para recuperar a coluna:

mtbpy.mtb_instance().get_column(sys.argv[1:][0])

PYSC "test.py" "M1"

"M1"

Use a seguinte função para recuperar a matriz:

mtbpy.mtb_instance().get_matrix(sys.argv[1:][0])

PYSC "test.py" "K1"

"K1"

Use a seguinte função para recuperar a constante:

mtbpy.mtb_instance().get_constant(sys.argv[1:][0])

Também é possível usar argumentos que são os nomes de colunas, matrizes ou constantes no Minitab:

Comando Session do Minitab Valor em Python Uso

Comando Session do Minitab	Valor em Python	Uso
`PYSC "test.py" "My Column"`	`"My Column"`	Use a seguinte função para recuperar a coluna: `mtbpy.mtb_instance().get_column(sys.argv[1:][0])`
`PYSC "test.py" "My Matrix"`	`"My Matrix"`	Use a seguinte função para recuperar a matriz: `mtbpy.mtb_instance().get_matrix(sys.argv[1:][0])`
`PYSC "test.py" "My Constant"`	`"My Constant"`	Use a seguinte função para recuperar a constante: `mtbpy.mtb_instance().get_constant(sys.argv[1:][0])`

PYSC "test.py" "My Column"

"My Column"

Use a seguinte função para recuperar a coluna:

mtbpy.mtb_instance().get_column(sys.argv[1:][0])

PYSC "test.py" "My Matrix"

"My Matrix"

Use a seguinte função para recuperar a matriz:

mtbpy.mtb_instance().get_matrix(sys.argv[1:][0])

PYSC "test.py" "My Constant"

"My Constant"

Use a seguinte função para recuperar a constante:

mtbpy.mtb_instance().get_constant(sys.argv[1:][0])

Também é possível especificar argumentos para passar texto para usar em seu código Python. Você pode transferir texto diretamente ou em uma constante.

Comando Session do Minitab	Valor em Python	Uso
`PYSC "test.py" "Text not Stored"`	`"Text not Stored"`	Este caso transferiu um valor que não pode ser usado com um comando '`get`’ do mtbpy. No entanto, Args não se limitam apenas a transferir colunas, matrizes e constantes.
`LET K1 = "Text in Constant" PYSC "test.py" K1`	`"Text in Constant"`	Este caso destaca que, embora o PYSC não aceite argumentos que não sejam valores de texto, você pode passar uma constante para o PYSC, desde que tal constante seja definida como um valor de texto.

Quando você passa mais de um argumento, pode acessar os argumentos na ordem da lista de argumentos:

Comando Session do Minitab Valor em Python Uso

Comando Session do Minitab	Valor em Python	Uso
`PYSC "test.py" "C1" "C2" "M1" "K3" "10"`	`"C1" "C2" "M1" "K3" "10"`	Este caso é um exemplo de como passar vários Args, em que você os acessa usando as seguintes funções em 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])`

PYSC "test.py" "C1" "C2" "M1" "K3" "10"

"C1" "C2" "M1" "K3" "10"

Este caso é um exemplo de como passar vários Args, em que você os acessa usando as seguintes funções em 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])

Use o arquivo a seguir para ver a saída do texto de exemplo para os seguintes subcomandos. Certifique-se de que o arquivo test.py está na pasta do Minitab para scripts Python.

Arquivo	Descrição
test.py	Utilizamos um script Python de exemplo em todo este guia. Quando você passa argumentos para o script, os resultados incluem uma lista dos valores dos argumentos. Quando você executa o script com o argumento "ArgToBePrintedToStdErr", o script grava o nome do argumento no arquivo stderr. Quando você executa o script com o argumento "ArgToBePrintedToStdOut", o script grava o nome do argumento no arquivo stdout. Use os subcomandos a seguir para controlar se o conteúdo desses arquivos aparece no painel de saída do Minitab.

Arquivo

Descrição

test.py

Utilizamos um script Python de exemplo em todo este guia. Quando você passa argumentos para o script, os resultados incluem uma lista dos valores dos argumentos. Quando você executa o script com o argumento "ArgToBePrintedToStdErr", o script grava o nome do argumento no arquivo stderr. Quando você executa o script com o argumento "ArgToBePrintedToStdOut", o script grava o nome do argumento no arquivo stdout. Use os subcomandos a seguir para controlar se o conteúdo desses arquivos aparece no painel de saída do Minitab.

NOSERR

Especifica que o texto da saída do console de erro padrão (stderr) no painel Saída em Minitab não será exibido. A saída do console stderr é onde é possível ver as mensagens de erro do Python quando você executa seu código em um ambiente de desenvolvimento integrado com o Python, embora seja possível usar o Python para colocar outros resultados no arquivo stderr. Por exemplo, por padrão:

PYSC "test.py" "ArgToBePrintedToStdErr".

Produz os seguintes resultados que incluem a saída do 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'

Os comandos de sessão a seguir excluem a saída do console stderr:

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

Os comandos de sessão produzem os seguintes resultados:

Python Script

These results are from external software.

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

SOUT

Especifica que o texto da saída do console padrão (stdout) no painel Saída do Minitab será exibido. O stdout é onde você vê os resultados de comandos como print() em um ambiente de desenvolvimento integrado com o Python. Por exemplo, por padrão:

PYSC "test.py" "ArgToBePrintedToStdOut".

Produz os seguintes resultados que excluem o stdout:

Python Script

These results are from external software.

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

Os seguintes comandos de sessão incluem o stdout:

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

Os comandos de sessão produzem os seguintes resultados:

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'

Execute scripts Python de um arquivo exec do Minitab

Use o seguinte arquivo para executar as etapas nesta seção:

Arquivo	Descrição
test.py	Utilizamos um script Python de exemplo em todo este guia. Quando você passa argumentos para o script, os resultados incluem uma lista dos valores dos argumentos.
PYEXEC.MTB	Um arquivo exec de exemplo do Minitab que inclui os comandos de sessão para executar o script test.py com dois argumentos.

Execs são arquivos de texto que contêm comandos de sessão do Minitab. Você pode incluir o comando PYSC que executa o Python em um exec do Minitab. Com arquivos exec, você pode executar facilmente comandos sem redigitá-los, e pode atribuir o exec a um botão personalizado no Minitab. Para obter mais informações sobre os execs do Minitab, acesse a Ajuda de Macros do Minitab. Para executar um exec, escolha Arquivo > Executar uma exec.

Suponha que você criou o exec PYEXEC.MTB. O arquivo exec contém o seguinte comando do Minitab:

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

Para executar o script Python com o exec, use os passos a seguir:

Escolha Arquivo > Executar uma exec.
Clique em Selecionar Arquivo.
Selecione PYEXEC.MTB.
Clique em Abrir.

O script exibe os valores dos argumentos no Minitab, e o exec produz os seguintes resultados:

Python Script

These results are from external software.

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

Execute scripts Python pela interface do Minitab

Se você tem um arquivo exec do Minitab, pode criar um botão ou menu personalizado para executar o exec. Para obter informações gerais sobre como personalizar a interface no Minitab, acesse Menus personalizados, barras de ferramentas e teclas de atalho.

Você pode usar as seguintes etapas para criar um botão personalizado que execute um exec:

Escolha Visualizar > Personalizar.
Clique na guia Ferramentas.
Na guia Ferramentas, clique no botão Novo (Inserir).
Digite um nome para o comando e pressione a tecla Enter.
Clique no botão Abrir.
Na lista de suspensa do tipo arquivo, selecione Todos os arquivos (*.*).
Navegue e selecione um arquivo exec.
Clique em Abrir.
Escolha Visualizar > Personalizar novamente.
Na guia Comandos, em Categorias, selecione Ferramentas.
Enquanto a caixa de diálogo Personalizar estiver aberta, arraste o novo comando para o lugar em que deseja que ele apareça no menu do Minitab ou na barra de ferramentas.
Clique em Fechar.

Além de personalizar a interface do Minitab, você pode usar uma linguagem compatível com COM para criar caixas de diálogo e análises personalizadas. Para obter informações sobre como personalizar o Minitab por meio do COM, acesse a Automatização no Minitab.

Interrompa o comando PYSC

Você pode interromper um script Python e manter o Minitab aberto, o que impede a perda de edições feitas em seu projeto Minitab desde a última que foi salvo. O método para interromper um script Python depende de seu sistema operacional.

Microsoft® Windows: Pressione Ctrl + Alt + Delete para abrir o Gerenciador de Tarefas do Windows. Depois disso, encerre o processo do Python.
macOS: Pressione Command + Option + Esc para abrir a janela Force Quit. Depois disso, encerre o aplicativo do Python.