Importing QuantUI results into Avogadro / IQmol / Jmol¶
QuantUI saves every calculation as a result folder under $QUANTUI_RESULTS_DIR
(~/.quantui/results/ in the containers; ./results if the variable is unset).
Each folder ships with portable, standards-compliant files that the wider
quantum-chemistry ecosystem already knows how to read. No screen-scraping,
no lock-in, no waiting on QuantUI to add a feature you can already get from
the tool you already use.
This page is a quick cross-reference: "I want to do X — which file do I open in which tool?"
The big table¶
| What you want to do | QuantUI file (in result folder) | Recommended external tool(s) |
|---|---|---|
| View molecular orbitals in 3D | result.molden |
Avogadro · IQmol · Jmol |
| Animate vibrational normal modes | result.molden (from a Frequency calc) |
Avogadro |
| Plot or replay a geometry-optimization, PES-scan, Transition State or IRC trajectory | trajectory.xyz (any tool) or trajectory.traj (ASE) |
VMD · Avogadro · ASE-GUI |
| Render an orbital isosurface from a saved cube | HOMO.cube / LUMO.cube / etc. |
Avogadro · VMD · ChimeraX |
| Open spectrum data in Excel / a notebook | *_data_*.csv (per-panel: IR, Raman, UV-Vis, NMR, orbitals, PES; written by Copy data) |
LibreOffice Calc · Excel · pandas.read_csv |
| Share the whole result with a collaborator | <result-folder>.zip (Results tab → Export → Export bundle (.zip); written next to the folder) |
Any unzip tool |
| Edit a structure and re-run elsewhere | trajectory.traj (last frame) |
ASE-GUI |
Where the files live¶
After a calculation finishes, open the Files tab in QuantUI and select the result folder. You will see a tree like this:
2026-05-25_14-32-11-394021_H2O_B3LYP_6-31Gx/
├── result.json ← machine-readable result metadata
├── result.molden ← MOs + (for freq) vibrations ← EXPORT.1 / EXPORT.2
├── pyscf.log ← raw PySCF output
├── orbitals.npz ← MO coefficients (for QuantUI re-render)
├── thumbnail.png ← preview card image
├── trajectory.xyz ← opt / PES / TS / IRC frames (multi-frame XYZ)
├── trajectory.traj ← the same frames (ASE binary)
├── ir_spectrum_data_<ts>.csv ← written by Copy data (IR panel)
├── raman_spectrum_data_<ts>.csv ← … Raman panel
├── uv_vis_spectrum_data_<ts>.csv ← … UV-Vis panel
├── nmr_spectrum_data_<ts>.csv ← … NMR panel
├── orbital_energy_diagram_data_<ts>.csv ← … orbital diagram
├── pes_scan_profile_data_<ts>.csv ← … PES-scan panel
└── isosurfaces/ ← written when you generate an isosurface
├── H2O_HOMO_<ts>.cube
└── H2O_LUMO_<ts>.cube
The CSV and cube files appear only after you export them. Very old result folders may not have the Molden or trajectory files.
Per-tool quick start¶
Avogadro 2¶
Avogadro is the easiest cross-platform viewer for QuantUI outputs.
- View MOs:
File → Open → result.molden→ menu Analysis → Orbitals. Pick an orbital from the list, then Extensions → Surfaces → Generate. - Animate vibrations: open the same
result.moldenfrom a Frequency calculation → menu Extensions → Vibrational Modes → pick a frequency → Start Animation. QuantUI writes[FREQ],[FR-COORD], and[FR-NORM-COORD]blocks per the Molden spec. - Replay a geometry optimization:
File → Open → trajectory.xyzand use the frame slider at the bottom of the viewport. - Render an isosurface from a cube file:
File → Open → <orbital>.cube→ Extensions → Surfaces → Generate (the cube is already on a grid).
IQmol¶
Excellent for MO visualization with smooth navigation between orbitals.
- MOs:
File → Open → result.molden. The orbital tree appears in the side panel; double-click an orbital to render its isosurface. - IQmol does not animate vibrations from Molden files. For vibrations, use Avogadro.
Jmol¶
Useful when you want a script-driven viewer for batch screenshots or publications.
- MOs:
load result.molden→mo HOMO(or any orbital index). - Trajectories:
load trajectory.xyzautoloads all frames;frame nextcycles them. - Cubes:
isoSurface s1 cutoff 0.05 "HOMO.cube".
VMD¶
The best tool for large trajectories (PES scans with hundreds of points, long MD-style replays).
- Trajectories:
vmd -m trajectory.xyz. VMD auto-detects multi-frame XYZ. - Cubes:
mol new HOMO.cubethen Graphics → Representations → Isosurface.
ASE-GUI (graphical) and ase (Python)¶
ASE round-trips the binary .traj file with per-frame energies preserved.
- Graphical:
ase gui trajectory.trajopens an interactive viewer. Slice withase gui trajectory.traj@0:10:2. - Edit + save as a new starting point:
ase gui trajectory.traj→ manipulate atoms → File → Save as…. Re-import the saved geometry into QuantUI for a follow-up calculation. - Python post-processing:
from ase.io import read
frames = read("trajectory.traj", index=":")
for f in frames:
print(f.get_potential_energy()) # eV (ASE convention)
The .xyz trajectory uses the extended-XYZ convention with
energy=<value> Hartree per frame, so ase.io.read("trajectory.xyz", ":")
also works.
Plain Python (Excel, pandas)¶
Every spectrum / diagram panel exports its data as a per-trace CSV via
the 📋 Copy data button. The file is also written to the result folder
as <panel>_data_<timestamp>.csv. The format is a title line, then one
section per trace (each with its own x,y header):
A single-trace file reads directly with pandas.read_csv(path, comment="#").
For multi-trace files, split on the # <trace name> lines first (or read
with stdlib csv.reader), since each section repeats the x,y header.
Bundle export¶
Export bundle (.zip) (Results tab → Export) zips an entire result folder. The archive lands as a sibling of the result directory:
Share that one file and your collaborator gets every artifact above — no need to walk them through which file does what.
Troubleshooting¶
- Avogadro 1.2 doesn't show vibrations. Upgrade to Avogadro 2; the v1 branch is no longer maintained. Avogadro 2 reads QuantUI's Molden vibration blocks natively.
result.moldenis missing for an older result. Very old results predate the automatic Molden export; re-running the calc writes one.- IQmol can't open the file. IQmol's parser is stricter than Avogadro's. If you see a parse error, open the file in Avogadro first to confirm it's well-formed — usually a sign of a half-written file from an interrupted run.
- Cube files render in Avogadro but the colors are inverted. Toggle Extensions → Surfaces → Color by Phase. Cube sign conventions vary between codes; QuantUI uses PySCF's default (gpu4pyscf matches).
Related reading¶
- Molden file format spec
- Extended-XYZ specification
- ASE trajectory file format
- Cube file format (Gaussian convention)
See the CHANGELOG for when each export was added.