NAME¶

ctconvert — convert CTSim files between HDF5 and the legacy binary format

SYNOPSIS¶

DESCRIPTION¶

ctconvert reads input-file and writes output-file in the requested format. Both the format of the input and whether it holds an image or projections are detected from the file, so neither has to be given.

From version 6.5.0 CTSim writes HDF5 by default. HDF5 stores all floating point data as double precision, where the legacy format stored 32-bit float, and the files can be read directly by numpy, MATLAB, ImageJ and HDFView. Every tool reads both formats, so converting an archive is optional; it is worth doing where the extra precision or the interoperability matters.

Converting from HDF5 to the legacy format discards anything the older format cannot represent: structured history parameters are reduced to their text form, user attributes are dropped, and pixel values are rounded to 32-bit float.

Every tool is run through ctsim-nogui, as in "ctsim-nogui ctconvert ...", or directly if a symbolic link of that name points at it.

The arguments and options are as follows:

input-file

Image (.if) or projection (.pj) file, either format

output-file

Name of the converted file

--to

Output format

hdf5

HDF5 (default)

legacy

CTSim's original binary format

--verbose

Report progress and details while running.

--version

Print the CTSim version and exit.

--help

Print the usage summary and exit.

SEE ALSO¶

ctsim-nogui(1), ctsim(1)

The CTSim manual, installed as /usr/share/doc/ctsim/ctsim.pdf and ctsim.html and available from the Help menu of ctsim.

AUTHORS¶

Kevin M. Rosenberg <kevin@rosenberg.net>