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.

Guide già disponibili

Sono presenti tutte le guide prodotte finora, comprese le due guide complete dedicate alla costruzione degli script GNU Octave/MATLAB-like e Python.

Fondamenti

Introduzione a GX-TXT

Architettura generale, obiettivi, Session, Dataset canonici, analysis, plotting, scripting, provenance ed estensione.

GX-TXT 0.9.8.10-dev-031

Apri la guida

Fondamenti

Dataset e Variable ID

Dataset ID, Variable ID, Variable Schema v3, storage provider, metadata, coordinate e publication.

GX-TXT 0.9.8.10-dev-031 · Dataset API v2 · Variable Schema v3

Apri la guida

Fondamenti

Session Explorer e risorse

Session files, Session Script Explorer, Selections, Temporal Sets, script, note, plot/viewer state e provenance.

GX-TXT 0.9.8.10-dev-031 · Session File Explorer API v1

Apri la guida

Fondamenti

Projects, Experiments e Sessions

Relazione fra project_id, experiment_id e Session; storage, membership, GUI Projects/Experiment, attach/detach e navigazione.

GX-TXT 0.9.8.10-dev-031 · Project API v1

Apri la guida

Scripting

Scrivere script GNU Octave / MATLAB-like

Guida completa allo sviluppo di script .m in GX-TXT: Script Registry, context, Dataset API, API numeriche, pubblicazione, Plot Dataset e servizi pubblici.

GX-TXT 0.9.8.10-dev-031 · analysis.octave_script 1.3.0

Apri la guida

Scripting

Scrivere script Python

Guida completa allo sviluppo di script Python in GX-TXT: client gxtxt, context, Dataset API, NumPy, file e Dataset publication, parallelismo e provenance.

GX-TXT 0.9.8.10-dev-031 · analysis.python_script 1.1.0

Apri la guida

Scripting

Octave & Python Script Workspaces

Guida visuale ai viewer dedicati: gestione dei documenti registrati, editing, import/export, ricerca e bridge.

GX-TXT 0.9.8.10-dev-031

Apri la guida

Plotting

Scientific Dataset Plot

Guida completa a plot.dataset: Series, family, filtri, ordering, dual-Y, multi-panel, Variant, 3D, grandi Dataset ed API.

GX-TXT 0.9.8.10-dev-031 · plot.dataset 3.12.2

Apri la guida

Development

Script Module Builder

Da script Python/Octave a normale modulo Analysis installabile: Analysis Sources, bindings, fields, bundle, validation, packaging e public API.

GX-TXT 0.9.8.10-dev-031 · tool.script_module_builder 1.0.2

Apri la guida

Scripting

Guida alle API reference utilizzabili con Script Bridge

Metodo pratico per discovery, provider reference, required APIs, operations bridged, callback, transport e confini host-only.

GX-TXT 0.9.8.10-dev-031 · verifica 3 ottobre 2026

Apri la guida

Apri l’indice completo delle guide →

Mappa della documentazione futura

La struttura seguente è predisposta per coprire progressivamente tutto GX-TXT. Le voci disponibili portano già alla relativa guida; le altre identificano le aree da documentare.

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 e metadata.Pianificata
RIGOL CSVAcquisizioni da oscilloscopio e preview.Pianificata
Audio, WAV e segnaliImportazione audio e Dataset temporali/spettrali.Pianificata
3D, immagini, PDF e testoGeometry, image, document e text importers.Pianificata

Analisi scientifica

Calcolo numerico, statistica, segnali e fitting.

Analisi numericaInterpolazione, minimizzazione, root finding, smoothing e regression.Pianificata
StatisticaDescrittiva, test, ANOVA, PCA, correlation, resampling e grouped statistics.Pianificata
Analisi spettraleFFT, Welch, cepstrum, harmonic e time-dependent FFT.Pianificata
Curve fittingFitting, family/global models e workbench dedicati.Pianificata

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.