CoViS: Complex Visualization Suite

MATLAB toolkit for comparative complex analysis with identity-by-hue rendering. Supports 1D path plots and 2D holomorphic surfaces with mono-hue phase encoding, parallel/GPU evaluation, and custom sym-log scaling.

Features

• Path mode: real input → 3D complex output lines, optional symmetric log on Re/Im.
• Surface mode: complex input grid → magnitude surface with mono-hue phase bands and phase colorbar.
• Function registry with per-function hue; demos for exp, nu, gamma, and polynomials.
• Performance: optional GPU, parfor; integral-based nu wrapper, symbolic fallback for complex gamma.

Quick Start

1. Open MATLAB in this folder.
2. Run examples:
   • examples/path_demo.m
   • examples/surface_demo.m
3. Adjust config via CoVis_Control('config', ...) (Mode, Limits, Resolution, PhaseFreq, UseParallel, UseGPU, UseLogZ, UseSymLogPath, SymLogLinThresh).

Core Files

• CoVis_Control.m — config builder, registry helper, render entrypoint.
• CoVis_Math.m — vectorize symbolic expressions, nu solver, gamma_safe, registry validation.
• CoVis_Render.m — PATH/SURFACE renderers, GPU/parfor evaluation, phase mapping, legends/colorbar.
• examples/ — runnable demos for PATH and SURFACE modes.

Notes

• Phase mapping: hue is fixed per function; phase drives S/V with phi=0 → S=1, V=1.
• Gamma for complex inputs uses symbolic fallback if numeric gamma is unsupported.
• Nu integral can be heavy; enable UseParallel/UseGPU or reduce grid Resolution.

Customizing

• Add functions by extending names, handles, hues in demos, then rebuild registry: registry = CoVis_Control('registry', names, handles, hues);
• Toggle log options: UseLogZ (surface magnitude), UseSymLogPath+SymLogLinThresh (path Re/Im).

Dependencies

• MATLAB with Symbolic Math Toolbox (for complex gamma fallback) and optionally Parallel Computing Toolbox (parfor/GPU).