O contexto de script

O módulo modeler.script fornece o contexto no qual um script é executado. O módulo é importado automaticamente em um script SPSS® Modeler no tempo de execução. O módulo define quatro funções que fornecem a um script acesso ao seu ambiente de execução:

A função session() retorna a sessão do script. A sessão define informações como o locale e o backend SPSS Modeler backend (seja um processo local ou um nettrabalhado SPSS Modeler Server) que está sendo usado para executar quaisquer fluxos.
A função stream() pode ser usada com scripts de fluxo e SuperNode. Essa função retorna o fluxo que possui o script de fluxo ou o script SuperNode que está sendo executado.
A função diagram() pode ser usada com scripts SuperNode. Essa função retorna o diagrama dentro do site SuperNode. Para outros tipos de script, essa função retorna o mesmo que a função stream() .
A função supernode() pode ser usada com scripts SuperNode. Essa função retorna o endereço SuperNode que possui o script que está sendo executado.

As quatro funções e suas saídas estão resumidas na tabela a seguir.

Tabela 1. Resumo de funções `modeler.script`
Tipo de script	`session()`	`stream()`	`diagram()`	`supernode()`
Independente	Retorna uma sessão	Retorna o fluxo gerenciado atual no momento em que o script foi chamado (por exemplo, o fluxo passado por meio da opção `-stream` do modo em lote) ou `None`.	O mesmo que para `stream()`	Não aplicável
Fluxo	Retorna uma sessão	Retorna um fluxo	O mesmo que para `stream()`	Não aplicável
SuperNode	Retorna uma sessão	Retorna um fluxo	Retorna um fluxo SuperNode	Retorna um SuperNode

O módulo modeler.script também define uma maneira de encerrar o script com um código de saída. A função exit(exit-code) interrompe a execução do script e retorna o código de saída inteiro fornecido.

Um dos métodos definidos para um fluxo é runAll(List). Esse método executa todos os nós executáveis. Todos os modelos ou saídas gerados pela execução dos nós são adicionados à lista fornecida.

É comum que uma execução de fluxo gere resultados, como modelos, gráficos e outros resultados. Para capturar essa saída, um script pode fornecer uma variável que é inicializada em uma lista. Por exemplo:

stream = modeler.script.stream()
results = []
stream.runAll(results)

Quando a execução estiver concluída, todos os objetos gerados pela execução poderão ser acessados na lista results .