Download the matched sample CT/PET pair from Settings first. These examples contain identifiers and instructions, not image data.
Load the sample CT as fixed A and PET as moving B. Save the identity transform in the VoxelVision folder in Files, then choose Load Transform File in the registration panel. Identity preserves the pair's shared coordinate frame; it is a format example, not an accuracy reference.
Download sample transform ↓A one-pair protocol with the sample CT/PET identifiers. Place it as trial-manifest.json in the VoxelVision folder, tap the main-page banner, then Start. Export the registration to complete the step.
Download sample trial ↓First save a registration with anchor pairs, with sample CT as fixed A and PET as moving B. Save this example as batch-manifest.json in the VoxelVision folder. Open Logs & Feedback → Research Batch, then choose solve, refine, or benchmark. Results go to Research/Runs.
Download sample batch ↓These editing templates contain explicit REPLACE_WITH placeholders. Replace every placeholder before importing. Copy complete image keys from image details; keys are not filenames. JSON requires double quotes and cannot contain comments or trailing commas. Field explanations are provided here and in the downloadable instructions.
Two ordered pairs illustrate the structure. Replace the study ID, labels, and image keys. Duplicate or remove entries as needed; trialID and order must each be unique. Save the finished file as trial-manifest.json.
Download trial template ↓Select two saved registrations by their fixed and moving image keys. Give each config a unique configID. Replace runID for a new independent run. The benchmark example repeats each input three times. Save the finished file as batch-manifest.json.
Download batch template ↓A commented text scaffold for an ITK affine transform. Replace every token with a numeric value, then save as .tfm. Keep the header. Prefer exporting from your registration tool to entering parameters by hand.
Download transform template ↓| Field | How to customize |
|---|---|
| schema / schemaVersion | Keep the values in the matching template unchanged. |
| studyID / runID | Identify your trial protocol or batch run. Use a new runID for a new independent run. |
| trials / configs | One entry per pair. Duplicate or remove entries. Trials guide interactive work; configs select saved registrations for batch execution. |
| trialID / configID | Unique within the corresponding file. |
| order / caseLabel | Trial-only: unique integer order, presented ascending, and a neutral label shown to the operator. |
| fixedUniqueKey / movingUniqueKey | Copy full keys from image details. Both cases must be imported. Batch configs also require a saved registration with anchors in that fixed/moving direction. |
| allRegistrations | false selects only listed configs. true expands all saved registrations with anchors; use an empty configs array if you want only that set. |
| benchmark.repeatCount | Repetitions per input in benchmark mode; the template uses 3. Omit the benchmark object when unused. |
| factors (optional) | Trial-only string-to-string coded labels, preserved in exported records. Keep reference truth and code-to-condition mappings outside the operator-facing manifest. |
To process all saved registrations with anchors, use the all-registrations batch example. The selected-pair template uses library keys; do not add anchorsFile to the same config.
Parameters contains nine row-major matrix entries followed by three translation components in millimeters. FixedParameters contains the three-component center in absolute LPS millimeters. The affine mapping is y = M(x − c) + c + t.
VoxelVision expects the ITK fixed-to-moving resampling transform in absolute LPS coordinates. A moving-to-fixed modeling transform must be inverted; a RAS transform also needs coordinate conversion. A FSL/FLIRT .mat is not an ITK .tfm.
Download offline instructions ↓
Use VoxelVision packages for workflows with other mobile devices running VoxelVision, transferring images and annotations between devices.
Export a sample case to create an importable example with your own annotations. VoxelVision Case Package creates a .vvcase with images and annotations. Custom can export .vvanno (annotations only) or .vvimage (images only). Import via Import Image, drag and drop, or Open With. Annotation-only packages need their matching image case in the library.
Use these export formats for workflows that combine VoxelVision on your mobile device with 3D Slicer or ITK-SNAP on a computer.
Choose Other in Export for a zip with a NIfTI volume, Slicer-compatible Markups JSON, and an NRRD or NIfTI label map. CSV reports are exports, not annotation import templates.
All file formats and import locations →
Updated: