-
Notifications
You must be signed in to change notification settings - Fork 0
Usage
PARIS supports two operation modes:
- The geometry mode simply calculates and prints the target volume dimensions based on the input geometry. This allows the user to specify a region of interest later.
- The reconstruction mode performs an actual backprojection based on input parameters and projections.
The geometry mode is invoked by passing only the geometry file:
./paris --geometry foo.geo
The reconstruction mode needs at least a geometry file, a readable directory containing the projections and a writeable output path:
# writes volume to /output/path/vol.ddbvf
./paris --geometry foo.geo --input /path/to/projections --output /output/path
If a custom name for the output file is needed (the default one is "vol") this can be specified with the --name parameter:
# writes volume to /output/path/bar.ddbvf
./paris [geometry,input,output] --name bar
In some cases it is not desirable or necessary to reconstruct the whole volume. The user can easily pass a region of interest to PARIS by enabling the --roi switch:
./paris [geometry,input,output] --roi
Following the --roi switch the user needs to specify the coordinates of the region of interest. See Region of Interest for instructions on how to specify these coordinates.
In order to save time during reconstructions the user can optionally choose to backproject only every nth projection using the --quality parameter:
./paris [geometry,input,output] --quality n
Example: For n = 2, every second projection will be backprojected; higher values will further reduce the output volume's quality.
Due to mechanical or other real world limitations there are incomplete projection sets. By passing an angle file to the program these sets can still be backprojected:
./paris [geometry,input,output] --angles /path/to/angle.file
This file must contain all angles for the given projection set. Individual angles are separated by newlines and they must be in the same order as the projections in the set.