Octave avanzato A04 — Valori vuoti, null e dati mancanti
Corso avanzato di GNU Octave con GX-TXT · Modulo 01
Un contenitore vuoto, un valore nullo e una misura mancante possono esprimere concetti diversi. Con Octave e il Bridge è essenziale conoscere sia la rappresentazione nel linguaggio sia il significato attribuito da ciascuna API.
Obiettivi e prerequisiti
Dopo il corso base e la lezione A03 conosciamo matrici, celle e strutture. Ora confrontiamo tre contenitori e usiamo un argomento vuoto in una chiamata dove il contratto lo prevede. La prova usa GX-TXT dev112-P011-bis e GNU Octave 9.4.0.
Tre forme diverse
Importa valori_vuoti.m, registralo nella Session e avvialo con il Runner.
% Advanced Octave course A04: empty values and API-specific conventions.
% SPDX-License-Identifier: GPL-3.0-or-later
gxtxt_api_require({'NUMERIC_API_v1@1:math.numeric+complex_linear_algebra'});
empty_array = [];
empty_cell = {};
empty_struct = struct();
fprintf('Empty numeric array: class=%s, numel=%d\n', class(empty_array), numel(empty_array));
fprintf('Empty cell: class=%s, numel=%d\n', class(empty_cell), numel(empty_cell));
fprintf('Empty struct: class=%s, fields=%d\n', class(empty_struct), numel(fieldnames(empty_struct)));
A = struct('real', [2, 0; 0, 4], 'imaginary', zeros(2));
result = gxtxt_api_call('NUMERIC_API_v1', 'linear_matrix', {'inspect', A, []});
fprintf('Inspect matrix: rows=%d, cols=%d, rank=%d\n', result.rows, result.cols, result.rank);
[] crea un array numerico vuoto, {} una
cell array vuota e struct() una struttura senza campi. I
tre oggetti non hanno la stessa classe: il fatto che siano vuoti non li
rende sostituibili nelle richieste delle API.
L’output mostra rispettivamente le classi double,
cell e struct; l’ispezione restituisce due
righe, due colonne e rango due. Per l’azione inspect di
linear_matrix, il contratto consente di passare
[] come secondo operando non utilizzato. Questo è un uso
documentato per quella chiamata, non una regola universale per tutti i
parametri opzionali.
Quando arriva null
La documentazione del Bridge specifica che un valore
null esplicito ricevuto dal trasporto viene proiettato in
Octave come []. Poiché Octave non possiede in questo caso
uno scalare JSON null distinto, la proiezione può perdere l’informazione
che permetterebbe di distinguerlo da un array numerico vuoto. Se un’API
fornisce un result_json autorevole per questo scopo,
consultalo secondo il suo contratto. Inviare [] ordinario
dal client rappresenta invece un array numerico vuoto: non costruisce
automaticamente un valore null.
Nessuna di queste forme, da sola, dice che una misura sia mancante o pari a zero. Per dati sperimentali usa lo schema e le convenzioni di validità dichiarati dal Dataset o dall’operazione; non sostituire i dati assenti con zero senza una scelta scientifica esplicita.
Esercizio
- Quale classe ha
{}? E[]? - Perché l’argomento
[]inlinear_matrix/inspectè ammesso nell’esempio? - È corretto dedurre da un risultato
[]che una misura valga zero?
Soluzione ragionata
celledoublerispettivamente.- Perché il contratto dell’azione usata prevede un secondo operando vuoto quando non serve.
- No: bisogna distinguere rappresentazione, contratto e significato scientifico del dato.
Altre tappe del progetto
- Octave avanzato A01 — Contratti API e requisiti espliciti
- Octave avanzato A02 — Disponibilità dinamica e compatibilità
- Octave avanzato A03 — Tipi e forma attraverso il Bridge
- Octave avanzato A05 — Errori del Bridge e recupero controllato
- Octave avanzato A06 — Contesto, parametri e identità dello script