PQSetup

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

PQSetup builds the input package. PQ runs it.

Documentation · Getting started · Command line

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

See the documentation for server options, validation scopes, and complete setup examples.

Input

Multi-frame ASE sources import the final frame. Structures without a cell receive a centered vacuum cell. Periodic coordinates follow PQ's origin-centered cell convention.

Workflow

PQSetup does not submit jobs or run the simulation.

Validation

PQSetup checks the structure, plan, required files, and generated inputs locally. When the selected PQ executable advertises machine-readable validation, PQSetup also checks the inputs with PQ.

Environment detection reports what is available. It does not establish that a method, force field, or protocol is scientifically suitable.

PQSetup writes inputs for the stable PQ v0.7.0 release.

Run Packages

Uploaded force-field files and calculator templates are included in the package.

Development

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