VisualBasilisk

Source-first Basilisk VOF/facet-to-Blender bridge for explicit manifests, dry-run render planning, tiny synthetic fixture checks, and reproducible metadata reports.

Public source bridge — not CFD validation or a full renderer.

Overview

Why it exists

VisualBasilisk separates solver output, render planning, metadata reports, and scientific explanations. The goal is a small inspectable bridge from Basilisk-style facet exports to Blender-oriented visualization workflows without bundling simulations or large media.

Current scope

The public repository is a modest v0.3 source snapshot. It includes schemas, tests, tiny synthetic fixtures, and documentation for keeping raw solver artifacts out of GitHub-visible project pages.

What the bridge does

The useful product is the source workflow: check manifests, plan rendering, and keep scientific scope explicit.

Read compact Basilisk-style facet and surface manifests

This step supports reproducible inspection of visualization inputs without turning images into unsupported scientific claims.

Check frame completeness and manifest consistency

This step supports reproducible inspection of visualization inputs without turning images into unsupported scientific claims.

Generate deterministic dry-run Blender render plans

This step supports reproducible inspection of visualization inputs without turning images into unsupported scientific claims.

Run a minimal headless Blender smoke render for tiny synthetic fixtures

This step supports reproducible inspection of visualization inputs without turning images into unsupported scientific claims.

Keep metadata reports, provenance notes, and scientific scope visible

This step supports reproducible inspection of visualization inputs without turning images into unsupported scientific claims.

Current distribution

The v0.3 source snapshot includes code, schemas, tests, documentation, and synthetic fixtures. No package or container is distributed.

RepositoryPublic source-first v0.3 snapshot
Fixture policyTiny synthetic examples only
Render pathDry-run plans plus one minimal Blender smoke-render route
DistributionSource and documentation; no package, container, or release
Site statusPublic project page
Scientific statusNo validation, production-CFD, or fit-readiness claim

What it deliberately avoids

The tool organizes visualization inputs and render plans; it does not create or validate scientific results.

  • Not a CFD solver
  • Not a full renderer
  • Not validation or production CFD
  • Not an atomisation predictor
  • Not pressure-nozzle modeling
  • No real Basilisk fixture is included yet

Next reasonable step

The next development step is a small real Basilisk-derived fixture with explicit input semantics and tests. Until then, the source examples remain synthetic.