GX-TXT Documentation

Principi del framework

GX-TXT è pensato come infrastruttura scientifica generale, non come insieme di utility scollegate. Alcuni principi ricorrono in tutto il sistema:

Dataset canonici: gli strumenti lavorano su identità registrate e metadati scientifici, non su file scelti ad hoc dal codice.
API pubbliche: script e moduli accedono a Dataset, plotting, selezioni, persistenza e altri servizi attraverso contratti versionati.
Session e provenance: configurazioni, sorgenti, script e risultati restano collegati al lavoro che li ha prodotti.
Separazione fra calcolo e presentazione: i dati scientifici rimangono distinti da grafici, viewer e rappresentazioni.
Estendibilità: Python, GNU Octave e moduli installabili permettono di passare dall’esplorazione alla distribuzione senza modificare CORE.

Mappa della documentazione

Le guide sono organizzate per area funzionale. Le voci disponibili portano direttamente alla pagina; quelle ancora non documentate restano indicate come pianificate.

Fondamenti e Session

Architettura, identità scientifica e organizzazione del lavoro.

Introduzione a GX-TXTArchitettura, scopi, Session, Dataset canonici e workflow generale.Disponibile
Dataset e Variable IDIdentità scientifica, Variable Schema, storage provider, metadata e publication.Disponibile
Session Explorer e risorseSession files, Session scripts e modello delle risorse persistenti.Disponibile
Projects, Experiments e Sessions Project membership, experiment identity, Session storage e navigazione. Disponibile

Importazione e acquisizione

Da dati esterni a Dataset canonici GX-TXT.

Generic CSVTabelle generiche, batch multi-Dataset, Preview, Variables mapping e metadata.Disponibile
RIGOL CSVAcquisizioni da oscilloscopio, parser RIGOL/sequence, preview e mapping canali.Disponibile
Audio, WAV e segnaliAudio generico, WAV linear-PCM e decoding verso timeseries.table.Disponibile
3D, immagini, PDF e testoGeometry, image, PDF, text e source-code importers file-shaped.Disponibile

Analisi scientifica

Calcolo numerico, statistica, segnali e fitting.

Analisi numericaInterpolazione, calculus, smoothing, regression, root finding, optimization e algebra.Disponibile
StatisticaDescrittiva, correlation, test, ANOVA, PCA, resampling, pesi e repliche.Disponibile
Analisi spettraleFFT, Welch, cross-spectrum, time-frequency, cepstrum, envelope e feature.Disponibile
Curve fittingRegression, nonlinear fit, family/global fit e viewer/workbench interattivi.Disponibile

Plotting e viewer

Rappresentazione persistente e strumenti interattivi.

Scientific Dataset Plot2D, Series, family, dual-Y, multi-panel, Variant e 3D.Disponibile
Native 3D ViewerScene, representation, sync e visualizzazione scientifica 3D.Pianificata
Curve Digitizer / WorkbenchDigitalizzazione, tracing e costruzione interattiva di curve.Pianificata
Viewer specialisticiNMR, XAS, spettroscopia, strutture e librerie scientifiche.Pianificata

Scripting Python e Octave

Dalla scrittura di uno script alla sua esecuzione riproducibile.

Scrivere script GNU Octave / MATLAB-likeContext, Dataset API, calcolo, publication e plotting.Disponibile
Scrivere script PythonClient gxtxt, NumPy, Dataset/file publication e parallelismo.Disponibile
Script WorkspacesUso visuale dei viewer Octave e Python.Disponibile
Guida alle API reference utilizzabili con Script BridgeCome leggere le reference realmente invocabili da Python e Octave.Disponibile

Sviluppo di moduli e plugin

Estendere GX-TXT senza modificare CORE.

Script Module BuilderPackaging di script scientifici come moduli Analysis installabili.Disponibile
Standard Module APIDescriptor, fields, bindings, outputs, graphs e Analysis Sources.Pianificata
Plugin Install APIPackage ZIP, installazione, aggiornamento e dipendenze.Pianificata
Public API designContratti versionati e servizi script-safe.Pianificata

API Reference

Riferimento sistematico ai contratti pubblici del framework.

Dataset APIsCanonical Dataset, Variable Schema, Table Stream e Publication.Pianificata
Plot APIsGraph Series, Plot Dataset, axes, annotations e selection.Pianificata
Script APIsRegistry, execution e bridge.Pianificata
Viewer APIsViewer Provider, Interactive Document e Native 3D.Pianificata

Tutorial completi

Procedure che attraversano più componenti del framework.

Dal file al Dataset e al graficoImportazione, analisi, Plot Dataset ed export.Pianificata
Da script a modulo distribuibileWorkspace, API, Module Builder, installazione e Run.Pianificata
Pipeline scientifica riproducibileSession, provenance, Dataset derivati e Variant.Pianificata

Sito tecnico generale di riferimento: www.giux-lab.it.