Ritrova un output, il suo originale e le sue impostazioni senza esitare.

Scegli una struttura che saprai spiegare

Crea una cartella con il nome del progetto, poi qualche posizione dai ruoli chiari. Il nome di una persona o la data di oggi non bastano sempre a capire il contenuto sei settimane dopo. Una nota collocata nella radice deve spiegare dove sono gli input, i test in corso e la consegna scelta.

L'Università di Cambridge raccomanda di concordare presto una classificazione e regole di denominazione coerenti. Il modello qui sotto è una proposta BriefGPU per una piccola sessione. Adattalo se il tuo software impone già una struttura di progetto; non spostare le sue risorse collegate senza verificare che il progetto le ritrovi.

Mantieni riconoscibile l'input ricevuto

Prima della prima elaborazione, stabilisci l'elenco delle sorgenti con il loro nome originale e la loro posizione. Conserva una versione intatta di questi input, come raccomanda Cornell per i dati grezzi. Il semplice nome «originaux» non protegge il contenuto: indica al software una cartella di output diversa e controlla il suo comportamento su un file di prova.

Se devi convertire o ritagliare un input prima del calcolo, tratta questa preparazione come una fase identificata. Mantieni il collegamento con la sorgente ricevuta. Potrai allora distinguere un difetto già presente, un problema di preparazione e un effetto dell'elaborazione GPU.

Quando una nuova sorgente sostituisce la vecchia, annota la versione e gli output da rivedere. Non sovrascrivere silenziosamente un file usato da un test che vuoi capire. La regola è conservare la provenienza utile, non mantenere indefinitamente tutte le copie di lavoro.

Assegna un identificatore stabile a ogni unità di lavoro

Un identificatore breve come image-001 serve a seguire lo stesso input attraverso più test. Il suo ruolo non cambia quando un output viene accettato. Mantieni lo stato di validazione nell'inventario invece di rinominare continuamente i file in base a «buono», «cattivo» o «quasi-finale».

Per cento input, i numeri da 001 a 100 danno un riferimento regolare. Aggiungi un riferimento di business quando è necessario per la consegna. Non presumere che due file chiamati photo.png, ricevuti in due sottocartelle diverse, rappresentino la stessa cosa. Il percorso completo dell'input deve restare associato all'identificatore.

Scegli nomi compatibili con gli strumenti di destinazione. Windows riserva in particolare i caratteri due punti, punto interrogativo e asterisco; le sue regole ordinarie non permettono neppure di distinguere con certezza due nomi solo dalla maiuscola. Un nome come image-007_essai-02.png evita queste ambiguità. Verifica i vincoli propri dei tuoi altri strumenti invece di promettere una compatibilità universale.

Esempio: due test, un'unica collezione di sorgenti

Supponiamo che siano state ricevute otto immagini in due cartelle. L'inventario assegna image-001 a image-008 e conserva i loro percorsi originali. La prima passata usa le impostazioni prova-01; tutti i suoi output vanno nella cartella corrispondente. Un difetto su image-003 e image-006 porta a una seconda prova limitata a questi due input.

I sei risultati soddisfacenti della prima prova non vengono ricalcolati per rendere la cartella più uniforme. L'inventario indica quale output è stato scelto per ogni input. La consegna v01 contiene otto file con i nomi attesi, anche se la loro provenienza si distribuisce tra due prove. Questo esempio descrive un'organizzazione, senza dare per scontato che le impostazioni migliorino necessariamente i risultati.

Conserva le impostazioni al momento della prova

Un file chiamato prova-02.txt può essere una semplice nota se il software non sa esportare i suoi parametri. Annota la versione dello strumento, l'eventuale modello, gli input coinvolti e i valori che hai scelto. Aggiungi il motivo del cambiamento rispetto alla prova precedente. Uno screenshot può completare la nota quando i parametri sono visibili solo in una finestra.

Evita un'unica nota «impostazioni attuali» sostituita dopo ogni passata. Spiegherebbe l'ultimo tentativo, ma non più gli output precedenti. Se più prove usano gli stessi parametri, fai riferimento alla stessa configurazione identificata invece di ricopiarla inutilmente.

La versione del software e i parametri facilitano la spiegazione di un risultato; non garantiscono da soli una riproduzione identica. Alcune applicazioni richiedono altre informazioni o risorse. Segui la loro documentazione per un'esigenza di ripresa precisa, soprattutto quando si tratta di uno stato di addestramento.

Tieni un registro che spieghi le decisioni

Il registro completa l'inventario. Questo risponde a «a che punto è questo input?»; il registro risponde a «perché abbiamo cambiato?». Bastano poche righe datate: prova coinvolta, osservazione, decisione e prossima verifica. Evita di ricopiare ogni messaggio del software se nessuno potrà servirsene.

Per l'esempio, una riga utile sarebbe: «prova-01: contorni incompleti su image-003 e image-006; rifare questi due input con l'impostazione B; conservare gli altri output in attesa di validazione finale.» Dopo la revisione, aggiungi la decisione effettiva. Non riscrivere l'osservazione iniziale come se il difetto non fosse mai esistito.

Rileggi i registri tecnici prima di trasmetterli: possono contenere percorsi privati o mezzi di accesso. Tieni i segreti separati dalla cartella documentale. La nota destinata a un collega deve spiegare il lavoro con le informazioni di cui ha bisogno.

Distingui classificazione, consegna e backup

La cartella di lavoro conserva le prove utili al tuo ragionamento. La cartella di consegna raccoglie ciò che il destinatario deve ricevere. Il backup conserva gli elementi necessari su un'altra destinazione, con un controllo della copia. Tre cartelle affiancate sullo stesso spazio non svolgono da sole queste tre funzioni.

Non ricopiare tutte le fonti in ogni cartella di prova. Collega gli output agli input tramite l'inventario. Per la consegna, una copia selezionata può essere utile per fornire un insieme autonomo; annota allora la sua provenienza e la sua versione. Per il backup, segui la guida dedicata, che dettaglia l'inventario e la verifica dopo il trasferimento.

Prima di ripulire le varianti scartate, verifica quelle che restano necessarie per spiegare una decisione o rifare il lavoro. Questa organizzazione non impone alcuna durata di conservazione. Permette di decidere cosa merita di essere tenuto, e poi di ritrovare la copia che fa riferimento.

Fai un controllo a partire da un output scelto a caso

Scegli un file di consegna senza aprire prima il tuo software. A partire dal suo nome e dall'inventario, ritrova il suo input, la prova che l'ha prodotto, le sue impostazioni e la decisione di accettazione. Ripeti con un output che ha richiesto un rifacimento. Se il percorso dipende dalla tua memoria, manca un collegamento nel monitoraggio.

Controlla poi le quantità: numero di input previsti, risultati conservati, elementi bloccati e varianti escluse. Una cartella ben ordinata può comunque essere incompleta. Questo piccolo controllo è concluso quando gli scostamenti hanno un motivo e qualcun altro può capire quali file usare.