GX-TXT Octave Script Workspace – Complete Guide to the GNU Octave Editor, Scripts and Debugger
GX-TXT OPERATING GUIDE · GNU OCTAVE
Octave Script Workspace: from the editor to scientific results
This guide explains how to use GX-TXT Octave Script Workspace, the environment for writing, organizing, running and checking GNU Octave scripts. It starts by getting familiar with the interface and goes all the way to multi-file projects, the GX-TXT public APIs, Datasets, Jobs and the debugger.
Quick navigation
- Editor, sources and projects
- Script Runner, parameters and Datasets
- Native debugger
- Jobs, results and persistence
- Examples and guided paths
How to follow the guide
The guide is made up of 28 operating chapters and 4 applied paths or appendices. For a progressive reading, start from O01 and continue up to O28; if you already know the editor, you can go straight to the area you are interested in. Chapters W01–W03 offer complete exercises.
The entries below form the complete table of contents. Links to the individual chapters will be activated as they are published on the site.
1. Editor, sources and projects
Chapters O01–O13. First steps, navigating the interface, managing .m files, projects and Markdown notes attached to scripts.
- O01 — Opening Octave Script Workspace and getting to know the work area
- O02 — Octave Script Workspace menus and keyboard shortcuts
- O03 — Script identity: User, Session, metadata and revisions
- O04 — Creating, saving and protecting changes to a script
- O05 — Working with multiple source tabs in the Octave editor
- O06 — Editing code, finding text and navigating by line
- O07 — Organizing the Octave workspace: panels, Focus source and layout
- O08 — Importing and exporting Octave scripts: .m files, UTF-8 and saving
- O09 — Browsing the GX-TXT APIs from the Octave editor: Bridge Snippets and built-in help
- O10 — Creating and opening an Octave Project in the GX-TXT Workspace
- O11 — Organizing a multi-file Octave Project: helpers, entrypoint and Save All
- O12 — Documenting Octave scripts with Markdown Notes
- O13 — Formatting Markdown Notes and managing images in Octave scripts
2. Script Runner, parameters and Datasets
Chapters O14–O19. Preparing a controlled run, attaching input Datasets, configuring typed parameters and obtaining verifiable results.
- O14 — Opening Script Runner and checking the Octave source revision
- O15 — Selecting input Datasets, namespace and alias
- O16 — Typed parameters and single-invocation parameters
- O17 — Saving and loading a Parameter Dataset
- O18 — Checking outputs and running a controlled Octave Job
- O19 — Octave Script Workspace: from the Analysis page to the registered script
3. Native debugger
Chapters O20–O23. Setting breakpoints, following execution step by step, inspecting the stack and variables, recognizing errors and the limitations of the debugger.
- O20 — GX-TXT Octave Script Workspace: breakpoints, code gutter and folding
- O21 — GX-TXT Octave Script Workspace: starting the debugger and step commands
- O22 — Call Stack, Locals and execution frames
- O23 — Handling errors, Stop and Pause in the Octave Debugger
4. Jobs, results and persistence
Chapters O24–O28. Browsing the run history, reading output and diagnostics, managing scientific results and understanding the script life cycle.
- O24 — Script Jobs Manager: history, filters and Rerun
- O25 — Octave Job output: stdout, stderr and diagnostics
- O26 — Publishing numerical results and text output
- O27 — Script and Session lifecycle
- O28 — Accessibility, contrast and troubleshooting
5. Examples and guided paths
Three activities of increasing difficulty.
- W01 — The first Octave script: from Celsius to Kelvin
- W02 — Scientific calibration with the GX-TXT public APIs
- W03 — Multi-file Octave Project and native debugger
Reference environment
This documentation refers to GX-TXT DEV112 Release 2 with patches P001–P005, the analysis.octave_script module version 1.8.3 and GNU Octave 9.4.0. The availability and behaviour of individual functions may change in later versions.