Avanzamento, cancellazione e limiti dei Job

di Giux GX-TXT, python-it, scripts-it 3 min di lettura

Corso Python scientifico in GX-TXT · Modulo 7 · Lezione 41

Un’operazione lunga dovrebbe comunicare ciò che sta facendo senza bloccare inutilmente l’interfaccia. In questa lezione elaboriamo una piccola serie sintetica in blocchi e pubblichiamo eventi di avanzamento proporzionati al lavoro effettivo.

Obiettivi

  • Rappresentare avanzamento determinato con lavoro svolto e totale.
  • Distinguere avvio, lavoro, completamento ed errore.
  • Consultare la politica delle risorse parallele.
  • Capire che richiesta di cancellazione e cancellazione conclusa sono eventi distinti.

Esegui lo script

Nella Sessione corso_python, importa avanzamento.py, salvalo e avvialo con Run → Open Script Runner → Run Job.

Script di avanzamento nell'editor GX-TXT.
Script di avanzamento nell'editor GX-TXT.
import numpy as np
from gxtxt import gxtxt_api_call, gxtxt_api_require

for api in ("PROGRESS_API_v1@1", "CANONICAL_DATASET_API_v2@2", "PARALLEL_EXECUTION_API_v1@1"):
    gxtxt_api_require(api)
progress = "PROGRESS_API_v1"
def segnala(stato, corrente, totale):
    evento = {"state": stato, "mode": "determinate", "stage": "lettura", "message": "Lettura dati sintetici", "current": corrente, "total": totale}
    return gxtxt_api_call(progress, "publish", [evento])
segnala("start", 0, 4)
somma = 0.0
try:
    for inizio in (0, 2):
        blocco = gxtxt_api_call("CANONICAL_DATASET_API_v2", "read_range", ["corso_python_serie_sintetica", ["segnale"], inizio, 2])
        somma += float(np.sum(blocco["segnale"]["values"]))
        segnala("running", inizio + 2, 4)
    segnala("completed", 4, 4)
except Exception:
    segnala("failed", 0, 4)
    raise
print("Campioni elaborati:", 4)
print("Media sintetica (mV):", somma / 4)
print("Risorse disponibili:", gxtxt_api_call("PARALLEL_EXECUTION_API_v1", "resources", []))

La funzione segnala costruisce un evento con stato, fase, messaggio, quantità corrente e totale. Leggiamo realmente due blocchi di due righe: dopo ciascuna lettura comunichiamo il numero effettivo di campioni elaborati. completed viene inviato solo dopo il lavoro; in caso di eccezione inviamo failed e rilanciamo l’errore. Non introduciamo pause artificiali: su quattro righe l’avanzamento può essere troppo rapido per essere osservato in tempo reale.

Output del Job: quattro campioni e media sintetica di 1,4 mV.
Output del Job: quattro campioni e media sintetica di 1,4 mV.

Il risultato è la media dei quattro valori sintetici. La risposta di resources descrive la politica disponibile nell’ambiente dell’esecuzione: nell’immagine il limite riportato è un worker. È un’informazione sul contesto, non una richiesta di avviare processi paralleli.

Stati e cancellazione

Un progresso determinato è appropriato quando current e total rappresentano lavoro misurabile. Se il totale non è noto, un indicatore indeterminato è più onesto di una percentuale inventata. Aver raggiunto il totale e aver concluso con successo sono concetti distinti: un’ultima fase può ancora fallire.

Nel gestore dei Job, la richiesta di cancellazione non equivale immediatamente alla conferma che il processo e le sue risorse siano stati chiusi. Controlla lo stato finale del Job e usa le funzioni di cancellazione disponibili per l’operazione concreta. Questo esempio breve è stato portato a termine; non mostra una cancellazione riuscita. Per lavori con risorse gestite, prevedi sempre la pulizia appropriata anche in caso di errore.

Esercizio

  1. Quali valori di current vengono comunicati durante la lettura?
  2. Perché non inseriamo una pausa tra i due blocchi?
  3. Un Job arrivato a quattro campioni su quattro ha necessariamente completato ogni fase?

Soluzione ragionata

  1. Dopo l’avvio a 0, il lavoro comunica 2 e 4 campioni elaborati.
  2. Una pausa non rappresenterebbe lavoro reale; l’esempio non deve rallentare solo per rendere visibile la barra.
  3. No. La chiusura riuscita è uno stato separato e può dipendere da altre operazioni.

Nella prossima lezione confronteremo risultati ripetuti e salvataggio.

Scarica gli script del Modulo 07 (ZIP)

#GX-TXT #Python #Riproducibilità

Altre tappe del progetto

Lascia un commento

Il tuo indirizzo email non sarà pubblicato. I campi obbligatori sono contrassegnati *