Octave avanzato A03 — Tipi e forma attraverso il Bridge

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

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.

Script Octave che passa una matrice e uno scalare all’API numerica.
Script Octave che passa una matrice e uno scalare all’API numerica.
% 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.

Risultato reale dell’operazione: matrice di ingresso 2 per 2 e valori moltiplicati per due.
Risultato reale dell’operazione: matrice di ingresso 2 per 2 e valori moltiplicati per due.

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

  1. Cambia lo scalare in 3 e prevedi la matrice prima di eseguire il programma.
  2. Perché result.values e result non sono lo stesso tipo di oggetto?
  3. Come controlleresti che due colonne da Dataset differenti si riferiscano agli stessi istanti?

Soluzione ragionata

  1. [3, 6; 9, 12].
  2. Il primo è il campo numerico contenuto nella struttura restituita; il secondo è l’intera struttura.
  3. Confrontando esplicitamente coordinate temporali, unità e lunghezze, senza dedurre l’allineamento dalla sola forma.

La prossima lezione distinguerà valori vuoti e informazioni mancanti.

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 *