Riferimento dei campi tecnici PlotSpec
In Advanced PlotSpec… → Field reference il Viewer elenca i tipi riconosciuti dal proprietario originale per la figura corrente. Apri Technical PlotSpec per consultare il dizionario e abilita l’editing solo se conosci il contratto: Validate and apply draft valida l’intera proposta. I nomi sono dati strutturati, non espressioni da eseguire. Le sezioni graphics, legend, axes, layout, plot_config e camera sono sotto native_presentation; gli override di un pannello stanno in native_presentation → panels → ID pannello. Lo stile predefinito è in defaults → style, lo stile di una serie nella sua voce panels → series → style, e Model axis nella voce panels → axes → asse. I pannelli e le serie sono liste: conserva ID e ordine mentre modifichi una loro voce. Nelle chiavi del dizionario gli spazi mostrati dal riferimento corrispondono a underscore, per esempio x min è x_min. Le impostazioni disponibili dipendono dal tipo 2D/3D; il fatto che una proprietà compaia nel riferimento non garantisce che ogni renderer la usi.
I tipi number richiedono numeri finiti; boolean indica vero/falso; vector è una sequenza numerica e text_vector una lista di testi. Dove il proprietario lo ammette, vuoto, auto, inherit e source rappresentano rispettivamente assenza, scelta automatica, ereditarietà e unità della sorgente: non sono zeri numerici. Una modifica non valida è rifiutata conservando la bozza accettata.
Graphics, Legend, Layout e Camera
Per ogni proprietà Graphics, Legend, Layout e Camera, i significati, i valori e i limiti sono descritti rispettivamente nei capitoli Fonts and renderer settings, Legend e Layout e Scene e Camera. Il riferimento tecnico usa chiavi come width_px per la voce visibile «width px». Nella sezione tecnica native_presentation → graphics, per il 3D, aspect_mode ammette auto, xy_equal (stessa scala X/Y), data_equal (stessa scala X/Y/Z) e manual (rapporto esplicito); la scelta GUI equal è soggetta al problema descritto nel capitolo Graphics. I seguenti campi aggiuntivi sono esposti nel dizionario:
| Proprietà tecnica | Uso e condizioni |
|---|---|
| external_margin_px | Spazio esterno richiesto per la legenda, in pixel. Nella superficie 3D con legenda esterna provata, cambiare il valore non ha effetto visibile: per regolare la distanza usa margin_px nello stesso dizionario o Legend margin (px) nel modulo Legend and colorbar…, quindi controlla la vista. Le due impostazioni non sono necessariamente equivalenti negli altri layout. |
| source_override_enabled | Flag di precedenza del contenuto della legenda originale: 0 lascia la scelta della sorgente e 1 abilita la sostituzione. In una superficie 3D senza famiglia e con Legend content auto, nella prova 0 non mostra voci e 1 mostra la voce della serie; riportando 0 la legenda torna vuota. Non modifica il Dataset né il proprietario del grafico. |
Axes
Queste chiavi riguardano la presentazione degli assi del renderer. Usa preferibilmente l’Inspector dell’asse: riconosce le unità e valida i campi nel contesto scientifico. La bozza può già contenere titolo, etichette e limiti espliciti nei campi scientifici: questi possono prevalere sui corrispondenti override tecnici, quindi un valore accettato non garantisce da solo un cambiamento visibile. Verifica il risultato e modifica il campo scientifico pertinente se occorre.
| Campi | Uso e condizioni |
|---|---|
| x_scale, y_scale, y2_scale, z_scale | Scala dell’asse X, Y sinistro, Y destro e Z; linear e log hanno domini diversi. Un limite logaritmico deve essere positivo. Nel 2D provato x_scale=log, y_scale=log e y2_scale=log vengono accettati ma non applicati; seleziona l’asse X, Y sinistro o Y destro e usa Scale nel modulo ordinario. Per X il confronto è stato ripetuto con dati tutti positivi. Nel 3D surface con coordinate positive anche x_scale, y_scale e z_scale tecnici restano senza effetto: usa Scale nell’Inspector dell’asse. |
| xy_aspect_mode, aspect_mode, aspect_ratio | Per xy_aspect_mode, inherit eredita, auto sceglie automaticamente e xy_equal richiede proporzioni uguali fra X e Y. Per il campo Axes 3D aspect_mode, le scelte sono inherit (ereditata), auto (automatica), xy_equal (stessa scala X/Y), data_equal (stessa scala sui tre assi) e manual, che usa aspect_ratio con tre valori positivi X;Y;Z. Nel 3D surface provato, i valori di aspect_mode e aspect_ratio nel ramo Axes sono accettati ma la vista resta auto. Usa invece native_presentation → graphics → aspect_mode e, per manual, aspect_ratio: quel percorso è stato verificato. Il campo Graphics ordinario ha un insieme di valori diverso; equal può essere rifiutato e il percorso tecnico xy_equal è descritto nel capitolo Graphics. Verifica che le unità siano confrontabili. |
| x_unit, y_unit, y2_unit, z_unit, time_unit | Unità di visualizzazione dei rispettivi assi e del tempo; devono essere riconosciute e compatibili con la sorgente. Nel 2D provato x_unit=ms, y_unit=mV e y2_unit=A sono accettati ma non cambiano le unità: seleziona l’asse pertinente e usa Display unit nel modulo ordinario. Nella surface 3D provata anche le unità tecniche X, Y e Z restano senza effetto: usa Display unit nell’Inspector dell’asse. Nel 2D con tempo trascorso numerico provato, anche time_unit=min è accettato senza convertire X da secondi: usa Display unit sull’asse X. La conversione non cambia il Dataset; controlla separatamente l’unità della barra colore. |
| title, x_label, y_label, y2_label, z_label | Testo del titolo o dell’etichetta del rispettivo asse. Una scelta vuota può lasciare al proprietario il testo automatico. Nel 2D provato x_label, y_label, y2_label e title tecnici sono accettati ma non cambiano il testo: seleziona l’asse X o Y e imposta Label nel modulo ordinario; per il titolo seleziona Plot e usa Plot title. Nel 3D provato anche le etichette tecniche X/Y/Z e il titolo Axes vengono ignorati: usa Label nell’Inspector dell’asse e 3D plot title in Scene. |
| x_min, x_max, y_min, y_max, y2_min, y2_max, z_min, z_max | Limiti inferiori e superiori nelle unità visualizzate dei rispettivi assi; devono essere ordinati e validi per la scala scelta. Nel 2D provato i valori tecnici X, Y e Y2 sono accettati ma non modificano i limiti automatici. Seleziona l’asse X, Y sinistro o Y destro in Sources e imposta Minimum e Maximum in Axis, units and bounds…; il percorso è stato verificato su tutti e tre gli assi. Nel 3D provato anche i limiti tecnici X/Y/Z non cambiano l’intervallo: usa Minimum e Maximum nell’Inspector dell’asse. Controlla i limiti effettivi dopo l’applicazione. |
| x_step, y_step, y2_step, z_step | Passo principale positivo dei rispettivi assi nelle unità visualizzate; senza un override il renderer lo sceglie. Nel 2D provato i passi tecnici X, Y e Y2 non modificano i tick; usa Major step nel modulo ordinario dell’asse X, Y sinistro o Y destro: il percorso è stato verificato su tutti e tre. Nel 3D provato anche i passi tecnici X/Y/Z non cambiano i tick: usa Major step nell’Inspector dell’asse. |
| z_format, zgrid | z_format controlla il formato del testo dei tick Z. Per zgrid, inherit eredita, on mostra la griglia Z e off la nasconde, quando il proprietario 3D la supporta. |
| enabled, align_ylabels, ylabel_x, ygrid_source, grid_color | enabled dovrebbe abilitare la presentazione Axes: nel 2D provato 0 e 1 lasciano però ugualmente attivo ygrid_source=none. Per rimuovere quell’effetto elimina esplicitamente la chiave Axes, valida e controlla la vista. align_ylabels allinea le etichette Y dei pannelli; ylabel_x fissa la posizione orizzontale dell’etichetta; ygrid_source sceglie l’asse che determina la griglia: left sinistro, right destro, none nessuno o inherit ereditato; grid_color ne controlla il colore. |
| view_azimuth, view_elevation, projection | Angoli e proiezione della vista 3D. Nel caso provato, se una camera è conservata, questi valori del ramo Axes sono accettati ma non cambiano la camera effettiva. Usa Native camera… per modificare Position, Target e Projection, oppure l’orbita interattiva; verifica la vista. La camera non modifica le misure. |
| colormap, colorbar_visible, colorbar_label, color_unit, color_min, color_max, background | Palette, visibilità ed etichetta della barra colore, unità e limiti della mappatura scalare, sfondo; si applicano quando la figura usa una mappatura scalare. Nella surface 3D provata le sei chiavi colore e background nel ramo Axes sono accettate ma ignorate: imposta palette, barra, etichetta, unità e limiti nel modulo Fonts and renderer settings… oppure nel ramo tecnico Graphics. Il background Axes è rimasto senza effetto anche nel 2D provato: usa Background setting in Graphics. Verifica i limiti nella stessa unità del colore. |
| x_level_scale, y_level_scale, y2_level_scale, z_level_scale | Dizionari di trasformazione del livello dei rispettivi assi. Le chiavi ammesse sono descritte sotto; la trasformazione richiede un riferimento scientifico esplicito e non riscrive la sorgente. In 3D verifica separatamente la barra colore: la coordinata Z può mostrare dB mentre la mappatura scalare resta nell’unità della sorgente. Nella figura 2D di questa versione, x_level_scale può essere accettato senza trasformare i valori X né cambiare l’etichetta: non interpretare la semplice accettazione come trasformazione riuscita. Se il calcolo derivato è scientificamente appropriato, crea e pubblica una variabile canonica già trasformata con formula e riferimento documentati, poi usala come X senza applicare nuovamente la scala. |
Dizionario level scale
| Chiave | Uso e condizioni |
|---|---|
| scale | linear conserva la scala lineare; dB usa 20 log10(|x|/ref) per ampiezza e 10 log10(x/ref) per potenza; dBFS usa il logaritmo rispetto al fondo scala dichiarato; FS mostra il rapporto x/ref, conservando il segno dell’ampiezza. Il riferimento deve avere unità compatibile con l’asse; un ingresso già espresso in dB, dBFS o FS non viene trasformato di nuovo. Controlla i limiti espliciti dell’asse dopo la trasformazione: possono escludere i nuovi valori visualizzati. |
| quantity_kind | amplitude o power: specifica la natura della grandezza per una scala di livello non lineare. |
| amplitude_basis | Per amplitude specifica peak o rms; non presumere che una sia equivalente all’altra. |
| reference_value, reference_unit | Valore di riferimento finito e positivo e relativa unità esplicita, richiesti per la scala non lineare. |
| zero_policy | Per le trasformazioni logaritmiche, missing richiede di trattare lo zero come mancante; negative_infinity richiede meno infinito. In questa versione, una serie con zero e missing può essere rifiutata con “floating point value is Not a Number”, lasciando la bozza precedente. Se è scientificamente appropriato escludere gli zeri dalla vista, prima applica alla serie un predicato not_equal 0 sulla variabile sorgente e poi la scala: il Dataset resta intatto, ma dichiara che i punti a zero sono esclusi. negative_infinity ha una semantica diversa e va scelto solo se appropriato. Con FS il rapporto allo zero resta zero; valori non finiti e potenze negative non producono campioni validi. |

Style
Il riferimento espone anche proprietà di stile avanzate. In questa versione marker_edge_color, marker_face_color, fill_color, fill_opacity, edge_color, edge_width e hatch inseriti in panels → series → style sono rifiutati dalla validazione; per queste proprietà non è stato verificato un percorso alternativo. Il modulo ordinario consente invece colore della serie, tratto, forma e riempimento del marcatore e opacità complessiva. Le descrizioni seguenti indicano l’uso previsto dove il proprietario ammette i campi.
| Campi | Uso e condizioni |
|---|---|
| color, line_style, line_width | Colore, tratto e spessore della serie; le scelte di tratto e RGB sono spiegate in Dataset, serie e incertezza. |
| marker, marker_fill, marker_size | Forma, riempimento e dimensione del marcatore; il riempimento è significativo per simboli con un interno. |
| marker_edge_color, marker_face_color | Colori del contorno e dell’interno del marcatore quando supportati dal tipo e dal renderer. |
| fill_color, fill_opacity, edge_color, edge_width, hatch | Colore e opacità del riempimento, colore e spessore del bordo, tratteggio di riempimento per gli elementi che li supportano; l’effetto dipende dal tipo di grafico. |
| opacity | Opacità complessiva della serie: ridurla rende la rappresentazione più trasparente senza cambiare i valori. |
Plot config
| Campi | Uso e condizioni |
|---|---|
| auto_reduce_threshold, chunk_rows | Soglia in righe valide per attivare la riduzione automatica e dimensione dei blocchi di lettura; i valori predefiniti del proprietario sono rispettivamente 12.000 e 5.000. Con reduction_mode auto, la soglia decide quando considerare la riduzione: nella prova con 1200 punti e target 100, soglia 2000 conserva 1200 punti e soglia 500 ne mostra 101. chunk_rows è il numero di righe richiesto per blocco durante la preparazione; nelle prove sulla vista 3D, 100 e 500 conservano entrambi 1200 punti con riduzione none. La ricevuta della vista non espone il numero di blocchi effettivamente letti. In una prova con tracciamento del worker Native3D, le applicazioni dalla GUI con 100 e 500 hanno entrambe aperto lo stream con blocchi di 4096 righe. Non fare affidamento su chunk_rows per cambiare la dimensione dei blocchi in tale percorso. Nessuna delle due impostazioni altera i campioni canonici. |
| reduction_mode, target_points | Politica e obiettivo di riduzione del disegno; vedere Scene e Camera 3D per le scelte e le restrizioni topologiche. |
| family_display_unit, family_label_prefix, legend_content | Unità di presentazione della famiglia quando compatibile e prefisso delle etichette; auto lascia la scelta al proprietario. Per esempio, una famiglia 1/2 m mostrata in cm diventa 100/200 cm; il prefisso scelto compare nelle voci. legend_content può essere auto, none, series o family: scelta automatica, nessuna voce, voci di serie o membri di famiglia disponibili. Non cambiano le identità sorgente. |
| plot_type, plot_style, point_order | Il tipo 3D sceglie la geometria descritta nel capitolo Scene. Per il Graph 2D, plot_style offre auto, line, scatter e line_markers: rispettivamente automatico, linea, punti, linea con punti. Nel 2D provato questo default agisce quando Series kind è auto; un tipo esplicito della serie prevale. point_order usa dataset_order per l’ordine originale o sort_x per ordinare per X; in 2D è disponibile anche auto. La disponibilità dipende dal Graph. |
| line_width, marker_size, contour_levels | Spessore della linea, dimensione dei marcatori e numero dei livelli: si applicano soltanto ai tipi che li usano. |
| extra_format | Nessun output addizionale, SVG o PDF secondo la scelta e il proprietario. Nella surface 3D provata, plot_config/extra_format=pdf tecnico non ha creato il PDF alla pubblicazione; seleziona invece pdf in Scene → Additional output format prima di Publish Plot e controlla gli artefatti. La prova non copre SVG o 2D. |
| title, x_label, y_label, y2_label, z_label | Titolo ed etichette degli assi della figura, secondo le dimensioni del Graph. Nella surface 3D provata questi testi nel ramo Plot config sono accettati ma non cambiano la vista: usa 3D plot title e le label in Scene. Nel 2D con asse destro provato, anche y2_label viene accettato senza cambiare il testo: seleziona l’asse Y destro in Sources, apri Axis e imposta Label. Il titolo della bozza può prevalere; controlla il risultato. Il testo non rinomina i dati. |
Model axis
| Campi | Uso e condizioni |
|---|---|
| label, display_unit, scale, direction | Etichetta, unità compatibile, scala e direzione di un asse; le scelte e le guardie sono nel capitolo assi e pannelli. |
| min, max, major_step, label_position_x | Limiti, passo principale e posizione X dell’etichetta dell’asse nelle coordinate previste dal proprietario. |
| format, tick_format, tick_label_mode | Il riferimento elenca queste proprietà, ma in questa versione format e tick_format inseriti direttamente in panels → axes → x vengono rifiutati. Per il formato X, un percorso verificato è native_presentation → panels → ID pannello → x_format, per esempio %.2f per due decimali; applica e verifica il risultato. Conserva gli altri campi e usa solo formati accettati dal renderer. Anche tick_label_mode e label_position_x aggiunti direttamente nel Model axis X sono rifiutati. Non è stabilito un percorso alternativo per ogni proprietà mostrata dal riferimento. |
| grid, major_grid, minor_grid, grid_source | Politiche della griglia generale, principale e secondaria e asse sorgente; l’effetto dipende dal renderer. In questa versione i campi grid, major_grid e grid_source aggiunti direttamente al Model axis X sono rifiutati nonostante figurino nel riferimento. Per l’uso ordinario scegli le griglie disponibili nell’Inspector; minor_grid per X è stato accettato. Non assumere che ogni nome del riferimento sia modificabile in quella posizione. |
| tick_positions, tick_labels | Vettore delle posizioni e lista delle etichette corrispondenti; devono avere cardinalità coerente ed essere validi per l’asse. |