PQSetup

Prepare and validate PQ simulation inputs in a local browser interface.

PQSetup builds the input package. PQ runs it.

Documentation

Install

Python 3.11 or newer. The UI ships inside the package; Node.js is not required.

python3 -m venv .venv
source .venv/bin/activate
python -m pip install MolarVerse-PQSetup

From a local clone (contributors):

python -m pip install .

Quick Start

pqsetup

Keep the water example, choose a method, review the inputs, download the package, then run it where PQ is installed:

unzip water-nvt.zip -d water-nvt
cd water-nvt
./run.sh /path/to/PQ

Check what this machine can see:

pqsetup doctor
pqsetup --pq-executable /path/to/PQ doctor

Validate an existing input:

pqsetup validate run.in

PQSetup does not submit jobs or run the simulation. It writes inputs for the stable PQ v0.7.0 release.

Documentation

• Getting started — install, environment checks, and the first run package
• Build a run — Structure, Method, Run, Output, and keyboard shortcuts
• Validation — local preflight, environment discovery, and PQ parser checks
• Run packages — package layout, restart order, and the project manifest
• Command line — serve, doctor, and validate
• Compatibility — supported structure formats, cells, and calculators
• Advanced settings — the optional PQ keywords per calculator and force field
• Troubleshooting — blocked packages, missing PQ and runtime failures
• Shared design package — versioned tokens, CSS and React controls for other PQ web tools

Development

python -m pip install -e ".[test]"
npm --prefix frontend ci
python -m pytest
npm --prefix frontend test
npm --prefix frontend run build

The interface uses @molarverse/pq-design, the shared design package for the PQ web tools. The frontend locks a public release archive in package-lock.json and needs no sibling checkout.