Configuration File Format

Version 1.1

Overview

The configuration file is a CFG file that contains all of the information to load a trial into Autoscoper. The configuration file is used to load camera calibration files, videos, and volumes. The file is organized with key value pairs and supports relative paths. The configuration file is loaded by Autoscoper when the user selects a trial to load.

Key value pairs

Key	Value
`Version`	The version of the configuration file.
`mayaCam_csv`	The path to the camera calibration file. See more information about the camera calibration file format here.
`CameraRootDir`	The root directory for the radiographs. The order must be the same as the order of the `mayaCam_csv` keys to ensure the correct camera is loaded.
`VolumeFile`	The path to the volume file.
`VolumeFlip`	The flip of the volume.
`VoxelSize`	The voxel size of the volume.
`RenderResolution`	The resolution of the 2D rendering.
`OptimizationOffsets`	The offsets for the optimization.

Example

Given a directory structure like this:

Main Directory
├───Calibration
│   ├───{task prefix}-cam01.csv
│   └───{task prefix}-cam02.csv
├───RadiographImages
│   ├───{task prefix}-cam01
│   │   ├───0001.tif
│   │   ├───0002.tif
│   │   ├───...
│   │   └───n.tif
│   └───{task prefix}-cam02
│       ├───0001.tif
│       ├───0002.tif
│       ├───...
│       └───n.tif
├───Volumes
│   └───radius.tif
└───{task prefix}.cfg

The config file would be placed in the Main Directory and would look like this:

Note

All relative paths must be in the format path/to/something/ or ./path/to/something/.

Any relative paths that are in the format /path/to/something/ will fail to load properly.

# This is a comment
Version 1.1

mayaCam_csv Calibration/{task prefix}-cam01.csv
mayaCam_csv Calibration/{task prefix}-cam02.csv

CameraRootDir RadiographImages/{task prefix}-cam01/
CameraRootDir RadiographImages/{task prefix}-cam02/

VolumeFile Volumes/radius.tif
VolumeFlip 0 0 0
VoxelSize 0.1 0.1 0.1

RenderResolution 512 512

OptimizationOffsets 0.1 0.1 0.1 0.1 0.1 0.1

Version 1.0

Overview

Warning

This version of the configuration file does not support relative paths and is not recommended for use.

The configuration file is a CFG file that contains all of the information to load a trial into Autoscoper. The configuration file is used to load camera calibration files, videos, and volumes. The file is organized with key value pairs and does not support relative paths. The configuration file is loaded by Autoscoper when the user selects a trial to load.

Key value pairs

Key	Value
`mayaCam_csv`	The path to the camera calibration file. See more information about the camera calibration file format here.
`CameraRootDir`	The root directory for the radiographs. The order must be the same as the order of the `mayaCam_csv` keys to ensure the correct camera is loaded.
`VolumeFile`	The path to the volume file.
`VolumeFlip`	The flip of the volume.
`VoxelSize`	The voxel size of the volume.
`RenderResolution`	The resolution of the 2D rendering.
`OptimizationOffsets`	The offsets for the optimization.

Example

# This is a comment
mayaCam_csv C:/Users/username/Documents/Autoscoper/Calibration/{task prefix}-cam01.csv
mayaCam_csv C:/Users/username/Documents/Autoscoper/Calibration/{task prefix}-cam02.csv

CameraRootDir C:/Users/username/Documents/Autoscoper/RadiographImages/{task prefix}-cam01/
CameraRootDir C:/Users/username/Documents/Autoscoper/RadiographImages/{task prefix}-cam02/

VolumeFile C:/Users/username/Documents/Autoscoper/Volumes/radius.tif
VolumeFlip 0 0 0
VoxelSize 0.1 0.1 0.1

RenderResolution 512 512

OptimizationOffsets 0.1 0.1 0.1 0.1 0.1 0.1