Scroll to navigation

ctsim(1) General Commands Manual ctsim(1)

NAME

ctsim — A Graphical Computed Tomography Simulator

SYNOPSIS

ctsim [files-to-open... | function [options]] [--shell]

DESCRIPTION

ctsim is a graphical user interface to the various components of the CTSim package. The home for CTSim is http://www.ctsim.org.

ctsim also runs those components from the command line, without opening a window. Naming a function first runs that function and exits, with its output on the standard output and its exit code as the program's:

ctsim phm2if head.if 256 256 --phantom herman

and --shell reads functions from a prompt instead. The decision is made before the graphical interface is started, so a function runs on a machine with no display. ctsim-nogui(1) is the same program built without the interface, for a machine with no Qt at all; it offers the same functions and the same shell. The functions are each installed under their own name as well, so

phm2if head.if 256 256
does the same thing.

OPTIONS

directory
The directory a script writes what it makes into, made if it does not exist. Without this option a directory named ctsim-work- and the time is made under the system temporary directory, and removed when CTSim exits.
When the script ends, save every window it made into the work directory, each under a name made from its title, and copy the script beside them. With --workdir the directory then holds everything needed to see what a run did and to do it again.
Exit zero even where a script command fails. Without it a script that fails exits non-zero, so a demonstration that has quietly stopped working is noticed.
file
Run a script of interface commands and exit with its result. The manual's Scripts section lists the commands; scripts/demos/intro.ctsim is an example.
directory
The directory the file dialogs open in, and the one a script's relative paths are taken from. Useful on macOS, where an application bundle is started with the root of the volume as its working directory.
Do not show the splash screen. A script run wants the windows it makes, not two seconds of logo in front of them.
Verbose logging.
Write CTSim's legacy binary file format instead of HDF5. The legacy format carries no history and cannot hold a plot's ranges; it is here for writing files that can be read by CTSim versions prior to 6.5.0.
Display version
Print a terse help message

SEE ALSO

ctsim-nogui(1), and the manual page of each function.

AUTHORS

Kevin Rosenberg, M.D. <kevin@ctsim.org>

HISTORY

CTSim was begun in 1983 using MS-DOS and a CGA display adapter. In 1999 it was ported to GNU/Linux and later ported to Microsoft Windows.

SEE ALSO

ifinfo (1), if1 (1), if2 (1), ifexport (1), phm2pj (1), phm2if (1), pj2if (1), pjinfo (1), pjrec (1)

September 18, 2026 Nixpkgs