Contenuto principale

Simulation Data Inspector

R2026b

Esaminare e confrontare i dati e i risultati della simulazione per validare e iterare i progetti dei modelli

Descrizione

Simulation Data Inspector visualizza e confronta diversi tipi di dati.

Utilizzando Simulation Data Inspector, è possibile esaminare e confrontare i dati delle serie temporali in diverse fasi del workflow. È inoltre possibile utilizzare le schede (da R2026b) per organizzare diverse visualizzazioni e layout. Questo esempio di workflow mostra come Simulation Data Inspector supporti tutte le fasi del ciclo di progettazione:

  1. View Simulation Data in Simulation Data Inspector o Import Data from Workspace or File into Simulation Data Inspector

    Eseguire una simulazione in un modello configurato per registrare i dati in Simulation Data Inspector o importare i dati dal workspace o da un file. È possibile utilizzare più schede per visualizzare e verificare i dati di input del modello o esaminare i dati di simulazione registrati mentre si modifica il diagramma del modello, i valori dei parametri o la configurazione del modello in modo iterativo. Per ulteriori informazioni sulla registrazione dei dati di simulazione, vedere Save Simulation Data.

  2. Inspect Simulation Data

    Utilizzare più schede per organizzare diverse visualizzazioni dei dati di simulazione. In ogni scheda, tracciare i segnali su più grafici secondari, ingrandire e ridurre gli assi del grafico specificati e utilizzare i cursori dei dati per comprendere e valutare i dati. È possibile scegliere tra diverse visualizzazioni, come tempo, array, mappa, sparkline e grafici XY. Per ulteriori informazioni su come presentare i dati in modo efficace, vedere Create Plots Using Simulation Data Inspector.

  3. Compare Simulation Data

    Confrontare singoli segnali o esecuzioni di simulazione e analizzare i risultati del confronto con tolleranze relative, assolute e temporali. Gli strumenti di confronto di Simulation Data Inspector supportano la progettazione iterativa e consentono di evidenziare i segnali che non soddisfano i requisiti di tolleranza. Per ulteriori informazioni sulla procedura di confronto, vedere How the Simulation Data Inspector Compares Data.

  4. Save and Share Simulation Data Inspector Data and Views

    Condividere i risultati con altre persone salvando i dati e le visualizzazioni di Simulation Data Inspector.

È possibile utilizzare Simulation Data Inspector anche dalla riga di comando. Per ulteriori informazioni, vedere Inspect Data Programmatically e Compare Data Programmatically.

The Inspect pane of the Simulation Data Inspector shows three subplots on a tab. The subplots show time plots of data gathered from three runs of the model sldemo_autotrans. The first subplot shows the EngineRPM signals from all three runs. The second subplot shows the ShiftLogic signals from all three runs. The third subplot shows the VehicleSpeed signal from all three runs.

Apri Simulation Data Inspector

  • Barra degli strumenti di Simulink®: Nella scheda Simulation, alla voce Review Results, fare clic su Data Inspector.

  • Da un modello: fare clic sul badge dello streaming su un segnale per aprire Simulation Data Inspector e tracciare il segnale.

  • Prompt dei comandi di MATLAB®:

Esempi

espandi tutto

Creare un'esecuzione, aggiungere i dati e visualizzarli nella scheda attiva di Simulation Data Inspector.

Creazione dei dati per l'esecuzione

Creare due oggetti timeseries per contenere i dati di un segnale sinusoidale e di un segnale cosinusoidale. Assegnare un nome descrittivo a ciascun oggetto timeseries.

time = linspace(0,20,101);

sine_vals = sin(2*pi/5*time);
sine_ts = timeseries(sine_vals,time);
sine_ts.Name = "Sine, T=5";

cos_vals = cos(2*pi/8*time);
cos_ts = timeseries(cos_vals,time);
cos_ts.Name = "Cosine, T=8";

Creazione di esecuzioni e aggiunta di dati

Per aprire Simulation Data Inspector, utilizzare Simulink.sdi.view.

Simulink.sdi.view

Per importare i dati dal workspace in Simulation Data Inspector, creare un oggetto Simulink.sdi.Run utilizzando Simulink.sdi.Run.create. Aggiungere le informazioni relative ai metadati utilizzando le proprietà Name e Description dell'oggetto Run.

sinusoidsRun = Simulink.sdi.Run.create;
sinusoidsRun.Name = "Sinusoids";
sinusoidsRun.Description = "Sine and cosine signals with different frequencies";

Aggiungere i dati creati nel workspace all'esecuzione vuota.

add(sinusoidsRun,"vars",sine_ts,cos_ts);
 0.091530s wall, 0.156250s user + 0.031250s system = 0.187500s CPU (204.9%)

Plottaggio dei dati in Simulation Data Inspector

Per accedere all'oggetto Simulink.sdi.Signal corrispondente a ciascun segnale, utilizzare getSignalByIndex. È possibile utilizzare le proprietà dell'oggetto Simulink.sdi.Signal per specificare lo stile e il colore della linea del segnale e tracciare il segnale in Simulation Data Inspector. Ad esempio, specificare le proprietà LineColor e LineDashed per ciascun segnale.

sine_sig = getSignalByIndex(sinusoidsRun,1);
sine_sig.LineColor = [0 0 1];
sine_sig.LineDashed = "-.";

cos_sig = sinusoidsRun.getSignalByIndex(2);
cos_sig.LineColor = [1 0 0];
cos_sig.LineDashed = "--";

Per configurare un layout di un grafico secondario di 2x1 nella scheda attiva dell'area di plottaggio di Simulation Data Inspector, utilizzare Simulink.sdi.setSubPlotLayout. Per tracciare il segnale sinusoidale nel grafico secondario superiore e il segnale cosinusoidale su quello inferiore, utilizzare plotOnSubPlot.

Simulink.sdi.setSubPlotLayout(2,1);

plotOnSubPlot(sine_sig,1,1,true);
plotOnSubPlot(cos_sig,2,1,true);

A 2-by-1 subplot layout for Tab1 in the Simulation Data Inspector. The sine signal is plotted in the upper subplot and the cosine signal is plotted in the lower subplot.

Esame dei dati utilizzando i cursori

Per accedere al valore di un segnale in un momento specifico, è possibile aggiungere un cursore al grafico. Ad esempio, il segnale Sine sembra avere un massimo locale a circa 6 secondi. Aggiungere un cursore al grafico e osservare il valore del segnale a 6 secondi.

Simulink.sdi.setNumCursors(1)
Simulink.sdi.setCursorPositions("left",6)

The Simulation Data Inspector with a cursor positioned at 6 seconds in Tab1. The cursor is applied to both subplots.

Aggiungere due cursori per misurare la differenza temporale tra due punti o per estrarre le statistiche descrittive relative all'intervallo definito.

Simulink.sdi.setNumCursors(2)
Simulink.sdi.setCursorPositions("left",5,"right",7)

The Simulation Data Inspector with two cursors positioned at 5 seconds and 7 seconds in Tab1.

Determinare il valore massimo locale del campione nel segnale Sine tra i cursori utilizzando la funzione max.

[t1,t2] = Simulink.sdi.getCursorPositions;
localMax = max(sine_sig,t1,t2)
localMax = 
0.9980

Chiusura di Simulation Data Inspector e salvataggio dei dati

Una volta terminato di esaminare i dati del segnale tracciato, è possibile chiudere Simulation Data Inspector e salvare la sessione in un file MLDATX.

Simulink.sdi.close("sinusoids.mldatx")

È possibile utilizzare l'interfaccia programmatica di Simulation Data Inspector per modificare un parametro per lo stesso segnale in più esecuzioni. Questo esempio aggiunge una tolleranza assoluta di 0.1 a un segnale in tutte e quattro le esecuzioni dei dati.

Per prima cosa, cancellare il workspace e caricare la sessione di Simulation Data Inspector con i dati. La sessione include i dati registrati di quattro simulazioni di un modello di Simulink® di controller longitudinale per un aeromobile.

Simulink.sdi.clear
Simulink.sdi.load('AircraftExample.mldatx');

Utilizzare la funzione Simulink.sdi.getRunCount per ottenere il numero di esecuzioni in Simulation Data Inspector. È possibile utilizzare questo numero come indice per un for loop che opera su ciascuna esecuzione.

count = Simulink.sdi.getRunCount;

Quindi, utilizzare un for loop per assegnare la tolleranza assoluta di 0.1 al primo segnale di ciascuna esecuzione.

for a = 1:count
    runID = Simulink.sdi.getRunIDByIndex(a);
    aircraftRun = Simulink.sdi.getRun(runID);
    sig = getSignalByIndex(aircraftRun,1);
    sig.AbsTol = 0.1;
end

Esempi correlati

Parametri

Non sono disponibili parametri per questa applicazione.

Uso programmatico

Simulink.sdi.view apre Simulation Data Inspector dalla riga di comando di MATLAB.

Cronologia versioni

Introdotto in R2010b

espandi tutto