Decision table
| What you see | Likely stage | Next check |
|---|---|---|
| New project is unavailable | Account workspace initialization | Allow the workspace to load. On a cloud error, reload; do not clear browser data containing unsynchronized edits. |
| Structure will not import | Parsing or geometry | Check format, encoding, lattice, coordinates, and occupancies. Keep the source file for diagnosis. |
| Run is rejected immediately | Submission validation | Inspect the field error, resource limits, authentication, and method compatibility. |
| Run remains Queued | Worker or dependency | Check destination, private worker heartbeat, shared availability, and predecessors. |
| Worker starts but QE exits | Runtime or scientific input | Read the first solver error. Check pseudopotential files, species names, syntax, memory, and disk. |
| SCF cycles do not settle | Electronic self-consistency | Inspect geometry, occupations, magnetism, mixing, thresholds, and near-degenerate states. |
| Solver finished but result unavailable | Upload or completion | Keep the worker running; inspect network, credential validity, and final upload state. |
| Open in Figure Lab fails | Numerical source retrieval | Retry the source. Older runs may need their original numerical file when retained datasets are absent. |
| Overlay or pair warns about context | Scientific comparison | Read geometry, energy-reference, and path identity. Use independent panels when comparability is not established. |
| Export fails | Rendering or font resources | Reconnect, reduce an oversized raster, and retry. Keep the figure document and source package. |
Collect useful evidence
- Record the page and exact action, time, project, and run identifier.
- Copy the visible error and relevant solver-log lines around the first failure.
- Note the destination, allocation, operating system, worker image, and whether the problem repeats.
- For a plot issue, retain the numerical dataset, figure Source package, and expected axis convention.
- Contact support with the smallest reproducible example. Remove private credentials, cookies, passwords, and unrelated project data.
Protect recoverable work
Keep the current browser session open when it contains an unsynchronized figure or project. Export source files before clearing site storage.
A retry creates or repeats work according to the active action. Inspect existing queued and running calculations before submitting duplicates.
Replacing a personal credential invalidates the old worker. Finish or cancel active work before rotating it so a completed solver can still upload its result.