| Launch GUI viewer |
orbitron view file.xyz |
See §3.1 for extra flags. |
| Launch TUI |
orbitron-tui fixtures/benzene.xyz |
Keyboard shortcuts listed in §5. |
| Headless render |
orbitron render input.xyz -o output.png --camera cameras/front.json |
Camera presets documented in §3.10 and §4.3. |
| Python quickstart |
extensions/python-bridge/examples/api_quickstart.ipynb |
Build instructions in §7. |
| Python wheel install |
pip install orbitron-*.whl |
Platform-specific wheels available from releases. See §1.3. |
| Web viewer embedding |
Download orbitron-viewer-web-v*.zip or standalone HTML |
Full integration guide in §10. |
| Reset viewer to defaults |
Delete ~/.config/Orbitron/config.toml (platform equivalent) |
Configuration schema covered in the Developer Guide (§7.2 UI State & Panels). |
| Keyboard cheat sheet |
Press H in the viewer or use Help → Keyboard Controls |
Full table in §3.3. |
| Inspect run summary |
orbitron inspect fixtures/gaussian/water_two_stage.log |
Shows stage/task boundaries usable with the boundary loaders. |
| Preflight a large source |
orbitron resources run.out --mode scene --json |
Reads metadata and at most 64 KiB, without parsing the source. Use trajectory only when the operation retains every frame. |
| Prepare a portable bundle |
orbitron canonical export run.out -o run.orbpack --skip-cache --json |
Run beside the source on an HPC system, then transfer the bundle. Add --mo N to keep one volumetric dataset. |
| Open a portable bundle |
orbitron view run.orbpack |
Replays retained grids, trajectories, modes, and presentation state without the original source file. |
| Inspect a GROMACS trajectory |
orbitron view production.xtc --topology system.gro |
XTC is read-only and requires a topology-bearing structure with matching atom order. See GROMACS and MD. |
| Analyze an MD trajectory |
orbitron --topology system.gro analyze md production.xtc --rmsd --rmsf residue --output analysis.csv |
One bounded-memory pass; frame indices are zero-based. |
| Open an experimental density map |
orbitron view density.map |
For a fitted model, open PDB/mmCIF first and choose Analysis → Surfaces → Add volume…. |
| Clip density around atoms |
Select atoms, expand the volume row, then choose Clip to selection |
Starts with 4 Å padding. Clipping reduces meshing work, not map parsing or retained-grid memory. |
| Build from SMILES |
orbitron from-smiles 'CCO' -o ethanol.sdf |
Deterministic 3D by default; see Viewer §3.7.12 for the accepted subset. |
| Search conformers |
Edit → Generate Conformers… |
Bounded UFF-ranked search with single and combined torsion starts for one connected, non-periodic, non-metal molecule. |
| Set charge and multiplicity |
Edit rail → Molecular state |
Separate from atomic formal charges and parsed calculation evidence. |
| Mutate a residue |
Select one annotated residue, then Edit → Mutate Residue… |
Top8000-derived backbone-dependent rotamers with probability, clash-ranked detached previews, and explicit HID/HIE/HIP histidine states. |
| Repair a missing side chain |
Find and select one incomplete residue, then Edit → Repair Missing Side Chain… |
Replaces the complete side chain with a clash-checked CCD/Top8000 candidate and reports missing atoms, retained-atom displacement, and formal charge before Apply. |
| Retain or delete an alternate location |
Select one residue with named conformers, then Edit → Edit Alternate Locations… |
Residue-local detached preview. Shared blank-location atoms stay; keep-only clears the retained label but preserves source occupancy. |
| Select or remove water and ions |
Enter edit mode, optionally select anchor atoms, then Edit → Clean Up Water/Ions… |
Whole-residue All/Within/Beyond matching with periodic minimum-image distance. Water is the default; ion removal is explicit and warns about structural or catalytic metals. |
| Add a protein terminal cap |
Select one observed fragment end, then Edit → Add Terminal Cap… |
Detached heavy-atom ACE/NME preview with assigned residue identity, removed atoms, formal-charge change, Apply, and Undo. |
| Set a side-chain protonation state |
Select one ASP/ASH, GLU/GLH, CYS/CYM, or LYS/LYN residue, then Edit → Set Protonation State… |
Explicit state and acidic-oxygen tautomer choice with charge and hydrogen preview. Orbitron does not infer pH. |
| Create or break a disulfide |
Select atoms spanning two CYS/CYX residues, then Edit → Edit Disulfide… |
Detached SG-SG, hydrogen, SSBOND, distance, and formal-charge preview. Creation accepts CYS pairs 1.7–2.5 Å apart; cleavage also accepts CYX. |
| Inspect steric clashes |
Scene → Sequence / Residues → Steric clashes |
Worst-first per-pair distance, limit, and overlap; heavy atoms by default, with exact pair selection. |
| Inspect protein backbone |
Scene → Sequence / Residues → Backbone validation |
Top8000 favored/allowed/outlier evaluation with phi, psi, residue type, and whole-residue selection. |
| Find missing side-chain atoms |
Scene → Sequence / Residues → Missing side-chain atoms |
Lists absent heavy atoms for supported coordinate-bearing amino acids and selects each incomplete conformer. |
| Inspect protein side chains |
Scene → Sequence / Residues → Side-chain validation |
Top8000 favored/allowed/outlier evaluation with chi angles, score, and visible-conformer selection. |
| Export structural validation |
Any validation panel → Export → CSV… or JSON… |
Exports all findings with scene digest, version, model/frame, assembly, alternate-location view, selection, and analysis parameters. |
| Run compact biology/MD examples |
examples/biology-and-md/run.sh all |
Produces inspectable JSON/CSV, PNG, GRO, and .orbpack outputs from committed fixtures. |
| Browse interactive examples |
Open the Live Examples page |
WASM examples cover molecules, crystals, normal modes, proteins, MD snapshots, and density. |