Octave avanzato A03 — Tipi e forma attraverso il Bridge
Corso avanzato di GNU Octave con GX-TXT · Modulo 01
Una matrice non è soltanto una sequenza di numeri: le sue dimensioni stabiliscono come associare valori, campioni e variabili. Vediamo come un’operazione pubblica di GX-TXT riceve dati strutturati da GNU Octave e restituisce il risultato.
Obiettivi e prerequisiti
Conosciamo già matrici, struct e cell array dal corso
base e i controlli sulle API dalle lezioni A01–A02. Ora distinguiamo
il contenitore degli argomenti di gxtxt_api_call, la
struttura che descrive un operando e la matrice contenuta nel risultato.
La prova usa GX-TXT dev112-P011-bis e GNU Octave 9.4.0.
Una matrice e uno scalare
Importa forma_bridge.m nell’Octave Script Workspace, registralo nella Session ed eseguilo dal Runner.
% Advanced Octave course A03: matrix shape across the public Bridge.
% SPDX-License-Identifier: GPL-3.0-or-later
gxtxt_api_require({'NUMERIC_API_v1@1'});
A = [1, 2; 3, 4];
a = struct('kind', 'matrix', 'value', A);
b = struct('kind', 'scalar', 'value', 2);
result = gxtxt_api_call('NUMERIC_API_v1', 'array_binary', ...
{'multiply', a, b});
fprintf('Input matrix: %d x %d\n', size(A,1), size(A,2));
fprintf('Result fields:\n');
disp(fieldnames(result));
disp(result);
La chiamata usa una cell array per gli argomenti
posizionali dell’operazione: il nome multiply e due
strutture. In questo esempio a dichiara un operando di tipo
matrice e b uno scalare. L’operazione espande lo scalare e
moltiplica ogni elemento. La struttura restituita contiene il campo
values.
Nel risultato osservato la matrice è [2, 4; 6, 8]: le
due righe e le due colonne mantengono la disposizione richiesta. Per
usarla successivamente puoi assegnare B = result.values e
verificare size(B) prima di associarla a etichette o
coordinate. Un esempio piccolo permette di controllare anche l’ordine
dei valori, non soltanto il numero complessivo.
Forma, tipo e significato
Per array_binary il contratto numerico distingue
espansione di uno scalare e operazioni tra due array non scalari: questi
ultimi devono avere forma compatibile secondo le regole dell’API. Non
assumere che un vettore riga e uno colonna rappresentino lo stesso
oggetto. Se la semantica richiede una colonna, usa una trasformazione
esplicita e verifica le dimensioni.
Il Bridge supporta anche celle e strutture annidate; il loro significato dipende dalla singola operazione. I numeri complessi possono richiedere un contratto specifico, per esempio componenti reali e immaginarie separate: non assumere che ogni operazione sugli array reali li accetti. Leggi sempre la documentazione del provider prima di costruire gli argomenti.
Infine, una dimensione corretta non dimostra che la prima riga rappresenti il campione giusto o che le unità siano coerenti: tali associazioni fanno parte del modello scientifico dello script.
Esercizio
- Cambia lo scalare in
3e prevedi la matrice prima di eseguire il programma. - Perché
result.valueseresultnon sono lo stesso tipo di oggetto? - Come controlleresti che due colonne da Dataset differenti si riferiscano agli stessi istanti?
Soluzione ragionata
[3, 6; 9, 12].- Il primo è il campo numerico contenuto nella struttura restituita; il secondo è l’intera struttura.
- Confrontando esplicitamente coordinate temporali, unità e lunghezze, senza dedurre l’allineamento dalla sola forma.
La prossima lezione distinguerà valori vuoti e informazioni mancanti.
Altre tappe del progetto
- Octave avanzato A01 — Contratti API e requisiti espliciti
- Octave avanzato A02 — Disponibilità dinamica e compatibilità
- Octave avanzato A04 — Valori vuoti, null e dati mancanti
- Octave avanzato A05 — Errori del Bridge e recupero controllato
- Octave avanzato A06 — Contesto, parametri e identità dello script