Octave avanzato A04 — Valori vuoti, null e dati mancanti

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

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.

Script Octave con tre contenitori vuoti e una chiamata di ispezione della matrice.
Script Octave con tre contenitori vuoti e una chiamata di ispezione della matrice.
% 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.

Output GX-TXT: classi dei contenitori vuoti e risultato dell’ispezione della matrice.
Output GX-TXT: classi dei contenitori vuoti e risultato dell’ispezione della matrice.

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

  1. Quale classe ha {}? E []?
  2. Perché l’argomento [] in linear_matrix/inspect è ammesso nell’esempio?
  3. È corretto dedurre da un risultato [] che una misura valga zero?

Soluzione ragionata

  1. cell e double rispettivamente.
  2. Perché il contratto dell’azione usata prevede un secondo operando vuoto quando non serve.
  3. No: bisogna distinguere rappresentazione, contratto e significato scientifico del dato.

Scarica gli script del Modulo 01 (ZIP)

#GX-TXT #Octave #Script Runner

Altre tappe del progetto

Lascia un commento

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