ConeBeamReconstructionSettings
Settings for cone beam reconstruction.
Import
import ScriptingApi as api
# Access the class
# ConeBeamReconstructionSettings is available via api.ConeBeamReconstructionSettings
Properties
invert_x
Mirror the input projections horizontally (flip along the X axis).
Type: bool
invert_y
Mirror the input projections vertically (flip along the Y axis).
Type: bool
invert_z
Reverse the order of input projections (invert the Z direction). Rarely used.
Type: bool
invert_intensity
Invert the intensity values of the input projections. Use if projections appear as negative images.
Type: bool
source_to_detector_distance
Distance from the X-ray source to the detector plane (in millimeters). This affects the magnification and geometry of the scan.
Type: float
source_to_isocenter_distance
Distance from the X-ray source to the object isocenter (in millimeters). This is the radius of the scan trajectory.
Type: float
detector_pixel_size_x
Physical size of a detector pixel along the X (horizontal) axis (in millimeters).
Type: float
detector_pixel_size_y
Physical size of a detector pixel along the Y (vertical) axis (in millimeters).
Type: float
xray_scan_start_angle
The starting angle of the X-ray scan (in degrees). Defines the initial gantry position.
Type: float
xray_scan_total_angle
Total angular range covered by the scan (in degrees). 360° for a full scan, less for a short scan.
Type: float
is_clockwise
Scan rotation direction.
Type: bool
projection_offset_x
Horizontal offset of the detector center relative to the rotation axis (in millimeters). Use to correct for detector misalignment.
Type: float
projection_offset_y
Vertical offset of the detector center relative to the rotation axis (in millimeters). Use to correct for detector misalignment.
Type: float
source_offset_x
Horizontal offset of the X-ray source relative to the rotation axis (in millimeters).
Type: float
source_offset_y
Vertical offset of the X-ray source relative to the rotation axis (in millimeters).
Type: float
out_of_plane_angle
Rotation of the detector around the X axis (out-of-plane tilt, in degrees). Use to correct for detector tilt.
Type: float
in_plane_angle
Rotation of the detector around the Z axis (in-plane tilt, in degrees). Use to correct for detector tilt.
Type: float
enable_displaced_detector
Enable special handling for off-centered (displaced) detector panels. Useful for short scans or non-standard geometries.
Type: bool
angular_gap_threshold
Angular gap threshold (in degrees) for detecting short scans with displaced detectors. Above this value, short scan weighting is applied.
Type: float
projection_skip
Skip projections to reduce computation time. 0 uses all, 1 uses every 2nd, 2 uses every 3rd, etc. Note: Increasing this reduces computation and data size but also lowers angular sampling and may degrade reconstruction quality.
Type: int
projection_smoothing_level
Projection smoothing level. Low/Medium provide increasing noise reduction; higher settings reduce fine details. Choose Low or Medium for a balanced result. Use api.CBR_ProjectionSmoothingLevel.Low, api.CBR_ProjectionSmoothingLevel..Medium, api.CBR_ProjectionSmoothingLevel.High
Type: CBR_ProjectionSmoothingLevel
speckle_removal_mode
Speckle removal mode. Use to remove isolated hot/dead pixels while preserving overall sharpness. Use api.CBR_SpeckleRemovalMode.MultiPixel, api.CBR_SpeckleRemovalMode.SinglePixel, api.CBR_SpeckleRemovalMode.Off
Type: CBR_SpeckleRemovalMode
beam_hardening_preset
Beam hardening correction preset. Presets increase correction strength from mild to strong. Use api.CBR_BeamHardeningPreset.Off, api.CBR_BeamHardeningPreset.Low, api.CBR_BeamHardeningPreset.Medium, api.CBR_BeamHardeningPreset.High
Type: CBR_BeamHardeningPreset
enable_intensity_offset_correction
Apply intensity offset/bias correction. Subtracts a constant percentage from projection intensities. Percentage of the maximum detector intensity to subtract (e.g., 0.5–5%). Typical starting values: 0.5–2.0 (%). Higher values may produce negative intensities and cause streak artifacts; increase gradually and inspect results.
Type: bool
intensity_offset_bias
Intensity offset bias value to subtract from projections (percentage of maximum intensity). Range: 0.0–100.0 (%). Typical: 0.5–5.0 (%). Use small values to avoid artifacts.
Type: float
enable_logarithm_conversion
Convert raw detector intensities to attenuation values using logarithmic transformation. Enable when input projections are raw transmission/intensity measurements (I).
Type: bool
enable_scatter_correction
Enable scatter radiation correction. Apply when working with raw intensities to reduce scatter-induced background; requires tuning of related parameters.
Type: bool
scatter_air_threshold
Detector value threshold for identifying air regions (for scatter correction). Typical values for 16-bit detectors: 30000–40000; tune according to detector and acquisition.
Type: float
scatter_to_primary_ratio
Estimated ratio of scatter to primary radiation. Typical values 0.02–0.15.
Type: float
dark_field_image_file_name
Path to dark field calibration image for flat-field correction.
Type: str
bright_field_image_file_name
Path to bright field calibration image for flat-field correction.
Type: str
truncation_correction
Truncation correction factor for the reconstruction filter. Values above 0 enable correction for truncated projections (object extends beyond detector).
Type: float
hann_cut_frequency
Hann cut frequency (0.0 to 1.5). Higher values allow more high-frequency detail, lower values increase smoothing.
Type: float
auto_invert_intensity
Automatically invert the intensity of the reconstructed image. Useful if the reconstructed object appears with reversed contrast.
Type: bool
auto_crop
Automatically crop the reconstructed image to the object. Removes empty background for a tighter result.
Type: bool
crop_margin
Margin (in pixels) to add around the cropped object. Only used if autoCrop is enabled.
Type: int
enable_low_clamping
Enable low intensity clamping (clamp values below threshold).
Type: bool
low_clamping_type
Low clamping type. Use api.CBR_ClampingType.Absolute, api.CBR_ClampingType.Percental
Type: CBR_ClampingType
low_clamping_value
Low clamping threshold value (absolute or percentage based on type).
Type: float
enable_high_clamping
Enable high intensity clamping (clamp values above threshold).
Type: bool
high_clamping_type
High clamping type. Use api.CBR_ClampingType.Absolute, api.CBR_ClampingType.Percental
Type: CBR_ClampingType
high_clamping_value
High clamping threshold value (absolute or percentage based on type).
Type: float
enable_sharpening
Enable Unsharp Mask (USM) sharpening on the reconstructed volume. Sharpening can enhance edge contrast and local detail but may amplify noise.
Type: bool
sharpening_iterations
Number of times the sharpening operation is applied. More iterations increase sharpening strength; typical values: 1-5.
Type: int
sharpening_radius
Radius (in pixels) of the local neighborhood used for sharpening. Larger radius affects broader features; typical values: 1-5.
Type: int
sharpening_contrast
Sharpening amount expressed as a percentage. Typical values: 10-200.
Type: int