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​

Opening a project runs two independent checks. The format version is checked first, then the integrity data. Each one has its own dialog, each is answered separately, and one project can raise both, one after the other.

The format version check:

  • Compatible files: Open seamlessly with no user interaction required. A project saved by an older Volvicon, or one saved before format versions were recorded, is treated as compatible.
  • Newer format files: A Project File Compatibility Warning appears when the project was written in a newer project format than this Volvicon supports, which is narrower than simply a newer Volvicon version. You can choose to:
    • Yes: Attempt to open the file (some data may not load correctly)
    • No: Stop opening, to avoid potential issues. No is the default.
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, a Project Integrity Warning appears with details about what was detected. You can choose to:

  • Yes: Open the project anyway (use with caution)
  • No: Stop opening, to investigate the issue. No is the default.

Answering No to either warning stops the opening. Answering Yes to the compatibility warning moves on to the integrity check, which may raise a warning of its own.

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.

What is checked when a project opens​

Both checks, and every way each one can end, in one picture. No is the default button on both warnings.

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