Skip to main content

Project Files

A project file stores your work in Volvicon, including all imported data, created objects, measurements, primitives, and view settings. This allows you to save your progress and return to it later.

What is Stored in a Project?

A Volvicon project contains:

ContentDescription
Volume imagesImported 3D image data
MasksSegmentation results
Surface meshesGenerated or imported surfaces
Volume meshesGenerated or imported meshes
MeasurementsDistances, angles, annotations
PrimitivesROIs and geometric objects
AnalysesAnalysis objects
View settingsCamera positions, window/level, transfer functions
Object propertiesColors, visibility, names

Working with Projects

Creating a New Project

  1. Click New Project on the File ribbon tab
  2. Select the data file(s) to import
  3. Configure import options
  4. The project is created with the imported data

Opening an Existing Project

  1. Click Open Project on the File ribbon tab
  2. Navigate to the .vvcx file
  3. Click Open

Saving a Project

ActionShortcutDescription
SaveCtrl+SSave changes to current project
Save AsCtrl+Shift+SSave as a new project with a new name
note

Save your project regularly to avoid losing work.

Project Data Management

Importing Additional Data

To add more data to an existing project:

  1. Open the project
  2. Click Import on the File ribbon tab
  3. Select the data type and file(s)
  4. The new data is added to the project

Exporting Data

To export objects from a project:

  1. Select the object in the Project Panel
  2. Click Export on the File ribbon tab
  3. Choose the export format
  4. Configure options and save

Version Compatibility

Volvicon project files (.vvcx) include format version information to ensure proper compatibility when sharing projects between different versions of Volvicon.

Compatibility Scenarios

ScenarioBehavior
Same versionOpens without issues
Older project → Newer VolviconFull backward compatibility; opens normally
Newer project → Older VolviconWarning displayed; some features may not load

What Happens When Opening Projects

When you open a project file, Volvicon automatically checks the format version:

  • Compatible files: Open seamlessly with no user interaction required
  • Newer format files: A warning dialog appears explaining that the project was created with a newer version. You can choose to:
    • Continue: Attempt to open the file (some data may not load correctly)
    • Cancel: Abort opening to avoid potential issues
Sharing Projects

For best results when sharing projects with colleagues, ensure everyone uses the same or a compatible version of Volvicon. When in doubt, the person with the newer version should save a copy for the recipient.

Data Integrity

Project files include built-in integrity verification to help detect unauthorized modifications, tampering, or accidental corruption. This feature is designed to support compliance with regulatory requirements in industries such as:

  • Medical imaging (FDA 21 CFR Part 11, ISO 13485)
  • Automotive (IATF 16949)
  • Manufacturing (ISO 9001)

How Integrity Verification Works

When you save a project, Volvicon automatically creates an integrity manifest that records:

  • A list of all files in the project
  • File sizes and checksums
  • A cryptographic hash of the manifest itself

When you open a project, Volvicon verifies this information to detect:

Detection TypeDescription
Missing filesFiles expected by the manifest but not found
Added filesUnexpected files found that weren't in the original project
Modified filesFiles with different sizes or different CRC32 values than when the project was saved
Tampered manifestChanges to the integrity data itself or a corrupted manifest

Integrity Warnings

If Volvicon detects an integrity issue, you'll see a warning dialog with details about what was detected. You can choose to:

  • Continue: Open the project anyway (use with caution)
  • Cancel: Stop opening to investigate the issue
Missing Manifest

If a project file is missing its integrity manifest, Volvicon will warn you before opening. A missing manifest indicates that the file may have been modified outside of Volvicon or the manifest was deliberately removed.

For Regulated Industries

If your organization requires audit trails for data integrity, consider documenting the integrity check results shown when opening project files. The warning messages include specific file names for traceability.

Best Practices

PracticeReason
Save frequentlyPrevent data loss
Use descriptive namesEasy identification
Keep project folders togetherMaintain data integrity
Back up important projectsRecovery from failures
Close projects before moving foldersPrevent broken references

Troubleshooting

IssueSolution
Missing data filesCheck if files were moved; re-link or re-import
Cannot open projectVerify Volvicon version compatibility
Large project sizeConsider using referenced data mode
Slow loadingLarge datasets take time; be patient